@devflow-tools/sdk 0.16.10 → 0.16.11

package/dist/host-adapters/claude-code.js

@@ -0,0 +1,61 @@
+import { join } from 'node:path';
+import { capability, pathScore, resolvedHome, } from '../host-adapter.js';
+import { projectJsonMcpServer, registerClaudePlugin } from './projection.js';
+const HOOK_CAPABILITIES = [
+    'hooks.session_start',
+    'hooks.prompt_submit',
+    'hooks.pre_tool_use',
+    'hooks.post_tool_use',
+    'hooks.stop',
+    'hooks.session_end',
+];
+export const claudeCodeHostAdapter = {
+    id: 'claude-code',
+    aliases: ['claude', 'claude_code'],
+    async detect(context) {
+        if (context.env?.CLAUDE_PROJECT_DIR || context.env?.CLAUDE_CODE_ENTRYPOINT)
+            return 100;
+        return Math.max(pathScore(join(context.projectRoot, '.claude'), 70), pathScore(join(resolvedHome(context), '.claude'), 30));
+    },
+    async capabilities() {
+        return [
+            ...HOOK_CAPABILITIES.map(name => capability(name, 'supported', 'claude-plugin-hook')),
+            capability('mcp.stdio', 'supported', 'claude-mcp-config'),
+            capability('mcp.http', 'supported', 'claude-mcp-config'),
+            capability('skills.native', 'supported', 'claude-plugin-skills'),
+            capability('instructions.project', 'supported', 'CLAUDE.md'),
+            capability('session.history', 'supported', 'claude-project-history'),
+        ];
+    },
+    mcp: {
+        hostId: 'claude-code',
+        format: 'json',
+        ownedServerName: 'devflow',
+        configPaths(context) {
+            const home = resolvedHome(context);
+            return [
+                join(context.projectRoot, '.mcp.json'),
+                join(context.projectRoot, '.claude', 'mcp.json'),
+                join(home, '.claude', '.mcp.json'),
+                join(home, '.claude.json'),
+                join(home, '.claude', 'settings.json'),
+            ];
+        },
+        project(context, server) {
+            return projectJsonMcpServer(join(context.projectRoot, '.mcp.json'), 'devflow', server);
+        },
+    },
+    skills: {
+        native: true,
+        targetDirectories: context => [join(resolvedHome(context), '.claude', 'plugins')],
+        project(context, source) {
+            return [registerClaudePlugin(join(resolvedHome(context), '.claude', 'plugins', 'known_marketplaces.json'), source.pluginRoot)];
+        },
+    },
+    sessions: {
+        status: 'supported',
+        historyPaths: context => [join(resolvedHome(context), '.claude', 'projects')],
+    },
+    hooks: { nativeEvents: HOOK_CAPABILITIES, profileSupport: ['minimal', 'standard', 'strict'] },
+};
+//# sourceMappingURL=claude-code.js.map

package/dist/host-adapters/claude-code.js.map

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

package/dist/host-adapters/codex.d.ts

@@ -0,0 +1,3 @@
+import { type HostAdapter } from '../host-adapter.js';
+export declare const codexHostAdapter: HostAdapter;
+//# sourceMappingURL=codex.d.ts.map

package/dist/host-adapters/codex.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"codex.d.ts","sourceRoot":"","sources":["../../src/host-adapters/codex.ts"],"names":[],"mappings":"AACA,OAAO,EAAuC,KAAK,WAAW,EAAuB,MAAM,oBAAoB,CAAC;AAYhH,eAAO,MAAM,gBAAgB,EAAE,WAsD9B,CAAC"}

package/dist/host-adapters/codex.js

@@ -0,0 +1,54 @@
+import { join } from 'node:path';
+import { capability, pathScore, resolvedHome } from '../host-adapter.js';
+import { projectBoundedInstructions, projectCodexMcpServer, projectNativeSkills } from './projection.js';
+const HOOKS = [
+    'hooks.session_start', 'hooks.prompt_submit', 'hooks.pre_tool_use',
+    'hooks.post_tool_use', 'hooks.stop', 'hooks.session_end',
+];
+function codexHome(context) {
+    return context.env?.CODEX_HOME || join(resolvedHome(context), '.codex');
+}
+export const codexHostAdapter = {
+    id: 'codex',
+    aliases: ['openai-codex'],
+    async detect(context) {
+        if (context.env?.CODEX_HOME || context.env?.CODEX_THREAD_ID)
+            return 100;
+        return Math.max(pathScore(join(context.projectRoot, '.codex'), 70), pathScore(codexHome(context), 30));
+    },
+    async capabilities() {
+        return [
+            ...HOOKS.map(name => capability(name, 'unavailable', undefined, 'Codex does not expose Claude-compatible lifecycle Hooks.', 'Use MCP tools, native Skills, project instructions, and durable server-side receipts.')),
+            capability('mcp.stdio', 'supported', 'codex-config-toml'),
+            capability('mcp.http', 'supported', 'codex-config-toml'),
+            capability('skills.native', 'supported', 'codex-skills'),
+            capability('instructions.project', 'supported', 'AGENTS.md'),
+            capability('session.history', 'degraded', 'codex-session-metadata', 'Lifecycle boundaries are not Hook-backed.', 'Use durable MCP receipts and queue state.'),
+        ];
+    },
+    mcp: {
+        hostId: 'codex',
+        format: 'toml',
+        ownedServerName: 'devflow',
+        configPaths: context => [
+            join(context.projectRoot, '.codex', 'config.toml'),
+            join(codexHome(context), 'config.toml'),
+        ],
+        project: (context, server) => projectCodexMcpServer(join(codexHome(context), 'config.toml'), 'devflow', server),
+    },
+    skills: {
+        native: true,
+        targetDirectories: context => [join(codexHome(context), 'skills')],
+        project(context, source) {
+            return [
+                projectNativeSkills(join(codexHome(context), 'skills'), source.skillsDirectory),
+                projectBoundedInstructions(join(context.projectRoot, 'AGENTS.md'), source.instructionContent),
+            ];
+        },
+    },
+    sessions: {
+        status: 'degraded',
+        historyPaths: context => [join(codexHome(context), 'sessions')],
+    },
+};
+//# sourceMappingURL=codex.js.map

package/dist/host-adapters/codex.js.map

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

package/dist/host-adapters/generic-mcp.d.ts

@@ -0,0 +1,3 @@
+import { type HostAdapter } from '../host-adapter.js';
+export declare const genericMcpHostAdapter: HostAdapter;
+//# sourceMappingURL=generic-mcp.d.ts.map

package/dist/host-adapters/generic-mcp.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generic-mcp.d.ts","sourceRoot":"","sources":["../../src/host-adapters/generic-mcp.ts"],"names":[],"mappings":"AACA,OAAO,EAAc,KAAK,WAAW,EAAuB,MAAM,oBAAoB,CAAC;AAQvF,eAAO,MAAM,qBAAqB,EAAE,WAmCnC,CAAC"}

package/dist/host-adapters/generic-mcp.js

@@ -0,0 +1,37 @@
+import { join } from 'node:path';
+import { capability } from '../host-adapter.js';
+import { projectInstructionFallback, projectJsonMcpServer } from './projection.js';
+const HOOKS = [
+    'hooks.session_start', 'hooks.prompt_submit', 'hooks.pre_tool_use',
+    'hooks.post_tool_use', 'hooks.stop', 'hooks.session_end',
+];
+export const genericMcpHostAdapter = {
+    id: 'generic-mcp',
+    aliases: ['generic', 'mcp', 'cursor', 'cline'],
+    detect: async () => 1,
+    async capabilities() {
+        return [
+            ...HOOKS.map(name => capability(name, 'unavailable', undefined, 'The generic MCP contract has no lifecycle Hook API.', 'Use explicit MCP calls and canonical receipts.')),
+            capability('mcp.stdio', 'supported', 'host-managed-mcp'),
+            capability('mcp.http', 'supported', 'host-managed-mcp'),
+            capability('skills.native', 'unavailable', undefined, 'No host-native Skill format is assumed.', 'Project a concise instruction file and expose MCP schemas.'),
+            capability('instructions.project', 'degraded', 'host-managed-instructions', 'Instruction filename is host-defined.', 'Configure the host to load DevFlow project instructions.'),
+            capability('session.history', 'unavailable', undefined, 'No session history contract is assumed.', 'Use MCP session IDs supplied by the host.'),
+        ];
+    },
+    mcp: {
+        hostId: 'generic-mcp',
+        format: 'json',
+        ownedServerName: 'devflow',
+        configPaths: context => [join(context.projectRoot, '.mcp.json')],
+        project: (context, server) => projectJsonMcpServer(join(context.projectRoot, '.mcp.json'), 'devflow', server),
+    },
+    skills: {
+        native: false,
+        targetDirectories: () => [],
+        fallback: 'project-instructions-plus-mcp',
+        project: (context, source) => [projectInstructionFallback(join(context.projectRoot, '.devflow', 'instructions.md'), source.instructionContent)],
+    },
+    sessions: { status: 'unavailable', historyPaths: () => [] },
+};
+//# sourceMappingURL=generic-mcp.js.map

package/dist/host-adapters/generic-mcp.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"generic-mcp.js","sourceRoot":"","sources":["../../src/host-adapters/generic-mcp.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,UAAU,EAAyC,MAAM,oBAAoB,CAAC;AACvF,OAAO,EAAE,0BAA0B,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AAEnF,MAAM,KAAK,GAAqB;IAC9B,qBAAqB,EAAE,qBAAqB,EAAE,oBAAoB;IAClE,qBAAqB,EAAE,YAAY,EAAE,mBAAmB;CACzD,CAAC;AAEF,MAAM,CAAC,MAAM,qBAAqB,GAAgB;IAChD,EAAE,EAAE,aAAa;IACjB,OAAO,EAAE,CAAC,SAAS,EAAE,KAAK,EAAE,QAAQ,EAAE,OAAO,CAAC;IAC9C,MAAM,EAAE,KAAK,IAAI,EAAE,CAAC,CAAC;IACrB,KAAK,CAAC,YAAY;QAChB,OAAO;YACL,GAAG,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,IAAI,EAAE,aAAa,EAAE,SAAS,EAAE,qDAAqD,EAAE,gDAAgD,CAAC,CAAC;YACzK,UAAU,CAAC,WAAW,EAAE,WAAW,EAAE,kBAAkB,CAAC;YACxD,UAAU,CAAC,UAAU,EAAE,WAAW,EAAE,kBAAkB,CAAC;YACvD,UAAU,CAAC,eAAe,EAAE,aAAa,EAAE,SAAS,EAAE,yCAAyC,EAAE,4DAA4D,CAAC;YAC9J,UAAU,CAAC,sBAAsB,EAAE,UAAU,EAAE,2BAA2B,EAAE,uCAAuC,EAAE,0DAA0D,CAAC;YAChL,UAAU,CAAC,iBAAiB,EAAE,aAAa,EAAE,SAAS,EAAE,yCAAyC,EAAE,2CAA2C,CAAC;SAChJ,CAAC;IACJ,CAAC;IACD,GAAG,EAAE;QACH,MAAM,EAAE,aAAa;QACrB,MAAM,EAAE,MAAM;QACd,eAAe,EAAE,SAAS;QAC1B,WAAW,EAAE,OAAO,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,WAAW,EAAE,WAAW,CAAC,CAAC;QAChE,OAAO,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,CAAC,oBAAoB,CAChD,IAAI,CAAC,OAAO,CAAC,WAAW,EAAE,WAAW,CAAC,EACtC,SAAS,EACT,MAAM,CACP;KACF;IACD,MAAM,EAAE;QACN,MAAM,EAAE,KAAK;QACb,iBAAiB,EAAE,GAAG,EAAE,CAAC,EAAE;QAC3B,QAAQ,EAAE,+BAA+B;QACzC,OAAO,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,CAAC,CAAC,0BAA0B,CACvD,IAAI,CAAC,OAAO,CAAC,WAAW,EAAE,UAAU,EAAE,iBAAiB,CAAC,EACxD,MAAM,CAAC,kBAAkB,CAC1B,CAAC;KACH;IACD,QAAQ,EAAE,EAAE,MAAM,EAAE,aAAa,EAAE,YAAY,EAAE,GAAG,EAAE,CAAC,EAAE,EAAE;CAC5D,CAAC"}

package/dist/host-adapters/index.d.ts

@@ -0,0 +1,8 @@
+import { HostAdapterRegistry, type HostDetectionContext, type HostAdapterSelection } from '../host-adapter.js';
+import { claudeCodeHostAdapter } from './claude-code.js';
+import { codexHostAdapter } from './codex.js';
+import { genericMcpHostAdapter } from './generic-mcp.js';
+export { claudeCodeHostAdapter, codexHostAdapter, genericMcpHostAdapter };
+export declare function createDefaultHostAdapterRegistry(): HostAdapterRegistry;
+export declare function selectHostAdapter(context: HostDetectionContext): Promise<HostAdapterSelection>;
+//# sourceMappingURL=index.d.ts.map

package/dist/host-adapters/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/host-adapters/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,KAAK,oBAAoB,EAAE,KAAK,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAC/G,OAAO,EAAE,qBAAqB,EAAE,MAAM,kBAAkB,CAAC;AACzD,OAAO,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAC9C,OAAO,EAAE,qBAAqB,EAAE,MAAM,kBAAkB,CAAC;AAEzD,OAAO,EAAE,qBAAqB,EAAE,gBAAgB,EAAE,qBAAqB,EAAE,CAAC;AAE1E,wBAAgB,gCAAgC,IAAI,mBAAmB,CAMtE;AAED,wBAAsB,iBAAiB,CAAC,OAAO,EAAE,oBAAoB,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAEpG"}

package/dist/host-adapters/index.js

@@ -0,0 +1,16 @@
+import { HostAdapterRegistry } from '../host-adapter.js';
+import { claudeCodeHostAdapter } from './claude-code.js';
+import { codexHostAdapter } from './codex.js';
+import { genericMcpHostAdapter } from './generic-mcp.js';
+export { claudeCodeHostAdapter, codexHostAdapter, genericMcpHostAdapter };
+export function createDefaultHostAdapterRegistry() {
+    const registry = new HostAdapterRegistry();
+    registry.register(claudeCodeHostAdapter);
+    registry.register(codexHostAdapter);
+    registry.register(genericMcpHostAdapter);
+    return registry;
+}
+export async function selectHostAdapter(context) {
+    return createDefaultHostAdapterRegistry().select(context);
+}
+//# sourceMappingURL=index.js.map

package/dist/host-adapters/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/host-adapters/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAwD,MAAM,oBAAoB,CAAC;AAC/G,OAAO,EAAE,qBAAqB,EAAE,MAAM,kBAAkB,CAAC;AACzD,OAAO,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAC9C,OAAO,EAAE,qBAAqB,EAAE,MAAM,kBAAkB,CAAC;AAEzD,OAAO,EAAE,qBAAqB,EAAE,gBAAgB,EAAE,qBAAqB,EAAE,CAAC;AAE1E,MAAM,UAAU,gCAAgC;IAC9C,MAAM,QAAQ,GAAG,IAAI,mBAAmB,EAAE,CAAC;IAC3C,QAAQ,CAAC,QAAQ,CAAC,qBAAqB,CAAC,CAAC;IACzC,QAAQ,CAAC,QAAQ,CAAC,gBAAgB,CAAC,CAAC;IACpC,QAAQ,CAAC,QAAQ,CAAC,qBAAqB,CAAC,CAAC;IACzC,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,iBAAiB,CAAC,OAA6B;IACnE,OAAO,gCAAgC,EAAE,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;AAC5D,CAAC"}

package/dist/host-adapters/projection.d.ts

@@ -0,0 +1,8 @@
+import type { McpServerProjection, ProjectionResult } from '../host-adapter.js';
+export declare function projectJsonMcpServer(path: string, serverName: string, server: McpServerProjection): ProjectionResult;
+export declare function projectCodexMcpServer(path: string, serverName: string, server: McpServerProjection): ProjectionResult;
+export declare function registerClaudePlugin(path: string, pluginRoot: string | undefined): ProjectionResult;
+export declare function projectNativeSkills(path: string, source: string | undefined): ProjectionResult;
+export declare function projectBoundedInstructions(path: string, content?: string): ProjectionResult;
+export declare function projectInstructionFallback(path: string, content?: string): ProjectionResult;
+//# sourceMappingURL=projection.d.ts.map

package/dist/host-adapters/projection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"projection.d.ts","sourceRoot":"","sources":["../../src/host-adapters/projection.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,mBAAmB,EAAsB,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAqCpG,wBAAgB,oBAAoB,CAClC,IAAI,EAAE,MAAM,EACZ,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,mBAAmB,GAC1B,gBAAgB,CAmBlB;AA+ED,wBAAgB,qBAAqB,CACnC,IAAI,EAAE,MAAM,EACZ,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,mBAAmB,GAC1B,gBAAgB,CAclB;AAED,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,SAAS,GAAG,gBAAgB,CAqGnG;AAED,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,SAAS,GAAG,gBAAgB,CA6C9F;AA6CD,wBAAgB,0BAA0B,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,gBAAgB,CA2B3F;AAED,wBAAgB,0BAA0B,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,gBAAgB,CAmB3F"}

package/dist/host-adapters/projection.js

@@ -0,0 +1,396 @@
+import { cpSync, existsSync, mkdirSync, readFileSync, readdirSync, statSync, writeFileSync } from 'node:fs';
+import { dirname, join, relative } from 'node:path';
+function failure(artifact, path, error) {
+    return {
+        artifact,
+        status: 'failed',
+        changed: false,
+        path,
+        message: error instanceof Error ? error.message : String(error),
+    };
+}
+function readJsonObject(path) {
+    if (!existsSync(path))
+        return {};
+    const parsed = JSON.parse(readFileSync(path, 'utf8'));
+    if (!parsed || typeof parsed !== 'object' || Array.isArray(parsed)) {
+        throw new Error(`Expected a JSON object in ${path}; no changes were written.`);
+    }
+    return parsed;
+}
+function sameJson(left, right) {
+    return JSON.stringify(left) === JSON.stringify(right);
+}
+function normalizedServer(server) {
+    if (!server.command && !server.url) {
+        throw new Error('An MCP projection requires either command or url.');
+    }
+    return {
+        ...(server.command ? { command: server.command } : {}),
+        ...(server.args && server.args.length > 0 ? { args: server.args } : {}),
+        ...(server.url ? { url: server.url } : {}),
+        ...(server.env && Object.keys(server.env).length > 0 ? { env: server.env } : {}),
+    };
+}
+export function projectJsonMcpServer(path, serverName, server) {
+    try {
+        const existing = readJsonObject(path);
+        const rawServers = existing.mcpServers;
+        if (rawServers !== undefined && (!rawServers || typeof rawServers !== 'object' || Array.isArray(rawServers))) {
+            throw new Error(`Expected mcpServers to be a JSON object in ${path}; no changes were written.`);
+        }
+        const servers = { ...(rawServers ?? {}) };
+        const projected = normalizedServer(server);
+        if (sameJson(servers[serverName], projected)) {
+            return { artifact: 'mcp', status: 'unchanged', changed: false, path, message: `${serverName} MCP server is already configured.` };
+        }
+        servers[serverName] = projected;
+        mkdirSync(dirname(path), { recursive: true });
+        writeFileSync(path, `${JSON.stringify({ ...existing, mcpServers: servers }, null, 2)}\n`);
+        return { artifact: 'mcp', status: 'written', changed: true, path, message: `${serverName} MCP server configured.` };
+    }
+    catch (error) {
+        return failure('mcp', path, error);
+    }
+}
+function quoteToml(value) {
+    return JSON.stringify(value);
+}
+function parseTablePath(header) {
+    const trimmed = header.trim();
+    const match = trimmed.startsWith('[[')
+        ? /^\[\[\s*([^\]]+)\s*\]\](?:\s*#.*)?$/.exec(trimmed)
+        : /^\[\s*([^\]]+)\s*\](?:\s*#.*)?$/.exec(trimmed);
+    if (!match)
+        return null;
+    const path = [];
+    let cursor = 0;
+    const input = match[1];
+    while (cursor < input.length) {
+        while (/\s/.test(input[cursor] ?? ''))
+            cursor += 1;
+        const quote = input[cursor] === '"' || input[cursor] === "'" ? input[cursor++] : undefined;
+        let segment = '';
+        while (cursor < input.length) {
+            const char = input[cursor];
+            if (quote) {
+                if (char === quote) {
+                    cursor += 1;
+                    break;
+                }
+                if (quote === '"' && char === '\\' && cursor + 1 < input.length) {
+                    segment += input[cursor + 1];
+                    cursor += 2;
+                    continue;
+                }
+            }
+            else if (char === '.' || /\s/.test(char)) {
+                break;
+            }
+            segment += char;
+            cursor += 1;
+        }
+        if (!segment)
+            return null;
+        path.push(segment);
+        while (/\s/.test(input[cursor] ?? ''))
+            cursor += 1;
+        if (cursor >= input.length)
+            break;
+        if (input[cursor] !== '.')
+            return null;
+        cursor += 1;
+    }
+    return path;
+}
+function removeOwnedTomlTables(content, serverName) {
+    const lines = content.split(/\r?\n/);
+    const kept = [];
+    let skip = false;
+    for (const line of lines) {
+        const table = parseTablePath(line);
+        if (table) {
+            skip = table[0] === 'mcp_servers' && table[1] === serverName;
+        }
+        if (!skip)
+            kept.push(line);
+    }
+    while (kept.length > 0 && kept[kept.length - 1] === '')
+        kept.pop();
+    return kept.join('\n');
+}
+function renderCodexServer(serverName, server) {
+    normalizedServer(server);
+    const lines = [`[mcp_servers.${quoteToml(serverName)}]`];
+    if (server.command)
+        lines.push(`command = ${quoteToml(server.command)}`);
+    if (server.args && server.args.length > 0) {
+        lines.push(`args = [${server.args.map(quoteToml).join(', ')}]`);
+    }
+    if (server.url)
+        lines.push(`url = ${quoteToml(server.url)}`);
+    if (server.env && Object.keys(server.env).length > 0) {
+        lines.push('', `[mcp_servers.${quoteToml(serverName)}.env]`);
+        for (const key of Object.keys(server.env).sort()) {
+            lines.push(`${quoteToml(key)} = ${quoteToml(server.env[key])}`);
+        }
+    }
+    return lines.join('\n');
+}
+export function projectCodexMcpServer(path, serverName, server) {
+    try {
+        const existing = existsSync(path) ? readFileSync(path, 'utf8') : '';
+        const preserved = removeOwnedTomlTables(existing, serverName);
+        const projected = [preserved, renderCodexServer(serverName, server)].filter(Boolean).join('\n\n') + '\n';
+        if (existing === projected) {
+            return { artifact: 'mcp', status: 'unchanged', changed: false, path, message: `${serverName} MCP server is already configured.` };
+        }
+        mkdirSync(dirname(path), { recursive: true });
+        writeFileSync(path, projected);
+        return { artifact: 'mcp', status: 'written', changed: true, path, message: `${serverName} MCP server configured.` };
+    }
+    catch (error) {
+        return failure('mcp', path, error);
+    }
+}
+export function registerClaudePlugin(path, pluginRoot) {
+    if (!pluginRoot) {
+        return { artifact: 'plugin', status: 'failed', changed: false, path, message: 'Claude plugin directory was not found.' };
+    }
+    const pluginManifestPath = join(pluginRoot, '.claude-plugin', 'plugin.json');
+    if (!existsSync(pluginManifestPath)) {
+        return { artifact: 'plugin', status: 'failed', changed: false, path, message: `Claude plugin manifest was not found at ${pluginManifestPath}.` };
+    }
+    try {
+        const pluginsDir = dirname(path);
+        const marketplaceRoot = join(pluginsDir, 'marketplaces', 'devflow-local');
+        const marketplacePath = join(marketplaceRoot, '.claude-plugin', 'marketplace.json');
+        const installedPath = join(pluginsDir, 'installed_plugins.json');
+        const settingsPath = join(dirname(pluginsDir), 'settings.json');
+        const known = readJsonObject(path);
+        const installed = readJsonObject(installedPath);
+        const settings = readJsonObject(settingsPath);
+        const rawPlugins = installed.plugins;
+        if (rawPlugins !== undefined && (!rawPlugins || typeof rawPlugins !== 'object' || Array.isArray(rawPlugins))) {
+            throw new Error(`Invalid Claude plugin registry plugins in ${installedPath}; no changes were written.`);
+        }
+        const plugins = { ...(rawPlugins ?? {}) };
+        const rawDevflowEntries = plugins['devflow@devflow-local'];
+        if (rawDevflowEntries !== undefined && !Array.isArray(rawDevflowEntries)) {
+            throw new Error(`Invalid Claude plugin registration in ${installedPath}; no changes were written.`);
+        }
+        const rawEnabled = settings.enabledPlugins;
+        const rawExtraMarketplaces = settings.extraKnownMarketplaces;
+        if (rawEnabled !== undefined && (!rawEnabled || typeof rawEnabled !== 'object' || Array.isArray(rawEnabled))) {
+            throw new Error(`Invalid enabledPlugins in ${settingsPath}; no changes were written.`);
+        }
+        if (rawExtraMarketplaces !== undefined && (!rawExtraMarketplaces || typeof rawExtraMarketplaces !== 'object' || Array.isArray(rawExtraMarketplaces))) {
+            throw new Error(`Invalid extraKnownMarketplaces in ${settingsPath}; no changes were written.`);
+        }
+        const version = readPluginVersion(pluginRoot);
+        const existingEntries = rawDevflowEntries ?? [];
+        const existingUser = existingEntries.find(entry => isRecord(entry) && entry.scope === 'user');
+        const otherEntries = existingEntries.filter(entry => !isRecord(entry) || entry.scope !== 'user');
+        const unchangedInstall = isRecord(existingUser)
+            && existingUser.installPath === pluginRoot
+            && existingUser.version === version;
+        const now = new Date().toISOString();
+        const installedAt = isRecord(existingUser) && typeof existingUser.installedAt === 'string'
+            ? existingUser.installedAt
+            : now;
+        const lastUpdated = unchangedInstall && isRecord(existingUser) && typeof existingUser.lastUpdated === 'string'
+            ? existingUser.lastUpdated
+            : now;
+        plugins['devflow@devflow-local'] = [
+            ...otherEntries,
+            {
+                ...(isRecord(existingUser) ? existingUser : {}),
+                scope: 'user',
+                installPath: pluginRoot,
+                version,
+                installedAt,
+                lastUpdated,
+            },
+        ];
+        let pluginSource = relative(marketplaceRoot, pluginRoot).replaceAll('\\', '/');
+        if (!pluginSource.startsWith('.'))
+            pluginSource = `./${pluginSource}`;
+        const marketplace = {
+            name: 'devflow-local',
+            description: 'DevFlow local Claude Code plugin',
+            owner: { name: 'DevFlow' },
+            plugins: [{ name: 'devflow', source: pluginSource }],
+        };
+        const knownEntry = isRecord(known['devflow-local']) ? known['devflow-local'] : {};
+        const projectedKnown = {
+            ...known,
+            'devflow-local': {
+                ...knownEntry,
+                source: { source: 'directory', path: marketplaceRoot },
+                installLocation: marketplaceRoot,
+            },
+        };
+        const enabledPlugins = { ...(rawEnabled ?? {}) };
+        enabledPlugins['devflow@devflow-local'] = true;
+        const extraKnown = { ...(rawExtraMarketplaces ?? {}) };
+        extraKnown['devflow-local'] = { source: { source: 'directory', path: marketplaceRoot } };
+        const projectedSettings = { ...settings, enabledPlugins, extraKnownMarketplaces: extraKnown };
+        const projectedInstalled = { ...installed, version: 2, plugins };
+        const targets = [
+            { targetPath: marketplacePath, existing: readJsonObject(marketplacePath), projected: marketplace },
+            { targetPath: path, existing: known, projected: projectedKnown },
+            { targetPath: installedPath, existing: installed, projected: projectedInstalled },
+            { targetPath: settingsPath, existing: settings, projected: projectedSettings },
+        ];
+        const changedTargets = targets.filter(target => !sameJson(target.existing, target.projected));
+        for (const target of changedTargets) {
+            mkdirSync(dirname(target.targetPath), { recursive: true });
+            writeFileSync(target.targetPath, `${JSON.stringify(target.projected, null, 2)}\n`);
+        }
+        return changedTargets.length === 0
+            ? { artifact: 'plugin', status: 'unchanged', changed: false, path: marketplacePath, message: 'Claude plugin is already registered.' }
+            : { artifact: 'plugin', status: 'written', changed: true, path: marketplacePath, message: 'Claude plugin marketplace, installation, and enablement registered.' };
+    }
+    catch (error) {
+        return failure('plugin', path, error);
+    }
+}
+export function projectNativeSkills(path, source) {
+    if (!source || !existsSync(source)) {
+        return { artifact: 'skills', status: 'failed', changed: false, path, message: 'DevFlow Skill source directory was not found.' };
+    }
+    try {
+        const projections = readdirSync(source)
+            .filter(entry => entry.startsWith('devflow') && statSync(join(source, entry)).isDirectory())
+            .map(entry => ({ sourceName: entry, targetName: normalizeCodexSkillName(entry) }));
+        const byTarget = new Map();
+        for (const projection of projections) {
+            const names = byTarget.get(projection.targetName) ?? [];
+            names.push(projection.sourceName);
+            byTarget.set(projection.targetName, names);
+        }
+        const collision = [...byTarget.entries()].find(([, names]) => names.length > 1);
+        if (collision) {
+            return {
+                artifact: 'skills',
+                status: 'failed',
+                changed: false,
+                path,
+                message: `Codex Skill name collision for ${collision[0]}: ${collision[1].join(', ')}.`,
+            };
+        }
+        mkdirSync(path, { recursive: true });
+        let count = 0;
+        for (const projection of projections) {
+            const sourcePath = join(source, projection.sourceName);
+            const targetPath = join(path, projection.targetName);
+            cpSync(sourcePath, targetPath, { recursive: true, force: true });
+            const skillPath = join(targetPath, 'SKILL.md');
+            if (!existsSync(skillPath)) {
+                throw new Error(`Codex Skill source is missing SKILL.md: ${sourcePath}`);
+            }
+            const content = readFileSync(skillPath, 'utf8');
+            writeFileSync(skillPath, rewriteSkillFrontmatterName(content, projection.targetName));
+            count += 1;
+        }
+        if (count === 0) {
+            return { artifact: 'skills', status: 'failed', changed: false, path, message: 'No DevFlow Skills were found to project.' };
+        }
+        return { artifact: 'skills', status: 'written', changed: true, path, message: `${count} native DevFlow Skills projected.` };
+    }
+    catch (error) {
+        return failure('skills', path, error);
+    }
+}
+function normalizeCodexSkillName(name) {
+    const normalized = name.toLowerCase()
+        .replace(/[^a-z0-9-]+/g, '-')
+        .replace(/-+/g, '-')
+        .replace(/^-|-$/g, '');
+    if (!normalized || !/^[a-z0-9-]+$/.test(normalized)) {
+        throw new Error(`Cannot derive a valid Codex Skill name from ${name}.`);
+    }
+    return normalized;
+}
+function rewriteSkillFrontmatterName(content, name) {
+    if (!content.startsWith('---\n')) {
+        return `---\nname: ${name}\n---\n${content}`;
+    }
+    const end = content.indexOf('\n---', 4);
+    if (end < 0)
+        throw new Error('Skill frontmatter is missing its closing marker.');
+    const frontmatter = content.slice(4, end);
+    const rewritten = /^name\s*:.*$/m.test(frontmatter)
+        ? frontmatter.replace(/^name\s*:.*$/m, `name: ${name}`)
+        : `name: ${name}\n${frontmatter}`;
+    return `---\n${rewritten}${content.slice(end)}`;
+}
+function readPluginVersion(pluginRoot) {
+    for (const path of [join(pluginRoot, 'package.json'), join(pluginRoot, '.claude-plugin', 'plugin.json')]) {
+        try {
+            const value = JSON.parse(readFileSync(path, 'utf8'));
+            if (typeof value.version === 'string' && value.version)
+                return value.version;
+        }
+        catch {
+            // Try the next plugin metadata source.
+        }
+    }
+    return 'unknown';
+}
+function isRecord(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+const DEVFLOW_INSTRUCTIONS_START = '<!-- devflow:instructions:start -->';
+const DEVFLOW_INSTRUCTIONS_END = '<!-- devflow:instructions:end -->';
+export function projectBoundedInstructions(path, content) {
+    const body = (content ?? [
+        '## DevFlow',
+        '',
+        'Use the projected DevFlow Skills and the configured `devflow` MCP server for context, memory, knowledge, workflow, and telemetry operations.',
+        'Lifecycle Hooks are unavailable on this host. Rely on canonical MCP receipts and explicit capability degradation instead of assuming native tool blocking.',
+    ].join('\n')).trim();
+    const section = `${DEVFLOW_INSTRUCTIONS_START}\n${body}\n${DEVFLOW_INSTRUCTIONS_END}`;
+    try {
+        const existing = existsSync(path) ? readFileSync(path, 'utf8') : '';
+        const start = existing.indexOf(DEVFLOW_INSTRUCTIONS_START);
+        const end = existing.indexOf(DEVFLOW_INSTRUCTIONS_END);
+        if ((start >= 0) !== (end >= 0) || (start >= 0 && end < start)) {
+            throw new Error(`DevFlow instruction markers are incomplete in ${path}; no changes were written.`);
+        }
+        const projected = start >= 0
+            ? `${existing.slice(0, start)}${section}${existing.slice(end + DEVFLOW_INSTRUCTIONS_END.length)}`
+            : `${existing.trimEnd()}${existing.trimEnd() ? '\n\n' : ''}${section}\n`;
+        if (existing === projected) {
+            return { artifact: 'instructions', status: 'unchanged', changed: false, path, message: 'DevFlow project instructions are already configured.' };
+        }
+        mkdirSync(dirname(path), { recursive: true });
+        writeFileSync(path, projected);
+        return { artifact: 'instructions', status: 'written', changed: true, path, message: 'DevFlow project instructions configured.' };
+    }
+    catch (error) {
+        return failure('instructions', path, error);
+    }
+}
+export function projectInstructionFallback(path, content) {
+    const instructions = content ?? [
+        '# DevFlow',
+        '',
+        'Use the configured `devflow` MCP server for DevFlow context, memory, knowledge, workflow, and telemetry operations.',
+        'This host has no assumed native Skill or lifecycle Hook integration. Treat MCP receipts as the authoritative result.',
+        '',
+    ].join('\n');
+    try {
+        const existing = existsSync(path) ? readFileSync(path, 'utf8') : undefined;
+        if (existing === instructions) {
+            return { artifact: 'instructions', status: 'degraded', changed: false, path, message: 'Generic host instructions already exist; configure the host to load this file.' };
+        }
+        mkdirSync(dirname(path), { recursive: true });
+        writeFileSync(path, instructions);
+        return { artifact: 'instructions', status: 'degraded', changed: true, path, message: 'Generic host instructions written; configure the host to load this file.' };
+    }
+    catch (error) {
+        return failure('instructions', path, error);
+    }
+}
+//# sourceMappingURL=projection.js.map