@akanjs/cli 3.1.0-rc.2 → 3.1.0-rc.21

package/{index-rhbabmja.js → index-033wne2j.js}

@@ -2,7 +2,10 @@
 import {
   AppExecutor,
   LibExecutor
-} from "./index-2etqq75t.js";
+} from "./index-g6ax17x4.js";
+
+// pkgs/@akanjs/devkit/workflow/artifacts.ts
+import { capitalize } from "akanjs/common";
 
 // pkgs/@akanjs/devkit/workflow/utils.ts
 var jsonText = (value, { trailingNewline = true } = {}) => `${JSON.stringify(value, null, 2)}${trailingNewline ? `
@@ -22,7 +25,6 @@ var uniqueBy = (values, key) => {
 var compactDiagnostics = (diagnostics) => diagnostics.filter((diagnostic) => !!diagnostic);
 
 // pkgs/@akanjs/devkit/workflow/artifacts.ts
-import { capitalize } from "akanjs/common";
 var sourceChangeBlocked = (diagnostics) => diagnostics.some((diagnostic) => diagnostic.severity === "error" && (diagnostic.failureScope === "source-change" || !diagnostic.failureScope || diagnostic.failureScope === "unknown"));
 var workflowPlanApproval = {
   required: true,
@@ -139,7 +141,7 @@ var writeWorkflowRunArtifact = async (workspace, artifact) => {
   return { runId, path: artifactPath, artifact: artifactWithMetadata };
 };
 var workflowSyncDir = ".akan/workflows/sync";
-var syncStateSlug = (target) => target.trim().replace(/[^a-zA-Z0-9]+/g, "-").replace(/^-+|-+$/g, "").toLowerCase();
+var syncStateSlug = (target) => target.trim().replace(/[^a-zA-Z0-9]+/g, "-").replace(/^-|-$/g, "").toLowerCase();
 var workflowSyncStatePath = (target) => `${workflowSyncDir}/${syncStateSlug(target) || "target"}.json`;
 var generatedFilePathsForTarget = (targetRoot, reason = "Generated files were refreshed by sync.") => [
   { path: `${targetRoot}/lib/cnst.ts`, action: "sync", reason },
@@ -383,260 +385,6 @@ var createRepairReport = ({
   generatedFiles,
   ...syncedAt ? { syncedAt } : {}
 });
-
-// pkgs/@akanjs/devkit/workflow/render.ts
-var listOr = (items, render, empty = "- none") => items?.length ? items.map(render) : [empty];
-var renderDiagnostic = (diagnostic) => `- [${diagnostic.severity}] ${diagnostic.code}: ${diagnostic.message}`;
-var renderCommand = (entry) => `- \`${entry.command}\`: ${entry.reason}`;
-var renderFile = (file) => `- \`${file.action}\` ${file.path}: ${file.reason}`;
-var renderRecommendation = (recommendation) => {
-  const target = recommendation.target ? ` ${recommendation.target}` : "";
-  const action = recommendation.action ? ` Action: ${recommendation.action}` : "";
-  return `- [${recommendation.kind}]${target} ${recommendation.message}${action}`;
-};
-var renderWorkflowList = (specs) => [
-  "# Akan Workflows",
-  "",
-  ...specs.flatMap((spec) => [`- \`${spec.name}\`: ${spec.description}`, `  - When: ${spec.whenToUse}`]),
-  ""
-].join(`
-`);
-var renderWorkflowExplain = (spec) => [
-  `# Workflow: ${spec.name}`,
-  "",
-  spec.description,
-  "",
-  "## When To Use",
-  spec.whenToUse,
-  "",
-  "## Inputs",
-  ...Object.entries(spec.inputs).map(([name, input]) => `- \`${name}\`${input.required ? " (required)" : ""}: ${input.description}${input.allowedValues ? ` Allowed: ${input.allowedValues.join(", ")}.` : ""}`),
-  "",
-  "## Optional Surfaces",
-  ...Object.entries(spec.optionalSurfaces ?? {}).map(([name, mode]) => `- \`${name}\`: ${mode}`),
-  "",
-  "## Steps",
-  ...spec.steps.map((step, index) => `${index + 1}. \`${step.id}\` (${step.tool}): ${step.description}`),
-  "",
-  "## Validation",
-  ...spec.validation.map(renderCommand),
-  ""
-].join(`
-`);
-var renderWorkflowPlan = (plan) => [
-  `# Workflow Plan: ${plan.workflow}`,
-  "",
-  `- Mode: ${plan.mode}`,
-  `- Requires approval: ${plan.requiresApproval}`,
-  `- Approval: ${plan.approval?.meaning ?? "Review this read-only plan before applying workflow mutations."}`,
-  "",
-  "## Inputs",
-  ...Object.entries(plan.inputs).map(([name, value]) => `- \`${name}\`: ${Array.isArray(value) ? value.join(", ") : value}`),
-  "",
-  "## Optional Surfaces",
-  ...Object.entries(plan.optionalSurfaces).map(([name, mode]) => `- \`${name}\`: ${mode}`),
-  "",
-  "## Steps",
-  ...plan.steps.map((step, index) => `${index + 1}. \`${step.id}\` (${step.tool}): ${step.description}`),
-  "",
-  "## Predicted Changes",
-  ...plan.predictedChanges.map((change) => {
-    const scope = change.applyScope ? ` (${change.applyScope})` : "";
-    return `- \`${change.action}\`${scope} ${change.target}: ${change.reason}`;
-  }),
-  "",
-  "## Validation",
-  ...plan.validation.map(renderCommand),
-  "",
-  "## Diagnostics",
-  ...listOr(plan.diagnostics, renderDiagnostic),
-  "",
-  "## Recommendations",
-  ...listOr(plan.recommendations, (recommendation) => `- [${recommendation.kind}] ${recommendation.message}`),
-  ""
-].join(`
-`);
-var renderWorkflowApplyReport = (report) => {
-  const applySummary = {
-    sourceFilesChanged: report.summary?.sourceFilesChanged ?? report.changedFiles,
-    generatedFilesSynced: report.summary?.generatedFilesSynced ?? report.generatedFiles
-  };
-  const manualReviewItems = [
-    ...report.diagnostics.filter((diagnostic) => diagnostic.severity === "warning").map(renderDiagnostic),
-    ...report.recommendations.filter((recommendation) => recommendation.kind === "manual-action").map(renderRecommendation)
-  ];
-  const validationBlockers = report.diagnostics.filter((diagnostic) => diagnostic.severity === "error" && (diagnostic.failureScope === "workspace-config" || diagnostic.failureScope === "environment")).map(renderDiagnostic);
-  const sourceBlockers = report.diagnostics.filter((diagnostic) => diagnostic.severity === "error" && (diagnostic.failureScope === "source-change" || !diagnostic.failureScope || diagnostic.failureScope === "unknown")).map(renderDiagnostic);
-  return [
-    `# Workflow Apply: ${report.workflow}`,
-    "",
-    `- Mode: ${report.mode}`,
-    `- Status: ${report.status}`,
-    `- Source-change status: ${sourceBlockers.length ? "failed" : "passed"}`,
-    `- Workspace status: ${validationBlockers.length ? "blocked" : "not blocked during apply"}`,
-    `- Source files changed: ${applySummary.sourceFilesChanged.length}`,
-    `- Generated files queued for sync: ${applySummary.generatedFilesSynced.length}`,
-    ...report.validationTarget ? [`- Validation target: ${report.validationTarget}`] : [],
-    "",
-    "## Apply Checks",
-    ...report.postApplyChecks?.length ? report.postApplyChecks.map((check) => `- [${check.status}] ${check.code} ${check.target}: ${check.message}`) : ["- not run"],
-    "",
-    "## Source Change Blockers",
-    ...sourceBlockers.length ? sourceBlockers : ["- none"],
-    "",
-    "## Automatically Modified",
-    ...listOr(applySummary.sourceFilesChanged, renderFile),
-    "",
-    "## Generated Sync",
-    ...listOr(applySummary.generatedFilesSynced, renderFile),
-    "",
-    "## Applied Commands",
-    ...listOr(report.appliedCommands, renderCommand),
-    "",
-    "## Recommended Validation Commands",
-    ...listOr(report.recommendedValidationCommands, renderCommand),
-    "",
-    "## User Review Required",
-    ...manualReviewItems.length ? manualReviewItems : ["- none"],
-    "",
-    "## Validation Blockers",
-    ...validationBlockers.length ? validationBlockers : report.recommendedValidationCommands.length ? ["- none detected during apply; run validation with the validation target for command-level blockers."] : ["- none"],
-    "",
-    "## Diagnostics",
-    ...listOr(report.diagnostics, renderDiagnostic),
-    "",
-    "## Recommendations",
-    ...listOr(report.recommendations.slice(0, 3), renderRecommendation),
-    "",
-    "## Next Actions",
-    ...listOr(report.nextActions.slice(0, 3), renderCommand),
-    ""
-  ].join(`
-`);
-};
-var renderWorkflowApply = (report, format = "markdown") => format === "json" ? jsonText(report) : renderWorkflowApplyReport(report);
-var renderWorkflowValidationRunReport = (report) => {
-  const baselineSummary = report.baselineSummary ?? {
-    status: report.baselineDiagnostics?.some((diagnostic) => diagnostic.severity === "error") ? "failed" : "unknown",
-    total: report.baselineDiagnostics?.length ?? 0,
-    totalErrors: report.baselineDiagnostics?.filter((diagnostic) => diagnostic.severity === "error").length ?? 0,
-    totalWarnings: report.baselineDiagnostics?.filter((diagnostic) => diagnostic.severity === "warning").length ?? 0,
-    detailsIncluded: true,
-    knownBlockerCount: report.knownBlockers.filter((blocker) => blocker.known).length,
-    byCode: []
-  };
-  return [
-    `# Workflow Validation: ${report.workflow}`,
-    "",
-    `- Run: ${report.runId}`,
-    `- Status: ${report.status}`,
-    `- Source status: ${report.sourceStatus}`,
-    `- Workspace status: ${report.workspaceStatus}`,
-    `- Validation commands status: ${report.validationCommandsStatus ?? "unknown"}`,
-    `- Baseline status: ${report.baselineStatus ?? baselineSummary.status}`,
-    `- Overall status: ${report.overallStatus}`,
-    "",
-    "## Status Summary",
-    `- Source-change: ${report.summary.sourceChange}`,
-    `- Generated sync: ${report.summary.generatedSync}`,
-    `- Validation commands: ${report.summary.validationCommands ?? "unknown"}`,
-    `- Baseline: ${report.summary.baseline ?? baselineSummary.status}`,
-    `- Workspace config: ${report.summary.workspaceConfig}`,
-    `- Environment: ${report.summary.environment}`,
-    "",
-    "## Source Change Diagnostics",
-    ...listOr(report.workflowDiagnostics, renderDiagnostic),
-    "",
-    "## Existing Workspace Blockers",
-    `- Status: ${baselineSummary.status}`,
-    `- Errors: ${baselineSummary.totalErrors}`,
-    `- Warnings: ${baselineSummary.totalWarnings}`,
-    ...listOr(baselineSummary.byCode, (item) => `- [${item.severity}] ${item.code} (${item.count}x): ${item.sampleMessage}`),
-    ...baselineSummary.detailsIncluded ? [] : [
-      "- Baseline details are summarized by default. Re-run validation with includeBaselineDetails=true for full baselineDiagnostics."
-    ],
-    "",
-    "## Existing Workspace Blocker Details",
-    ...listOr(report.baselineDiagnostics, renderDiagnostic, baselineSummary.detailsIncluded ? "- none" : "- omitted"),
-    "",
-    "## Known Blockers",
-    ...listOr(report.knownBlockers, (blocker) => {
-      const command = blocker.command ? ` \`${blocker.command}\`` : "";
-      const count = blocker.count > 1 ? ` (${blocker.count}x)` : "";
-      const known = blocker.known ? " known" : "";
-      return `- [${blocker.failureScope}${known}]${command}${count}: ${blocker.message}`;
-    }),
-    "",
-    "## Commands",
-    ...listOr(report.commands, (command) => {
-      const scope = command.failureScope ? ` (${command.failureScope})` : "";
-      return `- [${command.status}] \`${command.command}\`${scope}: ${command.reason}`;
-    }),
-    "",
-    "## Diagnostics",
-    ...listOr(report.diagnostics, renderDiagnostic),
-    "",
-    "## Repair Actions",
-    ...listOr(report.repairActions, renderCommand),
-    "",
-    "## Next Actions",
-    ...listOr(report.nextActions, renderCommand),
-    ""
-  ].join(`
-`);
-};
-var renderWorkflowValidation = (report, format = "markdown") => format === "json" ? jsonText(report) : renderWorkflowValidationRunReport(report);
-var renderRepairReportMarkdown = (report) => [
-  `# Akan Repair: ${report.kind}`,
-  "",
-  `- Status: ${report.status}`,
-  `- Target: ${report.target ?? "none"}`,
-  "",
-  "## Commands",
-  ...listOr(report.commands, (command) => `- [${command.status}] \`${command.command}\`: ${command.reason}`),
-  "",
-  "## Diagnostics",
-  ...listOr(report.diagnostics, renderDiagnostic),
-  "",
-  "## Next Actions",
-  ...listOr(report.nextActions, renderCommand),
-  ""
-].join(`
-`);
-var renderRepairReport = (report, format = "markdown") => format === "json" ? jsonText(report) : renderRepairReportMarkdown(report);
-var renderWorkflowRunArtifact = (artifact, format = "markdown") => {
-  if ("kind" in artifact)
-    return renderRepairReport(artifact, format);
-  if ("mode" in artifact && artifact.mode === "validate")
-    return renderWorkflowValidation(artifact, format);
-  if ("mode" in artifact && (artifact.mode === "apply" || artifact.mode === "dry-run")) {
-    return renderWorkflowApply(artifact, format);
-  }
-  return jsonText(artifact);
-};
-var renderPrimitiveWriteReport = (report) => [
-  `# Primitive Write: ${report.command}`,
-  "",
-  `- Status: ${report.status}`,
-  "",
-  "## Changed Files",
-  ...listOr(report.changedFiles, renderFile),
-  "",
-  "## Generated Files",
-  ...listOr(report.generatedFiles, renderFile),
-  "",
-  "## Validation Commands",
-  ...listOr(report.validationCommands, renderCommand),
-  "",
-  "## Diagnostics",
-  ...listOr(report.diagnostics, renderDiagnostic),
-  "",
-  "## Next Actions",
-  ...listOr(report.nextActions, renderCommand),
-  ""
-].join(`
-`);
-var renderPrimitiveReport = (report, format = "markdown") => format === "json" ? jsonText(report) : renderPrimitiveWriteReport(report);
 // pkgs/@akanjs/devkit/workflow/executor.ts
 import { capitalize as capitalize2 } from "akanjs/common";
 import ts4 from "typescript";
@@ -704,7 +452,7 @@ var sourceFile = (sys, path, action, reason) => ({
   action,
   reason
 });
-var moduleComponentName = (moduleName) => moduleName.replace(/[-_]+/g, " ").replace(/(?:^|\s+)([a-zA-Z0-9])/g, (_, char) => char.toUpperCase()).replace(/\s+/g, "");
+var moduleComponentName = (moduleName) => moduleName.replace(/[-_]+/g, " ").replace(/(?<=^|\s)[a-zA-Z0-9]/g, (char) => char.toUpperCase()).replace(/\s+/g, "");
 var moduleSourcePaths = (moduleName) => {
   const componentName = moduleComponentName(moduleName);
   return {
@@ -1292,7 +1040,7 @@ var insertTemplateField = ({
 var ensureEnumImport = (content) => {
   if (content.includes("enumOf"))
     return content;
-  const baseImport = /import \{ ([^}]+) \} from "akanjs\/base";/.exec(content);
+  const baseImport = /import \{ ([^{}]+) \} from "akanjs\/base";/.exec(content);
   if (baseImport) {
     const names = baseImport[1]?.split(",").map((name) => name.trim()) ?? [];
     return content.replace(baseImport[0], `import { ${[...names, "enumOf"].sort().join(", ")} } from "akanjs/base";`);
@@ -2687,6 +2435,259 @@ var createWorkflowPlan = (spec, rawInputs) => {
     approval: workflowPlanApproval
   };
 };
+// pkgs/@akanjs/devkit/workflow/render.ts
+var listOr = (items, render, empty = "- none") => items?.length ? items.map(render) : [empty];
+var renderDiagnostic = (diagnostic) => `- [${diagnostic.severity}] ${diagnostic.code}: ${diagnostic.message}`;
+var renderCommand = (entry) => `- \`${entry.command}\`: ${entry.reason}`;
+var renderFile = (file) => `- \`${file.action}\` ${file.path}: ${file.reason}`;
+var renderRecommendation = (recommendation) => {
+  const target = recommendation.target ? ` ${recommendation.target}` : "";
+  const action = recommendation.action ? ` Action: ${recommendation.action}` : "";
+  return `- [${recommendation.kind}]${target} ${recommendation.message}${action}`;
+};
+var renderWorkflowList = (specs) => [
+  "# Akan Workflows",
+  "",
+  ...specs.flatMap((spec) => [`- \`${spec.name}\`: ${spec.description}`, `  - When: ${spec.whenToUse}`]),
+  ""
+].join(`
+`);
+var renderWorkflowExplain = (spec) => [
+  `# Workflow: ${spec.name}`,
+  "",
+  spec.description,
+  "",
+  "## When To Use",
+  spec.whenToUse,
+  "",
+  "## Inputs",
+  ...Object.entries(spec.inputs).map(([name, input]) => `- \`${name}\`${input.required ? " (required)" : ""}: ${input.description}${input.allowedValues ? ` Allowed: ${input.allowedValues.join(", ")}.` : ""}`),
+  "",
+  "## Optional Surfaces",
+  ...Object.entries(spec.optionalSurfaces ?? {}).map(([name, mode]) => `- \`${name}\`: ${mode}`),
+  "",
+  "## Steps",
+  ...spec.steps.map((step, index) => `${index + 1}. \`${step.id}\` (${step.tool}): ${step.description}`),
+  "",
+  "## Validation",
+  ...spec.validation.map(renderCommand),
+  ""
+].join(`
+`);
+var renderWorkflowPlan = (plan) => [
+  `# Workflow Plan: ${plan.workflow}`,
+  "",
+  `- Mode: ${plan.mode}`,
+  `- Requires approval: ${plan.requiresApproval}`,
+  `- Approval: ${plan.approval?.meaning ?? "Review this read-only plan before applying workflow mutations."}`,
+  "",
+  "## Inputs",
+  ...Object.entries(plan.inputs).map(([name, value]) => `- \`${name}\`: ${Array.isArray(value) ? value.join(", ") : value}`),
+  "",
+  "## Optional Surfaces",
+  ...Object.entries(plan.optionalSurfaces).map(([name, mode]) => `- \`${name}\`: ${mode}`),
+  "",
+  "## Steps",
+  ...plan.steps.map((step, index) => `${index + 1}. \`${step.id}\` (${step.tool}): ${step.description}`),
+  "",
+  "## Predicted Changes",
+  ...plan.predictedChanges.map((change) => {
+    const scope = change.applyScope ? ` (${change.applyScope})` : "";
+    return `- \`${change.action}\`${scope} ${change.target}: ${change.reason}`;
+  }),
+  "",
+  "## Validation",
+  ...plan.validation.map(renderCommand),
+  "",
+  "## Diagnostics",
+  ...listOr(plan.diagnostics, renderDiagnostic),
+  "",
+  "## Recommendations",
+  ...listOr(plan.recommendations, (recommendation) => `- [${recommendation.kind}] ${recommendation.message}`),
+  ""
+].join(`
+`);
+var renderWorkflowApplyReport = (report) => {
+  const applySummary = {
+    sourceFilesChanged: report.summary?.sourceFilesChanged ?? report.changedFiles,
+    generatedFilesSynced: report.summary?.generatedFilesSynced ?? report.generatedFiles
+  };
+  const manualReviewItems = [
+    ...report.diagnostics.filter((diagnostic) => diagnostic.severity === "warning").map(renderDiagnostic),
+    ...report.recommendations.filter((recommendation) => recommendation.kind === "manual-action").map(renderRecommendation)
+  ];
+  const validationBlockers = report.diagnostics.filter((diagnostic) => diagnostic.severity === "error" && (diagnostic.failureScope === "workspace-config" || diagnostic.failureScope === "environment")).map(renderDiagnostic);
+  const sourceBlockers = report.diagnostics.filter((diagnostic) => diagnostic.severity === "error" && (diagnostic.failureScope === "source-change" || !diagnostic.failureScope || diagnostic.failureScope === "unknown")).map(renderDiagnostic);
+  return [
+    `# Workflow Apply: ${report.workflow}`,
+    "",
+    `- Mode: ${report.mode}`,
+    `- Status: ${report.status}`,
+    `- Source-change status: ${sourceBlockers.length ? "failed" : "passed"}`,
+    `- Workspace status: ${validationBlockers.length ? "blocked" : "not blocked during apply"}`,
+    `- Source files changed: ${applySummary.sourceFilesChanged.length}`,
+    `- Generated files queued for sync: ${applySummary.generatedFilesSynced.length}`,
+    ...report.validationTarget ? [`- Validation target: ${report.validationTarget}`] : [],
+    "",
+    "## Apply Checks",
+    ...report.postApplyChecks?.length ? report.postApplyChecks.map((check) => `- [${check.status}] ${check.code} ${check.target}: ${check.message}`) : ["- not run"],
+    "",
+    "## Source Change Blockers",
+    ...sourceBlockers.length ? sourceBlockers : ["- none"],
+    "",
+    "## Automatically Modified",
+    ...listOr(applySummary.sourceFilesChanged, renderFile),
+    "",
+    "## Generated Sync",
+    ...listOr(applySummary.generatedFilesSynced, renderFile),
+    "",
+    "## Applied Commands",
+    ...listOr(report.appliedCommands, renderCommand),
+    "",
+    "## Recommended Validation Commands",
+    ...listOr(report.recommendedValidationCommands, renderCommand),
+    "",
+    "## User Review Required",
+    ...manualReviewItems.length ? manualReviewItems : ["- none"],
+    "",
+    "## Validation Blockers",
+    ...validationBlockers.length ? validationBlockers : report.recommendedValidationCommands.length ? ["- none detected during apply; run validation with the validation target for command-level blockers."] : ["- none"],
+    "",
+    "## Diagnostics",
+    ...listOr(report.diagnostics, renderDiagnostic),
+    "",
+    "## Recommendations",
+    ...listOr(report.recommendations.slice(0, 3), renderRecommendation),
+    "",
+    "## Next Actions",
+    ...listOr(report.nextActions.slice(0, 3), renderCommand),
+    ""
+  ].join(`
+`);
+};
+var renderWorkflowApply = (report, format = "markdown") => format === "json" ? jsonText(report) : renderWorkflowApplyReport(report);
+var renderWorkflowValidationRunReport = (report) => {
+  const baselineSummary = report.baselineSummary ?? {
+    status: report.baselineDiagnostics?.some((diagnostic) => diagnostic.severity === "error") ? "failed" : "unknown",
+    total: report.baselineDiagnostics?.length ?? 0,
+    totalErrors: report.baselineDiagnostics?.filter((diagnostic) => diagnostic.severity === "error").length ?? 0,
+    totalWarnings: report.baselineDiagnostics?.filter((diagnostic) => diagnostic.severity === "warning").length ?? 0,
+    detailsIncluded: true,
+    knownBlockerCount: report.knownBlockers.filter((blocker) => blocker.known).length,
+    byCode: []
+  };
+  return [
+    `# Workflow Validation: ${report.workflow}`,
+    "",
+    `- Run: ${report.runId}`,
+    `- Status: ${report.status}`,
+    `- Source status: ${report.sourceStatus}`,
+    `- Workspace status: ${report.workspaceStatus}`,
+    `- Validation commands status: ${report.validationCommandsStatus ?? "unknown"}`,
+    `- Baseline status: ${report.baselineStatus ?? baselineSummary.status}`,
+    `- Overall status: ${report.overallStatus}`,
+    "",
+    "## Status Summary",
+    `- Source-change: ${report.summary.sourceChange}`,
+    `- Generated sync: ${report.summary.generatedSync}`,
+    `- Validation commands: ${report.summary.validationCommands ?? "unknown"}`,
+    `- Baseline: ${report.summary.baseline ?? baselineSummary.status}`,
+    `- Workspace config: ${report.summary.workspaceConfig}`,
+    `- Environment: ${report.summary.environment}`,
+    "",
+    "## Source Change Diagnostics",
+    ...listOr(report.workflowDiagnostics, renderDiagnostic),
+    "",
+    "## Existing Workspace Blockers",
+    `- Status: ${baselineSummary.status}`,
+    `- Errors: ${baselineSummary.totalErrors}`,
+    `- Warnings: ${baselineSummary.totalWarnings}`,
+    ...listOr(baselineSummary.byCode, (item) => `- [${item.severity}] ${item.code} (${item.count}x): ${item.sampleMessage}`),
+    ...baselineSummary.detailsIncluded ? [] : [
+      "- Baseline details are summarized by default. Re-run validation with includeBaselineDetails=true for full baselineDiagnostics."
+    ],
+    "",
+    "## Existing Workspace Blocker Details",
+    ...listOr(report.baselineDiagnostics, renderDiagnostic, baselineSummary.detailsIncluded ? "- none" : "- omitted"),
+    "",
+    "## Known Blockers",
+    ...listOr(report.knownBlockers, (blocker) => {
+      const command = blocker.command ? ` \`${blocker.command}\`` : "";
+      const count = blocker.count > 1 ? ` (${blocker.count}x)` : "";
+      const known = blocker.known ? " known" : "";
+      return `- [${blocker.failureScope}${known}]${command}${count}: ${blocker.message}`;
+    }),
+    "",
+    "## Commands",
+    ...listOr(report.commands, (command) => {
+      const scope = command.failureScope ? ` (${command.failureScope})` : "";
+      return `- [${command.status}] \`${command.command}\`${scope}: ${command.reason}`;
+    }),
+    "",
+    "## Diagnostics",
+    ...listOr(report.diagnostics, renderDiagnostic),
+    "",
+    "## Repair Actions",
+    ...listOr(report.repairActions, renderCommand),
+    "",
+    "## Next Actions",
+    ...listOr(report.nextActions, renderCommand),
+    ""
+  ].join(`
+`);
+};
+var renderWorkflowValidation = (report, format = "markdown") => format === "json" ? jsonText(report) : renderWorkflowValidationRunReport(report);
+var renderRepairReportMarkdown = (report) => [
+  `# Akan Repair: ${report.kind}`,
+  "",
+  `- Status: ${report.status}`,
+  `- Target: ${report.target ?? "none"}`,
+  "",
+  "## Commands",
+  ...listOr(report.commands, (command) => `- [${command.status}] \`${command.command}\`: ${command.reason}`),
+  "",
+  "## Diagnostics",
+  ...listOr(report.diagnostics, renderDiagnostic),
+  "",
+  "## Next Actions",
+  ...listOr(report.nextActions, renderCommand),
+  ""
+].join(`
+`);
+var renderRepairReport = (report, format = "markdown") => format === "json" ? jsonText(report) : renderRepairReportMarkdown(report);
+var renderWorkflowRunArtifact = (artifact, format = "markdown") => {
+  if ("kind" in artifact)
+    return renderRepairReport(artifact, format);
+  if ("mode" in artifact && artifact.mode === "validate")
+    return renderWorkflowValidation(artifact, format);
+  if ("mode" in artifact && (artifact.mode === "apply" || artifact.mode === "dry-run")) {
+    return renderWorkflowApply(artifact, format);
+  }
+  return jsonText(artifact);
+};
+var renderPrimitiveWriteReport = (report) => [
+  `# Primitive Write: ${report.command}`,
+  "",
+  `- Status: ${report.status}`,
+  "",
+  "## Changed Files",
+  ...listOr(report.changedFiles, renderFile),
+  "",
+  "## Generated Files",
+  ...listOr(report.generatedFiles, renderFile),
+  "",
+  "## Validation Commands",
+  ...listOr(report.validationCommands, renderCommand),
+  "",
+  "## Diagnostics",
+  ...listOr(report.diagnostics, renderDiagnostic),
+  "",
+  "## Next Actions",
+  ...listOr(report.nextActions, renderCommand),
+  ""
+].join(`
+`);
+var renderPrimitiveReport = (report, format = "markdown") => format === "json" ? jsonText(report) : renderPrimitiveWriteReport(report);
 // pkgs/@akanjs/devkit/workflow/rolloutGate.ts
 var toolingRolloutCandidates = [
   {