kiokuko 1.0.0

package/dist/setup/client-detection.js

@@ -0,0 +1,64 @@
+import { constants } from 'node:fs';
+import { access, stat } from 'node:fs/promises';
+import path from 'node:path';
+export const DETECTABLE_CLIENTS = ['codex', 'opencode', 'claude', 'hermes'];
+function errorCode(error) {
+    return error instanceof Error && 'code' in error
+        ? String(error.code)
+        : undefined;
+}
+async function hasExecutable(platform, pathModule, env, executableBaseName, dependencies) {
+    const pathValue = env.PATH;
+    if (!pathValue)
+        return false;
+    const pathDelimiter = platform === 'win32' ? ';' : ':';
+    const executableNames = platform === 'win32'
+        ? [`${executableBaseName}.exe`, `${executableBaseName}.cmd`, `${executableBaseName}.bat`, executableBaseName]
+        : [executableBaseName];
+    for (const directory of pathValue.split(pathDelimiter).filter(Boolean)) {
+        for (const executableName of executableNames) {
+            const executable = pathModule.join(directory, executableName);
+            try {
+                const info = await dependencies.stat(executable);
+                if (!info.isFile())
+                    continue;
+            }
+            catch (error) {
+                if (['ENOENT', 'ENOTDIR'].includes(errorCode(error) ?? ''))
+                    continue;
+                throw error;
+            }
+            try {
+                await dependencies.access(executable, platform === 'win32' ? constants.F_OK : constants.X_OK);
+                return true;
+            }
+            catch (error) {
+                if (['EACCES', 'EPERM', 'ENOENT', 'ENOTDIR'].includes(errorCode(error) ?? ''))
+                    continue;
+                throw error;
+            }
+        }
+    }
+    return false;
+}
+/** Detect supported client executables without mutating client state. */
+export async function detectInstalledClients(options = {}, dependencyOverrides = {}) {
+    const platform = options.platform ?? process.platform;
+    const pathModule = platform === 'win32' ? path.win32 : path.posix;
+    const env = options.env ?? process.env;
+    const dependencies = {
+        stat: dependencyOverrides.stat ?? stat,
+        access: dependencyOverrides.access ?? access,
+    };
+    const installed = [];
+    for (const client of DETECTABLE_CLIENTS) {
+        if (await hasExecutable(platform, pathModule, env, client, dependencies))
+            installed.push(client);
+    }
+    return installed;
+}
+/** Detect an installed Hermes executable without mutating client state. */
+export async function isHermesAgentInstalled(options = {}, dependencyOverrides = {}) {
+    return (await detectInstalledClients(options, dependencyOverrides)).includes('hermes');
+}
+//# sourceMappingURL=client-detection.js.map

package/dist/setup/client-detection.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client-detection.js","sourceRoot":"","sources":["../../src/setup/client-detection.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AACpC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AAChD,OAAO,IAAI,MAAM,WAAW,CAAC;AAG7B,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,QAAQ,CAAU,CAAC;AAQrF,SAAS,SAAS,CAAC,KAAc;IAC/B,OAAO,KAAK,YAAY,KAAK,IAAI,MAAM,IAAI,KAAK;QAC9C,CAAC,CAAC,MAAM,CAAE,KAA+B,CAAC,IAAI,CAAC;QAC/C,CAAC,CAAC,SAAS,CAAC;AAChB,CAAC;AAED,KAAK,UAAU,aAAa,CAC1B,QAAyB,EACzB,UAA6B,EAC7B,GAAsB,EACtB,kBAA0B,EAC1B,YAAmD;IAEnD,MAAM,SAAS,GAAG,GAAG,CAAC,IAAI,CAAC;IAC3B,IAAI,CAAC,SAAS;QAAE,OAAO,KAAK,CAAC;IAC7B,MAAM,aAAa,GAAG,QAAQ,KAAK,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC;IACvD,MAAM,eAAe,GAAG,QAAQ,KAAK,OAAO;QAC1C,CAAC,CAAC,CAAC,GAAG,kBAAkB,MAAM,EAAE,GAAG,kBAAkB,MAAM,EAAE,GAAG,kBAAkB,MAAM,EAAE,kBAAkB,CAAC;QAC7G,CAAC,CAAC,CAAC,kBAAkB,CAAC,CAAC;IAEzB,KAAK,MAAM,SAAS,IAAI,SAAS,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC;QACvE,KAAK,MAAM,cAAc,IAAI,eAAe,EAAE,CAAC;YAC7C,MAAM,UAAU,GAAG,UAAU,CAAC,IAAI,CAAC,SAAS,EAAE,cAAc,CAAC,CAAC;YAC9D,IAAI,CAAC;gBACH,MAAM,IAAI,GAAG,MAAM,YAAY,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;gBACjD,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE;oBAAE,SAAS;YAC/B,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,IAAI,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAC,QAAQ,CAAC,SAAS,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC;oBAAE,SAAS;gBACrE,MAAM,KAAK,CAAC;YACd,CAAC;YACD,IAAI,CAAC;gBACH,MAAM,YAAY,CAAC,MAAM,CAAC,UAAU,EAAE,QAAQ,KAAK,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;gBAC9F,OAAO,IAAI,CAAC;YACd,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,IAAI,CAAC,QAAQ,EAAE,OAAO,EAAE,QAAQ,EAAE,SAAS,CAAC,CAAC,QAAQ,CAAC,SAAS,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC;oBAAE,SAAS;gBACxF,MAAM,KAAK,CAAC;YACd,CAAC;QACH,CAAC;IACH,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,yEAAyE;AACzE,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAC1C,UAA2B,EAAE,EAC7B,sBAAmD,EAAE;IAErD,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,IAAI,OAAO,CAAC,QAAQ,CAAC;IACtD,MAAM,UAAU,GAAG,QAAQ,KAAK,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC;IAClE,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,IAAI,OAAO,CAAC,GAAG,CAAC;IACvC,MAAM,YAAY,GAA0C;QAC1D,IAAI,EAAE,mBAAmB,CAAC,IAAI,IAAI,IAAI;QACtC,MAAM,EAAE,mBAAmB,CAAC,MAAM,IAAI,MAAM;KAC7C,CAAC;IACF,MAAM,SAAS,GAAuB,EAAE,CAAC;IACzC,KAAK,MAAM,MAAM,IAAI,kBAAkB,EAAE,CAAC;QACxC,IAAI,MAAM,aAAa,CAAC,QAAQ,EAAE,UAAU,EAAE,GAAG,EAAE,MAAM,EAAE,YAAY,CAAC;YAAE,SAAS,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACnG,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,2EAA2E;AAC3E,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAC1C,UAA2B,EAAE,EAC7B,sBAAmD,EAAE;IAErD,OAAO,CAAC,MAAM,sBAAsB,CAAC,OAAO,EAAE,mBAAmB,CAAC,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;AACzF,CAAC"}

package/dist/setup/hermes-config.d.ts

@@ -0,0 +1,7 @@
+import type { SkillDiscoveryMode } from '../skills/types.js';
+import type { DelimitedBlockResult } from './managed-text.js';
+export declare const HERMES_MANAGED_MARKER = "Managed by `kiokuko setup`.";
+export declare function renderHermesConfig(existing: string | undefined, command?: string, skillDiscoveryMode?: SkillDiscoveryMode, options?: {
+    replaceConflictingIdentity?: boolean;
+}): DelimitedBlockResult;
+//# sourceMappingURL=hermes-config.d.ts.map

package/dist/setup/hermes-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hermes-config.d.ts","sourceRoot":"","sources":["../../src/setup/hermes-config.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAC7D,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AAG9D,eAAO,MAAM,qBAAqB,gCAAgC,CAAC;AAiGnE,wBAAgB,kBAAkB,CAChC,QAAQ,EAAE,MAAM,GAAG,SAAS,EAC5B,OAAO,SAAY,EACnB,kBAAkB,CAAC,EAAE,kBAAkB,EACvC,OAAO,GAAE;IAAE,0BAA0B,CAAC,EAAE,OAAO,CAAA;CAAO,GACrD,oBAAoB,CA4DtB"}

package/dist/setup/hermes-config.js

@@ -0,0 +1,145 @@
+import { parseDocument, isMap, isNode, isPair, isScalar, isSeq } from 'yaml';
+import { KiokukoError } from '../errors.js';
+import { isSkillDiscoveryMode, SKILL_DISCOVERY_ENV } from '../skills/config.js';
+import { setupMcpIdentityConflict } from './mcp-conflict.js';
+export const HERMES_MANAGED_MARKER = 'Managed by `kiokuko setup`.';
+function scalarValue(value) {
+    return isScalar(value) ? value.value : undefined;
+}
+function findKeyPair(map, key) {
+    return map.items.find((item) => isPair(item) && scalarValue(item.key) === key);
+}
+function hasManagedMarker(pair) {
+    return isNode(pair.value) && pair.value.commentBefore?.trim() === HERMES_MANAGED_MARKER;
+}
+function hasCanonicalManagedShape(pair) {
+    if (!isMap(pair.value))
+        return false;
+    const fields = pair.value.items.map((item) => isPair(item) ? scalarValue(item.key) : undefined);
+    if (fields.length !== 3
+        || new Set(fields).size !== fields.length
+        || !fields.includes('command')
+        || !fields.includes('args')
+        || fields.some((field) => field !== 'command' && field !== 'args' && field !== 'env'))
+        return false;
+    const commandNode = pair.value.get('command', true);
+    const argsNode = pair.value.get('args', true);
+    const command = scalarValue(commandNode);
+    if (typeof command !== 'string'
+        || command.trim().length === 0
+        || command.includes('\0')
+        || !isSeq(argsNode)
+        || argsNode.items.length !== 1
+        || scalarValue(argsNode.items[0]) !== 'mcp')
+        return false;
+    const envNode = pair.value.get('env', true);
+    if (!isMap(envNode) || envNode.items.length !== 1)
+        return false;
+    const environmentPair = envNode.items[0];
+    return isPair(environmentPair)
+        && scalarValue(environmentPair.key) === SKILL_DISCOVERY_ENV
+        && isSkillDiscoveryMode(scalarValue(environmentPair.value));
+}
+function currentManagedCommand(pair) {
+    if (!hasCanonicalManagedShape(pair))
+        return undefined;
+    const command = scalarValue(pair.value.get('command', true));
+    return typeof command === 'string' ? command : undefined;
+}
+function currentManagedSkillDiscoveryMode(pair) {
+    if (!hasCanonicalManagedShape(pair) || !isMap(pair.value))
+        return undefined;
+    const environment = pair.value.get('env', true);
+    if (!isMap(environment))
+        return undefined;
+    const mode = scalarValue(environment.get(SKILL_DISCOVERY_ENV, true));
+    return isSkillDiscoveryMode(mode) ? mode : undefined;
+}
+function hasRequestedState(pair, command, skillDiscoveryMode) {
+    return currentManagedCommand(pair) === command
+        && currentManagedSkillDiscoveryMode(pair) === skillDiscoveryMode;
+}
+function validation() {
+    throw new KiokukoError('VALIDATION_ERROR', 'Hermes config is not a valid YAML mapping');
+}
+function conflict() {
+    setupMcpIdentityConflict('hermes', 'Hermes config already contains a conflicting kiokuko MCP server');
+}
+function managedHermesServerValue(document, command, skillDiscoveryMode) {
+    const value = document.createNode({
+        command,
+        args: ['mcp'],
+        env: { [SKILL_DISCOVERY_ENV]: skillDiscoveryMode },
+    });
+    if (!isNode(value))
+        validation();
+    value.commentBefore = ` ${HERMES_MANAGED_MARKER}`;
+    return value;
+}
+function serializeHermesDocument(document, source, existing) {
+    const eol = source.includes('\r\n') ? '\r\n' : '\n';
+    const serialized = document.toString({ lineWidth: 0 }).replaceAll('\r\n', '\n');
+    const content = serialized.replaceAll('\n', eol);
+    return {
+        content,
+        action: existing === undefined ? 'created' : content === existing ? 'unchanged' : 'updated',
+    };
+}
+export function renderHermesConfig(existing, command = 'kiokuko', skillDiscoveryMode, options = {}) {
+    if (typeof command !== 'string' || command.trim().length === 0 || command.includes('\0')) {
+        throw new KiokukoError('VALIDATION_ERROR', 'Hermes MCP command must be a non-empty executable path or name');
+    }
+    if (skillDiscoveryMode !== undefined && !isSkillDiscoveryMode(skillDiscoveryMode)) {
+        throw new KiokukoError('VALIDATION_ERROR', 'Hermes Skill discovery mode is invalid');
+    }
+    if (options.replaceConflictingIdentity !== undefined
+        && typeof options.replaceConflictingIdentity !== 'boolean') {
+        throw new KiokukoError('VALIDATION_ERROR', 'Hermes MCP replacement authorization is invalid');
+    }
+    const source = existing ?? '';
+    const document = parseDocument(source);
+    if (document.errors.length > 0)
+        validation();
+    let contents = document.contents;
+    if (contents === null) {
+        const created = document.createNode({});
+        document.contents = created;
+        contents = created;
+    }
+    if (!isMap(contents))
+        validation();
+    let mcpServers = contents.get('mcp_servers', true);
+    if (mcpServers !== undefined && !isMap(mcpServers))
+        validation();
+    if (mcpServers === undefined) {
+        const created = document.createNode({});
+        contents.set('mcp_servers', created);
+        mcpServers = created;
+    }
+    const serverMap = mcpServers;
+    const existingPair = findKeyPair(serverMap, 'kiokuko');
+    if (existingPair !== undefined) {
+        if (!hasManagedMarker(existingPair) || !hasCanonicalManagedShape(existingPair)) {
+            if (!options.replaceConflictingIdentity)
+                conflict();
+            existingPair.value = managedHermesServerValue(document, command, skillDiscoveryMode ?? 'official');
+            return serializeHermesDocument(document, source, existing);
+        }
+        const currentSkillDiscoveryMode = currentManagedSkillDiscoveryMode(existingPair);
+        if (currentSkillDiscoveryMode === undefined)
+            conflict();
+        const effectiveSkillDiscoveryMode = skillDiscoveryMode ?? currentSkillDiscoveryMode;
+        if (hasRequestedState(existingPair, command, effectiveSkillDiscoveryMode))
+            return { content: source, action: 'unchanged' };
+        if (!isMap(existingPair.value))
+            conflict();
+        existingPair.value.set('command', command);
+        existingPair.value.set('env', { [SKILL_DISCOVERY_ENV]: effectiveSkillDiscoveryMode });
+        return serializeHermesDocument(document, source, existing);
+    }
+    const effectiveSkillDiscoveryMode = skillDiscoveryMode ?? 'official';
+    const pair = document.createPair('kiokuko', managedHermesServerValue(document, command, effectiveSkillDiscoveryMode));
+    serverMap.add(pair);
+    return serializeHermesDocument(document, source, existing);
+}
+//# sourceMappingURL=hermes-config.js.map

package/dist/setup/hermes-config.js.map

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

package/dist/setup/managed-text.d.ts

@@ -0,0 +1,6 @@
+export interface DelimitedBlockResult {
+    content: string;
+    action: 'created' | 'updated' | 'unchanged';
+}
+export declare function upsertDelimitedBlock(existing: string, block: string, beginMarker: string, endMarker: string, label: string): DelimitedBlockResult;
+//# sourceMappingURL=managed-text.d.ts.map

package/dist/setup/managed-text.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"managed-text.d.ts","sourceRoot":"","sources":["../../src/setup/managed-text.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,oBAAoB;IACnC,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,SAAS,GAAG,SAAS,GAAG,WAAW,CAAC;CAC7C;AAwBD,wBAAgB,oBAAoB,CAClC,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,MAAM,EACb,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,MAAM,GACZ,oBAAoB,CA0BtB"}

package/dist/setup/managed-text.js

@@ -0,0 +1,52 @@
+import { KiokukoError } from '../errors.js';
+function positions(content, marker) {
+    const found = [];
+    let offset = 0;
+    for (;;) {
+        const position = content.indexOf(marker, offset);
+        if (position < 0)
+            return found;
+        found.push(position);
+        offset = position + marker.length;
+    }
+}
+function isStandaloneMarker(content, marker, position) {
+    const before = position === 0 ? '' : content[position - 1];
+    const after = content.slice(position + marker.length, position + marker.length + 2);
+    return (position === 0 || before === '\n')
+        && (position + marker.length === content.length || after.startsWith('\n') || after === '\r\n');
+}
+function eolFor(content) {
+    return content.includes('\r\n') ? '\r\n' : '\n';
+}
+export function upsertDelimitedBlock(existing, block, beginMarker, endMarker, label) {
+    const begins = positions(existing, beginMarker);
+    const ends = positions(existing, endMarker);
+    if ((begins.length === 0) !== (ends.length === 0)
+        || begins.length > 1
+        || ends.length > 1
+        || (begins[0] !== undefined && !isStandaloneMarker(existing, beginMarker, begins[0]))
+        || (ends[0] !== undefined && !isStandaloneMarker(existing, endMarker, ends[0]))) {
+        throw new KiokukoError('VALIDATION_ERROR', `${label} contains malformed Kiokuko managed markers`);
+    }
+    const eol = eolFor(existing);
+    const normalized = block.replaceAll('\r\n', '\n').replaceAll('\n', eol);
+    if (begins.length === 0) {
+        if (existing.length === 0)
+            return { content: `${normalized}${eol}`, action: 'created' };
+        const separator = existing.endsWith('\n') || existing.endsWith('\r') ? eol : `${eol}${eol}`;
+        return { content: `${existing}${separator}${normalized}${eol}`, action: 'created' };
+    }
+    const begin = begins[0];
+    const end = ends[0];
+    if (begin >= end)
+        throw new KiokukoError('VALIDATION_ERROR', `${label} contains malformed Kiokuko managed markers`);
+    const endExclusive = end + endMarker.length;
+    if (existing.slice(begin, endExclusive) === normalized)
+        return { content: existing, action: 'unchanged' };
+    return {
+        content: `${existing.slice(0, begin)}${normalized}${existing.slice(endExclusive)}`,
+        action: 'updated',
+    };
+}
+//# sourceMappingURL=managed-text.js.map

package/dist/setup/managed-text.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"managed-text.js","sourceRoot":"","sources":["../../src/setup/managed-text.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAO5C,SAAS,SAAS,CAAC,OAAe,EAAE,MAAc;IAChD,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,IAAI,MAAM,GAAG,CAAC,CAAC;IACf,SAAS,CAAC;QACR,MAAM,QAAQ,GAAG,OAAO,CAAC,OAAO,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QACjD,IAAI,QAAQ,GAAG,CAAC;YAAE,OAAO,KAAK,CAAC;QAC/B,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QACrB,MAAM,GAAG,QAAQ,GAAG,MAAM,CAAC,MAAM,CAAC;IACpC,CAAC;AACH,CAAC;AAED,SAAS,kBAAkB,CAAC,OAAe,EAAE,MAAc,EAAE,QAAgB;IAC3E,MAAM,MAAM,GAAG,QAAQ,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC,CAAC;IAC3D,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,QAAQ,GAAG,MAAM,CAAC,MAAM,EAAE,QAAQ,GAAG,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IACpF,OAAO,CAAC,QAAQ,KAAK,CAAC,IAAI,MAAM,KAAK,IAAI,CAAC;WACrC,CAAC,QAAQ,GAAG,MAAM,CAAC,MAAM,KAAK,OAAO,CAAC,MAAM,IAAI,KAAK,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,KAAK,KAAK,MAAM,CAAC,CAAC;AACnG,CAAC;AAED,SAAS,MAAM,CAAC,OAAe;IAC7B,OAAO,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC;AAClD,CAAC;AAED,MAAM,UAAU,oBAAoB,CAClC,QAAgB,EAChB,KAAa,EACb,WAAmB,EACnB,SAAiB,EACjB,KAAa;IAEb,MAAM,MAAM,GAAG,SAAS,CAAC,QAAQ,EAAE,WAAW,CAAC,CAAC;IAChD,MAAM,IAAI,GAAG,SAAS,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAC;IAC5C,IAAI,CAAC,MAAM,CAAC,MAAM,KAAK,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,KAAK,CAAC,CAAC;WAC5C,MAAM,CAAC,MAAM,GAAG,CAAC;WACjB,IAAI,CAAC,MAAM,GAAG,CAAC;WACf,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,SAAS,IAAI,CAAC,kBAAkB,CAAC,QAAQ,EAAE,WAAW,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;WAClF,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,SAAS,IAAI,CAAC,kBAAkB,CAAC,QAAQ,EAAE,SAAS,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QAClF,MAAM,IAAI,YAAY,CAAC,kBAAkB,EAAE,GAAG,KAAK,6CAA6C,CAAC,CAAC;IACpG,CAAC;IACD,MAAM,GAAG,GAAG,MAAM,CAAC,QAAQ,CAAC,CAAC;IAC7B,MAAM,UAAU,GAAG,KAAK,CAAC,UAAU,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC,UAAU,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;IACxE,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACxB,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,EAAE,OAAO,EAAE,GAAG,UAAU,GAAG,GAAG,EAAE,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC;QACxF,MAAM,SAAS,GAAG,QAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,QAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,GAAG,GAAG,GAAG,EAAE,CAAC;QAC5F,OAAO,EAAE,OAAO,EAAE,GAAG,QAAQ,GAAG,SAAS,GAAG,UAAU,GAAG,GAAG,EAAE,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC;IACtF,CAAC;IACD,MAAM,KAAK,GAAG,MAAM,CAAC,CAAC,CAAE,CAAC;IACzB,MAAM,GAAG,GAAG,IAAI,CAAC,CAAC,CAAE,CAAC;IACrB,IAAI,KAAK,IAAI,GAAG;QAAE,MAAM,IAAI,YAAY,CAAC,kBAAkB,EAAE,GAAG,KAAK,6CAA6C,CAAC,CAAC;IACpH,MAAM,YAAY,GAAG,GAAG,GAAG,SAAS,CAAC,MAAM,CAAC;IAC5C,IAAI,QAAQ,CAAC,KAAK,CAAC,KAAK,EAAE,YAAY,CAAC,KAAK,UAAU;QAAE,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,WAAW,EAAE,CAAC;IAC1G,OAAO;QACL,OAAO,EAAE,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,GAAG,UAAU,GAAG,QAAQ,CAAC,KAAK,CAAC,YAAY,CAAC,EAAE;QAClF,MAAM,EAAE,SAAS;KAClB,CAAC;AACJ,CAAC"}

package/dist/setup/mcp-conflict.d.ts

@@ -0,0 +1,4 @@
+export type SetupMcpClient = 'codex' | 'opencode' | 'claude' | 'hermes';
+export declare function setupMcpIdentityConflict(client: SetupMcpClient, message: string): never;
+export declare function setupMcpIdentityConflictClient(error: unknown): SetupMcpClient | undefined;
+//# sourceMappingURL=mcp-conflict.d.ts.map

package/dist/setup/mcp-conflict.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-conflict.d.ts","sourceRoot":"","sources":["../../src/setup/mcp-conflict.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,cAAc,GAAG,OAAO,GAAG,UAAU,GAAG,QAAQ,GAAG,QAAQ,CAAC;AAWxE,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,cAAc,EAAE,OAAO,EAAE,MAAM,GAAG,KAAK,CAEvF;AAED,wBAAgB,8BAA8B,CAAC,KAAK,EAAE,OAAO,GAAG,cAAc,GAAG,SAAS,CAEzF"}

package/dist/setup/mcp-conflict.js

@@ -0,0 +1,15 @@
+import { KiokukoError } from '../errors.js';
+class SetupMcpIdentityConflictError extends KiokukoError {
+    client;
+    constructor(client, message) {
+        super('CONFLICT', message);
+        this.client = client;
+    }
+}
+export function setupMcpIdentityConflict(client, message) {
+    throw new SetupMcpIdentityConflictError(client, message);
+}
+export function setupMcpIdentityConflictClient(error) {
+    return error instanceof SetupMcpIdentityConflictError ? error.client : undefined;
+}
+//# sourceMappingURL=mcp-conflict.js.map

package/dist/setup/mcp-conflict.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-conflict.js","sourceRoot":"","sources":["../../src/setup/mcp-conflict.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAI5C,MAAM,6BAA8B,SAAQ,YAAY;IAE3C;IADX,YACW,MAAsB,EAC/B,OAAe;QAEf,KAAK,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;QAHlB,WAAM,GAAN,MAAM,CAAgB;IAIjC,CAAC;CACF;AAED,MAAM,UAAU,wBAAwB,CAAC,MAAsB,EAAE,OAAe;IAC9E,MAAM,IAAI,6BAA6B,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAC3D,CAAC;AAED,MAAM,UAAU,8BAA8B,CAAC,KAAc;IAC3D,OAAO,KAAK,YAAY,6BAA6B,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC;AACnF,CAAC"}

package/dist/setup/opencode-config.d.ts

@@ -0,0 +1,6 @@
+import type { SkillDiscoveryMode } from '../skills/types.js';
+import type { DelimitedBlockResult } from './managed-text.js';
+export declare function renderOpenCodeConfig(existing: string | undefined, command?: string, skillDiscoveryMode?: SkillDiscoveryMode, options?: {
+    replaceConflictingIdentity?: boolean;
+}): DelimitedBlockResult;
+//# sourceMappingURL=opencode-config.d.ts.map

package/dist/setup/opencode-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"opencode-config.d.ts","sourceRoot":"","sources":["../../src/setup/opencode-config.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAC7D,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AAyC9D,wBAAgB,oBAAoB,CAClC,QAAQ,EAAE,MAAM,GAAG,SAAS,EAC5B,OAAO,SAAY,EACnB,kBAAkB,CAAC,EAAE,kBAAkB,EACvC,OAAO,GAAE;IAAE,0BAA0B,CAAC,EAAE,OAAO,CAAA;CAAO,GACrD,oBAAoB,CA8CtB"}

package/dist/setup/opencode-config.js

@@ -0,0 +1,86 @@
+import { applyEdits, modify, parse } from 'jsonc-parser';
+import { KiokukoError } from '../errors.js';
+import { isSkillDiscoveryMode, SKILL_DISCOVERY_ENV } from '../skills/config.js';
+import { setupMcpIdentityConflict } from './mcp-conflict.js';
+import { assertStrictJsonSyntax } from './strict-json.js';
+function object(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value)
+        ? value
+        : undefined;
+}
+function hasExactKeys(value, expected) {
+    const keys = Object.keys(value);
+    return keys.length === expected.length && expected.every((key) => keys.includes(key));
+}
+function isNonEmptyCommand(value) {
+    return typeof value === 'string' && value.trim().length > 0 && !value.includes('\0');
+}
+function isCanonicalManagedServer(value) {
+    const server = object(value);
+    if (server === undefined || !hasExactKeys(server, ['type', 'command', 'enabled', 'environment']))
+        return false;
+    if (server.type !== 'local' || server.enabled !== true)
+        return false;
+    if (!Array.isArray(server.command)
+        || server.command.length !== 2
+        || !isNonEmptyCommand(server.command[0])
+        || server.command[1] !== 'mcp')
+        return false;
+    const environment = object(server.environment);
+    return environment !== undefined
+        && hasExactKeys(environment, [SKILL_DISCOVERY_ENV])
+        && isSkillDiscoveryMode(environment[SKILL_DISCOVERY_ENV]);
+}
+function validation(message) {
+    throw new KiokukoError('VALIDATION_ERROR', message);
+}
+function conflict() {
+    setupMcpIdentityConflict('opencode', 'OpenCode config already contains a conflicting kiokuko MCP server');
+}
+export function renderOpenCodeConfig(existing, command = 'kiokuko', skillDiscoveryMode, options = {}) {
+    if (!isNonEmptyCommand(command))
+        validation('OpenCode MCP command must be a non-empty executable path or name');
+    if (skillDiscoveryMode !== undefined && !isSkillDiscoveryMode(skillDiscoveryMode)) {
+        validation('OpenCode Skill discovery mode is invalid');
+    }
+    if (options.replaceConflictingIdentity !== undefined
+        && typeof options.replaceConflictingIdentity !== 'boolean') {
+        validation('OpenCode MCP replacement authorization is invalid');
+    }
+    const source = existing ?? '{\n  "$schema": "https://opencode.ai/config.json"\n}\n';
+    assertStrictJsonSyntax(source, { allowTrailingComma: true, disallowComments: false }, 'OpenCode config is not a valid JSON/JSONC object with unique keys');
+    const errors = [];
+    const parsed = parse(source, errors, { allowTrailingComma: true, disallowComments: false });
+    if (errors.length > 0 || typeof parsed !== 'object' || parsed === null || Array.isArray(parsed)) {
+        validation('OpenCode config is not a valid JSON/JSONC object');
+    }
+    const root = parsed;
+    const mcp = object(root.mcp);
+    if (root.mcp !== undefined && mcp === undefined)
+        validation('OpenCode config has an invalid mcp object');
+    const currentServer = mcp?.kiokuko;
+    const canonicalServer = currentServer !== undefined && isCanonicalManagedServer(currentServer)
+        ? currentServer
+        : undefined;
+    if (currentServer !== undefined && canonicalServer === undefined && !options.replaceConflictingIdentity)
+        conflict();
+    const currentEnvironment = canonicalServer === undefined ? undefined : object(canonicalServer.environment);
+    const effectiveSkillDiscoveryMode = skillDiscoveryMode
+        ?? currentEnvironment?.[SKILL_DISCOVERY_ENV]
+        ?? 'official';
+    const eol = source.includes('\r\n') ? '\r\n' : '\n';
+    const edits = modify(source, ['mcp', 'kiokuko'], {
+        type: 'local',
+        command: [command, 'mcp'],
+        enabled: true,
+        environment: { [SKILL_DISCOVERY_ENV]: effectiveSkillDiscoveryMode },
+    }, {
+        formattingOptions: { insertSpaces: true, tabSize: 2, eol },
+    });
+    const content = applyEdits(source, edits);
+    return {
+        content,
+        action: existing === undefined ? 'created' : content === existing ? 'unchanged' : 'updated',
+    };
+}
+//# sourceMappingURL=opencode-config.js.map

package/dist/setup/opencode-config.js.map

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

package/dist/setup/project-agent-refresh.d.ts

@@ -0,0 +1,41 @@
+import { lstat } from 'node:fs/promises';
+import type { SqliteDatabase } from '../db/adapter.js';
+import { type ErrorCode } from '../errors.js';
+import { useRepository } from '../commands/use.js';
+export declare const MAX_SETUP_PROJECT_LOCATIONS = 10000;
+export interface RegisteredProjectLocation {
+    repositoryId: string;
+    workspace: string;
+    repositoryRoot: string;
+}
+export type ProjectAgentRefreshResult = RegisteredProjectLocation & ({
+    status: 'created' | 'updated' | 'unchanged';
+    agentFile: string;
+    bindingAction: 'created' | 'updated' | 'unchanged' | 'planned';
+} | {
+    status: 'skipped';
+    agentFile: null;
+    reason: 'missing_root' | 'unsafe_root';
+} | {
+    status: 'failed';
+    agentFile: null;
+    reason: 'inaccessible_root' | 'use_rejected';
+    errorCode: ErrorCode | 'FILESYSTEM_ERROR';
+});
+export interface RefreshRegisteredProjectOptions {
+    databasePath: string;
+    migrationsDirectory?: string;
+    dryRun?: boolean;
+}
+export interface RefreshRegisteredProjectDependencies {
+    useRepository?: typeof useRepository;
+    lstat?: typeof lstat;
+}
+export interface ListRegisteredProjectOptions {
+    allowUnavailableRegistry?: boolean;
+}
+/** Read one bounded, validated snapshot of project locations persisted by Kiokuko. */
+export declare function listRegisteredProjectLocations(database: SqliteDatabase, options?: ListRegisteredProjectOptions): RegisteredProjectLocation[];
+/** Apply the existing `kiokuko use` file contract to each registered live project. */
+export declare function refreshRegisteredProjectAgentFiles(locations: readonly RegisteredProjectLocation[], options: RefreshRegisteredProjectOptions, dependencyOverrides?: RefreshRegisteredProjectDependencies): Promise<ProjectAgentRefreshResult[]>;
+//# sourceMappingURL=project-agent-refresh.d.ts.map

package/dist/setup/project-agent-refresh.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"project-agent-refresh.d.ts","sourceRoot":"","sources":["../../src/setup/project-agent-refresh.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AAGzC,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,EAAgB,KAAK,SAAS,EAAE,MAAM,cAAc,CAAC;AAE5D,OAAO,EAAE,aAAa,EAAmB,MAAM,oBAAoB,CAAC;AAEpE,eAAO,MAAM,2BAA2B,QAAS,CAAC;AAGlD,MAAM,WAAW,yBAAyB;IACxC,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,MAAM,yBAAyB,GAAG,yBAAyB,GAAG,CAChE;IACE,MAAM,EAAE,SAAS,GAAG,SAAS,GAAG,WAAW,CAAC;IAC5C,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,EAAE,SAAS,GAAG,SAAS,GAAG,WAAW,GAAG,SAAS,CAAC;CAChE,GACD;IACE,MAAM,EAAE,SAAS,CAAC;IAClB,SAAS,EAAE,IAAI,CAAC;IAChB,MAAM,EAAE,cAAc,GAAG,aAAa,CAAC;CACxC,GACD;IACE,MAAM,EAAE,QAAQ,CAAC;IACjB,SAAS,EAAE,IAAI,CAAC;IAChB,MAAM,EAAE,mBAAmB,GAAG,cAAc,CAAC;IAC7C,SAAS,EAAE,SAAS,GAAG,kBAAkB,CAAC;CAC3C,CACJ,CAAC;AAUF,MAAM,WAAW,+BAA+B;IAC9C,YAAY,EAAE,MAAM,CAAC;IACrB,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,oCAAoC;IACnD,aAAa,CAAC,EAAE,OAAO,aAAa,CAAC;IACrC,KAAK,CAAC,EAAE,OAAO,KAAK,CAAC;CACtB;AAED,MAAM,WAAW,4BAA4B;IAC3C,wBAAwB,CAAC,EAAE,OAAO,CAAC;CACpC;AAyBD,sFAAsF;AACtF,wBAAgB,8BAA8B,CAC5C,QAAQ,EAAE,cAAc,EACxB,OAAO,GAAE,4BAAiC,GACzC,yBAAyB,EAAE,CAyB7B;AA0FD,sFAAsF;AACtF,wBAAsB,kCAAkC,CACtD,SAAS,EAAE,SAAS,yBAAyB,EAAE,EAC/C,OAAO,EAAE,+BAA+B,EACxC,mBAAmB,GAAE,oCAAyC,GAC7D,OAAO,CAAC,yBAAyB,EAAE,CAAC,CAatC"}