chapterhouse 0.3.25 → 0.4.0

package/dist/memory/tiering.js

@@ -0,0 +1,193 @@
+import { config } from "../config.js";
+import { getDb } from "../store/db.js";
+import { childLogger } from "../util/logger.js";
+const log = childLogger("memory.tiering");
+const TABLES = {
+    observation: "mem_observations",
+    decision: "mem_decisions",
+    entity: "mem_entities",
+};
+function dbTable(table) {
+    return TABLES[table];
+}
+function passSummary(pass, examined = 0, modified = 0, errors = []) {
+    return { pass, examined, modified, errors };
+}
+function isRecent(value, days) {
+    if (!value) {
+        return false;
+    }
+    const parsed = new Date(value.includes("T") ? value : value.replace(" ", "T"));
+    if (Number.isNaN(parsed.getTime())) {
+        return false;
+    }
+    return parsed.getTime() >= Date.now() - days * 24 * 60 * 60 * 1000;
+}
+export function inferTierFromSignals(row) {
+    if (row.archived_at || row.superseded_by) {
+        return "cold";
+    }
+    if (row.tier === "glacier") {
+        return "cold";
+    }
+    if (row.confidence !== undefined && row.confidence !== null && row.confidence > 0.7) {
+        const timestamp = row.created_at ?? row.decided_at ?? row.updated_at;
+        if (isRecent(timestamp, 30)) {
+            return "hot";
+        }
+    }
+    return row.tier === "hot" || row.tier === "cold" ? row.tier : "warm";
+}
+function setTier(table, id, tier, reason, manual) {
+    const result = getDb().prepare(`
+    UPDATE ${dbTable(table)}
+    SET tier = ?, tier_reason = ?, tier_pinned_at = ${manual ? "CURRENT_TIMESTAMP" : "tier_pinned_at"}
+    WHERE id = ?
+  `).run(tier, reason, id);
+    if (result.changes === 0) {
+        throw new Error(`Unknown memory ${table} id '${id}'.`);
+    }
+    log.info({ table, id, tier, reason, manual }, "memory.tier.set");
+}
+export function promoteToHot(table, id, reason) {
+    setTier(table, id, "hot", reason, true);
+}
+export function demoteToWarm(table, id, reason) {
+    setTier(table, id, "warm", reason, true);
+}
+export function demoteToCold(table, id, reason) {
+    setTier(table, id, "cold", reason, true);
+}
+function updateTier(sql, params) {
+    return getDb().prepare(sql).run(...params).changes;
+}
+export function tieringPass(scopeId) {
+    if (!config.memoryTieringEnabled) {
+        return passSummary("tieringPass");
+    }
+    try {
+        const db = getDb();
+        const counts = db.prepare(`
+      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);
+        let modified = 0;
+        const tx = db.transaction(() => {
+            modified += updateTier(`
+        UPDATE mem_observations
+        SET tier = 'cold', tier_reason = 'archived or superseded'
+        WHERE scope_id = ?
+          AND tier != 'cold'
+          AND tier_pinned_at IS NULL
+          AND (archived_at IS NOT NULL OR superseded_by IS NOT NULL)
+      `, [scopeId]);
+            modified += updateTier(`
+        UPDATE mem_decisions
+        SET tier = 'cold', tier_reason = 'archived or superseded'
+        WHERE scope_id = ?
+          AND tier != 'cold'
+          AND tier_pinned_at IS NULL
+          AND (archived_at IS NOT NULL OR superseded_by IS NOT NULL)
+      `, [scopeId]);
+            modified += updateTier(`
+        UPDATE mem_observations
+        SET tier = 'hot', tier_reason = 'referenced by recent entity decision'
+        WHERE scope_id = ?
+          AND tier != 'hot'
+          AND tier_pinned_at IS NULL
+          AND archived_at IS NULL
+          AND superseded_by IS NULL
+          AND entity_id IS NOT NULL
+          AND EXISTS (
+            SELECT 1
+            FROM mem_decisions d
+            WHERE d.scope_id = mem_observations.scope_id
+              AND d.entity_id = mem_observations.entity_id
+              AND d.archived_at IS NULL
+              AND d.superseded_by IS NULL
+              AND datetime(d.decided_at) >= datetime('now', '-7 days')
+          )
+      `, [scopeId]);
+            modified += updateTier(`
+        UPDATE mem_decisions
+        SET tier = 'hot', tier_reason = 'recent decision restatement'
+        WHERE scope_id = ?
+          AND tier != 'hot'
+          AND tier_pinned_at IS NULL
+          AND archived_at IS NULL
+          AND (
+            datetime(decided_at) >= datetime('now', '-7 days')
+            OR EXISTS (
+              SELECT 1
+              FROM mem_decisions old
+              WHERE old.superseded_by = mem_decisions.id
+                AND datetime(mem_decisions.decided_at) >= datetime('now', '-7 days')
+            )
+          )
+      `, [scopeId]);
+            modified += updateTier(`
+        UPDATE mem_entities
+        SET tier = 'hot', tier_reason = 'referenced by three recent observations'
+        WHERE scope_id = ?
+          AND tier != 'hot'
+          AND tier_pinned_at IS NULL
+          AND (
+            SELECT COUNT(*)
+            FROM mem_observations o
+            WHERE o.entity_id = mem_entities.id
+              AND o.archived_at IS NULL
+              AND o.superseded_by IS NULL
+              AND datetime(o.created_at) >= datetime('now', '-7 days')
+          ) >= 3
+      `, [scopeId]);
+            modified += updateTier(`
+        UPDATE mem_observations
+        SET tier = 'warm', tier_reason = 'hot age threshold without recall'
+        WHERE scope_id = ?
+          AND tier = 'hot'
+          AND tier_pinned_at IS NULL
+          AND archived_at IS NULL
+          AND superseded_by IS NULL
+          AND last_recalled_at IS NULL
+          AND datetime(created_at) < datetime('now', ?)
+      `, [scopeId, `-${config.memoryHotAgeDays} days`]);
+            modified += updateTier(`
+        UPDATE mem_decisions
+        SET tier = 'warm', tier_reason = 'hot age threshold without recall'
+        WHERE scope_id = ?
+          AND tier = 'hot'
+          AND tier_pinned_at IS NULL
+          AND archived_at IS NULL
+          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_observations
+        SET tier = 'cold', tier_reason = 'stale low confidence'
+        WHERE scope_id = ?
+          AND tier = 'warm'
+          AND tier_pinned_at IS NULL
+          AND confidence < 0.3
+          AND datetime(created_at) < datetime('now', '-60 days')
+      `, [scopeId]);
+            modified += updateTier(`
+        UPDATE mem_entities
+        SET tier = 'cold', tier_reason = 'stale low confidence'
+        WHERE scope_id = ?
+          AND tier = 'warm'
+          AND tier_pinned_at IS NULL
+          AND confidence < 0.3
+          AND datetime(updated_at) < datetime('now', '-60 days')
+      `, [scopeId]);
+        });
+        tx();
+        return passSummary("tieringPass", counts.observations + counts.decisions + counts.entities, modified);
+    }
+    catch (error) {
+        return passSummary("tieringPass", 0, 0, [error instanceof Error ? error.message : String(error)]);
+    }
+}
+//# sourceMappingURL=tiering.js.map

package/dist/memory/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/paths.js

@@ -13,8 +13,14 @@ function resolveChapterhouseHome() {
         : join(configuredHome, ".chapterhouse");
 }
 export const CHAPTERHOUSE_HOME = resolveChapterhouseHome();
+export function getChapterhouseHome() {
+    return resolveChapterhouseHome();
+}
 /** Path to the SQLite database */
 export const DB_PATH = join(CHAPTERHOUSE_HOME, "chapterhouse.db");
+export function getDbPath() {
+    return join(resolveChapterhouseHome(), "chapterhouse.db");
+}
 /** Path to the user .env file */
 export const ENV_PATH = join(CHAPTERHOUSE_HOME, ".env");
 /** Path to user-local skills */
@@ -36,6 +42,6 @@ export function resolveWikiRelativePath(relativePath) {
 }
 /** Ensure ~/.chapterhouse/ exists */
 export function ensureChapterhouseHome() {
-    mkdirSync(CHAPTERHOUSE_HOME, { recursive: true });
+    mkdirSync(resolveChapterhouseHome(), { recursive: true });
 }
 //# sourceMappingURL=paths.js.map