@basou/cli 0.42.0 → 0.42.2

package/dist/index.js

@@ -1149,6 +1149,15 @@ async function warnLinkedFilesOutsideRoots(input) {
   } catch {
   }
 }
+var TRACK_MARKER_IN_TITLE = /^\s*track\s*[:\uff1a]|[[(\uff08\uff3b\u3010]\s*track\s*[\])\uff09\uff3d\u3011]/i;
+function warnTrackMarkerWithoutKind(decisions, markerWithoutKind) {
+  for (const index of markerWithoutKind) {
+    const title = (decisions[index]?.title ?? "").trim();
+    console.error(
+      `basou: decision[${index}] title carries a track marker (${title.slice(0, 40)}) but "kind" is absent \u2014 it is recorded as a point-in-time decision and will NOT resurface in orient. Set "kind": "track" to open a track, or "kind": "decision" to say the marker is part of the title.`
+    );
+  }
+}
 async function doRunDecisionRecord(options, ctx) {
   const cwd = ctx.cwd ?? process.cwd();
   const repositoryRoot = await resolveRepositoryRootForDecision(cwd);
@@ -1246,7 +1255,8 @@ async function doRunDecisionCapture(options, ctx) {
   const paths = basouPaths3(repositoryRoot);
   await assertWorkspaceInitialized2(paths.root);
   const raw = await readCaptureInput(options, ctx);
-  const decisions = parseCaptureInput(raw);
+  const { decisions, markerWithoutKind } = parseCaptureInput(raw);
+  warnTrackMarkerWithoutKind(decisions, markerWithoutKind);
   await warnLinkedFilesOutsideRoots({
     linkedFiles: decisions.flatMap((d) => d.linked_files ?? []),
     cwd,
@@ -1507,7 +1517,14 @@ function parseCaptureInput(raw) {
   if (parsed.length === 0) {
     throw new Error("Input array must contain at least one decision.");
   }
-  return parsed.map((item, index) => validateCaptureItem(item, index));
+  const decisions = [];
+  const markerWithoutKind = [];
+  parsed.forEach((item, index) => {
+    const { input, kindWasPresent } = validateCaptureItem(item, index);
+    decisions.push(input);
+    if (!kindWasPresent && TRACK_MARKER_IN_TITLE.test(input.title)) markerWithoutKind.push(index);
+  });
+  return { decisions, markerWithoutKind };
 }
 function validateCaptureItem(item, index) {
   if (typeof item !== "object" || item === null || Array.isArray(item)) {
@@ -1568,7 +1585,7 @@ function validateCaptureItem(item, index) {
       }
     });
   }
-  return out;
+  return { input: out, kindWasPresent: obj.kind !== void 0 };
 }
 function requireNonEmptyString(value, index, field) {
   if (typeof value !== "string" || isBlank(value)) {
@@ -1619,6 +1636,9 @@ function captureItemToPayload(item) {
   if (item.input.kind !== void 0) payload.kind = item.input.kind;
   return payload;
 }
+function kindMarker(kind) {
+  return kind === "track" ? " [TRACK]" : " [DECISION]";
+}
 function printCapturePreview(options, decisions) {
   if (options.json === true) {
     console.log(JSON.stringify({ dry_run: true, count: decisions.length, decisions }));
@@ -1628,7 +1648,7 @@ function printCapturePreview(options, decisions) {
     `Would capture ${decisions.length} decision${decisions.length === 1 ? "" : "s"} (dry run; nothing written):`
   );
   for (const decision of decisions) {
-    console.log(`- ${decision.title}${decision.kind === "track" ? " [TRACK]" : ""}`);
+    console.log(`- ${decision.title}${kindMarker(decision.kind)}`);
   }
 }
 function printCaptureResult(options, result) {
@@ -1649,9 +1669,7 @@ function printCaptureResult(options, result) {
     `Captured ${result.items.length} decision${result.items.length === 1 ? "" : "s"} in ad-hoc session ${sid}:`
   );
   for (const item of result.items) {
-    console.log(
-      `- ${item.decisionId}: ${item.input.title}${item.input.kind === "track" ? " [TRACK]" : ""}`
-    );
+    console.log(`- ${item.decisionId}: ${item.input.title}${kindMarker(item.input.kind)}`);
   }
 }
 function pickRichFields(options) {
@@ -11752,6 +11770,9 @@ function formatCoverageReport(result) {
   lines.push(
     "Register the project in a workspace's import.source_roots to start capturing it (registering a path in ~/.basou/portfolio.yaml alone imports nothing \u2014 it only adds the workspace to this view). A scratch directory, a temp path, or a GUI tool's own working directory has no repo to declare and is expected to stay here."
   );
+  lines.push(
+    "A directory that no longer exists is still worth declaring: when a project moved or was renamed, add its OLD path \u2014 written relative to the workspace it now lives in \u2014 to that workspace's import.source_roots. The path does not have to exist for the sessions recorded under it to be captured on the next refresh."
+  );
   return [...lines, ...inertLines(result)];
 }
 function inertLines(result) {