I3280 — An intent, a milestone and an issue carry provenance the way an ADR and a knowledge record do

○PŘIPRAVENO vlna 0 · p1 · profil implementation · bezpečné souběžně

Part of a-promoted-record-opens-its-message — Every record promoted from a workspace cites the message it came from, and the UI opens it for the operator who holds it.

Cíl

Give the intent, milestone and issue schemas an optional provenance header (origin, derived_from) like the ADR and knowledge schemas carry, with one reference grammar declared once and inlined by majordomus generate into each schema, each kind admitting its own declared subset, read by the plan model, so a promoted plan record can name where it came from.

Proč

The 2026-10-18 import promotes intents, milestones and issues, and their schemas (share/schemas/majordomus/{intent,milestone,issue}) have no field for a source: today the drill-back the owner asked for has nowhere to live on three of the five record kinds. Critique 2026-10-18: adr.v1 admits ^(decision|session|commit|issue|file|test):.+$ while knowledge.v1 adds task:, and their origin semantics differ, so 'one Provenance' means one grammar inlined at generate time with a per-kind admitted subset, not one merged definition. It does not wait on milestone external-workspaces: that milestone dependency was removed from a-promoted-record-opens-its-message, and only the issue-level dependencies of I3282 (on I1308) and I3283 (on I1309) remain. Proposed in ADR 0211 (A record promoted from a workspace cites the message it came from by a typed reference that validates in every checkout and resolves only where the store is held) (proposed; it carries no authority until the owner accepts it). Sources: chatgpt-majordomus:c267#2.

Aktuální stav

Verified on master 707a04c: adr.v1 admits derived_from ^(decision|session|commit|issue|file|test):.+$; knowledge.v1 adds task: and resolves decision, session and task references against the ledger; the two origin semantics differ; the plan schemas define no provenance; no schema under share/schemas uses a cross-file $ref.

Cílový stav

One reference grammar declared once and inlined into all five schemas at generate time, each kind admitting its declared subset, validated by plan validate and knowledge check alike.

Rozsah

• apps/majordomus-cli/src/plan.rs
• apps/majordomus-cli/src/generate.rs
• share/schemas/majordomus/adr/adr.v1.schema.json
• share/schemas/majordomus/knowledge/knowledge.v1.schema.json
• share/schemas/majordomus/intent/intent.v1.schema.json
• share/schemas/majordomus/milestone/milestone.v1.schema.json
• share/schemas/majordomus/issue/issue.v1.schema.json
• share/allow/intent.txt
• share/allow/issue.txt
• share/allow/milestone.txt
• apps/majordomus-cli/src/commands/plan.rs

Mimo rozsah

• New reference types (I3281)
• Removing task: from knowledge provenance
• A runtime cross-file $ref resolver in the schema validator

Závislosti

Žádné. Tento úkol je kořenem grafu.

Co na tom čeká

• I3273✕BLOCKED Each requirement of a campaign revision has a content-derived identity and is reconciled into the existing intents and issues
• I3275✕BLOCKED An intent's inspector shows the campaign segments it was derived from
• I3281✕BLOCKED A workspace message is a typed provenance reference that validates in every checkout without the store

Kritéria přijetí

• An issue with provenance.derived_from: [file:README.md] validates; one with an unknown key is refused
• plan show renders the provenance
• The reference grammar is declared once and `majordomus generate` inlines it into the adr, knowledge, intent, milestone and issue schemas; no schema uses a cross-file $ref and the jsonschema build is unchanged
• Each kind admits its own declared subset: intent, milestone and issue admit only tracked-resolvable types (commit, issue, file, test); adr keeps decision|session|commit|issue|file|test; knowledge keeps task:
• A plan record citing task:, session: or decision: is refused with the reason that ledger-local references fail in every other checkout
• The adr `origin` and knowledge `origin` semantics are kept per kind and covered by one test each

Validace

• majordomus plan validate
• majordomus generate --check
• bin/majordomus knowledge check

Požadované důkazy

• case_a_plan_record_carries_provenance

Důkazy

Nic nezaznamenáno. Za každým tokenem výše musí stát příkaz nebo artefakt, než lze tento úkol dokončit; vyprávění se odmítá.

Časová osa

zahájeno

—

ověřeno

—

dokončeno

—

Tato tři pole, důkazy výše a stav závislostí jsou vše, z čeho se stav skládá. Neexistuje žádné pole stavu, které by s nimi mohlo být v rozporu.

Canonical record: .ai/repo/project/issues/I3280.yaml. Read it back with majordomus plan show I3280.