@basou/core 0.21.0 → 0.23.0

package/dist/index.d.ts

@@ -3401,6 +3401,31 @@ type NoteRecord = {
     occurredAt: string;
     host: string | null;
 };
+/**
+ * One recent session condensed to its direction signal, for the "最近の流れ"
+ * (recent direction) section. Across the last N non-archived sessions
+ * (newest first), this surfaces the ARC of recent intent — the decision titles
+ * and next-step notes recorded in EACH session — rather than orientation's
+ * single latest decision/note, which can be stale or missing. When a session
+ * recorded neither a decision nor a note, its top changed files stand in as the
+ * activity signal, so the trajectory stays visible even when explicit capture
+ * was missed (the read-side safety net for the intent-leak gap).
+ */
+type RecentSessionDigest = {
+    sessionId: string;
+    label: string | null;
+    /** Session boundary (ended_at ?? started_at); the basis for its relative age. */
+    occurredAt: string;
+    host: string | null;
+    /** Non-voided decision titles recorded in this session, chronological, capped. */
+    decisions: string[];
+    /** Count of this session's non-voided decisions beyond those in `decisions`. */
+    decisionsOverflow: number;
+    /** next_step note bodies recorded in this session, chronological, capped. */
+    notes: string[];
+    /** Top changed files, populated ONLY when the session has no decision and no note. */
+    files: string[];
+};
 type PendingApproval = {
     id: string;
     risk: string;
@@ -3474,6 +3499,15 @@ type OrientationSummary = {
      * step / handoff ("次の起点") surfaced in the forward section; null when none.
      */
     latestNote: NoteRecord | null;
+    /**
+     * The last N non-archived sessions (newest first) condensed to their direction
+     * signal — the "最近の流れ" (recent direction) arc. Distinct from the single
+     * latest decision/note: it shows the trajectory of intent across recent
+     * sessions, and falls back to each session's changed files when no decision or
+     * note was captured, so a resuming agent has grounding even when explicit
+     * capture was missed. Empty when no non-archived sessions exist.
+     */
+    recentDirection: RecentSessionDigest[];
     /**
      * related_files of the latest session, deduped + sorted + capped at the
      * display limit. `outOfRoot` lists the entries (over the FULL deduped set,

package/dist/index.js

@@ -4646,6 +4646,16 @@ async function summarizeOrientation(input) {
   const decisions = [];
   const tracks = [];
   const voidedDecisionIds = /* @__PURE__ */ new Set();
+  const perSession = /* @__PURE__ */ new Map();
+  const recordDirection = (sessionId, kind, value) => {
+    let bucket = perSession.get(sessionId);
+    if (bucket === void 0) {
+      bucket = { decisions: [], notes: [] };
+      perSession.set(sessionId, bucket);
+    }
+    if (kind === "decision" && typeof value !== "string") bucket.decisions.push(value);
+    else if (kind === "note" && typeof value === "string") bucket.notes.push(value);
+  };
   let latestActivityAt = null;
   let latestNote = null;
   const noteActivity = (iso) => {
@@ -4669,6 +4679,12 @@ async function summarizeOrientation(input) {
             sessionId: entry.sessionId,
             host: entry.host
           });
+          if (counted) {
+            recordDirection(entry.sessionId, "decision", {
+              decisionId: ev.decision_id,
+              title: ev.title
+            });
+          }
           if (ev.kind === "track") {
             tracks.push({
               decisionId: ev.decision_id,
@@ -4683,6 +4699,7 @@ async function summarizeOrientation(input) {
           voidedDecisionIds.add(ev.decision_id);
         }
         if (counted && ev.type === "note_added" && ev.kind === "next_step") {
+          recordDirection(entry.sessionId, "note", ev.body);
           if (latestNote === null || Date.parse(ev.occurred_at) > Date.parse(latestNote.occurredAt)) {
             latestNote = {
               body: ev.body,
@@ -4714,6 +4731,29 @@ async function summarizeOrientation(input) {
     const c = Date.parse(b.occurredAt) - Date.parse(a.occurredAt);
     return c !== 0 ? c : b.decisionId.localeCompare(a.decisionId);
   });
+  const recentDirection = entries.filter((e) => e.session.session.status !== "archived").map((e) => ({
+    entry: e,
+    boundary: e.session.session.ended_at ?? e.session.session.started_at
+  })).sort((a, b) => {
+    const c = Date.parse(b.boundary) - Date.parse(a.boundary);
+    return c !== 0 ? c : b.entry.sessionId.localeCompare(a.entry.sessionId);
+  }).slice(0, RECENT_DIRECTION_SESSIONS).map(({ entry, boundary }) => {
+    const bucket = perSession.get(entry.sessionId);
+    const decisionTitles = (bucket?.decisions ?? []).filter((d) => !voidedDecisionIds.has(d.decisionId)).map((d) => d.title);
+    const notes = bucket?.notes ?? [];
+    const hasIntent = decisionTitles.length > 0 || notes.length > 0;
+    const files = hasIntent ? [] : [...new Set(entry.session.session.related_files ?? [])].sort().slice(0, FILES_PER_DIGEST);
+    return {
+      sessionId: entry.sessionId,
+      label: entry.session.session.label ?? null,
+      occurredAt: boundary,
+      host: entry.host,
+      decisions: decisionTitles.slice(0, DECISIONS_PER_DIGEST),
+      decisionsOverflow: Math.max(0, decisionTitles.length - DECISIONS_PER_DIGEST),
+      notes: notes.slice(0, NOTES_PER_DIGEST),
+      files
+    };
+  });
   const taskLoadOpts = {};
   if (input.onTaskSkip !== void 0) taskLoadOpts.onSkip = input.onTaskSkip;
   const taskEntries = await loadTaskEntries(input.paths, taskLoadOpts);
@@ -4804,6 +4844,7 @@ async function summarizeOrientation(input) {
     decisionCount: decisions.length,
     openTracks,
     latestNote,
+    recentDirection,
     relatedFiles: { displayed, overflow, outOfRoot },
     inFlightTasks,
     plannedTasks,
@@ -4906,6 +4947,29 @@ function formatOrientationBody(summary, opts) {
     lines.push("- \u76F4\u8FD1\u306E\u5909\u66F4\u30D5\u30A1\u30A4\u30EB: (none recorded)");
   }
   lines.push("");
+  lines.push(`## \u6700\u8FD1\u306E\u6D41\u308C (\u76F4\u8FD1 ${RECENT_DIRECTION_SESSIONS} session)`);
+  lines.push("");
+  if (summary.recentDirection.length === 0) {
+    lines.push("- (\u307E\u3060\u8A18\u9332\u304C\u3042\u308A\u307E\u305B\u3093)");
+  } else {
+    for (const s of summary.recentDirection) {
+      const sid = shortId(s.sessionId);
+      const age = relativeAgeJa(s.occurredAt, now);
+      const head = s.label !== null && s.label !== "" ? s.label : sid;
+      lines.push(`- ${head} (${age})${hostSuffix(s.host)}`);
+      if (s.decisions.length > 0) {
+        const more = s.decisionsOverflow > 0 ? ` (+${s.decisionsOverflow})` : "";
+        lines.push(`  - \u5224\u65AD: ${s.decisions.map(noteSummary).join("; ")}${more}`);
+      }
+      for (const note of s.notes) {
+        lines.push(`  - \u6B21\u306E\u8D77\u70B9: ${noteSummary(note)}`);
+      }
+      if (s.files.length > 0) {
+        lines.push(`  - \u5909\u66F4: ${s.files.join(", ")}`);
+      }
+    }
+  }
+  lines.push("");
   lines.push("## \u4F55\u304C\u52D5\u304F");
   lines.push("");
   lines.push(`### \u9032\u884C\u4E2D task (${summary.inFlightTasks.length})`);
@@ -5064,7 +5128,7 @@ function stalenessBanner(staleness) {
     if (staleness.newSessions > 0) parts.push(`\u65B0\u898F ${staleness.newSessions} \u4EF6`);
     if (staleness.updatedSessions > 0) parts.push(`\u66F4\u65B0 ${staleness.updatedSessions} \u4EF6`);
     return [
-      `> \u26A0\uFE0F **\u53E4\u3044\u304B\u3082\u3057\u308C\u307E\u305B\u3093** \u2014 \u672A\u53D6\u308A\u8FBC\u307F\u306E\u4F5C\u696D\u304C\u3042\u308A\u307E\u3059(${parts.join("\u30FB")})\u3002\u7740\u624B\u524D\u306B \`basou refresh\` \u3067\u66F4\u65B0\u3057\u3066\u304F\u3060\u3055\u3044(\u8A73\u7D30\u306F\u672B\u5C3E\u300C\u3053\u308C\u306F\u6700\u65B0\u304B\u300D)\u3002`
+      `> \u26A0\uFE0F **\u53E4\u3044\u3067\u3059\uFF08\u672A\u53D6\u308A\u8FBC\u307F ${parts.join("\u30FB")}\uFF09** \u2014 \u7740\u624B\u524D\u306B\u5FC5\u305A \`basou refresh\` \u3092\u5B9F\u884C\u3057\u3066\u304F\u3060\u3055\u3044(\u8A73\u7D30\u306F\u672B\u5C3E\u300C\u3053\u308C\u306F\u6700\u65B0\u304B\u300D)\u3002`
     ];
   }
   return [];
@@ -5081,8 +5145,8 @@ function freshnessVerdict(summary, staleness, now) {
     if (staleness.newSessions > 0) parts.push(`\u65B0\u898F ${staleness.newSessions} \u4EF6`);
     if (staleness.updatedSessions > 0) parts.push(`\u66F4\u65B0 ${staleness.updatedSessions} \u4EF6`);
     return [
-      `\u26A0\uFE0F \u53E4\u3044\u304B\u3082\u3057\u308C\u307E\u305B\u3093\u3002\u6700\u5F8C\u306E\u53D6\u308A\u8FBC\u307F\u4EE5\u964D\u306B\u672A\u53D6\u308A\u8FBC\u307F\u306E\u4F5C\u696D\u304C\u3042\u308A\u307E\u3059(${parts.join("\u30FB")})\u3002`,
-      "`basou refresh` \u3067\u66F4\u65B0\u3057\u3066\u304F\u3060\u3055\u3044\u3002"
+      `\u26A0\uFE0F \u53E4\u3044\u3067\u3059\u3002\u6700\u5F8C\u306E\u53D6\u308A\u8FBC\u307F\u4EE5\u964D\u306B\u672A\u53D6\u308A\u8FBC\u307F\u306E\u4F5C\u696D\u304C\u3042\u308A\u307E\u3059(${parts.join("\u30FB")})\u3002`,
+      "\u7740\u624B\u524D\u306B\u5FC5\u305A `basou refresh` \u3092\u5B9F\u884C\u3057\u3066\u304F\u3060\u3055\u3044\u3002"
     ];
   }
   if (summary.freshness.newestStartedAt === null) {
@@ -5133,6 +5197,10 @@ function relativeAge(startedAt, now) {
   if (ms < 1e3) return "just now";
   return `${formatDurationMs(ms)} ago`;
 }
+var RECENT_DIRECTION_SESSIONS = 5;
+var DECISIONS_PER_DIGEST = 3;
+var NOTES_PER_DIGEST = 2;
+var FILES_PER_DIGEST = 3;
 var NOTE_SUMMARY_MAX = 200;
 function noteSummary(body) {
   const oneLine = body.replace(/\s+/g, " ").trim();