linger-skill 0.2.2

package/dist/hook-installer.js

@@ -0,0 +1,120 @@
+import { mkdir, readFile } from "node:fs/promises";
+import path from "node:path";
+import { atomicJson } from "./io.js";
+import { parseManagedHookCommand, posixHookCommand } from "./hook-command.js";
+import { windowsCommand } from "./windows-command.js";
+import { runtimeFingerprint } from "./runtime-identity.js";
+export async function installHooks(home, packageRoot, adapters) {
+    const node = process.execPath;
+    const hook = path.join(packageRoot, "dist", "hook-cli.js");
+    const runtimeIdentity = await runtimeFingerprint(packageRoot, node);
+    const written = [];
+    if (adapters.includes("claude-code")) {
+        const file = path.join(home, ".claude", "settings.json");
+        const settings = await jsonObjectOr(file);
+        const hooks = asHooks(settings.hooks);
+        removeLingerHookCommands(hooks, home, "claude-code");
+        addLingerHooks(hooks, "claude-code", node, hook, runtimeIdentity, ["SessionStart", "UserPromptSubmit", "Stop", "StopFailure"]);
+        await mkdir(path.dirname(file), { recursive: true });
+        await atomicJson(file, { ...settings, hooks });
+        written.push(file);
+    }
+    if (adapters.includes("codex")) {
+        const file = path.join(home, ".codex", "hooks.json");
+        const document = await jsonObjectOr(file);
+        const hooks = asHooks(document.hooks);
+        removeLingerHookCommands(hooks, home, "codex");
+        addLingerHooks(hooks, "codex", node, hook, runtimeIdentity, ["SessionStart", "UserPromptSubmit", "Stop"]);
+        await mkdir(path.dirname(file), { recursive: true });
+        await atomicJson(file, { ...document, hooks });
+        written.push(file);
+    }
+    return written;
+}
+export async function uninstallHooks(home, adapters, claudeAutoMemory) {
+    const changed = [];
+    for (const [adapter, file] of [
+        ["claude-code", path.join(home, ".claude", "settings.json")],
+        ["codex", path.join(home, ".codex", "hooks.json")]
+    ]) {
+        if (!adapters.includes(adapter) && !(adapter === "claude-code" && claudeAutoMemory))
+            continue;
+        const document = await jsonObjectOr(file);
+        const hooks = asHooks(document.hooks);
+        const removed = removeLingerHookCommands(hooks, home, adapter);
+        let restored = false;
+        if (adapter === "claude-code" && claudeAutoMemory && document.autoMemoryEnabled === false) {
+            if (claudeAutoMemory.had_value)
+                document.autoMemoryEnabled = claudeAutoMemory.previous_value;
+            else
+                delete document.autoMemoryEnabled;
+            restored = true;
+        }
+        if (removed || restored) {
+            await atomicJson(file, { ...document, hooks });
+            changed.push(file);
+        }
+    }
+    return changed;
+}
+function addLingerHooks(hooks, adapter, node, hook, runtimeIdentity, events) {
+    const command = posixHookCommand({ adapter, node, hook, runtime_identity: runtimeIdentity });
+    const commandWindows = windowsCommand({ adapter, node, hook, runtimeIdentity });
+    for (const event of events) {
+        const groups = hooks[event] ?? [];
+        const already = groups.some(group => group.hooks.some(hook => hook.command === command));
+        if (!already)
+            groups.push({ ...(event === "SessionStart" ? { matcher: "startup|resume|compact" } : {}), hooks: [{ type: "command", command, commandWindows, timeout: 10, statusMessage: "Linger capture" }] });
+        hooks[event] = groups;
+    }
+}
+function removeLingerHookCommands(hooks, home, adapter) {
+    let removed = false;
+    for (const event of Object.keys(hooks)) {
+        const groups = hooks[event] ?? [];
+        for (const group of groups) {
+            const before = group.hooks.length;
+            group.hooks = group.hooks.filter(hook => !isLingerHookCommand(hook.command, home, adapter));
+            removed ||= before !== group.hooks.length;
+        }
+        hooks[event] = groups.filter(group => group.hooks.length);
+        if (!hooks[event].length)
+            delete hooks[event];
+    }
+    return removed;
+}
+function asHooks(value) {
+    if (value === undefined)
+        return {};
+    if (!value || typeof value !== "object" || Array.isArray(value))
+        throw new Error("Invalid host hooks configuration");
+    for (const groups of Object.values(value)) {
+        if (!Array.isArray(groups))
+            throw new Error("Invalid host hook groups");
+        for (const group of groups) {
+            if (!group || typeof group !== "object" || Array.isArray(group) || !Array.isArray(group.hooks))
+                throw new Error("Invalid host hook group");
+            for (const hook of group.hooks)
+                if (!hook || typeof hook !== "object" || Array.isArray(hook) || typeof hook.command !== "string")
+                    throw new Error("Invalid host hook command");
+        }
+    }
+    return value;
+}
+async function jsonObjectOr(file) {
+    try {
+        const value = JSON.parse(await readFile(file, "utf8"));
+        if (!value || typeof value !== "object" || Array.isArray(value))
+            throw new Error("Invalid host configuration document");
+        return value;
+    }
+    catch (error) {
+        if (error.code === "ENOENT")
+            return {};
+        throw error;
+    }
+}
+function isLingerHookCommand(command, home, adapter) {
+    return Boolean(parseManagedHookCommand(command, home, adapter));
+}
+//# sourceMappingURL=hook-installer.js.map

package/dist/hook-installer.js.map

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

package/dist/hook-ownership.d.ts

@@ -0,0 +1,8 @@
+import type { RawEvent, Role } from "./types.js";
+export declare function findRecentEquivalentHookEvent(root: string, input: {
+    projectId: string;
+    role: Role;
+    content: string;
+    now?: number;
+}): Promise<RawEvent | undefined>;
+export declare function assertDecisionEvidenceNotHookOwned(root: string, projectId: string, evidenceRefs: string[], now?: number): Promise<void>;

package/dist/hook-ownership.js

@@ -0,0 +1,51 @@
+import { createHash } from "node:crypto";
+import path from "node:path";
+import { readJson } from "./io.js";
+import { isExplicitMemoryRequest } from "./memory-intent.js";
+import { assertSafeId, vaultPaths } from "./paths.js";
+import { assertRawRecordPath } from "./record-paths.js";
+import { assertRawEvent } from "./schema-validation.js";
+import { listJsonFiles } from "./vault.js";
+const HOOK_AGENTS = new Set(["claude-code", "codex"]);
+const OWNERSHIP_WINDOW_MS = 5 * 60 * 1000;
+export async function findRecentEquivalentHookEvent(root, input) {
+    const normalized = normalize(input.content);
+    if (normalized.length < 8)
+        return undefined;
+    const events = await recentHookEvents(root, input.projectId, input.now ?? Date.now());
+    return events.find(event => event.role === input.role && isExplicitMemoryRequest(event.content) && equivalent(normalized, normalize(event.content)));
+}
+export async function assertDecisionEvidenceNotHookOwned(root, projectId, evidenceRefs, now = Date.now()) {
+    const refs = new Set(evidenceRefs);
+    const owned = (await recentHookEvents(root, projectId, now)).find(event => refs.has(event.event_id));
+    if (owned)
+        throw new Error(`Recent lifecycle hook evidence ${owned.event_id} is already owned by automatic processing; refusing duplicate decision-add`);
+}
+async function recentHookEvents(root, projectId, now) {
+    const project = assertSafeId(projectId, "project id");
+    const p = vaultPaths(root);
+    const events = (await Promise.all((await listJsonFiles(path.join(p.raw, project), p.root)).map(async (file) => {
+        try {
+            const value = await readJson(file);
+            assertRawEvent(value);
+            assertRawRecordPath(p, file, value);
+            if (createHash("sha256").update(value.content).digest("hex") !== value.content_hash)
+                return undefined;
+            const age = now - Date.parse(value.timestamp);
+            if (!HOOK_AGENTS.has(value.source_agent) || !Number.isFinite(age) || age < 0 || age > OWNERSHIP_WINDOW_MS)
+                return undefined;
+            return value;
+        }
+        catch {
+            return undefined;
+        }
+    }))).filter((event) => Boolean(event));
+    return events.sort((left, right) => right.timestamp.localeCompare(left.timestamp) || right.seq_id - left.seq_id);
+}
+function normalize(value) {
+    return value.normalize("NFKC").toLowerCase().replace(/\s+/g, " ").trim();
+}
+function equivalent(shorter, longer) {
+    return shorter === longer || shorter.includes(longer) || longer.includes(shorter);
+}
+//# sourceMappingURL=hook-ownership.js.map

package/dist/hook-ownership.js.map

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

package/dist/install-consent.d.ts

@@ -0,0 +1,4 @@
+import type { Readable, Writable } from "node:stream";
+import type { AdapterName } from "./adapters.js";
+export declare function confirmPrivacyConsent(input: Readable, output: Writable): Promise<boolean>;
+export declare function parseAdapterSelection(value?: string): AdapterName[];

package/dist/install-consent.js

@@ -0,0 +1,20 @@
+import { PRIVACY_NOTICE } from "./installer.js";
+export async function confirmPrivacyConsent(input, output) {
+    output.write(`${PRIVACY_NOTICE}\nType YES to install Linger, or anything else to cancel: `);
+    let text = "";
+    for await (const chunk of input) {
+        text += chunk.toString();
+        if (/\r?\n/.test(text))
+            break;
+    }
+    return text.split(/\r?\n/, 1)[0]?.trim() === "YES";
+}
+export function parseAdapterSelection(value) {
+    if (value === undefined)
+        return ["claude-code", "codex"];
+    const adapters = [...new Set(value.split(",").map(item => item.trim()).filter(Boolean))];
+    if (!adapters.length || adapters.some(item => item !== "claude-code" && item !== "codex"))
+        throw new Error("--adapters must be claude-code, codex, or both comma-separated");
+    return adapters;
+}
+//# sourceMappingURL=install-consent.js.map

package/dist/install-consent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"install-consent.js","sourceRoot":"","sources":["../src/install-consent.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAEhD,MAAM,CAAC,KAAK,UAAU,qBAAqB,CAAC,KAAe,EAAE,MAAgB;IAC3E,MAAM,CAAC,KAAK,CAAC,GAAG,cAAc,4DAA4D,CAAC,CAAC;IAC5F,IAAI,IAAI,GAAG,EAAE,CAAC;IACd,IAAI,KAAK,EAAE,MAAM,KAAK,IAAI,KAAK,EAAE,CAAC;QAChC,IAAI,IAAI,KAAK,CAAC,QAAQ,EAAE,CAAC;QACzB,IAAI,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC;YAAE,MAAM;IAChC,CAAC;IACD,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,KAAK,KAAK,CAAC;AACrD,CAAC;AAED,MAAM,UAAU,qBAAqB,CAAC,KAAc;IAClD,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,CAAC,aAAa,EAAE,OAAO,CAAC,CAAC;IACzD,MAAM,QAAQ,GAAG,CAAC,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;IACzF,IAAI,CAAC,QAAQ,CAAC,MAAM,IAAI,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,KAAK,aAAa,IAAI,IAAI,KAAK,OAAO,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,gEAAgE,CAAC,CAAC;IAC7K,OAAO,QAAyB,CAAC;AACnC,CAAC"}

package/dist/installer.d.ts

@@ -0,0 +1,33 @@
+import { capabilityReport, type AdapterName } from "./adapters.js";
+export declare const PRIVACY_NOTICE = "Linger stores visible conversations in local files. Recalled evidence and bounded normal-sensitivity enrichment batches may be sent to the model provider configured in the current Codex or Claude Code host. Linger does not configure a separate model provider or API key, and it does not disable or replace host-owned memory. Local-first does not mean data never leaves this device. No telemetry is installed, and uninstall preserves the vault.";
+export interface InstallManifest {
+    schema_version: 1;
+    package_version: string;
+    installed_at: string;
+    package_root: string;
+    runtime_root: string;
+    adapters: AdapterName[];
+    files: string[];
+    backups: string[];
+    hook_files: string[];
+    /** Legacy v0.2.1 migration state. New installs never create this field. */
+    claude_auto_memory?: ClaudeAutoMemoryState;
+}
+export interface ClaudeAutoMemoryState {
+    had_value: boolean;
+    previous_value?: boolean;
+}
+export interface InstallOptions {
+    home: string;
+    packageRoot: string;
+    adapters?: AdapterName[];
+}
+export declare function install(options: InstallOptions): Promise<{
+    manifest: InstallManifest;
+    capabilities: Awaited<ReturnType<typeof capabilityReport>>;
+    privacy_notice: string;
+}>;
+export declare function uninstall(home: string): Promise<{
+    removed: string[];
+    vault_preserved: true;
+}>;

package/dist/installer.js

@@ -0,0 +1,140 @@
+import { cp, mkdir, readFile, rename, rm, stat, writeFile } from "node:fs/promises";
+import path from "node:path";
+import { capabilityReport } from "./adapters.js";
+import { atomicJson } from "./io.js";
+import { installHooks, uninstallHooks } from "./hook-installer.js";
+import { installRuntime, uninstallRuntime } from "./runtime-installer.js";
+import { assertSafeId } from "./paths.js";
+export const PRIVACY_NOTICE = "Linger stores visible conversations in local files. Recalled evidence and bounded normal-sensitivity enrichment batches may be sent to the model provider configured in the current Codex or Claude Code host. Linger does not configure a separate model provider or API key, and it does not disable or replace host-owned memory. Local-first does not mean data never leaves this device. No telemetry is installed, and uninstall preserves the vault.";
+export async function install(options) {
+    const adapters = options.adapters ?? ["claude-code", "codex"];
+    assertAdapters(adapters);
+    const sourceSkill = path.join(options.packageRoot, "skills", "linger");
+    await stat(path.join(sourceSkill, "SKILL.md"));
+    const stateRoot = path.join(options.home, ".linger");
+    const manifestFile = path.join(stateRoot, "install-manifest.json");
+    await mkdir(stateRoot, { recursive: true, mode: 0o700 });
+    const previousManifest = await existingManifest(options.home, manifestFile);
+    const staleAdapters = previousManifest?.adapters.filter(adapter => !adapters.includes(adapter)) ?? [];
+    if (staleAdapters.length || previousManifest?.claude_auto_memory) {
+        await uninstallHooks(options.home, staleAdapters, previousManifest?.claude_auto_memory);
+    }
+    const currentDestinations = new Set(adapters.map(adapter => path.resolve(skillDestination(options.home, adapter))));
+    for (const target of previousManifest?.files ?? []) {
+        if (!currentDestinations.has(path.resolve(target)) && await isManaged(target))
+            await rm(target, { recursive: true, force: true });
+    }
+    const backups = [];
+    const files = [];
+    for (const adapter of adapters) {
+        const destination = skillDestination(options.home, adapter);
+        if (await exists(destination)) {
+            if (await isManaged(destination))
+                await rm(destination, { recursive: true, force: true });
+            else {
+                const backup = `${destination}.backup-${Date.now()}`;
+                await rename(destination, backup);
+                backups.push(backup);
+            }
+        }
+        await mkdir(destination, { recursive: true, mode: 0o700 });
+        await cp(sourceSkill, destination, { recursive: true, force: false });
+        await writeFile(path.join(destination, ".linger-managed"), "managed by linger-skill\n", { mode: 0o600 });
+        files.push(destination);
+    }
+    const runtime = await installRuntime(options.home, options.packageRoot);
+    const hookFiles = await installHooks(options.home, runtime.root, adapters);
+    const manifest = { schema_version: 1, package_version: runtime.version, installed_at: new Date().toISOString(), package_root: options.packageRoot, runtime_root: runtime.root, adapters, files, backups, hook_files: hookFiles };
+    await atomicJson(manifestFile, manifest);
+    return { manifest, capabilities: await capabilityReport(options.home), privacy_notice: PRIVACY_NOTICE };
+}
+export async function uninstall(home) {
+    const manifestFile = path.join(home, ".linger", "install-manifest.json");
+    let manifest;
+    try {
+        manifest = JSON.parse(await readFile(manifestFile, "utf8"));
+    }
+    catch (error) {
+        if (error.code === "ENOENT")
+            return { removed: [], vault_preserved: true };
+        throw error;
+    }
+    assertInstallManifest(home, manifest);
+    const removed = [];
+    for (const target of manifest.files) {
+        if (!isInside(home, target))
+            throw new Error(`Refusing to remove path outside home: ${target}`);
+        if (await isManaged(target)) {
+            await rm(target, { recursive: true, force: true });
+            removed.push(target);
+        }
+    }
+    await uninstallHooks(home, manifest.adapters, manifest.claude_auto_memory);
+    await uninstallRuntime(home, manifest.runtime_root);
+    await rm(manifestFile, { force: true });
+    return { removed, vault_preserved: true };
+}
+function skillDestination(home, adapter) {
+    return path.join(home, adapter === "claude-code" ? ".claude" : ".codex", "skills", "linger");
+}
+function assertAdapters(adapters) {
+    if (!Array.isArray(adapters) || !adapters.length || !adapters.every(adapter => adapter === "claude-code" || adapter === "codex") || new Set(adapters).size !== adapters.length)
+        throw new Error("Invalid install adapters");
+}
+function assertInstallManifest(home, value) {
+    if (!value || typeof value !== "object" || Array.isArray(value))
+        throw new Error("Invalid install manifest");
+    const item = value;
+    if (item.schema_version !== 1)
+        throw new Error("Invalid install manifest schema");
+    const packageVersion = typeof item.package_version === "string" ? assertSafeId(item.package_version, "package version") : (() => { throw new Error("Invalid install manifest package version"); })();
+    if (typeof item.installed_at !== "string" || !Number.isFinite(Date.parse(item.installed_at)))
+        throw new Error("Invalid install manifest timestamp");
+    if (typeof item.package_root !== "string" || typeof item.runtime_root !== "string")
+        throw new Error("Invalid install manifest paths");
+    assertAdapters(item.adapters);
+    for (const field of ["files", "backups", "hook_files"])
+        if (!Array.isArray(item[field]) || !item[field].every(entry => typeof entry === "string"))
+            throw new Error(`Invalid install manifest ${field}`);
+    if (item.claude_auto_memory !== undefined)
+        assertClaudeAutoMemoryState(item.claude_auto_memory);
+    const allowedTargets = new Set(item.adapters.map(adapter => path.resolve(skillDestination(home, adapter))));
+    if (!item.files.every(file => allowedTargets.has(path.resolve(file))))
+        throw new Error("Invalid install manifest target");
+    const allowedRuntime = path.resolve(home, ".linger", "runtime", packageVersion);
+    if (path.resolve(item.runtime_root) !== allowedRuntime)
+        throw new Error("Invalid install manifest runtime");
+}
+function isInside(parent, child) { const relative = path.relative(path.resolve(parent), path.resolve(child)); return relative !== "" && !relative.startsWith("..") && !path.isAbsolute(relative); }
+async function isManaged(dir) { return await exists(path.join(dir, ".linger-managed")); }
+async function exists(file) { try {
+    await stat(file);
+    return true;
+}
+catch {
+    return false;
+} }
+async function existingManifest(home, file) {
+    try {
+        const value = JSON.parse(await readFile(file, "utf8"));
+        assertInstallManifest(home, value);
+        return value;
+    }
+    catch (error) {
+        if (error.code === "ENOENT")
+            return undefined;
+        throw error;
+    }
+}
+function assertClaudeAutoMemoryState(value) {
+    if (!value || typeof value !== "object" || Array.isArray(value))
+        throw new Error("Invalid install manifest Claude auto-memory state");
+    const item = value;
+    if (typeof item.had_value !== "boolean")
+        throw new Error("Invalid install manifest Claude auto-memory state");
+    if (item.had_value ? typeof item.previous_value !== "boolean" : item.previous_value !== undefined)
+        throw new Error("Invalid install manifest Claude auto-memory state");
+    if (Object.keys(item).some(key => key !== "had_value" && key !== "previous_value"))
+        throw new Error("Invalid install manifest Claude auto-memory state");
+}
+//# sourceMappingURL=installer.js.map

package/dist/installer.js.map

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

package/dist/io.d.ts

@@ -0,0 +1,7 @@
+export declare function ensureDir(dir: string): Promise<void>;
+export declare function atomicWrite(file: string, data: string): Promise<void>;
+export declare function atomicJson(file: string, value: unknown): Promise<void>;
+export declare function readJson<T>(file: string): Promise<T>;
+export declare function assertReadableInside(root: string, target: string): Promise<void>;
+export declare function assertWritableInside(root: string, target: string): Promise<void>;
+export declare function withFileLock<T>(lockFile: string, action: () => Promise<T>): Promise<T>;

package/dist/io.js

@@ -0,0 +1,86 @@
+import { lstat, mkdir, open, readFile, realpath, rename, writeFile } from "node:fs/promises";
+import path from "node:path";
+import { randomUUID } from "node:crypto";
+export async function ensureDir(dir) {
+    await mkdir(dir, { recursive: true, mode: 0o700 });
+}
+export async function atomicWrite(file, data) {
+    await ensureDir(path.dirname(file));
+    const tmp = path.join(path.dirname(file), `.${path.basename(file)}.${randomUUID()}.tmp`);
+    await writeFile(tmp, data, { encoding: "utf8", mode: 0o600, flag: "wx" });
+    await rename(tmp, file);
+}
+export async function atomicJson(file, value) {
+    await atomicWrite(file, `${JSON.stringify(value, null, 2)}\n`);
+}
+export async function readJson(file) {
+    return JSON.parse(await readFile(file, "utf8"));
+}
+export async function assertReadableInside(root, target) {
+    const rootResolved = path.resolve(root);
+    const targetResolved = path.resolve(target);
+    const lexical = path.relative(rootResolved, targetResolved);
+    if (!lexical || lexical.startsWith("..") || path.isAbsolute(lexical))
+        throw new Error("Read path escapes Vault");
+    const [rootReal, targetReal] = await Promise.all([realpath(rootResolved), realpath(targetResolved)]);
+    const physical = path.relative(rootReal, targetReal);
+    if (!physical || physical.startsWith("..") || path.isAbsolute(physical))
+        throw new Error("Read path escapes Vault through symlink");
+    if ((await lstat(targetResolved)).isSymbolicLink())
+        throw new Error("Read target is a symlink");
+}
+export async function assertWritableInside(root, target) {
+    const rootResolved = path.resolve(root);
+    const targetResolved = path.resolve(target);
+    const lexical = path.relative(rootResolved, targetResolved);
+    if (!lexical || lexical.startsWith("..") || path.isAbsolute(lexical))
+        throw new Error("Write path escapes Vault");
+    const rootReal = await realpath(rootResolved);
+    let ancestor = path.dirname(targetResolved);
+    while (true) {
+        try {
+            ancestor = await realpath(ancestor);
+            break;
+        }
+        catch (error) {
+            if (error.code !== "ENOENT")
+                throw error;
+            const parent = path.dirname(ancestor);
+            if (parent === ancestor)
+                throw error;
+            ancestor = parent;
+        }
+    }
+    const physical = path.relative(rootReal, ancestor);
+    if (physical.startsWith("..") || path.isAbsolute(physical))
+        throw new Error("Write path escapes Vault through symlink");
+    try {
+        if ((await lstat(targetResolved)).isSymbolicLink())
+            throw new Error("Write target is a symlink");
+    }
+    catch (error) {
+        if (error.code !== "ENOENT")
+            throw error;
+    }
+}
+export async function withFileLock(lockFile, action) {
+    await ensureDir(path.dirname(lockFile));
+    let handle;
+    try {
+        handle = await open(lockFile, "wx", 0o600);
+    }
+    catch (error) {
+        if (error.code === "EEXIST")
+            throw new Error(`Vault is busy: ${lockFile}`);
+        throw error;
+    }
+    try {
+        return await action();
+    }
+    finally {
+        await handle.close();
+        const { unlink } = await import("node:fs/promises");
+        await unlink(lockFile).catch(() => undefined);
+    }
+}
+//# sourceMappingURL=io.js.map

package/dist/io.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"io.js","sourceRoot":"","sources":["../src/io.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAC7F,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEzC,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,GAAW;IACzC,MAAM,KAAK,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;AACrD,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,IAAY,EAAE,IAAY;IAC1D,MAAM,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC;IACpC,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,IAAI,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,UAAU,EAAE,MAAM,CAAC,CAAC;IACzF,MAAM,SAAS,CAAC,GAAG,EAAE,IAAI,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;IAC1E,MAAM,MAAM,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;AAC1B,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,IAAY,EAAE,KAAc;IAC3D,MAAM,WAAW,CAAC,IAAI,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC;AACjE,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,QAAQ,CAAI,IAAY;IAC5C,OAAO,IAAI,CAAC,KAAK,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,CAAM,CAAC;AACvD,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,oBAAoB,CAAC,IAAY,EAAE,MAAc;IACrE,MAAM,YAAY,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IACxC,MAAM,cAAc,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;IAC5C,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC,YAAY,EAAE,cAAc,CAAC,CAAC;IAC5D,IAAI,CAAC,OAAO,IAAI,OAAO,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,yBAAyB,CAAC,CAAC;IACjH,MAAM,CAAC,QAAQ,EAAE,UAAU,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC,CAAC,QAAQ,CAAC,YAAY,CAAC,EAAE,QAAQ,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC;IACrG,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC,QAAQ,EAAE,UAAU,CAAC,CAAC;IACrD,IAAI,CAAC,QAAQ,IAAI,QAAQ,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,yCAAyC,CAAC,CAAC;IACpI,IAAI,CAAC,MAAM,KAAK,CAAC,cAAc,CAAC,CAAC,CAAC,cAAc,EAAE;QAAE,MAAM,IAAI,KAAK,CAAC,0BAA0B,CAAC,CAAC;AAClG,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,oBAAoB,CAAC,IAAY,EAAE,MAAc;IACrE,MAAM,YAAY,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IACxC,MAAM,cAAc,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;IAC5C,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC,YAAY,EAAE,cAAc,CAAC,CAAC;IAC5D,IAAI,CAAC,OAAO,IAAI,OAAO,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,0BAA0B,CAAC,CAAC;IAClH,MAAM,QAAQ,GAAG,MAAM,QAAQ,CAAC,YAAY,CAAC,CAAC;IAC9C,IAAI,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,cAAc,CAAC,CAAC;IAC5C,OAAO,IAAI,EAAE,CAAC;QACZ,IAAI,CAAC;YAAC,QAAQ,GAAG,MAAM,QAAQ,CAAC,QAAQ,CAAC,CAAC;YAAC,MAAM;QAAC,CAAC;QACnD,OAAO,KAAK,EAAE,CAAC;YACb,IAAK,KAA+B,CAAC,IAAI,KAAK,QAAQ;gBAAE,MAAM,KAAK,CAAC;YACpE,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;YACtC,IAAI,MAAM,KAAK,QAAQ;gBAAE,MAAM,KAAK,CAAC;YACrC,QAAQ,GAAG,MAAM,CAAC;QACpB,CAAC;IACH,CAAC;IACD,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;IACnD,IAAI,QAAQ,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,0CAA0C,CAAC,CAAC;IACxH,IAAI,CAAC;QAAC,IAAI,CAAC,MAAM,KAAK,CAAC,cAAc,CAAC,CAAC,CAAC,cAAc,EAAE;YAAE,MAAM,IAAI,KAAK,CAAC,2BAA2B,CAAC,CAAC;IAAC,CAAC;IACzG,OAAO,KAAK,EAAE,CAAC;QAAC,IAAK,KAA+B,CAAC,IAAI,KAAK,QAAQ;YAAE,MAAM,KAAK,CAAC;IAAC,CAAC;AACxF,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,YAAY,CAAI,QAAgB,EAAE,MAAwB;IAC9E,MAAM,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC;IACxC,IAAI,MAAM,CAAC;IACX,IAAI,CAAC;QACH,MAAM,GAAG,MAAM,IAAI,CAAC,QAAQ,EAAE,IAAI,EAAE,KAAK,CAAC,CAAC;IAC7C,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAK,KAA+B,CAAC,IAAI,KAAK,QAAQ;YAAE,MAAM,IAAI,KAAK,CAAC,kBAAkB,QAAQ,EAAE,CAAC,CAAC;QACtG,MAAM,KAAK,CAAC;IACd,CAAC;IACD,IAAI,CAAC;QACH,OAAO,MAAM,MAAM,EAAE,CAAC;IACxB,CAAC;YAAS,CAAC;QACT,MAAM,MAAM,CAAC,KAAK,EAAE,CAAC;QACrB,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,MAAM,CAAC,kBAAkB,CAAC,CAAC;QACpD,MAAM,MAAM,CAAC,QAAQ,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;IAChD,CAAC;AACH,CAAC"}

package/dist/memory-events.d.ts

@@ -0,0 +1,31 @@
+import type { ProcessedMemory } from "./types.js";
+export type MemoryControlKind = "forget" | "correct" | "delete";
+export interface MemoryControlEvent {
+    schema_version: 1;
+    event_id: string;
+    kind: MemoryControlKind;
+    project_id: string;
+    target_memory_id: string;
+    replacement_memory_id?: string;
+    reason?: string;
+    evidence_refs: string[];
+    timestamp: string;
+}
+export interface EffectiveMemoryState {
+    status: "active" | "revoked" | "superseded" | "deleted";
+    replacement_memory_id?: string;
+    event_ids: string[];
+}
+export declare function appendMemoryControl(root: string, input: Omit<MemoryControlEvent, "schema_version" | "event_id" | "timestamp"> & {
+    timestamp?: string;
+}): Promise<MemoryControlEvent>;
+export declare function effectiveMemoryStates(root: string, projectId: string): Promise<Map<string, EffectiveMemoryState>>;
+export declare function correctMemory(root: string, projectId: string, targetMemoryId: string, correction: {
+    summary: string;
+    evidenceRefs: string[];
+    reason?: string;
+    source?: "user_explicit" | "agent_inferred";
+}): Promise<{
+    memory: ProcessedMemory;
+    event: MemoryControlEvent;
+}>;