truecourse 0.6.0-next.2 → 0.6.0-next.4

package/cli.mjs

@@ -128242,7 +128242,7 @@ function readToolVersion() {
   if (cachedVersion)
     return cachedVersion;
   if (true) {
-    cachedVersion = "0.6.0-next.2";
+    cachedVersion = "0.6.0-next.4";
     return cachedVersion;
   }
   try {
@@ -149105,12 +149105,14 @@ async function runContractsGenerate(options = {}) {
   const extractModel = resolveModel("contract.extract", void 0, repoRoot5);
   const repairModel = resolveModel("contract.repair", void 0, repoRoot5);
   const fallbackModel = resolveFallbackModel(repoRoot5) ?? void 0;
+  let totalSlices = 0;
+  let sliceNum = 0;
   const runner = spawnRunner2({
     concurrency,
     model: extractModel,
     fallbackModel,
     onSliceStart: (s) => {
-      O2.step(`extracting  ${s.specPath} :: ${s.headingPath.join(" \u2192 ")}`);
+      O2.step(`extracting  ${++sliceNum}/${totalSlices}  ${s.specPath} :: ${s.headingPath.join(" \u2192 ")}`);
     }
   });
   let result;
@@ -149120,8 +149122,11 @@ async function runContractsGenerate(options = {}) {
       runner,
       models: { extract: extractModel, repair: repairModel, fallback: fallbackModel },
       dryRun: !!options.diff,
+      onSlicesReady: (t2) => {
+        totalSlices = t2;
+      },
       onSliceCacheHit: (s) => {
-        O2.message(`  cache hit  ${s.specPath} :: ${s.headingPath.join(" \u2192 ")}`, { symbol: "\xB7" });
+        O2.message(`  cache hit  ${++sliceNum}/${totalSlices}  ${s.specPath} :: ${s.headingPath.join(" \u2192 ")}`, { symbol: "\xB7" });
       }
     });
   } catch (e) {
@@ -149166,7 +149171,7 @@ async function runContractsGenerate(options = {}) {
   }
   stampGeneratedMarker(repoRoot5);
   if (result.write.written.length === 0) {
-    gt("Up to date \u2014 no contract files needed updating.");
+    gt("Up to date \u2014 run `truecourse verify`.");
     return;
   }
   O2.success(`Wrote ${result.write.written.length} contract file${result.write.written.length === 1 ? "" : "s"}.`);
@@ -149197,7 +149202,7 @@ async function runContractsList(options = {}) {
   }
   mt(`Contracts (${files.length})`);
   for (const f2 of files) console.log(`  ${path54.relative(repoRoot5, f2)}`);
-  gt("");
+  gt("`truecourse contracts validate` then `truecourse verify`.");
 }
 async function runContractsValidate(options = {}) {
   const repoRoot5 = options.cwd ?? process.cwd();
@@ -149233,6 +149238,7 @@ async function runContractsValidate(options = {}) {
   }
   if (issues.length === 0) {
     O2.success(`Validated ${resolution.index.size} artifact${resolution.index.size === 1 ? "" : "s"} \u2014 no issues.`);
+    gt("Run `truecourse verify`.");
     return;
   }
   O2.error(`${issues.length} issue${issues.length === 1 ? "" : "s"}:`);
@@ -149354,7 +149360,9 @@ async function runSpecScan(opts = {}) {
       O2.message('                      truecourse spec conflicts custom <id> --text "\u2026"');
       O2.message("  \u2022 accept defaults:  truecourse spec resolve --all-defaults");
     }
-    gt(merge2.openConflicts.length === 0 ? "No open conflicts." : `${merge2.openConflicts.length} open.`);
+    gt(
+      merge2.openConflicts.length === 0 ? "No open conflicts \u2014 run `truecourse contracts generate`." : `${merge2.openConflicts.length} open.`
+    );
   } catch (e) {
     renderer.dispose();
     pt(`Failed: ${e.message}`);
@@ -149405,7 +149413,9 @@ async function runSpecStatus(opts = {}) {
       O2.message("");
       summarizeConflicts("Open", merge2.openConflicts);
     }
-    gt(merge2.openConflicts.length === 0 ? "Up to date." : "Pending decisions.");
+    gt(
+      merge2.openConflicts.length === 0 ? "Up to date \u2014 run `truecourse contracts generate`." : "Pending decisions \u2014 see `truecourse spec conflicts list`."
+    );
   } catch (e) {
     renderer.dispose();
     pt(`Failed: ${e.message}`);
@@ -149571,7 +149581,7 @@ async function runSpecConflictsList(opts = {}) {
   for (const c2 of list) {
     O2.message(`  \u2022 ${c2.id}  [${c2.topic}] ${c2.subject}  (${c2.candidates.length} candidates)`);
   }
-  gt("Use `truecourse spec conflicts show <id>` for full detail.");
+  gt('`show <id>` for detail \xB7 resolve with `pick <id> <n>` or `custom <id> --text "\u2026"`.');
 }
 async function runSpecConflictsShow(conflictId2, opts = {}) {
   const root = repoRoot2(opts);
@@ -149605,7 +149615,10 @@ async function runSpecConflictsShow(conflictId2, opts = {}) {
       if (diffs.length > 12) O2.message(`  \u2026 and ${diffs.length - 12} more`);
     }
   }
-  gt("");
+  if (!opts.diff) O2.message("add --diff to see field-level differences.");
+  gt(
+    `resolve: truecourse spec conflicts pick ${conflict.id} <n>  \xB7  custom ${conflict.id} --text "\u2026"`
+  );
 }
 async function runSpecConflictsPick(conflictId2, candidateIndex, opts = {}) {
   const root = repoRoot2(opts);
@@ -149624,7 +149637,10 @@ async function runSpecConflictsPick(conflictId2, candidateIndex, opts = {}) {
     note: opts.note
   });
   await refreshScan(root);
-  emitOk(`Picked candidate ${candidateIndex} on ${conflictId2.slice(0, 12)}\u2026`);
+  emitOk(
+    `Picked candidate ${candidateIndex} on ${conflictId2.slice(0, 12)}\u2026`,
+    "next: resolve remaining (`truecourse spec conflicts list`) or `truecourse contracts generate`."
+  );
 }
 async function runSpecConflictsCustom(conflictId2, text, opts = {}) {
   const root = repoRoot2(opts);
@@ -149640,13 +149656,19 @@ async function runSpecConflictsCustom(conflictId2, text, opts = {}) {
     candidateFingerprint: candidateFingerprint(conflict)
   });
   await refreshScan(root);
-  emitOk(`Wrote custom answer for ${conflictId2.slice(0, 12)}\u2026`);
+  emitOk(
+    `Wrote custom answer for ${conflictId2.slice(0, 12)}\u2026`,
+    "next: resolve remaining (`truecourse spec conflicts list`) or `truecourse contracts generate`."
+  );
 }
 async function runSpecConflictsRevoke(conflictId2, opts = {}) {
   const root = repoRoot2(opts);
   revokeDecision(root, conflictId2);
   await refreshScan(root);
-  emitOk(`Revoked decision for ${conflictId2.slice(0, 12)}\u2026`);
+  emitOk(
+    `Revoked decision for ${conflictId2.slice(0, 12)}\u2026`,
+    `re-resolve: truecourse spec conflicts pick ${conflictId2} <n>  \xB7  custom ${conflictId2} --text "\u2026"`
+  );
 }
 function serializeConflict(c2) {
   return {
@@ -149657,7 +149679,8 @@ function serializeConflict(c2) {
 async function refreshScan(root) {
   await scanInProcess(root, {});
 }
-function emitOk(msg) {
+function emitOk(msg, hint) {
+  if (hint) O2.message(hint);
   gt(msg);
 }
 function fail(msg) {
@@ -149739,22 +149762,29 @@ async function runSpecChainsList(opts = {}) {
   for (const c2 of manual) {
     O2.message(`  ${c2.older}  \u2192  ${c2.newer}  ${c2.note ? `\xB7 ${c2.note}` : ""}`);
   }
-  gt("");
+  gt("manage with `truecourse spec chains add/remove`.");
 }
 async function runSpecChainsAdd(opts) {
   const root = repoRoot3(opts);
   if (opts.older === opts.newer) return fail2("older and newer must be different docs");
   addManualChain(root, { older: opts.older, newer: opts.newer, note: opts.note });
   await scanInProcess(root, {});
-  emitOk2(`Marked ${opts.older} as superseded by ${opts.newer}`);
+  emitOk2(
+    `Marked ${opts.older} as superseded by ${opts.newer}`,
+    "re-run `truecourse spec scan` to apply."
+  );
 }
 async function runSpecChainsRemove(opts) {
   const root = repoRoot3(opts);
   removeManualChain(root, { older: opts.older, newer: opts.newer });
   await scanInProcess(root, {});
-  emitOk2(`Removed chain ${opts.older} \u2192 ${opts.newer}`);
+  emitOk2(
+    `Removed chain ${opts.older} \u2192 ${opts.newer}`,
+    "re-run `truecourse spec scan` to apply."
+  );
 }
-function emitOk2(msg) {
+function emitOk2(msg, hint) {
+  if (hint) O2.message(hint);
   gt(msg);
 }
 function fail2(msg) {
@@ -149782,23 +149812,30 @@ async function runSpecDocsSkipped(opts = {}) {
     O2.step(`Manual includes (${manualIncludes.length})`);
     for (const inc of manualIncludes) O2.message(`  ${inc}`);
   }
-  gt("");
+  gt("force-include with `truecourse spec docs include <path>`.");
 }
 async function runSpecDocsInclude(docPath, opts = {}) {
   const root = repoRoot4(opts);
   if (!docPath) return fail3("Missing doc path");
   addManualInclude(root, docPath);
   await scanInProcess(root, {});
-  emitOk3(`Force-include ${docPath}`);
+  emitOk3(
+    `Force-include ${docPath}`,
+    "re-scanned \u2014 review `truecourse spec conflicts list`."
+  );
 }
 async function runSpecDocsUninclude(docPath, opts = {}) {
   const root = repoRoot4(opts);
   if (!docPath) return fail3("Missing doc path");
   removeManualInclude(root, docPath);
   await scanInProcess(root, {});
-  emitOk3(`Removed force-include for ${docPath}`);
+  emitOk3(
+    `Removed force-include for ${docPath}`,
+    "re-scanned \u2014 review `truecourse spec conflicts list`."
+  );
 }
-function emitOk3(msg) {
+function emitOk3(msg, hint) {
+  if (hint) O2.message(hint);
   gt(msg);
 }
 function fail3(msg) {
@@ -152751,7 +152788,7 @@ async function runHooksRun() {
 
 // tools/cli/src/index.ts
 var program2 = new Command();
-program2.name("truecourse").version("0.6.0-next.2").description("TrueCourse CLI \u2014 analyze your repository and open the dashboard");
+program2.name("truecourse").version("0.6.0-next.4").description("TrueCourse CLI \u2014 analyze your repository and open the dashboard");
 var dashboardCmd = program2.command("dashboard").description("Start the TrueCourse dashboard and open it in your browser").option("--reconfigure", "Re-prompt for console vs background service mode").option("--service", "Run as a background service (skips mode prompt)").option("--console", "Run in this terminal (skips mode prompt)").action(async (options) => {
   if (options.service && options.console) {
     console.error("error: --service and --console are mutually exclusive");

package/package.json

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

package/server.mjs

@@ -156920,7 +156920,7 @@ function readToolVersion() {
   if (cachedVersion)
     return cachedVersion;
   if (true) {
-    cachedVersion = "0.6.0-next.2";
+    cachedVersion = "0.6.0-next.4";
     return cachedVersion;
   }
   try {