create-agdf 0.14.4 → 0.20.0

package/generated/plugins/agdf/runtime/create-agdf/generated/plugins/agdf/meta/agdf-plugin.definition.json

@@ -1,7 +1,7 @@
 {
   "schemaVersion": 1,
   "id": "agdf",
-  "version": "0.14.4",
+  "version": "0.20.0",
   "displayName": "AI Governance & Delivery Framework",
   "developerName": "Arndt Gold",
   "description": "Control layer for governed AI-assisted delivery.",
@@ -41,6 +41,7 @@
   },
   "claude": {
     "skillPrefix": "",
+    "mcpServers": "./mcp/claude.mcp.json",
     "agentRouter": "meta/agdf-agent-router.md",
     "defaultPrompt": [
       "Assess whether AGDF fits this request and recommend the lightest safe path before proposing implementation.",
@@ -52,8 +53,8 @@
     "skillPrefix": "agdf-",
     "runtimeContractFileName": "agdf-runtime-contract.md",
     "pluginManifest": "plugin.json",
-    "skills": "copilot-skills/",
-    "hooks": "hooks/copilot-hooks.json"
+    "skills": "skills/",
+    "hooks": "com.github.copilot/hooks/hooks.json"
   },
   "opencode": {
     "skillPrefix": "agdf-",
@@ -89,7 +90,7 @@
     },
     "surfaces": {
       "codex": "native-hook-review",
-      "claude": "exact-command-rule",
+      "claude": "plugin-enablement",
       "copilot": "plugin-hook-review",
       "opencode": "plugin-internal",
       "portable-skills": "manual-external-required"
@@ -232,66 +233,323 @@
       "availabilityDecision": "submission/openai/availability.md"
     }
   },
+  "runtimeContract": {
+    "schemaVersion": 1,
+    "manifestPath": "meta/agdf-runtime-contract.md",
+    "modules": [
+      "meta/contracts/request-activation.md",
+      "meta/contracts/task-target-resolution.md",
+      "meta/contracts/gate-transition.md",
+      "meta/contracts/gate-artifact-preparation.md",
+      "meta/contracts/interaction.md",
+      "meta/contracts/modes.md",
+      "meta/contracts/quality.md",
+      "meta/contracts/context-graph.md",
+      "meta/contracts/control-scaffold.md",
+      "meta/contracts/closeout.md",
+      "meta/contracts/ur-definition.md",
+      "meta/contracts/prd-definition.md",
+      "meta/contracts/sd-definition.md",
+      "meta/contracts/tp-definition.md"
+    ]
+  },
+  "instructionFootprint": {
+    "schemaVersion": 1,
+    "measurement": {
+      "encoding": "utf8",
+      "lineEndings": "lf",
+      "dynamicAbsolutePathTokens": {
+        "executable": "<executable>",
+        "validator": "<validator>",
+        "workingDirectory": "<working-directory>"
+      }
+    },
+    "budgets": {
+      "activationKernel": {
+        "maxNormalizedBytes": 1100,
+        "structuralConditions": [
+          "exactly_one_semantic_kernel_source"
+        ]
+      },
+      "skillDiscoveryDescription": {
+        "maxNormalizedBytes": 420,
+        "structuralConditions": [
+          "one_skill_purpose_and_boundary_plus_compact_common_boundary"
+        ]
+      },
+      "allSkillDiscoveryDescriptions": {
+        "maxNormalizedBytes": 3000,
+        "structuralConditions": [
+          "exactly_catalog_in_definition_order",
+          "no_full_exclusion_taxonomy",
+          "no_operation_catalog"
+        ]
+      },
+      "sessionStartBase": {
+        "maxNormalizedBytes": 1912,
+        "structuralConditions": [
+          "exactly_one_kernel",
+          "exactly_one_dispatcher_binding",
+          "no_router_or_target_gate_quality_closeout_handbook"
+        ]
+      },
+      "runtimeCheckSupplement": {
+        "maxNormalizedBytes": 1200,
+        "structuralConditions": [
+          "separately_measurable_variable_facts_only",
+          "bounded_non_authorizing_repository_control_facts_and_fixed_reentry"
+        ]
+      },
+      "openCodeEagerInstructions": {
+        "maxNormalizedBytes": 4000,
+        "structuralConditions": [
+          "exactly_one_kernel",
+          "no_dispatcher_binding",
+          "no_full_router_target_mode_gate_quality_or_closeout_sections"
+        ]
+      },
+      "openCodeActiveDynamicContext": {
+        "maxNormalizedBytes": 1000,
+        "structuralConditions": [
+          "exactly_one_dispatcher_binding",
+          "active_and_version_facts_only",
+          "no_kernel_or_immutable_policy_prose"
+        ]
+      },
+      "openCodeInactiveDynamicContext": {
+        "maxNormalizedBytes": 0,
+        "structuralConditions": [
+          "no_binding_notice_policy_or_runtime_supplement"
+        ]
+      },
+      "openCodeComposedStaticAndActiveDynamic": {
+        "maxNormalizedBytes": 5000,
+        "structuralConditions": [
+          "exactly_one_kernel_and_one_dispatcher_binding_across_repository_and_global_variants"
+        ]
+      },
+      "openCodeCompactionAddition": {
+        "maxNormalizedBytes": 1100,
+        "structuralConditions": [
+          "at_most_one_kernel_only_recovery_block",
+          "no_dispatcher_binding_or_active_inactive_guidance"
+        ]
+      },
+      "selectedGateCheckSkill": {
+        "maxNormalizedBytes": 6900,
+        "structuralConditions": [
+          "exactly_one_kernel_before_unchanged_terminal_dispatch",
+          "dispatch_and_bootstrap_only",
+          "detailed_fallback_only_through_focused_contracts"
+        ]
+      }
+    }
+  },
   "skillSet": [
     {
       "slug": "delivery-path-search",
+      "runtimeContractModules": [
+        "control-scaffold",
+        "gate-transition",
+        "quality"
+      ],
       "discovery": "optional",
       "useFor": "high-impact planning decisions with several plausible next delivery steps before implementation",
-      "boundary": "read-only advisory search; never grants gate permission or replaces gate-check"
+      "boundary": "read-only advisory search; never grants gate permission or replaces gate-check",
+      "dispatch": {
+        "mode": "judgement_required",
+        "requiresControlSnapshot": true
+      }
     },
     {
       "slug": "brownfield-analysis",
+      "runtimeContractModules": [
+        "gate-transition",
+        "modes",
+        "context-graph",
+        "quality"
+      ],
       "discovery": "automatic",
-      "useFor": "after gate-check permits Brownfield Review or implementation preparation, before non-trivial changes in existing systems",
-      "boundary": "clarifies reuse, owners, risks and Mode/Slice Decision; never bypasses gate-check; Brownfield Review is not implementation permission"
+      "useFor": "permitted Brownfield Review or preparation before non-trivial existing-system changes",
+      "boundary": "clarifies reuse, owners, risks and Mode/Slice; never bypasses control or grants implementation",
+      "dispatch": {
+        "mode": "judgement_required",
+        "requiresControlSnapshot": true
+      }
     },
     {
       "slug": "ux-intent-definition",
+      "runtimeContractModules": [
+        "gate-transition",
+        "quality"
+      ],
       "discovery": "automatic",
-      "useFor": "after approved UR and post-UR routing for medium/high UI/UX impact or ambiguous low-impact product semantics before PRD readiness",
-      "boundary": "non-authorizing analytical PRD input; never creates product intent, gate permission, technical design or a parallel product source of truth"
+      "useFor": "approved UR with routed medium/high UX impact or ambiguous low-impact semantics before PRD",
+      "boundary": "analytical PRD input only; no intent, gate, design or parallel product authority",
+      "dispatch": {
+        "mode": "judgement_required",
+        "requiresControlSnapshot": true
+      }
     },
     {
       "slug": "clean-implementation-review",
+      "runtimeContractModules": [
+        "quality",
+        "context-graph"
+      ],
       "discovery": "automatic",
       "useFor": "evidence dimension: inspect whether the solution is structurally clean",
-      "boundary": "supports Quality Readiness; not a TP or QA substitute"
+      "boundary": "supports Quality Readiness; not a TP or QA substitute",
+      "dispatch": {
+        "mode": "judgement_required",
+        "requiresControlSnapshot": true
+      }
     },
     {
       "slug": "code-review",
+      "runtimeContractModules": [
+        "quality",
+        "context-graph"
+      ],
       "discovery": "automatic",
       "useFor": "evidence dimension: review the actual diff for defects, regression and security findings",
-      "boundary": "supports Quality Readiness; does not replace QA"
+      "boundary": "supports Quality Readiness; does not replace QA",
+      "dispatch": {
+        "mode": "judgement_required",
+        "requiresControlSnapshot": true
+      }
     },
     {
       "slug": "delivery-closeout",
+      "runtimeContractModules": [
+        "closeout",
+        "context-graph",
+        "gate-transition"
+      ],
       "discovery": "automatic",
       "useFor": "commit/PR-near handoff after QA/OR/UAT",
-      "boundary": "never performs VCS actions automatically"
+      "boundary": "never performs VCS actions automatically",
+      "dispatch": {
+        "mode": "judgement_required",
+        "requiresControlSnapshot": true
+      }
+    },
+    {
+      "slug": "ur-definition",
+      "runtimeContractModules": [
+        "ur-definition"
+      ],
+      "discovery": "automatic",
+      "useFor": "bound UR drafting, clarification or revision",
+      "boundary": "content only; preserves approved intent",
+      "dispatch": {
+        "mode": "judgement_required",
+        "requiresControlSnapshot": true
+      }
+    },
+    {
+      "slug": "prd-definition",
+      "runtimeContractModules": [
+        "prd-definition",
+        "gate-artifact-preparation"
+      ],
+      "discovery": "automatic",
+      "useFor": "bound PRD drafting, clarification or revision",
+      "boundary": "content only; preserves approved intent",
+      "dispatch": {
+        "mode": "judgement_required",
+        "requiresControlSnapshot": true
+      }
+    },
+    {
+      "slug": "sd-definition",
+      "runtimeContractModules": [
+        "sd-definition",
+        "gate-artifact-preparation"
+      ],
+      "discovery": "automatic",
+      "useFor": "bound SD content",
+      "boundary": "content only; preserves approved intent",
+      "dispatch": {
+        "mode": "judgement_required",
+        "requiresControlSnapshot": true
+      }
+    },
+    {
+      "slug": "tp-definition",
+      "runtimeContractModules": [
+        "tp-definition",
+        "gate-artifact-preparation"
+      ],
+      "discovery": "automatic",
+      "useFor": "bound TP content",
+      "boundary": "content only; preserves approved sources",
+      "dispatch": {
+        "mode": "judgement_required",
+        "requiresControlSnapshot": true
+      }
     },
     {
       "slug": "gate-check",
+      "runtimeContractModules": [
+        "gate-transition",
+        "modes",
+        "gate-artifact-preparation"
+      ],
       "discovery": "start_here",
-      "useFor": "new build/change intent, unclear approval, Structured Delivery, later-gate artefact requested",
-      "boundary": "does not create later artefacts or skip Mode/Slice Decision after Brownfield Review"
+      "useFor": "delivery control and gate readiness",
+      "boundary": "delegates drafts; never approves or skips gates",
+      "dispatch": {
+        "mode": "deterministic_control",
+        "deterministicCommand": "gate-check",
+        "requiresControlSnapshot": true
+      }
     },
     {
       "slug": "qa-gate",
+      "runtimeContractModules": [
+        "quality",
+        "context-graph",
+        "gate-transition"
+      ],
       "discovery": "automatic",
       "useFor": "sole final Quality Readiness decision",
-      "boundary": "only instance for `pass | revise | block`"
+      "boundary": "only instance for `pass | revise | block`",
+      "dispatch": {
+        "mode": "judgement_required",
+        "requiresControlSnapshot": true
+      }
     },
     {
       "slug": "release-or",
+      "runtimeContractModules": [
+        "closeout",
+        "quality",
+        "context-graph",
+        "control-scaffold"
+      ],
       "discovery": "automatic",
       "useFor": "auditable closeout for every relevant run",
-      "boundary": "not a QA substitute"
+      "boundary": "not a QA substitute",
+      "dispatch": {
+        "mode": "judgement_required",
+        "requiresControlSnapshot": true
+      }
     },
     {
       "slug": "task-plan-review",
+      "runtimeContractModules": [
+        "quality",
+        "context-graph",
+        "gate-transition"
+      ],
       "discovery": "automatic",
       "useFor": "evidence dimension: verify whether the approved Task Plan was fulfilled",
-      "boundary": "supports Quality Readiness; no final QA decision"
+      "boundary": "supports Quality Readiness; no final QA decision",
+      "dispatch": {
+        "mode": "judgement_required",
+        "requiresControlSnapshot": true
+      }
     }
   ],
   "distributionProfiles": {
@@ -301,31 +559,19 @@
       "generatedRepository": "agdf-repo"
     },
     "profiles": {
-      "source-development": {
-        "runtime": "absent",
-        "installable": false,
-        "machineValidation": "unavailable"
-      },
-      "runtime-plugin": {
-        "runtime": "required",
-        "installable": true,
-        "machineValidation": "local_exact_version_digest"
-      },
-      "copilot-runtime-plugin": {
-        "runtime": "required",
-        "installable": true,
-        "machineValidation": "local_exact_version_digest_inventory"
-      },
-      "opencode-config-local": {
-        "runtime": "config_local_package",
-        "installable": true,
-        "machineValidation": "local_exact_version"
-      },
-      "portable-skills": {
-        "runtime": "absent",
-        "installable": true,
-        "machineValidation": "unavailable_or_external_required"
-      }
+      "source-development": {"runtime":"absent","installable":false,"machineValidation":"unavailable"},
+      "runtime-plugin": {"runtime":"required","installable":true,"machineValidation":"local_exact_version_digest"},
+      "copilot-runtime-plugin": {"runtime":"required","installable":true,"machineValidation":"local_exact_version_digest_inventory"},
+      "opencode-config-local": {"runtime":"config_local_package","installable":true,"machineValidation":"local_exact_version"},
+      "portable-skills": {"runtime":"absent","installable":true,"machineValidation":"unavailable_or_external_required"}
     }
+  },
+  "hostSupport": {
+    "schema_version": 3,
+    "tiers": {"codex":"qualification_target","claude":"qualification_target","copilot":"experimental","opencode":"experimental"},
+    "required_targets": [{"host":"claude","surface":"cli","os":"win32","scenarios":["dispatch","failure_case","skill_continuation","upgrade","recovery"]},{"host":"codex","surface":"cli","os":"darwin","scenarios":["dispatch","failure_case","skill_continuation","upgrade","recovery"]}],
+    "reported_desktop": [{"host":"codex","surface":"desktop-code","os":"observed","scenarios":["session","upgrade","recovery"]},{"host":"claude","surface":"desktop-code","os":"win32","scenarios":["session","upgrade","recovery"]}],
+    "optional_cli": {"codex":{"codex_version":"0.157.1","model":"gpt-6-luna","platforms":["linux","win32"]}},
+    "unqualified": [{"host":"codex","surface":"cli","os":"linux"},{"host":"codex","surface":"cli","os":"win32"}]
   }
 }

package/generated/plugins/{copilot/agdf/copilot-skills → agdf/runtime/create-agdf/generated/plugins/agdf/meta}/contracts/closeout.md

@@ -9,6 +9,10 @@ When the next step is gated, name the required approval or AGDF skill instead of
 
 ## Relevant Run
 
+When `release-or` authors the Orchestration Report, it uses only the bound absolute plugin-owned
+`template_path` for `OR.md`. Repository scaffold copies never override it. Missing or unsafe plugin
+content blocks OR authoring without mutation or fallback and remains an explicit closeout gap.
+
 A relevant run is any run that changes durable state, creates or updates an AGDF artefact, changes code or runtime behaviour, performs a gate decision, blocks on a governance condition, produces QA/UAT/release evidence, or closes a delivery slice.
 
 OR is not mandatory for a pure explanation, read-only inspection, small review, or local debugging step that produces no durable state change and no gate consequence.
@@ -47,7 +51,7 @@ Child handling input is limited to `action_required | accepted_open`. `accepted_
 outcome open and visible while allowing independently valid Child delivery to continue; it never
 asserts Parent reconciliation. Evaluation is read-only and must never mutate a Parent.
 
-`agdf-release-or` reports the evaluated result in the Child OR. `agdf-delivery-closeout` consumes that OR
+`release-or` reports the evaluated result in the Child OR. `delivery-closeout` consumes that OR
 projection only; it must not search sibling runs, infer a relationship, reevaluate evidence or repair
 a Parent. Unresolved explicit reconciliation is warning-level coordination evidence, not a Child
 gate failure. Legacy runs without the optional relationship remain unchanged and add no routine
@@ -73,6 +77,6 @@ acceptance criteria, which remain owned by the referenced programme artefact.
 ## Do Not Duplicate
 
 The explanatory framework lives in `docs/`.
-The operating philosophy lives in `plugin/meta/agdf-constitution.md`.
-The principles live in `plugin/meta/agdf-tenets.md`.
+The operating philosophy lives in `plugins/agdf/meta/agdf-constitution.md`.
+The principles live in `plugins/agdf/meta/agdf-tenets.md`.
 This contract is only the compact runtime interface for skills.

package/generated/plugins/{copilot/agdf/copilot-skills → agdf/runtime/create-agdf/generated/plugins/agdf/meta}/contracts/control-scaffold.md

@@ -4,7 +4,7 @@
 
 Delivery Path Search is an optional read-only planning step for high-impact decisions with several materially different next actions.
 
-- It consumes the canonical selected-run `agdf-gate-check` evaluation for run, revision, current gate and
+- It consumes the canonical selected-run `gate-check` evaluation for run, revision, current gate and
   legal actions. Persisted presentation Markdown such as the Run Status Card is never policy input.
 - It binds the selected `scope_key`, `scope_revision` and objective to one control snapshot. A stale
   or incomplete snapshot fails before candidate generation or evaluation.
@@ -19,7 +19,7 @@ Delivery Path Search is an optional read-only planning step for high-impact deci
   recommendation conclusion.
 - It must report budgets, stopping reason and `full | tool_enforced | instruction_only` enforcement.
 - Model scores are judgements, not measurements.
-- Search output is evidence only. Canonical `agdf-gate-check` independently decides what may proceed.
+- Search output is evidence only. Canonical `gate-check` independently decides what may proceed.
 - Search applies only to the selected run objective. An unrelated decision needs the correct
   governed scope; Delivery Path Search is not a second task-target resolver.
 - The bounded first-release algorithm must not be labelled MCTS.
@@ -56,9 +56,19 @@ Repository-level discovery is derived; do not maintain a writable active-run das
 closed. Legacy `AGDF_RUN.md` is migration input or an explicitly rendered non-authoritative projection,
 never a second writable owner. Read-only commands must not migrate state.
 
+`run-create` writes a sealed run. The seal covers the run state and every file listed under
+Artefacts; an unrecorded edit blocks `doctor` and `gate-check` with `AGDF_RUN_SEAL_MISMATCH`. After
+changing either, call `run-update --run <run_id> --revision <revision_id>` before `gate-check`; it
+advances the revision and refuses Approvals changes. Only `run-approve` records an approval. Both run
+on the surface-local validator. The seal detects unrecorded edits; it is not a signature.
+Keep one `Artefacts` row per type: update the existing placeholder row instead of appending another.
+`run-update` and all run writers reject duplicate rows without advancing the revision. Remove the
+extra row and retry `run-update` to record the correction. Duplicate rows in older sealed runs also
+block `doctor` and gate presentation.
+
 When a repository needs durable AGDF state, use the plugin-local `control/` scaffold as the starting point.
 
-- `config.json` stores project language preferences. Use `artifact_language` for generated AGDF artefacts and `chat_language` for user-facing responses unless the user explicitly asks otherwise. Runtime rules remain English.
+- `config.json` stores project language preferences. Use `artifact_language` for generated AGDF artefacts. `chat_language` is the direct-command presentation default; dispatcher calls supply `presentation_language` under their current-request language contract. This presentation override never changes `artifact_language`. Runtime rules remain English. Authoring continuations supply the resolved languages and any required localized approval-summary heading before drafting.
 - `.agdf/control/runs/<run_id>/RUN_STATE.md` is the canonical current-run dashboard; legacy `AGDF_RUN.md` is migration input or an explicit non-authoritative projection.
 - `MASTER_BACKLOG.md` is the living pointer for active delivery work.
 - `BROWNFIELD_REVIEW.md` records the post-UR existing-system view and Mode/Slice Decision before PRD depth or Quick Task execution is chosen.
@@ -92,15 +102,18 @@ AGDF is agent-native first and CLI-verifiable by design.
 
 The primary operating path is the active skill plus the live `.agdf/control/` artefacts.
 Agents should read the repository state, apply this Runtime Contract, create or update only the currently allowed artefact, and make the next permissible step explicit.
-When control state is missing for a fresh request, keep the first step lightweight: draft the minimal UR in the response and request `Approval: UR`.
+When control state is missing, follow the existing setup/link boundary before run creation.
+After a concrete run is bound, dispatch delegates requirement drafting to `ur-definition`.
+Only fresh canonical readiness and a run-present binding may request `Approval: UR`.
+This branch is unreachable for `target_unresolved`.
 Initialize a control scaffold only when durable AGDF control state is explicitly requested, already used by the repository, or required by a deterministic CLI/CI setup path.
 
 Helper commands are deterministic proof and automation interfaces, not the normal-work ritual:
 
 - `init` creates the machine-readable control scaffold.
-- `doctor --json` checks whether `.agdf/control/` is consistent and actionable; it is not the reviewer.
+- `doctor --json` checks whether `.agdf/control/` is consistent and actionable; it is not the reviewer. On a host that lists the AGDF MCP server, the read-only tool `agdf_inspect` (`operation: doctor | gate-check | delivery-map | contract`) returns the same `--json` object and canonical Markdown without a shell; the shell binding stays the fallback. It never writes control state or prepares an approval binding.
 - `gate-check --json` reports reproducible gate state; it does not replace the gate-check skill judgement.
-- `gate-check --approval-envelope` prints the canonical ready-gate cards and exact-text request from the same evaluation; it does not grant approval or replace the chat workflow.
+- `gate-check --approval-envelope` prints a read-only summary and link to the current artefact. The agent uses `run-present` before asking for an exact gate approval.
 - `delivery-map --json` reports the delivery picture for CI, PRs, regression checks and audit trails.
 
 Machine-readable outputs should stay agent-friendly: stable decisions, blocking gate or current gate, missing approval, allowed outputs, forbidden outputs, next step, evidence and findings.

package/generated/plugins/agdf/runtime/create-agdf/generated/plugins/agdf/meta/contracts/gate-artifact-preparation.md

@@ -0,0 +1,132 @@
+# AGDF Runtime Contract — Gate Artifact Preparation
+
+This contract guides the `gate-check` skill when canonical gate evaluation returns
+`control.next_operation.type: prepare_gate_artifact`. It is procedural guidance only; canonical
+Run State, gate evaluation and exact approval remain authoritative.
+
+## Common Route
+
+- Use only the supplied `gate`, `artifact_path`, `template_path`, `source_artifacts`, `target`,
+  `run_id` and `revision_id`. `template_path` is the absolute canonical authoring template from the
+  installed, version-matched plugin for PRD, SD, TP or QA Report preparation. Repository scaffold
+  copies are derived references only. Do not rediscover or substitute a run, target, source
+  artifact or template. A missing or unsafe template blocks authoring without fallback or mutation.
+- Prepare only the named current-gate artifact from the supplied approved sources.
+  Record with `run-step --step artefact --gate <PRD|SD|TP|QA>
+  --evidence .agdf/control/artefacts/<run_id>/<input.json> --run <run_id> --revision <revision_id>`.
+  Do not publish a pointer and its required source relationship in separate accepted revisions.
+- After persistence, redispatch `gate-check` for the same target/run and use its fresh revision,
+  gate route and approval presentation. Do not reuse this operation or ask for approval until the
+  fresh dispatcher result supplies a valid presentation.
+- If a source is missing, a prerequisite is unresolved, the state changed, or persistence fails, stop
+  dependent authoring. Use interaction.md Bounded internal recovery only for its dispatched eligible
+  analytical owner; other conditions stay blocked. Never infer approval or create later-gate work.
+
+## Reviewed Recording Input (version 1)
+
+### Language and approval summary preparation
+
+Use the supplied `artifact_language` from `.agdf/control/config.json` for the artefact and
+the resolved `presentation_language` for user-facing text. The configured chat language is
+the direct-command default; dispatcher presentation input follows its current-request contract.
+Neither the request language nor English runtime/template text changes the artefact language.
+When `approval_summary_required` is true, before recording include exactly one
+`## <approval_summary_heading>` section with the supplied heading verbatim and a complete
+summary in the resolved presentation language. Apply the existing interaction contract's
+summary completeness and size limits; use no ellipses or hidden decision-relevant omissions.
+For PRD include user goal, scope, every canonical criterion ID exactly once, and decision context
+when approval decisions exist. Corrections use the existing permitted recording/revision path
+and require a fresh presentation. The summary grants no approval and is not another authority.
+
+Before recording, prefer the existing read-only MCP tool `agdf_inspect` with
+`operation: artifact-readiness`, `presentation_language`, `working_directory`, the resolved
+`primary_target`/`target_source`, and the supplied `run_id`, `gate` and `expected_revision_id`.
+Supported draft gates are `UR | PRD | SD | TP`. The Core derives the contained run-local
+`<gate>.md` path; there is no caller-supplied arbitrary path or implicit Run selection.
+This operation calls the existing summary, product-decision and traceability validators.
+The response has `report.ready`, `checks`, concrete `diagnostics`, `artifact_path`,
+`artifact_digest`, current/expected revision and `next_action`; `authorizes` is always false.
+`ready` covers authoring checks only: it neither records the draft nor establishes semantic
+derivation, source-binding proof, final QA, presentation or approval readiness. Missing source,
+stale revision, approved source or canonical integrity/gate blockers keep it unready. Resolve
+the named issue through its existing owner. No recording or approval follows from this result
+alone. Registration and run-present repeat their own current canonical checks.
+
+Without that MCP capability, use the exact Core function
+`inspectArtifactReadiness(root, { runId, gate, expectedRevisionId, presentationLanguage })`
+in `packages/core/lib/control-inspect/artifact-readiness.js` (packaged as
+`runtime/create-agdf/runtime/core/lib/control-inspect/artifact-readiness.js` in the plugin). Same report; no writes.
+Do not search for internal validator signatures or invent a replacement validator.
+The existing Core `evaluateApprovalSummaryReadiness` remains the summary owner.
+For a German PRD summary use separate `- Ziel:`, `- Umfang:` and, when decisions exist,
+`- Entscheidungen:` lines; English summaries use `- Goal:`, `- Scope:` and `- Decisions:`.
+Each criterion has its own `- AC-...:` line. A combined label such as `Ziel und Umfang:` or
+`Entscheidungskontext:` is not one of these fields. Readiness and presentation share this validator;
+do not accept prose as a substitute or invent another parser. An eligible own unapproved format
+correction stays with the existing authoring continuation, once per diagnosed condition, followed
+by canonical replacement and fresh evaluation. A ready draft still needs actual editing intent;
+status is read-only, protected sources and unrelated blockers remain stopped.
+
+Prepare files under `.agdf/control/artefacts/<run_id>/` before recording. The single shared Core
+relationship registry selects PRD-derived_from-UR, SD-derived_from-PRD, TP-derived_from-SD or
+QA_REPORT-tests-TP. UR-approved_by remains exclusively approval-owned. QA recording copies an
+existing report's explicit Decision/Status value (`pass | revise | block`); it does not decide QA.
+
+The JSON object has exactly these fields:
+
+- `schema_version`: string `1`.
+- `target_id`: existing local command-target identity, SHA-256 of `agdf-command-target/1`, NUL,
+  and the canonical real absolute governance target. This is a binding, not authority.
+- `run_id`, `expected_revision_id`: the supplied selected run and current revision.
+- `destination`: exactly `type`, `path`, `digest`, `status`; logical registry type, canonical
+  run-local `<type>.md`, full canonical SHA-256 and `draft` for PRD/SD/TP, report decision for QA.
+- `source`: exactly `type`, `path`, `digest`; the registry's approved source and canonical digest.
+- `relationship`: exactly `from`, `relationship`, `to`; the explicit registry triple.
+- `review`: exactly `reviewer`, `path`, `digest`; named reviewer, separate contained mapping file
+  and its canonical SHA-256. Do not overwrite an earlier sealed proof file.
+- `update_draft`: boolean; true only for an explicit current-gate draft update.
+
+The mapping file is JSON with exactly `schema_version`, `target_id`, `run_id`, `relationship`,
+`destination`, `source`, `reviewer`, `reviewed`. Identity and source/destination objects match
+the recording input exactly; reviewer matches review.reviewer, and reviewed is boolean true.
+Digests use the existing canonical text/line-ending semantics. This is cooperative review
+attestation, never independent proof of a human review or semantic derivation. QA/review assesses
+the meaning. A prose header or gate order is not machine proof.
+
+The existing operation checks current permission, contained non-symlink files, exact approved
+sources and revision under locks. It appends its sealed Artefact Bindings receipt/history and
+publishes pointer, relationship and audit together. The receipt is writer-owned; do not hand-author
+it. An allowed draft replacement supersedes the prior active binding, retaining history. A changed
+draft is accepted only when its prior binding reconstructs the recorded seal and every other
+bound/approved byte remains unchanged. Otherwise stop with explicit maintenance/revision recovery.
+
+Before presentation/approval, a recorded eligible current artefact must have its evidenced source
+relationship. Missing artefacts remain draftable; a relationship-only blocker must not redraft the
+artefact repeatedly. Only authorized bound continuation can attempt one exact previously sealed
+proof correction before output. The shared Core continuation service coordinates this operation
+and fresh routing; the dispatcher service itself only reads and routes. Explicit status, doctor,
+evaluation and run-present never correct.
+Unknown/malformed/foreign/stale/ambiguous proof, missing full approval integrity or unrelated
+blockers remain blocked; legacy absence grants no correction permission. A successful correction
+creates a new audited revision and fresh evaluation without another approval. Terminal output
+already emitted is never intercepted. Older runtimes have no automatic correction capability.
+
+## Gate-Specific Work
+
+### PRD
+
+Semantic PRD drafting and clarification belongs exclusively to prd-definition under its focused
+contract. This module supplies the shared Reviewed Recording Input procedure only; gate-check
+controls prerequisites, readiness and presentation.
+
+### SD
+
+Semantic SD drafting and clarification belongs exclusively to sd-definition under its focused
+contract. This module supplies the shared Reviewed Recording Input procedure only; gate-check
+controls prerequisites, declared decision readiness, traceability and presentation.
+
+### TP
+
+Semantic TP drafting, clarification and explicit unapproved revision belong exclusively to
+tp-definition under its focused contract. This module supplies shared recording only; gate-check
+retains prerequisite/readiness and presentation authority.