linger-skill 0.2.2

package/dist/tag-registry.d.ts

@@ -0,0 +1,21 @@
+export interface TagRegistryEntry {
+    raw_tag: string;
+    normalized_tag: string;
+    aliases: string[];
+    related_terms: string[];
+    usage_count: number;
+    created_at: string;
+    last_used: string;
+    examples: string[];
+    confidence: number;
+}
+export interface TagRegistry {
+    schema_version: 1;
+    project_id: string;
+    generated_at: string;
+    entries: TagRegistryEntry[];
+    skipped_files: string[];
+}
+export declare function rebuildTagRegistry(root: string, projectId: string): Promise<TagRegistry>;
+export declare function readTagRegistry(root: string, projectId: string): Promise<TagRegistry | undefined>;
+export declare function normalizeTag(value: string): string;

package/dist/tag-registry.js

@@ -0,0 +1,70 @@
+import path from "node:path";
+import { assertWritableInside, atomicJson, readJson } from "./io.js";
+import { effectiveMemoryStates } from "./memory-events.js";
+import { applyEnrichment, readEnrichmentOverlays } from "./enrichment.js";
+import { assertSafeId, vaultPaths } from "./paths.js";
+import { assertProcessedMemory, assertTagRegistry } from "./schema-validation.js";
+import { assertProcessedRecordPath, assertTagRegistryPath } from "./record-paths.js";
+import { listJsonFiles } from "./vault.js";
+export async function rebuildTagRegistry(root, projectId) {
+    const project = assertSafeId(projectId, "project id");
+    const p = vaultPaths(root);
+    const states = await effectiveMemoryStates(root, project);
+    const overlays = await readEnrichmentOverlays(root, project);
+    const entries = new Map();
+    const skipped = [];
+    for (const file of await listJsonFiles(path.join(p.processed, project), p.root)) {
+        try {
+            const baseline = await readJson(file);
+            assertProcessedMemory(baseline);
+            assertProcessedRecordPath(p, file, baseline);
+            const memory = applyEnrichment(baseline, overlays.get(baseline.id));
+            if (memory.status !== "active" || states.has(memory.id))
+                continue;
+            for (const raw of [...new Set([...memory.tags, ...memory.predictive_tags])]) {
+                const normalized = normalizeTag(raw);
+                if (!normalized)
+                    continue;
+                const current = entries.get(normalized);
+                if (current) {
+                    current.usage_count += 1;
+                    current.last_used = later(current.last_used, memory.updated_at);
+                    current.examples = [...new Set([...current.examples, memory.id])].slice(0, 5);
+                    if (raw !== normalized)
+                        current.aliases = [...new Set([...current.aliases, raw])].sort();
+                    current.confidence = Math.max(current.confidence, memory.confidence);
+                }
+                else {
+                    entries.set(normalized, { raw_tag: raw, normalized_tag: normalized, aliases: raw === normalized ? [] : [raw], related_terms: [], usage_count: 1, created_at: memory.created_at, last_used: memory.updated_at, examples: [memory.id], confidence: memory.confidence });
+                }
+            }
+        }
+        catch {
+            skipped.push(path.relative(p.root, file));
+        }
+    }
+    const registry = { schema_version: 1, project_id: project, generated_at: new Date().toISOString(), entries: [...entries.values()].sort((a, b) => b.usage_count - a.usage_count || a.normalized_tag.localeCompare(b.normalized_tag)), skipped_files: skipped };
+    const file = path.join(p.registry, "tags", `${project}.json`);
+    await assertWritableInside(p.root, file);
+    await atomicJson(file, registry);
+    return registry;
+}
+export async function readTagRegistry(root, projectId) {
+    const p = vaultPaths(root);
+    const file = path.join(p.registry, "tags", `${assertSafeId(projectId, "project id")}.json`);
+    await assertWritableInside(p.root, file);
+    try {
+        const value = await readJson(file);
+        assertTagRegistry(value);
+        assertTagRegistryPath(p, file, value);
+        return value;
+    }
+    catch (error) {
+        if (error.code === "ENOENT")
+            return undefined;
+        throw error;
+    }
+}
+export function normalizeTag(value) { return value.trim().toLowerCase().replace(/\s+/g, "-").replace(/^-+|-+$/g, ""); }
+function later(a, b) { return a.localeCompare(b) >= 0 ? a : b; }
+//# sourceMappingURL=tag-registry.js.map

package/dist/tag-registry.js.map

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

package/dist/term-graph.d.ts

@@ -0,0 +1,18 @@
+export type TermRelationType = "synonym" | "alias" | "abbreviation" | "related" | "contextual_equivalent" | "location_mapping" | "product_name" | "ambiguous";
+export interface TermRelation {
+    schema_version: 1;
+    relation_id: string;
+    project_id: string;
+    term_a: string;
+    term_b: string;
+    relation_type: TermRelationType;
+    confidence: number;
+    context_tags: string[];
+    evidence_refs: string[];
+    created_at: string;
+    last_verified: string;
+}
+export declare function addTermRelation(root: string, input: Omit<TermRelation, "schema_version" | "relation_id" | "created_at" | "last_verified"> & {
+    timestamp?: string;
+}): Promise<TermRelation>;
+export declare function expandTerms(root: string, projectId: string, queryTerms: string[], contextTags?: string[]): Promise<Map<string, number>>;

package/dist/term-graph.js

@@ -0,0 +1,63 @@
+import { randomUUID } from "node:crypto";
+import path from "node:path";
+import { assertWritableInside, atomicJson, readJson } from "./io.js";
+import { assertSafeId, vaultPaths } from "./paths.js";
+import { assertTermRelation } from "./schema-validation.js";
+import { assertTermRelationPath } from "./record-paths.js";
+import { listJsonFiles } from "./vault.js";
+const RELATION_TYPES = new Set(["synonym", "alias", "abbreviation", "related", "contextual_equivalent", "location_mapping", "product_name", "ambiguous"]);
+export async function addTermRelation(root, input) {
+    const project = assertSafeId(input.project_id, "project id");
+    const a = normalize(input.term_a);
+    const b = normalize(input.term_b);
+    if (!a || !b || a === b)
+        throw new Error("Term relation requires two distinct terms");
+    if (!RELATION_TYPES.has(input.relation_type))
+        throw new Error("Invalid term relation type");
+    if (input.confidence < 0 || input.confidence > 1)
+        throw new Error("Confidence must be between 0 and 1");
+    if (!input.evidence_refs.length)
+        throw new Error("Term relation requires evidence");
+    const timestamp = input.timestamp ?? new Date().toISOString();
+    const relation = {
+        schema_version: 1, relation_id: `tr_${randomUUID()}`, project_id: project, term_a: a, term_b: b,
+        relation_type: input.relation_type, confidence: input.confidence, context_tags: [...new Set(input.context_tags.map(normalize).filter(Boolean))],
+        evidence_refs: [...new Set(input.evidence_refs)], created_at: timestamp, last_verified: timestamp
+    };
+    assertTermRelation(relation);
+    const p = vaultPaths(root);
+    const file = path.join(p.registry, "term-graph", project, `${relation.relation_id}.json`);
+    await assertWritableInside(p.root, file);
+    await atomicJson(file, relation);
+    return relation;
+}
+export async function expandTerms(root, projectId, queryTerms, contextTags = []) {
+    const project = assertSafeId(projectId, "project id");
+    const p = vaultPaths(root);
+    const query = new Set(queryTerms.map(normalize).filter(Boolean));
+    const context = new Set(contextTags.map(normalize).filter(Boolean));
+    const expanded = new Map();
+    for (const file of await listJsonFiles(path.join(p.registry, "term-graph", project), p.root)) {
+        let relation;
+        try {
+            const value = await readJson(file);
+            assertTermRelation(value);
+            assertTermRelationPath(p, file, value);
+            relation = value;
+        }
+        catch {
+            continue;
+        }
+        if (relation.relation_type === "ambiguous" || relation.confidence < 0.6)
+            continue;
+        if (relation.context_tags.length && !relation.context_tags.some(tag => context.has(tag)))
+            continue;
+        if (query.has(relation.term_a))
+            expanded.set(relation.term_b, Math.max(expanded.get(relation.term_b) ?? 0, relation.confidence));
+        if (query.has(relation.term_b) && relation.relation_type !== "related")
+            expanded.set(relation.term_a, Math.max(expanded.get(relation.term_a) ?? 0, relation.confidence));
+    }
+    return expanded;
+}
+function normalize(value) { return value.trim().toLowerCase(); }
+//# sourceMappingURL=term-graph.js.map

package/dist/term-graph.js.map

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

package/dist/types.d.ts

@@ -0,0 +1,68 @@
+export type Role = "user" | "assistant" | "system";
+export type SavepointStatus = "pending" | "complete" | "partial";
+export type MemorySource = "user_explicit" | "agent_inferred";
+export interface RawEvent {
+    schema_version: 1;
+    event_id: string;
+    session_id: string;
+    project_id: string;
+    seq_id: number;
+    turn_id: string;
+    role: Role;
+    timestamp: string;
+    source_agent: string;
+    source_model?: string;
+    content: string;
+    content_hash: string;
+    savepoint_status: SavepointStatus;
+    capture_status: "captured";
+    sensitivity: "normal" | "sensitive" | "secret";
+    raw_ref: string;
+}
+export interface QueueItem {
+    schema_version: 1;
+    task_id: string;
+    event_id: string;
+    project_id: string;
+    priority: "normal" | "explicit";
+    status: "pending" | "processing" | "failed" | "done";
+    attempts: number;
+    created_at: string;
+    updated_at: string;
+    error?: string;
+}
+export interface ProcessedMemory {
+    schema_version: 1;
+    id: string;
+    type: "conversation" | "idea" | "preference" | "proposal" | "rationale" | "constraint" | "rejection" | "decision" | "current_state" | "todo" | "correction";
+    scope: "project" | "global";
+    project_id: string;
+    title: string;
+    summary: string;
+    tags: string[];
+    predictive_tags: string[];
+    retrieval_phrases: string[];
+    source_events: string[];
+    source_hash?: string;
+    source_savepoint_status: SavepointStatus;
+    confidence: number;
+    source: MemorySource;
+    status: "active" | "revoked" | "superseded";
+    sensitivity: "normal" | "sensitive";
+    supersedes: string[];
+    superseded_by: string[];
+    created_at: string;
+    updated_at: string;
+    agent: string;
+    model?: string;
+}
+export interface SearchHit {
+    match_type: "exact_record" | "similar_record" | "possible_match" | "unprocessed_raw";
+    confidence: number;
+    score: number;
+    source: string;
+    snippet: string;
+    raw_ref: string[];
+    warning_flags: string[];
+    sensitivity_flags: string[];
+}

package/dist/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/dist/vault-candidates.d.ts

@@ -0,0 +1 @@
+export declare function listVaultJsonCandidates(target: string, boundaryRoot: string): Promise<string[]>;

package/dist/vault-candidates.js

@@ -0,0 +1,57 @@
+import { lstat, readdir } from "node:fs/promises";
+import path from "node:path";
+import { assertReadableInside, assertWritableInside } from "./io.js";
+export async function listVaultJsonCandidates(target, boundaryRoot) {
+    try {
+        await assertWritableInside(boundaryRoot, target);
+        await assertReadableInside(boundaryRoot, target);
+        const info = await lstat(target);
+        if (info.isSymbolicLink())
+            return [target];
+        if (info.isFile())
+            return target.endsWith(".json") ? [target] : [];
+        if (!info.isDirectory())
+            return [];
+        const entries = await readdir(target, { withFileTypes: true });
+        const files = [];
+        for (const entry of entries.sort((a, b) => a.name.localeCompare(b.name))) {
+            const child = path.join(target, entry.name);
+            if (entry.isSymbolicLink())
+                files.push(child);
+            else if (entry.isDirectory())
+                files.push(...await listVaultJsonCandidates(child, boundaryRoot));
+            else if (entry.isFile() && entry.name.endsWith(".json"))
+                files.push(child);
+        }
+        return files;
+    }
+    catch (error) {
+        const symlink = await firstSymlink(boundaryRoot, target);
+        if (symlink)
+            return [symlink];
+        if (error.code === "ENOENT")
+            return [];
+        throw error;
+    }
+}
+async function firstSymlink(root, target) {
+    const rootResolved = path.resolve(root);
+    const relative = path.relative(rootResolved, path.resolve(target));
+    if (!relative || relative.startsWith("..") || path.isAbsolute(relative))
+        return undefined;
+    let current = rootResolved;
+    for (const part of relative.split(path.sep)) {
+        current = path.join(current, part);
+        try {
+            if ((await lstat(current)).isSymbolicLink())
+                return current;
+        }
+        catch (error) {
+            if (error.code === "ENOENT")
+                return undefined;
+            throw error;
+        }
+    }
+    return undefined;
+}
+//# sourceMappingURL=vault-candidates.js.map

package/dist/vault-candidates.js.map

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

package/dist/vault.d.ts

@@ -0,0 +1,28 @@
+export interface VaultConfig {
+    schema_version: 1;
+    paused: boolean;
+    project_only_recall: boolean;
+    sensitive_exclusion: boolean;
+    max_snippets: number;
+    max_characters: number;
+    max_files: number;
+    max_raw_fragment_characters: number;
+    search_timeout_ms: number;
+    created_at: string;
+}
+export interface ProjectRecord {
+    schema_version: 1;
+    project_id: string;
+    display_name: string;
+    root_path: string;
+    identity_source: "git_remote_root" | "git_root" | "absolute_path";
+    created_at: string;
+    last_seen: string;
+}
+export declare function initVault(root: string): Promise<VaultConfig>;
+export declare function setPaused(root: string, paused: boolean): Promise<VaultConfig>;
+export declare function projectId(cwd: string): Promise<string>;
+export declare function registerProject(root: string, cwd: string): Promise<ProjectRecord>;
+export declare function listProjects(root: string): Promise<ProjectRecord[]>;
+export declare function listJsonFiles(dir: string, boundaryRoot: string): Promise<string[]>;
+export declare function vaultStats(root: string): Promise<Record<string, number | boolean>>;

package/dist/vault.js

@@ -0,0 +1,158 @@
+import { readdir, realpath, stat } from "node:fs/promises";
+import path from "node:path";
+import { createHash } from "node:crypto";
+import { assertReadableInside, assertWritableInside, atomicJson, ensureDir, readJson } from "./io.js";
+import { vaultPaths } from "./paths.js";
+import { assertProjectRecord, assertQueueItem, assertVaultConfig } from "./schema-validation.js";
+import { assertProjectRecordPath, assertQueueRecordPath } from "./record-paths.js";
+function defaultConfig(createdAt = new Date().toISOString()) {
+    return {
+        schema_version: 1,
+        paused: false,
+        project_only_recall: true,
+        sensitive_exclusion: true,
+        max_snippets: 8,
+        max_characters: 12000,
+        max_files: 5000,
+        max_raw_fragment_characters: 500,
+        search_timeout_ms: 2000,
+        created_at: createdAt
+    };
+}
+export async function initVault(root) {
+    const p = vaultPaths(root);
+    await Promise.all([
+        p.projects, p.raw, p.processed, p.enrichments, p.queue, p.tmp, p.registry, p.decisions, p.quarantine
+    ].map(ensureDir));
+    await assertWritableInside(p.root, p.config);
+    try {
+        const existing = await readJson(p.config);
+        if (existing.schema_version !== 1)
+            throw new Error(`Unsupported vault config schema: ${String(existing.schema_version)}`);
+        const next = { ...defaultConfig(typeof existing.created_at === "string" ? existing.created_at : undefined), ...existing };
+        assertVaultConfig(next);
+        if (JSON.stringify(existing) !== JSON.stringify(next)) {
+            await assertWritableInside(p.root, p.config);
+            await atomicJson(p.config, next);
+        }
+        return next;
+    }
+    catch (error) {
+        if (error.code !== "ENOENT")
+            throw error;
+    }
+    const config = defaultConfig();
+    await assertWritableInside(p.root, p.config);
+    await atomicJson(p.config, config);
+    return config;
+}
+export async function setPaused(root, paused) {
+    const p = vaultPaths(root);
+    const config = await initVault(root);
+    const next = { ...config, paused };
+    await assertWritableInside(p.root, p.config);
+    await atomicJson(p.config, next);
+    return next;
+}
+export async function projectId(cwd) {
+    return (await projectIdentity(cwd)).project_id;
+}
+export async function registerProject(root, cwd) {
+    await initVault(root);
+    const identity = await projectIdentity(cwd);
+    const p = vaultPaths(root);
+    const file = path.join(p.projects, `${identity.project_id}.json`);
+    await assertWritableInside(p.root, file);
+    const now = new Date().toISOString();
+    let createdAt = now;
+    try {
+        const existing = await readJson(file);
+        assertProjectRecord(existing);
+        assertProjectRecordPath(p, file, existing);
+        createdAt = existing.created_at;
+    }
+    catch { }
+    const record = { schema_version: 1, ...identity, created_at: createdAt, last_seen: now };
+    await assertWritableInside(p.root, file);
+    await atomicJson(file, record);
+    return record;
+}
+export async function listProjects(root) {
+    const p = vaultPaths(root);
+    return (await Promise.all((await listJsonFiles(p.projects, p.root)).map(async (file) => {
+        try {
+            const value = await readJson(file);
+            assertProjectRecord(value);
+            assertProjectRecordPath(p, file, value);
+            return value;
+        }
+        catch {
+            return undefined;
+        }
+    }))).filter((record) => Boolean(record)).sort((a, b) => b.last_seen.localeCompare(a.last_seen) || a.project_id.localeCompare(b.project_id));
+}
+async function projectIdentity(cwd) {
+    const requested = path.resolve(cwd);
+    const resolved = await realpath(requested).catch(() => requested);
+    const remote = await gitValue(resolved, ["config", "--get", "remote.origin.url"]);
+    const gitRoot = await gitValue(resolved, ["rev-parse", "--show-toplevel"]);
+    const rootPath = gitRoot ?? resolved;
+    const material = remote && gitRoot ? `${remote}\0${gitRoot}` : rootPath;
+    return {
+        project_id: `p_${createHash("sha256").update(material).digest("hex").slice(0, 16)}`,
+        display_name: path.basename(rootPath) || rootPath,
+        root_path: rootPath,
+        identity_source: remote && gitRoot ? "git_remote_root" : gitRoot ? "git_root" : "absolute_path"
+    };
+}
+async function gitValue(cwd, args) {
+    const { execFile } = await import("node:child_process");
+    return await new Promise((resolve) => {
+        execFile("git", args, { cwd }, (error, stdout) => resolve(error ? undefined : stdout.trim() || undefined));
+    });
+}
+export async function listJsonFiles(dir, boundaryRoot) {
+    try {
+        await assertWritableInside(boundaryRoot, dir);
+        await assertReadableInside(boundaryRoot, 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 listJsonFiles(target, boundaryRoot));
+            else if (entry.isFile() && entry.name.endsWith(".json"))
+                files.push(target);
+        }
+        return files.sort();
+    }
+    catch (error) {
+        if (error.code === "ENOENT")
+            return [];
+        throw error;
+    }
+}
+export async function vaultStats(root) {
+    const p = vaultPaths(root);
+    const config = await initVault(root);
+    const [raw, processed, enrichments, queue, pendingCaptures] = await Promise.all([
+        listJsonFiles(p.raw, p.root), listJsonFiles(p.processed, p.root), listJsonFiles(p.enrichments, p.root), listJsonFiles(p.queue, p.root), listJsonFiles(path.join(p.tmp, "pending"), p.root)
+    ]);
+    const queueCounts = { pending: 0, processing: 0, failed: 0, done: 0, invalid: 0 };
+    for (const file of queue) {
+        try {
+            const item = await readJson(file);
+            assertQueueItem(item);
+            assertQueueRecordPath(p, file, item);
+            queueCounts[item.status] += 1;
+        }
+        catch {
+            queueCounts.invalid += 1;
+        }
+    }
+    let bytes = 0;
+    for (const file of [...raw, ...processed, ...enrichments])
+        bytes += (await stat(file)).size;
+    return { paused: config.paused, raw_events: raw.length, processed_memories: processed.length, enriched_memories: enrichments.length, queue_items: queue.length, queue_pending: queueCounts.pending, queue_processing: queueCounts.processing, queue_failed: queueCounts.failed, queue_done: queueCounts.done, queue_invalid: queueCounts.invalid, pending_captures: pendingCaptures.length, bytes };
+}
+//# sourceMappingURL=vault.js.map

package/dist/vault.js.map

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

package/dist/windows-command.d.ts

@@ -0,0 +1,6 @@
+export declare function windowsCommand(input: {
+    adapter: string;
+    node: string;
+    hook: string;
+    runtimeIdentity?: string;
+}): string;

package/dist/windows-command.js

@@ -0,0 +1,9 @@
+export function windowsCommand(input) {
+    const adapter = ps(input.adapter);
+    const node = ps(input.node);
+    const hook = ps(input.hook);
+    const identity = input.runtimeIdentity ? `$env:LINGER_RUNTIME_ID='${ps(input.runtimeIdentity)}'; ` : "";
+    return `powershell.exe -NoProfile -Command "$env:LINGER_ADAPTER='${adapter}'; ${identity}& '${node}' '${hook}'"`;
+}
+function ps(value) { return value.replaceAll("'", "''"); }
+//# sourceMappingURL=windows-command.js.map

package/dist/windows-command.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"windows-command.js","sourceRoot":"","sources":["../src/windows-command.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,cAAc,CAAC,KAAgF;IAC7G,MAAM,OAAO,GAAG,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IAClC,MAAM,IAAI,GAAG,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAC5B,MAAM,IAAI,GAAG,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAC5B,MAAM,QAAQ,GAAG,KAAK,CAAC,eAAe,CAAC,CAAC,CAAC,2BAA2B,EAAE,CAAC,KAAK,CAAC,eAAe,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;IACxG,OAAO,4DAA4D,OAAO,MAAM,QAAQ,MAAM,IAAI,MAAM,IAAI,IAAI,CAAC;AACnH,CAAC;AAED,SAAS,EAAE,CAAC,KAAa,IAAY,OAAO,KAAK,CAAC,UAAU,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC"}

package/package.json

@@ -0,0 +1,53 @@
+{
+  "name": "linger-skill",
+  "version": "0.2.2",
+  "description": "File-native sidecar conversation archive and decision trail for coding agents.",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/arishana1969/linger-skill.git"
+  },
+  "homepage": "https://github.com/arishana1969/linger-skill#readme",
+  "bugs": {
+    "url": "https://github.com/arishana1969/linger-skill/issues"
+  },
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  },
+  "type": "module",
+  "bin": {
+    "linger-skill": "dist/cli.js",
+    "linger": "dist/cli.js",
+    "linger-eval": "dist/eval-cli.js"
+  },
+  "files": [
+    "dist",
+    "!dist/*.test.*",
+    "skills",
+    "README.md",
+    "README.zh-CN.md",
+    "CHANGELOG.md",
+    "PRIVACY.md",
+    "SECURITY.md",
+    "LICENSE",
+    "scripts/release-readiness.mjs"
+  ],
+  "engines": {
+    "node": ">=20"
+  },
+  "devDependencies": {
+    "@types/node": "^24.0.0",
+    "typescript": "^5.8.0"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "check": "tsc -p tsconfig.json --noEmit",
+    "test": "pnpm run build && node --test dist/*.test.js",
+    "eval:year": "node dist/eval-cli.js generate --output eval-data && node dist/eval-cli.js run --fixture eval-data/fixtures/linger-year-2025.json --oracle eval-data/oracle/linger-year-2025.oracle.json",
+    "eval:adversarial": "node dist/eval-cli.js adversarial",
+    "eval:heldout": "node dist/eval-cli.js heldout",
+    "verify:package": "node scripts/package-smoke.mjs",
+    "verify:release-metadata": "node scripts/release-readiness.mjs"
+  }
+}