chapterhouse 0.4.1 → 0.4.3

package/dist/memory/housekeeping.test.js

@@ -45,30 +45,30 @@ test("dedupObservationsPass supersedes similar observations in scope determinist
     const team = getScope("team");
     assert.ok(chapterhouse && team);
     const first = recordObservation({
-        scope_id: chapterhouse.id,
+        scope_id: team.id,
         content: "The worker event stream uses server sent events for live task output.",
         source: "test",
         confidence: 0.4,
     });
     const keeper = recordObservation({
-        scope_id: chapterhouse.id,
+        scope_id: team.id,
         content: "Worker event streams use server sent events for live task output.",
         source: "test",
         confidence: 0.9,
     });
     const third = recordObservation({
-        scope_id: chapterhouse.id,
+        scope_id: team.id,
         content: "The worker event stream uses server sent events for live task output today.",
         source: "test",
         confidence: 0.9,
     });
     const otherScope = recordObservation({
-        scope_id: team.id,
+        scope_id: chapterhouse.id,
         content: "Worker event streams use server sent events for live task output.",
         source: "test",
         confidence: 0.1,
     });
-    const summary = housekeepingModule.dedupObservationsPass(chapterhouse.id);
+    const summary = housekeepingModule.dedupObservationsPass(team.id);
     assert.equal(summary.pass, "dedupObservationsPass");
     assert.equal(summary.examined, 3);
     assert.equal(summary.modified, 2);
@@ -79,7 +79,7 @@ test("dedupObservationsPass supersedes similar observations in scope determinist
         { id: third.id, superseded_by: keeper.id },
     ]);
     assert.equal(db.prepare(`SELECT superseded_by FROM mem_observations WHERE id = ?`).get(otherScope.id).superseded_by, null);
-    const second = housekeepingModule.dedupObservationsPass(chapterhouse.id);
+    const second = housekeepingModule.dedupObservationsPass(team.id);
     assert.equal(second.modified, 0);
 });
 test("dedupDecisionsPass supersedes similar active decisions within scope and keeps the latest decision", async () => {
@@ -88,39 +88,39 @@ test("dedupDecisionsPass supersedes similar active decisions within scope and ke
     const getScope = getFunction(memoryModule, "getScope");
     const upsertEntity = getFunction(memoryModule, "upsertEntity");
     const recordDecision = getFunction(memoryModule, "recordDecision");
-    const chapterhouse = getScope("chapterhouse");
     const team = getScope("team");
-    assert.ok(chapterhouse && team);
-    const api = upsertEntity({ scope_id: chapterhouse.id, kind: "component", name: "api" });
-    const web = upsertEntity({ scope_id: chapterhouse.id, kind: "component", name: "web" });
+    const infra = getScope("infra");
+    assert.ok(team && infra);
+    const api = upsertEntity({ scope_id: team.id, kind: "component", name: "api" });
+    const web = upsertEntity({ scope_id: team.id, kind: "component", name: "web" });
     const oldDecision = recordDecision({
-        scope_id: chapterhouse.id,
+        scope_id: team.id,
         entity_id: api.id,
         title: "Use SQLite FTS5 for memory recall",
         rationale: "Initial choice.",
         decided_at: "2026-05-11",
     });
     const keeper = recordDecision({
-        scope_id: chapterhouse.id,
+        scope_id: team.id,
         entity_id: api.id,
         title: "Use SQLite FTS5 for scoped memory recall",
         rationale: "Latest choice.",
         decided_at: "2026-05-13",
     });
     const otherEntity = recordDecision({
-        scope_id: chapterhouse.id,
+        scope_id: team.id,
         entity_id: web.id,
         title: "Use SQLite FTS5 for memory recall",
         rationale: "Same title, different entity context, but newer scope-level decision.",
         decided_at: "2026-05-14",
     });
     const otherScope = recordDecision({
-        scope_id: team.id,
+        scope_id: infra.id,
         title: "Use SQLite FTS5 for memory recall",
         rationale: "Same title, different scope.",
         decided_at: "2026-05-14",
     });
-    const summary = housekeepingModule.dedupDecisionsPass(chapterhouse.id);
+    const summary = housekeepingModule.dedupDecisionsPass(team.id);
     assert.equal(summary.pass, "dedupDecisionsPass");
     assert.equal(summary.examined, 3);
     assert.equal(summary.modified, 2);
@@ -129,7 +129,7 @@ test("dedupDecisionsPass supersedes similar active decisions within scope and ke
     assert.equal(db.prepare(`SELECT superseded_by FROM mem_decisions WHERE id = ?`).get(keeper.id).superseded_by, otherEntity.id);
     assert.equal(db.prepare(`SELECT superseded_by FROM mem_decisions WHERE id = ?`).get(otherEntity.id).superseded_by, null);
     assert.equal(db.prepare(`SELECT superseded_by FROM mem_decisions WHERE id = ?`).get(otherScope.id).superseded_by, null);
-    const second = housekeepingModule.dedupDecisionsPass(chapterhouse.id);
+    const second = housekeepingModule.dedupDecisionsPass(team.id);
     assert.equal(second.modified, 0);
 });
 test("orphanCleanupPass clears missing observation entity references without touching valid or out-of-scope rows", async () => {
@@ -225,18 +225,18 @@ test("tieringPass promotes and demotes rows from lifecycle signals and is idempo
     const upsertEntity = getFunction(memoryModule, "upsertEntity");
     const recordObservation = getFunction(memoryModule, "recordObservation");
     const recordDecision = getFunction(memoryModule, "recordDecision");
-    const chapterhouse = getScope("chapterhouse");
-    assert.ok(chapterhouse);
-    const entity = upsertEntity({ scope_id: chapterhouse.id, kind: "component", name: "memory", tier: "warm" });
+    const team = getScope("team");
+    assert.ok(team);
+    const entity = upsertEntity({ scope_id: team.id, kind: "component", name: "memory", tier: "warm" });
     const referencedObservation = recordObservation({
-        scope_id: chapterhouse.id,
+        scope_id: team.id,
         entity_id: entity.id,
         content: "Referenced by a recent decision through its entity.",
         source: "test",
         tier: "warm",
     });
     const recentDecision = recordDecision({
-        scope_id: chapterhouse.id,
+        scope_id: team.id,
         entity_id: entity.id,
         title: "Restate memory tiering decision",
         rationale: "Recent entity-linked decisions keep related observations hot.",
@@ -244,20 +244,20 @@ test("tieringPass promotes and demotes rows from lifecycle signals and is idempo
         tier: "warm",
     });
     const oldHot = recordObservation({
-        scope_id: chapterhouse.id,
+        scope_id: team.id,
         content: "Old hot row with no recall activity should cool down.",
         source: "test",
         tier: "hot",
     });
     const staleLowConfidence = recordObservation({
-        scope_id: chapterhouse.id,
+        scope_id: team.id,
         content: "Low confidence stale row should go cold.",
         source: "test",
         tier: "warm",
         confidence: 0.2,
     });
     const archived = recordObservation({
-        scope_id: chapterhouse.id,
+        scope_id: team.id,
         content: "Archived row should always be cold.",
         source: "test",
         tier: "hot",
@@ -265,7 +265,7 @@ test("tieringPass promotes and demotes rows from lifecycle signals and is idempo
     db.prepare(`UPDATE mem_observations SET created_at = datetime('now', '-45 days') WHERE id = ?`).run(oldHot.id);
     db.prepare(`UPDATE mem_observations SET created_at = datetime('now', '-61 days') WHERE id = ?`).run(staleLowConfidence.id);
     db.prepare(`UPDATE mem_observations SET archived_at = CURRENT_TIMESTAMP WHERE id = ?`).run(archived.id);
-    const summary = housekeepingModule.tieringPass(chapterhouse.id);
+    const summary = housekeepingModule.tieringPass(team.id);
     assert.equal(summary.pass, "tieringPass");
     assert.equal(summary.modified, 5);
     assert.deepEqual(summary.errors, []);
@@ -274,7 +274,7 @@ test("tieringPass promotes and demotes rows from lifecycle signals and is idempo
     assert.equal(db.prepare(`SELECT tier FROM mem_observations WHERE id = ?`).get(oldHot.id).tier, "warm");
     assert.equal(db.prepare(`SELECT tier FROM mem_observations WHERE id = ?`).get(staleLowConfidence.id).tier, "cold");
     assert.equal(db.prepare(`SELECT tier FROM mem_observations WHERE id = ?`).get(archived.id).tier, "cold");
-    const second = housekeepingModule.tieringPass(chapterhouse.id);
+    const second = housekeepingModule.tieringPass(team.id);
     assert.equal(second.modified, 0);
 });
 //# sourceMappingURL=housekeeping.test.js.map

package/dist/memory/index.js

@@ -1,3 +1,4 @@
+export { completeActionItem, dropActionItem, getActionItem, listActionItems, recordActionItem, snoozeActionItem, } from "./action-items.js";
 export { getActiveScope, inferScopeFromText, setActiveScope } from "./active-scope.js";
 export { recordDecision, getDecision, listDecisions, supersedeDecision } from "./decisions.js";
 export { getEntity, findEntityByName, listEntities, upsertEntity } from "./entities.js";

package/dist/memory/recall.js

@@ -169,6 +169,63 @@ function recallEntityHits(query, scopeId, options = {}) {
         snippet: `${row.name}${row.summary ? ` — ${row.summary}` : ""}`,
     }));
 }
+function recallActionItemHits(query, scopeId, options = {}) {
+    if (isFts5Available()) {
+        const ftsQuery = quoteFts5QueryTerms(query);
+        const rows = getDb().prepare(`
+      SELECT
+        a.id,
+        a.scope_id,
+        s.slug AS scope,
+        a.title,
+        a.detail,
+        a.tier,
+        -bm25(mem_action_items_fts) * CASE WHEN a.tier = 'hot' THEN ? ELSE 1 END AS score,
+        snippet(mem_action_items_fts, 0, '[', ']', '…', 8) || COALESCE(' — ' ||
+          snippet(mem_action_items_fts, 1, '[', ']', '…', 12), '') AS snippet
+      FROM mem_action_items a
+      JOIN mem_scopes s ON s.id = a.scope_id
+      JOIN mem_action_items_fts ON mem_action_items_fts.rowid = a.id
+      WHERE mem_action_items_fts MATCH ?
+        AND (? IS NULL OR a.scope_id = ?)
+        AND (? = 1 OR a.tier != 'cold')
+        AND a.status IN ('open', 'snoozed')
+      ORDER BY score DESC, a.id DESC
+    `).all(config.memoryHotRecallBoost, ftsQuery, scopeId ?? null, scopeId ?? null, options.includeCold ? 1 : 0);
+        return rows.map((row) => ({
+            kind: "action_item",
+            id: row.id,
+            scopeId: row.scope_id,
+            scope: row.scope,
+            content: `${row.title}${row.detail ? ` — ${row.detail}` : ""}`,
+            score: row.score,
+            snippet: row.snippet ?? `${row.title}${row.detail ? ` — ${row.detail}` : ""}`,
+        }));
+    }
+    const pattern = `%${query}%`;
+    const rows = getDb().prepare(`
+    SELECT a.id, a.scope_id, s.slug AS scope, a.title, a.detail, a.tier
+    FROM mem_action_items a
+    JOIN mem_scopes s ON s.id = a.scope_id
+    WHERE (? IS NULL OR a.scope_id = ?)
+      AND (? = 1 OR a.tier != 'cold')
+      AND a.status IN ('open', 'snoozed')
+      AND (a.title LIKE ? OR COALESCE(a.detail, '') LIKE ?)
+    ORDER BY
+      CASE WHEN a.due_at IS NULL THEN 1 ELSE 0 END ASC,
+      datetime(a.due_at) ASC,
+      a.id DESC
+  `).all(scopeId ?? null, scopeId ?? null, options.includeCold ? 1 : 0, pattern, pattern);
+    return rows.map((row) => ({
+        kind: "action_item",
+        id: row.id,
+        scopeId: row.scope_id,
+        scope: row.scope,
+        content: `${row.title}${row.detail ? ` — ${row.detail}` : ""}`,
+        score: row.tier === "hot" ? config.memoryHotRecallBoost : 1,
+        snippet: `${row.title}${row.detail ? ` — ${row.detail}` : ""}`,
+    }));
+}
 export function recall(input) {
     const activeScope = getActiveScope();
     const effectiveScopeId = input.scope_id ?? activeScope?.id;
@@ -180,6 +237,7 @@ export function recall(input) {
         ...(requestedKinds.has("observation") ? recallObservationHits(input.query, effectiveScopeId, input) : []),
         ...(requestedKinds.has("decision") ? recallDecisionHits(input.query, effectiveScopeId, input) : []),
         ...(requestedKinds.has("entity") ? recallEntityHits(input.query, effectiveScopeId, input) : []),
+        ...(requestedKinds.has("action_item") ? recallActionItemHits(input.query, effectiveScopeId, input) : []),
     ]
         .sort((a, b) => {
         if (b.score !== a.score)
@@ -193,6 +251,7 @@ export function recall(input) {
             observation: "mem_observations",
             decision: "mem_decisions",
             entity: "mem_entities",
+            action_item: "mem_action_items",
         };
         for (const kind of Object.keys(tables)) {
             const ids = hits.filter((hit) => hit.kind === kind).map((hit) => hit.id);

package/dist/memory/recall.test.js

@@ -96,6 +96,33 @@ test("recall returns active-scope hot-tier entries before ranked FTS hits and re
     });
     assert.equal(limited.hits.length, 1);
 });
+test("recall can opt into action item hits without adding them to default kind searches", async () => {
+    const { dbModule, memoryModule } = await loadModules();
+    dbModule.getDb();
+    const getScope = getFunction(memoryModule, "getScope");
+    const recordActionItem = getFunction(memoryModule, "recordActionItem");
+    const recall = getFunction(memoryModule, "recall");
+    const chapterhouse = getScope("chapterhouse");
+    assert.ok(chapterhouse);
+    const actionItem = recordActionItem({
+        scope_id: chapterhouse.id,
+        title: "Bellonda disk alert",
+        detail: "Next time disk usage exceeds 85 percent, notify infra.",
+        source: "test",
+    });
+    const defaults = recall({ query: "Bellonda disk alert", scope_id: chapterhouse.id, limit: 10 });
+    assert.equal(defaults.hits.some((hit) => hit.kind === "action_item" && hit.id === actionItem.id), false);
+    const actionOnly = recall({
+        query: "Bellonda disk alert",
+        scope_id: chapterhouse.id,
+        kinds: ["action_item"],
+        limit: 10,
+    });
+    assert.equal(actionOnly.hits.length, 1);
+    assert.equal(actionOnly.hits[0]?.kind, "action_item");
+    assert.equal(actionOnly.hits[0]?.id, actionItem.id);
+    assert.match(actionOnly.hits[0]?.content ?? "", /Bellonda disk alert/);
+});
 test("recall excludes superseded and archived rows by default with opt-in inclusion", async () => {
     const { dbModule, memoryModule } = await loadModules();
     const db = dbModule.getDb();

package/dist/memory/tiering.js

@@ -6,6 +6,7 @@ const TABLES = {
     observation: "mem_observations",
     decision: "mem_decisions",
     entity: "mem_entities",
+    action_item: "mem_action_items",
 };
 function dbTable(table) {
     return TABLES[table];
@@ -71,8 +72,9 @@ export function tieringPass(scopeId) {
       SELECT
         (SELECT COUNT(*) FROM mem_observations WHERE scope_id = ?) AS observations,
         (SELECT COUNT(*) FROM mem_decisions WHERE scope_id = ?) AS decisions,
-        (SELECT COUNT(*) FROM mem_entities WHERE scope_id = ?) AS entities
-    `).get(scopeId, scopeId, scopeId);
+        (SELECT COUNT(*) FROM mem_entities WHERE scope_id = ?) AS entities,
+        (SELECT COUNT(*) FROM mem_action_items WHERE scope_id = ?) AS action_items
+    `).get(scopeId, scopeId, scopeId, scopeId);
         let modified = 0;
         const tx = db.transaction(() => {
             modified += updateTier(`
@@ -163,6 +165,34 @@ export function tieringPass(scopeId) {
           AND superseded_by IS NULL
           AND last_recalled_at IS NULL
           AND datetime(decided_at) < datetime('now', ?)
+      `, [scopeId, `-${config.memoryHotAgeDays} days`]);
+            modified += updateTier(`
+        UPDATE mem_action_items
+        SET tier = 'cold', tier_reason = 'resolved action item'
+        WHERE scope_id = ?
+          AND tier != 'cold'
+          AND tier_pinned_at IS NULL
+          AND status IN ('done', 'dropped')
+      `, [scopeId]);
+            modified += updateTier(`
+        UPDATE mem_action_items
+        SET tier = 'hot', tier_reason = 'open action item due soon'
+        WHERE scope_id = ?
+          AND tier != 'hot'
+          AND tier_pinned_at IS NULL
+          AND status = 'open'
+          AND due_at IS NOT NULL
+          AND datetime(due_at) <= datetime('now', '+7 days')
+      `, [scopeId]);
+            modified += updateTier(`
+        UPDATE mem_action_items
+        SET tier = 'warm', tier_reason = 'hot age threshold without recall'
+        WHERE scope_id = ?
+          AND tier = 'hot'
+          AND tier_pinned_at IS NULL
+          AND status = 'open'
+          AND last_recalled_at IS NULL
+          AND datetime(created_at) < datetime('now', ?)
       `, [scopeId, `-${config.memoryHotAgeDays} days`]);
             modified += updateTier(`
         UPDATE mem_observations
@@ -184,7 +214,7 @@ export function tieringPass(scopeId) {
       `, [scopeId]);
         });
         tx();
-        return passSummary("tieringPass", counts.observations + counts.decisions + counts.entities, modified);
+        return passSummary("tieringPass", counts.observations + counts.decisions + counts.entities + counts.action_items, modified);
     }
     catch (error) {
         return passSummary("tieringPass", 0, 0, [error instanceof Error ? error.message : String(error)]);