@basou/core 0.18.0 → 0.19.0

package/dist/index.d.ts

@@ -410,6 +410,10 @@ declare const SessionImportPayloadSchema: z.ZodObject<{
         rejected_reason: z.ZodOptional<z.ZodNullable<z.ZodString>>;
         linked_events: z.ZodOptional<z.ZodArray<z.ZodString & z.ZodType<`evt_${string}`, string, z.core.$ZodTypeInternals<`evt_${string}`, string>>>>;
         linked_files: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        kind: z.ZodOptional<z.ZodEnum<{
+            decision: "decision";
+            track: "track";
+        }>>;
     }, z.core.$strip>, z.ZodObject<{
         schema_version: z.ZodLiteral<"0.1.0">;
         id: z.ZodString & z.ZodType<`evt_${string}`, string, z.core.$ZodTypeInternals<`evt_${string}`, string>>;
@@ -966,6 +970,10 @@ declare const DecisionRecordedEventSchema: z.ZodObject<{
     rejected_reason: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     linked_events: z.ZodOptional<z.ZodArray<z.ZodString & z.ZodType<`evt_${string}`, string, z.core.$ZodTypeInternals<`evt_${string}`, string>>>>;
     linked_files: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    kind: z.ZodOptional<z.ZodEnum<{
+        decision: "decision";
+        track: "track";
+    }>>;
 }, z.core.$strip>;
 declare const TaskCreatedEventSchema: z.ZodObject<{
     schema_version: z.ZodLiteral<"0.1.0">;
@@ -1214,6 +1222,10 @@ declare const EventSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
     rejected_reason: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     linked_events: z.ZodOptional<z.ZodArray<z.ZodString & z.ZodType<`evt_${string}`, string, z.core.$ZodTypeInternals<`evt_${string}`, string>>>>;
     linked_files: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    kind: z.ZodOptional<z.ZodEnum<{
+        decision: "decision";
+        track: "track";
+    }>>;
 }, z.core.$strip>, z.ZodObject<{
     schema_version: z.ZodLiteral<"0.1.0">;
     id: z.ZodString & z.ZodType<`evt_${string}`, string, z.core.$ZodTypeInternals<`evt_${string}`, string>>;
@@ -3298,6 +3310,8 @@ type OrientationRendererResult = {
     /** Tasks whose status is `planned` or `in_progress`. */
     inFlightTaskCount: number;
     decisionCount: number;
+    /** Open (non-voided) `kind: "track"` decisions surfaced as strategic continuation. */
+    openTrackCount: number;
 };
 type DecisionRecord = {
     decisionId: string;
@@ -3306,6 +3320,21 @@ type DecisionRecord = {
     sessionId: string;
     host: string | null;
 };
+/**
+ * An open (non-voided) decision recorded with `kind: "track"` — a strategic,
+ * unfinished direction the forward section resurfaces every session until it is
+ * closed via `decision void` / supersede. Carries the rationale (the WHY) so the
+ * surfaced track answers not just "what to build next" but "and why", which is
+ * exactly the intent that otherwise lives only in the conversation.
+ */
+type TrackRecord = {
+    decisionId: string;
+    title: string;
+    rationale: string | null;
+    occurredAt: string;
+    sessionId: string;
+    host: string | null;
+};
 type NoteRecord = {
     body: string;
     sessionId: string;
@@ -3370,6 +3399,16 @@ type OrientationSummary = {
     /** Most recent `decision_recorded` across all sessions; null when none. */
     latestDecision: DecisionRecord | null;
     decisionCount: number;
+    /**
+     * Open (non-voided) `kind: "track"` decisions — strategic, unfinished
+     * directions that the forward section ("どこへ向かう") resurfaces every session
+     * until they are closed with `decision void` / supersede. Newest first. This
+     * is the intent-continuity layer: distinct from the single latest decision
+     * (point-in-time) and the recorded next step (`note`), an open track keeps
+     * carrying "the next essential thing to build, and why" across sessions so it
+     * does not sink into the flat decision list. Empty when none are open.
+     */
+    openTracks: TrackRecord[];
     /**
      * Most recent `note_added` over non-archived sessions — the recorded next
      * step / handoff ("次の起点") surfaced in the forward section; null when none.
@@ -4695,6 +4734,8 @@ type ReportDecisionItem = {
     occurredAt: string;
     /** True when a later `decision_voided` event retracted this decision. */
     voided?: boolean;
+    /** True when the decision was recorded as a strategic track (`kind: "track"`). */
+    track?: boolean;
 };
 type ReportTaskItem = {
     id: string;

package/dist/index.js

@@ -872,7 +872,17 @@ var DecisionRecordedEventSchema = BaseEventSchema.extend({
   alternatives: z3.array(z3.string().min(1)).optional(),
   rejected_reason: z3.string().nullable().optional(),
   linked_events: z3.array(EventIdSchema).optional(),
-  linked_files: z3.array(z3.string().min(1).max(4096)).optional()
+  linked_files: z3.array(z3.string().min(1).max(4096)).optional(),
+  // `track` promotes a decision to a strategic, unfinished DIRECTION ("the next
+  // essential thing to build, and why") that orientation/handoff resurface every
+  // time until it is explicitly closed with `decision void` / supersede — as
+  // opposed to a point-in-time `decision`, which is only ever surfaced as the
+  // single latest one. This is the intent-continuity layer: a direction agreed
+  // in conversation otherwise sinks into the flat decision list and never carries
+  // to the next session. Absent (the default) is a plain `decision`, so all
+  // pre-existing decision_recorded events round-trip unchanged (additive optional
+  // => no schema_version bump; mirrors `note_added.kind`).
+  kind: z3.enum(["decision", "track"]).optional()
 });
 var DecisionVoidedEventSchema = BaseEventSchema.extend({
   type: z3.literal("decision_voided"),
@@ -1487,6 +1497,7 @@ async function renderDecisions(input) {
             rejectedReason: ev.rejected_reason,
             linkedEvents: ev.linked_events,
             linkedFiles: ev.linked_files,
+            kind: ev.kind,
             voided: void 0
           });
         } else if (ev.type === "decision_voided") {
@@ -1542,18 +1553,22 @@ async function formatDecisionsBody(args) {
     return lines.join("\n");
   }
   for (const d of args.decisions) {
+    const trackMark = d.kind === "track" ? " [TRACK]" : "";
     if (d.voided !== void 0) {
-      lines.push(`## ~~${d.decisionId}: ${d.title}~~ [VOIDED]`);
+      lines.push(`## ~~${d.decisionId}: ${d.title}~~ [VOIDED]${trackMark}`);
       lines.push("");
       const supersededBy = d.voided.supersededBy !== void 0 ? `, superseded by ${d.voided.supersededBy}` : "";
       const reason = typeof d.voided.reason === "string" && d.voided.reason.length > 0 ? `: ${d.voided.reason}` : "";
       lines.push(`- \u26A0 VOIDED${reason}${supersededBy}`);
     } else {
-      lines.push(`## ${d.decisionId}: ${d.title}`);
+      lines.push(`## ${d.decisionId}: ${d.title}${trackMark}`);
       lines.push("");
     }
     const occurredDate = d.occurredAt.slice(0, 10);
     lines.push(`- \u6C7A\u5B9A\u65E5: ${occurredDate}`);
+    if (d.kind === "track" && d.voided === void 0) {
+      lines.push("- \u7A2E\u5225: track (close \u307E\u3067 orient/handoff \u306B\u7D99\u7D9A\u8868\u793A)");
+    }
     lines.push(`- session: ${shortDecisionSessionId(d.sessionId)}`);
     lines.push(`- \u5224\u65AD: ${d.title}`);
     if (typeof d.rationale === "string" && d.rationale.length > 0) {
@@ -3876,6 +3891,7 @@ async function renderHandoff(input) {
   if (input.onWarning !== void 0) loadOpts.onWarning = input.onWarning;
   const entries = await loadSessionEntries(input.paths, loadOpts);
   const decisions = [];
+  const tracks = [];
   const voidedDecisionIds = /* @__PURE__ */ new Set();
   const tasksCreated = [];
   const tasksStatusChanged = [];
@@ -3901,6 +3917,15 @@ async function renderHandoff(input) {
             occurredAt: ev.occurred_at,
             sessionId: entry.sessionId
           });
+          if (ev.kind === "track") {
+            tracks.push({
+              decisionId: ev.decision_id,
+              title: ev.title,
+              rationale: ev.rationale ?? null,
+              occurredAt: ev.occurred_at,
+              sessionId: entry.sessionId
+            });
+          }
         } else if (ev.type === "decision_voided") {
           voidedDecisionIds.add(ev.decision_id);
         } else if (ev.type === "task_created") {
@@ -3936,6 +3961,10 @@ async function renderHandoff(input) {
       break;
     }
   }
+  const openTracks = tracks.filter((t) => !voidedDecisionIds.has(t.decisionId)).sort((a, b) => {
+    const c = Date.parse(b.occurredAt) - Date.parse(a.occurredAt);
+    return c !== 0 ? c : b.decisionId.localeCompare(a.decisionId);
+  });
   tasksCreated.sort((a, b) => {
     const c = Date.parse(a.occurredAt) - Date.parse(b.occurredAt);
     return c !== 0 ? c : a.taskId.localeCompare(b.taskId);
@@ -3980,6 +4009,7 @@ async function renderHandoff(input) {
     latestActivityAt,
     decisions,
     latestDecision,
+    openTracks,
     pendingApprovalsCount,
     suspectCount,
     displayedFiles,
@@ -4065,6 +4095,23 @@ function formatHandoffBody(args) {
     lines.push(`(${args.decisions.length} decisions total \u2014 see decisions.md)`);
   }
   lines.push("");
+  if (args.openTracks.length > 0) {
+    const TRACK_DISPLAY_LIMIT = 10;
+    const shown = args.openTracks.slice(0, TRACK_DISPLAY_LIMIT);
+    const overflow = args.openTracks.length - shown.length;
+    lines.push("## \u672A\u5B8C\u30C8\u30E9\u30C3\u30AF (close \u307E\u3067\u7D99\u7D9A\u8868\u793A)");
+    lines.push("");
+    for (const t of shown) {
+      lines.push(`- ${t.title} [${shortIdWithPrefix(t.decisionId)}]`);
+      if (t.rationale !== null && t.rationale.trim() !== "") {
+        lines.push(`  - \u7406\u7531: ${handoffRationale(t.rationale)}`);
+      }
+    }
+    if (overflow > 0) lines.push(`- ... +${overflow} more (see decisions.md)`);
+    lines.push("");
+    lines.push("\u5B8C\u4E86\u3057\u305F\u3089 `basou decision void <decision_id>` \u3067\u9589\u3058\u3066\u304F\u3060\u3055\u3044\u3002");
+    lines.push("");
+  }
   lines.push("## \u672A\u6C7A\u4E8B\u9805");
   lines.push("");
   if (args.pendingApprovalsCount > 0) {
@@ -4149,6 +4196,11 @@ function formatHandoffBody(args) {
   lines.push(sessionsLine);
   return lines.join("\n");
 }
+var HANDOFF_TRACK_RATIONALE_MAX = 240;
+function handoffRationale(rationale) {
+  const oneLine = rationale.replace(/\s+/g, " ").trim();
+  return oneLine.length > HANDOFF_TRACK_RATIONALE_MAX ? `${oneLine.slice(0, HANDOFF_TRACK_RATIONALE_MAX - 1)}\u2026` : oneLine;
+}
 function suspectLabel(reason) {
   if (reason === "events_say_ended_but_yaml_running") return " \u26A0 ended (yaml stale)";
   if (reason === "running_no_end_event") return " \u26A0 no end event";
@@ -4502,6 +4554,7 @@ async function summarizeOrientation(input) {
     }
   ) : await loadSessionEntries(input.paths, loadOpts);
   const decisions = [];
+  const tracks = [];
   const voidedDecisionIds = /* @__PURE__ */ new Set();
   let latestActivityAt = null;
   let latestNote = null;
@@ -4526,6 +4579,16 @@ async function summarizeOrientation(input) {
             sessionId: entry.sessionId,
             host: entry.host
           });
+          if (ev.kind === "track") {
+            tracks.push({
+              decisionId: ev.decision_id,
+              title: ev.title,
+              rationale: ev.rationale ?? null,
+              occurredAt: ev.occurred_at,
+              sessionId: entry.sessionId,
+              host: entry.host
+            });
+          }
         } else if (ev.type === "decision_voided") {
           voidedDecisionIds.add(ev.decision_id);
         }
@@ -4557,6 +4620,10 @@ async function summarizeOrientation(input) {
       break;
     }
   }
+  const openTracks = tracks.filter((t) => !voidedDecisionIds.has(t.decisionId)).sort((a, b) => {
+    const c = Date.parse(b.occurredAt) - Date.parse(a.occurredAt);
+    return c !== 0 ? c : b.decisionId.localeCompare(a.decisionId);
+  });
   const taskLoadOpts = {};
   if (input.onTaskSkip !== void 0) taskLoadOpts.onSkip = input.onTaskSkip;
   const taskEntries = await loadTaskEntries(input.paths, taskLoadOpts);
@@ -4645,6 +4712,7 @@ async function summarizeOrientation(input) {
     latestSession,
     latestDecision: latestDecision ?? null,
     decisionCount: decisions.length,
+    openTracks,
     latestNote,
     relatedFiles: { displayed, overflow, outOfRoot },
     inFlightTasks,
@@ -4672,7 +4740,8 @@ async function renderOrientation(input) {
     pendingApprovalsCount: summary.pendingApprovals.length,
     suspectCount: summary.suspects.length,
     inFlightTaskCount: summary.inFlightTasks.length,
-    decisionCount: summary.decisionCount
+    decisionCount: summary.decisionCount,
+    openTrackCount: summary.openTracks.length
   };
 }
 function formatOrientationBody(summary, opts) {
@@ -4779,6 +4848,26 @@ function formatOrientationBody(summary, opts) {
   lines.push("");
   lines.push("## \u3069\u3053\u3078\u5411\u304B\u3046");
   lines.push("");
+  if (summary.openTracks.length > 0) {
+    const TRACK_DISPLAY_LIMIT = 10;
+    const shownTracks = summary.openTracks.slice(0, TRACK_DISPLAY_LIMIT);
+    const trackOverflow = summary.openTracks.length - shownTracks.length;
+    lines.push(`### \u672A\u5B8C\u30C8\u30E9\u30C3\u30AF (close \u307E\u3067\u7D99\u7D9A\u8868\u793A) (${summary.openTracks.length})`);
+    for (const t of shownTracks) {
+      const trackAge = relativeAgeJa(t.occurredAt, now);
+      lines.push(`- ${t.title} [${shortId(t.decisionId)}] (${trackAge})${hostSuffix(t.host)}`);
+      if (t.rationale !== null && t.rationale.trim() !== "") {
+        lines.push(`  - \u7406\u7531: ${trackRationale(t.rationale)}`);
+      }
+    }
+    if (trackOverflow > 0) {
+      lines.push(`- ... +${trackOverflow} more (see decisions.md)`);
+    }
+    lines.push(
+      "\u5B8C\u4E86\u3057\u305F\u3089 `basou decision void <decision_id>` \u3067\u9589\u3058\u3066\u304F\u3060\u3055\u3044\u3002\u9589\u3058\u308B\u307E\u3067\u6BCE\u56DE\u3053\u3053\u306B\u8868\u793A\u3055\u308C\u307E\u3059\u3002"
+    );
+    lines.push("");
+  }
   if (summary.latestNote !== null) {
     const noteAge = relativeAgeJa(summary.latestNote.occurredAt, now);
     lines.push(
@@ -4794,7 +4883,7 @@ function formatOrientationBody(summary, opts) {
   for (const t of summary.plannedTasks) {
     lines.push(`- ${t.title} [${shortId(t.id)}]`);
   }
-  if (summary.latestNote === null && summary.plannedTasks.length === 0) {
+  if (summary.openTracks.length === 0 && summary.latestNote === null && summary.plannedTasks.length === 0) {
     const dec = summary.latestDecision;
     if (dec === null) {
       lines.push("- (no planned tasks or recorded next step yet)");
@@ -4807,6 +4896,11 @@ function formatOrientationBody(summary, opts) {
       lines.push("- (no planned tasks \u2014 direction is inferred from recent decisions)");
       lines.push(`  - \u76F4\u8FD1\u306E\u5224\u65AD: ${dec.title}`);
     }
+    if (dec !== null) {
+      lines.push(
+        '  - \u6B21\u306B\u4F5C\u308B\u3079\u304D\u672C\u8CEA\u7684\u306A\u65B9\u5411\u6027\u304C\u5B9A\u307E\u3063\u305F\u3089 `basou decision capture` (`"kind":"track"`) / `basou decision record --track` \u3067 track \u5316\u3059\u308B\u3068\u3001close \u307E\u3067\u6BCE session \u3053\u3053\u306B\u7D99\u7D9A\u8868\u793A\u3055\u308C\u307E\u3059\u3002'
+      );
+    }
   }
   lines.push("");
   lines.push("## \u3053\u308C\u306F\u6700\u65B0\u304B");
@@ -4932,6 +5026,11 @@ function noteSummary(body) {
   const oneLine = body.replace(/\s+/g, " ").trim();
   return oneLine.length > NOTE_SUMMARY_MAX ? `${oneLine.slice(0, NOTE_SUMMARY_MAX - 1)}\u2026` : oneLine;
 }
+var TRACK_RATIONALE_MAX = 240;
+function trackRationale(rationale) {
+  const oneLine = rationale.replace(/\s+/g, " ").trim();
+  return oneLine.length > TRACK_RATIONALE_MAX ? `${oneLine.slice(0, TRACK_RATIONALE_MAX - 1)}\u2026` : oneLine;
+}
 function suspectText(reason) {
   if (reason === "events_say_ended_but_yaml_running") return "ended (yaml stale)";
   if (reason === "running_no_end_event") return "no end event";
@@ -5847,7 +5946,12 @@ async function renderReport(input) {
         onWarning: (w) => input.onWarning?.(w, entry.sessionId)
       })) {
         if (ev.type === "decision_recorded") {
-          decisions.push({ id: ev.decision_id, title: ev.title, occurredAt: ev.occurred_at });
+          decisions.push({
+            id: ev.decision_id,
+            title: ev.title,
+            occurredAt: ev.occurred_at,
+            ...ev.kind === "track" ? { track: true } : {}
+          });
         } else if (ev.type === "decision_voided") {
           voidedDecisionIds.add(ev.decision_id);
         }
@@ -6033,8 +6137,9 @@ function formatReportBody(data) {
       lines.push("");
     }
     for (const d of shown) {
+      const trackTag = d.track === true ? " [track]" : "";
       const voidedTag = d.voided === true ? " (voided)" : "";
-      lines.push(`- ${d.occurredAt.slice(0, 10)} \xB7 ${d.title}${voidedTag}`);
+      lines.push(`- ${d.occurredAt.slice(0, 10)} \xB7 ${d.title}${trackTag}${voidedTag}`);
     }
   }
   lines.push("");