@shendu-sdt/sdt-dev-agent 0.1.2 → 0.1.3-beta.10

package/dist/core/init-plan.js

@@ -1,16 +1,107 @@
-import { readFileSync } from 'node:fs';
+import { readdirSync, readFileSync, statSync } from 'node:fs';
 import path from 'node:path';
 import { fileURLToPath } from 'node:url';
+import { REQUIRED_SKILL_ID, getWorkflowCatalogEntry, getMcpCatalogEntry, getSkillCatalogEntry, } from '../catalog.js';
+import { buildClaudeMcpConfig, buildCodexMcpConfig } from './mcp-config.js';
 import { renderTemplate } from '../utils/render-template.js';
 const currentDir = path.dirname(fileURLToPath(import.meta.url));
 const projectRoot = path.resolve(currentDir, '..', '..');
+/** 从仓库内模板目录读取原始模板内容。 */
 function loadTemplate(relativePath) {
     return readFileSync(path.join(projectRoot, 'templates', relativePath), 'utf8');
 }
-function toolDir(tool) {
-    return tool === 'codex' ? '.codex' : '.claude';
+/** 递归收集某个模板目录下的所有文件，用于整目录复制型模板展开。 */
+function walkTemplateFiles(relativeDir) {
+    const absoluteDir = path.join(projectRoot, 'templates', relativeDir);
+    const entries = readdirSync(absoluteDir);
+    const files = [];
+    for (const entry of entries) {
+        const absoluteEntry = path.join(absoluteDir, entry);
+        const relativeEntry = path.join(relativeDir, entry);
+        if (statSync(absoluteEntry).isDirectory()) {
+            files.push(...walkTemplateFiles(relativeEntry));
+            continue;
+        }
+        files.push(relativeEntry);
+    }
+    return files;
+}
+/** 各工具项目级 skill 根目录的事实源。 */
+export function getProjectSkillRoot(tool) {
+    return tool === 'codex' ? path.join('.agents', 'skills') : path.join('.claude', 'skills');
+}
+/** 返回某个远端 skill 在指定工具下的主目标路径。 */
+export function getRemoteSkillTargetPath(tool, skillId) {
+    const skill = getSkillCatalogEntry(skillId);
+    const firstTarget = skill.remote?.installTargets?.[0]?.targetDirName;
+    return path.join(getProjectSkillRoot(tool), firstTarget ?? skillId);
+}
+/**
+ * 远端 skill 可能会安装成多个目录。
+ * 这里统一展开为“传给安装器的 skillName + 项目内目标路径”集合。
+ */
+export function getRemoteSkillInstallTargets(tool, skillId) {
+    const skill = getSkillCatalogEntry(skillId);
+    const configuredTargets = skill.remote?.installTargets;
+    if (!configuredTargets || configuredTargets.length === 0) {
+        return [
+            {
+                skillName: skillId,
+                targetPath: getRemoteSkillTargetPath(tool, skillId),
+            },
+        ];
+    }
+    return configuredTargets.map((target) => ({
+        skillName: target.skillName,
+        targetPath: path.join(getProjectSkillRoot(tool), target.targetDirName),
+    }));
+}
+/** 仅负责把命令模板里的 `<tool>` 替换成真实 tool 标识。 */
+export function buildRemoteSkillInstallCommand(_skillId, tool, installCommandTemplate) {
+    return installCommandTemplate.replace('<tool>', tool);
 }
-function baseTemplateValues(facts, selections) {
+/** `OpenSpec` CLI 与本仓库 `ToolId` 的工具名有一层映射。 */
+function mapOpenSpecToolId(tool) {
+    return tool === 'claude-code' ? 'claude' : 'codex';
+}
+/**
+ * workflow 的“已安装”判定依赖一组关键路径同时存在。
+ * 这里集中维护各工具下的目标路径矩阵。
+ */
+export function getWorkflowTargetPaths(tool, workflowId) {
+    if (workflowId !== 'openspec') {
+        throw new Error(`Unknown workflow target mapping: ${workflowId}`);
+    }
+    if (tool === 'codex') {
+        return [
+            path.join('.codex', 'skills', 'openspec-apply-change', 'SKILL.md'),
+            path.join('.codex', 'skills', 'openspec-archive-change', 'SKILL.md'),
+            path.join('.codex', 'skills', 'openspec-explore', 'SKILL.md'),
+            path.join('.codex', 'skills', 'openspec-propose', 'SKILL.md'),
+        ];
+    }
+    return [
+        path.join('.claude', 'skills', 'openspec-apply-change', 'SKILL.md'),
+        path.join('.claude', 'skills', 'openspec-archive-change', 'SKILL.md'),
+        path.join('.claude', 'skills', 'openspec-explore', 'SKILL.md'),
+        path.join('.claude', 'skills', 'openspec-propose', 'SKILL.md'),
+        path.join('.claude', 'commands', 'opsx', 'apply.md'),
+        path.join('.claude', 'commands', 'opsx', 'archive.md'),
+        path.join('.claude', 'commands', 'opsx', 'explore.md'),
+        path.join('.claude', 'commands', 'opsx', 'propose.md'),
+    ];
+}
+/** 生成对外展示和失败提示用的 workflow 安装命令。 */
+export function buildWorkflowInstallCommand(workflowId, tool) {
+    const workflow = getWorkflowCatalogEntry(workflowId);
+    return workflow.installCommand.replace('<tool>', mapOpenSpecToolId(tool));
+}
+/** 当前工具对应的项目级 MCP 配置文件路径。 */
+export function getProjectMcpConfigPath(tool) {
+    return tool === 'codex' ? path.join('.codex', 'config.toml') : '.mcp.json';
+}
+/** 所有模板都会共享的基础插值变量。 */
+function baseTemplateValues(facts, selections, tool) {
     return {
         projectName: facts.projectName,
         packageManager: facts.packageManager,
@@ -18,54 +109,131 @@ function baseTemplateValues(facts, selections) {
         testRoot: facts.testRoot,
         selectedTools: selections.tools.join(', '),
         installMode: selections.installMode,
-        capabilities: selections.capabilities.join(', '),
+        selectedSkills: selections.skills.join(', ') || '(none)',
+        selectedMcps: selections.mcps.join(', ') || '(none)',
+        toolId: tool ?? '',
+        toolRulesDoc: tool === 'codex' ? 'AGENTS.md' : tool === 'claude-code' ? 'CLAUDE.md' : '',
     };
 }
-function addBaseAssets(files, facts, selections) {
-    const values = baseTemplateValues(facts, selections);
+/** 生成目标项目的 bootstrap 入口文档。 */
+function addProjectEntry(files, facts, selections) {
     files.push({
-        path: 'AGENTS.md',
-        content: renderTemplate(loadTemplate('AGENTS.md'), values),
-        kind: 'project-asset',
-    }, {
-        path: 'ARCHITECTURE.md',
-        content: renderTemplate(loadTemplate('ARCHITECTURE.md'), values),
-        kind: 'project-asset',
-    }, {
-        path: path.join('docs', 'ai-collaboration', 'README.md'),
-        content: renderTemplate(loadTemplate(path.join('docs', 'ai-collaboration', 'README.md')), values),
-        kind: 'project-asset',
+        path: path.join('.sdt-devagent', 'bootstrap-project-docs.md'),
+        content: renderTemplate(loadTemplate(path.join('bootstrap', 'project-entry.md')), baseTemplateValues(facts, selections)),
+        kind: 'bootstrap',
     });
 }
-function addToolFiles(files, tools) {
-    for (const tool of tools) {
+/** 把内置 bootstrap skill 整目录展开到工具对应的项目级 skill 目录。 */
+function addBuiltinBootstrapSkill(files, facts, selections, tool) {
+    const entry = getSkillCatalogEntry(REQUIRED_SKILL_ID);
+    if (!entry.templateDir) {
+        throw new Error(`Bootstrap skill template directory is missing for ${REQUIRED_SKILL_ID}`);
+    }
+    const targetRoot = path.join(getProjectSkillRoot(tool), entry.id);
+    const templateFiles = walkTemplateFiles(entry.templateDir);
+    const values = baseTemplateValues(facts, selections, tool);
+    for (const templateFile of templateFiles) {
+        const relativeFile = path.relative(entry.templateDir, templateFile);
         files.push({
-            path: path.join(toolDir(tool), 'README.md'),
-            content: loadTemplate(path.join('tools', tool, 'README.md')),
-            kind: 'tool-integration',
+            path: path.join(targetRoot, relativeFile),
+            content: renderTemplate(loadTemplate(templateFile), values),
+            kind: 'bootstrap',
         });
     }
 }
-function addCapabilityFiles(files, tools, capabilities) {
-    for (const capability of capabilities) {
-        if (capability === 'base-assets') {
+/** 按工具生成项目级 MCP 配置文件。 */
+function addMcpConfig(files, tool, selectedMcps) {
+    if (selectedMcps.length === 0) {
+        return;
+    }
+    files.push({
+        path: getProjectMcpConfigPath(tool),
+        content: tool === 'codex' ? buildCodexMcpConfig(selectedMcps) : buildClaudeMcpConfig(selectedMcps),
+        kind: 'mcp',
+    });
+}
+/** 把需要额外走外部安装命令的远端 skill 收口成执行计划。 */
+function buildRemoteSkillInstalls(tools, skillIds) {
+    const installs = [];
+    for (const skillId of skillIds) {
+        const skill = getSkillCatalogEntry(skillId);
+        if (!skill.remote) {
             continue;
         }
         for (const tool of tools) {
-            files.push({
-                path: path.join(toolDir(tool), capability, 'README.md'),
-                content: loadTemplate(path.join('capabilities', capability, 'README.md')),
-                kind: 'tool-integration',
+            installs.push({
+                tool,
+                skillId,
+                targetPath: getRemoteSkillTargetPath(tool, skillId),
+                installTargets: getRemoteSkillInstallTargets(tool, skillId),
+                source: skill.remote.source,
+                installCommand: buildRemoteSkillInstallCommand(skillId, tool, skill.remote.installCommand),
             });
         }
     }
+    return installs;
 }
-function buildManifest(facts, selections, files) {
+/** 统一构造 manifest 中单个 tool 维度的安装记录。 */
+function createInstallRecord(tool, pathValue, source, installCommand) {
+    return {
+        tool,
+        status: 'installed',
+        path: pathValue,
+        source,
+        installCommand,
+    };
+}
+/** 构造 manifest 的 skill 段，包含必装 bootstrap skill。 */
+function buildSkillManifestEntries(tools, selectedSkillIds) {
+    const bootstrap = getSkillCatalogEntry(REQUIRED_SKILL_ID);
+    const records = [
+        {
+            id: REQUIRED_SKILL_ID,
+            selection: bootstrap.selection,
+            sourceType: bootstrap.sourceType,
+            installs: tools.map((tool) => createInstallRecord(tool, path.join(getProjectSkillRoot(tool), REQUIRED_SKILL_ID, 'SKILL.md'))),
+        },
+    ];
+    for (const skillId of selectedSkillIds) {
+        const skill = getSkillCatalogEntry(skillId);
+        records.push({
+            id: skillId,
+            selection: skill.selection,
+            sourceType: skill.sourceType,
+            installs: tools.map((tool) => createInstallRecord(tool, getRemoteSkillTargetPath(tool, skillId), skill.remote?.source, skill.remote
+                ? buildRemoteSkillInstallCommand(skillId, tool, skill.remote.installCommand)
+                : undefined)),
+        });
+    }
+    return records;
+}
+/** 构造 manifest 的 MCP 段。 */
+function buildMcpManifestEntries(tools, selectedMcps) {
+    return selectedMcps.map((mcpId) => {
+        const mcp = getMcpCatalogEntry(mcpId);
+        return {
+            id: mcpId,
+            selection: mcp.selection,
+            sourceType: mcp.sourceType,
+            installs: tools.map((tool) => createInstallRecord(tool, getProjectMcpConfigPath(tool))),
+        };
+    });
+}
+/** `init` 默认不安装 workflow，留给后续 `add workflow` 增量接入。 */
+function buildWorkflowManifestEntries(_tools) {
+    return [];
+}
+/** 基于计划文件和外部安装计划，生成最终要回写的 manifest 快照。 */
+function buildManifest(facts, selections, files, remoteSkillInstalls) {
     const generatedFiles = [
         ...files.map((file) => ({
             path: file.path,
             kind: file.kind,
         })),
+        ...remoteSkillInstalls.map((install) => ({
+            path: install.targetPath,
+            kind: 'bootstrap',
+        })),
         {
             path: path.join('.sdt-devagent', 'manifest.json'),
             kind: 'manifest',
@@ -76,7 +244,10 @@ function buildManifest(facts, selections, files) {
         generatedAt: new Date().toISOString(),
         installMode: selections.installMode,
         tools: selections.tools,
-        capabilities: selections.capabilities,
+        bootstrapSkillId: REQUIRED_SKILL_ID,
+        skills: buildSkillManifestEntries(selections.tools, selections.skills),
+        mcps: buildMcpManifestEntries(selections.tools, selections.mcps),
+        workflows: buildWorkflowManifestEntries(selections.tools),
         project: {
             path: facts.targetPath,
             name: facts.projectName,
@@ -87,14 +258,16 @@ function buildManifest(facts, selections, files) {
         generatedFiles,
     };
 }
+/** `init` 主链路的纯计划构建入口，不在这里做真实文件写入。 */
 export function createInitPlan(facts, selections) {
     const files = [];
-    if (selections.capabilities.includes('base-assets')) {
-        addBaseAssets(files, facts, selections);
+    addProjectEntry(files, facts, selections);
+    for (const tool of selections.tools) {
+        addBuiltinBootstrapSkill(files, facts, selections, tool);
+        addMcpConfig(files, tool, selections.mcps);
     }
-    addToolFiles(files, selections.tools);
-    addCapabilityFiles(files, selections.tools, selections.capabilities);
-    const manifest = buildManifest(facts, selections, files);
+    const remoteSkillInstalls = buildRemoteSkillInstalls(selections.tools, selections.skills);
+    const manifest = buildManifest(facts, selections, files, remoteSkillInstalls);
     files.push({
         path: path.join('.sdt-devagent', 'manifest.json'),
         content: `${JSON.stringify(manifest, null, 2)}\n`,
@@ -102,6 +275,7 @@ export function createInitPlan(facts, selections) {
     });
     return {
         files,
+        remoteSkillInstalls,
         manifest,
     };
 }

package/dist/core/init-plan.js.map

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

package/dist/core/init-writer.d.ts

@@ -1,6 +1,22 @@
 import type { InitPlan } from '../types.js';
+/** 应用安装计划后的写入摘要。 */
 export interface WriteResult {
     writtenFiles: string[];
+    failedRemoteSkills: Array<{
+        skillId: string;
+        tool: string;
+        installCommand: string;
+        error: string;
+    }>;
 }
-export declare function applyInitPlan(targetPath: string, plan: InitPlan): Promise<WriteResult>;
+/** 提供给命令层的进度回调，避免 `core` 直接耦合终端输出。 */
+export interface ApplyInitPlanHooks {
+    onRemoteSkillInstallStart?: (install: InitPlan['remoteSkillInstalls'][number], index: number, total: number) => void;
+    onRemoteSkillInstallFinish?: (install: InitPlan['remoteSkillInstalls'][number], result: 'installed' | 'already-present' | 'failed') => void;
+}
+/**
+ * 执行 `createInitPlan` 产出的计划。
+ * 这里负责真实写盘、MCP 合并、远端 skill 安装以及 manifest 最终回写。
+ */
+export declare function applyInitPlan(targetPath: string, plan: InitPlan, hooks?: ApplyInitPlanHooks): Promise<WriteResult>;
 //# sourceMappingURL=init-writer.d.ts.map

package/dist/core/init-writer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"init-writer.d.ts","sourceRoot":"","sources":["../../src/core/init-writer.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAA;AAE3C,MAAM,WAAW,WAAW;IAC1B,YAAY,EAAE,MAAM,EAAE,CAAA;CACvB;AAeD,wBAAsB,aAAa,CAAC,UAAU,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,GAAG,OAAO,CAAC,WAAW,CAAC,CAmB5F"}
+{"version":3,"file":"init-writer.d.ts","sourceRoot":"","sources":["../../src/core/init-writer.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAA;AAE3C,oBAAoB;AACpB,MAAM,WAAW,WAAW;IAC1B,YAAY,EAAE,MAAM,EAAE,CAAA;IACtB,kBAAkB,EAAE,KAAK,CAAC;QACxB,OAAO,EAAE,MAAM,CAAA;QACf,IAAI,EAAE,MAAM,CAAA;QACZ,cAAc,EAAE,MAAM,CAAA;QACtB,KAAK,EAAE,MAAM,CAAA;KACd,CAAC,CAAA;CACH;AAED,sCAAsC;AACtC,MAAM,WAAW,kBAAkB;IACjC,yBAAyB,CAAC,EAAE,CAC1B,OAAO,EAAE,QAAQ,CAAC,qBAAqB,CAAC,CAAC,MAAM,CAAC,EAChD,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,MAAM,KACV,IAAI,CAAA;IACT,0BAA0B,CAAC,EAAE,CAC3B,OAAO,EAAE,QAAQ,CAAC,qBAAqB,CAAC,CAAC,MAAM,CAAC,EAChD,MAAM,EAAE,WAAW,GAAG,iBAAiB,GAAG,QAAQ,KAC/C,IAAI,CAAA;CACV;AAED;;;GAGG;AACH,wBAAsB,aAAa,CACjC,UAAU,EAAE,MAAM,EAClB,IAAI,EAAE,QAAQ,EACd,KAAK,GAAE,kBAAuB,GAC7B,OAAO,CAAC,WAAW,CAAC,CAyFtB"}

package/dist/core/init-writer.js

@@ -1,28 +1,81 @@
 import path from 'node:path';
-import { exists, toPosixPath, writeText } from '../utils/fs.js';
-async function collectConflicts(targetPath, plan) {
-    const conflicts = [];
-    for (const file of plan.files) {
-        const absolutePath = path.join(targetPath, file.path);
-        if (await exists(absolutePath)) {
-            conflicts.push(file.path);
-        }
-    }
-    return conflicts;
-}
-export async function applyInitPlan(targetPath, plan) {
-    const conflicts = await collectConflicts(targetPath, plan);
-    if (conflicts.length > 0) {
-        throw new Error(`Initialization aborted. Existing files would be overwritten:\n${conflicts
-            .map((item) => `- ${item}`)
-            .join('\n')}`);
-    }
+import { detectSkillAvailability } from './capability-discovery.js';
+import { mergeMcpConfig, parseConfiguredMcpIds } from './mcp-config.js';
+import { installRemoteSkill } from './remote-skill-installer.js';
+import { exists, readText, toPosixPath, writeText } from '../utils/fs.js';
+/**
+ * 执行 `createInitPlan` 产出的计划。
+ * 这里负责真实写盘、MCP 合并、远端 skill 安装以及 manifest 最终回写。
+ */
+export async function applyInitPlan(targetPath, plan, hooks = {}) {
     const writtenFiles = [];
+    const failedRemoteSkills = [];
     for (const file of plan.files) {
+        if (file.kind === 'manifest') {
+            // manifest 需要在远端安装结果落定后再写一次，避免状态不一致。
+            continue;
+        }
         const absolutePath = path.join(targetPath, file.path);
+        if (file.kind === 'mcp' && (await exists(absolutePath))) {
+            const tool = file.path === '.mcp.json' ? 'claude-code' : 'codex';
+            const existingContent = await readText(absolutePath);
+            const selectedMcps = plan.manifest.mcps
+                .filter((mcp) => mcp.installs.some((install) => install.tool === tool && install.path === file.path))
+                .map((mcp) => mcp.id);
+            const existingServers = parseConfiguredMcpIds(tool, existingContent);
+            for (const mcp of plan.manifest.mcps) {
+                const installRecord = mcp.installs.find((install) => install.tool === tool && install.path === file.path);
+                if (installRecord && existingServers.has(mcp.id)) {
+                    installRecord.status = 'already-present';
+                    installRecord.reason = 'already-present';
+                }
+            }
+            const mergedContent = mergeMcpConfig(tool, existingContent, selectedMcps);
+            if (mergedContent !== existingContent) {
+                await writeText(absolutePath, mergedContent);
+                writtenFiles.push(toPosixPath(file.path));
+            }
+            continue;
+        }
         await writeText(absolutePath, file.content);
         writtenFiles.push(toPosixPath(file.path));
     }
-    return { writtenFiles };
+    for (const [index, install] of plan.remoteSkillInstalls.entries()) {
+        hooks.onRemoteSkillInstallStart?.(install, index + 1, plan.remoteSkillInstalls.length);
+        const availability = await detectSkillAvailability(targetPath, install.tool, install.skillId);
+        const skillRecord = plan.manifest.skills.find((skill) => skill.id === install.skillId);
+        const installRecord = skillRecord?.installs.find((item) => item.tool === install.tool);
+        if (!installRecord) {
+            continue;
+        }
+        if (availability.status === 'already-present') {
+            installRecord.status = availability.status;
+            installRecord.reason = availability.reason;
+            hooks.onRemoteSkillInstallFinish?.(install, 'already-present');
+            continue;
+        }
+        const result = await installRemoteSkill(targetPath, install);
+        if (!result.success) {
+            installRecord.status = 'failed';
+            installRecord.reason = 'install-failed';
+            hooks.onRemoteSkillInstallFinish?.(install, 'failed');
+            failedRemoteSkills.push({
+                skillId: install.skillId,
+                tool: install.tool,
+                installCommand: install.installCommand,
+                error: result.error ?? 'Unknown error',
+            });
+            continue;
+        }
+        writtenFiles.push(...result.targetPaths.map((targetPath) => toPosixPath(targetPath)));
+        hooks.onRemoteSkillInstallFinish?.(install, 'installed');
+    }
+    const manifestPath = path.join(targetPath, '.sdt-devagent', 'manifest.json');
+    await writeText(manifestPath, `${JSON.stringify(plan.manifest, null, 2)}\n`);
+    writtenFiles.push('.sdt-devagent/manifest.json');
+    return {
+        writtenFiles,
+        failedRemoteSkills,
+    };
 }
 //# sourceMappingURL=init-writer.js.map

package/dist/core/init-writer.js.map

@@ -1 +1 @@
-{"version":3,"file":"init-writer.js","sourceRoot":"","sources":["../../src/core/init-writer.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,WAAW,CAAA;AAE5B,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAA;AAO/D,KAAK,UAAU,gBAAgB,CAAC,UAAkB,EAAE,IAAc;IAChE,MAAM,SAAS,GAAa,EAAE,CAAA;IAE9B,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;QAC9B,MAAM,YAAY,GAAG,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,IAAI,CAAC,IAAI,CAAC,CAAA;QACrD,IAAI,MAAM,MAAM,CAAC,YAAY,CAAC,EAAE,CAAC;YAC/B,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;QAC3B,CAAC;IACH,CAAC;IAED,OAAO,SAAS,CAAA;AAClB,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,UAAkB,EAAE,IAAc;IACpE,MAAM,SAAS,GAAG,MAAM,gBAAgB,CAAC,UAAU,EAAE,IAAI,CAAC,CAAA;IAC1D,IAAI,SAAS,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACzB,MAAM,IAAI,KAAK,CACb,iEAAiE,SAAS;aACvE,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,KAAK,IAAI,EAAE,CAAC;aAC1B,IAAI,CAAC,IAAI,CAAC,EAAE,CAChB,CAAA;IACH,CAAC;IAED,MAAM,YAAY,GAAa,EAAE,CAAA;IAEjC,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;QAC9B,MAAM,YAAY,GAAG,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,IAAI,CAAC,IAAI,CAAC,CAAA;QACrD,MAAM,SAAS,CAAC,YAAY,EAAE,IAAI,CAAC,OAAO,CAAC,CAAA;QAC3C,YAAY,CAAC,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAA;IAC3C,CAAC;IAED,OAAO,EAAE,YAAY,EAAE,CAAA;AACzB,CAAC"}
+{"version":3,"file":"init-writer.js","sourceRoot":"","sources":["../../src/core/init-writer.ts"],"names":[],"mappings":"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"}

package/dist/core/manifest.d.ts

@@ -0,0 +1,8 @@
+import type { InstallManifest } from '../types.js';
+/** `.sdt-devagent/manifest.json` 的固定位置。 */
+export declare function getManifestPath(projectRoot: string): string;
+/** 读取并解析项目内 manifest。 */
+export declare function readInstallManifest(projectRoot: string): Promise<InstallManifest>;
+/** 用格式化 JSON 回写 manifest。 */
+export declare function writeInstallManifest(projectRoot: string, manifest: InstallManifest): Promise<void>;
+//# sourceMappingURL=manifest.d.ts.map

package/dist/core/manifest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"manifest.d.ts","sourceRoot":"","sources":["../../src/core/manifest.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAA;AAElD,2CAA2C;AAC3C,wBAAgB,eAAe,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAE3D;AAED,yBAAyB;AACzB,wBAAsB,mBAAmB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC,CAGvF;AAED,6BAA6B;AAC7B,wBAAsB,oBAAoB,CACxC,WAAW,EAAE,MAAM,EACnB,QAAQ,EAAE,eAAe,GACxB,OAAO,CAAC,IAAI,CAAC,CAEf"}

package/dist/core/manifest.js

@@ -0,0 +1,16 @@
+import path from 'node:path';
+import { readText, writeText } from '../utils/fs.js';
+/** `.sdt-devagent/manifest.json` 的固定位置。 */
+export function getManifestPath(projectRoot) {
+    return path.join(projectRoot, '.sdt-devagent', 'manifest.json');
+}
+/** 读取并解析项目内 manifest。 */
+export async function readInstallManifest(projectRoot) {
+    const raw = await readText(getManifestPath(projectRoot));
+    return JSON.parse(raw);
+}
+/** 用格式化 JSON 回写 manifest。 */
+export async function writeInstallManifest(projectRoot, manifest) {
+    await writeText(getManifestPath(projectRoot), `${JSON.stringify(manifest, null, 2)}\n`);
+}
+//# sourceMappingURL=manifest.js.map

package/dist/core/manifest.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"manifest.js","sourceRoot":"","sources":["../../src/core/manifest.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,WAAW,CAAA;AAE5B,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAA;AAGpD,2CAA2C;AAC3C,MAAM,UAAU,eAAe,CAAC,WAAmB;IACjD,OAAO,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,eAAe,EAAE,eAAe,CAAC,CAAA;AACjE,CAAC;AAED,yBAAyB;AACzB,MAAM,CAAC,KAAK,UAAU,mBAAmB,CAAC,WAAmB;IAC3D,MAAM,GAAG,GAAG,MAAM,QAAQ,CAAC,eAAe,CAAC,WAAW,CAAC,CAAC,CAAA;IACxD,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAoB,CAAA;AAC3C,CAAC;AAED,6BAA6B;AAC7B,MAAM,CAAC,KAAK,UAAU,oBAAoB,CACxC,WAAmB,EACnB,QAAyB;IAEzB,MAAM,SAAS,CAAC,eAAe,CAAC,WAAW,CAAC,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAA;AACzF,CAAC"}

package/dist/core/mcp-config.d.ts

@@ -0,0 +1,12 @@
+import type { McpId, ToolId } from '../types.js';
+/** 获取某个 MCP 在指定工具下的模板片段。 */
+export declare function getMcpSnippet(tool: ToolId, mcpId: McpId): string;
+/** 组装 Codex 项目的 `config.toml` 片段。 */
+export declare function buildCodexMcpConfig(selectedMcps: McpId[]): string;
+/** 组装 Claude Code 项目的 `.mcp.json` 内容。 */
+export declare function buildClaudeMcpConfig(selectedMcps: McpId[]): string;
+/** 从已有配置中解析出已经声明过的 MCP server ID。 */
+export declare function parseConfiguredMcpIds(tool: ToolId, content: string): Set<string>;
+/** 仅把缺失的 MCP 片段追加进去，已存在的 server 不覆盖。 */
+export declare function mergeMcpConfig(tool: ToolId, existingContent: string, selectedMcps: McpId[]): string;
+//# sourceMappingURL=mcp-config.d.ts.map

package/dist/core/mcp-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-config.d.ts","sourceRoot":"","sources":["../../src/core/mcp-config.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAA;AAUhD,4BAA4B;AAC5B,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,GAAG,MAAM,CAIhE;AAED,qCAAqC;AACrC,wBAAgB,mBAAmB,CAAC,YAAY,EAAE,KAAK,EAAE,GAAG,MAAM,CAQjE;AAED,yCAAyC;AACzC,wBAAgB,oBAAoB,CAAC,YAAY,EAAE,KAAK,EAAE,GAAG,MAAM,CASlE;AAED,qCAAqC;AACrC,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,GAAG,CAAC,MAAM,CAAC,CAShF;AAED,wCAAwC;AACxC,wBAAgB,cAAc,CAC5B,IAAI,EAAE,MAAM,EACZ,eAAe,EAAE,MAAM,EACvB,YAAY,EAAE,KAAK,EAAE,GACpB,MAAM,CAsBR"}

package/dist/core/mcp-config.js

@@ -0,0 +1,60 @@
+import { readFileSync } from 'node:fs';
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
+const currentDir = path.dirname(fileURLToPath(import.meta.url));
+const projectRoot = path.resolve(currentDir, '..', '..');
+/** 从模板目录读取单个 MCP 片段。 */
+function loadTemplate(relativePath) {
+    return readFileSync(path.join(projectRoot, 'templates', relativePath), 'utf8');
+}
+/** 获取某个 MCP 在指定工具下的模板片段。 */
+export function getMcpSnippet(tool, mcpId) {
+    return tool === 'codex'
+        ? loadTemplate(path.join('mcp', mcpId, 'codex', 'config.toml'))
+        : loadTemplate(path.join('mcp', mcpId, 'claude-code', 'server.json'));
+}
+/** 组装 Codex 项目的 `config.toml` 片段。 */
+export function buildCodexMcpConfig(selectedMcps) {
+    const lines = ['# Managed by SDT DevAgent'];
+    for (const mcpId of selectedMcps) {
+        lines.push('', getMcpSnippet('codex', mcpId).trimEnd());
+    }
+    return `${lines.join('\n')}\n`;
+}
+/** 组装 Claude Code 项目的 `.mcp.json` 内容。 */
+export function buildClaudeMcpConfig(selectedMcps) {
+    const mcpServers = {};
+    for (const mcpId of selectedMcps) {
+        const parsed = JSON.parse(getMcpSnippet('claude-code', mcpId));
+        Object.assign(mcpServers, parsed);
+    }
+    return `${JSON.stringify({ mcpServers }, null, 2)}\n`;
+}
+/** 从已有配置中解析出已经声明过的 MCP server ID。 */
+export function parseConfiguredMcpIds(tool, content) {
+    if (tool === 'codex') {
+        return new Set([...content.matchAll(/^\[mcp_servers\.([A-Za-z0-9_-]+)\]$/gm)].map((match) => match[1]));
+    }
+    const parsed = JSON.parse(content);
+    return new Set(Object.keys(parsed.mcpServers ?? {}));
+}
+/** 仅把缺失的 MCP 片段追加进去，已存在的 server 不覆盖。 */
+export function mergeMcpConfig(tool, existingContent, selectedMcps) {
+    const existingServers = parseConfiguredMcpIds(tool, existingContent);
+    const missingMcps = selectedMcps.filter((mcpId) => !existingServers.has(mcpId));
+    if (missingMcps.length === 0) {
+        return existingContent.endsWith('\n') ? existingContent : `${existingContent}\n`;
+    }
+    if (tool === 'codex') {
+        const additions = missingMcps.map((mcpId) => getMcpSnippet(tool, mcpId).trim());
+        const base = existingContent.trimEnd();
+        return `${base}\n\n${additions.join('\n\n')}\n`;
+    }
+    const parsed = JSON.parse(existingContent);
+    const mergedServers = { ...(parsed.mcpServers ?? {}) };
+    for (const mcpId of missingMcps) {
+        Object.assign(mergedServers, JSON.parse(getMcpSnippet(tool, mcpId)));
+    }
+    return `${JSON.stringify({ ...parsed, mcpServers: mergedServers }, null, 2)}\n`;
+}
+//# sourceMappingURL=mcp-config.js.map

package/dist/core/mcp-config.js.map

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

package/dist/core/project-inspector.d.ts

@@ -1,3 +1,4 @@
 import type { ProjectFacts } from '../types.js';
+/** `init` 当前只关注最小项目事实，不做框架和业务层深入探测。 */
 export declare function inspectProject(targetPath: string): Promise<ProjectFacts>;
 //# sourceMappingURL=project-inspector.d.ts.map

package/dist/core/project-inspector.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"project-inspector.d.ts","sourceRoot":"","sources":["../../src/core/project-inspector.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAkD/C,wBAAsB,cAAc,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,CAa9E"}
+{"version":3,"file":"project-inspector.d.ts","sourceRoot":"","sources":["../../src/core/project-inspector.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAqD/C,uCAAuC;AACvC,wBAAsB,cAAc,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,CAa9E"}