create-agdf 0.8.5 → 0.8.7

package/lib/interaction-presentation.js

@@ -2,6 +2,7 @@ const REQUIRED_GATES = ["UR", "PRD", "SD", "TP", "QA", "UAT"];
 const ARTEFACT_ORDER = ["UR", "PRD", "SD", "TP"];
 const OUTCOMES = new Set(["approve", "revise", "decline", "cancel", "no_response", "timeout", "empty", "invalid", "stale"]);
 const ATTEMPT_OUTCOMES = new Set(["presented", "unavailable_before_invocation", "attempted_not_applied", "unsafe_to_wait"]);
+const APPROVAL_VALUE_TRANSPORTS = new Set(["exact_option_value", "separate_label_and_value", "decorated_label_only", "unknown"]);
 const APPROVAL_SEQUENCE = Object.freeze(["run_status_card", "gate_transition_card", "approval_interaction"]);
 const QUALITY_STATUS_RANK = { pass: 0, warn: 1, revise: 2, block: 3 };
 const QUALITY_DIMENSIONS = Object.freeze([
@@ -63,7 +64,7 @@ export function validateLocaleRegistry(registry) {
     for (const [key, value] of visibleStrings(pack)) {
       if (!value.trim()) errors.push(`empty_copy:${locale}:${key}`);
       const budget = key.startsWith("gateTitles.") ? budgets.title
-        : key.includes("Description") || key.includes("fallbackReasons") || key.startsWith("primary.actions.") || key.startsWith("primary.afterApproval.") || key === "primary.quality"
+        : key.includes("Description") || key.includes("fallbackReasons") || key.startsWith("primary.actions.") || key.startsWith("primary.afterApproval.") || key.startsWith("primary.narration.") || key.startsWith("gateRationale.") || key.startsWith("interaction.why.") || key === "primary.quality"
           ? budgets.description
           : budgets.label;
       if (Number.isInteger(budget) && value.length > budget) errors.push(`length_budget:${locale}:${key}`);
@@ -96,6 +97,10 @@ export function gateTitle(registry, requestedLocale, gate) {
   return localePack(registry, requestedLocale).gateTitles[gate] || String(gate || "");
 }
 
+export function gateRationale(registry, requestedLocale, gate) {
+  return localePack(registry, requestedLocale).gateRationale?.[gate] || String(gate || "");
+}
+
 function stripMarkdown(value) {
   return String(value ?? "")
     .replace(/^#+\s*/, "")
@@ -180,10 +185,31 @@ export function reconcileRunScope({ requestText = "", scopeKey = "", runs = [] }
   return Object.freeze({ outcome: matches[0].lifecycle === "active" ? "active_match" : "completed_match", matches, reason: "exact_match" });
 }
 
-export function executeNativeApprovalAttempt({ ready = false, orientationSnapshot, invokeNative, fallback } = {}) {
+export function evaluateNativeApprovalCapability({ staticCapability, runtimeCapability } = {}) {
+  const staticValue = staticCapability?.approvalValueTransport;
+  const runtimeValue = runtimeCapability?.approvalValueTransport;
+  if (runtimeCapability && staticCapability && (runtimeValue !== staticValue || runtimeCapability.waitSafety !== staticCapability.waitSafety)) {
+    return Object.freeze({ eligible: false, native_attempt_required: false, preflight_outcome: "unavailable_before_invocation", reason: "capability_conflict", evidence_source: "runtime" });
+  }
+  const capability = runtimeCapability ?? staticCapability;
+  const evidenceSource = runtimeCapability ? "runtime" : staticCapability ? "static" : "none";
+  if (!capability || !APPROVAL_VALUE_TRANSPORTS.has(capability.approvalValueTransport)) return Object.freeze({ eligible: false, native_attempt_required: false, preflight_outcome: "unavailable_before_invocation", reason: "capability_missing", evidence_source: evidenceSource });
+  if (capability.waitSafety === "unsafe") return Object.freeze({ eligible: false, native_attempt_required: false, preflight_outcome: "unsafe_to_wait", reason: "unsafe_wait", evidence_source: evidenceSource });
+  if (capability.waitSafety !== "deliberate_no_auto_resolution") return Object.freeze({ eligible: false, native_attempt_required: false, preflight_outcome: "unavailable_before_invocation", reason: "capability_missing", evidence_source: evidenceSource });
+  if (!new Set(["exact_option_value", "separate_label_and_value"]).has(capability.approvalValueTransport)) return Object.freeze({ eligible: false, native_attempt_required: false, preflight_outcome: "unavailable_before_invocation", reason: capability.approvalValueTransport === "decorated_label_only" ? "decorated_only" : "capability_missing", evidence_source: evidenceSource });
+  return Object.freeze({ eligible: true, native_attempt_required: true, preflight_outcome: "eligible_for_invocation", reason: capability.approvalValueTransport === "exact_option_value" ? "exact_transport" : "separate_value_transport", evidence_source: evidenceSource });
+}
+
+export function executeNativeApprovalAttempt({ ready = false, orientationSnapshot, capabilityPreflight, invokeNative, fallback } = {}) {
   if (!ready) return Object.freeze({ attempted: false, outcome: "unavailable_before_invocation", reason: "gate_not_ready", authorizes: false });
   const preflight = validateApprovalOrientationSnapshot(orientationSnapshot);
   if (!preflight.valid) return Object.freeze({ attempted: false, outcome: "unavailable_before_invocation", reason: "orientation_preflight_failed", authorizes: false });
+  if (!capabilityPreflight?.eligible) {
+    const outcome = capabilityPreflight?.preflight_outcome === "unsafe_to_wait" ? "unsafe_to_wait" : "unavailable_before_invocation";
+    const reason = capabilityPreflight?.reason || "capability_missing";
+    if (typeof fallback === "function") fallback({ outcome, reason });
+    return Object.freeze({ attempted: false, outcome, reason, authorizes: false });
+  }
   if (typeof invokeNative !== "function") return Object.freeze({ attempted: false, outcome: "unavailable_before_invocation", reason: "adapter_unavailable", authorizes: false });
   let adapterResult;
   try {
@@ -395,6 +421,66 @@ export function buildQualityReadiness({
   });
 }
 
+export function collapseInternalState(
+  { modeSliceDecision = "", verifiedChangeState = "", contextGraphRequiredAction = "", multiScopeState = "" } = {},
+  registry,
+  requestedLocale,
+) {
+  const pack = localePack(registry, requestedLocale);
+  const labels = pack.internalStateLabels || {};
+  const result = {};
+  if (modeSliceDecision === "verified_change") {
+    if (verifiedChangeState === "escalated") {
+      result.verified_change = labels.verifiedChangeEscalated || "Escalated to structured delivery";
+    } else if (["missing", "draft", "invalid", "eligible", "executed"].includes(verifiedChangeState)) {
+      result.verified_change = labels.verifiedChange || "Compact change under review";
+    }
+  }
+  if (contextGraphRequiredAction === "open_gap") {
+    result.context_graph = labels.contextGraphOpenGap || "Graph gap open";
+  } else if (["link", "update", "create", "resolve_drift"].includes(contextGraphRequiredAction)) {
+    result.context_graph = labels.contextGraphMaintained || "Project memory maintained";
+  }
+  if (multiScopeState === "blocked") {
+    result.multi_scope = labels.multiScopeBlocked || "Ambiguous scope, clarification needed";
+  }
+  return result;
+}
+
+export function buildBreadcrumb(breadcrumb, registry, requestedLocale) {
+  if (!Array.isArray(breadcrumb)) return "";
+  const pack = localePack(registry, requestedLocale);
+  const cardLabels = pack.statusCard || {};
+  const titles = pack.gateTitles || {};
+  const sep = cardLabels.breadcrumbSeparator || " \u00b7 ";
+  const symbols = {
+    fulfilled: cardLabels.breadcrumbFulfilled || "\u2713",
+    current: cardLabels.breadcrumbCurrent || "\u25cf",
+    open: cardLabels.breadcrumbOpen || "\u25cb",
+  };
+  return breadcrumb
+    .map((entry) => {
+      const title = titles[entry.gate] || entry.gate;
+      const symbol = symbols[entry.status] || symbols.open;
+      return `${title} ${symbol}`;
+    })
+    .join(sep);
+}
+
+export function buildTransitionNarration(gate, registry, requestedLocale) {
+  const pack = localePack(registry, requestedLocale);
+  const narration = pack.primary?.narration || {};
+  const gateTitles = pack.gateTitles || {};
+  const gateTitle = gateTitles[gate] || gate;
+  const gateConfig = narration.gates?.[gate] || {};
+  const agentNext = gateConfig.agentNext || "";
+  const userAction = gateConfig.userAction || narration.noAction || "no user action required now";
+  if (!agentNext) return "";
+  const gateSatisfiedTemplate = narration.gateSatisfied || "{gate} approved";
+  const gateSatisfied = gateSatisfiedTemplate.replace("{gate}", gateTitle);
+  return `${gateSatisfied} \u2192 ${agentNext} \u2192 ${userAction}`;
+}
+
 export const interactionPresentationConstants = Object.freeze({
   artefactOrder: Object.freeze([...ARTEFACT_ORDER]),
   outcomes: Object.freeze([...OUTCOMES]),

package/package.json

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