@moreih29/nexus-core 0.11.0 → 0.13.0

package/dist/mcp/tools/task.js

@@ -0,0 +1,252 @@
+import { z } from "zod";
+import { join } from "node:path";
+import fs from "node:fs";
+import { getNexusRoot, getSessionRoot, getCurrentBranch, ensureDir } from "../../shared/paths.js";
+import { readJsonFile, updateJsonFileLocked } from "../../shared/json-store.js";
+import { textResult } from "../../shared/mcp-utils.js";
+import { logToolCall } from "../../shared/tool-log.js";
+import { TaskOwnerSchema, ResumeTierSchema } from "../../types/state.js";
+// ---------------------------------------------------------------------------
+// Internal helpers
+// ---------------------------------------------------------------------------
+function tasksPath() {
+    return join(getSessionRoot(), "tasks.json");
+}
+function planPath() {
+    return join(getSessionRoot(), "plan.json");
+}
+function historyPath() {
+    return join(getNexusRoot(), "history.json");
+}
+const defaultTasksFile = () => ({ tasks: [] });
+// Compute summary partition over all tasks (mutually exclusive).
+// - in_progress: status === "in_progress"
+// - completed: status === "completed"
+// - blocked: status === "pending" AND has at least one dep that is NOT completed
+// - ready: status === "pending" AND all deps are completed (or no deps)
+function computeSummary(tasks) {
+    const completedIds = new Set(tasks.filter((t) => t.status === "completed").map((t) => t.id));
+    const in_progress = [];
+    const completed = [];
+    const blocked = [];
+    const ready = [];
+    for (const task of tasks) {
+        if (task.status === "in_progress") {
+            in_progress.push(task.id);
+        }
+        else if (task.status === "completed") {
+            completed.push(task.id);
+        }
+        else {
+            // pending
+            const deps = task.deps ?? [];
+            const allDepsComplete = deps.every((dep) => completedIds.has(dep));
+            if (allDepsComplete) {
+                ready.push(task.id);
+            }
+            else {
+                blocked.push(task.id);
+            }
+        }
+    }
+    return { total: tasks.length, in_progress, completed, blocked, ready };
+}
+// ---------------------------------------------------------------------------
+// registerTaskTools
+// ---------------------------------------------------------------------------
+export function registerTaskTools(server) {
+    // -----------------------------------------------------------------------
+    // nx_task_add
+    // -----------------------------------------------------------------------
+    server.tool("nx_task_add", "새 task 추가 — tasks.json에 TaskItem 삽입", {
+        title: z.string().describe("Task 제목"),
+        context: z.string().describe("Task 컨텍스트 설명"),
+        acceptance: z.string().describe("완료 조건 (DoD) — 필수"),
+        approach: z.string().optional().describe("구현 접근법"),
+        risk: z.string().optional().describe("알려진 리스크"),
+        plan_issue: z.number().optional().describe("연관 plan issue ID"),
+        deps: z.array(z.number()).optional().describe("선행 task ID 목록"),
+        owner: TaskOwnerSchema.describe("소유자 정보 (role 필수)"),
+        goal: z.string().optional().describe("tasks.json top-level goal 갱신"),
+        decisions: z.array(z.string()).optional().describe("tasks.json top-level decisions append"),
+    }, async ({ title, context, acceptance, approach, risk, plan_issue, deps, owner, goal, decisions }) => {
+        const t0 = Date.now();
+        const tPath = tasksPath();
+        let newTask;
+        await updateJsonFileLocked(tPath, defaultTasksFile(), (data) => {
+            if (goal !== undefined) {
+                data.goal = goal;
+            }
+            if (decisions !== undefined && decisions.length > 0) {
+                data.decisions = [...(data.decisions ?? []), ...decisions];
+            }
+            // Validate deps
+            if (deps && deps.length > 0) {
+                const existingIds = new Set(data.tasks.map((t) => t.id));
+                for (let i = 0; i < deps.length; i++) {
+                    if (!existingIds.has(deps[i])) {
+                        throw new Error(`deps[${i}] does not exist: task id ${deps[i]} not found`);
+                    }
+                }
+            }
+            const maxId = data.tasks.reduce((m, t) => Math.max(m, t.id), 0);
+            newTask = {
+                id: maxId + 1,
+                title,
+                status: "pending",
+                context,
+                acceptance,
+                ...(approach !== undefined ? { approach } : {}),
+                ...(risk !== undefined ? { risk } : {}),
+                ...(plan_issue !== undefined ? { plan_issue } : {}),
+                ...(deps !== undefined && deps.length > 0 ? { deps } : {}),
+                owner,
+                created_at: new Date().toISOString(),
+            };
+            data.tasks.push(newTask);
+            return data;
+        });
+        const response = { task: newTask };
+        logToolCall({ tool: "nx_task_add", args: { title, owner }, response, duration_ms: Date.now() - t0 });
+        return textResult(response);
+    });
+    // -----------------------------------------------------------------------
+    // nx_task_list
+    // -----------------------------------------------------------------------
+    server.tool("nx_task_list", "tasks.json 조회 — task 목록 및 summary 반환", {
+        include_completed: z.boolean().optional().describe("완료 task 포함 여부 (기본 true)"),
+    }, async ({ include_completed = true }) => {
+        const t0 = Date.now();
+        const data = await readJsonFile(tasksPath(), null);
+        if (!data) {
+            const response = { tasks: [], summary: { total: 0, in_progress: [], completed: [], blocked: [], ready: [] } };
+            logToolCall({ tool: "nx_task_list", args: { include_completed }, response, duration_ms: Date.now() - t0 });
+            return textResult(response);
+        }
+        // summary is always computed over ALL tasks regardless of include_completed
+        const summary = computeSummary(data.tasks);
+        const tasks = include_completed
+            ? data.tasks
+            : data.tasks.filter((t) => t.status !== "completed");
+        const response = { tasks, summary };
+        if (data.goal !== undefined)
+            response.goal = data.goal;
+        logToolCall({ tool: "nx_task_list", args: { include_completed }, response, duration_ms: Date.now() - t0 });
+        return textResult(response);
+    });
+    // -----------------------------------------------------------------------
+    // nx_task_update
+    // -----------------------------------------------------------------------
+    // Update owner schema — role 갱신 불가, agent_id/resume_tier nullable
+    const TaskOwnerUpdateSchema = z.object({
+        agent_id: z.string().nullable().optional(),
+        resume_tier: ResumeTierSchema.nullable().optional(),
+    });
+    server.tool("nx_task_update", "Task status 또는 owner 메타데이터 부분 갱신", {
+        id: z.number().describe("갱신할 task ID"),
+        status: z.enum(["pending", "in_progress", "completed"]).optional().describe("새 상태"),
+        owner: TaskOwnerUpdateSchema.optional().describe("owner 부분 갱신 (agent_id, resume_tier만 — role 갱신 불가)"),
+    }, async ({ id, status, owner }) => {
+        const t0 = Date.now();
+        const tPath = tasksPath();
+        let updatedTask;
+        await updateJsonFileLocked(tPath, defaultTasksFile(), (data) => {
+            const task = data.tasks.find((t) => t.id === id);
+            if (!task)
+                throw new Error(`Task ${id} not found`);
+            if (status !== undefined) {
+                task.status = status;
+            }
+            if (owner !== undefined) {
+                if ("agent_id" in owner) {
+                    const val = owner.agent_id;
+                    if (val === null || val === "") {
+                        delete task.owner.agent_id;
+                    }
+                    else if (val !== undefined) {
+                        task.owner.agent_id = val;
+                    }
+                }
+                if ("resume_tier" in owner) {
+                    const val = owner.resume_tier;
+                    if (val === null) {
+                        delete task.owner.resume_tier;
+                    }
+                    else if (val !== undefined) {
+                        task.owner.resume_tier = val;
+                    }
+                }
+            }
+            updatedTask = task;
+            return data;
+        });
+        const response = { task: updatedTask };
+        logToolCall({ tool: "nx_task_update", args: { id, status }, response, duration_ms: Date.now() - t0 });
+        return textResult(response);
+    });
+    // -----------------------------------------------------------------------
+    // nx_task_close
+    // -----------------------------------------------------------------------
+    server.tool("nx_task_close", "현재 사이클 종료 — history.json에 아카이브 후 plan.json·tasks.json 삭제", {}, async () => {
+        const t0 = Date.now();
+        const tPath = tasksPath();
+        const pPath = planPath();
+        const hPath = historyPath();
+        const tasksData = await readJsonFile(tPath, null);
+        const planData = await readJsonFile(pPath, null);
+        const tasks = tasksData?.tasks ?? [];
+        const plan_id = planData?.id ?? null;
+        const task_count = tasks.length;
+        const incomplete_count = tasks.filter((t) => t.status !== "completed").length;
+        // Append to history.json
+        await updateJsonFileLocked(hPath, { cycles: [] }, (history) => {
+            history.cycles.push({
+                schema_version: "1.0",
+                completed_at: new Date().toISOString(),
+                branch: getCurrentBranch(),
+                ...(planData ? { plan: planData } : {}),
+                tasks,
+            });
+            return history;
+        });
+        // Unlink plan.json and tasks.json
+        ensureDir(getNexusRoot());
+        try {
+            fs.unlinkSync(pPath);
+        }
+        catch { /* not present */ }
+        try {
+            fs.unlinkSync(tPath);
+        }
+        catch { /* not present */ }
+        const response = { closed: true, plan_id, task_count, incomplete_count };
+        logToolCall({ tool: "nx_task_close", args: {}, response, duration_ms: Date.now() - t0 });
+        return textResult(response);
+    });
+    // -----------------------------------------------------------------------
+    // nx_task_resume
+    // -----------------------------------------------------------------------
+    server.tool("nx_task_resume", "Task resume 라우팅 정보 조회 — owner.resume_tier 기반 정책 반환", {
+        id: z.number().describe("조회할 task ID"),
+    }, async ({ id }) => {
+        const t0 = Date.now();
+        const data = await readJsonFile(tasksPath(), null);
+        if (!data)
+            throw new Error(`Task ${id} not found`);
+        const task = data.tasks.find((t) => t.id === id);
+        if (!task)
+            throw new Error(`Task ${id} not found`);
+        const resumable = task.owner.resume_tier !== undefined && task.owner.resume_tier !== null;
+        const agent_id = task.owner.agent_id ?? null;
+        const resume_tier = task.owner.resume_tier ?? null;
+        const response = {
+            task_id: task.id,
+            resumable,
+            agent_id,
+            resume_tier,
+        };
+        logToolCall({ tool: "nx_task_resume", args: { id }, response, duration_ms: Date.now() - t0 });
+        return textResult(response);
+    });
+}
+//# sourceMappingURL=task.js.map

package/dist/mcp/tools/task.js.map

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

package/dist/shared/invocations.d.ts

@@ -0,0 +1,74 @@
+/**
+ * src/shared/invocations.ts
+ *
+ * expandInvocation — cross-harness invocation template expansion.
+ *
+ * Resolves {{template_name key=value ...}} placeholders in agent/skill body.md
+ * to harness-native call syntax as defined in assets/tools/tool-name-map.yml
+ * invocations section.
+ *
+ * Supported templates (4):
+ *   {{subagent_spawn target_role=<role> prompt=<text> [name=<label>]}}
+ *   {{skill_activation skill=<name> [mode=<mode>]}}
+ *   {{task_register label=<text> state=<text>}}
+ *   {{user_question question=<text> options=<json-array>}}
+ */
+export type Harness = "claude" | "opencode" | "codex";
+export interface InvocationTemplate {
+    args: string[];
+    templates: Record<Harness, string>;
+}
+export interface InvocationsMap {
+    [name: string]: InvocationTemplate;
+}
+/**
+ * Parse a {{...}} invocation call string into its template name and key=value args.
+ *
+ * Format: {{template_name key1=value1 key2=value2 ...}}
+ * Values may be:
+ *   - double-quoted strings: "..."
+ *   - bracket-balanced arrays: [...]
+ *   - brace-balanced objects: {...}
+ *   - plain non-whitespace tokens
+ *
+ * Returns null if the format is invalid.
+ */
+export declare function parseInvocationCall(call: string): {
+    name: string;
+    args: Record<string, string>;
+} | null;
+/**
+ * Apply a single invocation template for the given harness.
+ *
+ * Substitutes {placeholder} tokens in the template string with arg values.
+ * Optional args (those not in the args map) are omitted along with their
+ * surrounding delimiters when absent.
+ *
+ * Returns the harness-native syntax string, or an error comment if the
+ * template name is unknown or a required arg is missing.
+ */
+export declare function applyTemplate(templateStr: string, args: Record<string, string>, templateDef: InvocationTemplate): string;
+/**
+ * Expand a single {{...}} invocation expression to harness-native syntax.
+ *
+ * @param expression  The content inside {{ }}, e.g. "subagent_spawn target_role=engineer prompt=Fix the bug"
+ * @param harness     Target harness: "claude" | "opencode" | "codex"
+ * @param invocations Parsed invocations map from tool-name-map.yml
+ *
+ * Returns the expanded string, or a comment if unknown/invalid.
+ */
+export declare function expandInvocationExpression(expression: string, harness: Harness, invocations: InvocationsMap): string;
+/**
+ * Expand all {{...}} invocation placeholders in a body string.
+ *
+ * Uses a balance-counter scanner so that nested `{}` inside argument values
+ * (e.g. options=[{label: "Set up"}]) are correctly included in the match.
+ *
+ * @param input       Raw body.md content (may contain multiple {{}} blocks)
+ * @param harness     Target harness
+ * @param invocations Parsed invocations map
+ *
+ * Returns the body with all {{}} templates replaced by harness-native syntax.
+ */
+export declare function expandInvocations(input: string, harness: Harness, invocations: InvocationsMap): string;
+//# sourceMappingURL=invocations.d.ts.map

package/dist/shared/invocations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"invocations.d.ts","sourceRoot":"","sources":["../../src/shared/invocations.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,MAAM,MAAM,OAAO,GAAG,QAAQ,GAAG,UAAU,GAAG,OAAO,CAAC;AAEtD,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,SAAS,EAAE,MAAM,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;CACpC;AAED,MAAM,WAAW,cAAc;IAC7B,CAAC,IAAI,EAAE,MAAM,GAAG,kBAAkB,CAAC;CACpC;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG;IACjD,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC9B,GAAG,IAAI,CAmGP;AAED;;;;;;;;;GASG;AACH,wBAAgB,aAAa,CAC3B,WAAW,EAAE,MAAM,EACnB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAC5B,WAAW,EAAE,kBAAkB,GAC9B,MAAM,CAgBR;AAED;;;;;;;;GAQG;AACH,wBAAgB,0BAA0B,CACxC,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,OAAO,EAChB,WAAW,EAAE,cAAc,GAC1B,MAAM,CAiBR;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,OAAO,EAChB,WAAW,EAAE,cAAc,GAC1B,MAAM,CAqDR"}

package/dist/shared/invocations.js

@@ -0,0 +1,247 @@
+/**
+ * src/shared/invocations.ts
+ *
+ * expandInvocation — cross-harness invocation template expansion.
+ *
+ * Resolves {{template_name key=value ...}} placeholders in agent/skill body.md
+ * to harness-native call syntax as defined in assets/tools/tool-name-map.yml
+ * invocations section.
+ *
+ * Supported templates (4):
+ *   {{subagent_spawn target_role=<role> prompt=<text> [name=<label>]}}
+ *   {{skill_activation skill=<name> [mode=<mode>]}}
+ *   {{task_register label=<text> state=<text>}}
+ *   {{user_question question=<text> options=<json-array>}}
+ */
+/**
+ * Parse a {{...}} invocation call string into its template name and key=value args.
+ *
+ * Format: {{template_name key1=value1 key2=value2 ...}}
+ * Values may be:
+ *   - double-quoted strings: "..."
+ *   - bracket-balanced arrays: [...]
+ *   - brace-balanced objects: {...}
+ *   - plain non-whitespace tokens
+ *
+ * Returns null if the format is invalid.
+ */
+export function parseInvocationCall(call) {
+    // call is the content inside {{ }}
+    const trimmed = call.trim();
+    if (!trimmed)
+        return null;
+    // Extract template name (first token)
+    const firstSpace = trimmed.indexOf(" ");
+    const name = firstSpace === -1 ? trimmed : trimmed.slice(0, firstSpace);
+    const rest = firstSpace === -1 ? "" : trimmed.slice(firstSpace + 1).trim();
+    const args = {};
+    if (rest) {
+        // Manual tokenizer: scan for key=<value> pairs where <value> may contain
+        // nested brackets/braces or quoted strings.
+        let i = 0;
+        while (i < rest.length) {
+            // Skip whitespace
+            while (i < rest.length && /\s/.test(rest[i]))
+                i++;
+            if (i >= rest.length)
+                break;
+            // Read key (word chars up to '=')
+            const keyStart = i;
+            while (i < rest.length && /\w/.test(rest[i]))
+                i++;
+            if (i >= rest.length || rest[i] !== "=") {
+                // Not a valid key=value pair — skip this token
+                while (i < rest.length && !/\s/.test(rest[i]))
+                    i++;
+                continue;
+            }
+            const key = rest.slice(keyStart, i);
+            i++; // consume '='
+            if (i >= rest.length)
+                break;
+            // Read value: dispatch on first character
+            let value = "";
+            const ch = rest[i];
+            if (ch === '"') {
+                // Quoted string — scan to closing unescaped quote
+                i++; // consume opening quote
+                const start = i;
+                while (i < rest.length) {
+                    if (rest[i] === "\\" && i + 1 < rest.length) {
+                        i += 2; // skip escape sequence
+                    }
+                    else if (rest[i] === '"') {
+                        break;
+                    }
+                    else {
+                        i++;
+                    }
+                }
+                value = rest.slice(start, i).replace(/\\"/g, '"');
+                if (i < rest.length)
+                    i++; // consume closing quote
+            }
+            else if (ch === "[" || ch === "{") {
+                // Bracket/brace balanced scan
+                const open = ch;
+                const close = open === "[" ? "]" : "}";
+                let depth = 0;
+                const start = i;
+                while (i < rest.length) {
+                    const c = rest[i];
+                    if (c === '"') {
+                        // Skip quoted section inside array/object
+                        i++;
+                        while (i < rest.length) {
+                            if (rest[i] === "\\" && i + 1 < rest.length) {
+                                i += 2;
+                            }
+                            else if (rest[i] === '"') {
+                                i++;
+                                break;
+                            }
+                            else {
+                                i++;
+                            }
+                        }
+                        continue;
+                    }
+                    if (c === open)
+                        depth++;
+                    else if (c === close) {
+                        depth--;
+                        if (depth === 0) {
+                            i++; // consume closing bracket
+                            break;
+                        }
+                    }
+                    i++;
+                }
+                value = rest.slice(start, i);
+            }
+            else {
+                // Plain non-whitespace token
+                const start = i;
+                while (i < rest.length && !/\s/.test(rest[i]))
+                    i++;
+                value = rest.slice(start, i);
+            }
+            if (key)
+                args[key] = value;
+        }
+    }
+    return { name, args };
+}
+/**
+ * Apply a single invocation template for the given harness.
+ *
+ * Substitutes {placeholder} tokens in the template string with arg values.
+ * Optional args (those not in the args map) are omitted along with their
+ * surrounding delimiters when absent.
+ *
+ * Returns the harness-native syntax string, or an error comment if the
+ * template name is unknown or a required arg is missing.
+ */
+export function applyTemplate(templateStr, args, templateDef) {
+    let result = templateStr;
+    // Replace all {key} tokens with their values
+    for (const [key, value] of Object.entries(args)) {
+        result = result.replace(new RegExp(`\\{${key}\\}`, "g"), value);
+    }
+    // Remove any remaining optional placeholders that have no value
+    // Pattern: `, "description": "{name}"` or similar — strip the whole field segment
+    // We handle this by removing ", key: "{remaining_token}"" patterns
+    result = result.replace(/,?\s*\w+:\s*"\{[^}]+\}"/g, "");
+    // Also handle ", description: {name}" without quotes (less common but defensive)
+    result = result.replace(/,?\s*\w+:\s*\{[^}]+\}/g, "");
+    return result;
+}
+/**
+ * Expand a single {{...}} invocation expression to harness-native syntax.
+ *
+ * @param expression  The content inside {{ }}, e.g. "subagent_spawn target_role=engineer prompt=Fix the bug"
+ * @param harness     Target harness: "claude" | "opencode" | "codex"
+ * @param invocations Parsed invocations map from tool-name-map.yml
+ *
+ * Returns the expanded string, or a comment if unknown/invalid.
+ */
+export function expandInvocationExpression(expression, harness, invocations) {
+    const parsed = parseInvocationCall(expression);
+    if (!parsed) {
+        return `/* [nexus] invalid invocation: ${expression.trim()} */`;
+    }
+    const def = invocations[parsed.name];
+    if (!def) {
+        return `/* [nexus] unknown invocation: ${parsed.name} */`;
+    }
+    const templateStr = def.templates[harness];
+    if (!templateStr) {
+        return `/* [nexus] no template for harness ${harness}: ${parsed.name} */`;
+    }
+    return applyTemplate(templateStr, parsed.args, def);
+}
+/**
+ * Expand all {{...}} invocation placeholders in a body string.
+ *
+ * Uses a balance-counter scanner so that nested `{}` inside argument values
+ * (e.g. options=[{label: "Set up"}]) are correctly included in the match.
+ *
+ * @param input       Raw body.md content (may contain multiple {{}} blocks)
+ * @param harness     Target harness
+ * @param invocations Parsed invocations map
+ *
+ * Returns the body with all {{}} templates replaced by harness-native syntax.
+ */
+export function expandInvocations(input, harness, invocations) {
+    let result = "";
+    let i = 0;
+    while (i < input.length) {
+        // Find the next '{{'
+        const openIdx = input.indexOf("{{", i);
+        if (openIdx === -1) {
+            result += input.slice(i);
+            break;
+        }
+        // Append text before the '{{'
+        result += input.slice(i, openIdx);
+        i = openIdx + 2; // move past '{{'
+        // Scan forward with brace depth to find the matching '}}'
+        // We start after '{{', depth tracks inner '{' vs '}'
+        let depth = 0;
+        let innerStart = i;
+        let found = false;
+        while (i < input.length) {
+            if (input[i] === "{") {
+                depth++;
+                i++;
+            }
+            else if (input[i] === "}") {
+                if (depth === 0 && input[i + 1] === "}") {
+                    // Found the closing '}}'
+                    const inner = input.slice(innerStart, i);
+                    result += expandInvocationExpression(inner, harness, invocations);
+                    i += 2; // consume '}}'
+                    found = true;
+                    break;
+                }
+                else if (depth > 0) {
+                    depth--;
+                    i++;
+                }
+                else {
+                    // Single '}' with no matching depth — treat as literal
+                    i++;
+                }
+            }
+            else {
+                i++;
+            }
+        }
+        if (!found) {
+            // No closing '}}' — treat the '{{' as literal text
+            result += "{{" + input.slice(innerStart, i);
+        }
+    }
+    return result;
+}
+//# sourceMappingURL=invocations.js.map

package/dist/shared/invocations.js.map

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

package/dist/shared/json-store.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Read a JSON file, returning `defaultValue` when the file does not exist or
+ * its content cannot be parsed.
+ */
+export declare function readJsonFile<T>(filePath: string, defaultValue: T): Promise<T>;
+/**
+ * Atomically write a JSON file.
+ * Writes to a unique temp file then renames to the target path.
+ * Parent directories are created automatically.
+ */
+export declare function writeJsonFile<T>(filePath: string, data: T): Promise<void>;
+/**
+ * Read-modify-write a JSON file under a two-layer lock.
+ *
+ * Layer 1 — in-process promise queue: serialises concurrent calls within the
+ * same Node/Bun process with zero overhead and no retry cost.
+ *
+ * Layer 2 — cross-process `.lock` file (O_EXCL): prevents data races between
+ * separate processes. Retries every 100 ms for up to 50 attempts (5 s total).
+ * Stale locks (mtime > 30 s) are forcibly removed before retry.
+ *
+ * The lock is always released even when `updater` throws.
+ */
+export declare function updateJsonFileLocked<T>(filePath: string, defaultValue: T, updater: (current: T) => T | Promise<T>): Promise<T>;
+/**
+ * Append a single JSON record as one line to a `.jsonl` file.
+ *
+ * Uses the OS `write(2)` syscall via `appendFileSync`, which is atomic for
+ * writes up to ~4 KB on most POSIX filesystems. Lines exceeding that threshold
+ * trigger a `console.error` warning but are still written (best-effort).
+ *
+ * No lock is acquired — concurrent appenders are safe at the line level
+ * because each call is a single `write(2)` syscall.
+ * Parent directories are created automatically.
+ */
+export declare function appendJsonLine(filePath: string, record: unknown): void;
+//# sourceMappingURL=json-store.d.ts.map

package/dist/shared/json-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"json-store.d.ts","sourceRoot":"","sources":["../../src/shared/json-store.ts"],"names":[],"mappings":"AA0FA;;;GAGG;AACH,wBAAsB,YAAY,CAAC,CAAC,EAAE,QAAQ,EAAE,MAAM,EAAE,YAAY,EAAE,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAenF;AAED;;;;GAIG;AACH,wBAAsB,aAAa,CAAC,CAAC,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAK/E;AAED;;;;;;;;;;;GAWG;AACH,wBAAsB,oBAAoB,CAAC,CAAC,EAC1C,QAAQ,EAAE,MAAM,EAChB,YAAY,EAAE,CAAC,EACf,OAAO,EAAE,CAAC,OAAO,EAAE,CAAC,KAAK,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,GACtC,OAAO,CAAC,CAAC,CAAC,CAYZ;AAQD;;;;;;;;;;GAUG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,GAAG,IAAI,CAYtE"}