@nathapp/nax 0.89.0 → 0.90.0

package/dist/nax.js

@@ -48669,7 +48669,7 @@ var package_default;
 var init_package = __esm(() => {
   package_default = {
     name: "@nathapp/nax",
-    version: "0.89.0",
+    version: "0.90.0",
     description: "AI Coding Agent Orchestrator \u2014 loops until done",
     type: "module",
     bin: {
@@ -48755,7 +48755,7 @@ var init_package = __esm(() => {
       "@agentclientprotocol/sdk": "~1.7.0",
       "@anthropic-ai/sandbox-runtime": "0.0.77",
       "@modelcontextprotocol/sdk": "^1.32.1",
-      "@nathapp/nax-ai": "0.89.0",
+      "@nathapp/nax-ai": "0.90.0",
       chalk: "^5.6.2",
       commander: "^13.1.0",
       ink: "^6.7.0",
@@ -73074,8 +73074,8 @@ var init_version = __esm(() => {
   NAX_AI_VERSION = CATALOG_VERSION;
   NAX_COMMIT = (() => {
     try {
-      if (/^[0-9a-f]{6,10}$/.test("26921a9"))
-        return "26921a9";
+      if (/^[0-9a-f]{6,10}$/.test("297c3c7"))
+        return "297c3c7";
     } catch {}
     try {
       const result = Bun.spawnSync(["git", "rev-parse", "--short", "HEAD"], {
@@ -136471,6 +136471,48 @@ var init_trust2 = __esm(() => {
   };
 });
 
+// src/workflow/supplementary-items.ts
+function listedDecisionIds(openItems) {
+  return new Set(openItems.flatMap((item) => [item.id, ...item.ruling?.decisionId ? [item.ruling.decisionId] : []]));
+}
+async function advisorItems2(dir, feature, openItems, outputDir) {
+  const listed = listedDecisionIds(openItems);
+  return (await readTrustedDecisions(dir, feature, outputDir)).filter((d) => !listed.has(d.id)).map((d) => ({ id: d.id, kind: "advisor", issue: oneLine3(`${d.kind} ${d.action.type}: ${d.rationale}`) }));
+}
+function cannotVerifyItems(lines) {
+  const counts = new Map;
+  return lines.map((line) => {
+    const n = (counts.get(line.storyId) ?? 0) + 1;
+    counts.set(line.storyId, n);
+    return { id: `${line.storyId}:cv${n}`, kind: "cannot-verify", issue: line.text };
+  });
+}
+async function orNone(source, read) {
+  try {
+    return await read();
+  } catch (err) {
+    getSafeLogger2()?.warn("workflow", "Skipping unreadable supplementary items", {
+      storyId: "_run",
+      source,
+      error: errorMessage(err)
+    });
+    return [];
+  }
+}
+async function loadSupplementaryItems(dir, feature, openItems, outputDir) {
+  const advisor = await orNone("advisor ledger", () => advisorItems2(dir, feature, openItems, outputDir));
+  const ledger = await orNone("run ledgers", async () => cannotVerifyItems((await collectLedgerItems(workflowFeatureDir(dir, feature))).cannotVerify));
+  return [...advisor, ...ledger];
+}
+var oneLine3 = (text) => text.replace(/\s+/g, " ").trim();
+var init_supplementary_items = __esm(() => {
+  init_internal();
+  init_advisor();
+  init_logger2();
+  init_ledger_items();
+  init_paths5();
+});
+
 // src/workflow/run-verdict.ts
 import { basename as basename34 } from "path";
 async function newestResult(dir, feature) {
@@ -136493,7 +136535,7 @@ function noResult(feature) {
     feature
   });
 }
-async function loadRunVerdict(dir, feature) {
+async function loadRunVerdict(dir, feature, resolveOutputDir) {
   validateFeatureName(feature);
   const found = await newestResult(dir, feature);
   if (!found)
@@ -136503,13 +136545,15 @@ async function loadRunVerdict(dir, feature) {
     throw notStarted(feature, found.runId);
   const filled = fillStoryStates(record, found.result);
   const verdict = buildVerdict(filled);
+  const openItems = verdict?.openItems ?? buildOpenItems(filled);
   return {
     runId: found.runId,
     runDir: found.runDir,
     result: found.result,
     record,
-    openItems: verdict?.openItems ?? buildOpenItems(filled),
-    reasons: record.reasons
+    openItems,
+    reasons: record.reasons,
+    supplementaryItems: await loadSupplementaryItems(dir, feature, openItems, await resolveOutputDir(dir))
   };
 }
 var init_run_verdict = __esm(() => {
@@ -136518,17 +136562,25 @@ var init_run_verdict = __esm(() => {
   init_open_items();
   init_paths5();
   init_result();
+  init_supplementary_items();
 });
 
 // src/cli/workflow-forge.ts
+import { basename as basename35 } from "path";
 var _workflowForgeDeps;
 var init_workflow_forge = __esm(() => {
+  init_config();
   init_forge();
+  init_runtime3();
   init_ci_wait();
   _workflowForgeDeps = {
     forge: defaultForgeDeps,
     now: () => new Date,
-    waitForChecks
+    waitForChecks,
+    resolveOutputDir: async (dir) => {
+      const config = await loadConfig(dir).catch(() => null);
+      return projectOutputDir(config?.name?.trim() || basename35(dir), config?.outputDir);
+    }
   };
 });
 
@@ -136591,8 +136643,8 @@ function sidecarKindFor(item) {
 function openIds(items) {
   return items.length === 0 ? "none" : items.map((item) => item.id).join(", ");
 }
-function checkEntriesAgainstItems(entries, items) {
-  const byId = new Map(items.map((item) => [item.id, item]));
+function checkEntriesAgainstItems(entries, items, supplementary = []) {
+  const byId = new Map([...supplementary, ...items].map((item) => [item.id, item]));
   for (const entry of entries) {
     const item = byId.get(entry.id);
     if (item === undefined) {
@@ -136955,13 +137007,13 @@ function reportOf(input) {
 }
 async function promote(opts, forgeDeps) {
   validateFeatureName(opts.feature);
-  const loaded = await loadRunVerdict(opts.dir, opts.feature);
+  const loaded = await loadRunVerdict(opts.dir, opts.feature, forgeDeps.resolveOutputDir);
   const url = draftUrl(loaded, opts.feature);
   const forge = await draftForge(forgeDeps, opts.dir, url);
   const expectedSha = await headSha2(forgeDeps.forge, opts.dir);
   const found = await newestSidecar(loaded.runDir);
   if (found)
-    checkEntriesAgainstItems(found.sidecar.decisions, loaded.openItems);
+    checkEntriesAgainstItems(found.sidecar.decisions, loaded.openItems, loaded.supplementaryItems);
   const checks = [itemsRuled(loaded, found), await ciGreen({ forgeDeps, forge, url, dir: opts.dir, expectedSha })];
   const target = { opts, loaded, url, forge, forgeDeps, found };
   if (!opts.yes || !allPassed(checks))
@@ -137076,7 +137128,7 @@ function updatedSidecar(existing, input) {
 async function writeRecorded(input) {
   const found = await newestSidecar(input.loaded.runDir);
   if (found) {
-    checkEntriesAgainstItems(found.sidecar.decisions, input.loaded.openItems);
+    checkEntriesAgainstItems(found.sidecar.decisions, input.loaded.openItems, input.loaded.supplementaryItems);
     const sidecar = updatedSidecar(found.sidecar, input);
     await writeSidecar(found.path, sidecar);
     return { path: found.path, sidecar };
@@ -137104,9 +137156,9 @@ async function record4(opts, forgeDeps) {
   validateFeatureName(opts.feature);
   const outcome = outcomeOf2(opts);
   const ctx = { dir: opts.dir, forgeDeps };
-  const loaded = await loadRunVerdict(opts.dir, opts.feature);
+  const loaded = await loadRunVerdict(opts.dir, opts.feature, forgeDeps.resolveOutputDir);
   const entries = opts.decisions === undefined ? [] : await readDecisionsFile(opts.decisions);
-  checkEntriesAgainstItems(entries, loaded.openItems);
+  checkEntriesAgainstItems(entries, loaded.openItems, loaded.supplementaryItems);
   const prUrl = outcome !== undefined && PR_OUTCOMES.includes(outcome) ? await readyPrUrl(outcome, loaded, ctx) : undefined;
   const written = await writeRecorded({ opts, loaded, entries, outcome, prUrl, now: forgeDeps.now() });
   return reportOf2(opts, loaded, written);
@@ -137159,11 +137211,12 @@ function reportFor2(dir, feature, loaded) {
     ...record.ci === undefined ? {} : { ci: record.ci },
     ...record.url === undefined ? {} : { url: record.url },
     reasons: record.reasons,
-    openItems: loaded.openItems
+    openItems: loaded.openItems,
+    supplementaryItems: loaded.supplementaryItems
   };
 }
-async function buildReport(dir, feature) {
-  return reportFor2(dir, feature, await loadRunVerdict(dir, feature));
+async function buildReport(dir, feature, forgeDeps) {
+  return reportFor2(dir, feature, await loadRunVerdict(dir, feature, forgeDeps.resolveOutputDir));
 }
 function exitCodeFor(report) {
   return report.outcome === "ready" && report.openItems.length === 0 ? 0 : 2;
@@ -137171,16 +137224,19 @@ function exitCodeFor(report) {
 function printPlain4(report, deps) {
   const outcome = report.outcome ?? NOT_PUBLISHED2;
   deps.log(`${report.feature}: ${outcome}${report.url ? ` ${report.url}` : ""}`);
-  if (report.openItems.length === 0) {
+  if (report.openItems.length === 0)
     deps.log(NO_ITEMS);
-    return;
-  }
   for (const item of report.openItems)
-    deps.log(`- [${item.kind}] ${item.id} \u2014 ${item.issue}`);
+    deps.log(itemLine(item));
+  if (report.supplementaryItems.length === 0)
+    return;
+  deps.log(SUPPLEMENTARY_HEADING);
+  for (const item of report.supplementaryItems)
+    deps.log(itemLine(item));
 }
-async function workflowStatusCommand(opts, deps = _workflowCliDeps) {
+async function workflowStatusCommand(opts, deps = _workflowCliDeps, forgeDeps = _workflowForgeDeps) {
   try {
-    const report = await buildReport(opts.dir, opts.feature);
+    const report = await buildReport(opts.dir, opts.feature, forgeDeps);
     if (opts.json)
       deps.log(JSON.stringify(report));
     else
@@ -137205,7 +137261,7 @@ async function guarded4(deps, body) {
 }
 function registerWorkflowCommand(program, deps = _workflowCliDeps, forgeDeps = _workflowForgeDeps) {
   const group = program.command("workflow").description("Inspect a feature's workflow run");
-  group.command("status").description("Print the verdict for the feature's newest workflow run").requiredOption("-f, --feature <name>", "Feature name").option("-d, --dir <path>", "Project directory", process.cwd()).option("--json", "Emit one machine-readable JSON document", false).action((o) => guarded4(deps, () => workflowStatusCommand({ dir: o.dir, feature: o.feature, json: o.json === true }, deps)));
+  group.command("status").description("Print the verdict for the feature's newest workflow run").requiredOption("-f, --feature <name>", "Feature name").option("-d, --dir <path>", "Project directory", process.cwd()).option("--json", "Emit one machine-readable JSON document", false).action((o) => guarded4(deps, () => workflowStatusCommand({ dir: o.dir, feature: o.feature, json: o.json === true }, deps, forgeDeps)));
   group.command("record").description("Record a human's rulings and the run's outcome in the decisions sidecar").requiredOption("-f, --feature <name>", "Feature name").option("--decisions <file>", "A JSON array of decision entries").option("--outcome <outcome>", "One of pending, promoted, verified-ready, abandoned").option("-d, --dir <path>", "Project directory", process.cwd()).option("--json", "Emit one machine-readable JSON document", false).action((o) => guarded4(deps, () => workflowRecordCommand({
     dir: o.dir,
     feature: o.feature,
@@ -137216,7 +137272,7 @@ function registerWorkflowCommand(program, deps = _workflowCliDeps, forgeDeps = _
   group.command("promote").description("Check a draft run and report whether its PR can be promoted").requiredOption("-f, --feature <name>", "Feature name").option("--yes", "Promote for real once every check passes", false).option("-d, --dir <path>", "Project directory", process.cwd()).option("--json", "Emit one machine-readable JSON document", false).action((o) => guarded4(deps, () => workflowPromoteCommand({ dir: o.dir, feature: o.feature, yes: o.yes === true, json: o.json === true }, deps, forgeDeps)));
   return group;
 }
-var _workflowCliDeps, NOT_PUBLISHED2 = "not published", NO_ITEMS = "No open items.";
+var _workflowCliDeps, NOT_PUBLISHED2 = "not published", NO_ITEMS = "No open items.", SUPPLEMENTARY_HEADING = "Also to verify (not blocking):", itemLine = (item) => `- [${item.kind}] ${item.id} \u2014 ${item.issue}`;
 var init_workflow2 = __esm(() => {
   init_internal();
   init_open_items();
@@ -149849,7 +149905,7 @@ var init_worktree_id2 = __esm(() => {
 });
 
 // src/bakeoff/contestant.ts
-import { basename as basename38, join as join193 } from "path";
+import { basename as basename39, join as join193 } from "path";
 function aggregateTotals(metrics) {
   let costUsd = 0;
   let wallTimeMs = 0;
@@ -149879,7 +149935,7 @@ async function runContestant(agent, options, deps) {
     }
   };
   const worktree = storyWorktreePath(options.projectRoot, storyId);
-  const projectKey = options.config.name?.trim() || basename38(options.projectRoot);
+  const projectKey = options.config.name?.trim() || basename39(options.projectRoot);
   const outputDir = join193(projectOutputDir(projectKey, options.outputDir), "bakeoff", feature, agent);
   const context = {
     profile: agent,
@@ -151773,7 +151829,7 @@ init_checkpoint();
 init_runtime3();
 init_feature_name();
 import { existsSync as existsSync45 } from "fs";
-import { basename as basename35, join as join188 } from "path";
+import { basename as basename36, join as join188 } from "path";
 async function defaultCheckpointExists(featureDir) {
   if (!featureDir || !existsSync45(featureDir))
     return false;
@@ -151870,7 +151926,7 @@ function registerResumeCommand(program) {
         const globalNaxDir = globalConfigDir();
         const hooks = await loadHooksConfig(naxDir, globalNaxDir);
         applyResumeModeDeps(opts.featureDir ?? "", "auto");
-        const projectKey = config.name?.trim() || basename35(dir);
+        const projectKey = config.name?.trim() || basename36(dir);
         const outputDir = projectOutputDir(projectKey, config.outputDir);
         const statusFilePath = join188(outputDir, "status.json");
         const runsDir = join188(outputDir, "features", feature, "runs");
@@ -152052,7 +152108,7 @@ init_execution2();
 init_logger2();
 init_runtime3();
 import { mkdir as mkdir50, unlink as unlink13 } from "fs/promises";
-import { basename as basename36, join as join190 } from "path";
+import { basename as basename37, join as join190 } from "path";
 var _unlockDeps = {
   findProjectDir,
   loadConfig,
@@ -152083,7 +152139,7 @@ function parseFeatureLockRecord(raw) {
 async function resolveOutputDir3(workdir) {
   const naxDir = _unlockDeps.findProjectDir(workdir);
   const config = await _unlockDeps.loadConfig(naxDir ?? undefined);
-  const projectKey = config.name?.trim() || basename36(workdir);
+  const projectKey = config.name?.trim() || basename37(workdir);
   const outputDir = _unlockDeps.projectOutputDir(projectKey, config.outputDir);
   return { outputDir, naxDir };
 }
@@ -159895,7 +159951,7 @@ init_version();
 init_source();
 init_cli2();
 import { existsSync as existsSync47, mkdirSync as mkdirSync9 } from "fs";
-import { basename as basename37, join as join192 } from "path";
+import { basename as basename38, join as join192 } from "path";
 
 // src/cli/run-max-iterations.ts
 function parseMaxIterationsFlag(raw) {
@@ -160268,7 +160324,7 @@ async function displayPlanConfirmation(prd, options) {
 }
 function initRunLogging(params) {
   const { options, config, workdir, isTTY, logLevel, formatterMode } = params;
-  const projectKey = config.name?.trim() || basename37(workdir);
+  const projectKey = config.name?.trim() || basename38(workdir);
   const outputDir = projectOutputDir(projectKey, config.outputDir);
   const runsDir = join192(outputDir, "features", options.feature, "runs");
   mkdirSync9(runsDir, { recursive: true });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nathapp/nax",
-  "version": "0.89.0",
+  "version": "0.90.0",
   "description": "AI Coding Agent Orchestrator — loops until done",
   "type": "module",
   "bin": {
@@ -86,7 +86,7 @@
     "@agentclientprotocol/sdk": "~1.7.0",
     "@anthropic-ai/sandbox-runtime": "0.0.77",
     "@modelcontextprotocol/sdk": "^1.32.1",
-    "@nathapp/nax-ai": "0.89.0",
+    "@nathapp/nax-ai": "0.90.0",
     "chalk": "^5.6.2",
     "commander": "^13.1.0",
     "ink": "^6.7.0",