@basou/core 0.20.0 → 0.22.0

package/dist/index.d.ts

@@ -570,10 +570,14 @@ type ClaudeTranscriptToPayloadOptions = {
  * - `command_executed` from each `Bash` tool use, recorded as `bash -c "<cmd>"`
  *   (the transcript carries the shell line, not a parsed argv).
  * - `file_changed` from each `Edit` / `Write` / `NotebookEdit` tool use.
- * - `decision_recorded` from each `AskUserQuestion` tool use: one decision per
- *   question, titled `<question> -> <chosen answer>`. The chosen answer is read
- *   from the paired result record's structured `toolUseResult.answers` map; a
- *   question with no recorded string answer is skipped.
+ * - `decision_recorded` from each `AskUserQuestion` tool use, but ONLY when the
+ *   recorded answer is a confirmed SELECTION — it exactly matches an option the
+ *   question offered (`input.questions[].options[].label`). One decision per
+ *   such question, titled `<question> -> <chosen answer>`. The answer is read
+ *   from the paired result record's `toolUseResult.answers` map; a question with
+ *   no recorded answer, or a free-text "Other" reply that matches no offered
+ *   label, is skipped (it is not a decision, and would otherwise pollute
+ *   decisions.md / orientation's latest-decision surface).
  *
  * Exit codes and per-command durations are not present in the transcript, so
  * `command_executed.exit_code` is `null` and `duration_ms` is `0`.
@@ -3397,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;
@@ -3470,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

@@ -246,11 +246,16 @@ function claudeTranscriptToImportPayload(records, options) {
         const useId = readString2(item.id);
         const answers = useId !== void 0 ? askAnswers.get(useId) : void 0;
         if (answers !== void 0) {
+          const offeredByQuestion = readOfferedOptions(input);
           for (const [question, answer] of Object.entries(answers)) {
             if (question.length === 0) continue;
             const answerStr = typeof answer === "string" && answer.length > 0 ? answer : void 0;
-            const title = answerStr !== void 0 ? `${question} -> ${answerStr}` : question;
-            derived.push(decisionRecordedEvent(ts, placeholderSessionId, title));
+            if (answerStr === void 0) continue;
+            const offered = offeredByQuestion.get(question);
+            if (offered === void 0 || !offered.has(answerStr.trim())) continue;
+            derived.push(
+              decisionRecordedEvent(ts, placeholderSessionId, `${question} -> ${answerStr}`)
+            );
           }
         }
         continue;
@@ -410,6 +415,24 @@ function indexAskAnswers(records) {
   }
   return byId;
 }
+function readOfferedOptions(input) {
+  const byQuestion = /* @__PURE__ */ new Map();
+  const questions = Array.isArray(input.questions) ? input.questions : [];
+  for (const q of questions) {
+    if (!isObject2(q)) continue;
+    const text = readString2(q.question);
+    if (text === void 0) continue;
+    const labels = /* @__PURE__ */ new Set();
+    const options = Array.isArray(q.options) ? q.options : [];
+    for (const o of options) {
+      if (!isObject2(o)) continue;
+      const label = readString2(o.label);
+      if (label !== void 0) labels.add(label.trim());
+    }
+    byQuestion.set(text, labels);
+  }
+  return byQuestion;
+}
 
 // src/adapters/codex/rollout-importer.ts
 var CODEX_IMPORT_SOURCE = "codex-import";
@@ -4623,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) => {
@@ -4646,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,
@@ -4660,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,
@@ -4691,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);
@@ -4781,6 +4844,7 @@ async function summarizeOrientation(input) {
     decisionCount: decisions.length,
     openTracks,
     latestNote,
+    recentDirection,
     relatedFiles: { displayed, overflow, outOfRoot },
     inFlightTasks,
     plannedTasks,
@@ -4825,6 +4889,11 @@ function formatOrientationBody(summary, opts) {
     lines.push(`> hosts: local, ${summary.hosts.join(", ")}`);
   }
   lines.push("");
+  const banner = stalenessBanner(opts.staleness);
+  if (banner.length > 0) {
+    for (const line of banner) lines.push(line);
+    lines.push("");
+  }
   lines.push("## \u4ECA\u3069\u3053\u306B\u3044\u308B");
   lines.push("");
   if (summary.latestSession !== null) {
@@ -4878,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})`);
@@ -5024,6 +5116,23 @@ function toolDisplayName(kind) {
       return kind ?? "\u4E0D\u660E";
   }
 }
+function stalenessBanner(staleness) {
+  if (staleness === null) return [];
+  if ((staleness.unverifiableSessions ?? 0) > 0) {
+    return [
+      `> \u26A0\uFE0F **\u6700\u65B0\u3067\u306F\u306A\u3044\u53EF\u80FD\u6027** \u2014 \u5909\u5316\u3057\u305F\u304C\u5B89\u5168\u306B\u53D6\u308A\u8FBC\u3081\u306A\u3044\u30BB\u30C3\u30B7\u30E7\u30F3\u304C ${staleness.unverifiableSessions} \u4EF6\u3042\u308A\u307E\u3059\u3002\u7740\u624B\u524D\u306B \`basou verify\` / \`basou refresh --force\`(\u8A73\u7D30\u306F\u672B\u5C3E\u300C\u3053\u308C\u306F\u6700\u65B0\u304B\u300D)\u3002`
+    ];
+  }
+  if (staleness.newSessions > 0 || staleness.updatedSessions > 0) {
+    const parts = [];
+    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`
+    ];
+  }
+  return [];
+}
 function freshnessVerdict(summary, staleness, now) {
   if (staleness !== null && (staleness.unverifiableSessions ?? 0) > 0) {
     return [
@@ -5088,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();