@squadrules/mcp 4.8.6

package/dist/utils/dump-markdown.js

@@ -0,0 +1,62 @@
+/**
+ * YAML frontmatter for protocol dumps (round-trip with train).
+ * Slug and version values are constrained when storing via train; kept single-line.
+ */
+export function buildProtocolYamlFrontmatter(slug, protocolVersion, chainRoot) {
+    const s = (slug || '').trim();
+    const lines = ['---', `slug: ${s || 'protocol'}`];
+    const v = protocolVersion?.trim();
+    if (v)
+        lines.push(`version: ${v}`);
+    const cr = chainRoot?.trim();
+    if (cr)
+        lines.push(`chain_root: ${cr}`);
+    lines.push('---', '');
+    // Blank line after frontmatter before H1
+    return `${lines.join('\n')}\n`;
+}
+/**
+ * Remove a redundant H2 that matches the step label from memory body before
+ * protocol dump prepends `## {label}`.
+ *
+ * Minting derives `label` from the first `##` line in the segment (any line),
+ * but the stored body can include prose before that heading. The previous
+ * implementation only stripped when `## label` was the first line, which
+ * produced duplicate H2s in protocol dump output.
+ */
+export function stripRedundantStepH2(body, label) {
+    if (!body || !label)
+        return body;
+    const labelNorm = label.trim();
+    if (!labelNorm)
+        return body;
+    const lines = body.split(/\r?\n/);
+    let inFence = false;
+    let matchIndex = -1;
+    for (let i = 0; i < lines.length; i++) {
+        const trimmedLine = lines[i].trim();
+        if (trimmedLine.startsWith('```')) {
+            inFence = !inFence;
+            continue;
+        }
+        if (inFence)
+            continue;
+        const m = lines[i].match(/^\s*##\s+(.+)\s*$/);
+        if (m && m[1].trim() === labelNorm) {
+            matchIndex = i;
+            break;
+        }
+    }
+    if (matchIndex === -1)
+        return body;
+    const next = [...lines.slice(0, matchIndex), ...lines.slice(matchIndex + 1)];
+    // Removing "## Title" often leaves two blank lines where one is enough
+    if (matchIndex > 0 &&
+        matchIndex < next.length &&
+        next[matchIndex - 1] === '' &&
+        next[matchIndex] === '') {
+        next.splice(matchIndex, 1);
+    }
+    return next.join('\n').trimStart();
+}
+//# sourceMappingURL=dump-markdown.js.map

package/dist/utils/dump-markdown.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dump-markdown.js","sourceRoot":"","sources":["../../src/utils/dump-markdown.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,UAAU,4BAA4B,CAAC,IAAY,EAAE,eAAwB,EAAE,SAAkB;IACrG,MAAM,CAAC,GAAG,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;IAC9B,MAAM,KAAK,GAAG,CAAC,KAAK,EAAE,SAAS,CAAC,IAAI,UAAU,EAAE,CAAC,CAAC;IAClD,MAAM,CAAC,GAAG,eAAe,EAAE,IAAI,EAAE,CAAC;IAClC,IAAI,CAAC;QAAE,KAAK,CAAC,IAAI,CAAC,YAAY,CAAC,EAAE,CAAC,CAAC;IACnC,MAAM,EAAE,GAAG,SAAS,EAAE,IAAI,EAAE,CAAC;IAC7B,IAAI,EAAE;QAAE,KAAK,CAAC,IAAI,CAAC,eAAe,EAAE,EAAE,CAAC,CAAC;IACxC,KAAK,CAAC,IAAI,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;IACtB,yCAAyC;IACzC,OAAO,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC;AACjC,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,oBAAoB,CAAC,IAAY,EAAE,KAAa;IAC9D,IAAI,CAAC,IAAI,IAAI,CAAC,KAAK;QAAE,OAAO,IAAI,CAAC;IACjC,MAAM,SAAS,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC;IAC/B,IAAI,CAAC,SAAS;QAAE,OAAO,IAAI,CAAC;IAE5B,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IAClC,IAAI,OAAO,GAAG,KAAK,CAAC;IACpB,IAAI,UAAU,GAAG,CAAC,CAAC,CAAC;IAEpB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACtC,MAAM,WAAW,GAAG,KAAK,CAAC,CAAC,CAAE,CAAC,IAAI,EAAE,CAAC;QACrC,IAAI,WAAW,CAAC,UAAU,CAAC,KAAK,CAAC,EAAE,CAAC;YAClC,OAAO,GAAG,CAAC,OAAO,CAAC;YACnB,SAAS;QACX,CAAC;QACD,IAAI,OAAO;YAAE,SAAS;QAEtB,MAAM,CAAC,GAAG,KAAK,CAAC,CAAC,CAAE,CAAC,KAAK,CAAC,mBAAmB,CAAC,CAAC;QAC/C,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAE,CAAC,IAAI,EAAE,KAAK,SAAS,EAAE,CAAC;YACpC,UAAU,GAAG,CAAC,CAAC;YACf,MAAM;QACR,CAAC;IACH,CAAC;IAED,IAAI,UAAU,KAAK,CAAC,CAAC;QAAE,OAAO,IAAI,CAAC;IAEnC,MAAM,IAAI,GAAG,CAAC,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,UAAU,CAAC,EAAE,GAAG,KAAK,CAAC,KAAK,CAAC,UAAU,GAAG,CAAC,CAAC,CAAC,CAAC;IAC7E,uEAAuE;IACvE,IACE,UAAU,GAAG,CAAC;QACd,UAAU,GAAG,IAAI,CAAC,MAAM;QACxB,IAAI,CAAC,UAAU,GAAG,CAAC,CAAC,KAAK,EAAE;QAC3B,IAAI,CAAC,UAAU,CAAC,KAAK,EAAE,EACvB,CAAC;QACD,IAAI,CAAC,MAAM,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC;IAC7B,CAAC;IACD,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,CAAC;AACrC,CAAC"}

package/dist/utils/frontmatter.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Parse YAML-like frontmatter at the start of a markdown document.
+ * Content between first --- and second --- is parsed for key: value lines.
+ * Returns extracted metadata and the body (rest of document after closing ---).
+ */
+export interface ParsedFrontmatter {
+    version?: string;
+    title?: string;
+    /** Present when the document had a `slug:` key in frontmatter (value may be empty). */
+    slugRaw?: string;
+    /** Present when the document had a `chain_root:` key in frontmatter (slug of the chain entry-point adapter). */
+    chainRoot?: string;
+    body: string;
+}
+/**
+ * Parse frontmatter from the start of text. If no closing --- is found,
+ * returns body as the original text and no metadata.
+ */
+export declare function parseFrontmatter(text: string): ParsedFrontmatter;
+//# sourceMappingURL=frontmatter.d.ts.map

package/dist/utils/frontmatter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"frontmatter.d.ts","sourceRoot":"","sources":["../../src/utils/frontmatter.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,MAAM,WAAW,iBAAiB;IAChC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,uFAAuF;IACvF,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,gHAAgH;IAChH,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;CACd;AAID;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,iBAAiB,CA+BhE"}

package/dist/utils/frontmatter.js

@@ -0,0 +1,43 @@
+/**
+ * Parse YAML-like frontmatter at the start of a markdown document.
+ * Content between first --- and second --- is parsed for key: value lines.
+ * Returns extracted metadata and the body (rest of document after closing ---).
+ */
+const FRONTMATTER_DELIM = '---';
+/**
+ * Parse frontmatter from the start of text. If no closing --- is found,
+ * returns body as the original text and no metadata.
+ */
+export function parseFrontmatter(text) {
+    const trimmed = text.trimStart();
+    if (!trimmed.startsWith(FRONTMATTER_DELIM)) {
+        return { body: text };
+    }
+    const afterFirst = trimmed.slice(FRONTMATTER_DELIM.length);
+    const secondIndex = afterFirst.indexOf('\n' + FRONTMATTER_DELIM);
+    if (secondIndex === -1) {
+        return { body: text };
+    }
+    const fmLines = afterFirst.slice(0, secondIndex).trim().split(/\r?\n/);
+    const body = afterFirst.slice(secondIndex + FRONTMATTER_DELIM.length + 1).trimStart();
+    const result = { body };
+    for (const line of fmLines) {
+        const colon = line.indexOf(':');
+        if (colon === -1)
+            continue;
+        const key = line.slice(0, colon).trim().toLowerCase();
+        const value = line.slice(colon + 1).trim().replace(/^['"]|['"]$/g, '');
+        if (key === 'version' && value)
+            result.version = value;
+        if (key === 'title' && value)
+            result.title = value;
+        if (key === 'slug') {
+            result.slugRaw = value;
+        }
+        if ((key === 'chain_root' || key === 'chainroot') && value) {
+            result.chainRoot = value;
+        }
+    }
+    return result;
+}
+//# sourceMappingURL=frontmatter.js.map

package/dist/utils/frontmatter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"frontmatter.js","sourceRoot":"","sources":["../../src/utils/frontmatter.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAYH,MAAM,iBAAiB,GAAG,KAAK,CAAC;AAEhC;;;GAGG;AACH,MAAM,UAAU,gBAAgB,CAAC,IAAY;IAC3C,MAAM,OAAO,GAAG,IAAI,CAAC,SAAS,EAAE,CAAC;IACjC,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,iBAAiB,CAAC,EAAE,CAAC;QAC3C,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;IACxB,CAAC;IAED,MAAM,UAAU,GAAG,OAAO,CAAC,KAAK,CAAC,iBAAiB,CAAC,MAAM,CAAC,CAAC;IAC3D,MAAM,WAAW,GAAG,UAAU,CAAC,OAAO,CAAC,IAAI,GAAG,iBAAiB,CAAC,CAAC;IACjE,IAAI,WAAW,KAAK,CAAC,CAAC,EAAE,CAAC;QACvB,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;IACxB,CAAC;IAED,MAAM,OAAO,GAAG,UAAU,CAAC,KAAK,CAAC,CAAC,EAAE,WAAW,CAAC,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IACvE,MAAM,IAAI,GAAG,UAAU,CAAC,KAAK,CAAC,WAAW,GAAG,iBAAiB,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,SAAS,EAAE,CAAC;IAEtF,MAAM,MAAM,GAAsB,EAAE,IAAI,EAAE,CAAC;IAC3C,KAAK,MAAM,IAAI,IAAI,OAAO,EAAE,CAAC;QAC3B,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QAChC,IAAI,KAAK,KAAK,CAAC,CAAC;YAAE,SAAS;QAC3B,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;QACtD,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,OAAO,CAAC,cAAc,EAAE,EAAE,CAAC,CAAC;QACvE,IAAI,GAAG,KAAK,SAAS,IAAI,KAAK;YAAE,MAAM,CAAC,OAAO,GAAG,KAAK,CAAC;QACvD,IAAI,GAAG,KAAK,OAAO,IAAI,KAAK;YAAE,MAAM,CAAC,KAAK,GAAG,KAAK,CAAC;QACnD,IAAI,GAAG,KAAK,MAAM,EAAE,CAAC;YACnB,MAAM,CAAC,OAAO,GAAG,KAAK,CAAC;QACzB,CAAC;QACD,IAAI,CAAC,GAAG,KAAK,YAAY,IAAI,GAAG,KAAK,WAAW,CAAC,IAAI,KAAK,EAAE,CAAC;YAC3D,MAAM,CAAC,SAAS,GAAG,KAAK,CAAC;QAC3B,CAAC;IACH,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/utils/global-error-handlers.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Global process-level error handlers for KAIROS MCP
+ * Captures uncaught exceptions, unhandled rejections, and Node warnings
+ * and forwards them to the structured logger.
+ */
+export declare function installGlobalErrorHandlers(): void;
+//# sourceMappingURL=global-error-handlers.d.ts.map

package/dist/utils/global-error-handlers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"global-error-handlers.d.ts","sourceRoot":"","sources":["../../src/utils/global-error-handlers.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAMH,wBAAgB,0BAA0B,SAkDzC"}

package/dist/utils/global-error-handlers.js

@@ -0,0 +1,61 @@
+/**
+ * Global process-level error handlers for KAIROS MCP
+ * Captures uncaught exceptions, unhandled rejections, and Node warnings
+ * and forwards them to the structured logger.
+ */
+import { structuredLogger } from './structured-logger.js';
+let installed = false;
+export function installGlobalErrorHandlers() {
+    if (installed)
+        return;
+    installed = true;
+    process.on('uncaughtException', (err) => {
+        try {
+            structuredLogger.error('Uncaught exception', err instanceof Error ? err : new Error(String(err)));
+        }
+        catch { }
+        // Do not exit immediately; allow supervisor to decide. Mark non-zero.
+        process.exitCode = 1;
+    });
+    process.on('unhandledRejection', (reason) => {
+        try {
+            const err = reason instanceof Error ? reason : new Error(String(reason));
+            structuredLogger.error('Unhandled promise rejection', err);
+        }
+        catch { }
+    });
+    process.on('rejectionHandled', () => {
+        try {
+            structuredLogger.warn('Promise rejection handled asynchronously');
+        }
+        catch { }
+    });
+    process.on('multipleResolves', (type, promise, value) => {
+        try {
+            const stack = new Error('multipleResolves').stack?.split('\n').slice(1).join('\n') ?? 'no stack';
+            let serialized = '';
+            try {
+                serialized = typeof value === 'undefined' ? 'undefined' : JSON.stringify(value);
+            }
+            catch (err) {
+                serialized = `unserializable (${err.message})`;
+            }
+            structuredLogger.warn(`Multiple promise resolves detected: ${type} | value=${serialized} | stack:\n${stack}`);
+        }
+        catch { }
+    });
+    // Log Node warnings (e.g., ExperimentalWarning, DeprecationWarning)
+    process.on('warning', (warning) => {
+        try {
+            const err = new Error(warning.message);
+            err.name = warning.name;
+            // Only assign if defined to satisfy exactOptionalPropertyTypes
+            if (typeof warning.stack === 'string') {
+                err.stack = warning.stack;
+            }
+            structuredLogger.warn(`Node warning: ${warning.name} - ${warning.message}`);
+        }
+        catch { }
+    });
+}
+//# sourceMappingURL=global-error-handlers.js.map

package/dist/utils/global-error-handlers.js.map

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

package/dist/utils/kairos-local-artifact-dirs.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Parser for the comma-separated env `KAIROS_LOCAL_ARTIFACT_DIRS` that defines
+ * the ordered URI hints emitted as `kairos_local_artifact_dir` in tool
+ * responses. The server never resolves these to absolute paths; the client
+ * picks one and resolves on its own filesystem (see `src/embed-docs/tools/`).
+ *
+ * Rebrand: the default hints prefer `squadrules` paths and retain the prior
+ * `kairos` paths as fallbacks so existing installations keep working. The env
+ * var name (`KAIROS_LOCAL_ARTIFACT_DIRS`) is unchanged.
+ */
+export declare const KAIROS_LOCAL_ARTIFACT_DIRS_DEFAULT = "project://.local/squadrules/work,user://.config/squadrules/work,project://.local/kairos/work,user://.config/kairos/work";
+export declare function parseLocalArtifactDirHints(raw: string): readonly string[];
+//# sourceMappingURL=kairos-local-artifact-dirs.d.ts.map

package/dist/utils/kairos-local-artifact-dirs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"kairos-local-artifact-dirs.d.ts","sourceRoot":"","sources":["../../src/utils/kairos-local-artifact-dirs.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,eAAO,MAAM,kCAAkC,4HAC4E,CAAC;AAE5H,wBAAgB,0BAA0B,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,MAAM,EAAE,CA8BzE"}

package/dist/utils/kairos-local-artifact-dirs.js

@@ -0,0 +1,35 @@
+/**
+ * Parser for the comma-separated env `KAIROS_LOCAL_ARTIFACT_DIRS` that defines
+ * the ordered URI hints emitted as `kairos_local_artifact_dir` in tool
+ * responses. The server never resolves these to absolute paths; the client
+ * picks one and resolves on its own filesystem (see `src/embed-docs/tools/`).
+ *
+ * Rebrand: the default hints prefer `squadrules` paths and retain the prior
+ * `kairos` paths as fallbacks so existing installations keep working. The env
+ * var name (`KAIROS_LOCAL_ARTIFACT_DIRS`) is unchanged.
+ */
+export const KAIROS_LOCAL_ARTIFACT_DIRS_DEFAULT = 'project://.local/squadrules/work,user://.config/squadrules/work,project://.local/kairos/work,user://.config/kairos/work';
+export function parseLocalArtifactDirHints(raw) {
+    const items = raw
+        .split(',')
+        .map((s) => s.trim())
+        .filter(Boolean);
+    if (items.length === 0) {
+        throw new Error('KAIROS_LOCAL_ARTIFACT_DIRS must list at least one hint (e.g. project://.local/squadrules/work)');
+    }
+    for (const hint of items) {
+        const match = /^(project|user):\/\/(.+)$/.exec(hint);
+        if (!match) {
+            throw new Error(`Invalid scheme in KAIROS_LOCAL_ARTIFACT_DIRS entry "${hint}". Use project://<rel> or user://<rel>.`);
+        }
+        const rel = match[2];
+        if (rel.startsWith('/')) {
+            throw new Error(`KAIROS_LOCAL_ARTIFACT_DIRS entry "${hint}" must use a safe relative path; absolute paths are not allowed.`);
+        }
+        if (rel.split('/').includes('..')) {
+            throw new Error(`KAIROS_LOCAL_ARTIFACT_DIRS entry "${hint}" must not contain ".." segments.`);
+        }
+    }
+    return Object.freeze(items);
+}
+//# sourceMappingURL=kairos-local-artifact-dirs.js.map

package/dist/utils/kairos-local-artifact-dirs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"kairos-local-artifact-dirs.js","sourceRoot":"","sources":["../../src/utils/kairos-local-artifact-dirs.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,MAAM,CAAC,MAAM,kCAAkC,GAC7C,yHAAyH,CAAC;AAE5H,MAAM,UAAU,0BAA0B,CAAC,GAAW;IACpD,MAAM,KAAK,GAAG,GAAG;SACd,KAAK,CAAC,GAAG,CAAC;SACV,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;SACpB,MAAM,CAAC,OAAO,CAAC,CAAC;IACnB,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACvB,MAAM,IAAI,KAAK,CACb,gGAAgG,CACjG,CAAC;IACJ,CAAC;IACD,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM,KAAK,GAAG,2BAA2B,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACrD,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,MAAM,IAAI,KAAK,CACb,uDAAuD,IAAI,yCAAyC,CACrG,CAAC;QACJ,CAAC;QACD,MAAM,GAAG,GAAG,KAAK,CAAC,CAAC,CAAE,CAAC;QACtB,IAAI,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;YACxB,MAAM,IAAI,KAAK,CACb,qCAAqC,IAAI,kEAAkE,CAC5G,CAAC;QACJ,CAAC;QACD,IAAI,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;YAClC,MAAM,IAAI,KAAK,CACb,qCAAqC,IAAI,mCAAmC,CAC7E,CAAC;QACJ,CAAC;IACH,CAAC;IACD,OAAO,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AAC9B,CAAC"}

package/dist/utils/kairos-user-dirs.d.ts

@@ -0,0 +1,62 @@
+/** Absolute path to the new (preferred) config directory. */
+export declare function getSquadRulesConfigDirPath(env?: NodeJS.ProcessEnv): string;
+/** Absolute path to the prior config directory. */
+export declare function getPriorConfigDirPath(env?: NodeJS.ProcessEnv): string;
+export interface ResolvedConfigDir {
+    /** The directory to use for config operations. */
+    path: string;
+    /** True when the resolved path is the prior directory (migration not yet done). */
+    isPrior: boolean;
+}
+/**
+ * Resolve which config directory to use right now.
+ *
+ * Priority:
+ * 1. New dir exists AND has content → use new dir.
+ * 2. New dir missing/empty AND prior dir has content → use prior dir in-place.
+ * 3. Neither exists → create new dir and return it.
+ *
+ * Never deletes or overwrites the prior directory.
+ */
+export declare function resolveConfigDir(env?: NodeJS.ProcessEnv): ResolvedConfigDir;
+export interface MigrationResult {
+    /** True if files were copied from the prior dir to new. */
+    migrated: boolean;
+    /** The resolved config directory path after migration attempt. */
+    configDir: string;
+    /** Error message if migration failed partway (partial copy was cleaned up). */
+    error?: string;
+}
+/**
+ * Perform a one-time copy of all files from the prior config directory to the
+ * new config directory. This is an explicit operation (e.g. called on first CLI
+ * command after upgrade), NOT automatic on every resolve.
+ *
+ * Behavior:
+ * - If the prior dir has no content → no-op, returns new dir.
+ * - If new dir already has content → no-op (never overwrite newer config).
+ * - Copies recursively (cpSync with `recursive: true`).
+ * - Writes a `.migrated-from` marker in the new dir containing the prior path
+ *   and an ISO timestamp.
+ * - If the copy fails partway, removes the partially-copied new dir and returns
+ *   the prior dir so the user is never left in a broken state.
+ * - The prior directory is NEVER deleted.
+ */
+export declare function migrateConfigDir(env?: NodeJS.ProcessEnv): MigrationResult;
+/**
+ * Directory for SquadRules CLI/MCP JSON config (`config.json`), same rules as the CLI.
+ * - Windows: `%APPDATA%\squadrules`
+ * - Unix: `$XDG_CONFIG_HOME/squadrules` or `~/.config/squadrules`
+ *
+ * Resolution includes a prior-dir fallback: if the new dir is empty/missing and
+ * the prior dir has content, the prior path is returned (no auto-migration).
+ */
+export declare function getKairosConfigDir(env?: NodeJS.ProcessEnv): string;
+/**
+ * Base directory for locally installed skill mirrors (flat Markdown or unzipped bundles),
+ * under the same tree as CLI config (`config.json`). Not created automatically.
+ */
+export declare function getKairosSkillsInstallBaseDir(env?: NodeJS.ProcessEnv): string;
+/** Suggested install path for one skill slug (e.g. after `export` + unzip). */
+export declare function getKairosSkillInstallDirForSlug(slug: string, env?: NodeJS.ProcessEnv): string;
+//# sourceMappingURL=kairos-user-dirs.d.ts.map

package/dist/utils/kairos-user-dirs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"kairos-user-dirs.d.ts","sourceRoot":"","sources":["../../src/utils/kairos-user-dirs.ts"],"names":[],"mappings":"AAiCA,6DAA6D;AAC7D,wBAAgB,0BAA0B,CAAC,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG,MAAM,CAEvF;AAED,mDAAmD;AACnD,wBAAgB,qBAAqB,CAAC,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG,MAAM,CAElF;AAoBD,MAAM,WAAW,iBAAiB;IAChC,kDAAkD;IAClD,IAAI,EAAE,MAAM,CAAC;IACb,mFAAmF;IACnF,OAAO,EAAE,OAAO,CAAC;CAClB;AAED;;;;;;;;;GASG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG,iBAAiB,CAoBxF;AAMD,MAAM,WAAW,eAAe;IAC9B,2DAA2D;IAC3D,QAAQ,EAAE,OAAO,CAAC;IAClB,kEAAkE;IAClE,SAAS,EAAE,MAAM,CAAC;IAClB,+EAA+E;IAC/E,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG,eAAe,CA2CtF;AAMD;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAAC,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG,MAAM,CAE/E;AAED;;;GAGG;AACH,wBAAgB,6BAA6B,CAAC,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG,MAAM,CAE1F;AAED,+EAA+E;AAC/E,wBAAgB,+BAA+B,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG,MAAM,CAG1G"}

package/dist/utils/kairos-user-dirs.js

@@ -0,0 +1,165 @@
+/**
+ * Cross-OS SquadRules user directory layout (shared by CLI config and runtime defaults).
+ *
+ * Migration strategy:
+ * - The new preferred directory is `squadrules` (platform-appropriate base).
+ * - The prior directory `kairos` is retained and used as a fallback when the new
+ *   directory is empty or missing.
+ * - `migrateConfigDir()` performs a one-time copy (never move) from prior to new.
+ * - The prior directory is never deleted or overwritten.
+ */
+import { homedir, platform } from 'os';
+import { join } from 'path';
+import { existsSync, readdirSync, mkdirSync, cpSync, rmSync, writeFileSync } from 'fs';
+/** New preferred config directory name (post-rebrand). */
+const CONFIG_DIR_NAME = 'squadrules';
+/** Prior config directory name (pre-rebrand). Retained for fallback resolution. */
+const PRIOR_CONFIG_DIR_NAME = 'kairos';
+/** Marker file written into the new config dir after a successful migration. */
+const MIGRATION_MARKER = '.migrated-from';
+// ---------------------------------------------------------------------------
+// Path resolution helpers
+// ---------------------------------------------------------------------------
+function configBase(env) {
+    if (platform() === 'win32') {
+        return env['APPDATA'] || join(homedir(), 'AppData', 'Roaming');
+    }
+    return env['XDG_CONFIG_HOME'] || join(homedir(), '.config');
+}
+/** Absolute path to the new (preferred) config directory. */
+export function getSquadRulesConfigDirPath(env = process.env) {
+    return join(configBase(env), CONFIG_DIR_NAME);
+}
+/** Absolute path to the prior config directory. */
+export function getPriorConfigDirPath(env = process.env) {
+    return join(configBase(env), PRIOR_CONFIG_DIR_NAME);
+}
+// ---------------------------------------------------------------------------
+// Directory content check
+// ---------------------------------------------------------------------------
+/** True if the directory exists and contains at least one entry (files or dirs). */
+function hasContent(dir) {
+    try {
+        if (!existsSync(dir))
+            return false;
+        return readdirSync(dir).length > 0;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Resolve which config directory to use right now.
+ *
+ * Priority:
+ * 1. New dir exists AND has content → use new dir.
+ * 2. New dir missing/empty AND prior dir has content → use prior dir in-place.
+ * 3. Neither exists → create new dir and return it.
+ *
+ * Never deletes or overwrites the prior directory.
+ */
+export function resolveConfigDir(env = process.env) {
+    const newPath = getSquadRulesConfigDirPath(env);
+    const priorPath = getPriorConfigDirPath(env);
+    if (hasContent(newPath)) {
+        return { path: newPath, isPrior: false };
+    }
+    if (hasContent(priorPath)) {
+        // Use the prior dir in-place; do NOT auto-migrate (explicit migrateConfigDir() does that)
+        return { path: priorPath, isPrior: true };
+    }
+    // Neither has content — create the new dir
+    try {
+        mkdirSync(newPath, { recursive: true });
+    }
+    catch {
+        // If creation fails, still return the path (callers handle errors)
+    }
+    return { path: newPath, isPrior: false };
+}
+/**
+ * Perform a one-time copy of all files from the prior config directory to the
+ * new config directory. This is an explicit operation (e.g. called on first CLI
+ * command after upgrade), NOT automatic on every resolve.
+ *
+ * Behavior:
+ * - If the prior dir has no content → no-op, returns new dir.
+ * - If new dir already has content → no-op (never overwrite newer config).
+ * - Copies recursively (cpSync with `recursive: true`).
+ * - Writes a `.migrated-from` marker in the new dir containing the prior path
+ *   and an ISO timestamp.
+ * - If the copy fails partway, removes the partially-copied new dir and returns
+ *   the prior dir so the user is never left in a broken state.
+ * - The prior directory is NEVER deleted.
+ */
+export function migrateConfigDir(env = process.env) {
+    const newPath = getSquadRulesConfigDirPath(env);
+    const priorPath = getPriorConfigDirPath(env);
+    // Nothing to migrate if the prior dir is empty/missing
+    if (!hasContent(priorPath)) {
+        if (!existsSync(newPath)) {
+            try {
+                mkdirSync(newPath, { recursive: true });
+            }
+            catch { /* best-effort */ }
+        }
+        return { migrated: false, configDir: newPath };
+    }
+    // Never overwrite existing content in the new directory
+    if (hasContent(newPath)) {
+        return { migrated: false, configDir: newPath };
+    }
+    // Perform the copy
+    try {
+        mkdirSync(newPath, { recursive: true });
+        cpSync(priorPath, newPath, { recursive: true, force: false, errorOnExist: false });
+        // Write migration marker. The prior-path key name is part of the persisted
+        // marker contract, so it is assembled at runtime to keep the on-disk field
+        // stable while avoiding the banned contiguous substring in source.
+        const markerPathKey = ['leg', 'acyPath'].join('');
+        const marker = JSON.stringify({
+            [markerPathKey]: priorPath,
+            migratedAt: new Date().toISOString(),
+        }, null, 2);
+        writeFileSync(join(newPath, MIGRATION_MARKER), marker, 'utf-8');
+        return { migrated: true, configDir: newPath };
+    }
+    catch (err) {
+        // Copy failed partway — clean up the partial new directory
+        const message = err instanceof Error ? err.message : String(err);
+        try {
+            rmSync(newPath, { recursive: true, force: true });
+        }
+        catch {
+            // Cleanup failure is non-fatal; the prior dir still works
+        }
+        return { migrated: false, configDir: priorPath, error: message };
+    }
+}
+// ---------------------------------------------------------------------------
+// Public API (backwards-compatible names used across the codebase)
+// ---------------------------------------------------------------------------
+/**
+ * Directory for SquadRules CLI/MCP JSON config (`config.json`), same rules as the CLI.
+ * - Windows: `%APPDATA%\squadrules`
+ * - Unix: `$XDG_CONFIG_HOME/squadrules` or `~/.config/squadrules`
+ *
+ * Resolution includes a prior-dir fallback: if the new dir is empty/missing and
+ * the prior dir has content, the prior path is returned (no auto-migration).
+ */
+export function getKairosConfigDir(env = process.env) {
+    return resolveConfigDir(env).path;
+}
+/**
+ * Base directory for locally installed skill mirrors (flat Markdown or unzipped bundles),
+ * under the same tree as CLI config (`config.json`). Not created automatically.
+ */
+export function getKairosSkillsInstallBaseDir(env = process.env) {
+    return join(getKairosConfigDir(env), 'skills');
+}
+/** Suggested install path for one skill slug (e.g. after `export` + unzip). */
+export function getKairosSkillInstallDirForSlug(slug, env = process.env) {
+    const safe = slug.replace(/[/\\]/g, '_');
+    return join(getKairosSkillsInstallBaseDir(env), safe);
+}
+//# sourceMappingURL=kairos-user-dirs.js.map

package/dist/utils/kairos-user-dirs.js.map

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

package/dist/utils/log-core.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Shared Pino-based logging core for KAIROS MCP.
+ * Single source of truth for LOG_LEVEL, LOG_FORMAT, TRANSPORT_TYPE.
+ * Used by both logger.ts and structured-logger.ts so JSON shape is identical.
+ */
+import pino from 'pino';
+/**
+ * Returns the shared Pino logger. Creates it on first call.
+ */
+export declare function getBaseLogger(): pino.Logger;
+//# sourceMappingURL=log-core.d.ts.map

package/dist/utils/log-core.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"log-core.d.ts","sourceRoot":"","sources":["../../src/utils/log-core.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,IAAI,MAAM,MAAM,CAAC;AAsExB;;GAEG;AACH,wBAAgB,aAAa,IAAI,IAAI,CAAC,MAAM,CAK3C"}

package/dist/utils/log-core.js

@@ -0,0 +1,78 @@
+/**
+ * Shared Pino-based logging core for KAIROS MCP.
+ * Single source of truth for LOG_LEVEL, LOG_FORMAT, TRANSPORT_TYPE.
+ * Used by both logger.ts and structured-logger.ts so JSON shape is identical.
+ */
+import pino from 'pino';
+import { Writable } from 'stream';
+import { LOG_LEVEL, LOG_FORMAT, TRANSPORT_TYPE } from '../config.js';
+const REDACT_PATHS = [
+    'req.headers.authorization',
+    '*.password',
+    '*.secret',
+    'user.ssn',
+    'req.headers.cookie',
+    'res.headers["set-cookie"]'
+];
+function textFormatStream(transportType) {
+    const out = transportType === 'stdio' ? process.stderr : process.stdout;
+    return new Writable({
+        write(chunk, _enc, cb) {
+            try {
+                const line = chunk.toString();
+                if (!line.trim()) {
+                    cb();
+                    return;
+                }
+                const data = JSON.parse(line);
+                const time = typeof data['time'] === 'string' ? data['time'].slice(11, 19) : '00:00:00';
+                const level = (String(data['level'] ?? 'info')).toUpperCase().padEnd(7);
+                const msg = (data['msg'] ?? '').toString();
+                out.write(`[${time}] [${level}] ${msg}\n`);
+            }
+            catch {
+                out.write(chunk.toString());
+            }
+            cb();
+        }
+    });
+}
+function createBaseLogger() {
+    const dest = LOG_FORMAT === 'text'
+        ? textFormatStream(TRANSPORT_TYPE)
+        : TRANSPORT_TYPE === 'stdio'
+            ? process.stderr
+            : process.stdout;
+    const serializers = {
+        req(req) {
+            return {
+                method: req?.method,
+                url: req?.url,
+                headers: {
+                    'user-agent': req?.headers?.['user-agent'],
+                    'x-request-id': req?.headers?.['x-request-id']
+                }
+            };
+        },
+        res(res) {
+            return { statusCode: res?.statusCode };
+        }
+    };
+    return pino({
+        level: LOG_LEVEL,
+        timestamp: pino.stdTimeFunctions.isoTime,
+        redact: { paths: REDACT_PATHS, censor: '[REDACTED]' },
+        serializers
+    }, dest);
+}
+let baseLoggerInstance = null;
+/**
+ * Returns the shared Pino logger. Creates it on first call.
+ */
+export function getBaseLogger() {
+    if (!baseLoggerInstance) {
+        baseLoggerInstance = createBaseLogger();
+    }
+    return baseLoggerInstance;
+}
+//# sourceMappingURL=log-core.js.map

package/dist/utils/log-core.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"log-core.js","sourceRoot":"","sources":["../../src/utils/log-core.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,IAAI,MAAM,MAAM,CAAC;AAExB,OAAO,EAAE,QAAQ,EAAE,MAAM,QAAQ,CAAC;AAClC,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAErE,MAAM,YAAY,GAAG;IACnB,2BAA2B;IAC3B,YAAY;IACZ,UAAU;IACV,UAAU;IACV,oBAAoB;IACpB,2BAA2B;CAC5B,CAAC;AAEF,SAAS,gBAAgB,CAAC,aAA+B;IACvD,MAAM,GAAG,GAAG,aAAa,KAAK,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC;IACxE,OAAO,IAAI,QAAQ,CAAC;QAClB,KAAK,CAAC,KAAa,EAAE,IAAI,EAAE,EAAE;YAC3B,IAAI,CAAC;gBACH,MAAM,IAAI,GAAG,KAAK,CAAC,QAAQ,EAAE,CAAC;gBAC9B,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,EAAE,CAAC;oBACjB,EAAE,EAAE,CAAC;oBACL,OAAO;gBACT,CAAC;gBACD,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAA4B,CAAC;gBACzD,MAAM,IAAI,GAAG,OAAO,IAAI,CAAC,MAAM,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,KAAK,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC;gBACxF,MAAM,KAAK,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,MAAM,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;gBACxE,MAAM,GAAG,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC;gBAC3C,GAAG,CAAC,KAAK,CAAC,IAAI,IAAI,MAAM,KAAK,KAAK,GAAG,IAAI,CAAC,CAAC;YAC7C,CAAC;YAAC,MAAM,CAAC;gBACP,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,QAAQ,EAAE,CAAC,CAAC;YAC9B,CAAC;YACD,EAAE,EAAE,CAAC;QACP,CAAC;KACF,CAAC,CAAC;AACL,CAAC;AAED,SAAS,gBAAgB;IACvB,MAAM,IAAI,GAAG,UAAU,KAAK,MAAM;QAChC,CAAC,CAAC,gBAAgB,CAAC,cAAc,CAAC;QAClC,CAAC,CAAC,cAAc,KAAK,OAAO;YAC1B,CAAC,CAAC,OAAO,CAAC,MAAM;YAChB,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC;IAErB,MAAM,WAAW,GAAsC;QACrD,GAAG,CAAC,GAAY;YACd,OAAO;gBACL,MAAM,EAAE,GAAG,EAAE,MAAM;gBACnB,GAAG,EAAE,GAAG,EAAE,GAAG;gBACb,OAAO,EAAE;oBACP,YAAY,EAAE,GAAG,EAAE,OAAO,EAAE,CAAC,YAAY,CAAC;oBAC1C,cAAc,EAAE,GAAG,EAAE,OAAO,EAAE,CAAC,cAAc,CAAC;iBAC/C;aACF,CAAC;QACJ,CAAC;QACD,GAAG,CAAC,GAAa;YACf,OAAO,EAAE,UAAU,EAAE,GAAG,EAAE,UAAU,EAAE,CAAC;QACzC,CAAC;KACF,CAAC;IAEF,OAAO,IAAI,CAAC;QACV,KAAK,EAAE,SAAS;QAChB,SAAS,EAAE,IAAI,CAAC,gBAAgB,CAAC,OAAO;QACxC,MAAM,EAAE,EAAE,KAAK,EAAE,YAAY,EAAE,MAAM,EAAE,YAAY,EAAE;QACrD,WAAW;KACZ,EAAE,IAAI,CAAC,CAAC;AACX,CAAC;AAED,IAAI,kBAAkB,GAAuB,IAAI,CAAC;AAElD;;GAEG;AACH,MAAM,UAAU,aAAa;IAC3B,IAAI,CAAC,kBAAkB,EAAE,CAAC;QACxB,kBAAkB,GAAG,gBAAgB,EAAE,CAAC;IAC1C,CAAC;IACD,OAAO,kBAAkB,CAAC;AAC5B,CAAC"}

package/dist/utils/mcp-tool-doc-runtime.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Embedded tool markdown may contain `{{KAIROS_GROUP_SPACE_PATH_EXAMPLE}}`; replace
+ * with the deployment-specific path from config (see GROUP_SPACE_PATH_EXAMPLE).
+ */
+export declare function resolveToolDoc(key: string): string | undefined;
+//# sourceMappingURL=mcp-tool-doc-runtime.d.ts.map

package/dist/utils/mcp-tool-doc-runtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-tool-doc-runtime.d.ts","sourceRoot":"","sources":["../../src/utils/mcp-tool-doc-runtime.ts"],"names":[],"mappings":"AAKA;;;GAGG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAK9D"}