@moreih29/nexus-core 0.12.0 → 0.14.0

package/dist/src/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/src/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/src/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/src/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/src/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/src/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"}

package/dist/src/shared/json-store.js

@@ -0,0 +1,163 @@
+import fs from "node:fs/promises";
+import { constants as fsConstants, appendFileSync, mkdirSync } from "node:fs";
+import path from "node:path";
+import { randomUUID } from "node:crypto";
+// ---------------------------------------------------------------------------
+// In-process mutex (serialises concurrent calls within the same process)
+// ---------------------------------------------------------------------------
+const inProcessQueues = new Map();
+async function runWithInProcessLock(filePath, action) {
+    const previous = inProcessQueues.get(filePath) ?? Promise.resolve();
+    let release = () => { };
+    const gate = new Promise((resolve) => {
+        release = resolve;
+    });
+    // The entry in the map is the combined promise so the next waiter queues behind both
+    const entry = previous.then(() => gate);
+    inProcessQueues.set(filePath, entry);
+    await previous;
+    try {
+        return await action();
+    }
+    finally {
+        release();
+        entry.finally(() => {
+            if (inProcessQueues.get(filePath) === entry) {
+                inProcessQueues.delete(filePath);
+            }
+        });
+    }
+}
+// ---------------------------------------------------------------------------
+// Cross-process file-system lock (.lock file, O_EXCL)
+// ---------------------------------------------------------------------------
+const LOCK_RETRY_INTERVAL_MS = 100;
+const LOCK_MAX_RETRIES = 50; // 5 seconds total
+const LOCK_STALE_MS = 30_000; // 30 seconds
+function lockPath(filePath) {
+    return `${filePath}.lock`;
+}
+async function acquireFsLock(filePath) {
+    const lp = lockPath(filePath);
+    for (let attempt = 0; attempt <= LOCK_MAX_RETRIES; attempt++) {
+        try {
+            // O_EXCL ensures atomic creation — only one process wins
+            const fd = await fs.open(lp, fsConstants.O_WRONLY | fsConstants.O_CREAT | fsConstants.O_EXCL);
+            await fd.close();
+            return;
+        }
+        catch (err) {
+            const e = err;
+            if (e.code !== "EEXIST")
+                throw err;
+            // Lock file exists — check if it is stale
+            try {
+                const stat = await fs.stat(lp);
+                const ageMs = Date.now() - stat.mtimeMs;
+                if (ageMs > LOCK_STALE_MS) {
+                    // Stale lock — remove and retry immediately
+                    await fs.unlink(lp).catch(() => undefined);
+                    continue;
+                }
+            }
+            catch {
+                // stat failed (lock vanished between check and here) — retry
+                continue;
+            }
+            if (attempt === LOCK_MAX_RETRIES) {
+                throw new Error(`Failed to acquire lock for "${filePath}" after ${LOCK_MAX_RETRIES} retries`);
+            }
+            await new Promise((resolve) => setTimeout(resolve, LOCK_RETRY_INTERVAL_MS));
+        }
+    }
+}
+async function releaseFsLock(filePath) {
+    await fs.unlink(lockPath(filePath)).catch(() => undefined);
+}
+// ---------------------------------------------------------------------------
+// Public API
+// ---------------------------------------------------------------------------
+/**
+ * Read a JSON file, returning `defaultValue` when the file does not exist or
+ * its content cannot be parsed.
+ */
+export async function readJsonFile(filePath, defaultValue) {
+    let raw;
+    try {
+        raw = await fs.readFile(filePath, "utf8");
+    }
+    catch (err) {
+        const e = err;
+        if (e.code === "ENOENT")
+            return defaultValue;
+        throw err;
+    }
+    try {
+        return JSON.parse(raw);
+    }
+    catch {
+        return defaultValue;
+    }
+}
+/**
+ * Atomically write a JSON file.
+ * Writes to a unique temp file then renames to the target path.
+ * Parent directories are created automatically.
+ */
+export async function writeJsonFile(filePath, data) {
+    await fs.mkdir(path.dirname(filePath), { recursive: true });
+    const tmpPath = `${filePath}.tmp.${process.pid}.${Date.now()}.${randomUUID()}`;
+    await fs.writeFile(tmpPath, JSON.stringify(data, null, 2) + "\n", "utf8");
+    await fs.rename(tmpPath, filePath);
+}
+/**
+ * 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 async function updateJsonFileLocked(filePath, defaultValue, updater) {
+    return runWithInProcessLock(filePath, async () => {
+        await acquireFsLock(filePath);
+        try {
+            const current = await readJsonFile(filePath, defaultValue);
+            const next = await updater(current);
+            await writeJsonFile(filePath, next);
+            return next;
+        }
+        finally {
+            await releaseFsLock(filePath);
+        }
+    });
+}
+// ---------------------------------------------------------------------------
+// Append-only JSONL helper
+// ---------------------------------------------------------------------------
+const APPEND_SIZE_WARN_THRESHOLD = 4 * 1024; // 4KB — OS write atomicity limit
+/**
+ * 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 function appendJsonLine(filePath, record) {
+    const line = JSON.stringify(record) + "\n";
+    if (line.length > APPEND_SIZE_WARN_THRESHOLD) {
+        console.error(`[json-store] appendJsonLine line exceeds ${APPEND_SIZE_WARN_THRESHOLD} bytes ` +
+            `(${line.length}) — write may not be atomic on some filesystems. path=${filePath}`);
+    }
+    mkdirSync(path.dirname(filePath), { recursive: true });
+    appendFileSync(filePath, line);
+}
+//# sourceMappingURL=json-store.js.map

package/dist/src/shared/json-store.js.map

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

package/dist/src/shared/mcp-utils.d.ts

@@ -0,0 +1,3 @@
+import type { CallToolResult } from "@modelcontextprotocol/sdk/types.js";
+export declare function textResult(obj: unknown): CallToolResult;
+//# sourceMappingURL=mcp-utils.d.ts.map

package/dist/src/shared/mcp-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-utils.d.ts","sourceRoot":"","sources":["../../../src/shared/mcp-utils.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AAEzE,wBAAgB,UAAU,CAAC,GAAG,EAAE,OAAO,GAAG,cAAc,CAIvD"}

package/dist/src/shared/mcp-utils.js

@@ -0,0 +1,6 @@
+export function textResult(obj) {
+    return {
+        content: [{ type: "text", text: JSON.stringify(obj, null, 2) }],
+    };
+}
+//# sourceMappingURL=mcp-utils.js.map

package/dist/src/shared/mcp-utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-utils.js","sourceRoot":"","sources":["../../../src/shared/mcp-utils.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,UAAU,CAAC,GAAY;IACrC,OAAO;QACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,GAAG,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC;KAChE,CAAC;AACJ,CAAC"}

package/dist/src/shared/paths.d.ts

@@ -0,0 +1,21 @@
+/**
+ * 프로젝트 루트 해석. 우선순위:
+ *   1. NEXUS_PROJECT_ROOT env (테스트·명시 주입용)
+ *   2. git rev-parse --show-toplevel (cwd 혹은 인자 기준)
+ *   3. cwd 상승하며 .git 수동 탐색
+ *   4. fallback: start 자체
+ */
+export declare function findProjectRoot(cwd?: string): string;
+/** .nexus/ 루트 경로 getter */
+export declare function getNexusRoot(cwd?: string): string;
+/** .nexus/state/ 경로 getter */
+export declare function getStateRoot(cwd?: string): string;
+/** 현재 git 브랜치명 반환. detached HEAD면 "HEAD" 또는 빈 문자열, git 없으면 빈 문자열 */
+export declare function getCurrentBranch(cwd?: string): string;
+/** 디렉토리 생성 (재귀). 이미 존재하면 idempotent */
+export declare function ensureDir(p: string): void;
+/** NEXUS_SESSION_ID env 우선, 없으면 '<branch>-<pid>' 또는 'unknown-<pid>' */
+export declare function getSessionId(cwd?: string): string;
+/** .nexus/state/<session_id>/ 경로 */
+export declare function getSessionRoot(cwd?: string): string;
+//# sourceMappingURL=paths.d.ts.map

package/dist/src/shared/paths.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.d.ts","sourceRoot":"","sources":["../../../src/shared/paths.ts"],"names":[],"mappings":"AAIA;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,MAAM,CAqBpD;AAED,2BAA2B;AAC3B,wBAAgB,YAAY,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,MAAM,CAEjD;AAED,8BAA8B;AAC9B,wBAAgB,YAAY,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,MAAM,CAEjD;AAED,oEAAoE;AACpE,wBAAgB,gBAAgB,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,MAAM,CAWrD;AAED,uCAAuC;AACvC,wBAAgB,SAAS,CAAC,CAAC,EAAE,MAAM,GAAG,IAAI,CAEzC;AAOD,uEAAuE;AACvE,wBAAgB,YAAY,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,MAAM,CAQjD;AAED,oCAAoC;AACpC,wBAAgB,cAAc,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,MAAM,CAEnD"}