Memoria governata per gli agenti, via MCP.

{
  "query": "Quale database è approvato per i nuovi servizi?",
  "topic": "database",
  "status": "contested",
  "decision": {
    "id": "adr-024",
    "content": "PostgreSQL è il database approvato per i nuovi servizi.",
    "value": "PostgreSQL",
    "status": "approved",
    "scope": "new-services",
    "valid_from": "2026-02-01",
    "valid_to": null,
    "confidence": 0.95,
    "authority": 1
  },
  "scope": "new-services",
  "temporal_validity": { "as_of": "2026-09-08", "valid_from": "2026-02-01", "valid_to": null },
  "sources": [
    { "source_id": "adr-024", "title": "ADR 024", "type": "decision-record", "reference": "docs/adr/024.md", "occurred_at": "2026-02-01" },
    { "source_id": "adr-001", "title": "ADR 001", "type": "decision-record", "reference": "docs/adr/001.md", "occurred_at": "2023-05-12" },
    { "source_id": "adr-011", "title": "ADR 011", "type": "decision-record", "reference": "docs/adr/011.md", "occurred_at": "2024-09-03" },
    { "source_id": "team-chat-2026-03-14", "title": "Chat del team", "type": "team-chat", "reference": "#platform", "occurred_at": "2026-03-14" }
  ],
  "evidence": [
    { "source_id": "adr-024", "excerpt": "PostgreSQL è il database approvato per i nuovi servizi dal 1 febbraio 2026.", "verified": true }
  ],
  "superseded_decisions": [
    { "id": "adr-001", "content": "MySQL è il database di default.", "value": "MySQL", "status": "superseded", "scope": "all", "valid_from": "2023-05-12", "valid_to": "2026-02-01", "confidence": 0.9, "authority": 1 }
  ],
  "scope_exceptions": [
    { "id": "adr-011", "content": "MongoDB resta approvato per i servizi legacy.", "value": "MongoDB", "status": "approved", "scope": "legacy", "valid_from": "2024-09-03", "valid_to": null, "confidence": 0.9, "authority": 1 }
  ],
  "conflicts": [
    {
      "conflict_id": "rel-dynamodb-vs-adr-024",
      "item": { "id": "claim-chat-dynamodb", "content": "Stiamo spostando i nuovi servizi su DynamoDB.", "value": "DynamoDB", "status": "proposed", "scope": "new-services", "valid_from": "2026-03-14", "valid_to": null, "confidence": 0.6, "authority": 0.3 },
      "source_ids": ["team-chat-2026-03-14"],
      "rationale": "Incompatible database choice for the same scope.",
      "status": "open"
    }
  ],
  "missing_information": ["At least one incompatible claim remains unresolved."],
  "context_metrics": { "source_characters": 18420, "evidence_characters_returned": 78 },
  "drill_down": {
    "required": false,
    "suggested_tool": null,
    "reason": "Current state, supersessions, scoped exceptions, conflicts, evidence, and sources are already included. Use a drill-down tool only if the user explicitly asks for exhaustive history or conflict remediation."
  }
}

status

Uno di quattro valori: verified, contested, insufficient_evidence, unknown. Qui contested: esiste una decisione in vigore e un claim incompatibile resta aperto nello stesso scope. verified è uno stato applicativo del registro, né una firma né la certezza che la decisione sia giusta.

decision

La decisione selezionata: id, enunciato, valore, scope, periodo di validità, confidenza e autorità. Può essere presente anche con insufficient_evidence: controlla sempre status e missing_information prima di usarla. null quando non è selezionabile una decisione.

scope

Lo scope su cui la domanda è stata risolta. Se non lo passi in input, è quello della decisione trovata.

temporal_validity

as_of seleziona la data di validità, oggi se omessa. Revoche e risoluzioni dei conflitti attuali si applicano anche alle date passate: non ricostruisce ciò che era noto allora.

sources, evidence

sources elenca le fonti della decisione, delle superate, delle eccezioni e dei conflitti. evidence porta gli estratti, con verified true quando l’estratto è stato riscontrato nel testo della fonte. Mai il documento intero.

superseded_decisions

Le decisioni che quella in vigore ha sostituito. Restano nella storia e nella risposta, con il loro valid_to, mai servite come in vigore.

scope_exceptions

Decisioni in vigore su uno scope che non si sovrappone a quello risolto: qui MongoDB per legacy. Il client sa che esistono e dove si applicano.

conflicts, missing_information

I claim incompatibili con la decisione, con l’id della relazione, le fonti e la motivazione. Finché uno resta open, lo stato è contested e missing_information lo dice in chiaro.

context_metrics, drill_down

context_metrics confronta i caratteri delle fonti con quelli degli estratti restituiti. drill_down dice se serve un altro tool (get_decision_history, find_conflicts) o se questa risposta basta.