sdd-mcp-server 3.4.0 → 3.5.0

package/dist/cli/tool-support/claude-code.js

@@ -0,0 +1,93 @@
+import * as fs from 'fs';
+import * as path from 'path';
+import { findTemplate } from '../utils/find-package-root.js';
+import { PreservingWriter, validateChildName } from '../utils/preserving-writer.js';
+import { parseSourceAgent, renderClaudeCodeAgent } from './target-agent-renderer.js';
+import { buildGuidanceSection, buildSteeringSection, buildTableSection, listMarkdownFiles, } from './root-guidance.js';
+import { copyFlatComponents, TargetInstallSession, } from './target-installer.js';
+export async function installClaudeCodeTarget(request) {
+    const session = new TargetInstallSession('claude-code', request.projectRoot, request.writer ?? new PreservingWriter(request.projectRoot));
+    const selected = new Set(request.components);
+    if (selected.has('skills')) {
+        await session.copySkills(request.sources.skillManager, request.paths.skills);
+    }
+    if (selected.has('steering')) {
+        await session.copySteering(request.sources.steeringSource, request.paths.steering);
+    }
+    if (selected.has('rules')) {
+        await copyFlatComponents(session, 'rules', request.paths.rules, await request.sources.rulesManager.listComponents());
+    }
+    if (selected.has('contexts')) {
+        await copyFlatComponents(session, 'contexts', request.paths.contexts, await request.sources.contextManager.listComponents());
+    }
+    if (selected.has('agents')) {
+        const destinationRoot = session.resolve(request.paths.agents);
+        for (const descriptor of await request.sources.agentManager.listComponents()) {
+            const destination = path.join(destinationRoot, `${descriptor.name}.md`);
+            try {
+                validateChildName(descriptor.name);
+                const source = await fs.promises.readFile(descriptor.path, 'utf8');
+                const rendered = renderClaudeCodeAgent(parseSourceAgent(source));
+                await session.write('agents', descriptor.name, destination, rendered);
+            }
+            catch (error) {
+                session.fail('agents', descriptor.name, destination, error);
+            }
+        }
+    }
+    if (selected.has('hooks')) {
+        const destinationRoot = session.resolve(request.paths.hooks);
+        for (const hook of await request.sources.hookLoader.listComponents()) {
+            const fileName = path.basename(hook.path);
+            const destination = path.join(destinationRoot, hook.event, fileName);
+            try {
+                validateChildName(hook.event);
+                validateChildName(fileName);
+                await session.copy('hooks', hook.name, hook.path, destination);
+            }
+            catch (error) {
+                session.fail('hooks', hook.name, destination, error);
+            }
+        }
+    }
+    let rootPreamble;
+    try {
+        rootPreamble = request.rootGuidanceContent ?? await loadClaudeTemplate();
+    }
+    catch (error) {
+        session.fail('root', request.paths.rootGuidance, session.resolve(request.paths.rootGuidance), error);
+        return session.report;
+    }
+    const rootContent = await buildClaudeRootGuidance(request, selected, rootPreamble);
+    await session.write('root', request.paths.rootGuidance, session.resolve(request.paths.rootGuidance), rootContent);
+    return session.report;
+}
+async function buildClaudeRootGuidance(request, selected, preamble) {
+    const [skills, rules, contexts, agents, steeringDocs] = await Promise.all([
+        selected.has('skills') ? request.sources.skillManager.listSkills() : Promise.resolve([]),
+        selected.has('rules') ? request.sources.rulesManager.listComponents() : Promise.resolve([]),
+        selected.has('contexts') ? request.sources.contextManager.listComponents() : Promise.resolve([]),
+        selected.has('agents') ? request.sources.agentManager.listComponents() : Promise.resolve([]),
+        selected.has('steering') ? listMarkdownFiles(request.sources.steeringSource) : Promise.resolve([]),
+    ]);
+    const sections = [
+        buildTableSection('Skills', 'On-demand guidance invoked via slash commands:', request.paths.skills, skills, skill => `${request.paths.skills}/${skill.name}/`),
+        buildTableSection('Rules', 'Always-active coding standards:', request.paths.rules, rules, rule => `${request.paths.rules}/${path.basename(rule.path)}`),
+        buildTableSection('Contexts', 'Switchable modes:', request.paths.contexts, contexts, context => `${request.paths.contexts}/${path.basename(context.path)}`),
+        buildTableSection('Agents', 'Specialized roles with model routing:', request.paths.agents, agents, agent => `${request.paths.agents}/${path.basename(agent.path, path.extname(agent.path))}.md`),
+        buildSteeringSection(request.paths.steering, steeringDocs),
+        selected.has('hooks') ? buildGuidanceSection('Hooks', request.paths.hooks) : '',
+    ].join('');
+    const marker = '\n## MCP Tools';
+    const markerIndex = preamble.indexOf(marker);
+    if (markerIndex < 0)
+        return `${preamble}${sections}`;
+    return `${preamble.slice(0, markerIndex)}\n${sections}${preamble.slice(markerIndex)}`;
+}
+async function loadClaudeTemplate() {
+    const template = findTemplate('CLAUDE.md');
+    if (!template)
+        return '# CLAUDE.md — Spec-Driven Development (SDD)\n';
+    return fs.promises.readFile(template, 'utf8');
+}
+//# sourceMappingURL=claude-code.js.map

package/dist/cli/tool-support/claude-code.js.map

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

package/dist/cli/tool-support/codex.d.ts

@@ -1,6 +1,7 @@
 import { SkillManager } from '../../skills/SkillManager.js';
 import { RulesManager } from '../../rules/RulesManager.js';
 import { AgentManager } from '../../agents/AgentManager.js';
+import { type BaseTargetInstallRequest } from './target-installer.js';
 /**
  * References to manager instances needed for generating AGENTS.md
  */
@@ -19,6 +20,9 @@ export interface InstallPaths {
     rulesPath: string;
     agentsPath: string;
     steeringPath: string;
+    contextsPath?: string;
+    hooksPath?: string;
+    agentExtension?: '.md' | '.toml';
 }
 /**
  * Which component types were actually installed in this run.
@@ -29,6 +33,13 @@ export interface InstalledComponents {
     rules: boolean;
     agents: boolean;
     steering: boolean;
+    contexts?: boolean;
+    hooks?: boolean;
+}
+export interface CodexGuidanceFailure {
+    name: string;
+    path: string;
+    error: string;
 }
 /**
  * Generate AGENTS.md in the project root for OpenAI Codex CLI.
@@ -40,4 +51,10 @@ export interface InstalledComponents {
  * Only sections for actually-installed component types are included,
  * and paths reflect the effective install targets (not hardcoded defaults).
  */
-export declare function generateCodexAgentsMd(projectRoot: string, managers: ManagerRefs, paths: InstallPaths, installed: InstalledComponents): Promise<void>;
+export declare function generateCodexAgentsMd(projectRoot: string, managers: ManagerRefs, paths: InstallPaths, installed: InstalledComponents): Promise<CodexGuidanceFailure[]>;
+export interface CodexInstallRequest extends BaseTargetInstallRequest {
+    rootGuidancePreamble?: string;
+    hookRunnerContent?: string;
+}
+export declare function installCodexTarget(request: CodexInstallRequest): Promise<import("../install-target.js").TargetInstallReport>;
+export declare function renderCodexHooksConfig(hooksPath: string, projectRoot?: string): string;

package/dist/cli/tool-support/codex.js

@@ -1,37 +1,12 @@
 import * as fs from 'fs';
 import * as path from 'path';
 import { findTemplate } from '../utils/find-package-root.js';
-/**
- * Build a markdown table section for a component type.
- * Returns the section string, or empty string if items is empty.
- */
-function buildTableSection(title, subtitle, basePath, items, pathFormatter) {
-    if (items.length === 0)
-        return '';
-    let section = `### ${title} (\`${basePath}/\`)\n\n`;
-    section += `${subtitle}\n\n`;
-    section += `| ${title.slice(0, -1)} | Description | Path |\n`;
-    section += '|-------|-------------|------|\n';
-    for (const item of items) {
-        section += `| ${item.name} | ${item.description || '—'} | \`${pathFormatter(item)}\` |\n`;
-    }
-    section += '\n';
-    return section;
-}
-/**
- * Build a markdown bullet list section for steering docs.
- */
-function buildSteeringSection(basePath, docs) {
-    if (docs.length === 0)
-        return '';
-    let section = `### Steering (\`${basePath}/\`)\n\n`;
-    section += 'Project-specific context documents:\n\n';
-    for (const doc of docs) {
-        section += `- \`${basePath}/${doc}\`\n`;
-    }
-    section += '\n';
-    return section;
-}
+import { PreservingWriter, validateChildName } from '../utils/preserving-writer.js';
+import { parseSourceAgent, renderCodexAgent } from './target-agent-renderer.js';
+import { buildGuidanceSection, buildSteeringSection, buildTableSection, listMarkdownFiles, } from './root-guidance.js';
+import { copyFlatComponents, TargetInstallSession, } from './target-installer.js';
+const CODEX_HOOK_RUNNER_FILE = 'sdd-hook-runner.mjs';
+const GIT_ROOT_EXPRESSION = '$(git rev-parse --show-toplevel)';
 /**
  * Load the template preamble for AGENTS.md
  */
@@ -60,9 +35,24 @@ function loadPreamble() {
  */
 export async function generateCodexAgentsMd(projectRoot, managers, paths, installed) {
     const targetPath = path.join(projectRoot, 'AGENTS.md');
+    const failures = [];
     if (fs.existsSync(targetPath)) {
+        try {
+            if (fs.statSync(targetPath).isDirectory()) {
+                const error = 'AGENTS.md destination is a directory';
+                failures.push({ name: 'AGENTS.md', path: targetPath, error });
+                console.error('  ❌ Failed to create AGENTS.md:', error);
+                return failures;
+            }
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            failures.push({ name: 'AGENTS.md', path: targetPath, error: message });
+            console.error('  ❌ Failed to inspect AGENTS.md:', message);
+            return failures;
+        }
         console.log('  ⏭️  AGENTS.md already exists, skipping');
-        return;
+        return failures;
     }
     let content = loadPreamble();
     try {
@@ -74,18 +64,153 @@ export async function generateCodexAgentsMd(projectRoot, managers, paths, instal
         ]);
         content += buildTableSection('Skills', 'Workflow guidance invoked via slash commands:', paths.skillsPath, skills, (s) => `${paths.skillsPath}/${s.name}/`);
         content += buildTableSection('Rules', 'Always-active coding standards:', paths.rulesPath, rules, (r) => `${paths.rulesPath}/${path.basename(r.path)}`);
-        content += buildTableSection('Agents', 'Specialized AI personas:', paths.agentsPath, agents, (a) => `${paths.agentsPath}/${path.basename(a.path)}`);
+        content += buildTableSection('Agents', 'Specialized AI personas:', paths.agentsPath, agents, (a) => `${paths.agentsPath}/${path.basename(a.path, path.extname(a.path))}${paths.agentExtension ?? path.extname(a.path)}`);
         content += buildSteeringSection(paths.steeringPath, steeringDocs);
+        if (installed.contexts)
+            content += buildGuidanceSection('Contexts', paths.contextsPath);
+        if (installed.hooks)
+            content += buildGuidanceSection('Hooks', paths.hooksPath);
     }
     catch (error) {
-        console.error('  ⚠️  Failed to gather component metadata:', error.message);
+        const message = error instanceof Error ? error.message : String(error);
+        console.error('  ⚠️  Failed to gather component metadata:', message);
+        failures.push({ name: 'metadata', path: targetPath, error: message });
     }
     try {
-        fs.writeFileSync(targetPath, content, 'utf-8');
+        fs.writeFileSync(targetPath, content, { encoding: 'utf-8', flag: 'wx' });
         console.log('  ✅ Created AGENTS.md for Codex CLI');
     }
     catch (error) {
-        console.error('  ❌ Failed to create AGENTS.md:', error.message);
+        if (isAlreadyExists(error)) {
+            console.log('  ⏭️  AGENTS.md already exists, skipping');
+            return failures;
+        }
+        const message = error instanceof Error ? error.message : String(error);
+        failures.push({ name: 'AGENTS.md', path: targetPath, error: message });
+        console.error('  ❌ Failed to create AGENTS.md:', message);
+    }
+    return failures;
+}
+export async function installCodexTarget(request) {
+    const session = new TargetInstallSession('codex', request.projectRoot, request.writer ?? new PreservingWriter(request.projectRoot));
+    const selected = new Set(request.components);
+    if (selected.has('skills')) {
+        await session.copySkills(request.sources.skillManager, request.paths.skills);
+    }
+    if (selected.has('steering')) {
+        await session.copySteering(request.sources.steeringSource, request.paths.steering);
+    }
+    if (selected.has('rules')) {
+        await copyFlatComponents(session, 'rules', request.paths.rules, await request.sources.rulesManager.listComponents());
+    }
+    if (selected.has('contexts')) {
+        await copyFlatComponents(session, 'contexts', request.paths.contexts, await request.sources.contextManager.listComponents());
+    }
+    if (selected.has('agents')) {
+        const destinationRoot = session.resolve(request.paths.agents);
+        for (const descriptor of await request.sources.agentManager.listComponents()) {
+            const destination = path.join(destinationRoot, `${descriptor.name}.toml`);
+            try {
+                validateChildName(descriptor.name);
+                const source = await fs.promises.readFile(descriptor.path, 'utf8');
+                const rendered = renderCodexAgent(parseSourceAgent(source));
+                await session.write('agents', descriptor.name, destination, rendered);
+            }
+            catch (error) {
+                session.fail('agents', descriptor.name, destination, error);
+            }
+        }
+    }
+    if (selected.has('hooks')) {
+        const runnerDestination = session.resolve(path.join(request.paths.hooks, CODEX_HOOK_RUNNER_FILE));
+        const configDestination = session.resolve(path.join(path.dirname(request.paths.hooks), 'hooks.json'));
+        let runnerContent = request.hookRunnerContent ?? null;
+        let templateLoadFailed = false;
+        if (request.hookRunnerContent === undefined) {
+            try {
+                runnerContent = await loadHookRunnerTemplate();
+            }
+            catch (error) {
+                templateLoadFailed = true;
+                session.fail('hooks', CODEX_HOOK_RUNNER_FILE, runnerDestination, error);
+            }
+        }
+        if (runnerContent === null && !templateLoadFailed) {
+            session.fail('hooks', CODEX_HOOK_RUNNER_FILE, runnerDestination, new Error('Codex hook runner template not found'));
+        }
+        else if (runnerContent !== null) {
+            await session.write('hooks', CODEX_HOOK_RUNNER_FILE, runnerDestination, runnerContent);
+            await session.write('hooks', 'hooks.json', configDestination, renderCodexHooksConfig(request.paths.hooks, request.projectRoot));
+        }
     }
+    const rootContent = await buildCodexRootGuidance(request, selected, request.rootGuidancePreamble ?? loadPreamble());
+    await session.write('root', request.paths.rootGuidance, session.resolve(request.paths.rootGuidance), rootContent);
+    return session.report;
+}
+async function buildCodexRootGuidance(request, selected, preamble) {
+    const [skills, rules, agents, steeringDocs] = await Promise.all([
+        selected.has('skills') ? request.sources.skillManager.listSkills() : Promise.resolve([]),
+        selected.has('rules') ? request.sources.rulesManager.listComponents() : Promise.resolve([]),
+        selected.has('agents') ? request.sources.agentManager.listComponents() : Promise.resolve([]),
+        selected.has('steering') ? listMarkdownFiles(request.sources.steeringSource) : Promise.resolve([]),
+    ]);
+    let content = preamble;
+    content += buildTableSection('Skills', 'Workflow guidance invoked as skills:', request.paths.skills, skills, skill => `${request.paths.skills}/${skill.name}/`);
+    content += buildTableSection('Rules', 'Always-active project guidance:', request.paths.rules, rules, rule => `${request.paths.rules}/${path.basename(rule.path)}`);
+    content += buildTableSection('Agents', 'Specialized AI personas with role-specific model routing:', request.paths.agents, agents, agent => `${request.paths.agents}/${path.basename(agent.path, path.extname(agent.path))}.toml`);
+    content += buildSteeringSection(request.paths.steering, steeringDocs);
+    if (selected.has('contexts'))
+        content += buildGuidanceSection('Contexts', request.paths.contexts);
+    if (selected.has('hooks'))
+        content += buildGuidanceSection('Hooks', request.paths.hooks);
+    return content;
+}
+export function renderCodexHooksConfig(hooksPath, projectRoot = process.cwd()) {
+    const runner = resolveHookRunnerCommandPath(hooksPath, projectRoot);
+    const command = (event) => `node ${runner} ${event}`;
+    return `${JSON.stringify({
+        hooks: {
+            SessionStart: [{
+                    matcher: 'startup|resume',
+                    hooks: [{ type: 'command', command: command('session-start') }],
+                }],
+            Stop: [{
+                    hooks: [{ type: 'command', command: command('stop') }],
+                }],
+        },
+    }, null, 2)}\n`;
+}
+function resolveHookRunnerCommandPath(hooksPath, projectRoot) {
+    const absoluteProjectRoot = path.resolve(projectRoot);
+    const absoluteRunner = path.resolve(absoluteProjectRoot, hooksPath, CODEX_HOOK_RUNNER_FILE);
+    const relativeRunner = path.relative(absoluteProjectRoot, absoluteRunner).split(path.sep).join('/');
+    if (path.isAbsolute(hooksPath)
+        || relativeRunner === ''
+        || relativeRunner === '..'
+        || relativeRunner.startsWith('../')) {
+        return shellQuote(absoluteRunner);
+    }
+    return `"${GIT_ROOT_EXPRESSION}/${shellDoubleQuote(relativeRunner)}"`;
+}
+function shellDoubleQuote(value) {
+    if (value.includes('\n') || value.includes('\r') || value.includes('\0')) {
+        throw new Error('Hook path contains an unsupported control character');
+    }
+    return value.replace(/(["\\$`])/g, '\\$1');
+}
+function shellQuote(value) {
+    if (value.includes('\n') || value.includes('\r') || value.includes('\0')) {
+        throw new Error('Hook path contains an unsupported control character');
+    }
+    return `'${value.replaceAll("'", "'\\''")}'`;
+}
+async function loadHookRunnerTemplate() {
+    const template = findTemplate('codex-hook-runner.js');
+    if (!template)
+        return null;
+    return fs.promises.readFile(template, 'utf8');
+}
+function isAlreadyExists(error) {
+    return typeof error === 'object' && error !== null && 'code' in error && error.code === 'EEXIST';
 }
 //# sourceMappingURL=codex.js.map

package/dist/cli/tool-support/codex.js.map

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

package/dist/cli/tool-support/index.d.ts

@@ -1,4 +1,4 @@
 export { generateCodexAgentsMd } from './codex.js';
-export type { ManagerRefs, InstallPaths, InstalledComponents } from './codex.js';
+export type { ManagerRefs, InstallPaths, InstalledComponents, CodexGuidanceFailure } from './codex.js';
 export { createAntigravitySymlinks } from './antigravity.js';
-export type { AntigravityPaths } from './antigravity.js';
+export type { AntigravityPaths, AntigravityFailure } from './antigravity.js';

package/dist/cli/tool-support/root-guidance.d.ts

@@ -0,0 +1,9 @@
+export interface GuidanceItem {
+    name: string;
+    description: string;
+    path: string;
+}
+export declare function buildTableSection(title: string, subtitle: string, basePath: string, items: GuidanceItem[], pathFormatter: (item: GuidanceItem) => string): string;
+export declare function buildSteeringSection(basePath: string, docs: string[]): string;
+export declare function buildGuidanceSection(title: string, basePath: string | undefined): string;
+export declare function listMarkdownFiles(directory: string): Promise<string[]>;

package/dist/cli/tool-support/root-guidance.js

@@ -0,0 +1,40 @@
+import * as fs from 'fs';
+export function buildTableSection(title, subtitle, basePath, items, pathFormatter) {
+    if (items.length === 0)
+        return '';
+    let section = `### ${title} (\`${basePath}/\`)\n\n`;
+    section += `${subtitle}\n\n`;
+    section += `| ${title.slice(0, -1)} | Description | Path |\n`;
+    section += '|-------|-------------|------|\n';
+    for (const item of items) {
+        section += `| ${item.name} | ${item.description || '—'} | \`${pathFormatter(item)}\` |\n`;
+    }
+    section += '\n';
+    return section;
+}
+export function buildSteeringSection(basePath, docs) {
+    if (docs.length === 0)
+        return '';
+    let section = `### Steering (\`${basePath}/\`)\n\n`;
+    section += 'Project-specific context documents:\n\n';
+    for (const doc of docs) {
+        section += `- \`${basePath}/${doc}\`\n`;
+    }
+    section += '\n';
+    return section;
+}
+export function buildGuidanceSection(title, basePath) {
+    if (!basePath)
+        return '';
+    return `### ${title} (\`${basePath}/\`)\n\nRead the relevant guidance files from this directory on demand.\n\n`;
+}
+export async function listMarkdownFiles(directory) {
+    try {
+        const entries = await fs.promises.readdir(directory);
+        return entries.filter(file => file.endsWith('.md'));
+    }
+    catch {
+        return [];
+    }
+}
+//# sourceMappingURL=root-guidance.js.map

package/dist/cli/tool-support/root-guidance.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"root-guidance.js","sourceRoot":"","sources":["../../../src/cli/tool-support/root-guidance.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,IAAI,CAAC;AAQzB,MAAM,UAAU,iBAAiB,CAC/B,KAAa,EACb,QAAgB,EAChB,QAAgB,EAChB,KAAqB,EACrB,aAA6C;IAE7C,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IAElC,IAAI,OAAO,GAAG,OAAO,KAAK,OAAO,QAAQ,UAAU,CAAC;IACpD,OAAO,IAAI,GAAG,QAAQ,MAAM,CAAC;IAC7B,OAAO,IAAI,KAAK,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,2BAA2B,CAAC;IAC9D,OAAO,IAAI,kCAAkC,CAAC;IAC9C,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,OAAO,IAAI,KAAK,IAAI,CAAC,IAAI,MAAM,IAAI,CAAC,WAAW,IAAI,GAAG,QAAQ,aAAa,CAAC,IAAI,CAAC,QAAQ,CAAC;IAC5F,CAAC;IACD,OAAO,IAAI,IAAI,CAAC;IAChB,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,QAAgB,EAAE,IAAc;IACnE,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IAEjC,IAAI,OAAO,GAAG,mBAAmB,QAAQ,UAAU,CAAC;IACpD,OAAO,IAAI,yCAAyC,CAAC;IACrD,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;QACvB,OAAO,IAAI,OAAO,QAAQ,IAAI,GAAG,MAAM,CAAC;IAC1C,CAAC;IACD,OAAO,IAAI,IAAI,CAAC;IAChB,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,KAAa,EAAE,QAA4B;IAC9E,IAAI,CAAC,QAAQ;QAAE,OAAO,EAAE,CAAC;IACzB,OAAO,OAAO,KAAK,OAAO,QAAQ,6EAA6E,CAAC;AAClH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,iBAAiB,CAAC,SAAiB;IACvD,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;QACrD,OAAO,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC;IACtD,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC;IACZ,CAAC;AACH,CAAC"}

package/dist/cli/tool-support/target-agent-renderer.d.ts

@@ -0,0 +1,11 @@
+import { type AgentRole } from '../install-target.js';
+export interface SourceAgent {
+    name: string;
+    description: string;
+    role: AgentRole;
+    expertise: string;
+    instructions: string;
+}
+export declare function parseSourceAgent(content: string): SourceAgent;
+export declare function renderClaudeCodeAgent(agent: SourceAgent): string;
+export declare function renderCodexAgent(agent: SourceAgent): string;

package/dist/cli/tool-support/target-agent-renderer.js

@@ -0,0 +1,52 @@
+import { ROLE_MODEL_ROUTES, } from '../install-target.js';
+export function parseSourceAgent(content) {
+    const match = content.match(/^---\r?\n([\s\S]*?)\r?\n---\r?\n?([\s\S]*)$/);
+    if (!match)
+        throw new Error('Agent source requires YAML frontmatter');
+    const metadata = new Map();
+    for (const line of match[1].split(/\r?\n/)) {
+        const separator = line.indexOf(':');
+        if (separator <= 0)
+            continue;
+        metadata.set(line.slice(0, separator).trim(), stripQuotes(line.slice(separator + 1).trim()));
+    }
+    const role = metadata.get('role');
+    if (!role || !(role in ROLE_MODEL_ROUTES))
+        throw new Error(`Unsupported agent role: ${role ?? '(missing)'}`);
+    return {
+        name: required(metadata, 'name'),
+        description: required(metadata, 'description'),
+        role: role,
+        expertise: metadata.get('expertise') ?? '',
+        instructions: match[2].trim(),
+    };
+}
+export function renderClaudeCodeAgent(agent) {
+    const model = ROLE_MODEL_ROUTES[agent.role].claudeCode.model;
+    return `---\nname: ${agent.name}\ndescription: ${agent.description}\nrole: ${agent.role}\nexpertise: ${agent.expertise}\nmodel: ${model}\n---\n\n${agent.instructions}\n`;
+}
+export function renderCodexAgent(agent) {
+    const route = ROLE_MODEL_ROUTES[agent.role].codex;
+    return [
+        `name = ${JSON.stringify(agent.name)}`,
+        `description = ${JSON.stringify(agent.description)}`,
+        `model = ${JSON.stringify(route.model)}`,
+        `model_reasoning_effort = ${JSON.stringify(route.reasoningEffort)}`,
+        `developer_instructions = ${JSON.stringify(agent.instructions)}`,
+        '',
+    ].join('\n');
+}
+function required(metadata, key) {
+    const value = metadata.get(key);
+    if (!value)
+        throw new Error(`Agent source requires ${key}`);
+    return value;
+}
+function stripQuotes(value) {
+    if (value.length >= 2 && ((value.startsWith('"') && value.endsWith('"')) ||
+        (value.startsWith("'") && value.endsWith("'")))) {
+        return value.slice(1, -1);
+    }
+    return value;
+}
+//# sourceMappingURL=target-agent-renderer.js.map

package/dist/cli/tool-support/target-agent-renderer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"target-agent-renderer.js","sourceRoot":"","sources":["../../../src/cli/tool-support/target-agent-renderer.ts"],"names":[],"mappings":"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"}

package/dist/cli/tool-support/target-installer.d.ts

@@ -0,0 +1,40 @@
+import type { SkillManager } from '../../skills/SkillManager.js';
+import type { RulesManager } from '../../rules/RulesManager.js';
+import type { ContextManager } from '../../contexts/ContextManager.js';
+import type { AgentManager } from '../../agents/AgentManager.js';
+import type { HookLoader } from '../../hooks/HookLoader.js';
+import type { ComponentType, InstallTarget, ResolvedInstallPaths, TargetInstallReport } from '../install-target.js';
+import { PreservingWriter } from '../utils/preserving-writer.js';
+export interface TargetSources {
+    skillManager: SkillManager;
+    rulesManager: RulesManager;
+    contextManager: ContextManager;
+    agentManager: AgentManager;
+    hookLoader: HookLoader;
+    steeringSource: string;
+}
+export interface BaseTargetInstallRequest {
+    projectRoot: string;
+    paths: ResolvedInstallPaths;
+    components: readonly ComponentType[];
+    sources: TargetSources;
+    writer?: PreservingWriter;
+}
+export declare class TargetInstallSession {
+    readonly target: InstallTarget;
+    readonly projectRoot: string;
+    readonly writer: PreservingWriter;
+    readonly report: TargetInstallReport;
+    constructor(target: InstallTarget, projectRoot: string, writer: PreservingWriter);
+    resolve(configuredPath: string): string;
+    label(destination: string): string;
+    write(component: ComponentType | 'root', name: string, destination: string, content: string): Promise<void>;
+    copy(component: ComponentType | 'root', name: string, source: string, destination: string): Promise<void>;
+    copySkills(sourceManager: SkillManager, configuredPath: string): Promise<void>;
+    copySteering(source: string, configuredPath: string): Promise<void>;
+    fail(component: ComponentType | 'root', name: string, destination: string, error: unknown): void;
+}
+export declare function copyFlatComponents(session: TargetInstallSession, component: 'rules' | 'contexts', configuredPath: string, descriptors: Array<{
+    name: string;
+    path: string;
+}>): Promise<void>;