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

package/dist/core/project-inspector.js

@@ -1,5 +1,6 @@
 import path from 'node:path';
 import { exists, readText } from '../utils/fs.js';
+/** 通过常见 lockfile 推断项目包管理器。 */
 async function detectPackageManager(targetPath) {
     const checks = [
         ['pnpm-lock.yaml', 'pnpm'],
@@ -14,6 +15,7 @@ async function detectPackageManager(targetPath) {
     }
     return 'unknown';
 }
+/** 读取项目名；没有 `package.json` 时回退到目录名。 */
 async function detectProjectName(targetPath) {
     const packageJsonPath = path.join(targetPath, 'package.json');
     if (!(await exists(packageJsonPath))) {
@@ -29,6 +31,7 @@ async function detectProjectName(targetPath) {
         hasPackageJson: true,
     };
 }
+/** 在一组候选目录里找第一个存在的目录作为事实值。 */
 async function detectDirectory(targetPath, candidates) {
     for (const candidate of candidates) {
         if (await exists(path.join(targetPath, candidate))) {
@@ -37,6 +40,7 @@ async function detectDirectory(targetPath, candidates) {
     }
     return 'N/A';
 }
+/** `init` 当前只关注最小项目事实，不做框架和业务层深入探测。 */
 export async function inspectProject(targetPath) {
     const project = await detectProjectName(targetPath);
     return {

package/dist/core/project-inspector.js.map

@@ -1 +1 @@
-{"version":3,"file":"project-inspector.js","sourceRoot":"","sources":["../../src/core/project-inspector.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,WAAW,CAAA;AAE5B,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAA;AAGjD,KAAK,UAAU,oBAAoB,CAAC,UAAkB;IACpD,MAAM,MAAM,GAA4B;QACtC,CAAC,gBAAgB,EAAE,MAAM,CAAC;QAC1B,CAAC,mBAAmB,EAAE,KAAK,CAAC;QAC5B,CAAC,WAAW,EAAE,MAAM,CAAC;QACrB,CAAC,WAAW,EAAE,KAAK,CAAC;KACrB,CAAA;IAED,KAAK,MAAM,CAAC,QAAQ,EAAE,cAAc,CAAC,IAAI,MAAM,EAAE,CAAC;QAChD,IAAI,MAAM,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAC,EAAE,CAAC;YAClD,OAAO,cAAc,CAAA;QACvB,CAAC;IACH,CAAC;IAED,OAAO,SAAS,CAAA;AAClB,CAAC;AAED,KAAK,UAAU,iBAAiB,CAAC,UAAkB;IAIjD,MAAM,eAAe,GAAG,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,cAAc,CAAC,CAAA;IAC7D,IAAI,CAAC,CAAC,MAAM,MAAM,CAAC,eAAe,CAAC,CAAC,EAAE,CAAC;QACrC,OAAO;YACL,WAAW,EAAE,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC;YACtC,cAAc,EAAE,KAAK;SACtB,CAAA;IACH,CAAC;IAED,MAAM,GAAG,GAAG,MAAM,QAAQ,CAAC,eAAe,CAAC,CAAA;IAC3C,MAAM,WAAW,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAsB,CAAA;IAExD,OAAO;QACL,WAAW,EAAE,WAAW,CAAC,IAAI,IAAI,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC;QAC1D,cAAc,EAAE,IAAI;KACrB,CAAA;AACH,CAAC;AAED,KAAK,UAAU,eAAe,CAAC,UAAkB,EAAE,UAAoB;IACrE,KAAK,MAAM,SAAS,IAAI,UAAU,EAAE,CAAC;QACnC,IAAI,MAAM,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,SAAS,CAAC,CAAC,EAAE,CAAC;YACnD,OAAO,SAAS,CAAA;QAClB,CAAC;IACH,CAAC;IAED,OAAO,KAAK,CAAA;AACd,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,UAAkB;IACrD,MAAM,OAAO,GAAG,MAAM,iBAAiB,CAAC,UAAU,CAAC,CAAA;IAEnD,OAAO;QACL,UAAU;QACV,WAAW,EAAE,OAAO,CAAC,WAAW;QAChC,cAAc,EAAE,MAAM,oBAAoB,CAAC,UAAU,CAAC;QACtD,UAAU,EAAE,MAAM,eAAe,CAAC,UAAU,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,UAAU,CAAC,CAAC;QACzE,QAAQ,EAAE,MAAM,eAAe,CAAC,UAAU,EAAE,CAAC,MAAM,EAAE,OAAO,EAAE,WAAW,CAAC,CAAC;QAC3E,cAAc,EAAE,OAAO,CAAC,cAAc;QACtC,SAAS,EAAE,MAAM,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,WAAW,CAAC,CAAC;QAC3D,UAAU,EAAE,MAAM,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC;KACxD,CAAA;AACH,CAAC"}
+{"version":3,"file":"project-inspector.js","sourceRoot":"","sources":["../../src/core/project-inspector.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,WAAW,CAAA;AAE5B,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAA;AAGjD,8BAA8B;AAC9B,KAAK,UAAU,oBAAoB,CAAC,UAAkB;IACpD,MAAM,MAAM,GAA4B;QACtC,CAAC,gBAAgB,EAAE,MAAM,CAAC;QAC1B,CAAC,mBAAmB,EAAE,KAAK,CAAC;QAC5B,CAAC,WAAW,EAAE,MAAM,CAAC;QACrB,CAAC,WAAW,EAAE,KAAK,CAAC;KACrB,CAAA;IAED,KAAK,MAAM,CAAC,QAAQ,EAAE,cAAc,CAAC,IAAI,MAAM,EAAE,CAAC;QAChD,IAAI,MAAM,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAC,EAAE,CAAC;YAClD,OAAO,cAAc,CAAA;QACvB,CAAC;IACH,CAAC;IAED,OAAO,SAAS,CAAA;AAClB,CAAC;AAED,uCAAuC;AACvC,KAAK,UAAU,iBAAiB,CAAC,UAAkB;IAIjD,MAAM,eAAe,GAAG,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,cAAc,CAAC,CAAA;IAC7D,IAAI,CAAC,CAAC,MAAM,MAAM,CAAC,eAAe,CAAC,CAAC,EAAE,CAAC;QACrC,OAAO;YACL,WAAW,EAAE,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC;YACtC,cAAc,EAAE,KAAK;SACtB,CAAA;IACH,CAAC;IAED,MAAM,GAAG,GAAG,MAAM,QAAQ,CAAC,eAAe,CAAC,CAAA;IAC3C,MAAM,WAAW,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAsB,CAAA;IAExD,OAAO;QACL,WAAW,EAAE,WAAW,CAAC,IAAI,IAAI,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC;QAC1D,cAAc,EAAE,IAAI;KACrB,CAAA;AACH,CAAC;AAED,8BAA8B;AAC9B,KAAK,UAAU,eAAe,CAAC,UAAkB,EAAE,UAAoB;IACrE,KAAK,MAAM,SAAS,IAAI,UAAU,EAAE,CAAC;QACnC,IAAI,MAAM,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,SAAS,CAAC,CAAC,EAAE,CAAC;YACnD,OAAO,SAAS,CAAA;QAClB,CAAC;IACH,CAAC;IAED,OAAO,KAAK,CAAA;AACd,CAAC;AAED,uCAAuC;AACvC,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,UAAkB;IACrD,MAAM,OAAO,GAAG,MAAM,iBAAiB,CAAC,UAAU,CAAC,CAAA;IAEnD,OAAO;QACL,UAAU;QACV,WAAW,EAAE,OAAO,CAAC,WAAW;QAChC,cAAc,EAAE,MAAM,oBAAoB,CAAC,UAAU,CAAC;QACtD,UAAU,EAAE,MAAM,eAAe,CAAC,UAAU,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,UAAU,CAAC,CAAC;QACzE,QAAQ,EAAE,MAAM,eAAe,CAAC,UAAU,EAAE,CAAC,MAAM,EAAE,OAAO,EAAE,WAAW,CAAC,CAAC;QAC3E,cAAc,EAAE,OAAO,CAAC,cAAc;QACtC,SAAS,EAAE,MAAM,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,WAAW,CAAC,CAAC;QAC3D,UAAU,EAAE,MAAM,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC;KACxD,CAAA;AACH,CAAC"}

package/dist/core/remote-skill-installer.d.ts

@@ -0,0 +1,16 @@
+import type { PlannedRemoteSkillInstall } from '../types.js';
+/** 单次远端 skill 安装后的结果摘要。 */
+export interface RemoteSkillInstallResult {
+    tool: PlannedRemoteSkillInstall['tool'];
+    skillId: PlannedRemoteSkillInstall['skillId'];
+    targetPaths: string[];
+    installCommand: string;
+    success: boolean;
+    error?: string;
+}
+/**
+ * 执行远端 skill 安装。
+ * 成功标准不是退出码，而是安装后项目级目标路径已经真实出现。
+ */
+export declare function installRemoteSkill(projectRoot: string, install: PlannedRemoteSkillInstall): Promise<RemoteSkillInstallResult>;
+//# sourceMappingURL=remote-skill-installer.d.ts.map

package/dist/core/remote-skill-installer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"remote-skill-installer.d.ts","sourceRoot":"","sources":["../../src/core/remote-skill-installer.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,aAAa,CAAA;AAE5D,2BAA2B;AAC3B,MAAM,WAAW,wBAAwB;IACvC,IAAI,EAAE,yBAAyB,CAAC,MAAM,CAAC,CAAA;IACvC,OAAO,EAAE,yBAAyB,CAAC,SAAS,CAAC,CAAA;IAC7C,WAAW,EAAE,MAAM,EAAE,CAAA;IACrB,cAAc,EAAE,MAAM,CAAA;IACtB,OAAO,EAAE,OAAO,CAAA;IAChB,KAAK,CAAC,EAAE,MAAM,CAAA;CACf;AAoDD;;;GAGG;AACH,wBAAsB,kBAAkB,CACtC,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,yBAAyB,GACjC,OAAO,CAAC,wBAAwB,CAAC,CAwEnC"}

package/dist/core/remote-skill-installer.js

@@ -0,0 +1,104 @@
+import { spawn } from 'node:child_process';
+import path from 'node:path';
+import { hasProjectSkillInstall } from './capability-discovery.js';
+/** 最小的子进程执行包装；统一收集 stdout/stderr 作为错误上下文。 */
+function runCommand(command, args, env, cwd) {
+    return new Promise((resolve) => {
+        const child = spawn(command, args, {
+            cwd,
+            env,
+            stdio: ['ignore', 'pipe', 'pipe'],
+            shell: process.platform === 'win32',
+        });
+        let stdout = '';
+        let stderr = '';
+        child.stdout?.setEncoding('utf8');
+        child.stderr?.setEncoding('utf8');
+        child.stdout?.on('data', (chunk) => {
+            stdout += chunk;
+        });
+        child.stderr?.on('data', (chunk) => {
+            stderr += chunk;
+        });
+        child.on('error', (error) => {
+            resolve({
+                success: false,
+                error: error.message,
+            });
+        });
+        child.on('close', (code, signal) => {
+            const output = [stdout.trim(), stderr.trim()].filter(Boolean).join('\n');
+            if (code === 0) {
+                resolve({ success: true, output });
+                return;
+            }
+            resolve({
+                success: false,
+                error: output || `Command failed with ${signal ? `signal ${signal}` : `exit code ${code}`}`,
+            });
+        });
+    });
+}
+/**
+ * 执行远端 skill 安装。
+ * 成功标准不是退出码，而是安装后项目级目标路径已经真实出现。
+ */
+export async function installRemoteSkill(projectRoot, install) {
+    const stubPath = process.env.SDT_DEV_AGENT_SKILLS_STUB_PATH;
+    const targetPaths = install.installTargets.map((target) => target.targetPath);
+    let execution;
+    if (stubPath) {
+        // 测试环境通过 stub 精确控制安装结果，避免真实依赖网络和外部 CLI。
+        for (const target of install.installTargets) {
+            execution = await runCommand(process.execPath, [stubPath, target.skillName, install.tool, path.join(projectRoot, target.targetPath)], process.env, projectRoot);
+            if (!execution.success) {
+                return {
+                    tool: install.tool,
+                    skillId: install.skillId,
+                    targetPaths,
+                    installCommand: install.installCommand,
+                    success: false,
+                    error: execution.error,
+                };
+            }
+        }
+        execution = { success: true, output: '' };
+    }
+    else {
+        // 正常链路复用 skills CLI，把能力直接 copy 到项目级目录。
+        const skillNames = install.installTargets.map((target) => target.skillName);
+        execution = await runCommand('npx', [
+            '-y',
+            'skills',
+            'add',
+            install.source,
+            '--yes',
+            '--skill',
+            ...skillNames,
+            '--copy',
+            '-a',
+            install.tool,
+        ], process.env, projectRoot);
+    }
+    if (execution.success && !hasProjectSkillInstall(projectRoot, install.tool, install.skillId)) {
+        const expectedPaths = targetPaths.join(', ');
+        const detail = execution.output ? `\nCommand output:\n${execution.output}` : '';
+        return {
+            tool: install.tool,
+            skillId: install.skillId,
+            targetPaths,
+            installCommand: install.installCommand,
+            success: false,
+            error: `Command exited successfully but the expected project skill paths were not written: ${expectedPaths}.${detail}`,
+        };
+    }
+    return {
+        tool: install.tool,
+        skillId: install.skillId,
+        targetPaths,
+        installCommand: install.installCommand,
+        success: execution.success,
+        error: execution.success ? undefined : execution.error,
+    };
+}
+//# sourceMappingURL=remote-skill-installer.js.map

package/dist/core/remote-skill-installer.js.map

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

package/dist/core/workflow-installer.d.ts

@@ -0,0 +1,22 @@
+import type { ToolId, WorkflowId } from '../types.js';
+/** `add workflow` 传给安装器的最小输入。 */
+export interface PlannedWorkflowInstall {
+    tool: ToolId;
+    workflowId: WorkflowId;
+    installCommand: string;
+}
+/** 单次 workflow 安装后的结果摘要。 */
+export interface WorkflowInstallResult {
+    tool: ToolId;
+    workflowId: WorkflowId;
+    targetPaths: string[];
+    installCommand: string;
+    success: boolean;
+    error?: string;
+}
+/**
+ * 执行 workflow 安装。
+ * 当前策略是优先走本机命令，失败时再回退到官方 `npx` 入口。
+ */
+export declare function installWorkflow(projectRoot: string, install: PlannedWorkflowInstall): Promise<WorkflowInstallResult>;
+//# sourceMappingURL=workflow-installer.d.ts.map

package/dist/core/workflow-installer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflow-installer.d.ts","sourceRoot":"","sources":["../../src/core/workflow-installer.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,aAAa,CAAA;AAErD,iCAAiC;AACjC,MAAM,WAAW,sBAAsB;IACrC,IAAI,EAAE,MAAM,CAAA;IACZ,UAAU,EAAE,UAAU,CAAA;IACtB,cAAc,EAAE,MAAM,CAAA;CACvB;AAED,4BAA4B;AAC5B,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,MAAM,CAAA;IACZ,UAAU,EAAE,UAAU,CAAA;IACtB,WAAW,EAAE,MAAM,EAAE,CAAA;IACrB,cAAc,EAAE,MAAM,CAAA;IACtB,OAAO,EAAE,OAAO,CAAA;IAChB,KAAK,CAAC,EAAE,MAAM,CAAA;CACf;AAyDD;;;GAGG;AACH,wBAAsB,eAAe,CACnC,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,sBAAsB,GAC9B,OAAO,CAAC,qBAAqB,CAAC,CAyEhC"}

package/dist/core/workflow-installer.js

@@ -0,0 +1,103 @@
+import { spawn } from 'node:child_process';
+import path from 'node:path';
+import { hasProjectWorkflowInstall } from './capability-discovery.js';
+import { getWorkflowTargetPaths } from './init-plan.js';
+/** 最小的子进程执行包装；统一收集 stdout/stderr 作为错误上下文。 */
+function runCommand(command, args, env, cwd) {
+    return new Promise((resolve) => {
+        const child = spawn(command, args, {
+            cwd,
+            env,
+            stdio: ['ignore', 'pipe', 'pipe'],
+            shell: process.platform === 'win32',
+        });
+        let stdout = '';
+        let stderr = '';
+        child.stdout?.setEncoding('utf8');
+        child.stderr?.setEncoding('utf8');
+        child.stdout?.on('data', (chunk) => {
+            stdout += chunk;
+        });
+        child.stderr?.on('data', (chunk) => {
+            stderr += chunk;
+        });
+        child.on('error', (error) => {
+            resolve({
+                success: false,
+                error: error.message,
+            });
+        });
+        child.on('close', (code, signal) => {
+            const output = [stdout.trim(), stderr.trim()].filter(Boolean).join('\n');
+            if (code === 0) {
+                resolve({ success: true, output });
+                return;
+            }
+            resolve({
+                success: false,
+                error: output || `Command failed with ${signal ? `signal ${signal}` : `exit code ${code}`}`,
+            });
+        });
+    });
+}
+/** `OpenSpec` CLI 使用的工具名与本仓库内部枚举不同。 */
+function mapOpenSpecToolId(tool) {
+    return tool === 'claude-code' ? 'claude' : 'codex';
+}
+/**
+ * 执行 workflow 安装。
+ * 当前策略是优先走本机命令，失败时再回退到官方 `npx` 入口。
+ */
+export async function installWorkflow(projectRoot, install) {
+    const stubPath = process.env.SDT_DEV_AGENT_WORKFLOWS_STUB_PATH;
+    const targetPaths = getWorkflowTargetPaths(install.tool, install.workflowId);
+    let execution;
+    if (stubPath) {
+        // 测试环境直接走 stub，避免依赖真实 OpenSpec CLI。
+        execution = await runCommand(process.execPath, [
+            stubPath,
+            install.workflowId,
+            install.tool,
+            ...targetPaths.map((targetPath) => path.join(projectRoot, targetPath)),
+        ], process.env, projectRoot);
+    }
+    else {
+        // 优先复用用户本机已安装的 openspec，失败时再回退到 npx。
+        const toolArg = mapOpenSpecToolId(install.tool);
+        execution = await runCommand('openspec', ['init', '--tools', toolArg, '--profile', 'core', projectRoot], process.env, projectRoot);
+        if (!execution.success) {
+            execution = await runCommand('npx', [
+                '-y',
+                '@fission-ai/openspec@latest',
+                'init',
+                '--tools',
+                toolArg,
+                '--profile',
+                'core',
+                projectRoot,
+            ], process.env, projectRoot);
+        }
+    }
+    if (execution.success &&
+        !hasProjectWorkflowInstall(projectRoot, install.tool, install.workflowId)) {
+        const expectedPaths = targetPaths.join(', ');
+        const detail = 'output' in execution && execution.output ? `\nCommand output:\n${execution.output}` : '';
+        return {
+            tool: install.tool,
+            workflowId: install.workflowId,
+            targetPaths,
+            installCommand: install.installCommand,
+            success: false,
+            error: `Command exited successfully but the expected project workflow paths were not written: ${expectedPaths}.${detail}`,
+        };
+    }
+    return {
+        tool: install.tool,
+        workflowId: install.workflowId,
+        targetPaths,
+        installCommand: install.installCommand,
+        success: execution.success,
+        error: execution.success ? undefined : execution.error,
+    };
+}
+//# sourceMappingURL=workflow-installer.js.map

package/dist/core/workflow-installer.js.map

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

package/dist/types.d.ts

@@ -1,13 +1,69 @@
+/** CLI 和 manifest 共用的基础枚举。 */
 export declare const SUPPORTED_TOOLS: readonly ["codex", "claude-code"];
-export declare const INSTALL_MODES: readonly ["recommended", "minimal", "custom"];
-export declare const CAPABILITIES: readonly ["base-assets", "skills", "mcp"];
+export declare const INSTALL_MODES: readonly ["recommended", "custom"];
+/** capability 来源类型。 */
+export declare const SKILL_SOURCE_TYPES: readonly ["builtin-local", "remote-recommended"];
+export declare const MCP_SOURCE_TYPES: readonly ["project-template"];
+export declare const WORKFLOW_SOURCE_TYPES: readonly ["workflow-integration"];
+/** 选择态与安装状态。 */
+export declare const CAPABILITY_SELECTIONS: readonly ["required", "default", "optional"];
+export declare const CAPABILITY_STATUSES: readonly ["installed", "already-present", "failed"];
+export declare const SKIP_REASONS: readonly ["already-present", "install-failed"];
 export type ToolId = (typeof SUPPORTED_TOOLS)[number];
 export type InstallMode = (typeof INSTALL_MODES)[number];
-export type CapabilityId = (typeof CAPABILITIES)[number];
+export type SkillSourceType = (typeof SKILL_SOURCE_TYPES)[number];
+export type McpSourceType = (typeof MCP_SOURCE_TYPES)[number];
+export type WorkflowSourceType = (typeof WORKFLOW_SOURCE_TYPES)[number];
+export type CapabilitySelection = (typeof CAPABILITY_SELECTIONS)[number];
+export type CapabilityStatus = (typeof CAPABILITY_STATUSES)[number];
+export type SkipReason = (typeof SKIP_REASONS)[number];
+/** catalog 使用的稳定 capability ID。 */
+export type SkillId = 'bootstrap-project-docs' | 'code-review-expert' | 'superpowers' | 'frontend-design' | 'agent-browser' | 'find-skills' | 'skill-creator';
+export type McpId = 'context7' | 'mastergo';
+export type WorkflowId = 'openspec';
+/** catalog 记录 */
+export interface CatalogSkill {
+    id: SkillId;
+    displayName: string;
+    description: string;
+    sourceType: SkillSourceType;
+    selection: CapabilitySelection;
+    detectionMode: 'single' | 'bundle';
+    supportedTools: ToolId[];
+    templateDir?: string;
+    remote?: {
+        source: string;
+        installCommand: string;
+        installTargets?: Array<{
+            skillName: string;
+            targetDirName: string;
+        }>;
+    };
+}
+export interface CatalogMcp {
+    id: McpId;
+    displayName: string;
+    description: string;
+    sourceType: McpSourceType;
+    selection: Extract<CapabilitySelection, 'default' | 'optional'>;
+    supportedTools: ToolId[];
+    templateBaseDir: string;
+}
+export interface CatalogWorkflow {
+    id: WorkflowId;
+    displayName: string;
+    description: string;
+    sourceType: WorkflowSourceType;
+    supportedTools: ToolId[];
+    templateBaseDir: string;
+    installCommand: string;
+}
+/** 初始化链路相关类型 */
 export interface InitSelections {
     tools: ToolId[];
     installMode: InstallMode;
-    capabilities: CapabilityId[];
+    skills: SkillId[];
+    mcps: McpId[];
 }
 export interface ProjectFacts {
     targetPath: string;
@@ -22,18 +78,59 @@ export interface ProjectFacts {
 export interface PlannedFile {
     path: string;
     content: string;
-    kind: 'project-asset' | 'tool-integration' | 'manifest';
+    kind: 'bootstrap' | 'workflow' | 'mcp' | 'manifest';
 }
 export interface InitPlan {
     files: PlannedFile[];
+    remoteSkillInstalls: PlannedRemoteSkillInstall[];
     manifest: InstallManifest;
 }
+export interface PlannedRemoteSkillInstall {
+    tool: ToolId;
+    skillId: SkillId;
+    targetPath: string;
+    installTargets: Array<{
+        skillName: string;
+        targetPath: string;
+    }>;
+    source: string;
+    installCommand: string;
+}
+/** manifest 相关类型 */
+export interface ManifestCapabilityInstall {
+    tool: ToolId;
+    status: CapabilityStatus;
+    path: string;
+    reason?: SkipReason;
+    source?: string;
+    installCommand?: string;
+}
+export interface ManifestSkillRecord {
+    id: SkillId;
+    selection: CapabilitySelection;
+    sourceType: SkillSourceType;
+    installs: ManifestCapabilityInstall[];
+}
+export interface ManifestMcpRecord {
+    id: McpId;
+    selection: Extract<CapabilitySelection, 'default' | 'optional'>;
+    sourceType: McpSourceType;
+    installs: ManifestCapabilityInstall[];
+}
+export interface ManifestWorkflowRecord {
+    id: WorkflowId;
+    sourceType: WorkflowSourceType;
+    installs: ManifestCapabilityInstall[];
+}
 export interface InstallManifest {
     version: string;
     generatedAt: string;
     installMode: InstallMode;
     tools: ToolId[];
-    capabilities: CapabilityId[];
+    bootstrapSkillId: SkillId;
+    skills: ManifestSkillRecord[];
+    mcps: ManifestMcpRecord[];
+    workflows: ManifestWorkflowRecord[];
     project: {
         path: string;
         name: string;

package/dist/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,eAAe,mCAAoC,CAAA;AAChE,eAAO,MAAM,aAAa,+CAAgD,CAAA;AAC1E,eAAO,MAAM,YAAY,2CAA4C,CAAA;AAErE,MAAM,MAAM,MAAM,GAAG,CAAC,OAAO,eAAe,CAAC,CAAC,MAAM,CAAC,CAAA;AACrD,MAAM,MAAM,WAAW,GAAG,CAAC,OAAO,aAAa,CAAC,CAAC,MAAM,CAAC,CAAA;AACxD,MAAM,MAAM,YAAY,GAAG,CAAC,OAAO,YAAY,CAAC,CAAC,MAAM,CAAC,CAAA;AAExD,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,MAAM,EAAE,CAAA;IACf,WAAW,EAAE,WAAW,CAAA;IACxB,YAAY,EAAE,YAAY,EAAE,CAAA;CAC7B;AAED,MAAM,WAAW,YAAY;IAC3B,UAAU,EAAE,MAAM,CAAA;IAClB,WAAW,EAAE,MAAM,CAAA;IACnB,cAAc,EAAE,MAAM,CAAA;IACtB,UAAU,EAAE,MAAM,CAAA;IAClB,QAAQ,EAAE,MAAM,CAAA;IAChB,cAAc,EAAE,OAAO,CAAA;IACvB,SAAS,EAAE,OAAO,CAAA;IAClB,UAAU,EAAE,OAAO,CAAA;CACpB;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,EAAE,MAAM,CAAA;IACf,IAAI,EAAE,eAAe,GAAG,kBAAkB,GAAG,UAAU,CAAA;CACxD;AAED,MAAM,WAAW,QAAQ;IACvB,KAAK,EAAE,WAAW,EAAE,CAAA;IACpB,QAAQ,EAAE,eAAe,CAAA;CAC1B;AAED,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,MAAM,CAAA;IACf,WAAW,EAAE,MAAM,CAAA;IACnB,WAAW,EAAE,WAAW,CAAA;IACxB,KAAK,EAAE,MAAM,EAAE,CAAA;IACf,YAAY,EAAE,YAAY,EAAE,CAAA;IAC5B,OAAO,EAAE;QACP,IAAI,EAAE,MAAM,CAAA;QACZ,IAAI,EAAE,MAAM,CAAA;QACZ,cAAc,EAAE,MAAM,CAAA;QACtB,UAAU,EAAE,MAAM,CAAA;QAClB,QAAQ,EAAE,MAAM,CAAA;KACjB,CAAA;IACD,cAAc,EAAE,KAAK,CAAC;QACpB,IAAI,EAAE,MAAM,CAAA;QACZ,IAAI,EAAE,WAAW,CAAC,MAAM,CAAC,CAAA;KAC1B,CAAC,CAAA;CACH"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}

package/dist/types.js

@@ -1,4 +1,12 @@
+/** CLI 和 manifest 共用的基础枚举。 */
 export const SUPPORTED_TOOLS = ['codex', 'claude-code'];
-export const INSTALL_MODES = ['recommended', 'minimal', 'custom'];
-export const CAPABILITIES = ['base-assets', 'skills', 'mcp'];
+export const INSTALL_MODES = ['recommended', 'custom'];
+/** capability 来源类型。 */
+export const SKILL_SOURCE_TYPES = ['builtin-local', 'remote-recommended'];
+export const MCP_SOURCE_TYPES = ['project-template'];
+export const WORKFLOW_SOURCE_TYPES = ['workflow-integration'];
+/** 选择态与安装状态。 */
+export const CAPABILITY_SELECTIONS = ['required', 'default', 'optional'];
+export const CAPABILITY_STATUSES = ['installed', 'already-present', 'failed'];
+export const SKIP_REASONS = ['already-present', 'install-failed'];
 //# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,OAAO,EAAE,aAAa,CAAU,CAAA;AAChE,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,aAAa,EAAE,SAAS,EAAE,QAAQ,CAAU,CAAA;AAC1E,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,aAAa,EAAE,QAAQ,EAAE,KAAK,CAAU,CAAA"}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,8BAA8B;AAC9B,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,OAAO,EAAE,aAAa,CAAU,CAAA;AAChE,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,aAAa,EAAE,QAAQ,CAAU,CAAA;AAE/D,uBAAuB;AACvB,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,eAAe,EAAE,oBAAoB,CAAU,CAAA;AAClF,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,kBAAkB,CAAU,CAAA;AAC7D,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,sBAAsB,CAAU,CAAA;AAEtE,gBAAgB;AAChB,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,UAAU,EAAE,SAAS,EAAE,UAAU,CAAU,CAAA;AACjF,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,WAAW,EAAE,iBAAiB,EAAE,QAAQ,CAAU,CAAA;AACtF,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,iBAAiB,EAAE,gBAAgB,CAAU,CAAA"}

package/dist/utils/follow-up-notice.d.ts

@@ -0,0 +1,7 @@
+/** 需要用户后续手动处理的提示。 */
+export declare function printFollowUpNotice(title: string, lines: string[]): void;
+/** 成功类提示。 */
+export declare function printSuccessNotice(title: string, lines: string[]): void;
+/** 失败类提示。 */
+export declare function printFailureNotice(title: string, lines: string[]): void;
+//# sourceMappingURL=follow-up-notice.d.ts.map

package/dist/utils/follow-up-notice.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"follow-up-notice.d.ts","sourceRoot":"","sources":["../../src/utils/follow-up-notice.ts"],"names":[],"mappings":"AAuBA,qBAAqB;AACrB,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,IAAI,CAExE;AAED,aAAa;AACb,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,IAAI,CAEvE;AAED,aAAa;AACb,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,IAAI,CAEvE"}

package/dist/utils/follow-up-notice.js

@@ -0,0 +1,29 @@
+import { withTerminalTone } from './terminal-theme.js';
+const DIVIDER = '========================================';
+/** 统一的高亮提示框，用于初始化或增量安装后的补充说明。 */
+function printNotice(tone, title, lines) {
+    const highlight = (value) => withTerminalTone(value, tone);
+    if (lines.length === 0) {
+        return;
+    }
+    console.log('');
+    console.log(highlight(DIVIDER));
+    console.log(highlight(title));
+    for (const line of lines) {
+        console.log(highlight(`- ${line}`));
+    }
+    console.log(highlight(DIVIDER));
+}
+/** 需要用户后续手动处理的提示。 */
+export function printFollowUpNotice(title, lines) {
+    printNotice('follow-up', title, lines);
+}
+/** 成功类提示。 */
+export function printSuccessNotice(title, lines) {
+    printNotice('success', title, lines);
+}
+/** 失败类提示。 */
+export function printFailureNotice(title, lines) {
+    printNotice('failure', title, lines);
+}
+//# sourceMappingURL=follow-up-notice.js.map

package/dist/utils/follow-up-notice.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"follow-up-notice.js","sourceRoot":"","sources":["../../src/utils/follow-up-notice.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAA;AAEtD,MAAM,OAAO,GAAG,0CAA0C,CAAA;AAI1D,iCAAiC;AACjC,SAAS,WAAW,CAAC,IAAgB,EAAE,KAAa,EAAE,KAAe;IACnE,MAAM,SAAS,GAAG,CAAC,KAAa,EAAU,EAAE,CAAC,gBAAgB,CAAC,KAAK,EAAE,IAAI,CAAC,CAAA;IAE1E,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACvB,OAAM;IACR,CAAC;IAED,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAA;IACf,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,CAAA;IAC/B,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAA;IAC7B,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,CAAA;IACrC,CAAC;IACD,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,CAAA;AACjC,CAAC;AAED,qBAAqB;AACrB,MAAM,UAAU,mBAAmB,CAAC,KAAa,EAAE,KAAe;IAChE,WAAW,CAAC,WAAW,EAAE,KAAK,EAAE,KAAK,CAAC,CAAA;AACxC,CAAC;AAED,aAAa;AACb,MAAM,UAAU,kBAAkB,CAAC,KAAa,EAAE,KAAe;IAC/D,WAAW,CAAC,SAAS,EAAE,KAAK,EAAE,KAAK,CAAC,CAAA;AACtC,CAAC;AAED,aAAa;AACb,MAAM,UAAU,kBAAkB,CAAC,KAAa,EAAE,KAAe;IAC/D,WAAW,CAAC,SAAS,EAAE,KAAK,EAAE,KAAK,CAAC,CAAA;AACtC,CAAC"}

package/dist/utils/init-welcome.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"init-welcome.d.ts","sourceRoot":"","sources":["../../src/utils/init-welcome.ts"],"names":[],"mappings":"AAkJA,wBAAgB,qBAAqB,IAAI,MAAM,EAAE,CAiBhD;AAED,wBAAgB,yBAAyB,IAAI,MAAM,EAAE,CAEpD;AAmDD,wBAAgB,iBAAiB,IAAI,MAAM,CAM1C;AAwDD,wBAAsB,eAAe,IAAI,OAAO,CAAC,IAAI,CAAC,CA8DrD"}
+{"version":3,"file":"init-welcome.d.ts","sourceRoot":"","sources":["../../src/utils/init-welcome.ts"],"names":[],"mappings":"AAiIA,wBAAgB,qBAAqB,IAAI,MAAM,EAAE,CAkBhD;AAED,wBAAgB,yBAAyB,IAAI,MAAM,EAAE,CAEpD;AAmDD,wBAAgB,iBAAiB,IAAI,MAAM,CAM1C;AAwDD,wBAAsB,eAAe,IAAI,OAAO,CAAC,IAAI,CAAC,CA8DrD"}