@tznthou/ccrecall 0.1.2

package/dist/cli/daemon.js

@@ -0,0 +1,163 @@
+// SPDX-License-Identifier: Apache-2.0
+import path from 'node:path';
+import os from 'node:os';
+import { spawn } from 'node:child_process';
+import { mkdir, writeFile, rm, realpath, lstat, readFile } from 'node:fs/promises';
+import { fileURLToPath } from 'node:url';
+/**
+ * macOS launchd installer for ccRecall.
+ *
+ * Produces a per-user LaunchAgent plist under ~/Library/LaunchAgents that
+ * keeps ccRecall running across reboots + auto-restarts on crash. Logs land
+ * in ~/Library/Logs/ccrecall/. Linux/Windows equivalents are Phase 5.
+ */
+const LABEL = 'com.tznthou.ccrecall';
+const DEFAULT_PORT = 7749;
+/** Resolve absolute paths for plist generation. `scriptPath` defaults to the
+ *  directory-relative dist/index.js so `node dist/index.js install-daemon`
+ *  plants a plist that re-executes the same binary. */
+export function resolveDaemonPaths(overrides = {}) {
+    const home = overrides.home ?? os.homedir();
+    const launchAgentsDir = path.join(home, 'Library', 'LaunchAgents');
+    const logsDir = path.join(home, 'Library', 'Logs', 'ccrecall');
+    const plistPath = path.join(launchAgentsDir, `${LABEL}.plist`);
+    const nodeBin = overrides.nodeBin ?? process.execPath;
+    const ccrecallJs = overrides.scriptPath ?? defaultScriptPath();
+    return { launchAgentsDir, logsDir, plistPath, nodeBin, ccrecallJs };
+}
+function defaultScriptPath() {
+    // When bundled as an npm bin, process.argv[1] points at the symlinked bin
+    // file. Resolve to the real dist/index.js so launchd spawns the actual file.
+    const argv1 = process.argv[1];
+    if (argv1 && argv1.endsWith('.js'))
+        return argv1;
+    // Fallback: compute relative to this module (e.g. during `pnpm dev`).
+    const here = fileURLToPath(import.meta.url);
+    return path.resolve(path.dirname(here), '..', 'index.js');
+}
+/** Escape text for safe embedding inside a <string> XML element. */
+function escapeXml(s) {
+    return s
+        .replace(/&/g, '&amp;')
+        .replace(/</g, '&lt;')
+        .replace(/>/g, '&gt;')
+        .replace(/"/g, '&quot;');
+}
+export function generatePlist(paths, opts = {}) {
+    const port = opts.port ?? DEFAULT_PORT;
+    const outLog = path.join(paths.logsDir, 'ccrecall.out.log');
+    const errLog = path.join(paths.logsDir, 'ccrecall.err.log');
+    const envEntries = [
+        ['CCRECALL_PORT', String(port)],
+    ];
+    if (opts.dbPath)
+        envEntries.push(['CCRECALL_DB_PATH', opts.dbPath]);
+    const envXml = envEntries
+        .map(([k, v]) => `    <key>${escapeXml(k)}</key>\n    <string>${escapeXml(v)}</string>`)
+        .join('\n');
+    return `<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+<dict>
+  <key>Label</key>
+  <string>${escapeXml(LABEL)}</string>
+  <key>ProgramArguments</key>
+  <array>
+    <string>${escapeXml(paths.nodeBin)}</string>
+    <string>${escapeXml(paths.ccrecallJs)}</string>
+  </array>
+  <key>RunAtLoad</key>
+  <true/>
+  <key>KeepAlive</key>
+  <true/>
+  <key>StandardOutPath</key>
+  <string>${escapeXml(outLog)}</string>
+  <key>StandardErrorPath</key>
+  <string>${escapeXml(errLog)}</string>
+  <key>EnvironmentVariables</key>
+  <dict>
+${envXml}
+  </dict>
+</dict>
+</plist>
+`;
+}
+/** Refuse to touch a plist that isn't ours. Protects against clobbering an
+ *  unrelated LaunchAgent when `$HOME` points somewhere unexpected (sudo, test
+ *  harness, compromised env) and against following a symlink out of the user's
+ *  LaunchAgents directory. "Managed" = regular file whose content contains
+ *  our Label. Non-existent path is OK (first install). */
+async function assertManagedPlist(plistPath) {
+    const stats = await lstat(plistPath).catch(() => null);
+    if (!stats)
+        return;
+    if (stats.isSymbolicLink()) {
+        throw new Error(`refuse to touch symlink at ${plistPath} — remove it manually if you're sure it's ccRecall's`);
+    }
+    if (!stats.isFile()) {
+        throw new Error(`refuse to touch non-regular file at ${plistPath}`);
+    }
+    const content = await readFile(plistPath, 'utf8').catch(() => '');
+    if (!content.includes(`<string>${LABEL}</string>`)) {
+        throw new Error(`refuse to overwrite unmanaged plist at ${plistPath} (Label does not match ${LABEL})`);
+    }
+}
+export async function installDaemon(opts = {}) {
+    if (process.platform !== 'darwin') {
+        throw new Error(`install-daemon currently supports macOS only (platform: ${process.platform}). See docs/launchd.md for manual setup.`);
+    }
+    const paths = resolveDaemonPaths(opts.overrides);
+    // dry-run must be side-effect free: skip realpath() (can block on broken
+    // symlinks or stale network mounts) and all filesystem writes. Generate the
+    // plist from paths as-given and print.
+    if (opts.dryRun) {
+        process.stdout.write(generatePlist(paths, { port: opts.port, dbPath: opts.dbPath }));
+        return;
+    }
+    // If ccrecallJs came from process.argv[1], resolve symlinks so the plist
+    // points at the real dist/index.js, not an npm bin symlink that may move.
+    try {
+        paths.ccrecallJs = await realpath(paths.ccrecallJs);
+    }
+    catch {
+        // If realpath fails (file doesn't exist yet?), keep the original path —
+        // the user will get a clear launchd error rather than silent install.
+    }
+    const plist = generatePlist(paths, { port: opts.port, dbPath: opts.dbPath });
+    await assertManagedPlist(paths.plistPath);
+    await mkdir(paths.launchAgentsDir, { recursive: true });
+    await mkdir(paths.logsDir, { recursive: true });
+    await writeFile(paths.plistPath, plist, 'utf8');
+    if (!opts.skipLaunchctl) {
+        await runLaunchctl(['unload', paths.plistPath]).catch(() => { });
+        await runLaunchctl(['load', '-w', paths.plistPath]);
+    }
+    console.log(`ccRecall LaunchAgent installed: ${paths.plistPath}`);
+    console.log(`Logs: ${paths.logsDir}/ccrecall.{out,err}.log`);
+    console.log('Verify with: launchctl list | grep ccrecall');
+}
+export async function uninstallDaemon(opts = {}) {
+    if (process.platform !== 'darwin') {
+        throw new Error(`uninstall-daemon currently supports macOS only (platform: ${process.platform}).`);
+    }
+    const paths = resolveDaemonPaths(opts.overrides);
+    await assertManagedPlist(paths.plistPath);
+    if (!opts.skipLaunchctl) {
+        await runLaunchctl(['unload', paths.plistPath]).catch(() => { });
+    }
+    await rm(paths.plistPath, { force: true });
+    console.log(`ccRecall LaunchAgent removed: ${paths.plistPath}`);
+}
+function runLaunchctl(args) {
+    return new Promise((resolve, reject) => {
+        const child = spawn('launchctl', args, { stdio: 'ignore' });
+        child.on('error', reject);
+        child.on('exit', (code) => {
+            if (code === 0)
+                resolve();
+            else
+                reject(new Error(`launchctl ${args.join(' ')} exited with code ${code}`));
+        });
+    });
+}
+//# sourceMappingURL=daemon.js.map

package/dist/cli/daemon.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"daemon.js","sourceRoot":"","sources":["../../src/cli/daemon.ts"],"names":[],"mappings":"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"}

package/dist/core/compression.d.ts

@@ -0,0 +1,37 @@
+import type { Database, CompressionCandidate } from './database.js';
+import type { MemoryService } from './memory-service.js';
+export type CompressionAction = {
+    kind: 'skip';
+    reason: string;
+} | {
+    kind: 'compress';
+    toLevel: 1 | 2;
+    newContent: string;
+} | {
+    kind: 'delete';
+};
+export interface CompressionStats {
+    scanned: number;
+    compressed: number;
+    deleted: number;
+    skipped: number;
+    errors: number;
+}
+export interface CompressionOptions {
+    batchSize?: number;
+}
+/** Truncate to a character budget with a trailing ellipsis marker. Trims
+ *  trailing whitespace before appending so the cut point does not look ragged. */
+export declare function truncate(text: string, maxChars: number): string;
+export declare function planTransition(c: CompressionCandidate): CompressionAction;
+export declare class CompressionPipeline {
+    private readonly db;
+    private readonly svc;
+    constructor(db: Database, svc: MemoryService);
+    /** Scan up to batchSize candidates (oldest-id first) and apply one transition
+     *  per memory. Designed to be called repeatedly by MaintenanceCoordinator —
+     *  advancing L0→L1→L2→delete across consecutive passes keeps any single tick
+     *  bounded and avoids starving MCP queries under WAL. */
+    runOnce(opts?: CompressionOptions): CompressionStats;
+}
+//# sourceMappingURL=compression.d.ts.map

package/dist/core/compression.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compression.d.ts","sourceRoot":"","sources":["../../src/core/compression.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,QAAQ,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAA;AACnE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAA;AAiCxD,MAAM,MAAM,iBAAiB,GACzB;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GAChC;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,OAAO,EAAE,CAAC,GAAG,CAAC,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,GACxD;IAAE,IAAI,EAAE,QAAQ,CAAA;CAAE,CAAA;AAEtB,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,MAAM,CAAA;IACf,UAAU,EAAE,MAAM,CAAA;IAClB,OAAO,EAAE,MAAM,CAAA;IACf,OAAO,EAAE,MAAM,CAAA;IACf,MAAM,EAAE,MAAM,CAAA;CACf;AAED,MAAM,WAAW,kBAAkB;IACjC,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB;AAED;kFACkF;AAClF,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAG/D;AAuBD,wBAAgB,cAAc,CAAC,CAAC,EAAE,oBAAoB,GAAG,iBAAiB,CAiCzE;AAED,qBAAa,mBAAmB;IAE5B,OAAO,CAAC,QAAQ,CAAC,EAAE;IACnB,OAAO,CAAC,QAAQ,CAAC,GAAG;gBADH,EAAE,EAAE,QAAQ,EACZ,GAAG,EAAE,aAAa;IAGrC;;;6DAGyD;IACzD,OAAO,CAAC,IAAI,GAAE,kBAAuB,GAAG,gBAAgB;CA2BzD"}

package/dist/core/compression.js

@@ -0,0 +1,129 @@
+import { scrubErrorMessage } from './log-safe.js';
+/**
+ * Phase 4d: mutable-memory compression pipeline.
+ *
+ * Stages a memory through three levels (L0 raw → L1 summary → L2 conclusion)
+ * based on age, access, and effective confidence gates. Session-backed memories
+ * sample `sessions.summary_text`/`intent_text` so L1/L2 content is derived from
+ * the original source rather than repeatedly truncating a truncated string.
+ * Manual memories and orphaned rows fall back to syntactic truncation.
+ *
+ * Auto-delete at L2 applies only to session-backed memories (`session_id IS NOT NULL`)
+ * — a user's manual memory is treated as an explicit intent and capped at L2.
+ */
+// Gate thresholds — kept as module-scope constants so decay-curve tuning lives
+// in one place and tests can reference the same values the pipeline uses.
+const L1_AGE_DAYS = 7;
+const L1_ACCESS_MAX = 2; // compress when access_count < this
+const L1_EFFECTIVE_CONFIDENCE_MAX = 0.5;
+const L2_AGE_DAYS = 30;
+const L2_ACCESS_MAX = 4;
+const DELETE_AGE_DAYS = 60;
+// Syntactic truncation budgets (chars, not tokens — kept deliberately small so
+// even multi-byte languages stay well under 1KB of storage per row).
+const L1_MANUAL_TRUNCATE = 150;
+const L2_MANUAL_TRUNCATE = 80;
+const L2_SUMMARY_TRUNCATE = 100;
+const DEFAULT_BATCH_SIZE = 50;
+/** Truncate to a character budget with a trailing ellipsis marker. Trims
+ *  trailing whitespace before appending so the cut point does not look ragged. */
+export function truncate(text, maxChars) {
+    if (text.length <= maxChars)
+        return text;
+    return text.slice(0, maxChars).trimEnd() + '...';
+}
+function deriveL1Content(c) {
+    // Session-backed: prefer the indexer-written summary as the compressed form.
+    // When the session row is missing (deleted manually, or pre-index race) fall
+    // through to syntactic truncation — matching the manual-memory path.
+    if (c.sessionId) {
+        const summary = c.summaryText?.trim();
+        if (summary)
+            return summary;
+    }
+    return truncate(c.content, L1_MANUAL_TRUNCATE);
+}
+function deriveL2Content(c) {
+    if (c.sessionId) {
+        const intent = c.intentText?.trim();
+        if (intent)
+            return intent;
+        const summary = c.summaryText?.trim();
+        if (summary)
+            return truncate(summary, L2_SUMMARY_TRUNCATE);
+    }
+    return truncate(c.content, L2_MANUAL_TRUNCATE);
+}
+export function planTransition(c) {
+    const level = c.compressionLevel;
+    if (level === 0) {
+        if (c.ageDays >= L1_AGE_DAYS
+            && c.accessCount < L1_ACCESS_MAX
+            && c.effectiveConfidence < L1_EFFECTIVE_CONFIDENCE_MAX) {
+            return { kind: 'compress', toLevel: 1, newContent: deriveL1Content(c) };
+        }
+        return { kind: 'skip', reason: 'L0 gates not met' };
+    }
+    if (level === 1) {
+        if (c.ageDays >= L2_AGE_DAYS && c.accessCount < L2_ACCESS_MAX) {
+            return { kind: 'compress', toLevel: 2, newContent: deriveL2Content(c) };
+        }
+        return { kind: 'skip', reason: 'L1 gates not met' };
+    }
+    if (level === 2) {
+        if (c.ageDays >= DELETE_AGE_DAYS
+            && c.sessionId !== null
+            && c.sessionExists
+            && c.accessCount === 0) {
+            return { kind: 'delete' };
+        }
+        // Orphan (sessionId present but sessions row gone) is deliberately skipped —
+        // the source JSONL is already lost, so auto-delete would erase the last
+        // surviving copy. Lint surfaces orphans for the user to purge explicitly.
+        return { kind: 'skip', reason: 'L2 gates not met' };
+    }
+    return { kind: 'skip', reason: `unknown compression_level=${level}` };
+}
+export class CompressionPipeline {
+    db;
+    svc;
+    constructor(db, svc) {
+        this.db = db;
+        this.svc = svc;
+    }
+    /** Scan up to batchSize candidates (oldest-id first) and apply one transition
+     *  per memory. Designed to be called repeatedly by MaintenanceCoordinator —
+     *  advancing L0→L1→L2→delete across consecutive passes keeps any single tick
+     *  bounded and avoids starving MCP queries under WAL. */
+    runOnce(opts = {}) {
+        const batchSize = opts.batchSize ?? DEFAULT_BATCH_SIZE;
+        const stats = {
+            scanned: 0, compressed: 0, deleted: 0, skipped: 0, errors: 0,
+        };
+        const candidates = this.db.getCompressionCandidates(batchSize);
+        stats.scanned = candidates.length;
+        for (const c of candidates) {
+            try {
+                const action = planTransition(c);
+                if (action.kind === 'compress') {
+                    this.svc.updateContent(c.id, action.newContent, action.toLevel);
+                    stats.compressed++;
+                }
+                else if (action.kind === 'delete') {
+                    this.svc.delete(c.id);
+                    stats.deleted++;
+                }
+                else {
+                    stats.skipped++;
+                }
+            }
+            catch (err) {
+                // Swallow and count — one corrupt row must not abort the whole batch.
+                console.warn('[compression] error on memory', c.id, scrubErrorMessage(err));
+                stats.errors++;
+            }
+        }
+        return stats;
+    }
+}
+//# sourceMappingURL=compression.js.map

package/dist/core/compression.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"compression.js","sourceRoot":"","sources":["../../src/core/compression.ts"],"names":[],"mappings":"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"}

package/dist/core/database.d.ts

@@ -0,0 +1,219 @@
+import type { Project, SessionMeta, Message, MessageContext, SearchPage, SearchOptions, SessionSearchPage, SessionTokenStats, SessionFile, OutcomeStatus, FileHistoryEntry, SubagentSession, SessionFileInput, Memory, MemoryType, Topic, SessionCheckpoint } from './types.js';
+/** 寫入 memories 時使用的參數型別 */
+export interface MemoryInput {
+    sessionId: string | null;
+    messageId: string | null;
+    content: string;
+    type: MemoryType;
+    confidence?: number;
+    /** Phase 4b: denormalized project scope. Session-backed memories auto-derive
+     *  this from sessions.project_id if omitted. Manual memories should set this
+     *  to avoid cross-project leakage. */
+    projectId?: string | null;
+}
+/** 寫入 messages 時使用的參數型別 */
+export interface MessageInput {
+    type: string;
+    uuid: string | null;
+    role: string | null;
+    contentText: string | null;
+    contentJson: string | null;
+    hasToolUse: boolean;
+    hasToolResult: boolean;
+    toolNames: string[];
+    timestamp: string | null;
+    sequence: number;
+    rawJson: string | null;
+    inputTokens: number | null;
+    outputTokens: number | null;
+    cacheReadTokens: number | null;
+    cacheCreationTokens: number | null;
+    model: string | null;
+}
+/** indexSession 的參數型別 */
+export interface IndexSessionParams {
+    sessionId: string;
+    projectId: string;
+    projectDisplayName: string;
+    title: string | null;
+    messageCount: number;
+    filePath: string;
+    fileSize: number;
+    fileMtime: string;
+    startedAt: string | null;
+    endedAt: string | null;
+    summaryText?: string | null;
+    intentText?: string | null;
+    outcomeStatus?: OutcomeStatus;
+    outcomeSignals?: string | null;
+    durationSeconds?: number | null;
+    activeDurationSeconds?: number | null;
+    summaryVersion?: number | null;
+    tags?: string | null;
+    filesTouched?: string | null;
+    toolsUsed?: string | null;
+    sessionFiles?: SessionFileInput[];
+    messages: MessageInput[];
+}
+/** Phase 4d: normalised shape consumed by the compression pipeline. */
+export interface CompressionCandidate {
+    id: number;
+    sessionId: string | null;
+    content: string;
+    compressionLevel: number;
+    accessCount: number;
+    ageDays: number;
+    effectiveConfidence: number;
+    summaryText: string | null;
+    intentText: string | null;
+    /** True when the session row that `sessionId` points at still exists.
+     *  False for manual memories (sessionId is null) or orphaned rows. Used by
+     *  the compression pipeline to block irreversible auto-delete of orphans. */
+    sessionExists: boolean;
+}
+export declare class Database {
+    private db;
+    /** Subagent 排除子查詢：用於所有面向使用者的 query，只顯示主 session */
+    private static readonly EXCLUDE_SUBAGENTS;
+    /** Phase 4b: SQL snippet for effective confidence with exponential decay and
+     *  access-extended half-life. Assumes `m` is the memories alias.
+     *    age_days   = julianday(now) − julianday(COALESCE(last_accessed, created_at))
+     *    half_life  = 7 + 7 · min(access_count, 4)  days
+     *    effective  = confidence · exp(−ln 2 · age_days / half_life)
+     *  Use in ORDER BY; requires exp() user function registered in the constructor. */
+    private static readonly EFFECTIVE_CONFIDENCE;
+    constructor(dbPath: string);
+    close(): void;
+    /** ⚠️ 測試專用：接受任意 SQL，禁止接到 IPC handler */
+    rawAll<T>(sql: string): T[];
+    /** ⚠️ 測試專用：執行 DDL/DML，禁止接到 IPC handler */
+    rawExec(sql: string): void;
+    private initSchema;
+    /** 依序執行尚未套用的 migrations */
+    private runMigrations;
+    /** 取得目前 schema 版本 */
+    getSchemaVersion(): number;
+    upsertProject(id: string, displayName: string): void;
+    getMainSessionCount(): number;
+    updateProjectStats(projectId: string): void;
+    getProjects(): Project[];
+    getSessionMtime(sessionId: string): string | null;
+    getSessions(projectId: string): SessionMeta[];
+    getSessionById(sessionId: string): SessionMeta | null;
+    /** 將 DB 中不在 keepIds 集合的 session 標記為 archived（JSONL 已從磁碟消失），排除 subagent sessions */
+    archiveStaleSessionsExcept(keepIds: Set<string>): void;
+    /** 一次取得所有 session 的 file_mtime + archived 狀態（增量索引批次比對用） */
+    getAllSessionMtimes(): Map<string, {
+        mtime: string;
+        archived: boolean;
+    }>;
+    /** 寫入 subagent session 記錄（upsert：重複 id 更新 mtime/count） */
+    indexSubagentSession(params: {
+        id: string;
+        parentSessionId: string;
+        agentType: string | null;
+        filePath: string;
+        fileSize: number | null;
+        fileMtime: string | null;
+        messageCount: number;
+        startedAt: string | null;
+        endedAt: string | null;
+    }): void;
+    /** 取得指定 parent session 下的所有 subagent sessions */
+    getSubagentSessions(parentSessionId: string): SubagentSession[];
+    /** 刪除指定 parent session 的所有 subagent sessions */
+    deleteSubagentSessions(parentSessionId: string): void;
+    /** 刪除單一 subagent session（含對應的 sessions/messages 資料） */
+    deleteSubagentSession(subagentId: string): void;
+    /** 取得指定 parent session 的所有 subagent ID */
+    getSubagentSessionIds(parentSessionId: string): string[];
+    /** 在單一 transaction 中執行多個 DB 操作 */
+    runTransaction(fn: () => void): void;
+    /** 一次取得所有 subagent sessions 的 file_mtime（增量比對用） */
+    getAllSubagentMtimes(): Map<string, string>;
+    /** 查詢 DB 中已存在的 uuid（用於跨 session 去重 resumed session replay） */
+    getExistingUuids(uuids: string[], excludeSessionId: string): Set<string>;
+    indexSession(params: IndexSessionParams): void;
+    getMessages(sessionId: string): Message[];
+    /** 取得指定訊息及其前後 range 則訊息（搜尋結果上下文預覽） */
+    getMessageContext(messageId: number, range?: number): MessageContext;
+    static readonly SEARCH_PAGE_SIZE = 30;
+    private static readonly VALID_OUTCOMES;
+    private static parseOutcomeStatus;
+    /** FTS5 安全引號包裹：所有 token 無條件包引號，防止 operator injection */
+    private static fts5QuoteIfNeeded;
+    search(query: string, projectId?: string | null, offset?: number, limit?: number, options?: SearchOptions): SearchPage;
+    /** 搜尋 session 標題 / 標籤 / 檔案路徑 / 摘要 / 意圖 */
+    searchSessions(query: string, projectId?: string | null, offset?: number, limit?: number, options?: SearchOptions): SessionSearchPage;
+    getSessionTokenStats(sessionId: string): SessionTokenStats;
+    /** 反向查詢：某檔案出現在哪些 session（按時間倒序） */
+    getFileHistory(filePath: string): FileHistoryEntry[];
+    /** 正向查詢：某 session 操作了哪些檔案 */
+    getSessionFiles(sessionId: string): SessionFile[];
+    saveMemory(input: MemoryInput): number;
+    queryMemories(query: string, limit: number, projectId?: string | null): Memory[];
+    /** Phase 4b: Increment access_count + stamp last_accessed for each id.
+     *  Caller is responsible for dedup (use MemoryService.touch for that). Runs
+     *  inside a transaction so partial failure does not leave half-applied state. */
+    touchMemory(ids: number[]): void;
+    /** Phase 4b: Delete a memory by id. memories_ad trigger syncs memories_fts. */
+    deleteMemory(id: number): boolean;
+    /** Phase 4b: Update memory content and stamp compression metadata atomically.
+     *  memories_au trigger syncs memories_fts. Used by the compression pipeline. */
+    updateMemoryContent(id: number, content: string, level: number, compressedAt: string): boolean;
+    getMemoriesBySessionId(sessionId: string): Memory[];
+    getMemoryCount(): number;
+    /** Phase 4d lint: memories whose session_id references a session row that no
+     *  longer exists (user scrubbed ~/.claude/projects, or pre-index race). Manual
+     *  memories (session_id IS NULL) are not orphan candidates by definition. */
+    getOrphanMemoryIds(limit?: number): Array<{
+        memoryId: number;
+        sessionId: string;
+    }>;
+    /** Phase 4d lint: memories that have fully decayed — effective confidence under
+     *  threshold AND never accessed AND older than `ageDays`. Strict `>` on age so
+     *  callers can use 90 as "more than 90 days" without fencepost ambiguity. */
+    getStaleMemoryIds(opts: {
+        effectiveConfidence: number;
+        ageDays: number;
+    }): Array<{
+        memoryId: number;
+        ageDays: number;
+        effectiveConfidence: number;
+    }>;
+    /** Phase 4d: fetch a batch of memories with everything the compression pipeline
+     *  needs to plan a transition — current level / access / age / effective confidence
+     *  plus the owning session's summary_text / intent_text for content rewrite.
+     *
+     *  LEFT JOIN sessions so session-backed memories whose session row was deleted
+     *  (manual scrub of ~/.claude) still surface; the pipeline detects the NULL
+     *  summary and falls back to syntactic truncation, matching manual memories. */
+    getCompressionCandidates(limit: number): CompressionCandidate[];
+    saveSessionTopics(sessionId: string, projectId: string, topicKeys: string[]): void;
+    saveMemoryTopics(memoryId: number, projectId: string, topicKeys: string[]): void;
+    /** Full rebuild of knowledge_map for a project. project_id for memory_topics is derived
+        from sessions.project_id (not the denormalized column) so repo renames / reindex won't
+        leave stale cross-project associations. */
+    rebuildKnowledgeMap(projectId: string): void;
+    private static readonly TOPIC_ORDER_BY;
+    getKnowledgeMap(projectId: string, opts?: {
+        limit?: number;
+        sortBy?: 'mention' | 'recent' | 'stale';
+    }): Topic[];
+    getMemoriesByTopics(projectId: string, topicKeys: string[], limit: number): Memory[];
+    getTopicCount(projectId?: string): number;
+    getSessionTopicKeys(sessionId: string): string[];
+    getTopic(topicKey: string, projectId: string): Topic | null;
+    /** 共現 topics（與目標共享 session 或 memory），按共現次數排序。
+        project_id 透過 JOIN sessions 決定，避免 memory_topics 過時的 project_id 汙染。 */
+    getRelatedTopics(topicKey: string, projectId: string, limit: number): string[];
+    getKnowledgeMapCounts(projectId: string): {
+        totalTopics: number;
+        totalMemories: number;
+        totalSessions: number;
+    };
+    saveCheckpoint(sessionId: string, projectId: string, snapshotText: string): number;
+    getCheckpointById(id: number): SessionCheckpoint | null;
+    getCheckpointsBySessionId(sessionId: string): SessionCheckpoint[];
+}
+//# sourceMappingURL=database.d.ts.map

package/dist/core/database.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"database.d.ts","sourceRoot":"","sources":["../../src/core/database.ts"],"names":[],"mappings":"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"}