linger-skill 0.2.2

package/dist/memory-events.js

@@ -0,0 +1,109 @@
+import { randomUUID } from "node:crypto";
+import path from "node:path";
+import { assertWritableInside, atomicJson, readJson, withFileLock } from "./io.js";
+import { writeProcessedMarkdown } from "./processed-markdown.js";
+import { assertSafeId, vaultPaths } from "./paths.js";
+import { assertMemoryControlEvent, assertProcessedMemory } from "./schema-validation.js";
+import { assertMemoryControlPath, assertProcessedRecordPath } from "./record-paths.js";
+import { listJsonFiles } from "./vault.js";
+export async function appendMemoryControl(root, input) {
+    const project = assertSafeId(input.project_id, "project id");
+    const target = assertSafeId(input.target_memory_id, "memory id");
+    if (input.kind === "correct" && !input.replacement_memory_id)
+        throw new Error("Correction requires a replacement memory");
+    if (input.kind !== "forget" && !input.evidence_refs.length)
+        throw new Error(`${input.kind} requires evidence`);
+    const p = vaultPaths(root);
+    return await withFileLock(path.join(p.tmp, `${project}.memory-control.lock`), async () => {
+        const event = {
+            schema_version: 1,
+            event_id: `mce_${randomUUID()}`,
+            kind: input.kind,
+            project_id: project,
+            target_memory_id: target,
+            replacement_memory_id: input.replacement_memory_id ? assertSafeId(input.replacement_memory_id, "replacement memory id") : undefined,
+            reason: input.reason?.trim() || undefined,
+            evidence_refs: [...new Set(input.evidence_refs)],
+            timestamp: input.timestamp ?? new Date().toISOString()
+        };
+        assertMemoryControlEvent(event);
+        const eventFile = path.join(p.registry, "memory-events", project, `${event.timestamp.replaceAll(":", "-")}-${event.event_id}.json`);
+        await assertWritableInside(p.root, eventFile);
+        await atomicJson(eventFile, event);
+        return event;
+    });
+}
+export async function effectiveMemoryStates(root, projectId) {
+    const project = assertSafeId(projectId, "project id");
+    const p = vaultPaths(root);
+    const files = await listJsonFiles(path.join(p.registry, "memory-events", project), p.root);
+    const events = (await Promise.all(files.map(async (file) => {
+        try {
+            const value = await readJson(file);
+            assertMemoryControlEvent(value);
+            assertMemoryControlPath(p, file, value);
+            return value;
+        }
+        catch {
+            return undefined;
+        }
+    }))).filter((event) => Boolean(event)).sort((a, b) => a.timestamp.localeCompare(b.timestamp) || a.event_id.localeCompare(b.event_id));
+    const states = new Map();
+    for (const event of events) {
+        const previous = states.get(event.target_memory_id);
+        states.set(event.target_memory_id, {
+            status: event.kind === "forget" ? "revoked" : event.kind === "correct" ? "superseded" : "deleted",
+            replacement_memory_id: event.replacement_memory_id,
+            event_ids: [...(previous?.event_ids ?? []), event.event_id]
+        });
+    }
+    return states;
+}
+export async function correctMemory(root, projectId, targetMemoryId, correction) {
+    if (!correction.summary.trim())
+        throw new Error("Correction summary is required");
+    if (!correction.evidenceRefs.length)
+        throw new Error("Correction requires evidence");
+    const project = assertSafeId(projectId, "project id");
+    const target = assertSafeId(targetMemoryId, "memory id");
+    const p = vaultPaths(root);
+    const oldFile = path.join(p.processed, project, `${target}.json`);
+    await assertWritableInside(p.root, oldFile);
+    const old = await readJson(oldFile);
+    assertProcessedMemory(old);
+    assertProcessedRecordPath(p, oldFile, old);
+    const timestamp = new Date().toISOString();
+    const id = `mem_${randomUUID().replaceAll("-", "")}`;
+    const text = correction.summary.trim();
+    const tags = [...new Set([...(text.toLowerCase().match(/[a-z][a-z0-9_-]{2,}/g) ?? []), ...(text.match(/[\p{Script=Han}]{2,8}/gu) ?? [])])].slice(0, 12);
+    const memory = {
+        ...old,
+        id,
+        project_id: project,
+        type: "correction",
+        title: correction.summary.trim().slice(0, 80),
+        summary: correction.summary.trim(),
+        tags,
+        predictive_tags: tags,
+        retrieval_phrases: tags.map(tag => `关于 ${tag} 的纠正`),
+        source_events: [...new Set(correction.evidenceRefs)],
+        source_hash: undefined,
+        source_savepoint_status: "complete",
+        confidence: correction.source === "agent_inferred" ? 0.8 : 1,
+        source: correction.source ?? "user_explicit",
+        status: "active",
+        supersedes: [target],
+        superseded_by: [],
+        created_at: timestamp,
+        updated_at: timestamp,
+        agent: "linger-correction"
+    };
+    assertProcessedMemory(memory);
+    const memoryFile = path.join(p.processed, project, `${id}.json`);
+    await assertWritableInside(p.root, memoryFile);
+    await atomicJson(memoryFile, memory);
+    await writeProcessedMarkdown(root, memory);
+    const event = await appendMemoryControl(root, { kind: "correct", project_id: project, target_memory_id: target, replacement_memory_id: id, reason: correction.reason, evidence_refs: correction.evidenceRefs });
+    return { memory, event };
+}
+//# sourceMappingURL=memory-events.js.map

package/dist/memory-events.js.map

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

package/dist/memory-intent.d.ts

@@ -0,0 +1 @@
+export declare function isExplicitMemoryRequest(content: string): boolean;

package/dist/memory-intent.js

@@ -0,0 +1,4 @@
+export function isExplicitMemoryRequest(content) {
+    return /(?:记一下|记住|保存这个|remember this)/i.test(content);
+}
+//# sourceMappingURL=memory-intent.js.map

package/dist/memory-intent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory-intent.js","sourceRoot":"","sources":["../src/memory-intent.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,uBAAuB,CAAC,OAAe;IACrD,OAAO,gCAAgC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;AACxD,CAAC"}

package/dist/paths.d.ts

@@ -0,0 +1,15 @@
+export interface VaultPaths {
+    root: string;
+    config: string;
+    projects: string;
+    raw: string;
+    processed: string;
+    enrichments: string;
+    queue: string;
+    tmp: string;
+    registry: string;
+    decisions: string;
+    quarantine: string;
+}
+export declare function vaultPaths(root: string): VaultPaths;
+export declare function assertSafeId(value: string, label: string): string;

package/dist/paths.js

@@ -0,0 +1,24 @@
+import path from "node:path";
+export function vaultPaths(root) {
+    const resolved = path.resolve(root);
+    return {
+        root: resolved,
+        config: path.join(resolved, "config.json"),
+        projects: path.join(resolved, "projects"),
+        raw: path.join(resolved, "raw"),
+        processed: path.join(resolved, "processed"),
+        enrichments: path.join(resolved, "enrichments"),
+        queue: path.join(resolved, "queue"),
+        tmp: path.join(resolved, "tmp"),
+        registry: path.join(resolved, "registry"),
+        decisions: path.join(resolved, "decisions"),
+        quarantine: path.join(resolved, "quarantine")
+    };
+}
+export function assertSafeId(value, label) {
+    if (!/^[a-zA-Z0-9][a-zA-Z0-9._-]{0,127}$/.test(value)) {
+        throw new Error(`Invalid ${label}`);
+    }
+    return value;
+}
+//# sourceMappingURL=paths.js.map

package/dist/paths.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.js","sourceRoot":"","sources":["../src/paths.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,WAAW,CAAC;AAgB7B,MAAM,UAAU,UAAU,CAAC,IAAY;IACrC,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IACpC,OAAO;QACL,IAAI,EAAE,QAAQ;QACd,MAAM,EAAE,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,aAAa,CAAC;QAC1C,QAAQ,EAAE,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,UAAU,CAAC;QACzC,GAAG,EAAE,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,KAAK,CAAC;QAC/B,SAAS,EAAE,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,WAAW,CAAC;QAC3C,WAAW,EAAE,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,aAAa,CAAC;QAC/C,KAAK,EAAE,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,OAAO,CAAC;QACnC,GAAG,EAAE,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,KAAK,CAAC;QAC/B,QAAQ,EAAE,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,UAAU,CAAC;QACzC,SAAS,EAAE,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,WAAW,CAAC;QAC3C,UAAU,EAAE,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,YAAY,CAAC;KAC9C,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,KAAa,EAAE,KAAa;IACvD,IAAI,CAAC,oCAAoC,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;QACtD,MAAM,IAAI,KAAK,CAAC,WAAW,KAAK,EAAE,CAAC,CAAC;IACtC,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/pending.d.ts

@@ -0,0 +1,21 @@
+import type { QueueItem, RawEvent } from "./types.js";
+export interface PendingCapture {
+    schema_version: 1;
+    pending_id: string;
+    event: RawEvent;
+    queue_item: QueueItem;
+    raw_file: string;
+    queue_file: string;
+    sequence_file?: string;
+    sequence_value?: number;
+    created_at: string;
+}
+export declare function stagePending(root: string, pending: PendingCapture): Promise<string>;
+export declare function completePending(file: string): Promise<void>;
+export declare function recoverPending(root: string): Promise<{
+    recovered: number;
+    failed: Array<{
+        file: string;
+        error: string;
+    }>;
+}>;

package/dist/pending.js

@@ -0,0 +1,76 @@
+import { unlink } from "node:fs/promises";
+import path from "node:path";
+import { assertWritableInside, atomicJson, readJson } from "./io.js";
+import { vaultPaths } from "./paths.js";
+import { assertPendingCapture, assertSequenceState } from "./schema-validation.js";
+import { assertPendingRecordPath } from "./record-paths.js";
+import { listJsonFiles } from "./vault.js";
+export async function stagePending(root, pending) {
+    const p = vaultPaths(root);
+    assertPendingCapture(pending);
+    await assertPendingDestinations(p, pending);
+    const file = path.join(p.tmp, "pending", pending.event.project_id, `${pending.pending_id}.json`);
+    await assertWritableInside(p.root, file);
+    await atomicJson(file, pending);
+    return file;
+}
+export async function completePending(file) {
+    await unlink(file).catch(error => { if (error.code !== "ENOENT")
+        throw error; });
+}
+export async function recoverPending(root) {
+    const p = vaultPaths(root);
+    const files = await listJsonFiles(path.join(p.tmp, "pending"), p.root);
+    let recovered = 0;
+    const failed = [];
+    for (const file of files) {
+        try {
+            const pending = await readJson(file);
+            assertPendingCapture(pending);
+            assertPendingRecordPath(p, file, pending);
+            await assertPendingDestinations(p, pending);
+            if (pending.sequence_file) {
+                let current = 0;
+                try {
+                    const state = await readJson(pending.sequence_file);
+                    assertSequenceState(state);
+                    current = state.value;
+                }
+                catch (error) {
+                    if (error.code !== "ENOENT")
+                        throw error;
+                }
+                if ((pending.sequence_value ?? 0) > current)
+                    await atomicJson(pending.sequence_file, { schema_version: 1, value: pending.sequence_value });
+            }
+            await atomicJson(pending.raw_file, pending.event);
+            await atomicJson(pending.queue_file, pending.queue_item);
+            await completePending(file);
+            recovered += 1;
+        }
+        catch (error) {
+            failed.push({ file: path.relative(p.root, file), error: error.message });
+        }
+    }
+    return { recovered, failed };
+}
+async function assertPendingDestinations(p, pending) {
+    const expectedRaw = path.join(p.raw, pending.event.project_id, pending.event.session_id, `${pending.event.event_id}.json`);
+    const expectedQueue = path.join(p.queue, pending.queue_item.project_id, `${pending.queue_item.task_id}.json`);
+    const expectedSequence = path.join(p.registry, `${pending.event.project_id}.sequence.json`);
+    assertSamePath(pending.raw_file, expectedRaw, "raw");
+    assertSamePath(pending.queue_file, expectedQueue, "queue");
+    if (pending.sequence_file)
+        assertSamePath(pending.sequence_file, expectedSequence, "sequence");
+    if (pending.event.raw_ref !== path.relative(p.root, expectedRaw))
+        throw new Error("Pending raw reference mismatch");
+    await assertWritableInside(p.root, expectedRaw);
+    await assertWritableInside(p.root, expectedQueue);
+    if (pending.sequence_file)
+        await assertWritableInside(p.root, expectedSequence);
+}
+function assertSamePath(actual, expected, label) {
+    if (path.resolve(actual) !== path.resolve(expected))
+        throw new Error(`Pending ${label} path mismatch`);
+}
+//# sourceMappingURL=pending.js.map

package/dist/pending.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pending.js","sourceRoot":"","sources":["../src/pending.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAC1C,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,oBAAoB,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AACrE,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AACxC,OAAO,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AACnF,OAAO,EAAE,uBAAuB,EAAE,MAAM,mBAAmB,CAAC;AAC5D,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAe3C,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,IAAY,EAAE,OAAuB;IACtE,MAAM,CAAC,GAAG,UAAU,CAAC,IAAI,CAAC,CAAC;IAC3B,oBAAoB,CAAC,OAAO,CAAC,CAAC;IAC9B,MAAM,yBAAyB,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC;IAC5C,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,EAAE,SAAS,EAAE,OAAO,CAAC,KAAK,CAAC,UAAU,EAAE,GAAG,OAAO,CAAC,UAAU,OAAO,CAAC,CAAC;IACjG,MAAM,oBAAoB,CAAC,CAAC,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;IACzC,MAAM,UAAU,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IAChC,OAAO,IAAI,CAAC;AACd,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,IAAY;IAChD,MAAM,MAAM,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE,GAAG,IAAK,KAA+B,CAAC,IAAI,KAAK,QAAQ;QAAE,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;AAC9G,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,IAAY;IAC/C,MAAM,CAAC,GAAG,UAAU,CAAC,IAAI,CAAC,CAAC;IAC3B,MAAM,KAAK,GAAG,MAAM,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,EAAE,SAAS,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC;IACvE,IAAI,SAAS,GAAG,CAAC,CAAC;IAClB,MAAM,MAAM,GAA2C,EAAE,CAAC;IAC1D,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,MAAM,QAAQ,CAAU,IAAI,CAAC,CAAC;YAC9C,oBAAoB,CAAC,OAAO,CAAC,CAAC;YAC9B,uBAAuB,CAAC,CAAC,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC;YAC1C,MAAM,yBAAyB,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC;YAC5C,IAAI,OAAO,CAAC,aAAa,EAAE,CAAC;gBAC1B,IAAI,OAAO,GAAG,CAAC,CAAC;gBAChB,IAAI,CAAC;oBAAC,MAAM,KAAK,GAAG,MAAM,QAAQ,CAAU,OAAO,CAAC,aAAa,CAAC,CAAC;oBAAC,mBAAmB,CAAC,KAAK,CAAC,CAAC;oBAAC,OAAO,GAAG,KAAK,CAAC,KAAK,CAAC;gBAAC,CAAC;gBAAC,OAAO,KAAK,EAAE,CAAC;oBAAC,IAAK,KAA+B,CAAC,IAAI,KAAK,QAAQ;wBAAE,MAAM,KAAK,CAAC;gBAAC,CAAC;gBAC/M,IAAI,CAAC,OAAO,CAAC,cAAc,IAAI,CAAC,CAAC,GAAG,OAAO;oBAAE,MAAM,UAAU,CAAC,OAAO,CAAC,aAAa,EAAE,EAAE,cAAc,EAAE,CAAC,EAAE,KAAK,EAAE,OAAO,CAAC,cAAc,EAAE,CAAC,CAAC;YAC7I,CAAC;YACD,MAAM,UAAU,CAAC,OAAO,CAAC,QAAQ,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC;YAClD,MAAM,UAAU,CAAC,OAAO,CAAC,UAAU,EAAE,OAAO,CAAC,UAAU,CAAC,CAAC;YACzD,MAAM,eAAe,CAAC,IAAI,CAAC,CAAC;YAC5B,SAAS,IAAI,CAAC,CAAC;QACjB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,EAAE,IAAI,CAAC,EAAE,KAAK,EAAG,KAAe,CAAC,OAAO,EAAE,CAAC,CAAC;QACtF,CAAC;IACH,CAAC;IACD,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,CAAC;AAC/B,CAAC;AAED,KAAK,UAAU,yBAAyB,CAAC,CAAgC,EAAE,OAAuB;IAChG,MAAM,WAAW,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,EAAE,OAAO,CAAC,KAAK,CAAC,UAAU,EAAE,OAAO,CAAC,KAAK,CAAC,UAAU,EAAE,GAAG,OAAO,CAAC,KAAK,CAAC,QAAQ,OAAO,CAAC,CAAC;IAC3H,MAAM,aAAa,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,EAAE,OAAO,CAAC,UAAU,CAAC,UAAU,EAAE,GAAG,OAAO,CAAC,UAAU,CAAC,OAAO,OAAO,CAAC,CAAC;IAC9G,MAAM,gBAAgB,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,QAAQ,EAAE,GAAG,OAAO,CAAC,KAAK,CAAC,UAAU,gBAAgB,CAAC,CAAC;IAC5F,cAAc,CAAC,OAAO,CAAC,QAAQ,EAAE,WAAW,EAAE,KAAK,CAAC,CAAC;IACrD,cAAc,CAAC,OAAO,CAAC,UAAU,EAAE,aAAa,EAAE,OAAO,CAAC,CAAC;IAC3D,IAAI,OAAO,CAAC,aAAa;QAAE,cAAc,CAAC,OAAO,CAAC,aAAa,EAAE,gBAAgB,EAAE,UAAU,CAAC,CAAC;IAC/F,IAAI,OAAO,CAAC,KAAK,CAAC,OAAO,KAAK,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,EAAE,WAAW,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,gCAAgC,CAAC,CAAC;IACpH,MAAM,oBAAoB,CAAC,CAAC,CAAC,IAAI,EAAE,WAAW,CAAC,CAAC;IAChD,MAAM,oBAAoB,CAAC,CAAC,CAAC,IAAI,EAAE,aAAa,CAAC,CAAC;IAClD,IAAI,OAAO,CAAC,aAAa;QAAE,MAAM,oBAAoB,CAAC,CAAC,CAAC,IAAI,EAAE,gBAAgB,CAAC,CAAC;AAClF,CAAC;AAED,SAAS,cAAc,CAAC,MAAc,EAAE,QAAgB,EAAE,KAAa;IACrE,IAAI,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,WAAW,KAAK,gBAAgB,CAAC,CAAC;AACzG,CAAC"}

package/dist/processed-markdown.d.ts

@@ -0,0 +1,3 @@
+import type { ProcessedMemory } from "./types.js";
+export declare function serializeProcessedMarkdown(memory: ProcessedMemory): string;
+export declare function writeProcessedMarkdown(root: string, memory: ProcessedMemory): Promise<string>;

package/dist/processed-markdown.js

@@ -0,0 +1,29 @@
+import path from "node:path";
+import { assertWritableInside, atomicWrite } from "./io.js";
+import { vaultPaths } from "./paths.js";
+import { assertProcessedMemory } from "./schema-validation.js";
+export function serializeProcessedMarkdown(memory) {
+    const frontmatter = {
+        schema_version: memory.schema_version, id: memory.id, type: memory.type, scope: memory.scope, project_id: memory.project_id,
+        tags: memory.tags, predictive_tags: memory.predictive_tags, retrieval_phrases: memory.retrieval_phrases,
+        source_events: memory.source_events, source_hash: memory.source_hash, source_savepoint_status: memory.source_savepoint_status, confidence: memory.confidence, source: memory.source,
+        status: memory.status, sensitivity: memory.sensitivity, supersedes: memory.supersedes, superseded_by: memory.superseded_by,
+        created_at: memory.created_at, updated_at: memory.updated_at, agent: memory.agent, model: memory.model
+    };
+    const lines = ["---"];
+    for (const [key, value] of Object.entries(frontmatter)) {
+        if (value === undefined)
+            continue;
+        lines.push(`${key}: ${JSON.stringify(value)}`);
+    }
+    lines.push("---", "", `# ${memory.title.replaceAll("\n", " ")}`, "", memory.summary, "");
+    return lines.join("\n");
+}
+export async function writeProcessedMarkdown(root, memory) {
+    assertProcessedMemory(memory);
+    const file = path.join(vaultPaths(root).processed, memory.project_id, `${memory.id}.md`);
+    await assertWritableInside(vaultPaths(root).root, file);
+    await atomicWrite(file, serializeProcessedMarkdown(memory));
+    return file;
+}
+//# sourceMappingURL=processed-markdown.js.map

package/dist/processed-markdown.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"processed-markdown.js","sourceRoot":"","sources":["../src/processed-markdown.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,oBAAoB,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAC5D,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AACxC,OAAO,EAAE,qBAAqB,EAAE,MAAM,wBAAwB,CAAC;AAG/D,MAAM,UAAU,0BAA0B,CAAC,MAAuB;IAChE,MAAM,WAAW,GAA4B;QAC3C,cAAc,EAAE,MAAM,CAAC,cAAc,EAAE,EAAE,EAAE,MAAM,CAAC,EAAE,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,UAAU,EAAE,MAAM,CAAC,UAAU;QAC3H,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,eAAe,EAAE,MAAM,CAAC,eAAe,EAAE,iBAAiB,EAAE,MAAM,CAAC,iBAAiB;QACvG,aAAa,EAAE,MAAM,CAAC,aAAa,EAAE,WAAW,EAAE,MAAM,CAAC,WAAW,EAAE,uBAAuB,EAAE,MAAM,CAAC,uBAAuB,EAAE,UAAU,EAAE,MAAM,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM;QACnL,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,EAAE,MAAM,CAAC,WAAW,EAAE,UAAU,EAAE,MAAM,CAAC,UAAU,EAAE,aAAa,EAAE,MAAM,CAAC,aAAa;QAC1H,UAAU,EAAE,MAAM,CAAC,UAAU,EAAE,UAAU,EAAE,MAAM,CAAC,UAAU,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK;KACvG,CAAC;IACF,MAAM,KAAK,GAAG,CAAC,KAAK,CAAC,CAAC;IACtB,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,WAAW,CAAC,EAAE,CAAC;QACvD,IAAI,KAAK,KAAK,SAAS;YAAE,SAAS;QAClC,KAAK,CAAC,IAAI,CAAC,GAAG,GAAG,KAAK,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;IACjD,CAAC;IACD,KAAK,CAAC,IAAI,CAAC,KAAK,EAAE,EAAE,EAAE,KAAK,MAAM,CAAC,KAAK,CAAC,UAAU,CAAC,IAAI,EAAE,GAAG,CAAC,EAAE,EAAE,EAAE,EAAE,MAAM,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;IACzF,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAAC,IAAY,EAAE,MAAuB;IAChF,qBAAqB,CAAC,MAAM,CAAC,CAAC;IAC9B,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,MAAM,CAAC,UAAU,EAAE,GAAG,MAAM,CAAC,EAAE,KAAK,CAAC,CAAC;IACzF,MAAM,oBAAoB,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;IACxD,MAAM,WAAW,CAAC,IAAI,EAAE,0BAA0B,CAAC,MAAM,CAAC,CAAC,CAAC;IAC5D,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/processing-policy.d.ts

@@ -0,0 +1,19 @@
+export interface ProcessingPolicy {
+    threshold_bytes: number;
+    max_wait_ms: number;
+    max_runs_per_hour: number;
+    max_items_per_run: number;
+    max_estimated_tokens_per_run: number;
+    min_content_characters: number;
+}
+export interface ProcessingDecision {
+    should_run: boolean;
+    reason: "explicit" | "startup" | "size_threshold" | "max_wait" | "manual" | "no_pending" | "below_threshold" | "rate_limited";
+    pending_items: number;
+    pending_bytes: number;
+    limit: number;
+    max_estimated_tokens: number;
+}
+export declare const DEFAULT_MIN_CONTENT_CHARACTERS = 20;
+export declare function processingDecision(root: string, projectId: string, trigger: "automatic" | "manual" | "startup", now?: Date, policy?: Partial<ProcessingPolicy>): Promise<ProcessingDecision>;
+export declare function recordProcessingRun(root: string, projectId: string, timestamp?: Date): Promise<void>;

package/dist/processing-policy.js

@@ -0,0 +1,79 @@
+import { stat } from "node:fs/promises";
+import path from "node:path";
+import { assertWritableInside, atomicJson, readJson } from "./io.js";
+import { assertSafeId, vaultPaths } from "./paths.js";
+import { assertQueueRecordPath, assertRawRecordPath } from "./record-paths.js";
+import { assertProcessingRunHistory, assertQueueItem, assertRawEvent } from "./schema-validation.js";
+import { listJsonFiles } from "./vault.js";
+export const DEFAULT_MIN_CONTENT_CHARACTERS = 20;
+const DEFAULT_POLICY = { threshold_bytes: 50 * 1024, max_wait_ms: 30 * 60 * 1000, max_runs_per_hour: 4, max_items_per_run: 100, max_estimated_tokens_per_run: 16_000, min_content_characters: DEFAULT_MIN_CONTENT_CHARACTERS };
+export async function processingDecision(root, projectId, trigger, now = new Date(), policy = {}) {
+    const project = assertSafeId(projectId, "project id");
+    const config = { ...DEFAULT_POLICY, ...policy };
+    const p = vaultPaths(root);
+    const items = [];
+    let bytes = 0;
+    for (const file of await listJsonFiles(path.join(p.queue, project), p.root)) {
+        try {
+            const item = await readJson(file);
+            assertQueueItem(item);
+            assertQueueRecordPath(p, file, item);
+            if (item.status !== "pending" && item.status !== "failed")
+                continue;
+            items.push(item);
+            for (const rawFile of await listJsonFiles(path.join(p.raw, project), p.root)) {
+                try {
+                    const event = await readJson(rawFile);
+                    assertRawEvent(event);
+                    assertRawRecordPath(p, rawFile, event);
+                    if (event.event_id === item.event_id)
+                        bytes += (await stat(rawFile)).size;
+                }
+                catch { /* doctor reports */ }
+            }
+        }
+        catch { /* doctor reports */ }
+    }
+    const base = { pending_items: items.length, pending_bytes: bytes, limit: config.max_items_per_run, max_estimated_tokens: config.max_estimated_tokens_per_run };
+    if (!items.length)
+        return { should_run: false, reason: "no_pending", ...base };
+    if (trigger === "manual")
+        return { should_run: true, reason: "manual", ...base };
+    const historyFile = path.join(p.registry, "processing-runs", `${project}.json`);
+    await assertWritableInside(p.root, historyFile);
+    const history = await readHistory(historyFile);
+    const cutoff = now.getTime() - 60 * 60 * 1000;
+    if (history.filter(value => Date.parse(value) >= cutoff).length >= config.max_runs_per_hour)
+        return { should_run: false, reason: "rate_limited", ...base };
+    if (trigger === "startup")
+        return { should_run: true, reason: "startup", ...base };
+    if (items.some(item => item.priority === "explicit"))
+        return { should_run: true, reason: "explicit", ...base };
+    if (bytes >= config.threshold_bytes)
+        return { should_run: true, reason: "size_threshold", ...base };
+    const oldest = Math.min(...items.map(item => Date.parse(item.created_at)));
+    if (now.getTime() - oldest >= config.max_wait_ms)
+        return { should_run: true, reason: "max_wait", ...base };
+    return { should_run: false, reason: "below_threshold", ...base };
+}
+export async function recordProcessingRun(root, projectId, timestamp = new Date()) {
+    const project = assertSafeId(projectId, "project id");
+    const file = path.join(vaultPaths(root).registry, "processing-runs", `${project}.json`);
+    await assertWritableInside(vaultPaths(root).root, file);
+    const history = await readHistory(file);
+    const cutoff = timestamp.getTime() - 24 * 60 * 60 * 1000;
+    await atomicJson(file, { schema_version: 1, runs: [...history.filter(value => Date.parse(value) >= cutoff), timestamp.toISOString()] });
+}
+async function readHistory(file) {
+    try {
+        const value = await readJson(file);
+        assertProcessingRunHistory(value);
+        return value.runs;
+    }
+    catch (error) {
+        if (error.code === "ENOENT")
+            return [];
+        throw error;
+    }
+}
+//# sourceMappingURL=processing-policy.js.map

package/dist/processing-policy.js.map

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

package/dist/processing.d.ts

@@ -0,0 +1,4 @@
+export declare function processQueue(root: string, projectId?: string, maxItems?: number, maxEstimatedTokens?: number): Promise<{
+    processed: number;
+    failed: number;
+}>;

package/dist/processing.js

@@ -0,0 +1,143 @@
+import path from "node:path";
+import { createHash } from "node:crypto";
+import { decisionFromEvent, decisionKindFromContent } from "./decision-extraction.js";
+import { appendDecision, getDecisionTrail } from "./decisions.js";
+import { assertWritableInside, atomicJson, readJson, withFileLock } from "./io.js";
+import { writeProcessedMarkdown } from "./processed-markdown.js";
+import { DEFAULT_MIN_CONTENT_CHARACTERS } from "./processing-policy.js";
+import { assertSafeId, vaultPaths } from "./paths.js";
+import { assertQueueItem, assertRawEvent } from "./schema-validation.js";
+import { assertQueueRecordPath, assertRawRecordPath } from "./record-paths.js";
+import { rebuildTagRegistry } from "./tag-registry.js";
+import { listJsonFiles } from "./vault.js";
+const STOP = new Set(["the", "and", "for", "that", "this", "with", "have", "from", "我们", "这个", "一下", "可以", "就是"]);
+export async function processQueue(root, projectId, maxItems = Number.POSITIVE_INFINITY, maxEstimatedTokens = Number.POSITIVE_INFINITY) {
+    if (!(maxEstimatedTokens > 0))
+        throw new Error("maxEstimatedTokens must be greater than zero");
+    if (projectId)
+        assertSafeId(projectId, "project id");
+    const p = vaultPaths(root);
+    return await withFileLock(path.join(p.tmp, "processor.lock"), async () => {
+        const queueFiles = (await listJsonFiles(p.queue, p.root)).filter((file) => !projectId || file.includes(`${path.sep}${projectId}${path.sep}`));
+        const items = [];
+        for (const file of queueFiles) {
+            try {
+                const item = await readJson(file);
+                assertQueueItem(item);
+                assertQueueRecordPath(p, file, item);
+                items.push({ file, item });
+            }
+            catch {
+                continue;
+            }
+        }
+        items.sort((a, b) => Number(b.item.priority === "explicit") - Number(a.item.priority === "explicit") || a.item.created_at.localeCompare(b.item.created_at));
+        let processed = 0;
+        let failed = 0;
+        let estimatedTokens = 0;
+        const touchedProjects = new Set();
+        const rawEventsByProject = new Map();
+        for (const entry of items.filter(({ item }) => item.status === "pending" || item.status === "failed").slice(0, maxItems)) {
+            const running = { ...entry.item, status: "processing", attempts: entry.item.attempts + 1, updated_at: new Date().toISOString() };
+            try {
+                let rawEvents = rawEventsByProject.get(running.project_id);
+                if (!rawEvents) {
+                    rawEvents = new Map();
+                    for (const file of await listJsonFiles(path.join(p.raw, running.project_id), p.root)) {
+                        try {
+                            const candidate = await readJson(file);
+                            assertRawEvent(candidate);
+                            assertRawRecordPath(p, file, candidate);
+                            rawEvents.set(candidate.event_id, candidate);
+                        }
+                        catch {
+                            continue;
+                        }
+                    }
+                    rawEventsByProject.set(running.project_id, rawEvents);
+                }
+                const event = rawEvents.get(running.event_id);
+                if (!event)
+                    throw new Error(`Missing raw event ${running.event_id}`);
+                const itemTokens = Math.max(1, Math.ceil(event.content.length / 4));
+                if (processed + failed > 0 && estimatedTokens + itemTokens > maxEstimatedTokens)
+                    break;
+                await atomicJson(entry.file, running);
+                estimatedTokens += itemTokens;
+                if (event.sensitivity === "secret") {
+                    await atomicJson(entry.file, { ...running, status: "done", updated_at: new Date().toISOString() });
+                    processed += 1;
+                    continue;
+                }
+                const memory = memoryFromEvent(event, running.priority === "explicit");
+                if (!memory) {
+                    await atomicJson(entry.file, { ...running, status: "done", updated_at: new Date().toISOString() });
+                    processed += 1;
+                    continue;
+                }
+                const memoryFile = path.join(p.processed, event.project_id, `${memory.id}.json`);
+                await assertWritableInside(p.root, memoryFile);
+                await atomicJson(memoryFile, memory);
+                await writeProcessedMarkdown(root, memory);
+                if (memory.type !== "conversation") {
+                    const decision = decisionFromEvent(event, memory.source === "user_explicit");
+                    if (/(?:当前|现在|目前|current|currently|now)/i.test(event.content)) {
+                        const trail = await getDecisionTrail(root, event.project_id, decision.topic);
+                        if (trail?.view.current_event_id)
+                            decision.supersedes = [trail.view.current_event_id];
+                    }
+                    await appendDecision(root, decision).catch(() => undefined);
+                }
+                touchedProjects.add(event.project_id);
+                await atomicJson(entry.file, { ...running, status: "done", updated_at: new Date().toISOString() });
+                processed += 1;
+            }
+            catch (error) {
+                await atomicJson(entry.file, { ...running, status: "failed", error: error.message, updated_at: new Date().toISOString() });
+                failed += 1;
+            }
+        }
+        for (const project of touchedProjects)
+            await rebuildTagRegistry(root, project).catch(() => undefined);
+        return { processed, failed };
+    });
+}
+function memoryFromEvent(event, explicit) {
+    const clean = event.content.replace(/\s+/g, " ").trim();
+    const decisionKind = decisionKindFromContent(clean);
+    const durableSignal = Boolean(decisionKind) || /(?:记住|remember)/i.test(clean);
+    if (event.role === "assistant" && !explicit && clean.length < DEFAULT_MIN_CONTENT_CHARACTERS && !durableSignal)
+        return undefined;
+    const tags = keywords(clean);
+    const id = `mem_${createHash("sha256").update(event.event_id).digest("hex").slice(0, 24)}`;
+    return {
+        schema_version: 1,
+        id,
+        type: decisionKind ?? "conversation",
+        scope: "project",
+        project_id: event.project_id,
+        title: clean.slice(0, 80),
+        summary: clean.slice(0, 1000),
+        tags,
+        predictive_tags: tags,
+        retrieval_phrases: tags.map(tag => `关于 ${tag} 的讨论`),
+        source_events: [event.event_id],
+        source_hash: event.content_hash,
+        source_savepoint_status: event.savepoint_status,
+        confidence: explicit ? 1 : 0.65,
+        source: explicit ? "user_explicit" : "agent_inferred",
+        status: "active",
+        sensitivity: event.sensitivity === "sensitive" ? "sensitive" : "normal",
+        supersedes: [],
+        superseded_by: [],
+        created_at: event.timestamp,
+        updated_at: event.timestamp,
+        agent: "linger-deterministic-processor"
+    };
+}
+function keywords(text) {
+    const latin = text.toLowerCase().match(/[a-z][a-z0-9_-]{2,}/g) ?? [];
+    const cjk = text.match(/[\p{Script=Han}]{2,8}/gu) ?? [];
+    return [...new Set([...latin, ...cjk].filter(token => !STOP.has(token)))].slice(0, 12);
+}
+//# sourceMappingURL=processing.js.map

package/dist/processing.js.map

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

package/dist/purge.d.ts

@@ -0,0 +1,7 @@
+export declare function purge(home: string, confirmation: {
+    yes: boolean;
+    phrase: string;
+}): Promise<{
+    purged: true;
+    root: string;
+}>;

package/dist/purge.js

@@ -0,0 +1,16 @@
+import { rm } from "node:fs/promises";
+import path from "node:path";
+import { uninstall } from "./installer.js";
+export async function purge(home, confirmation) {
+    if (!confirmation.yes || confirmation.phrase !== "PURGE")
+        throw new Error("Purge requires --yes and --confirm PURGE");
+    const resolvedHome = path.resolve(home);
+    const root = path.join(resolvedHome, ".linger");
+    const relative = path.relative(resolvedHome, root);
+    if (relative !== ".linger")
+        throw new Error("Unsafe purge target");
+    await uninstall(resolvedHome);
+    await rm(root, { recursive: true, force: true });
+    return { purged: true, root };
+}
+//# sourceMappingURL=purge.js.map