chapterhouse 0.13.1 → 0.14.1

package/dist/memory/action-items.js

@@ -1,100 +0,0 @@
-import { getDb } from "../store/db.js";
-function toActionItem(row) {
-    return {
-        id: row.id,
-        scopeId: row.scope_id,
-        entityId: row.entity_id ?? undefined,
-        title: row.title,
-        detail: row.detail ?? undefined,
-        status: row.status,
-        dueAt: row.due_at ?? undefined,
-        snoozeUntil: row.snooze_until ?? undefined,
-        source: row.source ?? undefined,
-        tier: row.tier,
-        tierPinnedAt: row.tier_pinned_at ?? undefined,
-        tierReason: row.tier_reason ?? undefined,
-        lastRecalledAt: row.last_recalled_at ?? undefined,
-        createdAt: row.created_at,
-        updatedAt: row.updated_at,
-        resolvedAt: row.resolved_at ?? undefined,
-        resolutionReason: row.resolution_reason ?? undefined,
-    };
-}
-const ACTION_ITEM_COLUMNS = `
-  id, scope_id, entity_id, title, detail, status, due_at, snooze_until, source,
-  created_at, updated_at, resolved_at, resolution_reason, tier, tier_pinned_at,
-  tier_reason, last_recalled_at
-`;
-export function recordActionItem(input) {
-    const result = getDb().prepare(`
-    INSERT INTO mem_action_items (
-      scope_id, entity_id, title, detail, due_at, source, tier, created_at, updated_at
-    )
-    VALUES (?, ?, ?, ?, ?, ?, ?, CURRENT_TIMESTAMP, CURRENT_TIMESTAMP)
-  `).run(input.scope_id, input.entity_id ?? null, input.title, input.detail ?? null, input.due_at ?? null, input.source ?? null, input.tier ?? "warm");
-    return getActionItem(Number(result.lastInsertRowid));
-}
-export function getActionItem(id) {
-    const row = getDb().prepare(`
-    SELECT ${ACTION_ITEM_COLUMNS}
-    FROM mem_action_items
-    WHERE id = ?
-  `).get(id);
-    return row ? toActionItem(row) : undefined;
-}
-export function listActionItems(input = {}) {
-    const rows = getDb().prepare(`
-    SELECT ${ACTION_ITEM_COLUMNS}
-    FROM mem_action_items
-    WHERE (? IS NULL OR scope_id = ?)
-      AND (
-        ? IS NOT NULL
-        OR status = 'open'
-        OR (status = 'snoozed' AND snooze_until IS NOT NULL AND datetime(snooze_until) <= datetime('now'))
-      )
-      AND (? IS NULL OR status = ?)
-      AND (? IS NULL OR due_at IS NOT NULL AND datetime(due_at) <= datetime(?))
-      AND (? = 1 OR tier != 'cold')
-    ORDER BY
-      CASE WHEN due_at IS NULL THEN 1 ELSE 0 END ASC,
-      datetime(due_at) ASC,
-      datetime(created_at) DESC,
-      id DESC
-    LIMIT ? OFFSET ?
-  `).all(input.scope_id ?? null, input.scope_id ?? null, input.status ?? null, input.status ?? null, input.status ?? null, input.due_before ?? null, input.due_before ?? null, input.includeArchived ? 1 : 0, input.limit ?? 50, input.offset ?? 0);
-    return rows.map(toActionItem);
-}
-function resolveActionItem(id, status, reason) {
-    const result = getDb().prepare(`
-    UPDATE mem_action_items
-    SET status = ?,
-      resolved_at = CURRENT_TIMESTAMP,
-      resolution_reason = ?,
-      updated_at = CURRENT_TIMESTAMP
-    WHERE id = ?
-  `).run(status, reason ?? null, id);
-    if (result.changes === 0) {
-        throw new Error(`Unknown action item id '${id}'.`);
-    }
-    return getActionItem(id);
-}
-export function completeActionItem(id, resolutionReason) {
-    return resolveActionItem(id, "done", resolutionReason);
-}
-export function dropActionItem(id, reason) {
-    return resolveActionItem(id, "dropped", reason);
-}
-export function snoozeActionItem(id, snoozeUntil) {
-    const result = getDb().prepare(`
-    UPDATE mem_action_items
-    SET status = 'snoozed',
-      snooze_until = ?,
-      updated_at = CURRENT_TIMESTAMP
-    WHERE id = ?
-  `).run(snoozeUntil, id);
-    if (result.changes === 0) {
-        throw new Error(`Unknown action item id '${id}'.`);
-    }
-    return getActionItem(id);
-}
-//# sourceMappingURL=action-items.js.map

package/dist/memory/action-items.test.js

@@ -1,83 +0,0 @@
-import assert from "node:assert/strict";
-import { mkdirSync, rmSync } from "node:fs";
-import { join } from "node:path";
-import test from "node:test";
-const repoRoot = process.cwd();
-const sandboxRoot = join(repoRoot, ".test-work", `memory-action-items-${process.pid}`);
-const chapterhouseHome = join(sandboxRoot, ".chapterhouse");
-process.env.CHAPTERHOUSE_HOME = sandboxRoot;
-function resetSandbox() {
-    mkdirSync(join(repoRoot, ".test-work"), { recursive: true });
-    rmSync(sandboxRoot, { recursive: true, force: true });
-    mkdirSync(chapterhouseHome, { recursive: true });
-}
-async function loadModules() {
-    const dbModule = await import(new URL("../store/db.js", import.meta.url).href);
-    const memoryModule = await import(new URL("./index.js", import.meta.url).href);
-    return { dbModule, memoryModule };
-}
-function getFunction(module, name) {
-    const value = module[name];
-    assert.equal(typeof value, "function", `expected ${name} to be exported`);
-    return value;
-}
-test.beforeEach(async () => {
-    process.env.CHAPTERHOUSE_HOME = sandboxRoot;
-    const dbModule = await import(new URL("../store/db.js", import.meta.url).href);
-    dbModule.closeDb();
-    resetSandbox();
-});
-test.after(async () => {
-    const dbModule = await import(new URL("../store/db.js", import.meta.url).href);
-    dbModule.closeDb();
-    rmSync(sandboxRoot, { recursive: true, force: true });
-});
-test("action items round-trip through add, list, and complete with done hidden by default", async () => {
-    const { dbModule, memoryModule } = await loadModules();
-    dbModule.getDb();
-    const getScope = getFunction(memoryModule, "getScope");
-    const recordActionItem = getFunction(memoryModule, "recordActionItem");
-    const listActionItems = getFunction(memoryModule, "listActionItems");
-    const completeActionItem = getFunction(memoryModule, "completeActionItem");
-    const chapterhouse = getScope("chapterhouse");
-    assert.ok(chapterhouse);
-    const added = recordActionItem({
-        scope_id: chapterhouse.id,
-        title: "Migrate feature ideas into memory",
-        detail: "Move feature-ideas.md into mem_action_items once the schema exists.",
-        due_at: "2026-05-15T12:00:00.000Z",
-        source: "test",
-    });
-    assert.equal(added.status, "open");
-    assert.equal(added.title, "Migrate feature ideas into memory");
-    assert.equal(added.detail, "Move feature-ideas.md into mem_action_items once the schema exists.");
-    assert.equal(added.dueAt, "2026-05-15T12:00:00.000Z");
-    assert.deepEqual(listActionItems({ scope_id: chapterhouse.id }).map((item) => item.id), [added.id]);
-    const completed = completeActionItem(added.id, "Migrated successfully.");
-    assert.equal(completed.status, "done");
-    assert.ok(completed.resolvedAt);
-    assert.deepEqual(listActionItems({ scope_id: chapterhouse.id }).map((item) => item.id), []);
-    assert.deepEqual(listActionItems({ scope_id: chapterhouse.id, status: "done" }).map((item) => item.id), [added.id]);
-});
-test("snoozed action items are hidden by default until snooze_until passes", async () => {
-    const { dbModule, memoryModule } = await loadModules();
-    dbModule.getDb();
-    const getScope = getFunction(memoryModule, "getScope");
-    const recordActionItem = getFunction(memoryModule, "recordActionItem");
-    const snoozeActionItem = getFunction(memoryModule, "snoozeActionItem");
-    const listActionItems = getFunction(memoryModule, "listActionItems");
-    const chapterhouse = getScope("chapterhouse");
-    assert.ok(chapterhouse);
-    const future = recordActionItem({ scope_id: chapterhouse.id, title: "Remind infra later", source: "test" });
-    const expired = recordActionItem({ scope_id: chapterhouse.id, title: "Reappears now", source: "test" });
-    assert.equal(snoozeActionItem(future.id, "2999-01-01T00:00:00.000Z").status, "snoozed");
-    assert.equal(snoozeActionItem(expired.id, "2000-01-01T00:00:00.000Z").status, "snoozed");
-    const defaults = listActionItems({ scope_id: chapterhouse.id });
-    assert.equal(defaults.some((item) => item.id === future.id), false);
-    assert.equal(defaults.some((item) => item.id === expired.id), true);
-    assert.deepEqual(listActionItems({ scope_id: chapterhouse.id, status: "snoozed" }).map((item) => item.id).sort(), [
-        expired.id,
-        future.id,
-    ].sort());
-});
-//# sourceMappingURL=action-items.test.js.map

package/dist/memory/active-scope.js

@@ -1,78 +0,0 @@
-import { AsyncLocalStorage } from "node:async_hooks";
-import { getDb } from "../store/db.js";
-import { getScope, listScopes } from "./scopes.js";
-const ACTIVE_SCOPE_KEY = "current_scope_slug";
-const activeScopeOverride = new AsyncLocalStorage();
-function setSetting(key, value) {
-    getDb().prepare(`
-    INSERT INTO mem_settings (key, value)
-    VALUES (?, ?)
-    ON CONFLICT(key) DO UPDATE SET value = excluded.value
-  `).run(key, value);
-}
-function getSetting(key) {
-    const row = getDb().prepare(`
-    SELECT value
-    FROM mem_settings
-    WHERE key = ?
-  `).get(key);
-    return row?.value;
-}
-function clearSetting(key) {
-    getDb().prepare(`DELETE FROM mem_settings WHERE key = ?`).run(key);
-}
-export function getActiveScope() {
-    const override = activeScopeOverride.getStore();
-    if (override !== undefined) {
-        return override === null ? null : (getScope(override) ?? null);
-    }
-    const slug = getSetting(ACTIVE_SCOPE_KEY);
-    if (!slug)
-        return null;
-    const scope = getScope(slug);
-    if (!scope) {
-        clearSetting(ACTIVE_SCOPE_KEY);
-        return null;
-    }
-    return scope;
-}
-export function withActiveScope(slug, fn) {
-    return activeScopeOverride.run(slug, fn);
-}
-export function setActiveScope(slug) {
-    if (slug === null) {
-        clearSetting(ACTIVE_SCOPE_KEY);
-        return null;
-    }
-    const scope = getScope(slug);
-    if (!scope) {
-        throw new Error(`Unknown memory scope '${slug}'.`);
-    }
-    setSetting(ACTIVE_SCOPE_KEY, scope.slug);
-    return scope;
-}
-export function inferScopeFromText(text) {
-    const lowered = text.toLowerCase();
-    const ranked = listScopes()
-        .filter((scope) => scope.active)
-        .map((scope) => {
-        const matchedKeywords = scope.keywords.filter((keyword, index, keywords) => lowered.includes(keyword.toLowerCase()) && keywords.indexOf(keyword) === index);
-        return { scope, matchedKeywords };
-    })
-        .filter((entry) => entry.matchedKeywords.length > 0)
-        .sort((a, b) => {
-        if (b.matchedKeywords.length !== a.matchedKeywords.length) {
-            return b.matchedKeywords.length - a.matchedKeywords.length;
-        }
-        return a.scope.slug.localeCompare(b.scope.slug);
-    });
-    const winner = ranked[0];
-    if (!winner)
-        return null;
-    return {
-        scope_id: winner.scope.id,
-        confidence: winner.matchedKeywords.length / Math.max(winner.scope.keywords.length, 1),
-        matched_keywords: winner.matchedKeywords,
-    };
-}
-//# sourceMappingURL=active-scope.js.map

package/dist/memory/active-scope.test.js

@@ -1,80 +0,0 @@
-import assert from "node:assert/strict";
-import { mkdirSync, rmSync } from "node:fs";
-import { join } from "node:path";
-import test from "node:test";
-const repoRoot = process.cwd();
-const sandboxRoot = join(repoRoot, ".test-work", `memory-active-scope-${process.pid}`);
-const chapterhouseHome = join(sandboxRoot, ".chapterhouse");
-process.env.CHAPTERHOUSE_HOME = sandboxRoot;
-function resetSandbox() {
-    mkdirSync(join(repoRoot, ".test-work"), { recursive: true });
-    rmSync(sandboxRoot, { recursive: true, force: true });
-    mkdirSync(chapterhouseHome, { recursive: true });
-}
-async function loadModules() {
-    const dbModule = await import(new URL("../store/db.js", import.meta.url).href);
-    const memoryModule = await import(new URL("./index.js", import.meta.url).href);
-    return { dbModule, memoryModule };
-}
-function getFunction(module, name) {
-    const value = module[name];
-    assert.equal(typeof value, "function", `expected ${name} to be exported`);
-    return value;
-}
-test.beforeEach(async () => {
-    const dbModule = await import(new URL("../store/db.js", import.meta.url).href);
-    dbModule.closeDb();
-    resetSandbox();
-});
-test.after(async () => {
-    const dbModule = await import(new URL("../store/db.js", import.meta.url).href);
-    dbModule.closeDb();
-    rmSync(sandboxRoot, { recursive: true, force: true });
-});
-test("active scope can be set, read, and cleared without changing scope activation status", async () => {
-    const { dbModule, memoryModule } = await loadModules();
-    dbModule.getDb();
-    const getActiveScope = getFunction(memoryModule, "getActiveScope");
-    const setActiveScope = getFunction(memoryModule, "setActiveScope");
-    const deactivateScope = getFunction(memoryModule, "deactivateScope");
-    const createScope = getFunction(memoryModule, "createScope");
-    assert.equal(getActiveScope(), null);
-    assert.equal(setActiveScope("chapterhouse")?.slug, "chapterhouse");
-    assert.equal(getActiveScope()?.slug, "chapterhouse");
-    const team = createScope({
-        slug: "team",
-        title: "Team",
-        description: "Team test scope",
-        keywords: ["team"],
-    });
-    const deactivated = deactivateScope(team.id);
-    assert.equal(deactivated.active, false);
-    assert.equal(getActiveScope()?.slug, "chapterhouse");
-    assert.equal(setActiveScope(null), null);
-    assert.equal(getActiveScope(), null);
-});
-test("inferScopeFromText prefers the highest keyword match count and breaks ties deterministically", async () => {
-    const { dbModule, memoryModule } = await loadModules();
-    dbModule.getDb();
-    const createScope = getFunction(memoryModule, "createScope");
-    const inferScopeFromText = getFunction(memoryModule, "inferScopeFromText");
-    const alpha = createScope({
-        slug: "alpha-release",
-        title: "Alpha Release",
-        description: "Alpha release work",
-        keywords: ["release"],
-    });
-    const beta = createScope({
-        slug: "beta-deploy",
-        title: "Beta Deploy",
-        description: "Deployment work",
-        keywords: ["deploy", "release"],
-    });
-    const bestMatch = inferScopeFromText("Please deploy the release workflow today.");
-    assert.equal(bestMatch?.scope_id, beta.id);
-    assert.deepEqual(bestMatch?.matched_keywords.sort(), ["deploy", "release"]);
-    const tie = inferScopeFromText("This release needs triage.");
-    assert.equal(tie?.scope_id, alpha.id);
-    assert.deepEqual(tie?.matched_keywords, ["release"]);
-});
-//# sourceMappingURL=active-scope.test.js.map

package/dist/memory/checkpoint-prompt.js

@@ -1,71 +0,0 @@
-function renderTurns(turns) {
-    return turns
-        .map((turn, index) => [
-        `Turn ${index + 1}`,
-        `User: ${turn.user}`,
-        `Assistant: ${turn.assistant}`,
-    ].join("\n"))
-        .join("\n\n");
-}
-function renderEntities(entities) {
-    if (entities.length === 0) {
-        return "- none";
-    }
-    return entities
-        .map((entity) => `- ${entity.name} (${entity.kind}): ${entity.summary ?? entity.name}`)
-        .join("\n");
-}
-function renderDecisions(decisions) {
-    if (decisions.length === 0) {
-        return "- none";
-    }
-    return decisions
-        .map((decision) => `- ${decision.title}: ${decision.rationale}`)
-        .join("\n");
-}
-export function buildCheckpointSystemPrompt() {
-    return [
-        "You extract durable agent memory from the most recent orchestrator turns.",
-        "Only return valid JSON. No prose, no markdown, no code fences.",
-        "Remember durable items only:",
-        "- decisions (architecture, process, user preferences)",
-        "- durable facts learned about code, tools, people, or infrastructure",
-        "- reusable gotchas or lessons learned",
-        "- named entities only when they are durable and worth remembering as an observation",
-        "Skip greetings, ephemeral progress updates, temporary branch names, one-off commit wording, and off-topic chatter.",
-        "Prefer concrete entries over vague summaries.",
-        "Use kind='decision' only when a real decision was made; otherwise use kind='observation'.",
-        "If nothing is worth remembering, return {\"proposals\":[]}.",
-        "JSON schema:",
-        "{\"proposals\":[{\"kind\":\"observation|decision\",\"title\":\"required for decision\",\"content\":\"string\",\"scope\":\"optional scope slug; omit to use active scope\",\"confidence\":0.0}]}",
-        "Example good output:",
-        "{\"proposals\":[{\"kind\":\"decision\",\"title\":\"Use SQLite FTS5 for recall\",\"content\":\"Chapterhouse uses SQLite FTS5 for scoped memory recall in v1.\",\"confidence\":0.93}]}",
-        "{\"proposals\":[{\"kind\":\"observation\",\"content\":\"Only orchestrator turns count toward memory checkpoints.\",\"confidence\":0.88}]}",
-    ].join("\n");
-}
-export function buildCheckpointUserPrompt(input) {
-    const scopeChangeBlock = input.scopeChangeContext
-        ? [
-            `Scope-change context: the user is moving from scope ${input.scopeChangeContext.from} to ${input.scopeChangeContext.to}.`,
-            `Extract everything worth remembering about scope ${input.scopeChangeContext.from} from the recent turns BEFORE the context shifts.`,
-            "",
-        ].join("\n")
-        : "";
-    return [
-        `Active scope: ${input.activeScope.slug} — ${input.activeScope.title}`,
-        `Scope description: ${input.activeScope.description}`,
-        "",
-        scopeChangeBlock,
-        "Known entities in the active scope:",
-        renderEntities(input.entities),
-        "",
-        "Known decisions in the active scope:",
-        renderDecisions(input.decisions),
-        "",
-        "Recent orchestrator turns:",
-        renderTurns(input.turns),
-        "",
-        "Return only the JSON object.",
-    ].join("\n");
-}
-//# sourceMappingURL=checkpoint-prompt.js.map