sphica 0.6.4 → 0.6.5

package/.claude-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "$schema": "https://anthropic.com/claude-code/plugin.schema.json",
   "name": "sphica",
-  "version": "0.6.4",
+  "version": "0.6.5",
   "description": "Records Claude Code and Codex sessions on your machine and keeps past implementation and decisions, with their sources, for your agent to find.",
   "author": {
     "name": "iroha924",

package/.codex-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "sphica",
-  "version": "0.6.4",
+  "version": "0.6.5",
   "description": "Records Claude Code and Codex sessions on your machine and keeps past implementation and decisions, with their sources, for your agent to find.",
   "author": {
     "name": "iroha924",

package/db/migrations/0002.sql

@@ -1,4 +1,4 @@
--- Revision 1 → 2 of generation 2: the owner can forget chosen sources (issue #187).
+-- Revision 1 → 2 of generation 2: the owner can forget chosen sources.
 -- `sphica init` runs this in one transaction with foreign keys off (set outside the transaction), then checks foreign_key_check before
 -- committing. Every statement matches db/schema.sql at revision 2; server/test/migrate.test.ts compares a migrated database with a fresh one.
 

package/db/migrations/0003.sql

@@ -1,4 +1,4 @@
--- Revision 2 → 3 of generation 2: a rejected option can carry a reconsider condition the owner stated, quoted as `reconsiders` evidence (issue #193).
+-- Revision 2 → 3 of generation 2: a rejected option can carry a reconsider condition the owner stated, quoted as `reconsiders` evidence.
 -- `sphica init` runs this in one transaction with foreign keys off (set outside the transaction), then checks foreign_key_check before
 -- committing. Every statement matches db/schema.sql at revision 3; server/test/migrate.test.ts compares a migrated database with a fresh one.
 

package/db/schema.sql

@@ -1,5 +1,5 @@
 -- The source of truth for Sphica's database (SQLite, `node:sqlite`): the memory of past implementation and decisions for one owner on one machine.
--- Generation 2 (the 0.5.0 rebuild). `sphica_generation` holds the generation; `pragma user_version` is the revision within it.
+-- Generation 2. `sphica_generation` holds the generation; `pragma user_version` is the revision within it.
 -- A database of another generation is refused without being changed.
 --
 -- Four boundaries:

package/dist/deliver.js

@@ -31689,10 +31689,28 @@ function localChange(root, args) {
   return { base, files, digest: sha256(read.join("\x00")).toString("hex") };
 }
 
+// server/src/trace.ts
+var PENDING_DAYS = 30;
+var pendingCutoff = (now) => new Date(now.getTime() - PENDING_DAYS * 86400000).toISOString();
+var untracedOwner = (eb) => eb.selectFrom("source as m").whereRef("m.session_id", "=", "s.id").where("m.author_kind", "=", "owner").where(({ not, exists, selectFrom }) => not(exists(selectFrom("source_processing as p").whereRef("p.source_id", "=", "m.id").select(sql`1`.as("x")))));
+var untracedSessions = (db, projectId2) => db.selectFrom("session as s").where("s.project_id", "=", projectId2).where((eb) => eb.exists(untracedOwner(eb).select(sql`1`.as("x")))).select((eb) => [
+  "s.id",
+  "s.host",
+  "s.started_at",
+  "s.branch",
+  eb.selectFrom("source as o").whereRef("o.session_id", "=", "s.id").where("o.author_kind", "=", "owner").select((o) => o.fn.max("o.created_at").as("last")).as("last"),
+  untracedOwner(eb).select((m) => m.fn.countAll().as("waiting")).as("waiting"),
+  untracedOwner(eb).select((m) => m.fn.min("m.id").as("first")).as("first")
+]);
+
 // server/src/status.ts
-async function pendingCount(db, projectId2) {
-  const r = await db.selectFrom("session as s").where("s.project_id", "=", projectId2).where((eb) => eb.exists(eb.selectFrom("source as m").whereRef("m.session_id", "=", "s.id").where("m.author_kind", "=", "owner").where((eb2) => eb2.not(eb2.exists(eb2.selectFrom("source_processing as p").whereRef("p.source_id", "=", "m.id").select(sql`1`.as("x"))))).select(sql`1`.as("x")))).select((eb) => eb.fn.countAll().as("n")).executeTakeFirst();
-  return Number(r?.n ?? 0);
+async function pendingCount(db, projectId2, now = new Date) {
+  const cutoff = pendingCutoff(now);
+  const r = await db.selectFrom(untracedSessions(db, projectId2).as("w")).select([
+    sql`count(case when w.last >= ${cutoff} then 1 end)`.as("recent"),
+    sql`count(case when w.last < ${cutoff} then 1 end)`.as("older")
+  ]).executeTakeFirst();
+  return { recent: Number(r?.recent ?? 0), older: Number(r?.older ?? 0) };
 }
 
 // server/src/deliver.ts
@@ -31887,7 +31905,7 @@ async function onPrompt(db, projectId2, prompt) {
 async function waiting(db, projectId2, place) {
   if (!place.owner)
     return "";
-  const n = await pendingCount(db, projectId2);
+  const n = (await pendingCount(db, projectId2)).recent;
   if (!n)
     return "";
   const day = new Date().toLocaleDateString("sv-SE");

package/dist/mcp-record.js

@@ -48172,15 +48172,26 @@ ${c.errors.map((e) => `  ${e}`).join(`
 }
 
 // server/src/trace.ts
-async function pendingSessions(db, projectId2, limit = 20) {
-  return db.selectFrom("session as s").innerJoin("source as m", "m.session_id", "s.id").where("s.project_id", "=", projectId2).where("m.author_kind", "=", "owner").where((eb) => eb.not(eb.exists(eb.selectFrom("source_processing as p").whereRef("p.source_id", "=", "m.id").select(sql`1`.as("x"))))).groupBy("s.id").select((eb) => [
-    "s.id",
-    "s.host",
-    "s.started_at",
-    "s.branch",
-    eb.fn.countAll().as("waiting"),
-    eb.fn.min("m.id").as("first")
-  ]).orderBy("s.started_at", "desc").limit(limit).execute();
+var PENDING_DAYS = 30;
+var pendingCutoff = (now) => new Date(now.getTime() - PENDING_DAYS * 86400000).toISOString();
+var untracedOwner = (eb) => eb.selectFrom("source as m").whereRef("m.session_id", "=", "s.id").where("m.author_kind", "=", "owner").where(({ not, exists, selectFrom }) => not(exists(selectFrom("source_processing as p").whereRef("p.source_id", "=", "m.id").select(sql`1`.as("x")))));
+var untracedSessions = (db, projectId2) => db.selectFrom("session as s").where("s.project_id", "=", projectId2).where((eb) => eb.exists(untracedOwner(eb).select(sql`1`.as("x")))).select((eb) => [
+  "s.id",
+  "s.host",
+  "s.started_at",
+  "s.branch",
+  eb.selectFrom("source as o").whereRef("o.session_id", "=", "s.id").where("o.author_kind", "=", "owner").select((o) => o.fn.max("o.created_at").as("last")).as("last"),
+  untracedOwner(eb).select((m) => m.fn.countAll().as("waiting")).as("waiting"),
+  untracedOwner(eb).select((m) => m.fn.min("m.id").as("first")).as("first")
+]);
+async function pendingSessions(db, projectId2, group, now = new Date, limit = 20) {
+  const cutoff = pendingCutoff(now);
+  const base = db.selectFrom(untracedSessions(db, projectId2).as("w")).where("w.last", group === "recent" ? ">=" : "<", cutoff);
+  const [rows, total] = await Promise.all([
+    base.selectAll("w").orderBy("w.last", "desc").limit(limit).execute(),
+    base.select((eb) => eb.fn.countAll().as("n")).executeTakeFirst()
+  ]);
+  return { rows, total: Number(total?.n ?? 0) };
 }
 async function openRun(db, v) {
   const r = await db.insertInto("extraction_run").values({
@@ -48219,15 +48230,30 @@ async function liveUnits(db, projectId2, limit = 40) {
 
 // server/src/extract.ts
 var newRunId = () => crypto2.randomBytes(9).toString("base64url");
-async function pendingText(db, projectId2) {
+async function pendingText(db, projectId2, now = new Date) {
   await flush(undefined, TOOL_FLUSH_BUDGET_MS).catch(() => {});
-  const rows = await pendingSessions(db, projectId2);
-  if (!rows.length)
+  const [recent, older] = await Promise.all([
+    pendingSessions(db, projectId2, "recent", now),
+    pendingSessions(db, projectId2, "older", now)
+  ]);
+  if (!recent.total && !older.total)
     return "Every captured session has been traced.";
-  const firsts = new Map((await db.selectFrom("source").select(["id", "text"]).where("id", "in", rows.map((r) => Number(r.first))).execute()).map((m) => [m.id, m.text]));
+  const ids = [...recent.rows, ...older.rows].map((r) => Number(r.first));
+  const firsts = new Map(ids.length ? (await db.selectFrom("source").select(["id", "text"]).where("id", "in", ids).execute()).map((m) => [
+    m.id,
+    m.text
+  ]) : []);
+  const group = (g) => [
+    ...g.rows.map((r) => `- ${r.id} ${r.host} ${r.started_at}: ${plural2(Number(r.waiting), "message")} waiting, starting "${inline(firsts.get(Number(r.first)) ?? "").slice(0, 100)}"`),
+    ...g.total > g.rows.length ? [`- and ${g.total - g.rows.length} more`] : []
+  ];
   return [
-    `${plural2(rows.length, "session")} to trace (pass the id to trace_begin):`,
-    ...rows.map((r) => `- ${r.id} ${r.host} ${r.started_at}: ${plural2(Number(r.waiting), "message")} waiting, starting "${inline(firsts.get(Number(r.first)) ?? "").slice(0, 100)}"`)
+    recent.total ? `${plural2(recent.total, "session")} to trace (pass the id to trace_begin):` : "No recent session waits to be traced.",
+    ...group(recent),
+    ...older.total ? [
+      `Older than ${PENDING_DAYS} days (not counted at session start), ${plural2(older.total, "session")}; trace_begin takes these ids too:`,
+      ...group(older)
+    ] : []
   ].join(`
 `);
 }
@@ -48637,7 +48663,7 @@ var READ = { readOnlyHint: true, destructiveHint: false, idempotentHint: true, o
 var RECORD = exports_external.record(exports_external.string(), exports_external.unknown()).describe("The record, as the Skill describes");
 server.registerTool("trace_pending", {
   title: "Sessions not traced yet",
-  description: "Lists this project's captured sessions with owner messages no trace has looked at.",
+  description: "Lists this project's captured sessions with owner messages no trace has looked at, then apart those whose last owner message is over 30 days old.",
   inputSchema: { cwd: CWD },
   annotations: READ
 }, async (a, extra) => tool(async () => pendingText(conn(), (await projectOf(a.cwd, extra._meta)).projectId)));

package/dist/mcp.js

@@ -46932,19 +46932,37 @@ async function checkFindings(db, projectId2, files, raw) {
   return problems;
 }
 
+// server/src/trace.ts
+var PENDING_DAYS = 30;
+var pendingCutoff = (now) => new Date(now.getTime() - PENDING_DAYS * 86400000).toISOString();
+var untracedOwner = (eb) => eb.selectFrom("source as m").whereRef("m.session_id", "=", "s.id").where("m.author_kind", "=", "owner").where(({ not, exists, selectFrom }) => not(exists(selectFrom("source_processing as p").whereRef("p.source_id", "=", "m.id").select(sql`1`.as("x")))));
+var untracedSessions = (db, projectId2) => db.selectFrom("session as s").where("s.project_id", "=", projectId2).where((eb) => eb.exists(untracedOwner(eb).select(sql`1`.as("x")))).select((eb) => [
+  "s.id",
+  "s.host",
+  "s.started_at",
+  "s.branch",
+  eb.selectFrom("source as o").whereRef("o.session_id", "=", "s.id").where("o.author_kind", "=", "owner").select((o) => o.fn.max("o.created_at").as("last")).as("last"),
+  untracedOwner(eb).select((m) => m.fn.countAll().as("waiting")).as("waiting"),
+  untracedOwner(eb).select((m) => m.fn.min("m.id").as("first")).as("first")
+]);
+
 // server/src/status.ts
-async function pendingCount(db, projectId2) {
-  const r = await db.selectFrom("session as s").where("s.project_id", "=", projectId2).where((eb) => eb.exists(eb.selectFrom("source as m").whereRef("m.session_id", "=", "s.id").where("m.author_kind", "=", "owner").where((eb2) => eb2.not(eb2.exists(eb2.selectFrom("source_processing as p").whereRef("p.source_id", "=", "m.id").select(sql`1`.as("x"))))).select(sql`1`.as("x")))).select((eb) => eb.fn.countAll().as("n")).executeTakeFirst();
-  return Number(r?.n ?? 0);
-}
-async function coverage(db, projectId2) {
+async function pendingCount(db, projectId2, now = new Date) {
+  const cutoff = pendingCutoff(now);
+  const r = await db.selectFrom(untracedSessions(db, projectId2).as("w")).select([
+    sql`count(case when w.last >= ${cutoff} then 1 end)`.as("recent"),
+    sql`count(case when w.last < ${cutoff} then 1 end)`.as("older")
+  ]).executeTakeFirst();
+  return { recent: Number(r?.recent ?? 0), older: Number(r?.older ?? 0) };
+}
+async function coverage(db, projectId2, now) {
   const count = async (q) => Number((await q)?.n ?? 0);
   const units = (where) => count(where(unitBase()).select((eb) => eb.fn.countAll().as("n")).executeTakeFirst());
   const unitBase = () => db.selectFrom("unit").where("project_id", "=", projectId2);
   const processed = (outcome) => db.selectFrom("source_processing as p").innerJoin("source as m", "m.id", "p.source_id").where("m.project_id", "=", projectId2).where("p.outcome", "=", outcome).where("m.session_id", "is not", null).select("m.session_id");
-  const [sessions, pendingSessions, emptySessions, sources, active, candidates, quarantined, work] = await Promise.all([
+  const [sessions, pending, emptySessions, sources, active, candidates, quarantined, work] = await Promise.all([
     count(db.selectFrom("session").where("project_id", "=", projectId2).select((eb) => eb.fn.countAll().as("n")).executeTakeFirst()),
-    pendingCount(db, projectId2),
+    pendingCount(db, projectId2, now),
     count(db.selectFrom("session").where("id", "in", processed("no_unit")).where("id", "not in", processed("units")).select((eb) => eb.fn.countAll().as("n")).executeTakeFirst()),
     count(db.selectFrom("source").where("project_id", "=", projectId2).select((eb) => eb.fn.countAll().as("n")).executeTakeFirst()),
     units((q) => q.where("lifecycle", "=", "active")),
@@ -46952,15 +46970,21 @@ async function coverage(db, projectId2) {
     units((q) => q.where("extraction", "=", "quarantined")),
     db.selectFrom("work").where("project_id", "=", projectId2).where("status", "in", ["active", "blocked", "paused"]).orderBy("updated_at", "desc").select(["title", "current", "status"]).limit(5).execute()
   ]);
-  return { sessions, pendingSessions, emptySessions, sources, active, candidates, quarantined, work };
+  return { sessions, pending, emptySessions, sources, active, candidates, quarantined, work };
 }
-async function status(db, projectId2, name) {
-  const c = await coverage(db, projectId2);
+async function status(db, projectId2, name, now = new Date) {
+  const c = await coverage(db, projectId2, now);
   const lines = [
     `${name}`,
     `Captured: ${plural2(c.sessions, "session")}, ${plural2(c.sources, "source")}.`,
     `Extracted: ${plural2(c.active, "active record")}, ${plural2(c.candidates, "candidate")} not active yet (waiting for adoption or evidence), ${plural2(c.quarantined, "quarantined record")}.`,
-    c.pendingSessions ? `${plural2(c.pendingSessions, "session")} not traced yet: their decisions exist only as captured text (run /sphica:trace pending).` : "Every captured session has been traced.",
+    ...c.pending.recent ? [
+      `${plural2(c.pending.recent, "session")} not traced yet: their decisions exist only as captured text (run /sphica:trace pending).`
+    ] : [],
+    ...c.pending.older ? [
+      `${c.pending.older} older ${c.pending.older === 1 ? "session" : "sessions"} (last owner message over ${PENDING_DAYS} days ago) not traced; /sphica:trace pending lists them.`
+    ] : [],
+    ...c.pending.recent || c.pending.older ? [] : ["Every captured session has been traced."],
     ...c.emptySessions ? [`${plural2(c.emptySessions, "session")} traced with nothing to record.`] : [],
     c.work.length ? `Work in progress:
 ${framed(c.work.map((w) => `- ${head(inline(w.title), 200)} (${w.status}): ${head(inline(w.current), 500)}`).join(`

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "sphica",
-  "version": "0.6.4",
+  "version": "0.6.5",
   "description": "Records Claude Code and Codex sessions on your machine and keeps past implementation and decisions, with their sources, for your agent to find.",
   "license": "MIT",
   "type": "module",

package/skills/forget/SKILL.md

@@ -3,7 +3,7 @@ name: forget
 description: Removes sources the owner chooses from Sphica (a message, a pull request item, a file excerpt), with their search index entries and the bytes left in the database file, and judges the records that cited them again. The owner confirms in a dialog before anything is removed. Use only when the user explicitly asks to forget or delete something Sphica captured.
 argument-hint: "<what to forget>"
 disable-model-invocation: true
-allowed-tools: AskUserQuestion, mcp__plugin_sphica_sphica__search, mcp__plugin_sphica_sphica__read, mcp__plugin_sphica_record__forget_preview, mcp__plugin_sphica_record__forget_apply
+allowed-tools: AskUserQuestion, mcp__plugin_sphica_sphica__search, mcp__plugin_sphica_sphica__read, mcp__plugin_sphica_record__forget_preview, mcp__plugin_sphica_record__forget_apply, mcp__plugin_sphica_sphica__status
 ---
 
 # forget — remove what should not have been kept

package/skills/glean/SKILL.md

@@ -3,7 +3,7 @@ name: glean
 description: Adds evidence and corrections to existing Sphica records, or keeps something the owner remembers, only from sources the owner points to (an issue or pull request, a file in the repository, the owner's own words now). Asks the owner for the source before saving anything. Use only when the user explicitly asks.
 argument-hint: "<what to add or correct>"
 disable-model-invocation: true
-allowed-tools: AskUserQuestion, mcp__plugin_sphica_record__glean_begin, mcp__plugin_sphica_record__glean_fetch, mcp__plugin_sphica_record__record_context, mcp__plugin_sphica_record__record_check, mcp__plugin_sphica_record__record_save, mcp__plugin_sphica_sphica__search, mcp__plugin_sphica_sphica__read
+allowed-tools: AskUserQuestion, mcp__plugin_sphica_record__glean_begin, mcp__plugin_sphica_record__glean_fetch, mcp__plugin_sphica_record__record_context, mcp__plugin_sphica_record__record_check, mcp__plugin_sphica_record__record_save, mcp__plugin_sphica_sphica__search, mcp__plugin_sphica_sphica__read, mcp__plugin_sphica_sphica__status
 ---
 
 # glean — add what was found later, with its source

package/skills/harvest/SKILL.md

@@ -3,7 +3,7 @@ name: harvest
 description: Reads one GitHub pull request of the current repository (its body, comments, reviews, review comments, commits, the merge, and the issues it closes), keeps them as sources, and extracts what it decided and implemented into records that quote them, in the same form as trace. Pass the PR number. Use only when the user explicitly asks.
 argument-hint: "<PR number>"
 disable-model-invocation: true
-allowed-tools: mcp__plugin_sphica_record__harvest_begin, mcp__plugin_sphica_record__record_context, mcp__plugin_sphica_record__record_check, mcp__plugin_sphica_record__record_save, mcp__plugin_sphica_sphica__search, mcp__plugin_sphica_sphica__read
+allowed-tools: mcp__plugin_sphica_record__harvest_begin, mcp__plugin_sphica_record__record_context, mcp__plugin_sphica_record__record_check, mcp__plugin_sphica_record__record_save, mcp__plugin_sphica_sphica__search, mcp__plugin_sphica_sphica__read, mcp__plugin_sphica_sphica__status
 ---
 
 # harvest — keep what a pull request decided and implemented

package/skills/review/SKILL.md

@@ -1,6 +1,7 @@
 ---
 name: review
 description: Reviews changes. Use it to review your own committed and uncommitted diff, to review someone else's PR, and to sweep for misses before a merge or release. It starts independent reviewers per aspect, and when Codex is available it runs the same aspects on the other model too, to catch defects only one model can see. Findings are ruled on by reproduction before they are returned. It does not handle formatting or naming inconsistencies, design preferences, or future extensibility.
+allowed-tools: mcp__plugin_sphica_sphica__status, mcp__plugin_sphica_sphica__search, mcp__plugin_sphica_sphica__read, mcp__plugin_sphica_sphica__review_select, mcp__plugin_sphica_sphica__review_check
 ---
 
 # review — sweep changes with independent reviewers

package/skills/rules/SKILL.md

@@ -3,7 +3,7 @@ name: rules
 description: Drafts lines for CLAUDE.md, AGENTS.md, or .claude/rules from recorded constraints and decisions the owner picks, each line ending with a marker holding its record key, so Sphica's overview (view look) can flag the line once the record is replaced or withdrawn. It prints the draft and never edits a file. Use only when the user explicitly asks for rule text from Sphica's records.
 argument-hint: "<which constraints, or empty to choose from the list>"
 disable-model-invocation: true
-allowed-tools: mcp__plugin_sphica_sphica__overview, mcp__plugin_sphica_sphica__search, mcp__plugin_sphica_sphica__read
+allowed-tools: mcp__plugin_sphica_sphica__overview, mcp__plugin_sphica_sphica__search, mcp__plugin_sphica_sphica__read, mcp__plugin_sphica_sphica__status
 ---
 
 # rules — draft instruction lines from recorded constraints

package/skills/trace/SKILL.md

@@ -3,7 +3,7 @@ name: trace
 description: Extracts what a coding session decided and implemented (decisions and rejected options, constraints, implementations, findings, dead ends, open questions) into records whose every claim quotes the captured conversation, so a later session can find them. With "pending", lists this project's sessions not traced yet. Use only when the user explicitly asks.
 argument-hint: "[pending]"
 disable-model-invocation: true
-allowed-tools: mcp__plugin_sphica_record__trace_pending, mcp__plugin_sphica_record__trace_begin, mcp__plugin_sphica_record__record_context, mcp__plugin_sphica_record__record_check, mcp__plugin_sphica_record__record_save, mcp__plugin_sphica_sphica__search, mcp__plugin_sphica_sphica__read
+allowed-tools: AskUserQuestion, mcp__plugin_sphica_record__trace_pending, mcp__plugin_sphica_record__trace_begin, mcp__plugin_sphica_record__record_context, mcp__plugin_sphica_record__record_check, mcp__plugin_sphica_record__record_save, mcp__plugin_sphica_sphica__search, mcp__plugin_sphica_sphica__read, mcp__plugin_sphica_sphica__status
 ---
 
 # trace — keep what a session decided and implemented
@@ -30,7 +30,8 @@ Everything goes through Sphica's `record` MCP server (its tools are `trace_pendi
 
 1. **Pick the session.** Without a target, it is this session: its id is `${CLAUDE_SESSION_ID}` in Claude Code; in Codex, read `CODEX_THREAD_ID`
    from your shell environment. With `pending`, call `trace_pending`, show the owner the list, and ask which to trace (AskUserQuestion in
-   Claude Code). Trace one session at a time
+   Claude Code). Sessions whose last owner message is over 30 days old come last under their own heading: session start does not count
+   them, but they can still be traced. Trace one session at a time
 2. **Begin**: `trace_begin` with that `session`. It returns a `run` id bound to that session and this project; the record never names them
 3. **Read**: `record_context` with the run. It prints each captured message as `## s<N> owner|assistant <turn> <time>` followed by its text,
    the edits observed, and the project's live records. `(traced before)` marks messages an earlier trace already looked at.