@basou/core 0.13.1 → 0.14.1

package/dist/index.d.ts

@@ -3170,6 +3170,7 @@ type DecisionRecord = {
     decisionId: string;
     title: string;
     occurredAt: string;
+    sessionId: string;
 };
 type NoteRecord = {
     body: string;

package/dist/index.js

@@ -2081,6 +2081,21 @@ function parseDiffNameStatus(raw) {
 // src/handoff/handoff-renderer.ts
 import { join as join13 } from "path";
 
+// src/lib/recency.ts
+var DECISION_TRAILING_ACTIVITY_GAP_MS = 60 * 60 * 1e3;
+function isTrailingStale(latestActivityAt, recordedAt) {
+  if (latestActivityAt === null) return false;
+  return Date.parse(latestActivityAt) - Date.parse(recordedAt) > DECISION_TRAILING_ACTIVITY_GAP_MS;
+}
+function pickLatestSubstantiveEntry(entries) {
+  return [...entries].sort((a, b) => {
+    const aSubstantive = (a.session.session.related_files?.length ?? 0) > 0 ? 1 : 0;
+    const bSubstantive = (b.session.session.related_files?.length ?? 0) > 0 ? 1 : 0;
+    if (aSubstantive !== bSubstantive) return bSubstantive - aSubstantive;
+    return Date.parse(b.session.session.started_at) - Date.parse(a.session.session.started_at);
+  })[0];
+}
+
 // src/storage/tasks.ts
 import { createHash as createHash2 } from "crypto";
 import { mkdir as mkdir3, readdir as readdir4, readFile as readFile7, rename as rename2, stat as stat3, unlink as unlink3 } from "fs/promises";
@@ -3799,12 +3814,21 @@ async function renderHandoff(input) {
   const decisions = [];
   const tasksCreated = [];
   const tasksStatusChanged = [];
+  let latestActivityAt = null;
+  const noteActivity = (iso) => {
+    if (latestActivityAt === null || Date.parse(iso) > Date.parse(latestActivityAt)) {
+      latestActivityAt = iso;
+    }
+  };
   for (const entry of entries) {
     const sessionDir = join13(input.paths.sessions, entry.sessionId);
+    const counted = entry.session.session.status !== "archived";
+    if (counted) noteActivity(entry.session.session.ended_at ?? entry.session.session.started_at);
     try {
       for await (const ev of replayEvents(sessionDir, {
         onWarning: (w) => input.onWarning?.(w, entry.sessionId)
       })) {
+        if (counted) noteActivity(ev.occurred_at);
         if (ev.type === "decision_recorded") {
           decisions.push({
             decisionId: ev.decision_id,
@@ -3864,9 +3888,7 @@ async function renderHandoff(input) {
   const liveEntries = entries.filter(
     (e) => e.session.session.status !== "archived" && e.session.session.source.kind !== "import"
   );
-  const latestSession = [...liveEntries].sort(
-    (a, b) => Date.parse(b.session.session.started_at) - Date.parse(a.session.session.started_at)
-  )[0];
+  const latestSession = pickLatestSubstantiveEntry(liveEntries);
   const latestFiles = latestSession?.session.session.related_files ?? [];
   const sortedFiles = [...new Set(latestFiles)].sort();
   const displayedFiles = sortedFiles.slice(0, limit);
@@ -3880,6 +3902,7 @@ async function renderHandoff(input) {
     sessionRange,
     sessionCount: entries.length,
     latestSession,
+    latestActivityAt,
     decisions,
     pendingApprovalsCount,
     suspectCount,
@@ -3952,6 +3975,16 @@ function formatHandoffBody(args) {
   } else {
     const last = args.decisions[args.decisions.length - 1];
     lines.push(`- ${last.title} [${shortIdWithPrefix(last.decisionId)}]`);
+    if (args.latestActivityAt !== null && isTrailingStale(args.latestActivityAt, last.occurredAt)) {
+      lines.push(
+        "  - \u6CE8: \u6700\u7D42\u6D3B\u52D5\u306F\u3053\u306E\u5224\u65AD\u3088\u308A\u5F8C\u3067\u3059\u3002\u4F1A\u8A71\u3067\u65E2\u306B\u89E3\u6C7A\u6E08\u307F\u306E\u53EF\u80FD\u6027\u304C\u3042\u308B\u305F\u3081\u3001\u518D\u958B\u524D\u306B\u7D99\u7D9A\u70B9\u3092\u78BA\u8A8D\u3057\u3066\u304F\u3060\u3055\u3044(\u4F1A\u8A71\u3067\u306E\u610F\u601D\u6C7A\u5B9A\u306F\u81EA\u52D5\u8A18\u9332\u3055\u308C\u307E\u305B\u3093\u3002`basou decision capture` \u3067\u8A18\u9332\u3067\u304D\u307E\u3059)\u3002"
+      );
+    }
+    if (args.latestSession !== void 0 && last.sessionId !== args.latestSession.sessionId) {
+      lines.push(
+        `  - \u6CE8: \u3053\u306E\u5224\u65AD\u306F\u6700\u7D42 session \u3068\u306F\u5225\u306E session [${shortIdWithPrefix(last.sessionId)}] \u306E\u3082\u306E\u3067\u3059\u3002`
+      );
+    }
     lines.push("");
     lines.push(`(${args.decisions.length} decisions total \u2014 see decisions.md)`);
   }
@@ -4305,7 +4338,6 @@ function hasErrorCode3(error) {
 }
 
 // src/orientation/orientation-renderer.ts
-var DECISION_TRAILING_ACTIVITY_GAP_MS = 60 * 60 * 1e3;
 async function summarizeOrientation(input) {
   const limit = input.relatedFilesLimit ?? 10;
   const now = new Date(input.nowIso);
@@ -4333,7 +4365,8 @@ async function summarizeOrientation(input) {
           decisions.push({
             decisionId: ev.decision_id,
             title: ev.title,
-            occurredAt: ev.occurred_at
+            occurredAt: ev.occurred_at,
+            sessionId: entry.sessionId
           });
         }
         if (counted && ev.type === "note_added" && ev.kind === "next_step") {
@@ -4386,9 +4419,7 @@ async function summarizeOrientation(input) {
   const liveEntries = entries.filter(
     (e) => e.session.session.status !== "archived" && e.session.session.source.kind !== "import"
   );
-  const latestEntry = [...liveEntries].sort(
-    (a, b) => Date.parse(b.session.session.started_at) - Date.parse(a.session.session.started_at)
-  )[0];
+  const latestEntry = pickLatestSubstantiveEntry(liveEntries);
   const latestSession = latestEntry !== void 0 ? {
     sessionId: latestEntry.sessionId,
     label: latestEntry.session.session.label ?? null,
@@ -4474,21 +4505,25 @@ function formatOrientationBody(summary, opts) {
     lines.push("- \u6700\u7D42 session: (no live sessions)");
   }
   if (summary.latestDecision !== null) {
-    const decAge = relativeAgeJa(summary.latestDecision.occurredAt, now);
-    lines.push(
-      `- \u76F4\u8FD1\u306E\u5224\u65AD: ${summary.latestDecision.title} [${shortId(summary.latestDecision.decisionId)}] (${decAge})`
-    );
+    const dec = summary.latestDecision;
+    const decAge = relativeAgeJa(dec.occurredAt, now);
+    lines.push(`- \u76F4\u8FD1\u306E\u5224\u65AD: ${dec.title} [${shortId(dec.decisionId)}] (${decAge})`);
     const activityAt = summary.freshness.latestActivityAt;
-    if (activityAt !== null && Date.parse(activityAt) - Date.parse(summary.latestDecision.occurredAt) > DECISION_TRAILING_ACTIVITY_GAP_MS) {
+    if (activityAt !== null && isTrailingStale(activityAt, dec.occurredAt)) {
+      lines.push(
+        `  - \u6CE8: \u3053\u308C\u306F\u6700\u5F8C\u306B\u300C\u8A18\u9332\u3055\u308C\u305F\u300D\u5224\u65AD\u3067\u3059\u3002\u6700\u7D42\u6D3B\u52D5 (${relativeAgeJa(activityAt, now)}) \u306F\u3053\u308C\u3088\u308A\u5F8C\u306E\u305F\u3081\u3001\u73FE\u5728\u306E\u65B9\u91DD\u304C\u53CD\u6620\u3055\u308C\u3066\u3044\u306A\u3044\u53EF\u80FD\u6027\u304C\u3042\u308A\u307E\u3059(\u4F1A\u8A71\u3067\u306E\u610F\u601D\u6C7A\u5B9A\u306F\u81EA\u52D5\u8A18\u9332\u3055\u308C\u307E\u305B\u3093\u3002\`basou decision capture\` \u3067\u3053\u306E session \u306E\u5224\u65AD\u3092\u8A18\u9332\u3067\u304D\u307E\u3059)\u3002`
+      );
+    }
+    if (summary.latestSession !== null && dec.sessionId !== summary.latestSession.sessionId) {
       lines.push(
-        `  - \u6CE8: \u3053\u308C\u306F\u6700\u5F8C\u306B\u300C\u8A18\u9332\u3055\u308C\u305F\u300D\u5224\u65AD\u3067\u3059\u3002\u6700\u7D42\u6D3B\u52D5 (${relativeAgeJa(activityAt, now)}) \u306F\u3053\u308C\u3088\u308A\u5F8C\u306E\u305F\u3081\u3001\u73FE\u5728\u306E\u65B9\u91DD\u304C\u53CD\u6620\u3055\u308C\u3066\u3044\u306A\u3044\u53EF\u80FD\u6027\u304C\u3042\u308A\u307E\u3059(\u4F1A\u8A71\u3067\u306E\u610F\u601D\u6C7A\u5B9A\u306F\u81EA\u52D5\u8A18\u9332\u3055\u308C\u307E\u305B\u3093)\u3002`
+        `  - \u6CE8: \u3053\u306E\u5224\u65AD\u306F\u6700\u7D42 session \u3068\u306F\u5225\u306E session [${shortId(dec.sessionId)}] \u306E\u3082\u306E\u3067\u3059\u3002`
       );
     }
     if (summary.decisionCount > 1) {
       lines.push(`  - ${summary.decisionCount} decisions total \u2014 see decisions.md`);
     }
   } else {
-    lines.push("- \u76F4\u8FD1\u306E\u5224\u65AD: (no decisions recorded yet)");
+    lines.push("- \u76F4\u8FD1\u306E\u5224\u65AD: (no decisions recorded yet; capture with `basou decision capture`)");
   }
   if (summary.relatedFiles.displayed.length > 0) {
     const shown = summary.relatedFiles.displayed.join(", ");
@@ -4539,7 +4574,7 @@ function formatOrientationBody(summary, opts) {
       `- \u6B21\u306E\u8D77\u70B9 (\u8A18\u9332\u6E08\u307F, ${noteAge}): ${noteSummary(summary.latestNote.body)} [session ${shortId(summary.latestNote.sessionId)}]`
     );
     const activityAt = summary.freshness.latestActivityAt;
-    if (activityAt !== null && Date.parse(activityAt) - Date.parse(summary.latestNote.occurredAt) > DECISION_TRAILING_ACTIVITY_GAP_MS) {
+    if (activityAt !== null && isTrailingStale(activityAt, summary.latestNote.occurredAt)) {
       lines.push(
         `  - \u6CE8: \u3053\u306E\u8D77\u70B9\u306E\u8A18\u9332\u5F8C (\u6700\u7D42\u6D3B\u52D5 ${relativeAgeJa(activityAt, now)}) \u3082\u4F5C\u696D\u304C\u7D9A\u3044\u3066\u3044\u307E\u3059\u3002\u518D\u958B\u70B9\u304C\u53E4\u3044\u53EF\u80FD\u6027\u304C\u3042\u308A\u307E\u3059\u3002`
       );
@@ -4549,9 +4584,17 @@ function formatOrientationBody(summary, opts) {
     lines.push(`- ${t.title} [${shortId(t.id)}]`);
   }
   if (summary.latestNote === null && summary.plannedTasks.length === 0) {
-    lines.push("- (no planned tasks \u2014 direction is inferred from recent decisions)");
-    if (summary.latestDecision !== null) {
-      lines.push(`  - \u76F4\u8FD1\u306E\u5224\u65AD: ${summary.latestDecision.title}`);
+    const dec = summary.latestDecision;
+    if (dec === null) {
+      lines.push("- (no planned tasks or recorded next step yet)");
+    } else if (isTrailingStale(summary.freshness.latestActivityAt, dec.occurredAt)) {
+      lines.push(
+        "- (no planned tasks or recorded next step \u2014 \u6700\u7D42\u6D3B\u52D5\u306F\u76F4\u8FD1\u306E\u5224\u65AD\u3088\u308A\u5F8C\u3067\u3059\u3002\u7D99\u7D9A\u70B9\u3092\u30E6\u30FC\u30B6\u306B\u78BA\u8A8D\u3057\u3066\u304F\u3060\u3055\u3044)"
+      );
+      lines.push(`  - \u53C2\u8003 (\u53E4\u3044\u53EF\u80FD\u6027\u30FB\u65B9\u91DD\u3067\u306F\u306A\u3044): ${dec.title}`);
+    } else {
+      lines.push("- (no planned tasks \u2014 direction is inferred from recent decisions)");
+      lines.push(`  - \u76F4\u8FD1\u306E\u5224\u65AD: ${dec.title}`);
     }
   }
   lines.push("");