truecourse 0.6.0-next.1 → 0.6.0-next.3

package/cli.mjs

@@ -128242,7 +128242,7 @@ function readToolVersion() {
   if (cachedVersion)
     return cachedVersion;
   if (true) {
-    cachedVersion = "0.6.0-next.1";
+    cachedVersion = "0.6.0-next.3";
     return cachedVersion;
   }
   try {
@@ -149166,7 +149166,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 +149197,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 +149233,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"}:`);
@@ -149341,14 +149342,22 @@ async function runSpecScan(opts = {}) {
       O2.message("Open conflicts:");
       for (const c2 of merge2.openConflicts.slice(0, 10)) {
         O2.message(`  \u2022 ${c2.subject}  (${c2.candidates.length} candidates, default: ${c2.candidates[c2.defaultPick].claim.provenance.file})`);
+        O2.message(`    id: ${c2.id}`);
       }
       if (merge2.openConflicts.length > 10) {
-        O2.message(`  \u2026 (+${merge2.openConflicts.length - 10} more)`);
+        O2.message(`  \u2026 (+${merge2.openConflicts.length - 10} more \u2014 run \`truecourse spec conflicts list\`)`);
       }
       O2.message("");
-      O2.message("Resolve in the dashboard, or run `truecourse spec resolve --all-defaults`.");
+      O2.message("Resolve them:");
+      O2.message("  \u2022 dashboard:        truecourse dashboard            (Spec tab)");
+      O2.message("  \u2022 per conflict:     truecourse spec conflicts show <id>");
+      O2.message("                      truecourse spec conflicts pick <id> <candidateIndex>");
+      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}`);
@@ -149399,7 +149408,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}`);
@@ -149563,9 +149574,9 @@ async function runSpecConflictsList(opts = {}) {
   const list = opts.all ? [...open, ...decided.map((d3) => d3.conflict)] : opts.decided ? decided.map((d3) => d3.conflict) : open;
   O2.step(`${list.length} ${which} conflicts`);
   for (const c2 of list) {
-    O2.message(`  \u2022 ${c2.id.slice(0, 12)}\u2026  [${c2.topic}] ${c2.subject}  (${c2.candidates.length} candidates)`);
+    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);
@@ -149575,7 +149586,7 @@ async function runSpecConflictsShow(conflictId2, opts = {}) {
     pt(`Conflict ${conflictId2} not found.`);
     process.exit(1);
   }
-  mt(`Conflict ${conflict.id.slice(0, 12)}\u2026 \u2014 ${conflict.subject}`);
+  mt(`Conflict ${conflict.id} \u2014 ${conflict.subject}`);
   O2.step(`topic: ${conflict.topic}`);
   if (conflict.explanation) O2.message(conflict.explanation);
   O2.step(`${conflict.candidates.length} candidates (default-pick: ${conflict.defaultPick})`);
@@ -149599,7 +149610,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);
@@ -149618,7 +149632,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);
@@ -149634,13 +149651,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 {
@@ -149651,7 +149674,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) {
@@ -149733,22 +149757,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) {
@@ -149776,23 +149807,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) {
@@ -152745,7 +152783,7 @@ async function runHooksRun() {
 
 // tools/cli/src/index.ts
 var program2 = new Command();
-program2.name("truecourse").version("0.6.0-next.1").description("TrueCourse CLI \u2014 analyze your repository and open the dashboard");
+program2.name("truecourse").version("0.6.0-next.3").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.1",
+  "version": "0.6.0-next.3",
   "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.1";
+    cachedVersion = "0.6.0-next.3";
     return cachedVersion;
   }
   try {