truecourse 0.7.0-next.10 → 0.7.0-next.11

package/README.md

@@ -301,6 +301,7 @@ truecourse spec docs unexclude <path>             # Remove a force-exclude overr
 truecourse guard generate                         # Author scenarios from spec sections (classify → generate → birth-validate)
 truecourse guard run                              # Build via the recipe + run committed scenarios; exits non-zero on any drift (CI gate)
 truecourse guard run --scenario <id>              # Run a single scenario
+truecourse guard run --verbose                    # List every scenario result (one ✓ line per pass; default shows failures only)
 truecourse guard status                           # Compact summary: section coverage, last run, last generate (LLM-free, no re-run)
 truecourse guard drifts                           # List the latest run's non-pass scenarios, most severe first (paginated; --all / --offset / --json)
 ```

package/cli.mjs

@@ -171204,7 +171204,7 @@ function readToolVersion() {
   if (cachedVersion)
     return cachedVersion;
   if (true) {
-    cachedVersion = "0.7.0-next.10";
+    cachedVersion = "0.7.0-next.11";
     return cachedVersion;
   }
   try {
@@ -208858,6 +208858,7 @@ async function generateGuards(options) {
   let extractDone = 0;
   const viewTotal = workDocs.reduce((n, d3) => n + countExtractViews(d3), 0);
   let viewDone = 0;
+  options.onExtractViewProgress?.(0, viewTotal);
   const extracted = await Promise.all(workDocs.map(async (doc) => {
     const result = await extractDocClaims(repoRoot5, doc, extractRunner, limit, () => options.onExtractViewProgress?.(++viewDone, viewTotal));
     options.onExtractProgress?.(++extractDone, workDocs.length);
@@ -211414,15 +211415,43 @@ init_registry();
 
 // tools/cli/src/lib/stdout-step-renderer.ts
 var SPINNER_FRAMES2 = ["\u280B", "\u2819", "\u2839", "\u2838", "\u283C", "\u2834", "\u2826", "\u2827", "\u2807", "\u280F"];
+var ANSI_SGR_GLOBAL = /\x1b\[[0-9;]*m/g;
+function visibleLength(s) {
+  return [...s.replace(ANSI_SGR_GLOBAL, "")].length;
+}
+function clampToWidth(s, maxWidth) {
+  if (maxWidth <= 0 || visibleLength(s) <= maxWidth) return s;
+  const budget = maxWidth - 1;
+  const tokens = s.match(/\x1b\[[0-9;]*m|[\s\S]/gu) ?? [];
+  let out = "";
+  let visible = 0;
+  for (const tok of tokens) {
+    if (tok.charCodeAt(0) === 27) {
+      out += tok;
+      continue;
+    }
+    if (visible >= budget) break;
+    out += tok;
+    visible++;
+  }
+  return `${out}\u2026`;
+}
+function terminalWidth() {
+  if (!process.stderr.isTTY) return null;
+  return process.stdout.columns || process.stderr.columns || 80;
+}
 function createStdoutStepRenderer() {
   let spinnerFrame2 = 0;
   let spinnerInterval2 = null;
   let renderedLineCount2 = 0;
   let latestSteps2 = null;
+  let lastPainted = null;
   function paint(steps) {
+    lastPainted = steps;
     if (renderedLineCount2 > 0) {
       process.stderr.write(`\x1B[${renderedLineCount2}A`);
     }
+    const width = terminalWidth();
     for (const step of steps) {
       const detail = step.detail && step.status !== "pending" ? ` \u2014 ${step.detail}` : "";
       let icon;
@@ -211449,7 +211478,9 @@ function createStdoutStepRenderer() {
           icon = "\u25CB";
           color = "";
       }
-      process.stderr.write(`\x1B[2K${color}  ${icon} ${step.label}${detail}${reset}
+      const content = `  ${icon} ${step.label}${detail}`;
+      const line = width === null ? content : clampToWidth(content, width);
+      process.stderr.write(`\x1B[2K${color}${line}${reset}
 `);
     }
     renderedLineCount2 = steps.length;
@@ -211472,6 +211503,20 @@ function createStdoutStepRenderer() {
     onProgress(payload) {
       if (payload.steps) paint(payload.steps);
     },
+    log(line) {
+      if (!process.stderr.isTTY) {
+        process.stderr.write(`${line}
+`);
+        return;
+      }
+      if (renderedLineCount2 > 0) {
+        process.stderr.write(`\x1B[${renderedLineCount2}A\x1B[0J`);
+        renderedLineCount2 = 0;
+      }
+      process.stderr.write(`${line}
+`);
+      if (lastPainted) paint(lastPainted);
+    },
     dispose() {
       if (spinnerInterval2) {
         clearInterval(spinnerInterval2);
@@ -212379,6 +212424,7 @@ async function guardGenerateInProcess(repoRoot5, options = {}) {
     cur = ni;
   };
   const withUsage = (key4, base2) => `${base2}${stageUsageTag(GUARD_STEP_STAGES[key4] ?? [], repoRoot5)}`;
+  let extractViewsTotal = 0;
   let authorDone = 0;
   let authorTotal = 0;
   let authorFinished = false;
@@ -212426,16 +212472,19 @@ async function guardGenerateInProcess(repoRoot5, options = {}) {
         sectionsTotal = work;
         tracker?.done("index", withUsage("index", `${work} of ${total} section${total === 1 ? "" : "s"} changed`));
         cur = STEPS.indexOf("extract");
-        tracker?.start("extract", `0 views`);
+        tracker?.start("extract");
       },
       onExtractViewProgress: (done, total) => {
+        extractViewsTotal = total;
         advanceTo("extract");
-        tracker?.detail("extract", withUsage("extract", `${done}/${total} view${total === 1 ? "" : "s"}`));
+        tracker?.detail("extract", withUsage("extract", `views ${done}/${total}`));
       },
       onExtractProgress: (done, total) => {
         advanceTo("extract");
         if (done >= total) {
-          tracker?.done("extract", withUsage("extract", `${total} doc${total === 1 ? "" : "s"}`));
+          const docs = `${total} doc${total === 1 ? "" : "s"}`;
+          const views = `${extractViewsTotal} view${extractViewsTotal === 1 ? "" : "s"}`;
+          tracker?.done("extract", withUsage("extract", `${docs} \xB7 ${views}`));
         }
       },
       onAuthorProgress: (done, total) => {
@@ -212547,7 +212596,10 @@ async function guardRunInProcess(repoRoot5, options = {}) {
         tracker?.start("run", `0/${total} scenarios`);
       }
     },
-    onScenarioSettled: (done, total) => tracker?.detail("run", `${done}/${total} scenarios`)
+    onScenarioSettled: (done, total, scenarioResult) => {
+      tracker?.detail("run", `${done}/${total} scenarios`);
+      options.onScenarioResult?.(scenarioResult);
+    }
   });
   if (result.status === "ok") {
     const n = result.latest.summary.total;
@@ -212580,13 +212632,26 @@ var MARK2 = {
   stale: "~",
   orphaned: "\u25CB"
 };
+function scenarioLine(s) {
+  const suffix = s.outcome === "stale" || s.outcome === "orphaned" ? `  \u2014 ${BINDING_REASON[s.outcome]}` : `  (${Math.round(s.durationMs)}ms)`;
+  return `${MARK2[s.outcome]} ${s.id} \u2014 ${s.title}${suffix}`;
+}
 async function runGuardRun(opts = {}) {
   const repoRoot5 = opts.cwd ?? process.cwd();
   mt("Guard");
   await requireGitRepo(repoRoot5);
   const renderer = createStdoutStepRenderer();
   const tracker = new StepTracker(renderer.onProgress, GUARD_RUN_STEPS.map((s) => ({ ...s })));
-  const result = await guardRunInProcess(repoRoot5, { scenario: opts.scenario, tracker });
+  const result = await guardRunInProcess(repoRoot5, {
+    scenario: opts.scenario,
+    tracker,
+    // Non-pass results surface the moment they settle — a full line each,
+    // printed above the live counter so they are never buried under pass
+    // output. Passes ride the counter only (`--verbose` lists them at the end).
+    onScenarioResult: (s) => {
+      if (s.outcome !== "pass") renderer.log(scenarioLine(s));
+    }
+  });
   renderer.dispose();
   switch (result.status) {
     case "no-recipe":
@@ -212632,22 +212697,8 @@ async function runGuardRun(opts = {}) {
       break;
   }
   const { latest, loadErrors, manifest } = result;
-  for (const s of latest.scenarios) {
-    const suffix = s.outcome === "stale" || s.outcome === "orphaned" ? `  \u2014 ${BINDING_REASON[s.outcome]}` : `  (${Math.round(s.durationMs)}ms)`;
-    O2.message(`${MARK2[s.outcome]} ${s.id} \u2014 ${s.title}${suffix}`);
-  }
-  const failing = latest.scenarios.filter((s) => s.outcome === "fail" || s.outcome === "error");
-  if (failing.length > 0) {
-    O2.message("");
-    for (const s of failing) {
-      O2.message(`${MARK2[s.outcome]} ${s.id}`);
-      if (s.failure) {
-        O2.message(`    step ${s.failure.step}`);
-        O2.message(`    expected: ${s.failure.expected}`);
-        O2.message(`    actual:   ${s.failure.actual}`);
-      }
-      if (s.evidencePath) O2.message(`    evidence: ${s.evidencePath}`);
-    }
+  if (opts.verbose) {
+    for (const s of latest.scenarios) O2.message(scenarioLine(s));
   }
   printLoadErrors(loadErrors);
   if (manifest) O2.info(`manifest: ${manifest.sections.length} section${manifest.sections.length === 1 ? "" : "s"} recorded`);
@@ -212661,6 +212712,12 @@ async function runGuardRun(opts = {}) {
   const bad = fail4 > 0 || error > 0 || stale > 0 || orphaned > 0 || loadErrors.length > 0;
   if (bad) {
     O2.error(parts.join(" \xB7 "));
+    O2.info(
+      [
+        "`truecourse guard drifts`  \u2014 inspect failures (expected/actual/evidence)",
+        "`truecourse guard status`  \u2014 coverage"
+      ].join("\n")
+    );
     gt("Guard found drift.");
     process.exit(1);
   }
@@ -213270,7 +213327,7 @@ async function runHooksRun() {
 
 // tools/cli/src/index.ts
 var program2 = new Command();
-program2.name("truecourse").version("0.7.0-next.10").description("TrueCourse CLI \u2014 analyze your repository and open the dashboard");
+program2.name("truecourse").version("0.7.0-next.11").description("TrueCourse CLI \u2014 analyze your repository and open the dashboard");
 function warnDiscontinued(command) {
   process.stderr.write(
     `\u26A0 \`${command}\` is discontinued in favor of \`truecourse guard\` \u2014 see the README. Planned removal: 0.8.
@@ -213424,8 +213481,8 @@ driftsCmd.command("list").description("List drifts from the latest verify (pagin
   });
 });
 var guardCmd = program2.command("guard").description("Run spec-section-bound scenario tests");
-guardCmd.command("run").description("Build via the recipe and run the committed scenarios").option("--scenario <id>", "Run only the scenario with this id").action(async (options) => {
-  await runGuardRun({ scenario: options.scenario });
+guardCmd.command("run").description("Build via the recipe and run the committed scenarios").option("--scenario <id>", "Run only the scenario with this id").option("--verbose", "List every scenario result (one \u2713 line per pass)").action(async (options) => {
+  await runGuardRun({ scenario: options.scenario, verbose: !!options.verbose });
 });
 guardCmd.command("generate").description("Author spec-section-bound scenarios (classify \u2192 generate \u2192 birth-validate)").option("-y, --yes", "Skip the pre-flight cost-estimate confirmation").option("--llm-transport <mode>", "LLM transport: cli (default) or agent").option("--io <dir>", "Request/response mailbox dir for --llm-transport agent").action(async (options) => {
   await runGuardGenerate({

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "truecourse",
-  "version": "0.7.0-next.10",
+  "version": "0.7.0-next.11",
   "description": "Visualize your codebase architecture as an interactive graph",
   "type": "module",
   "bin": {

package/server.mjs

@@ -227399,6 +227399,7 @@ async function generateGuards(options) {
   let extractDone = 0;
   const viewTotal = workDocs.reduce((n, d) => n + countExtractViews(d), 0);
   let viewDone = 0;
+  options.onExtractViewProgress?.(0, viewTotal);
   const extracted = await Promise.all(workDocs.map(async (doc) => {
     const result = await extractDocClaims(repoRoot, doc, extractRunner, limit, () => options.onExtractViewProgress?.(++viewDone, viewTotal));
     options.onExtractProgress?.(++extractDone, workDocs.length);
@@ -233154,7 +233155,7 @@ function readToolVersion() {
   if (cachedVersion)
     return cachedVersion;
   if (true) {
-    cachedVersion = "0.7.0-next.10";
+    cachedVersion = "0.7.0-next.11";
     return cachedVersion;
   }
   try {
@@ -241105,6 +241106,7 @@ async function guardGenerateInProcess(repoRoot, options = {}) {
     cur = ni;
   };
   const withUsage = (key4, base) => `${base}${stageUsageTag(GUARD_STEP_STAGES[key4] ?? [], repoRoot)}`;
+  let extractViewsTotal = 0;
   let authorDone = 0;
   let authorTotal = 0;
   let authorFinished = false;
@@ -241152,16 +241154,19 @@ async function guardGenerateInProcess(repoRoot, options = {}) {
         sectionsTotal = work;
         tracker?.done("index", withUsage("index", `${work} of ${total} section${total === 1 ? "" : "s"} changed`));
         cur = STEPS.indexOf("extract");
-        tracker?.start("extract", `0 views`);
+        tracker?.start("extract");
       },
       onExtractViewProgress: (done, total) => {
+        extractViewsTotal = total;
         advanceTo("extract");
-        tracker?.detail("extract", withUsage("extract", `${done}/${total} view${total === 1 ? "" : "s"}`));
+        tracker?.detail("extract", withUsage("extract", `views ${done}/${total}`));
       },
       onExtractProgress: (done, total) => {
         advanceTo("extract");
         if (done >= total) {
-          tracker?.done("extract", withUsage("extract", `${total} doc${total === 1 ? "" : "s"}`));
+          const docs = `${total} doc${total === 1 ? "" : "s"}`;
+          const views = `${extractViewsTotal} view${extractViewsTotal === 1 ? "" : "s"}`;
+          tracker?.done("extract", withUsage("extract", `${docs} \xB7 ${views}`));
         }
       },
       onAuthorProgress: (done, total) => {
@@ -241273,7 +241278,10 @@ async function guardRunInProcess(repoRoot, options = {}) {
         tracker?.start("run", `0/${total} scenarios`);
       }
     },
-    onScenarioSettled: (done, total) => tracker?.detail("run", `${done}/${total} scenarios`)
+    onScenarioSettled: (done, total, scenarioResult) => {
+      tracker?.detail("run", `${done}/${total} scenarios`);
+      options.onScenarioResult?.(scenarioResult);
+    }
   });
   if (result.status === "ok") {
     const n = result.latest.summary.total;