create-agdf 0.8.3 → 0.8.4

package/bin/create-agdf.js

@@ -2259,10 +2259,14 @@ function buildStatusCard({
   const qualityOutlook = deriveQualityOutlook(runState, findings);
   const postApproval = postApprovalTransition(missingApproval);
   const isUserGateApproval = missingApproval !== "none";
+  const lifecycle = extractField(runState.content ?? "", "lifecycle") || "unknown";
+  const nativeAttemptRequired = status === "open" && isUserGateApproval;
   return {
     run_id: extractField(runState.content ?? "", "run_id") || "unknown",
     presentation_language: chatLanguage,
     mode: extractField(runState.content ?? "", "mode") || "unknown",
+    lifecycle,
+    delivery_state: lifecycle === "completed" && currentGate === "OR" ? "completed_closeout_pending" : lifecycle,
     status,
     current_gate: currentGate,
     mode_slice_decision: runState.mode_slice_decision?.decision || "undecided",
@@ -2280,6 +2284,8 @@ function buildStatusCard({
     next_skill: nextSkillByGate[currentGate] ?? "gate-check",
     next_step: nextAllowedAction,
     quality_outlook: qualityOutlook,
+    interaction_kind: nativeAttemptRequired ? "gate_approval" : status === "blocked" ? "blocked" : "status",
+    native_attempt_required: nativeAttemptRequired,
   };
 }
 
@@ -2736,6 +2742,8 @@ function evaluateGateCheck(targetDir, selection = {}) {
     doctor_summary: doctorReport.summary,
     evidence_refs: runState.evidence_refs,
     quality_outlook: deriveQualityOutlook(runState, deliveryMap.findings),
+    interaction_kind: statusCard.interaction_kind,
+    native_attempt_required: statusCard.native_attempt_required,
     candidate_runs: runState.candidate_runs ?? [],
     status_card: statusCard,
     delivery_map: {
@@ -2764,6 +2772,7 @@ function printGateCheckStatusCard(report) {
   console.log(`${labels.run}: ${card.run_id}`);
   console.log(`${labels.humanTitle}: ${presentation.runTitle}`);
   console.log(`${labels.gate}: ${card.current_gate} — ${presentation.gateTitle}`);
+  console.log(`${labels.lifecycle}: ${primary.lifecycle[card.delivery_state] ?? primary.lifecycle.unknown}`);
   console.log(`${labels.artefacts}: ${formatArtefactRefs(presentation.artefactRefs)}`);
   console.log(`${labels.blocked}: ${card.blocking_condition === "none" ? primary.none : primary.blocked}`);
   console.log(`${labels.missing}: ${card.missing_approval === "none" ? primary.none : card.missing_approval}`);

package/generated/.github/skills/agdf-gate-check/SKILL.md

@@ -75,6 +75,12 @@ For a ready `gate_approval`:
 13. Reject a missing artefact, ambiguous or wrong run, wrong gate, stale expected gate, timeout/default, hook-supplied answer, agent message, technical permission outcome or plan approval.
 14. Persist accepted input only through the existing control-state workflow.
 
+The ready-gate projection must expose `native_attempt_required: true`. Treat this as a mandatory
+orchestration instruction: after rendering the two cards, invoke the configured native question
+adapter exactly once before using the exact-text fallback. A hook, permission result or session
+context message cannot replace that attempt or supply its answer. For every non-ready interaction,
+the signal is absent or false and no approval control may be shown.
+
 Before composing the question, resolve the configured chat locale from `.agdf/control/config.json` through `../agdf-interaction-locales.json`: exact complete pack, language subtag, then English fallback. German and English are initial packs, not a closed language list. Keep `Approval: <GateName>` exactly unchanged in every language, and do not mix presentation languages within one interaction. Labels and descriptions use the same resolved locale; host-owned UI chrome remains host-owned and may use a different language.
 
 For the transition card, use the complete resolved locale pack. The initial German pack includes `Bereit für deine Entscheidung`, `Jetzt freigeben` and `Danach`; the initial English pack includes `Ready for your decision`, `Approve now` and `Next`. Keep each card in one locale. Use a localized human-readable gate title rather than an internal status label, while leaving the exact gate identifier and approval value unchanged. Do not render a Markdown table, dashboard rows, raw control-state keys, diagnostic codes, evidence lists, a duplicated gate question or a false user gate in the approval-time card.

package/generated/.github/skills/agdf-interaction-locales.json

@@ -25,6 +25,7 @@
         "skill": "Next skill",
         "step": "Next step",
         "quality": "Quality outlook",
+        "lifecycle": "Delivery status",
         "allowed": "Allowed now",
         "forbidden": "Forbidden now",
         "artefacts": "Artefacts"
@@ -91,6 +92,13 @@
         "none": "none",
         "blocked": "current gate prerequisites",
         "quality": "Keep the presentation contract, evidence and gate authority aligned.",
+        "lifecycle": {
+          "active": "in progress",
+          "completed_closeout_pending": "completed — delivery closeout pending",
+          "completed": "completed",
+          "blocked": "blocked",
+          "unknown": "status not available"
+        },
         "actions": {
           "UR": "Clarify and approve the user requirements.",
           "Brownfield Review": "Review existing owners and choose the smallest safe delivery path.",
@@ -132,6 +140,7 @@
         "skill": "Nächster Skill",
         "step": "Nächster Schritt",
         "quality": "Qualitätsausblick",
+        "lifecycle": "Lieferstatus",
         "allowed": "Jetzt erlaubt",
         "forbidden": "Aktuell verboten",
         "artefacts": "Artefakte"
@@ -198,6 +207,13 @@
         "none": "keine",
         "blocked": "Voraussetzungen des aktuellen Gates",
         "quality": "Präsentationsvertrag, Nachweise und Gate-Berechtigung konsistent halten.",
+        "lifecycle": {
+          "active": "in Arbeit",
+          "completed_closeout_pending": "abgeschlossen — Abschluss offen",
+          "completed": "abgeschlossen",
+          "blocked": "blockiert",
+          "unknown": "Status nicht verfügbar"
+        },
         "actions": {
           "UR": "Nutzeranforderungen klären und freigeben.",
           "Brownfield Review": "Bestehende Owner prüfen und den kleinsten sicheren Lieferweg wählen.",

package/generated/.github/skills/agdf-runtime-contract.md

@@ -390,6 +390,7 @@ interaction_kind: clarification | tool_permission | gate_approval | blocked | st
 surface: codex | claude | opencode | fallback
 run_id: required for gate_approval
 current_gate: required for gate_approval
+native_attempt_required: true only for an eligible gate_approval before the first adapter attempt
 prompt: required
 options: required for a structured question
 effects: required when the interaction can cause side effects
@@ -420,6 +421,12 @@ Before presenting `gate_approval`, the agent must:
 6. reject missing evidence, ambiguous or wrong run, wrong gate, stale state and any response that is no longer valid;
 7. persist an accepted approval only through the existing control-state workflow.
 
+For an eligible `gate_approval`, `native_attempt_required` is a mandatory orchestration signal. The
+agent must make exactly one configured native adapter attempt after the two orientation cards and
+before any exact-text fallback. Hooks may prepare context but must not answer, approve or replace
+the adapter attempt. The signal is absent or false for clarification, blocked, status-only,
+internal-step and non-ready interactions.
+
 The first eligible native-attempt has a single bounded outcome: the declared
 host control is presented, or the agent immediately uses the exact-text
 fallback. A host that does not apply the control does not trigger a second

package/generated/.opencode/agdf-interaction-locales.json

@@ -25,6 +25,7 @@
         "skill": "Next skill",
         "step": "Next step",
         "quality": "Quality outlook",
+        "lifecycle": "Delivery status",
         "allowed": "Allowed now",
         "forbidden": "Forbidden now",
         "artefacts": "Artefacts"
@@ -91,6 +92,13 @@
         "none": "none",
         "blocked": "current gate prerequisites",
         "quality": "Keep the presentation contract, evidence and gate authority aligned.",
+        "lifecycle": {
+          "active": "in progress",
+          "completed_closeout_pending": "completed — delivery closeout pending",
+          "completed": "completed",
+          "blocked": "blocked",
+          "unknown": "status not available"
+        },
         "actions": {
           "UR": "Clarify and approve the user requirements.",
           "Brownfield Review": "Review existing owners and choose the smallest safe delivery path.",
@@ -132,6 +140,7 @@
         "skill": "Nächster Skill",
         "step": "Nächster Schritt",
         "quality": "Qualitätsausblick",
+        "lifecycle": "Lieferstatus",
         "allowed": "Jetzt erlaubt",
         "forbidden": "Aktuell verboten",
         "artefacts": "Artefakte"
@@ -198,6 +207,13 @@
         "none": "keine",
         "blocked": "Voraussetzungen des aktuellen Gates",
         "quality": "Präsentationsvertrag, Nachweise und Gate-Berechtigung konsistent halten.",
+        "lifecycle": {
+          "active": "in Arbeit",
+          "completed_closeout_pending": "abgeschlossen — Abschluss offen",
+          "completed": "abgeschlossen",
+          "blocked": "blockiert",
+          "unknown": "Status nicht verfügbar"
+        },
         "actions": {
           "UR": "Nutzeranforderungen klären und freigeben.",
           "Brownfield Review": "Bestehende Owner prüfen und den kleinsten sicheren Lieferweg wählen.",

package/generated/.opencode/agdf-runtime-contract.md

@@ -390,6 +390,7 @@ interaction_kind: clarification | tool_permission | gate_approval | blocked | st
 surface: codex | claude | opencode | fallback
 run_id: required for gate_approval
 current_gate: required for gate_approval
+native_attempt_required: true only for an eligible gate_approval before the first adapter attempt
 prompt: required
 options: required for a structured question
 effects: required when the interaction can cause side effects
@@ -420,6 +421,12 @@ Before presenting `gate_approval`, the agent must:
 6. reject missing evidence, ambiguous or wrong run, wrong gate, stale state and any response that is no longer valid;
 7. persist an accepted approval only through the existing control-state workflow.
 
+For an eligible `gate_approval`, `native_attempt_required` is a mandatory orchestration signal. The
+agent must make exactly one configured native adapter attempt after the two orientation cards and
+before any exact-text fallback. Hooks may prepare context but must not answer, approve or replace
+the adapter attempt. The signal is absent or false for clarification, blocked, status-only,
+internal-step and non-ready interactions.
+
 The first eligible native-attempt has a single bounded outcome: the declared
 host control is presented, or the agent immediately uses the exact-text
 fallback. A host that does not apply the control does not trigger a second

package/generated/.opencode/skills/agdf-gate-check/SKILL.md

@@ -75,6 +75,12 @@ For a ready `gate_approval`:
 13. Reject a missing artefact, ambiguous or wrong run, wrong gate, stale expected gate, timeout/default, hook-supplied answer, agent message, technical permission outcome or plan approval.
 14. Persist accepted input only through the existing control-state workflow.
 
+The ready-gate projection must expose `native_attempt_required: true`. Treat this as a mandatory
+orchestration instruction: after rendering the two cards, invoke the configured native question
+adapter exactly once before using the exact-text fallback. A hook, permission result or session
+context message cannot replace that attempt or supply its answer. For every non-ready interaction,
+the signal is absent or false and no approval control may be shown.
+
 Before composing the question, resolve the configured chat locale from `.agdf/control/config.json` through `../../agdf-interaction-locales.json`: exact complete pack, language subtag, then English fallback. German and English are initial packs, not a closed language list. Keep `Approval: <GateName>` exactly unchanged in every language, and do not mix presentation languages within one interaction. Labels and descriptions use the same resolved locale; host-owned UI chrome remains host-owned and may use a different language.
 
 For the transition card, use the complete resolved locale pack. The initial German pack includes `Bereit für deine Entscheidung`, `Jetzt freigeben` and `Danach`; the initial English pack includes `Ready for your decision`, `Approve now` and `Next`. Keep each card in one locale. Use a localized human-readable gate title rather than an internal status label, while leaving the exact gate identifier and approval value unchanged. Do not render a Markdown table, dashboard rows, raw control-state keys, diagnostic codes, evidence lists, a duplicated gate question or a false user gate in the approval-time card.

package/generated/plugins/agdf/.codex-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "agdf",
-  "version": "0.8.3",
+  "version": "0.8.4",
   "description": "Codex-first operating system for governed AI-assisted delivery.",
   "author": {
     "name": "Arndt Gold",

package/generated/plugins/agdf/meta/agdf-interaction-locales.json

@@ -25,6 +25,7 @@
         "skill": "Next skill",
         "step": "Next step",
         "quality": "Quality outlook",
+        "lifecycle": "Delivery status",
         "allowed": "Allowed now",
         "forbidden": "Forbidden now",
         "artefacts": "Artefacts"
@@ -91,6 +92,13 @@
         "none": "none",
         "blocked": "current gate prerequisites",
         "quality": "Keep the presentation contract, evidence and gate authority aligned.",
+        "lifecycle": {
+          "active": "in progress",
+          "completed_closeout_pending": "completed — delivery closeout pending",
+          "completed": "completed",
+          "blocked": "blocked",
+          "unknown": "status not available"
+        },
         "actions": {
           "UR": "Clarify and approve the user requirements.",
           "Brownfield Review": "Review existing owners and choose the smallest safe delivery path.",
@@ -132,6 +140,7 @@
         "skill": "Nächster Skill",
         "step": "Nächster Schritt",
         "quality": "Qualitätsausblick",
+        "lifecycle": "Lieferstatus",
         "allowed": "Jetzt erlaubt",
         "forbidden": "Aktuell verboten",
         "artefacts": "Artefakte"
@@ -198,6 +207,13 @@
         "none": "keine",
         "blocked": "Voraussetzungen des aktuellen Gates",
         "quality": "Präsentationsvertrag, Nachweise und Gate-Berechtigung konsistent halten.",
+        "lifecycle": {
+          "active": "in Arbeit",
+          "completed_closeout_pending": "abgeschlossen — Abschluss offen",
+          "completed": "abgeschlossen",
+          "blocked": "blockiert",
+          "unknown": "Status nicht verfügbar"
+        },
         "actions": {
           "UR": "Nutzeranforderungen klären und freigeben.",
           "Brownfield Review": "Bestehende Owner prüfen und den kleinsten sicheren Lieferweg wählen.",

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

@@ -1,7 +1,7 @@
 {
   "schemaVersion": 1,
   "id": "agdf",
-  "version": "0.8.3",
+  "version": "0.8.4",
   "displayName": "AI Governance & Delivery Framework",
   "developerName": "Arndt Gold",
   "description": "Codex-first operating system for governed AI-assisted delivery.",

package/generated/plugins/agdf/meta/agdf-runtime-contract.md

@@ -390,6 +390,7 @@ interaction_kind: clarification | tool_permission | gate_approval | blocked | st
 surface: codex | claude | opencode | fallback
 run_id: required for gate_approval
 current_gate: required for gate_approval
+native_attempt_required: true only for an eligible gate_approval before the first adapter attempt
 prompt: required
 options: required for a structured question
 effects: required when the interaction can cause side effects
@@ -420,6 +421,12 @@ Before presenting `gate_approval`, the agent must:
 6. reject missing evidence, ambiguous or wrong run, wrong gate, stale state and any response that is no longer valid;
 7. persist an accepted approval only through the existing control-state workflow.
 
+For an eligible `gate_approval`, `native_attempt_required` is a mandatory orchestration signal. The
+agent must make exactly one configured native adapter attempt after the two orientation cards and
+before any exact-text fallback. Hooks may prepare context but must not answer, approve or replace
+the adapter attempt. The signal is absent or false for clarification, blocked, status-only,
+internal-step and non-ready interactions.
+
 The first eligible native-attempt has a single bounded outcome: the declared
 host control is presented, or the agent immediately uses the exact-text
 fallback. A host that does not apply the control does not trigger a second

package/generated/plugins/agdf/skills/gate-check/SKILL.md

@@ -75,6 +75,12 @@ For a ready `gate_approval`:
 13. Reject a missing artefact, ambiguous or wrong run, wrong gate, stale expected gate, timeout/default, hook-supplied answer, agent message, technical permission outcome or plan approval.
 14. Persist accepted input only through the existing control-state workflow.
 
+The ready-gate projection must expose `native_attempt_required: true`. Treat this as a mandatory
+orchestration instruction: after rendering the two cards, invoke the configured native question
+adapter exactly once before using the exact-text fallback. A hook, permission result or session
+context message cannot replace that attempt or supply its answer. For every non-ready interaction,
+the signal is absent or false and no approval control may be shown.
+
 Before composing the question, resolve the configured chat locale from `.agdf/control/config.json` through `plugin/meta/agdf-interaction-locales.json`: exact complete pack, language subtag, then English fallback. German and English are initial packs, not a closed language list. Keep `Approval: <GateName>` exactly unchanged in every language, and do not mix presentation languages within one interaction. Labels and descriptions use the same resolved locale; host-owned UI chrome remains host-owned and may use a different language.
 
 For the transition card, use the complete resolved locale pack. The initial German pack includes `Bereit für deine Entscheidung`, `Jetzt freigeben` and `Danach`; the initial English pack includes `Ready for your decision`, `Approve now` and `Next`. Keep each card in one locale. Use a localized human-readable gate title rather than an internal status label, while leaving the exact gate identifier and approval value unchanged. Do not render a Markdown table, dashboard rows, raw control-state keys, diagnostic codes, evidence lists, a duplicated gate question or a false user gate in the approval-time card.

package/lib/interaction-presentation.js

@@ -147,6 +147,57 @@ export function buildRunCandidates(runs) {
     .sort((left, right) => left.display_title.localeCompare(right.display_title) || left.run_id.localeCompare(right.run_id));
 }
 
+export function normalizeReconciliationText(value) {
+  return String(value ?? "")
+    .normalize("NFKC")
+    .toLowerCase()
+    .replace(/[._:/\\-]+/g, " ")
+    .replace(/[^\p{L}\p{N}\s]+/gu, " ")
+    .replace(/\s+/g, " ")
+    .trim();
+}
+
+export function reconcileRunScope({ requestText = "", scopeKey = "", runs = [] } = {}) {
+  const requested = normalizeReconciliationText(scopeKey || requestText);
+  if (!requested) return Object.freeze({ outcome: "match_uncertain", matches: [], reason: "scope_input_missing" });
+  const matches = [...(runs ?? [])]
+    .filter((run) => run?.valid && ["active", "completed"].includes(run?.meta?.lifecycle) && typeof run.run_id === "string")
+    .filter((run) => {
+      const keys = [run.scope_key, run.display_title, run.current_artefact_heading, run.ur_heading]
+        .map(normalizeReconciliationText)
+        .filter(Boolean);
+      return keys.includes(requested);
+    })
+    .map((run) => Object.freeze({
+      run_id: run.run_id,
+      lifecycle: run.meta.lifecycle,
+      display_title: displaySafeTitle(run.display_title || run.ur_heading || run.run_id, normalizedRunTitle(run.run_id)),
+      current_gate: run.control_state?.current_gate || run.meta?.current_gate || "unknown",
+    }))
+    .sort((left, right) => left.run_id.localeCompare(right.run_id));
+  if (matches.length !== 1) return Object.freeze({ outcome: matches.length ? "match_uncertain" : "no_match", matches, reason: matches.length > 1 ? "multiple_exact_matches" : "no_exact_match" });
+  return Object.freeze({ outcome: matches[0].lifecycle === "active" ? "active_match" : "completed_match", matches, reason: "exact_match" });
+}
+
+export function executeNativeApprovalAttempt({ ready = false, invokeNative, fallback } = {}) {
+  if (!ready) return Object.freeze({ attempted: false, outcome: "unavailable_before_invocation", reason: "gate_not_ready", authorizes: false });
+  if (typeof invokeNative !== "function") return Object.freeze({ attempted: false, outcome: "unavailable_before_invocation", reason: "adapter_unavailable", authorizes: false });
+  let adapterResult;
+  try {
+    adapterResult = invokeNative();
+  } catch (error) {
+    adapterResult = { outcome: "attempted_not_applied", reason: String(error?.message || "adapter_error") };
+  }
+  const outcome = ATTEMPT_OUTCOMES.has(adapterResult?.outcome)
+    ? adapterResult.outcome
+    : adapterResult?.presented === true || adapterResult?.applied === true
+      ? "presented"
+      : "attempted_not_applied";
+  const reason = String(adapterResult?.reason || "").trim();
+  if (outcome !== "presented" && typeof fallback === "function") fallback({ outcome, reason });
+  return Object.freeze({ attempted: true, outcome, reason, authorizes: false });
+}
+
 export function buildInteractionAttempt({ interactionId, runId, currentGate, surface, attemptOutcome, expectedApproval, fallbackReason = "" }) {
   if (!ATTEMPT_OUTCOMES.has(attemptOutcome)) throw new Error("invalid interaction attempt outcome");
   if (!String(interactionId ?? "").trim() || !String(runId ?? "").trim() || !String(currentGate ?? "").trim())

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-agdf",
-  "version": "0.8.3",
+  "version": "0.8.4",
   "description": "Bootstrap AGDF repository-local plugin files, Copilot/OpenCode instructions, skills, control files and machine-readable checks.",
   "type": "module",
   "files": [