create-agdf 0.10.2 → 0.11.0

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

@@ -1,4 +1,4 @@
-import { attachApprovalOrientationSnapshot, buildArtefactRefs, buildQualityReadiness, formatArtefactRefs, gateTitle, localePack, renderApprovalOrientationSnapshot, resolveHumanRunTitle } from '../interaction-presentation.js';
+import { attachApprovalOrientationSnapshot, buildArtefactRefs, buildQualityReadiness, gateTitle, localePack, renderApprovalOrientationSnapshot, renderOperationalStatusCard, resolveHumanRunTitle } from '../interaction-presentation.js';
 import { interactionLocales, resolveConfiguredChatLanguage } from '../cli/runtime-context.js';
 import { evaluateDoctor } from './doctor.js';
 import { analyzeDeliveryMap, deriveQualityOutlook } from './delivery-map.js';
@@ -292,6 +292,11 @@ export function evaluateGateCheck(targetDir, selection = {}) {
     enumerable: false,
   });
   const revisionId = extractField(runState.content ?? "", "revision_id");
+  const statusPresentation = renderOperationalStatusCard(statusCard, {
+    registry: interactionLocales,
+    humanPresentation,
+    revisionId,
+  });
   const approvalOrientation = attachApprovalOrientationSnapshot(statusCard, {
     ready: isReadyUserGateApproval({ status, currentGate, missingApproval }),
     humanPresentation,
@@ -323,6 +328,7 @@ export function evaluateGateCheck(targetDir, selection = {}) {
     native_attempt_required: statusCard.native_attempt_required,
     candidate_runs: runState.candidate_runs ?? [],
     status_card: statusCard,
+    status_presentation: statusPresentation,
     approval_presentation: renderApprovalOrientationSnapshot(approvalOrientation, {
       registry: interactionLocales,
       expectedIdentity: {
@@ -392,28 +398,12 @@ export function printApprovalEnvelope(report, { io = console, reEvaluate } = {})
 
 function printGateCheckStatusCard(report, io) {
   const card = report.status_card;
-  const labels = localePack(interactionLocales, card.presentation_language).statusCard;
-  const primary = localePack(interactionLocales, card.presentation_language).primary;
-  const presentation = card.humanPresentation ?? {
-    runTitle: card.run_id,
-    gateTitle: gateTitle(interactionLocales, card.presentation_language, card.current_gate),
-    artefactRefs: buildArtefactRefs({}, interactionLocales, card.presentation_language),
-  };
-  io.log(`${labels.title}: ${primary.status[card.status] ?? card.status}`);
-  io.log(`${labels.run}: ${card.run_id}`);
-  io.log(`${labels.humanTitle}: ${presentation.runTitle}`);
-  io.log(`${labels.gate}: ${card.current_gate} — ${presentation.gateTitle}`);
-  io.log(`${labels.lifecycle}: ${primary.lifecycle[card.delivery_state] ?? primary.lifecycle.unknown}`);
-  io.log(`${labels.artefacts}: ${formatArtefactRefs(presentation.artefactRefs)}`);
-  io.log(`${labels.blocked}: ${card.blocking_condition === "none" ? primary.none : primary.blocked}`);
-  io.log(`${labels.missing}: ${card.missing_approval === "none" ? primary.none : card.missing_approval}`);
-  if (card.next_gate_after_approval !== "none") {
-    io.log(`${labels.nextGate}: ${card.next_gate_after_approval} — ${gateTitle(interactionLocales, card.presentation_language, card.next_gate_after_approval)}`);
-    io.log(`${labels.allowedAfter}: ${primary.afterApproval[card.current_gate] ?? primary.actions[card.current_gate]}`);
+  if (!report.status_presentation?.markdown) {
+    io.log(localePack(interactionLocales, card?.presentation_language || "en").interaction.statusPresentationFailure);
+    return false;
   }
-  io.log(`${labels.allowed}: ${primary.actions[card.current_gate] ?? primary.none}`);
-  io.log(`${labels.step}: ${primary.actions[card.current_gate] ?? primary.none}`);
-  io.log(`${labels.quality}: ${primary.quality}`);
+  io.log(report.status_presentation.markdown);
+  const primary = localePack(interactionLocales, card.presentation_language).primary;
   const readiness = qualityReadinessForRunState(card.runState, report.next_allowed_action);
   if (readiness) {
     const quality = localePack(interactionLocales, card.presentation_language).qualityReadiness;
@@ -429,17 +419,17 @@ function printGateCheckStatusCard(report, io) {
     io.log(`${quality.nextAction}: ${readiness.next_action || primary.none}`);
     io.log(`${quality.decisionOwner}: ${quality.decisionOwnerValue}`);
   }
+  return true;
 }
 
 export function printGateCheckReport(report, json, statusCard = false, io = console) {
   if (json) {
     io.log(JSON.stringify(report, null, 2));
-    return;
+    return true;
   }
 
   if (statusCard) {
-    printGateCheckStatusCard(report, io);
-    return;
+    return printGateCheckStatusCard(report, io);
   }
 
   io.log(`AGDF gate-check: ${report.status}`);
@@ -456,4 +446,5 @@ export function printGateCheckReport(report, json, statusCard = false, io = cons
   for (const item of report.forbidden) io.log(`- ${item}`);
   io.log("");
   io.log(`Next allowed action: ${report.next_allowed_action}`);
+  return true;
 }

package/lib/installers/opencode.js

@@ -14,6 +14,7 @@ const globalOpenCodeSkillOwnershipMarker = "<!-- AGDF-GLOBAL-SKILL: ";
 const globalOpenCodeInstructionsOwnershipMarker = "<!-- AGDF-GLOBAL-INSTRUCTIONS -->";
 const globalOpenCodeRuntimeContractOwnershipMarker = "<!-- AGDF-GLOBAL-RUNTIME-CONTRACT -->";
 const globalOpenCodeValidatorOwnershipMarker = "// AGDF-GLOBAL-LOCAL-VALIDATOR";
+const globalOpenCodeValidatorPackageOwner = "create-agdf";
 const testNpmCliPath = process.env.NODE_ENV === "test" ? process.env.AGDF_TEST_NPM_CLI_PATH || "" : "";
 const npmCommand = testNpmCliPath ? process.execPath : process.platform === "win32" ? process.execPath : "npm";
 const npmPrefixArgs = testNpmCliPath ? [testNpmCliPath] : process.platform === "win32" ? [join(dirname(process.execPath), "node_modules", "npm", "bin", "npm-cli.js")] : [];
@@ -74,16 +75,23 @@ export function installOpenCodeGlobalPlugin(configDir) {
   nextConfig.instructions = [...(nextConfig.instructions ?? [])];
   if (!nextConfig.instructions.includes("AGDF.md")) nextConfig.instructions.push("AGDF.md");
 
+  const canonicalPermissions = pluginDefinition.opencode.permissions;
   if (nextConfig.permission === undefined) {
-    nextConfig.permission = { question: "allow", skill: { "agdf-*": "allow" } };
+    nextConfig.permission = JSON.parse(JSON.stringify(canonicalPermissions));
   } else if (nextConfig.permission && typeof nextConfig.permission === "object" && !Array.isArray(nextConfig.permission)) {
     nextConfig.permission = { ...nextConfig.permission };
-    if (nextConfig.permission.question === undefined) nextConfig.permission.question = "allow";
+    for (const permissionName of ["question", "edit", "bash"]) {
+      if (nextConfig.permission[permissionName] === undefined) {
+        nextConfig.permission[permissionName] = canonicalPermissions[permissionName];
+      }
+    }
     if (nextConfig.permission.skill === undefined) {
-      nextConfig.permission.skill = { "agdf-*": "allow" };
+      nextConfig.permission.skill = { ...canonicalPermissions.skill };
     } else if (nextConfig.permission.skill && typeof nextConfig.permission.skill === "object" && !Array.isArray(nextConfig.permission.skill)) {
       nextConfig.permission.skill = { ...nextConfig.permission.skill };
-      if (nextConfig.permission.skill["agdf-*"] === undefined) nextConfig.permission.skill["agdf-*"] = "allow";
+      for (const [skillPattern, decision] of Object.entries(canonicalPermissions.skill)) {
+        if (nextConfig.permission.skill[skillPattern] === undefined) nextConfig.permission.skill[skillPattern] = decision;
+      }
     }
   }
 
@@ -122,9 +130,35 @@ function globalOpenCodeConfigPaths(configDir) {
     contracts: join(configDir, "contracts"),
     skills: join(configDir, "skills"),
     localValidator: join(configDir, "agdf", "bin", "agdf-local.js"),
+    localValidatorPackage: join(configDir, "agdf", "package.json"),
   };
 }
 
+function readGlobalOpenCodeValidatorPackage(path) {
+  if (!existsSync(path)) return null;
+  let existing;
+  try {
+    existing = JSON.parse(readFileSync(path, "utf8"));
+  } catch {
+    return null;
+  }
+  return existing;
+}
+
+function globalOpenCodeValidatorPackageIsValid(path) {
+  const manifest = readGlobalOpenCodeValidatorPackage(path);
+  return manifest?.type === "module"
+    && manifest?.agdf?.owner === globalOpenCodeValidatorPackageOwner
+    && manifest?.agdf?.surface === "opencode-global-validator";
+}
+
+function assertGlobalOpenCodeValidatorPackageWritable(path) {
+  if (!existsSync(path)) return;
+  if (!globalOpenCodeValidatorPackageIsValid(path)) {
+    throw new Error(`Refusing to overwrite unowned global OpenCode validator package: ${path}`);
+  }
+}
+
 function globalOpenCodeOwnershipMarkerIsValid(content, marker, placement) {
   const lines = content.split(/\r?\n/);
   if (placement === "first-line") return lines[0] === marker;
@@ -145,6 +179,7 @@ function assertGlobalOpenCodeSurfaceWritable(configDir) {
   assertGlobalOpenCodeFileWritable(paths.instructions, globalOpenCodeInstructionsOwnershipMarker, "first-line");
   assertGlobalOpenCodeFileWritable(paths.runtimeContract, globalOpenCodeRuntimeContractOwnershipMarker, "first-line");
   assertGlobalOpenCodeFileWritable(paths.localValidator, globalOpenCodeValidatorOwnershipMarker, "first-line");
+  assertGlobalOpenCodeValidatorPackageWritable(paths.localValidatorPackage);
   for (const moduleName of contractModules) {
     assertGlobalOpenCodeFileWritable(
       join(paths.contracts, moduleName),
@@ -202,6 +237,7 @@ function toGlobalOpenCodeContent(content) {
 }
 
 export function installOpenCodeGlobalSurface(configDir) {
+  assertGlobalOpenCodeSurfaceWritable(configDir);
   const paths = globalOpenCodeConfigPaths(configDir);
   const generatedOpenCodeRoot = join(generatedRoot, ".opencode");
   const generatedInstructions = readFileSync(join(generatedOpenCodeRoot, pluginDefinition.opencode.instructionsFileName), "utf8");
@@ -223,6 +259,16 @@ export function installOpenCodeGlobalSurface(configDir) {
   writeOwnedGlobalOpenCodeFile(paths.instructions, globalInstructions, globalOpenCodeInstructionsOwnershipMarker, "first-line");
   writeOwnedGlobalOpenCodeFile(paths.runtimeContract, globalRuntimeContract, globalOpenCodeRuntimeContractOwnershipMarker, "first-line");
   writeOwnedGlobalOpenCodeFile(paths.localValidator, localValidator, globalOpenCodeValidatorOwnershipMarker, "first-line");
+  mkdirSync(dirname(paths.localValidatorPackage), { recursive: true });
+  writeFileSync(paths.localValidatorPackage, `${JSON.stringify({
+    name: "agdf-opencode-validator-runtime",
+    private: true,
+    type: "module",
+    agdf: {
+      owner: globalOpenCodeValidatorPackageOwner,
+      surface: "opencode-global-validator",
+    },
+  }, null, 2)}\n`, "utf8");
   for (const moduleName of contractModules) {
     const generatedModule = readFileSync(join(generatedOpenCodeRoot, "contracts", moduleName), "utf8");
     writeOwnedGlobalOpenCodeFile(
@@ -249,6 +295,7 @@ export function installOpenCodeGlobalSurface(configDir) {
     contracts: paths.contracts,
     skills: paths.skills,
     localValidator: paths.localValidator,
+    localValidatorPackage: paths.localValidatorPackage,
   };
 }
 
@@ -352,6 +399,7 @@ function evaluateGlobalOpenCodeSurface(configDir) {
       && contractCount === contractModules.length
       && skillCount === openCodeSkillNames.length
       && existsSync(paths.localValidator)
+      && globalOpenCodeValidatorPackageIsValid(paths.localValidatorPackage)
       && validatorResolution.envelope.machine_validation === "owned_version_matched",
   };
 }

package/lib/interaction-presentation.js

@@ -269,6 +269,86 @@ export function formatArtefactRefs(refs) {
   return refs.map((ref) => ref.exists ? `[${ref.label}](${ref.path})` : ref.missingLabel).join(" · ");
 }
 
+function markdownCell(value) {
+  return String(value ?? "")
+    .replaceAll("\\", "\\\\")
+    .replaceAll("|", "\\|")
+    .replaceAll("&", "&")
+    .replaceAll("<", "&lt;")
+    .replaceAll(">", "&gt;")
+    .replace(/\r?\n/g, "<br>");
+}
+
+function operationalList(value, none) {
+  if (!Array.isArray(value) || value.length === 0) return none;
+  return value.map((item) => String(item ?? "").trim()).filter(Boolean).join("\n") || none;
+}
+
+function operationalBreadcrumb(value, labels) {
+  if (!Array.isArray(value) || value.length === 0) return "";
+  const marker = {
+    fulfilled: labels.breadcrumbFulfilled,
+    current: labels.breadcrumbCurrent,
+    open: labels.breadcrumbOpen,
+  };
+  return value.map((item) => `${marker[item?.status] ?? labels.breadcrumbOpen} ${String(item?.gate ?? "").trim()}`)
+    .filter((item) => item.trim())
+    .join(labels.breadcrumbSeparator);
+}
+
+export function renderOperationalStatusCard(statusCard, {
+  registry,
+  humanPresentation,
+  revisionId = "",
+} = {}) {
+  if (!plainObject(statusCard) || !plainObject(humanPresentation)) return null;
+  const runId = String(statusCard.run_id ?? "").trim();
+  const currentGate = String(statusCard.current_gate ?? "").trim();
+  const revision = String(revisionId ?? "").trim() || "unversioned";
+  const locale = resolvePresentationLocale(registry, statusCard.presentation_language);
+  if (!runId || !currentGate || !locale) return null;
+
+  const pack = localePack(registry, locale);
+  const labels = pack.statusCard;
+  const primary = pack.primary;
+  const none = primary.none;
+  const gateLabel = String(humanPresentation.gateTitle ?? "").trim() || gateTitle(registry, locale, currentGate);
+  const runTitle = displaySafeTitle(humanPresentation.runTitle, normalizedRunTitle(runId));
+  const breadcrumb = operationalBreadcrumb(statusCard.breadcrumb, labels);
+  const rows = [
+    [labels.run, `${runTitle} · \`${runId}\``],
+    ...(breadcrumb ? [[labels.breadcrumb, breadcrumb]] : []),
+    [labels.status, primary.status[statusCard.status] ?? statusCard.status],
+    [labels.gate, `${gateLabel} (\`${currentGate}\`)`],
+    [labels.allowed, operationalList(statusCard.allowed_now, none)],
+    [labels.forbidden, operationalList(statusCard.forbidden_now, none)],
+    [labels.blocked, statusCard.blocking_condition === "none" ? none : statusCard.blocking_condition],
+    [labels.missing, statusCard.missing_approval === "none" ? none : statusCard.missing_approval],
+    [labels.nextGate, statusCard.next_gate_after_approval === "none" ? none : statusCard.next_gate_after_approval],
+    [labels.allowedAfter, statusCard.allowed_after_approval === "none" ? none : statusCard.allowed_after_approval],
+    [labels.step, statusCard.next_step || none],
+    [labels.quality, statusCard.quality_outlook || none],
+  ];
+  const markdown = [
+    `## ${labels.title}`,
+    "",
+    `| ${labels.field} | ${labels.value} |`,
+    "|---|---|",
+    ...rows.map(([label, value]) => `| ${markdownCell(label)} | ${markdownCell(value)} |`),
+  ].join("\n");
+
+  return Object.freeze({
+    schema_version: "1",
+    semantic_block: "run_status_card",
+    run_id: runId,
+    revision_id: revision,
+    current_gate: currentGate,
+    presentation_language: locale,
+    markdown,
+    authorizes: false,
+  });
+}
+
 export function gateOptions(registry, requestedLocale, gate, { includeCancel = false } = {}) {
   const pack = localePack(registry, requestedLocale);
   const options = [

package/lib/scaffold/plan.js

@@ -30,6 +30,7 @@ const codexPluginFiles = [
   join("plugins", "agdf", "control", "templates", "artefacts", "BROWNFIELD_REVIEW.md"),
   join("plugins", "agdf", "control", "templates", "artefacts", "VERIFIED_CHANGE.md"),
   join("plugins", "agdf", "control", "templates", "artefacts", "PRD.md"),
+  join("plugins", "agdf", "control", "templates", "artefacts", "UX_INTENT_DEFINITION.md"),
   join("plugins", "agdf", "control", "templates", "artefacts", "SD.md"),
   join("plugins", "agdf", "control", "templates", "artefacts", "TP.md"),
   join("plugins", "agdf", "control", "templates", "artefacts", "QA_REPORT.md"),
@@ -56,6 +57,7 @@ const controlFiles = [
   join(".agdf", "control", "templates", "artefacts", "BROWNFIELD_REVIEW.md"),
   join(".agdf", "control", "templates", "artefacts", "VERIFIED_CHANGE.md"),
   join(".agdf", "control", "templates", "artefacts", "PRD.md"),
+  join(".agdf", "control", "templates", "artefacts", "UX_INTENT_DEFINITION.md"),
   join(".agdf", "control", "templates", "artefacts", "SD.md"),
   join(".agdf", "control", "templates", "artefacts", "TP.md"),
   join(".agdf", "control", "templates", "artefacts", "QA_REPORT.md"),
@@ -88,6 +90,7 @@ const artefactTemplateFiles = [
   join(".agdf", "control", "templates", "artefacts", "BROWNFIELD_REVIEW.md"),
   join(".agdf", "control", "templates", "artefacts", "VERIFIED_CHANGE.md"),
   join(".agdf", "control", "templates", "artefacts", "PRD.md"),
+  join(".agdf", "control", "templates", "artefacts", "UX_INTENT_DEFINITION.md"),
   join(".agdf", "control", "templates", "artefacts", "SD.md"),
   join(".agdf", "control", "templates", "artefacts", "TP.md"),
   join(".agdf", "control", "templates", "artefacts", "QA_REPORT.md"),

package/package.json

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