@tznthou/ccrecall 0.1.2

package/dist/core/memory-service.js

@@ -0,0 +1,47 @@
+import { scrubErrorMessage } from './log-safe.js';
+/**
+ * Phase 4b: thin abstraction on top of Database for memory lifecycle operations
+ * (touch / delete / update-content). Centralises policy so HTTP routes, MCP
+ * tools, hooks and background maintenance all share the same semantics.
+ *
+ * Deliberately narrow for now. Compression scheduling, decay tuning and lint
+ * orchestration land in Phase 4c–4e and will be added here rather than in the
+ * callers.
+ */
+export class MemoryService {
+    db;
+    constructor(db) {
+        this.db = db;
+    }
+    /**
+     * Increment access_count and stamp last_accessed for each id. Dedupes
+     * automatically so the same memory surfaced in multiple topic clusters is
+     * only counted once per request.
+     *
+     * Fire-and-forget: swallows errors and logs to stderr so query latency is
+     * never affected by touch failures.
+     */
+    touch(ids) {
+        const unique = Array.from(new Set(ids));
+        if (unique.length === 0)
+            return;
+        try {
+            this.db.touchMemory(unique);
+        }
+        catch (err) {
+            console.warn('[memory-service] touch failed:', scrubErrorMessage(err));
+        }
+    }
+    /** Delete a memory by id. Returns true if a row was deleted. */
+    delete(id) {
+        return this.db.deleteMemory(id);
+    }
+    /**
+     * Rewrite memory.content and stamp compression metadata atomically. Used by
+     * the compression pipeline in Phase 4d.
+     */
+    updateContent(id, content, level) {
+        return this.db.updateMemoryContent(id, content, level, new Date().toISOString());
+    }
+}
+//# sourceMappingURL=memory-service.js.map

package/dist/core/memory-service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory-service.js","sourceRoot":"","sources":["../../src/core/memory-service.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAA;AAEjD;;;;;;;;GAQG;AACH,MAAM,OAAO,aAAa;IACK;IAA7B,YAA6B,EAAY;QAAZ,OAAE,GAAF,EAAE,CAAU;IAAG,CAAC;IAE7C;;;;;;;OAOG;IACH,KAAK,CAAC,GAAa;QACjB,MAAM,MAAM,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,GAAG,CAAC,GAAG,CAAC,CAAC,CAAA;QACvC,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC;YAAE,OAAM;QAC/B,IAAI,CAAC;YACH,IAAI,CAAC,EAAE,CAAC,WAAW,CAAC,MAAM,CAAC,CAAA;QAC7B,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,OAAO,CAAC,IAAI,CAAC,gCAAgC,EAAE,iBAAiB,CAAC,GAAG,CAAC,CAAC,CAAA;QACxE,CAAC;IACH,CAAC;IAED,gEAAgE;IAChE,MAAM,CAAC,EAAU;QACf,OAAO,IAAI,CAAC,EAAE,CAAC,YAAY,CAAC,EAAE,CAAC,CAAA;IACjC,CAAC;IAED;;;OAGG;IACH,aAAa,CAAC,EAAU,EAAE,OAAe,EAAE,KAAa;QACtD,OAAO,IAAI,CAAC,EAAE,CAAC,mBAAmB,CAAC,EAAE,EAAE,OAAO,EAAE,KAAK,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC,CAAA;IAClF,CAAC;CACF"}

package/dist/core/parser.d.ts

@@ -0,0 +1,17 @@
+import type { ParsedLine, ParsedSession } from './types.js';
+interface ContentResult {
+    contentText: string | null;
+    hasToolUse: boolean;
+    hasToolResult: boolean;
+    toolNames: string[];
+}
+/** 移除系統注入的 XML 標籤，保留使用者原始文字。白名單制，不認識的標籤不動 */
+export declare function stripSystemXml(text: string): string;
+/** 解析 message.content 欄位，處理 string 和 array 兩種格式 */
+export declare function parseContent(content: unknown): ContentResult;
+/** 解析單行 JSONL，失敗回傳 null */
+export declare function parseLine(line: string): ParsedLine | null;
+/** 解析整個 JSONL 檔案為結構化 session */
+export declare function parseSession(filePath: string, sessionId: string): Promise<ParsedSession>;
+export {};
+//# sourceMappingURL=parser.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"parser.d.ts","sourceRoot":"","sources":["../../src/core/parser.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,YAAY,CAAA;AAE3D,UAAU,aAAa;IACrB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAA;IAC1B,UAAU,EAAE,OAAO,CAAA;IACnB,aAAa,EAAE,OAAO,CAAA;IACtB,SAAS,EAAE,MAAM,EAAE,CAAA;CACpB;AAcD,6CAA6C;AAC7C,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEnD;AAED,mDAAmD;AACnD,wBAAgB,YAAY,CAAC,OAAO,EAAE,OAAO,GAAG,aAAa,CA+C5D;AA6BD,2BAA2B;AAC3B,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU,GAAG,IAAI,CA8EzD;AAID,gCAAgC;AAChC,wBAAsB,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC,CAmD9F"}

package/dist/core/parser.js

@@ -0,0 +1,205 @@
+// SPDX-License-Identifier: Apache-2.0
+import { readFile } from 'node:fs/promises';
+/** 完全移除的系統標籤（標籤+內容一起刪）*/
+const STRIP_TAGS = ['local-command-caveat', 'task-notification', 'ide_opened_file', 'system-reminder'];
+/** 只移除標籤殼、保留內文的系統標籤 */
+const UNWRAP_TAGS = ['command-name', 'command-message', 'command-args', 'local-command-stdout'];
+const STRIP_RE = new RegExp(STRIP_TAGS.map(t => `<${t}>[\\s\\S]*?</${t}>`).join('|'), 'g');
+const UNWRAP_RE = new RegExp(`<(${UNWRAP_TAGS.join('|')})>([\\s\\S]*?)</\\1>`, 'g');
+/** 移除系統注入的 XML 標籤，保留使用者原始文字。白名單制，不認識的標籤不動 */
+export function stripSystemXml(text) {
+    return text.replace(STRIP_RE, '').replace(UNWRAP_RE, (_, _tag, content) => content).trim();
+}
+/** 解析 message.content 欄位，處理 string 和 array 兩種格式 */
+export function parseContent(content) {
+    if (content == null) {
+        return { contentText: null, hasToolUse: false, hasToolResult: false, toolNames: [] };
+    }
+    if (typeof content === 'string') {
+        const cleaned = stripSystemXml(content);
+        return { contentText: cleaned || null, hasToolUse: false, hasToolResult: false, toolNames: [] };
+    }
+    if (!Array.isArray(content)) {
+        return { contentText: null, hasToolUse: false, hasToolResult: false, toolNames: [] };
+    }
+    const textParts = [];
+    let hasToolUse = false;
+    let hasToolResult = false;
+    const toolNames = [];
+    for (const block of content) {
+        if (block == null || typeof block !== 'object')
+            continue;
+        const b = block;
+        switch (b.type) {
+            case 'text':
+                if (typeof b.text === 'string') {
+                    const cleaned = stripSystemXml(b.text);
+                    if (cleaned)
+                        textParts.push(cleaned);
+                }
+                break;
+            case 'tool_use':
+                hasToolUse = true;
+                if (typeof b.name === 'string')
+                    toolNames.push(b.name);
+                break;
+            case 'tool_result':
+                hasToolResult = true;
+                break;
+            // thinking, server_tool_use 等 → 跳過
+        }
+    }
+    return {
+        contentText: textParts.length > 0 ? textParts.join('\n') : null,
+        hasToolUse,
+        hasToolResult,
+        toolNames,
+    };
+}
+/** 安全轉換為整數，非數字回傳 null */
+function toInt(v) {
+    return typeof v === 'number' ? Math.floor(v) : null;
+}
+/** 從 message.usage 抽取 token 資料 */
+function parseUsage(message) {
+    const usage = message.usage;
+    if (!usage || typeof usage !== 'object') {
+        return { inputTokens: null, outputTokens: null, cacheReadTokens: null, cacheCreationTokens: null };
+    }
+    const base = toInt(usage.input_tokens) ?? 0;
+    const cacheRead = toInt(usage.cache_read_input_tokens) ?? 0;
+    const cacheCreation = toInt(usage.cache_creation_input_tokens) ?? 0;
+    return {
+        inputTokens: base + cacheRead + cacheCreation,
+        outputTokens: toInt(usage.output_tokens) ?? 0,
+        cacheReadTokens: cacheRead,
+        cacheCreationTokens: cacheCreation,
+    };
+}
+/** 解析單行 JSONL，失敗回傳 null */
+export function parseLine(line) {
+    if (!line.trim())
+        return null;
+    let obj;
+    try {
+        obj = JSON.parse(line);
+    }
+    catch {
+        return null;
+    }
+    if (typeof obj !== 'object' || obj === null)
+        return null;
+    const type = typeof obj.type === 'string' ? obj.type : 'unknown';
+    const rawUuid = typeof obj.uuid === 'string' ? obj.uuid.trim() : null;
+    const uuid = rawUuid && rawUuid.length <= 128 ? rawUuid : null;
+    const parentUuid = typeof obj.parentUuid === 'string' ? obj.parentUuid : null;
+    const sessionId = typeof obj.sessionId === 'string' ? obj.sessionId : null;
+    const timestamp = typeof obj.timestamp === 'string' ? obj.timestamp : null;
+    const rawRequestId = typeof obj.requestId === 'string' ? obj.requestId : null;
+    const requestId = rawRequestId && rawRequestId.length <= 128 ? rawRequestId : null;
+    let role = null;
+    let contentText = null;
+    let contentJson = null;
+    let hasToolUse = false;
+    let hasToolResult = false;
+    let toolNames = [];
+    let inputTokens = null;
+    let outputTokens = null;
+    let cacheReadTokens = null;
+    let cacheCreationTokens = null;
+    let model = null;
+    const message = obj.message;
+    if (message && typeof message === 'object') {
+        if (message.role === 'user' || message.role === 'assistant') {
+            role = message.role;
+        }
+        const result = parseContent(message.content);
+        contentText = result.contentText;
+        hasToolUse = result.hasToolUse;
+        hasToolResult = result.hasToolResult;
+        toolNames = result.toolNames;
+        contentJson = message.content != null ? JSON.stringify(message.content) : null;
+        // Token usage（僅 assistant 訊息有值）
+        const tokenData = parseUsage(message);
+        inputTokens = tokenData.inputTokens;
+        outputTokens = tokenData.outputTokens;
+        cacheReadTokens = tokenData.cacheReadTokens;
+        cacheCreationTokens = tokenData.cacheCreationTokens;
+        model = typeof message.model === 'string' ? message.model : null;
+    }
+    else if (typeof obj.content === 'string') {
+        // queue-operation 等 type 的 prompt 存在頂層 content 欄位
+        const cleaned = stripSystemXml(obj.content);
+        contentText = cleaned || null;
+    }
+    return {
+        type,
+        uuid,
+        parentUuid,
+        sessionId,
+        timestamp,
+        role,
+        contentText,
+        contentJson,
+        hasToolUse,
+        hasToolResult,
+        toolNames,
+        rawJson: line,
+        inputTokens,
+        outputTokens,
+        cacheReadTokens,
+        cacheCreationTokens,
+        model,
+        requestId,
+    };
+}
+const TITLE_MAX_LENGTH = 80;
+/** 解析整個 JSONL 檔案為結構化 session */
+export async function parseSession(filePath, sessionId) {
+    const raw = await readFile(filePath, 'utf-8');
+    const lines = raw.split('\n');
+    const messages = [];
+    let skippedLines = 0;
+    let totalLines = 0;
+    let title = null;
+    let startedAt = null;
+    let endedAt = null;
+    for (const line of lines) {
+        if (!line.trim())
+            continue;
+        totalLines++;
+        const parsed = parseLine(line);
+        if (!parsed) {
+            skippedLines++;
+            continue;
+        }
+        parsed.sessionId ??= sessionId;
+        messages.push(parsed);
+        // 追蹤時間範圍
+        if (parsed.timestamp) {
+            if (!startedAt)
+                startedAt = parsed.timestamp;
+            endedAt = parsed.timestamp;
+        }
+        // Title 推導：queue-operation prompt 優先，其次第一筆 user 訊息
+        if (!title && parsed.contentText) {
+            const isQueuePrompt = parsed.type === 'queue-operation';
+            const isFirstUser = parsed.role === 'user';
+            if (isQueuePrompt || isFirstUser) {
+                title = parsed.contentText.length > TITLE_MAX_LENGTH
+                    ? parsed.contentText.slice(0, TITLE_MAX_LENGTH) + '…'
+                    : parsed.contentText;
+            }
+        }
+    }
+    return {
+        sessionId,
+        title: title ?? sessionId,
+        messages,
+        startedAt,
+        endedAt,
+        skippedLines,
+        totalLines,
+    };
+}
+//# sourceMappingURL=parser.js.map

package/dist/core/parser.js.map

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

package/dist/core/scanner.d.ts

@@ -0,0 +1,8 @@
+import type { ScannedProject, ScannedSubagent } from './types.js';
+/** 將編碼後的資料夾名稱還原為可讀路徑（所有 - 替換為 /） */
+export declare function decodeProjectPath(encoded: string): string;
+/** 掃描 ~/.claude/projects/，回傳所有專案及其 JSONL 檔案 */
+export declare function scanProjects(baseDir?: string): Promise<ScannedProject[]>;
+/** 掃描 session 目錄下的 subagents/*.jsonl，回傳 SubagentFile 清單 */
+export declare function scanSubagents(sessionDir: string, parentSessionId: string): Promise<ScannedSubagent[]>;
+//# sourceMappingURL=scanner.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"scanner.d.ts","sourceRoot":"","sources":["../../src/core/scanner.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,cAAc,EAAkB,eAAe,EAAE,MAAM,YAAY,CAAA;AAIjF,oCAAoC;AACpC,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAEzD;AAED,+CAA+C;AAC/C,wBAAsB,YAAY,CAAC,OAAO,GAAE,MAAyB,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC,CA+DhG;AAED,2DAA2D;AAC3D,wBAAsB,aAAa,CAAC,UAAU,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC,CAmD3G"}

package/dist/core/scanner.js

@@ -0,0 +1,123 @@
+// SPDX-License-Identifier: Apache-2.0
+import { readdir, stat, readFile } from 'node:fs/promises';
+import path from 'node:path';
+import os from 'node:os';
+const DEFAULT_BASE_DIR = path.join(os.homedir(), '.claude', 'projects');
+/** 將編碼後的資料夾名稱還原為可讀路徑（所有 - 替換為 /） */
+export function decodeProjectPath(encoded) {
+    return encoded.replace(/-/g, '/');
+}
+/** 掃描 ~/.claude/projects/，回傳所有專案及其 JSONL 檔案 */
+export async function scanProjects(baseDir = DEFAULT_BASE_DIR) {
+    let entries;
+    try {
+        entries = await readdir(baseDir);
+    }
+    catch {
+        // 目錄不存在或不可讀 → 回傳空陣列
+        return [];
+    }
+    const projects = [];
+    for (const entry of entries) {
+        // 專案目錄以 - 開頭（編碼路徑的首字元 / → -）
+        if (!entry.startsWith('-'))
+            continue;
+        const projectDir = path.join(baseDir, entry);
+        // 確認是目錄
+        let dirStat;
+        try {
+            dirStat = await stat(projectDir);
+        }
+        catch {
+            continue;
+        }
+        if (!dirStat.isDirectory())
+            continue;
+        // 列出根層級 *.jsonl（不遞迴進 subagents/）
+        let files;
+        try {
+            files = await readdir(projectDir);
+        }
+        catch {
+            continue;
+        }
+        const sessions = [];
+        for (const file of files) {
+            if (!file.endsWith('.jsonl'))
+                continue;
+            const filePath = path.join(projectDir, file);
+            let fileStat;
+            try {
+                fileStat = await stat(filePath);
+            }
+            catch {
+                continue;
+            }
+            if (!fileStat.isFile())
+                continue;
+            sessions.push({
+                filePath,
+                fileSize: fileStat.size,
+                fileMtime: fileStat.mtime.toISOString(),
+                sessionId: file.replace(/\.jsonl$/, ''),
+            });
+        }
+        projects.push({
+            projectId: entry,
+            displayName: decodeProjectPath(entry),
+            sessions,
+        });
+    }
+    return projects;
+}
+/** 掃描 session 目錄下的 subagents/*.jsonl，回傳 SubagentFile 清單 */
+export async function scanSubagents(sessionDir, parentSessionId) {
+    const subagentsDir = path.join(sessionDir, 'subagents');
+    let entries;
+    try {
+        entries = await readdir(subagentsDir);
+    }
+    catch {
+        return [];
+    }
+    const results = [];
+    for (const entry of entries) {
+        if (!entry.endsWith('.jsonl'))
+            continue;
+        const filePath = path.join(subagentsDir, entry);
+        let fileStat;
+        try {
+            fileStat = await stat(filePath);
+        }
+        catch {
+            continue;
+        }
+        if (!fileStat.isFile())
+            continue;
+        const bareId = entry.replace(/\.jsonl$/, '');
+        const subagentId = `${parentSessionId}/${bareId}`;
+        // 嘗試讀取對應 meta.json
+        let agentType = null;
+        const metaPath = path.join(subagentsDir, `${bareId}.meta.json`);
+        try {
+            const metaRaw = await readFile(metaPath, 'utf-8');
+            const meta = JSON.parse(metaRaw);
+            if (typeof meta.agentType === 'string') {
+                agentType = meta.agentType;
+            }
+        }
+        catch {
+            // meta.json 不存在或 JSON 格式錯誤 → agentType 為 null
+        }
+        results.push({
+            filePath,
+            fileSize: fileStat.size,
+            fileMtime: fileStat.mtime.toISOString(),
+            subagentId,
+            parentSessionId,
+            agentType,
+        });
+    }
+    return results;
+}
+//# sourceMappingURL=scanner.js.map

package/dist/core/scanner.js.map

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

package/dist/core/summarizer.d.ts

@@ -0,0 +1,12 @@
+import type { ParsedLine, SessionSummary, SessionFileInput } from './types.js';
+/** 摘要引擎版本（每次規則改動時遞增，讓 backfill 可追蹤） */
+export declare const SUMMARY_VERSION = 1;
+/** 計算 active time：累加相鄰 message 間 ≤ 5 分鐘的間隔秒數 */
+export declare function computeActiveTime(messages: ParsedLine[]): number | null;
+export interface SummarizerResult {
+    summary: SessionSummary;
+    sessionFiles: SessionFileInput[];
+}
+/** 為一組 ParsedLine 產生結構化摘要 + session_files */
+export declare function summarizeSession(messages: ParsedLine[], startedAt?: string | null, endedAt?: string | null): SummarizerResult;
+//# sourceMappingURL=summarizer.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"summarizer.d.ts","sourceRoot":"","sources":["../../src/core/summarizer.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,cAAc,EAAgD,gBAAgB,EAAE,MAAM,YAAY,CAAA;AAE5H,uCAAuC;AACvC,eAAO,MAAM,eAAe,IAAI,CAAA;AAqVhC,gDAAgD;AAChD,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,UAAU,EAAE,GAAG,MAAM,GAAG,IAAI,CAiBvE;AAID,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,cAAc,CAAA;IACvB,YAAY,EAAE,gBAAgB,EAAE,CAAA;CACjC;AAED,6CAA6C;AAC7C,wBAAgB,gBAAgB,CAC9B,QAAQ,EAAE,UAAU,EAAE,EACtB,SAAS,GAAE,MAAM,GAAG,IAAW,EAC/B,OAAO,GAAE,MAAM,GAAG,IAAW,GAC5B,gBAAgB,CAkGlB"}