create-agdf 0.14.3 → 0.14.4

package/generated/submissions/openai/agdf/meta/distribution-profile-history.json

@@ -0,0 +1,125 @@
+{
+  "schema_version": 1,
+  "contracts": {
+    "five-profile-v1": {
+      "distribution_profiles": {
+        "schemaVersion": 1,
+        "marketplaceIdentities": {
+          "durable": "agdf",
+          "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"
+          }
+        }
+      },
+      "contract_digest": "0211f4e6054a23f0a3ba302e57303adcb8f5903581e99643f803647dd156fe32"
+    },
+    "four-profile-v1": {
+      "distribution_profiles": {
+        "schemaVersion": 1,
+        "marketplaceIdentities": {
+          "durable": "agdf",
+          "generatedRepository": "agdf-repo"
+        },
+        "profiles": {
+          "source-development": {
+            "runtime": "absent",
+            "installable": false,
+            "machineValidation": "unavailable"
+          },
+          "runtime-plugin": {
+            "runtime": "required",
+            "installable": true,
+            "machineValidation": "local_exact_version_digest"
+          },
+          "opencode-config-local": {
+            "runtime": "config_local_package",
+            "installable": true,
+            "machineValidation": "local_exact_version"
+          },
+          "portable-skills": {
+            "runtime": "absent",
+            "installable": true,
+            "machineValidation": "unavailable_or_external_required"
+          }
+        }
+      },
+      "contract_digest": "9987baa4ea91e28a096cac2be8daa876f1c0593e7edbfe2e96b713814aa65ce8"
+    }
+  },
+  "releases": {
+    "0.13.6": {
+      "contract_id": "four-profile-v1",
+      "provenance_schema_version": 1,
+      "profile_id": "runtime-plugin",
+      "entry_digest": "1c21c3fa99cdd788994013f25cbe606ffdcea2cc91d53c679cf061567f652bf3",
+      "status": "supported"
+    },
+    "0.13.7": {
+      "contract_id": "four-profile-v1",
+      "provenance_schema_version": 1,
+      "profile_id": "runtime-plugin",
+      "entry_digest": "6d5383537d2640dc13773f2929dd94d0e7e219e82d08418464c77786b475c3ee",
+      "status": "supported"
+    },
+    "0.13.8": {
+      "contract_id": "four-profile-v1",
+      "provenance_schema_version": 1,
+      "profile_id": "runtime-plugin",
+      "entry_digest": "405e8cfa72ec2e469354dab52197675783b3723adb969a0692e56ba7c95c85c8",
+      "status": "supported"
+    },
+    "0.14.1": {
+      "contract_id": "four-profile-v1",
+      "provenance_schema_version": 1,
+      "profile_id": "runtime-plugin",
+      "entry_digest": "1a6fd6f6a411eddb29e82d7b7abc7d5f658312f555dcf39e160a709194a8b867",
+      "status": "supported"
+    },
+    "0.14.2": {
+      "contract_id": "five-profile-v1",
+      "provenance_schema_version": 1,
+      "profile_id": "runtime-plugin",
+      "entry_digest": "f71ee26df3d4a89ecc727a1c30b40221cf062fce9f716a83453bced9503be8fd",
+      "status": "supported"
+    },
+    "0.14.3": {
+      "contract_id": "five-profile-v1",
+      "provenance_schema_version": 1,
+      "profile_id": "runtime-plugin",
+      "entry_digest": "c5dbe4044d11a976cd4ccd6de6cf1405ebfcb4a26ce5c6308c34f10142db50c9",
+      "status": "supported"
+    },
+    "0.14.4": {
+      "contract_id": "five-profile-v1",
+      "provenance_schema_version": 1,
+      "profile_id": "runtime-plugin",
+      "entry_digest": "a441d633fe11ea402c3366cfac0cec659d32eae5eb4ae6b1d25a1e366a029813",
+      "status": "supported"
+    }
+  }
+}

package/generated/submissions/openai/agdf/skills/gate-check/SKILL.md

@@ -209,10 +209,12 @@ the primary chat card into an audit dump. Do not maintain or render a skill-loca
 
 This complete operational status table remains the status-reporting and detail
 surface. When the same response immediately requests a ready gate approval,
-render its five-field compact approval-time projection first, then the Gate
-Transition Card in the same immediately preceding assistant message, then
-invoke exactly one native question or exact-text fallback. Both cards derive
-from the same snapshot and are shown exactly once.
+render its five-field compact approval-time projection first, then the complete
+operational Run Status Card verbatim (or its localized failure line with
+diagnostic codes when undeliverable), then the Gate Transition Card in the same
+immediately preceding assistant message, then invoke exactly one native
+question or exact-text fallback. The runtime contract owns this sequence; every
+block is shown exactly once.
 
 If this skill creates or updates control artefacts, do not paste full file bodies into the chat.
 List paths, summarize the decision, name the blocker or approval needed, and keep the durable content in the files.

package/generated/submissions/openai/agdf/submission/openai/availability.md

@@ -1,6 +1,6 @@
 # Availability Decision Record
 
-- release: `0.14.3`
+- release: `0.14.4`
 - decision_state: `pending`
 - decision_owner: verified publisher
 - countries: not selected

package/generated/submissions/openai/agdf/submission/openai/capability-matrix.json

@@ -1,6 +1,6 @@
 {
   "schemaVersion": 1,
-  "releaseVersion": "0.14.3",
+  "releaseVersion": "0.14.4",
   "evidenceStates": [
     "common",
     "codex-specific",

package/generated/submissions/openai/agdf/submission/openai/inventory.json

@@ -1,11 +1,11 @@
 {
   "schemaVersion": 1,
-  "releaseVersion": "0.14.3",
-  "digest": "88a2d665f6b0a11cc7de1d0200979d58bc601164f0418faa66e200f7d8a6635c",
+  "releaseVersion": "0.14.4",
+  "digest": "594be5be291554c4567bcd711274498d9600a896d2e6b5f85ca941e1dff77d12",
   "files": [
     {
       "path": ".codex-plugin/plugin.json",
-      "sha256": "1723041a1f54829e14dd90d95017fe403e72074e569ae64fca4fc62f9d74b318"
+      "sha256": "44c8561c912ed14a44849a23597e1786612d58596e745df691e6f343c0c595f8"
     },
     {
       "path": "assets/agdf-icon.svg",
@@ -29,7 +29,7 @@
     },
     {
       "path": "meta/agdf-plugin.definition.json",
-      "sha256": "16b69b796510bf4f6907fd986ad64dcf8e5ac4f3860d12e0e62381ea2582b012"
+      "sha256": "c0b249067a3fea29e551af28ccc855bfb4e9c7ef95f418d96d7e102c53650159"
     },
     {
       "path": "meta/agdf-runtime-contract.md",
@@ -61,7 +61,7 @@
     },
     {
       "path": "meta/contracts/interaction.md",
-      "sha256": "799ff1d27f16004844775f2802a94d6d336d9130b08a6484c5f325d7ea6b0df8"
+      "sha256": "45cb0bf83af21d46e55f6fbbc934f7bf1571d0d087a0a304b629297427078ce9"
     },
     {
       "path": "meta/contracts/modes.md",
@@ -77,7 +77,11 @@
     },
     {
       "path": "meta/copilot-payload-baseline.json",
-      "sha256": "7f9d12592af01da501c2e5e2c4fc79cff86e7677384db3b2c72c6f8ec589aa4c"
+      "sha256": "c2d5f1fe5285898d90bc9a15972bc388b485b5d212b6952f01d07c2d71f41a17"
+    },
+    {
+      "path": "meta/distribution-profile-history.json",
+      "sha256": "63a78c2659fe6ece380883d10188e7dad7373866711aeca13005193b68be1ab2"
     },
     {
       "path": "skills/brownfield-analysis/SKILL.md",
@@ -121,7 +125,7 @@
     },
     {
       "path": "skills/gate-check/SKILL.md",
-      "sha256": "84b83b23f18e24ebea94b5f24f1e438de2c93da7740fbc1bba95281e98b68ae0"
+      "sha256": "7f49c12942fc4312fe57f6be1c9844a9bf1ec5c7c9cce43b1c1d3e81d6c7adbb"
     },
     {
       "path": "skills/gate-check/help.md",
@@ -161,23 +165,23 @@
     },
     {
       "path": "submission/openai/availability.md",
-      "sha256": "6e2a4d12acfd22a728841169ae5d68b57d303ec3632aba09b5aa6c64d033253b"
+      "sha256": "f92ddfc516a7ffa9abbb847118597bdcce52b0087adbe1c3066a7821a9ad22bc"
     },
     {
       "path": "submission/openai/capability-matrix.json",
-      "sha256": "81425b79a427492d3e46e6f665ebc65e5a6ad47b8e897044180a8946e91c94b9"
+      "sha256": "0839d499972d89c7d173f3193a3e54a5b82aecd280192f80bff09733998e6cd6"
     },
     {
       "path": "submission/openai/listing.json",
-      "sha256": "8302d3c25e7385767456b9ffa8a8939f9476cc28ce5a2357eb8b08cceb58fbb0"
+      "sha256": "c5a069a9047ded702678d928014434dc0b44ead7ecf2b7b84d3d45c1d842742b"
     },
     {
       "path": "submission/openai/release-notes.md",
-      "sha256": "ece61208d4538e5fd9a239d3c6bca98e1e0a34a5204fae1d4666b0bbaabf54f4"
+      "sha256": "30e0057bd7e0538b25ca5bcf276fb418887f2e7d1806b431c013ba0d095dabb6"
     },
     {
       "path": "submission/openai/reviewer-cases.json",
-      "sha256": "83b192f19d11e28ed16b33a81cadbcef8d6dd4b46bd2022841dc317ba6612b7a"
+      "sha256": "f145161287a42a891734e27f6c3b8c88fb873227d4d759c0867e60c17217e715"
     }
   ]
 }

package/generated/submissions/openai/agdf/submission/openai/listing.json

@@ -1,6 +1,6 @@
 {
   "schemaVersion": 1,
-  "releaseVersion": "0.14.3",
+  "releaseVersion": "0.14.4",
   "submissionType": "skills",
   "identity": {
     "technicalId": "agdf",

package/generated/submissions/openai/agdf/submission/openai/readiness.json

@@ -1,6 +1,6 @@
 {
   "schemaVersion": 1,
-  "releaseVersion": "0.14.3",
+  "releaseVersion": "0.14.4",
   "candidateState": "repository_ready",
   "submissionReady": false,
   "submissionBlockers": [
@@ -16,7 +16,7 @@
     },
     "bundle": {
       "state": "pass",
-      "detail": "44 inventoried files; inventory digest 88a2d665f6b0a11cc7de1d0200979d58bc601164f0418faa66e200f7d8a6635c"
+      "detail": "45 inventoried files; inventory digest 594be5be291554c4567bcd711274498d9600a896d2e6b5f85ca941e1dff77d12"
     },
     "installed_host": {
       "state": "unverified",

package/generated/submissions/openai/agdf/submission/openai/readiness.md

@@ -1,6 +1,6 @@
 # AGDF Public Plugin Readiness
 
-- release: `0.14.3`
+- release: `0.14.4`
 - candidate_state: `repository_ready`
 - submission_ready: `false`
 
@@ -9,7 +9,7 @@
 | Class | State | Detail |
 |---|---|---|
 | repository | pass | canonical contract and deterministic source checks |
-| bundle | pass | 44 inventoried files; inventory digest 88a2d665f6b0a11cc7de1d0200979d58bc601164f0418faa66e200f7d8a6635c |
+| bundle | pass | 45 inventoried files; inventory digest 594be5be291554c4567bcd711274498d9600a896d2e6b5f85ca941e1dff77d12 |
 | installed_host | unverified | PPD-L02 and PPD-L03 not performed |
 | portal | unverified | unverified |
 | post_publication | unverified | not published |

package/generated/submissions/openai/agdf/submission/openai/release-notes.md

@@ -1,4 +1,4 @@
-# AGDF 0.14.3 — Initial OpenAI Public Plugin Candidate
+# AGDF 0.14.4 — Initial OpenAI Public Plugin Candidate
 
 This candidate packages the canonical AGDF workflow skills for public discovery in ChatGPT and
 Codex. It helps users assess delivery fit, preserve explicit human approvals, inspect existing-system

package/generated/submissions/openai/agdf/submission/openai/reviewer-cases.json

@@ -1,6 +1,6 @@
 {
   "schemaVersion": 1,
-  "releaseVersion": "0.14.3",
+  "releaseVersion": "0.14.4",
   "cases": [
     {
       "id": "positive-proportional-fit",

package/lib/cli/application.js

@@ -279,10 +279,10 @@ function runLifecyclePhase(phase, operation) {
 
 function installNextAction(surface, runtimeChecks, fallback) {
   if (surface === "codex" && runtimeChecks.requested === "enabled" && runtimeChecks.effective === "decision_required") {
-    return "Restart Codex, then approve the AGDF session hook when Codex asks.";
+    return `${fallback} Approve the AGDF session hook when the fresh Codex session asks.`;
   }
   if (surface === "copilot" && runtimeChecks.requested === "enabled" && runtimeChecks.effective === "decision_required") {
-    return "Restart GitHub Copilot, then review the AGDF session hook when Copilot asks.";
+    return `${fallback} Review the AGDF session hook when the fresh Copilot session asks.`;
   }
   return fallback;
 }
@@ -430,9 +430,11 @@ function printInstallFailure(surface, error, options, io, command = surface) {
 
 function runDisable(options, { io, exec }) {
   try {
-    const plan = planRepositoryDisable(options.dir, options.surface);
+    const plan = planRepositoryDisable(options.dir, options.surface, { shared: options.shared, exec });
     const applied = applyLifecyclePlan(plan, exec ? { exec } : {});
-    const verified = applied.status === "success" ? verifyRepositoryDisabled(options.dir) : { status: "failed", evidence: [] };
+    const verified = applied.status === "success"
+      ? verifyRepositoryDisabled(options.dir, options.surface, { shared: options.shared })
+      : { status: "failed", evidence: [] };
     const result = applied.status === "success" && verified.status !== "healthy" ? "failed" : applied.status;
     const report = createLifecycleResult({
       operation: "disable",
@@ -440,9 +442,12 @@ function runDisable(options, { io, exec }) {
       surface: options.surface,
       scope: "repository",
       verification: { status: verified.status === "healthy" ? "healthy" : "degraded", evidence: [...applied.completed.map((item) => item.path || item.executable), ...verified.evidence] },
+      activation: { status: result === "success" ? "pending_restart" : "unknown" },
       restart: { required: result === "success", reason: result === "success" ? "host_reload" : "none" },
       next_action: result === "success"
-        ? { kind: "restart", text: "Restart the host in this repository; global AGDF availability and .agdf/control are retained." }
+        ? options.surface === "copilot"
+          ? { kind: "restart", text: "Restart GitHub Copilot in this repository, then inspect /plugin list; independent instructions remain separate." }
+          : { kind: "restart", text: "Restart the host in this repository; global AGDF availability and .agdf/control are retained." }
         : { kind: "verify", text: "Inspect the reported repository configuration failure before retrying disable." },
       changes: applied.completed,
       retained: applied.retained,
@@ -453,7 +458,20 @@ function runDisable(options, { io, exec }) {
     printLifecycleResult(report, { json: options.json, io });
     return result === "success" ? 0 : 1;
   } catch (error) {
-    io.error(error.message);
+    const report = lifecycleFailure({
+      operation: "disable",
+      surface: options.surface,
+      scope: "repository",
+      phase: "repository_preflight",
+      message: error.message,
+      evidence: [error.message],
+      nextAction: "Resolve the reported repository configuration or ignore precondition, then retry disable without changing unrelated files.",
+    });
+    if (options.json) printLifecycleResult(report, { json: true, io });
+    else {
+      io.error(error.message);
+      printLifecycleResult(report, { io });
+    }
     return 1;
   }
 }

package/lib/cli/command-registry.js

@@ -18,7 +18,7 @@ export const commandRegistry = Object.freeze([
   command("opencode-status", { preferred: [""], scaffold: [""] }),
   command("status", { preferred: [" [--surface <surface>] [--run <run_id>] [--json]"] }),
   command("runtime-checks", { preferred: [" <status|enable|manual> --surface <codex|claude|copilot|opencode> [--json]"] }),
-  command("disable", { preferred: [" --surface <surface> [--scope repository] [--dir <path>]"] }),
+  command("disable", { preferred: [" --surface <surface> [--scope repository] [--shared] [--dir <path>]"] }),
   command("uninstall", { preferred: [" --surface <surface> --scope global [--confirm]"] }),
   command("opencode-repo", { preferred: [""], scaffold: [""] }),
   command("init", { preferred: [""], scaffold: [""] }),
@@ -65,6 +65,12 @@ export function validateCommandOptions(options) {
     throw new Error("uninstall requires explicit --scope global");
   }
   if (options.confirm && options.target !== "uninstall") throw new Error("--confirm is supported only by uninstall");
+  if (options.shared && !(options.target === "disable" && options.surface === "copilot" && options.scope === "repository")) {
+    throw new Error("--shared is supported only by disable --surface copilot --scope repository");
+  }
+  if (options.target === "disable" && options.surface === "copilot" && options.scope !== "repository") {
+    throw new Error("Copilot disable requires explicit --scope repository");
+  }
   if (options.runtimeChecksDecision && !["codex", "claude", "copilot", "opencode"].includes(options.target)) {
     throw new Error("--runtime-checks is supported only by codex, claude, copilot and opencode installation commands");
   }
@@ -126,6 +132,7 @@ Options:
   --scope <repository|global>
                  Select the lifecycle mutation scope
   --confirm      Apply a previously previewed global uninstall plan
+  --shared       Apply Copilot repository disable through shared .github/copilot/settings.json
   --runtime-checks <enable|manual|cancel>
                  Make the installation-time automatic-check decision explicitly; no TTY defaults to manual
   --fixture <path>

package/lib/cli/parse-args.js

@@ -45,6 +45,7 @@ export function parseArgs(argv, dependencies = {}) {
   let allActive = false;
   let scope;
   let confirm = false;
+  let shared = false;
   let runtimeChecksDecision;
   let runtimeChecksAction;
 
@@ -61,6 +62,7 @@ export function parseArgs(argv, dependencies = {}) {
     if (arg === "--generate-candidates") { generateCandidates = true; continue; }
     if (arg === "--all-active") { allActive = true; continue; }
     if (arg === "--confirm") { confirm = true; continue; }
+    if (arg === "--shared") { shared = true; continue; }
 
     if (arg === "--runtime-checks") {
       const next = requiredValue(args, i, arg);
@@ -162,6 +164,7 @@ export function parseArgs(argv, dependencies = {}) {
       allActive,
       scope,
       confirm,
+      shared,
       runtimeChecksDecision,
       runtimeChecksAction: runtimeChecksAction ?? "status",
       generatorModel,

package/lib/control-evaluation/doctor.js

@@ -130,6 +130,19 @@ export function evaluateDoctor(targetDir, selection = {}) {
           "Add at least one evidence row or explicitly document that no evidence exists yet.",
         );
       }
+
+      for (const identityFinding of selectedRunState.identity_findings ?? []) {
+        addFinding(
+          findings,
+          "revise",
+          identityFinding.code,
+          identityFinding.code === "AGDF_RUN_ID_INVALID"
+            ? "The selected run state has a missing or invalid run_id; interaction cards cannot be rendered for it."
+            : "The selected run state has a missing or invalid revision_id; approval interactions cannot be rendered for it.",
+          runPath,
+          "Run run-migrate to repair the run identity, or migrate the legacy state to a canonical run record.",
+        );
+      }
     }
 
     const backlogPath = join(".agdf", "control", "MASTER_BACKLOG.md");

package/lib/control-evaluation/gate-check.js

@@ -1,4 +1,4 @@
-import { attachApprovalOrientationSnapshot, buildArtefactRefs, buildQualityReadiness, gateTitle, localePack, renderApprovalOrientationSnapshot, renderOperationalStatusCard, resolveHumanRunTitle } from '../interaction-presentation.js';
+import { attachApprovalOrientationSnapshot, buildArtefactRefs, buildQualityReadiness, gateTitle, localePack, renderApprovalOrientationSnapshot, renderOperationalStatusCard, resolveHumanRunTitle, validateApprovalOrientationPreconditions, validateApprovalOrientationSnapshot, validateOperationalStatusCardPreconditions } from '../interaction-presentation.js';
 import { interactionLocales, resolveConfiguredChatLanguage } from '../cli/runtime-context.js';
 import { evaluateDoctor } from './doctor.js';
 import { analyzeDeliveryMap, deriveQualityOutlook } from './delivery-map.js';
@@ -300,8 +300,9 @@ export function evaluateGateCheck(targetDir, selection = {}) {
     humanPresentation,
     revisionId,
   });
+  const readyForApproval = isReadyUserGateApproval({ status, currentGate, missingApproval });
   const approvalOrientation = attachApprovalOrientationSnapshot(statusCard, {
-    ready: isReadyUserGateApproval({ status, currentGate, missingApproval }),
+    ready: readyForApproval,
     humanPresentation,
     revisionId,
     registry: interactionLocales,
@@ -312,6 +313,50 @@ export function evaluateGateCheck(targetDir, selection = {}) {
     enumerable: false,
   });
 
+  const approvalPresentation = renderApprovalOrientationSnapshot(approvalOrientation, {
+    registry: interactionLocales,
+    expectedIdentity: {
+      run_id: statusCard.run_id,
+      revision_id: revisionId,
+      current_gate: currentGate,
+      presentation_language: statusCard.presentation_language,
+    },
+  });
+  const presentationDiagnostics = {};
+  if (!statusPresentation) {
+    presentationDiagnostics.status_presentation_errors = [
+      ...validateOperationalStatusCardPreconditions(statusCard, {
+        registry: interactionLocales,
+        humanPresentation,
+      }).errors,
+    ];
+  }
+  if (readyForApproval && !approvalPresentation) {
+    presentationDiagnostics.approval_presentation_errors = approvalOrientation
+      ? [
+          ...validateApprovalOrientationSnapshot(approvalOrientation, {
+            registry: interactionLocales,
+            expectedIdentity: {
+              run_id: statusCard.run_id,
+              revision_id: revisionId,
+              current_gate: currentGate,
+              presentation_language: statusCard.presentation_language,
+            },
+          }).errors,
+        ]
+      : [
+          ...validateApprovalOrientationPreconditions({
+            statusCard,
+            humanPresentation,
+            registry: interactionLocales,
+            requestedLocale: presentationLocale,
+          }).errors,
+        ];
+    if (!presentationDiagnostics.approval_presentation_errors.length) {
+      presentationDiagnostics.approval_presentation_errors = ["snapshot_unavailable"];
+    }
+  }
+
   return {
     schema_version: "1",
     status,
@@ -332,15 +377,8 @@ export function evaluateGateCheck(targetDir, selection = {}) {
     candidate_runs: runState.candidate_runs ?? [],
     status_card: statusCard,
     status_presentation: statusPresentation,
-    approval_presentation: renderApprovalOrientationSnapshot(approvalOrientation, {
-      registry: interactionLocales,
-      expectedIdentity: {
-        run_id: statusCard.run_id,
-        revision_id: revisionId,
-        current_gate: currentGate,
-        presentation_language: statusCard.presentation_language,
-      },
-    }),
+    approval_presentation: approvalPresentation,
+    ...(Object.keys(presentationDiagnostics).length ? { presentation_diagnostics: presentationDiagnostics } : {}),
     delivery_map: {
       relationships: deliveryMap.relationships,
       mode_slice_decision: runState.mode_slice_decision,
@@ -368,6 +406,14 @@ export function printApprovalEnvelope(report, { io = console, reEvaluate } = {})
   if (report?.approval_presentation) {
     io.log(report.approval_presentation.blocks.run_status_card.markdown);
     io.log("");
+    if (report.status_presentation?.markdown) {
+      io.log(report.status_presentation.markdown);
+    } else {
+      const pack = localePack(interactionLocales, report.approval_presentation.presentation_language || "en");
+      const codes = report.presentation_diagnostics?.status_presentation_errors ?? [];
+      io.log(codes.length ? `${pack.interaction.statusPresentationFailure} (${codes.join(", ")})` : pack.interaction.statusPresentationFailure);
+    }
+    io.log("");
     io.log(report.approval_presentation.blocks.gate_transition_card.markdown);
     io.log("");
     io.log(report.approval_presentation.approval_interaction.exact_text_fallback);
@@ -386,7 +432,10 @@ export function printApprovalEnvelope(report, { io = console, reEvaluate } = {})
   const pack = localePack(interactionLocales, refreshed?.status_card?.presentation_language || report?.status_card?.presentation_language || "en");
   const refreshedApproval = canonicalApprovalForReport(refreshed);
   if (initialApproval && refreshedApproval) {
-    io.log(pack.interaction.presentationFailure);
+    const codes = refreshed?.presentation_diagnostics?.approval_presentation_errors
+      ?? report?.presentation_diagnostics?.approval_presentation_errors
+      ?? [];
+    io.log(codes.length ? `${pack.interaction.presentationFailure} (${codes.join(", ")})` : pack.interaction.presentationFailure);
     io.log(pack.interaction.exactTextRequest.replace("{approval}", refreshedApproval));
     return Object.freeze({ outcome: "exact_text_recovery", requested_decision: true, status: refreshed.status });
   }
@@ -404,7 +453,9 @@ export function printApprovalEnvelope(report, { io = console, reEvaluate } = {})
 function printGateCheckStatusCard(report, io) {
   const card = report.status_card;
   if (!report.status_presentation?.markdown) {
-    io.log(localePack(interactionLocales, card?.presentation_language || "en").interaction.statusPresentationFailure);
+    const failure = localePack(interactionLocales, card?.presentation_language || "en").interaction.statusPresentationFailure;
+    const codes = report.presentation_diagnostics?.status_presentation_errors ?? [];
+    io.log(codes.length ? `${failure} (${codes.join(", ")})` : failure);
     return false;
   }
   io.log(report.status_presentation.markdown);

package/lib/control-evaluation/run-state.js

@@ -2,6 +2,7 @@ import { existsSync, readFileSync, realpathSync, statSync } from "node:fs";
 import { isAbsolute, join, relative, resolve } from "node:path";
 import process from "node:process";
 import { parseControlState, resolveRuns } from "../control-state/index.js";
+import { validateRunIdentity } from "../control-state/run-identity.js";
 import { buildRunCandidates } from "../interaction-presentation.js";
 import { cleanStatusCell, filled, isPlaceholderValue, readTargetFile } from "./shared.js";
 import { extractField, isSafeRepoRelativePath, readVerifiedChangeRecord } from "./verified-change.js";
@@ -87,6 +88,7 @@ export function readRunState(targetDir, selection = {}) {
       memory: {},
       candidate_runs: candidateRuns,
       resolution_error: resolutionError,
+      identity_findings: [],
     };
   }
 
@@ -101,6 +103,10 @@ export function readRunState(targetDir, selection = {}) {
     path: runPath,
     content,
     ...parsed,
+    identity_findings: validateRunIdentity({
+      runId: extractField(content, "run_id").replace(/^`|`$/g, ""),
+      revisionId: extractField(content, "revision_id").replace(/^`|`$/g, ""),
+    }),
   };
 }
 

package/lib/control-state/run-identity.js

@@ -0,0 +1,9 @@
+export const RUN_ID_PATTERN = /^[a-z0-9][a-z0-9._-]{0,127}$/;
+export const REVISION_ID_PATTERN = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
+
+export function validateRunIdentity({ runId, revisionId } = {}) {
+  const findings = [];
+  if (!RUN_ID_PATTERN.test(String(runId ?? ""))) findings.push({ code: "AGDF_RUN_ID_INVALID" });
+  if (!REVISION_ID_PATTERN.test(String(revisionId ?? ""))) findings.push({ code: "AGDF_RUN_REVISION_ID_INVALID" });
+  return findings;
+}

package/lib/control-state/run-state-parser.js

@@ -1,4 +1,6 @@
-export const RUN_ID_PATTERN = /^[a-z0-9][a-z0-9._-]{0,127}$/;
+import { REVISION_ID_PATTERN, RUN_ID_PATTERN } from "./run-identity.js";
+
+export { RUN_ID_PATTERN } from "./run-identity.js";
 export const LIFECYCLES = new Set([
   "active",
   "completed",
@@ -34,7 +36,7 @@ export function parseRunState(content, expected) {
     findings.push({ code: "AGDF_RUN_LIFECYCLE_INVALID" });
   if (!/^[1-9]\d*$/.test(values.get("revision") ?? ""))
     findings.push({ code: "AGDF_RUN_REVISION_INVALID" });
-  if (!/^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i.test(values.get("revision_id") ?? ""))
+  if (!REVISION_ID_PATTERN.test(values.get("revision_id") ?? ""))
     findings.push({ code: "AGDF_RUN_REVISION_ID_INVALID" });
   return {
     content,