@basou/cli 0.18.0 → 0.19.0

package/dist/index.js

@@ -838,6 +838,9 @@ function registerDecisionCommand(program2) {
     "Related file path (repeatable). Path is opaque; existence is verified at render time.",
     collectLinkedFile,
     []
+  ).option(
+    "--track",
+    "Record as a strategic track (an unfinished direction + why). orientation/handoff keep resurfacing open tracks until you close one with 'basou decision void'."
   ).option(
     "--session <session_id>",
     "Attach to an existing session; otherwise an ad-hoc session is created"
@@ -870,13 +873,22 @@ Input format (a JSON array; one object per decision):
       "alternatives": ["npm workspaces", "yarn"],
       "rejected_reason": "npm hoisting caused phantom-dependency bugs",
       "linked_files": ["pnpm-workspace.yaml"]
+    },
+    {
+      "title": "Form-based admin editing is the next track (only 6/19 sections done)",
+      "rationale": "Raw-JSON editing is a stopgap, not the final shape; cover the rest.",
+      "kind": "track"
     }
   ]
 
-Only "title" is required; every other field is optional. All decisions are
-written into one ad-hoc session timestamped now, so orientation surfaces them
-as the latest decisions. Run from a workspace-view directory and it resolves to
-the planning repo, like 'basou orient' / 'basou refresh' / 'basou note'.
+Only "title" is required; every other field is optional. Set "kind": "track" to
+record a strategic, UNFINISHED direction (+ why): orientation/handoff resurface
+open tracks every session until you close one with 'basou decision void <id>'.
+Absent / "decision" is a point-in-time decision (surfaced only as the latest).
+All decisions are written into one ad-hoc session timestamped now, so
+orientation surfaces them as the latest decisions. Run from a workspace-view
+directory and it resolves to the planning repo, like 'basou orient' /
+'basou refresh' / 'basou note'.
 
 Example (heredoc on stdin):
   basou decision capture <<'JSON'
@@ -973,7 +985,7 @@ async function doRunDecisionRecord(options, ctx) {
     workingDirectory: repositoryRoot,
     invocation: {
       command: "basou decision record",
-      args: ["--title", options.title]
+      args: options.track === true ? ["--title", options.title, "--track"] : ["--title", options.title]
     },
     targetEventBuilders: [
       (sessionId, eventId) => buildDecisionEvent({
@@ -1254,7 +1266,8 @@ var CAPTURE_ALLOWED_KEYS = /* @__PURE__ */ new Set([
   "rejected_reason",
   "alternatives",
   "linked_events",
-  "linked_files"
+  "linked_files",
+  "kind"
 ]);
 function parseCaptureInput(raw) {
   if (raw.trim().length === 0) {
@@ -1283,7 +1296,7 @@ function validateCaptureItem(item, index) {
   for (const key of Object.keys(obj)) {
     if (!CAPTURE_ALLOWED_KEYS.has(key)) {
       throw new Error(
-        `decision[${index}]: unknown field '${key}'. Allowed: title, rationale, rejected_reason, alternatives, linked_events, linked_files.`
+        `decision[${index}]: unknown field '${key}'. Allowed: title, rationale, rejected_reason, alternatives, linked_events, linked_files, kind.`
       );
     }
   }
@@ -1291,6 +1304,12 @@ function validateCaptureItem(item, index) {
     throw new Error(`decision[${index}].title must be a non-empty string.`);
   }
   const out = { title: obj.title };
+  if (obj.kind !== void 0) {
+    if (obj.kind !== "decision" && obj.kind !== "track") {
+      throw new Error(`decision[${index}].kind must be "decision" or "track", got '${obj.kind}'.`);
+    }
+    if (obj.kind === "track") out.kind = "track";
+  }
   if (obj.rationale !== void 0) {
     out.rationale = requireNonEmptyString(obj.rationale, index, "rationale");
   }
@@ -1358,6 +1377,7 @@ function toRichFields(decision) {
   if (decision.alternatives !== void 0) out.alternatives = [...decision.alternatives];
   if (decision.linked_events !== void 0) out.linked_events = [...decision.linked_events];
   if (decision.linked_files !== void 0) out.linked_files = [...decision.linked_files];
+  if (decision.kind !== void 0) out.kind = decision.kind;
   return out;
 }
 function buildCaptureLabel(count) {
@@ -1375,6 +1395,7 @@ function captureItemToPayload(item) {
     payload.rejected_reason = item.input.rejected_reason;
   if (item.input.linked_events !== void 0) payload.linked_events = item.input.linked_events;
   if (item.input.linked_files !== void 0) payload.linked_files = item.input.linked_files;
+  if (item.input.kind !== void 0) payload.kind = item.input.kind;
   return payload;
 }
 function printCapturePreview(options, decisions) {
@@ -1386,7 +1407,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}`);
+    console.log(`- ${decision.title}${decision.kind === "track" ? " [TRACK]" : ""}`);
   }
 }
 function printCaptureResult(options, result) {
@@ -1407,7 +1428,9 @@ 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}`);
+    console.log(
+      `- ${item.decisionId}: ${item.input.title}${item.input.kind === "track" ? " [TRACK]" : ""}`
+    );
   }
 }
 function pickRichFields(options) {
@@ -1423,6 +1446,7 @@ function pickRichFields(options) {
   if (options.linkedFile !== void 0 && options.linkedFile.length > 0) {
     out.linked_files = [...options.linkedFile];
   }
+  if (options.track === true) out.kind = "track";
   return out;
 }
 function buildDecisionEvent(input) {
@@ -1439,7 +1463,8 @@ function buildDecisionEvent(input) {
     ...input.rich.alternatives !== void 0 ? { alternatives: input.rich.alternatives } : {},
     ...input.rich.rejected_reason !== void 0 ? { rejected_reason: input.rich.rejected_reason } : {},
     ...input.rich.linked_events !== void 0 ? { linked_events: input.rich.linked_events } : {},
-    ...input.rich.linked_files !== void 0 ? { linked_files: input.rich.linked_files } : {}
+    ...input.rich.linked_files !== void 0 ? { linked_files: input.rich.linked_files } : {},
+    ...input.rich.kind !== void 0 ? { kind: input.rich.kind } : {}
   };
 }
 function buildAdHocLabel(title) {
@@ -1506,15 +1531,19 @@ function printDecisionResult(options, result) {
     }
     if (result.rich.linked_events !== void 0) payload.linked_events = result.rich.linked_events;
     if (result.rich.linked_files !== void 0) payload.linked_files = result.rich.linked_files;
+    if (result.rich.kind !== void 0) payload.kind = result.rich.kind;
     console.log(JSON.stringify(payload));
     return;
   }
+  const trackPrefix = result.rich.kind === "track" ? "track " : "";
   const rationaleSuffix = result.rich.rationale !== void 0 ? ` (rationale: ${result.rich.rationale})` : "";
   if (result.mode === "ad-hoc") {
-    console.log(`Recorded ${result.decisionId} in ad-hoc session ${sid}${rationaleSuffix}`);
+    console.log(
+      `Recorded ${trackPrefix}${result.decisionId} in ad-hoc session ${sid}${rationaleSuffix}`
+    );
   } else {
     console.log(
-      `Recorded ${result.decisionId} in session ${sid} (${result.sessionStatus})${rationaleSuffix}`
+      `Recorded ${trackPrefix}${result.decisionId} in session ${sid} (${result.sessionStatus})${rationaleSuffix}`
     );
   }
 }