linger-skill 0.2.2

package/dist/purge.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"purge.js","sourceRoot":"","sources":["../src/purge.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,EAAE,EAAE,MAAM,kBAAkB,CAAC;AACtC,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAE3C,MAAM,CAAC,KAAK,UAAU,KAAK,CAAC,IAAY,EAAE,YAA8C;IACtF,IAAI,CAAC,YAAY,CAAC,GAAG,IAAI,YAAY,CAAC,MAAM,KAAK,OAAO;QAAE,MAAM,IAAI,KAAK,CAAC,0CAA0C,CAAC,CAAC;IACtH,MAAM,YAAY,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IACxC,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,SAAS,CAAC,CAAC;IAChD,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC,YAAY,EAAE,IAAI,CAAC,CAAC;IACnD,IAAI,QAAQ,KAAK,SAAS;QAAE,MAAM,IAAI,KAAK,CAAC,qBAAqB,CAAC,CAAC;IACnE,MAAM,SAAS,CAAC,YAAY,CAAC,CAAC;IAC9B,MAAM,EAAE,CAAC,IAAI,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;IACjD,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;AAChC,CAAC"}

package/dist/recall-sampling.d.ts

@@ -0,0 +1,53 @@
+import type { RecallPackage } from "./recall.js";
+export type RecallFeedbackOutcome = "useful" | "partial" | "wrong" | "missed";
+export type RawLocated = "yes" | "no" | "unknown";
+export interface RecallAttempt {
+    schema_version: 1;
+    attempt_id: string;
+    project_id: string;
+    query: string;
+    query_sensitivity: "normal" | "sensitive" | "secret";
+    classification: RecallPackage["classification"];
+    hit_sources: string[];
+    raw_refs: string[];
+    decision_topic?: string;
+    created_at: string;
+}
+export interface RecallFeedback {
+    schema_version: 1;
+    feedback_id: string;
+    attempt_id: string;
+    project_id: string;
+    outcome: RecallFeedbackOutcome;
+    raw_located: RawLocated;
+    decision_trail_used: boolean;
+    note?: string;
+    created_at: string;
+}
+export declare function recordRecallAttempt(root: string, input: {
+    projectId: string;
+    query: string;
+    result: RecallPackage;
+}, now?: Date): Promise<RecallAttempt>;
+export declare function recordRecallFeedback(root: string, input: {
+    projectId: string;
+    attemptId: string;
+    outcome: RecallFeedbackOutcome;
+    rawLocated?: RawLocated;
+    decisionTrailUsed?: boolean;
+    note?: string;
+}, now?: Date): Promise<RecallFeedback>;
+export declare function recallSamplingReport(root: string, projectId: string): Promise<{
+    project_id: string;
+    total_attempts: number;
+    unresolved_attempts: number;
+    classifications: Record<string, number>;
+    outcomes: Record<string, number>;
+    raw_located_yes: number;
+    decision_trail_used: number;
+}>;
+export declare function assertRecallAttempt(value: unknown): asserts value is RecallAttempt;
+export declare function assertRecallFeedback(value: unknown): asserts value is RecallFeedback;
+export declare function assertRecallAttemptPath(root: string, file: string, attempt: RecallAttempt): void;
+export declare function assertRecallFeedbackPath(root: string, file: string, feedback: RecallFeedback): void;
+export declare function assertRecallSampleRecord(root: string, file: string, value: unknown): void;

package/dist/recall-sampling.js

@@ -0,0 +1,201 @@
+import { randomUUID } from "node:crypto";
+import { readdir } from "node:fs/promises";
+import path from "node:path";
+import { assertReadableInside, assertWritableInside, atomicJson, readJson } from "./io.js";
+import { assertSafeId, vaultPaths } from "./paths.js";
+import { classifySensitivity, redactSecrets } from "./sensitivity.js";
+export async function recordRecallAttempt(root, input, now = new Date()) {
+    const project = assertSafeId(input.projectId, "project id");
+    const detected = classifySensitivity(input.query);
+    const attempt = {
+        schema_version: 1,
+        attempt_id: `ra_${randomUUID().replaceAll("-", "")}`,
+        project_id: project,
+        query: detected.level === "secret" ? redactSecrets(input.query) : input.query,
+        query_sensitivity: detected.level,
+        classification: input.result.classification,
+        hit_sources: [...new Set(input.result.hits.map(hit => hit.source))],
+        raw_refs: [...new Set(input.result.hits.flatMap(hit => hit.raw_ref))],
+        ...(input.result.decision_topic ? { decision_topic: input.result.decision_topic } : {}),
+        created_at: now.toISOString()
+    };
+    const file = path.join(sampleRoot(root, project), "attempts", `${attempt.attempt_id}.json`);
+    await assertWritableInside(root, file);
+    await atomicJson(file, attempt);
+    return attempt;
+}
+export async function recordRecallFeedback(root, input, now = new Date()) {
+    const project = assertSafeId(input.projectId, "project id");
+    const attemptId = assertSafeId(input.attemptId, "recall attempt id");
+    if (!["useful", "partial", "wrong", "missed"].includes(input.outcome))
+        throw new Error("Invalid recall feedback outcome");
+    const rawLocated = input.rawLocated ?? "unknown";
+    if (!["yes", "no", "unknown"].includes(rawLocated))
+        throw new Error("Invalid raw-located value");
+    if (input.note && input.note.length > 2000)
+        throw new Error("Recall feedback note is too long");
+    const attemptFile = path.join(sampleRoot(root, project), "attempts", `${attemptId}.json`);
+    await assertReadableInside(root, attemptFile);
+    const attempt = await readJson(attemptFile);
+    assertRecallAttempt(attempt);
+    assertRecallAttemptPath(root, attemptFile, attempt);
+    if (attempt.attempt_id !== attemptId || attempt.project_id !== project)
+        throw new Error("Invalid recall attempt");
+    const noteSensitivity = input.note ? classifySensitivity(input.note) : undefined;
+    const note = input.note && noteSensitivity?.level === "secret" ? redactSecrets(input.note) : input.note;
+    const feedback = {
+        schema_version: 1,
+        feedback_id: `rf_${randomUUID().replaceAll("-", "")}`,
+        attempt_id: attemptId,
+        project_id: project,
+        outcome: input.outcome,
+        raw_located: rawLocated,
+        decision_trail_used: input.decisionTrailUsed ?? false,
+        ...(note ? { note } : {}),
+        created_at: now.toISOString()
+    };
+    const file = path.join(sampleRoot(root, project), "feedback", attemptId, `${feedback.feedback_id}.json`);
+    await assertWritableInside(root, file);
+    await atomicJson(file, feedback);
+    return feedback;
+}
+export async function recallSamplingReport(root, projectId) {
+    const project = assertSafeId(projectId, "project id");
+    const base = sampleRoot(root, project);
+    const attempts = await readAttempts(root, path.join(base, "attempts"));
+    const feedback = await readFeedback(root, path.join(base, "feedback"));
+    if (attempts.some(item => item.project_id !== project) || feedback.some(item => item.project_id !== project))
+        throw new Error("Recall sampling project mismatch");
+    const attemptIds = new Set(attempts.map(item => item.attempt_id));
+    if (feedback.some(item => !attemptIds.has(item.attempt_id)))
+        throw new Error("Recall feedback references a missing attempt");
+    const latest = new Map();
+    for (const item of feedback.sort((a, b) => a.created_at.localeCompare(b.created_at)))
+        latest.set(item.attempt_id, item);
+    return {
+        project_id: project,
+        total_attempts: attempts.length,
+        unresolved_attempts: attempts.filter(attempt => !latest.has(attempt.attempt_id)).length,
+        classifications: counts(attempts.map(attempt => attempt.classification)),
+        outcomes: counts([...latest.values()].map(item => item.outcome)),
+        raw_located_yes: [...latest.values()].filter(item => item.raw_located === "yes").length,
+        decision_trail_used: [...latest.values()].filter(item => item.decision_trail_used).length
+    };
+}
+function sampleRoot(root, project) {
+    return path.join(vaultPaths(root).registry, "recall-samples", project);
+}
+async function readAttempts(root, dir) {
+    try {
+        await assertReadableInside(root, dir);
+        const names = (await readdir(dir)).filter(name => name.endsWith(".json")).sort();
+        return await Promise.all(names.map(async (name) => {
+            const file = path.join(dir, name);
+            await assertReadableInside(root, file);
+            const attempt = await readJson(file);
+            assertRecallAttempt(attempt);
+            assertRecallAttemptPath(root, file, attempt);
+            return attempt;
+        }));
+    }
+    catch (error) {
+        if (error.code === "ENOENT")
+            return [];
+        throw error;
+    }
+}
+async function readFeedback(root, dir) {
+    try {
+        await assertReadableInside(root, dir);
+        const attempts = await readdir(dir, { withFileTypes: true });
+        const result = [];
+        for (const attempt of attempts.filter(item => item.isDirectory()).sort((a, b) => a.name.localeCompare(b.name))) {
+            const attemptDir = path.join(dir, attempt.name);
+            await assertReadableInside(root, attemptDir);
+            const names = (await readdir(attemptDir)).filter(name => name.endsWith(".json")).sort();
+            for (const name of names) {
+                const file = path.join(attemptDir, name);
+                await assertReadableInside(root, file);
+                const item = await readJson(file);
+                assertRecallFeedback(item);
+                assertRecallFeedbackPath(root, file, item);
+                result.push(item);
+            }
+        }
+        return result;
+    }
+    catch (error) {
+        if (error.code === "ENOENT")
+            return [];
+        throw error;
+    }
+}
+function counts(values) {
+    const result = {};
+    for (const value of values)
+        result[value] = (result[value] ?? 0) + 1;
+    return result;
+}
+export function assertRecallAttempt(value) {
+    if (!value || typeof value !== "object" || Array.isArray(value))
+        throw new Error("Invalid recall attempt");
+    const item = value;
+    if (item.schema_version !== 1 || typeof item.attempt_id !== "string" || typeof item.project_id !== "string" || typeof item.query !== "string" || typeof item.created_at !== "string")
+        throw new Error("Invalid recall attempt");
+    assertSafeId(item.attempt_id, "recall attempt id");
+    assertSafeId(item.project_id, "project id");
+    assertIsoTimestamp(item.created_at, "recall attempt timestamp");
+    if (!["normal", "sensitive", "secret"].includes(item.query_sensitivity))
+        throw new Error("Invalid recall attempt sensitivity");
+    if (!["exact_record_found", "similar_record_found", "possible_match", "no_reliable_memory_found", "conflicting_memories_found", "unprocessed_raw_match"].includes(item.classification))
+        throw new Error("Invalid recall attempt classification");
+    if (!Array.isArray(item.hit_sources) || !item.hit_sources.every(value => typeof value === "string") || !Array.isArray(item.raw_refs) || !item.raw_refs.every(value => typeof value === "string"))
+        throw new Error("Invalid recall attempt references");
+    if (item.decision_topic !== undefined && typeof item.decision_topic !== "string")
+        throw new Error("Invalid recall attempt decision topic");
+}
+export function assertRecallFeedback(value) {
+    if (!value || typeof value !== "object" || Array.isArray(value))
+        throw new Error("Invalid recall feedback");
+    const item = value;
+    if (item.schema_version !== 1 || typeof item.feedback_id !== "string" || typeof item.attempt_id !== "string" || typeof item.project_id !== "string" || typeof item.created_at !== "string")
+        throw new Error("Invalid recall feedback");
+    assertSafeId(item.feedback_id, "recall feedback id");
+    assertSafeId(item.attempt_id, "recall attempt id");
+    assertSafeId(item.project_id, "project id");
+    assertIsoTimestamp(item.created_at, "recall feedback timestamp");
+    if (!["useful", "partial", "wrong", "missed"].includes(item.outcome) || !["yes", "no", "unknown"].includes(item.raw_located) || typeof item.decision_trail_used !== "boolean")
+        throw new Error("Invalid recall feedback values");
+    if (item.note !== undefined && (typeof item.note !== "string" || item.note.length > 2000))
+        throw new Error("Invalid recall feedback note");
+}
+export function assertRecallAttemptPath(root, file, attempt) {
+    const expected = path.join(sampleRoot(root, attempt.project_id), "attempts", `${attempt.attempt_id}.json`);
+    if (path.resolve(file) !== path.resolve(expected))
+        throw new Error("Invalid recall attempt path");
+}
+export function assertRecallFeedbackPath(root, file, feedback) {
+    const expected = path.join(sampleRoot(root, feedback.project_id), "feedback", feedback.attempt_id, `${feedback.feedback_id}.json`);
+    if (path.resolve(file) !== path.resolve(expected))
+        throw new Error("Invalid recall feedback path");
+}
+export function assertRecallSampleRecord(root, file, value) {
+    const relative = path.relative(path.join(vaultPaths(root).registry, "recall-samples"), file);
+    const parts = relative.split(path.sep);
+    if (parts.length === 3 && parts[1] === "attempts") {
+        assertRecallAttempt(value);
+        assertRecallAttemptPath(root, file, value);
+        return;
+    }
+    if (parts.length === 4 && parts[1] === "feedback") {
+        assertRecallFeedback(value);
+        assertRecallFeedbackPath(root, file, value);
+        return;
+    }
+    throw new Error("Invalid recall sample path");
+}
+function assertIsoTimestamp(value, label) {
+    if (typeof value !== "string" || !/^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}(?:\.\d{1,9})?(?:Z|[+-]\d{2}:\d{2})$/.test(value) || !Number.isFinite(Date.parse(value)))
+        throw new Error(`Invalid ${label}`);
+}
+//# sourceMappingURL=recall-sampling.js.map

package/dist/recall-sampling.js.map

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

package/dist/recall.d.ts

@@ -0,0 +1,19 @@
+import { type SearchOptions } from "./search.js";
+import type { SearchHit } from "./types.js";
+export interface RecallPackage {
+    classification: "exact_record_found" | "similar_record_found" | "possible_match" | "no_reliable_memory_found" | "conflicting_memories_found" | "unprocessed_raw_match";
+    hits: SearchHit[];
+    candidates: {
+        topics: string[];
+        decisions: string[];
+        tags: string[];
+        time_ranges: string[];
+    };
+    truncated: boolean;
+    total_characters: number;
+    current_state?: string;
+    decision_topic?: string;
+}
+export declare function recall(root: string, options: SearchOptions & {
+    maxCharacters?: number;
+}): Promise<RecallPackage>;

package/dist/recall.js

@@ -0,0 +1,70 @@
+import { listDecisionViews } from "./decisions.js";
+import { search } from "./search.js";
+import { readTagRegistry } from "./tag-registry.js";
+export async function recall(root, options) {
+    let found = await search(root, options);
+    if (/(?:为什么|原因|理由|why|reason)/i.test(options.query)) {
+        const rationale = found.filter(hit => /(?:因为|由于|\b因|because|reason|cost|complexity|constraint)/i.test(hit.snippet));
+        if (rationale.length)
+            found = rationale;
+    }
+    const decisions = await listDecisionViews(root, options.projectId);
+    const initialEvidence = new Set(found.flatMap(hit => hit.raw_ref));
+    const evidenceRank = new Map();
+    found.forEach((hit, index) => hit.raw_ref.forEach(event => evidenceRank.set(event, Math.min(evidenceRank.get(event) ?? Number.POSITIVE_INFINITY, index))));
+    const decisionRank = (sourceEvents) => Math.min(...sourceEvents.map(event => evidenceRank.get(event) ?? Number.POSITIVE_INFINITY));
+    const matchedDecision = decisions
+        .filter(view => view.source_events.some(event => initialEvidence.has(event)))
+        .sort((a, b) => decisionRank(a.source_events) - decisionRank(b.source_events) || b.updated_at.localeCompare(a.updated_at))[0];
+    const asksForCurrent = /(?:当前|现在|目前|current|currently|now)/i.test(options.query);
+    const asksForRationale = /(?:为什么|原因|理由|why|reason)/i.test(options.query);
+    if (matchedDecision?.current_evidence_refs?.length && (asksForCurrent || asksForRationale)) {
+        const currentEvidence = new Set(matchedDecision.current_evidence_refs);
+        const currentHits = found.filter(hit => hit.raw_ref.some(event => currentEvidence.has(event)));
+        if (currentHits.length)
+            found = currentHits;
+    }
+    const max = options.maxCharacters ?? 12000;
+    const hits = [];
+    let characters = 0;
+    let truncated = false;
+    for (const hit of found) {
+        const remaining = max - characters;
+        if (remaining <= 0) {
+            truncated = true;
+            break;
+        }
+        const snippet = hit.snippet.slice(0, remaining);
+        hits.push({ ...hit, snippet });
+        characters += snippet.length;
+        if (snippet.length < hit.snippet.length) {
+            truncated = true;
+            break;
+        }
+    }
+    const registry = await readTagRegistry(root, options.projectId).catch(() => undefined);
+    const classification = classify(hits, Boolean(matchedDecision?.conflicts.length));
+    return {
+        classification, hits, truncated, total_characters: characters, current_state: matchedDecision?.current_state, decision_topic: matchedDecision?.topic,
+        candidates: hits.length ? { topics: [], decisions: [], tags: [], time_ranges: [] } : {
+            topics: decisions.map(view => view.topic).slice(0, 5),
+            decisions: decisions.map(view => view.current_state).filter((value) => Boolean(value)).slice(0, 5),
+            tags: (registry?.entries ?? []).slice(0, 8).map(entry => entry.normalized_tag),
+            time_ranges: [...new Set((registry?.entries ?? []).map(entry => entry.last_used.slice(0, 7)).filter(value => /^\d{4}-\d{2}$/.test(value)))].sort().reverse().slice(0, 5)
+        }
+    };
+}
+function classify(hits, conflicting) {
+    if (!hits.length)
+        return "no_reliable_memory_found";
+    if (conflicting)
+        return "conflicting_memories_found";
+    if (hits.some(hit => hit.match_type === "exact_record"))
+        return "exact_record_found";
+    if (hits.some(hit => hit.match_type === "similar_record"))
+        return "similar_record_found";
+    if (hits.every(hit => hit.match_type === "unprocessed_raw"))
+        return "unprocessed_raw_match";
+    return "possible_match";
+}
+//# sourceMappingURL=recall.js.map

package/dist/recall.js.map

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

package/dist/record-paths.d.ts

@@ -0,0 +1,18 @@
+import type { VaultPaths } from "./paths.js";
+import type { DecisionEvent, DecisionView } from "./decisions.js";
+import type { MemoryControlEvent } from "./memory-events.js";
+import type { PendingCapture } from "./pending.js";
+import type { TagRegistry } from "./tag-registry.js";
+import type { TermRelation } from "./term-graph.js";
+import type { ProcessedMemory, QueueItem, RawEvent } from "./types.js";
+import type { ProjectRecord } from "./vault.js";
+export declare function assertRawRecordPath(paths: VaultPaths, file: string, event: RawEvent): void;
+export declare function assertQueueRecordPath(paths: VaultPaths, file: string, item: QueueItem): void;
+export declare function assertProcessedRecordPath(paths: VaultPaths, file: string, memory: ProcessedMemory): void;
+export declare function assertPendingRecordPath(paths: VaultPaths, file: string, pending: PendingCapture): void;
+export declare function assertDecisionEventPath(paths: VaultPaths, file: string, event: DecisionEvent): void;
+export declare function assertDecisionViewPath(paths: VaultPaths, file: string, view: DecisionView): void;
+export declare function assertMemoryControlPath(paths: VaultPaths, file: string, event: MemoryControlEvent): void;
+export declare function assertTermRelationPath(paths: VaultPaths, file: string, relation: TermRelation): void;
+export declare function assertTagRegistryPath(paths: VaultPaths, file: string, registry: TagRegistry): void;
+export declare function assertProjectRecordPath(paths: VaultPaths, file: string, project: ProjectRecord): void;

package/dist/record-paths.js

@@ -0,0 +1,38 @@
+import path from "node:path";
+export function assertRawRecordPath(paths, file, event) {
+    assertCanonicalPath(file, path.join(paths.raw, event.project_id, event.session_id, `${event.event_id}.json`), "raw record");
+    if (event.raw_ref !== path.relative(paths.root, file))
+        throw new Error("Invalid raw record reference");
+}
+export function assertQueueRecordPath(paths, file, item) {
+    assertCanonicalPath(file, path.join(paths.queue, item.project_id, `${item.task_id}.json`), "queue record");
+}
+export function assertProcessedRecordPath(paths, file, memory) {
+    assertCanonicalPath(file, path.join(paths.processed, memory.project_id, `${memory.id}.json`), "processed record");
+}
+export function assertPendingRecordPath(paths, file, pending) {
+    assertCanonicalPath(file, path.join(paths.tmp, "pending", pending.event.project_id, `${pending.pending_id}.json`), "pending record");
+}
+export function assertDecisionEventPath(paths, file, event) {
+    assertCanonicalPath(file, path.join(paths.decisions, event.project_id, event.canonical_id, "events", `${event.timestamp.replaceAll(":", "-")}-${event.event_id}.json`), "decision event");
+}
+export function assertDecisionViewPath(paths, file, view) {
+    assertCanonicalPath(file, path.join(paths.decisions, view.project_id, view.canonical_id, "current.json"), "decision view");
+}
+export function assertMemoryControlPath(paths, file, event) {
+    assertCanonicalPath(file, path.join(paths.registry, "memory-events", event.project_id, `${event.timestamp.replaceAll(":", "-")}-${event.event_id}.json`), "memory control record");
+}
+export function assertTermRelationPath(paths, file, relation) {
+    assertCanonicalPath(file, path.join(paths.registry, "term-graph", relation.project_id, `${relation.relation_id}.json`), "term relation record");
+}
+export function assertTagRegistryPath(paths, file, registry) {
+    assertCanonicalPath(file, path.join(paths.registry, "tags", `${registry.project_id}.json`), "tag registry record");
+}
+export function assertProjectRecordPath(paths, file, project) {
+    assertCanonicalPath(file, path.join(paths.projects, `${project.project_id}.json`), "project record");
+}
+function assertCanonicalPath(actual, expected, label) {
+    if (path.resolve(actual) !== path.resolve(expected))
+        throw new Error(`Invalid ${label} path`);
+}
+//# sourceMappingURL=record-paths.js.map

package/dist/record-paths.js.map

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

package/dist/repair.d.ts

@@ -0,0 +1,4 @@
+export declare function quarantineInvalidFiles(root: string): Promise<{
+    quarantined: string[];
+    skipped: string[];
+}>;

package/dist/repair.js

@@ -0,0 +1,83 @@
+import { rename } from "node:fs/promises";
+import path from "node:path";
+import { assertReadableInside, assertWritableInside, readJson } from "./io.js";
+import { assertCodexAdapterEvidence, assertCodexAdapterEvidencePath } from "./adapter-evidence.js";
+import { assertEnrichmentBatchPath, assertEnrichmentBatchRecord, assertEnrichmentOverlay, assertEnrichmentOverlayPath } from "./enrichment.js";
+import { vaultPaths } from "./paths.js";
+import { assertRecallSampleRecord } from "./recall-sampling.js";
+import { assertDecisionEvent, assertDecisionView, assertMemoryControlEvent, assertPendingCapture, assertProcessedMemory, assertProcessingRunHistory, assertProjectRecord, assertQueueItem, assertRawEvent, assertSequenceState, assertTagRegistry, assertTermRelation, assertVaultConfig } from "./schema-validation.js";
+import { assertDecisionEventPath, assertDecisionViewPath, assertMemoryControlPath, assertPendingRecordPath, assertProcessedRecordPath, assertProjectRecordPath, assertQueueRecordPath, assertRawRecordPath, assertTagRegistryPath, assertTermRelationPath } from "./record-paths.js";
+import { listVaultJsonCandidates } from "./vault-candidates.js";
+export async function quarantineInvalidFiles(root) {
+    const p = vaultPaths(root);
+    const quarantined = [];
+    const skipped = [];
+    try {
+        await assertReadableInside(p.root, p.config);
+        const value = await readJson(p.config);
+        assertVaultConfig(value);
+    }
+    catch (error) {
+        if (error.code !== "ENOENT")
+            await quarantineFile(p, "vault-config", p.root, p.config, quarantined, skipped);
+    }
+    const groups = [
+        { dir: p.raw, kind: "raw", read: async (file) => { const value = await readJson(file); assertRawEvent(value); assertRawRecordPath(p, file, value); } },
+        { dir: p.processed, kind: "processed", read: async (file) => { const value = await readJson(file); assertProcessedMemory(value); assertProcessedRecordPath(p, file, value); } },
+        { dir: p.enrichments, kind: "enrichment", read: async (file) => { const value = await readJson(file); assertEnrichmentOverlay(value); assertEnrichmentOverlayPath(p.root, file, value); } },
+        { dir: p.queue, kind: "queue", read: async (file) => { const value = await readJson(file); assertQueueItem(value); assertQueueRecordPath(p, file, value); } },
+        { dir: path.join(p.tmp, "pending"), kind: "pending", read: async (file) => { const value = await readJson(file); assertPendingCapture(value); assertPendingRecordPath(p, file, value); } },
+        { dir: p.decisions, kind: "decision", read: async (file) => { const value = await readJson(file); if (path.basename(file) === "current.json") {
+                assertDecisionView(value);
+                assertDecisionViewPath(p, file, value);
+            }
+            else {
+                assertDecisionEvent(value);
+                assertDecisionEventPath(p, file, value);
+            } } },
+        { dir: path.join(p.registry, "tags"), kind: "tag-registry", read: async (file) => { const value = await readJson(file); assertTagRegistry(value); assertTagRegistryPath(p, file, value); } },
+        { dir: path.join(p.registry, "memory-events"), kind: "memory-control", read: async (file) => { const value = await readJson(file); assertMemoryControlEvent(value); assertMemoryControlPath(p, file, value); } },
+        { dir: path.join(p.registry, "term-graph"), kind: "term-relation", read: async (file) => { const value = await readJson(file); assertTermRelation(value); assertTermRelationPath(p, file, value); } },
+        { dir: p.projects, kind: "project-record", read: async (file) => { const value = await readJson(file); assertProjectRecord(value); assertProjectRecordPath(p, file, value); } },
+        { dir: path.join(p.registry, "processing-runs"), kind: "processing-history", read: async (file) => { const value = await readJson(file); assertProcessingRunHistory(value); } },
+        { dir: path.join(p.registry, "adapter-evidence"), kind: "adapter-evidence", read: async (file) => { const value = await readJson(file); assertCodexAdapterEvidence(value); assertCodexAdapterEvidencePath(p.root, file); } },
+        { dir: path.join(p.registry, "recall-samples"), kind: "recall-sample", read: async (file) => { assertRecallSampleRecord(p.root, file, await readJson(file)); } },
+        { dir: path.join(p.registry, "enrichment-batches"), kind: "enrichment-batch", read: async (file) => { const value = await readJson(file); assertEnrichmentBatchRecord(value); assertEnrichmentBatchPath(p.root, file, value); } }
+    ];
+    for (const group of groups) {
+        for (const file of await listVaultJsonCandidates(group.dir, p.root)) {
+            try {
+                await assertReadableInside(p.root, file);
+                await group.read(file);
+            }
+            catch {
+                await quarantineFile(p, group.kind, p.root, file, quarantined, skipped);
+            }
+        }
+    }
+    for (const file of (await listVaultJsonCandidates(p.registry, p.root)).filter(file => path.dirname(file) === p.registry && file.endsWith(".sequence.json"))) {
+        try {
+            await assertReadableInside(p.root, file);
+            const value = await readJson(file);
+            assertSequenceState(value);
+        }
+        catch {
+            await quarantineFile(p, "sequence", p.root, file, quarantined, skipped);
+        }
+    }
+    return { quarantined, skipped };
+}
+async function quarantineFile(p, kind, base, file, quarantined, skipped) {
+    const relative = path.relative(base, file);
+    if (relative.startsWith("..") || path.isAbsolute(relative)) {
+        skipped.push(file);
+        return;
+    }
+    const destination = path.join(p.quarantine, kind, `${Date.now()}-${relative}`);
+    await assertWritableInside(p.root, destination);
+    const { ensureDir } = await import("./io.js");
+    await ensureDir(path.dirname(destination));
+    await rename(file, destination);
+    quarantined.push(path.relative(p.root, destination));
+}
+//# sourceMappingURL=repair.js.map

package/dist/repair.js.map

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

package/dist/runtime-identity.d.ts

@@ -0,0 +1 @@
+export declare function runtimeFingerprint(packageRoot: string, node: string): Promise<string>;

package/dist/runtime-identity.js

@@ -0,0 +1,31 @@
+import { createHash } from "node:crypto";
+import { readFile, readdir } from "node:fs/promises";
+import path from "node:path";
+import { assertReadableInside } from "./io.js";
+export async function runtimeFingerprint(packageRoot, node) {
+    const root = path.resolve(packageRoot);
+    await assertReadableInside(root, path.join(root, "dist"));
+    const files = await runtimeFiles(path.join(root, "dist"));
+    const hook = path.resolve(root, "dist", "hook-cli.js");
+    if (!files.some(file => path.resolve(file) === hook))
+        throw new Error("Linger runtime is missing dist/hook-cli.js");
+    const hash = createHash("sha256").update(root).update("\0").update(path.resolve(node));
+    for (const file of files) {
+        await assertReadableInside(root, file);
+        hash.update("\0").update(path.relative(root, file)).update("\0").update(await readFile(file));
+    }
+    return hash.digest("hex");
+}
+async function runtimeFiles(dir) {
+    const entries = await readdir(dir, { withFileTypes: true });
+    const files = [];
+    for (const entry of entries) {
+        const target = path.join(dir, entry.name);
+        if (entry.isDirectory())
+            files.push(...await runtimeFiles(target));
+        else if (entry.isFile())
+            files.push(target);
+    }
+    return files.sort();
+}
+//# sourceMappingURL=runtime-identity.js.map

package/dist/runtime-identity.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-identity.js","sourceRoot":"","sources":["../src/runtime-identity.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,oBAAoB,EAAE,MAAM,SAAS,CAAC;AAE/C,MAAM,CAAC,KAAK,UAAU,kBAAkB,CAAC,WAAmB,EAAE,IAAY;IACxE,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC;IACvC,MAAM,oBAAoB,CAAC,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC;IAC1D,MAAM,KAAK,GAAG,MAAM,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC;IAC1D,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,aAAa,CAAC,CAAC;IACvD,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,IAAI,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,4CAA4C,CAAC,CAAC;IACpH,MAAM,IAAI,GAAG,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC;IACvF,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM,oBAAoB,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;QACvC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,MAAM,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC;IAChG,CAAC;IACD,OAAO,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AAC5B,CAAC;AAED,KAAK,UAAU,YAAY,CAAC,GAAW;IACrC,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,GAAG,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC;IAC5D,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;QAC5B,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;QAC1C,IAAI,KAAK,CAAC,WAAW,EAAE;YAAE,KAAK,CAAC,IAAI,CAAC,GAAG,MAAM,YAAY,CAAC,MAAM,CAAC,CAAC,CAAC;aAC9D,IAAI,KAAK,CAAC,MAAM,EAAE;YAAE,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAC9C,CAAC;IACD,OAAO,KAAK,CAAC,IAAI,EAAE,CAAC;AACtB,CAAC"}

package/dist/runtime-installer.d.ts

@@ -0,0 +1,7 @@
+export interface RuntimeInstall {
+    root: string;
+    version: string;
+    files: string[];
+}
+export declare function installRuntime(home: string, packageRoot: string): Promise<RuntimeInstall>;
+export declare function uninstallRuntime(home: string, runtimeRoot: string): Promise<boolean>;