@hongmaple0820/scale-engine 0.15.1 → 0.17.0

package/dist/skills/SkillRepository.js

@@ -0,0 +1,365 @@
+const DEFAULT_REQUIRED_CHECKS = [
+    'review-skill-frontmatter',
+    'inspect-scripts-directory',
+    'verify-license-and-source',
+    'pin-source-revision',
+];
+export const SKILL_REPOSITORY = [
+    skill({
+        id: 'frontend-design',
+        name: 'Frontend Design',
+        category: 'ui',
+        description: '用于生成有审美约束的生产级前端界面方案。',
+        sourceUrl: 'https://github.com/anthropics/skills/tree/main/skills/frontend-design',
+        installCommand: 'npx skills add anthropics/skills --skill frontend-design',
+        trust: 'official',
+        primaryUse: 'UI 视觉方向、布局、组件状态和前端实现约束。',
+        combineWith: ['awesome-design-md', 'ui-ux-pro-max', 'webapp-testing'],
+        evidence: ['ui-spec', 'visual-review'],
+    }),
+    skill({
+        id: 'awesome-design-md',
+        name: 'Awesome Design.md',
+        category: 'ui',
+        description: '用于沉淀 DESIGN.md、品牌、设计系统和产品体验参考。',
+        sourceUrl: 'https://github.com/VoltAgent/awesome-design-md',
+        installCommand: 'npx skills add https://github.com/VoltAgent/awesome-design-md --skill awesome-design-md',
+        trust: 'ecosystem',
+        primaryUse: '建立产品级设计规范和视觉语言。',
+        combineWith: ['ui-ux-pro-max', 'frontend-design'],
+        evidence: ['design-spec', 'design-system'],
+    }),
+    skill({
+        id: 'ui-ux-pro-max',
+        name: 'UI/UX Pro Max',
+        category: 'ui',
+        description: '用于用户路径、交互、可访问性、响应式和审美质量检查。',
+        sourceUrl: 'https://github.com/nextlevelbuilder/ui-ux-pro-max-skill',
+        installCommand: 'npx skills add https://github.com/nextlevelbuilder/ui-ux-pro-max-skill --skill ui-ux-pro-max',
+        trust: 'ecosystem',
+        primaryUse: '补齐体验策略、交互状态和 UI 验收维度。',
+        combineWith: ['awesome-design-md', 'webapp-testing'],
+        evidence: ['ui-spec', 'accessibility-review'],
+    }),
+    skill({
+        id: 'webapp-testing',
+        name: 'Webapp Testing',
+        category: 'testing',
+        description: '基于 Playwright 的 Web 应用交互测试和截图证据。',
+        sourceUrl: 'https://github.com/anthropics/skills/tree/main/skills/webapp-testing',
+        installCommand: 'npx skills add anthropics/skills --skill webapp-testing',
+        trust: 'official',
+        primaryUse: '验证页面点击、表单、控制台、截图和端到端行为。',
+        combineWith: ['agent-browser', 'mcp-chrome-devtools'],
+        evidence: ['browser-evidence', 'screenshot', 'console-log'],
+    }),
+    skill({
+        id: 'web-access',
+        name: 'Web Access',
+        category: 'browser',
+        description: '用于联网搜索、动态页面、登录态页面和真实浏览器取证。',
+        sourceUrl: 'https://github.com/eze-is/web-access',
+        installCommand: 'npx skills add https://github.com/eze-is/web-access --skill web-access',
+        trust: 'ecosystem',
+        primaryUse: '获取一手资料、动态页面内容、网页证据和来源引用。',
+        combineWith: ['agent-browser', 'mcp-chrome-devtools'],
+        evidence: ['source-citation', 'browser-evidence'],
+    }),
+    skill({
+        id: 'agent-browser',
+        name: 'Agent Browser',
+        category: 'browser',
+        description: '用于浏览器自动化、页面操作、截图和交互验证。',
+        sourceUrl: 'https://github.com/vercel-labs/agent-browser',
+        installCommand: 'Install or configure Agent Browser from https://github.com/vercel-labs/agent-browser',
+        trust: 'ecosystem',
+        primaryUse: '与 Web 页面真实交互，补齐手工验收证据。',
+        combineWith: ['web-access', 'webapp-testing', 'mcp-chrome-devtools'],
+        evidence: ['browser-evidence', 'screenshot'],
+    }),
+    skill({
+        id: 'mcp-chrome-devtools',
+        name: 'Chrome DevTools MCP',
+        category: 'browser',
+        description: '用于控制台、网络、性能和浏览器状态检查。',
+        sourceUrl: 'https://github.com/ChromeDevTools/chrome-devtools-mcp',
+        installCommand: 'Configure Chrome DevTools MCP for the active agent platform',
+        trust: 'ecosystem',
+        primaryUse: '调试控制台错误、网络请求、页面状态和性能问题。',
+        combineWith: ['agent-browser', 'webapp-testing'],
+        evidence: ['network-console-check', 'browser-evidence'],
+    }),
+    skill({
+        id: 'cua',
+        name: 'CUA',
+        category: 'desktop',
+        description: '用于桌面应用、GUI、WPS、微信等端侧自动化验证。',
+        sourceUrl: 'https://github.com/trycua/cua',
+        installCommand: 'Install or configure CUA from https://github.com/trycua/cua',
+        trust: 'ecosystem',
+        primaryUse: '操作桌面应用并收集端侧截图、状态和副作用边界证据。',
+        combineWith: ['web-access', 'agent-browser'],
+        evidence: ['desktop-screenshot', 'operator-safety', 'side-effect-boundary'],
+    }),
+    skill({
+        id: 'code-reviewer',
+        name: 'Code Reviewer',
+        category: 'review',
+        description: '用于 Critical / Improvements / Nitpicks 分级代码审查。',
+        sourceUrl: 'https://github.com/google-gemini/gemini-cli/tree/main/.gemini/skills/code-reviewer',
+        installCommand: 'npx skills add https://github.com/google-gemini/gemini-cli --skill code-reviewer',
+        trust: 'official',
+        primaryUse: '合并前分级审查缺陷、安全、可维护性和测试风险。',
+        combineWith: ['security-and-hardening', 'update-docs'],
+        evidence: ['review-report'],
+    }),
+    skill({
+        id: 'fix',
+        name: 'Fix',
+        category: 'review',
+        description: '用于提交前格式化、lint 和简单自动修复。',
+        sourceUrl: 'https://github.com/facebook/react/tree/main/.claude/skills/fix',
+        installCommand: 'npx skills add https://github.com/facebook/react --skill fix',
+        trust: 'official',
+        primaryUse: '提交前清理格式和 lint 问题。',
+        combineWith: ['code-reviewer'],
+        evidence: ['lint-output'],
+    }),
+    skill({
+        id: 'pr-creator',
+        name: 'PR Creator',
+        category: 'review',
+        description: '用于按模板生成 PR 描述并检查分支边界。',
+        sourceUrl: 'https://github.com/google-gemini/gemini-cli/tree/main/.gemini/skills/pr-creator',
+        installCommand: 'npx skills add https://github.com/google-gemini/gemini-cli --skill pr-creator',
+        trust: 'official',
+        primaryUse: '生成标准 PR 描述和合并前说明。',
+        combineWith: ['code-reviewer', 'update-docs'],
+        evidence: ['pr-description'],
+    }),
+    skill({
+        id: 'update-docs',
+        name: 'Update Docs',
+        category: 'docs',
+        description: '用于代码变更后的文档影响分析和同步更新。',
+        sourceUrl: 'https://github.com/vercel/next.js/tree/canary/.claude/skills/update-docs',
+        installCommand: 'npx skills add https://github.com/vercel/next.js --skill update-docs',
+        trust: 'official',
+        primaryUse: '发现并更新受代码变更影响的长期文档。',
+        combineWith: ['documentation-and-adrs'],
+        evidence: ['docs-impact'],
+    }),
+    skill({
+        id: 'find-skills',
+        name: 'Find Skills',
+        category: 'discovery',
+        description: '用于发现当前任务缺失的 Skill 能力。',
+        sourceUrl: 'https://github.com/vercel-labs/skills/tree/main/skills/find-skills',
+        installCommand: 'npx skills add https://github.com/vercel-labs/skills --skill find-skills',
+        trust: 'ecosystem',
+        primaryUse: '按任务意图搜索合适 Skill，再进入安全扫描。',
+        combineWith: ['web-access'],
+        evidence: ['skill-candidate-list'],
+    }),
+    skill({
+        id: 'codex-cli',
+        name: 'Codex CLI',
+        category: 'agent-cli',
+        description: '用于外部 Agent 评审、对照实现或第二意见。',
+        sourceUrl: 'https://github.com/openai/codex',
+        installCommand: 'Install Codex CLI and verify with: codex --version',
+        trust: 'official',
+        primaryUse: '外部 CLI 审查和命令级证据。',
+        combineWith: ['gemini-cli', 'opencode-cli'],
+        evidence: ['cli-version-check', 'command-output'],
+    }),
+    skill({
+        id: 'gemini-cli',
+        name: 'Gemini CLI',
+        category: 'agent-cli',
+        description: '用于外部 Agent 评审、代码审查和交叉验证。',
+        sourceUrl: 'https://github.com/google-gemini/gemini-cli',
+        installCommand: 'Install Gemini CLI and verify with: gemini --version',
+        trust: 'official',
+        primaryUse: '外部 CLI 审查和命令级证据。',
+        combineWith: ['codex-cli', 'opencode-cli'],
+        evidence: ['cli-version-check', 'command-output'],
+    }),
+    skill({
+        id: 'opencode-cli',
+        name: 'OpenCode CLI',
+        category: 'agent-cli',
+        description: '用于外部 Agent 评审或跨工具验证。',
+        sourceUrl: 'https://github.com/sst/opencode',
+        installCommand: 'Install OpenCode CLI and verify with: opencode --version',
+        trust: 'ecosystem',
+        primaryUse: '外部 CLI 审查和命令级证据。',
+        combineWith: ['codex-cli', 'gemini-cli'],
+        evidence: ['cli-version-check', 'command-output'],
+    }),
+    skill({
+        id: 'agency-agents-zh',
+        name: 'Agency Agents ZH',
+        category: 'role-library',
+        description: '中文专家角色库，可借鉴精选安装和多平台转换方式。',
+        sourceUrl: 'https://github.com/jnMetaCode/agency-agents-zh',
+        installCommand: 'Review and selectively install role presets from https://github.com/jnMetaCode/agency-agents-zh',
+        trust: 'community',
+        primaryUse: '提供 CEO、CTO、工程、设计、产品等角色预设参考。',
+        combineWith: ['skill-safety-scan'],
+        evidence: ['selected-role-list', 'role-trigger-policy'],
+    }),
+];
+export function listSkillRepositoryEntries(filter) {
+    return SKILL_REPOSITORY.filter(entry => !filter?.category || entry.category === filter.category);
+}
+export function recommendSkillWorkflow(input) {
+    const text = `${input.description} ${input.phase ?? ''}`.toLowerCase();
+    const primary = new Set();
+    const supporting = new Set();
+    const evidence = new Set(['skill-safety-scan']);
+    const rationale = [];
+    if (matches(text, ['ui', 'ux', 'design', 'frontend', '视觉', '审美', '交互', '前端'])) {
+        add(primary, ['awesome-design-md', 'ui-ux-pro-max', 'frontend-design']);
+        add(supporting, ['webapp-testing', 'agent-browser', 'mcp-chrome-devtools']);
+        add(evidence, ['design-spec', 'browser-evidence']);
+        rationale.push('检测到 UI/UX 或前端体验任务，需要设计 Skill 和浏览器证据组合。');
+    }
+    if (matches(text, ['browser', 'e2e', 'playwright', '浏览器', '自动化', '网页', '联网'])) {
+        add(primary, ['web-access']);
+        add(supporting, ['agent-browser', 'mcp-chrome-devtools', 'webapp-testing']);
+        add(evidence, ['source-citation', 'browser-evidence', 'network-console-check']);
+        rationale.push('检测到联网或浏览器自动化任务，需要来源引用和浏览器取证。');
+    }
+    if (matches(text, ['desktop', 'gui', 'wps', 'wechat', '微信', '桌面', '端侧', '电脑'])) {
+        add(primary, ['cua']);
+        add(supporting, ['web-access', 'agent-browser']);
+        add(evidence, ['desktop-screenshot', 'operator-safety', 'side-effect-boundary']);
+        rationale.push('检测到桌面/GUI 自动化任务，需要操作安全边界和截图证据。');
+    }
+    if (matches(text, ['codex', 'gemini', 'opencode', 'cli', '外部 agent'])) {
+        add(supporting, ['codex-cli', 'gemini-cli', 'opencode-cli']);
+        add(evidence, ['cli-version-check', 'command-output', 'dry-run-or-safe-mode']);
+        rationale.push('检测到外部 Agent CLI 编排，需要记录版本和命令输出。');
+    }
+    if (primary.size === 0 && supporting.size === 0) {
+        add(primary, ['find-skills']);
+        add(supporting, ['web-access']);
+        add(evidence, ['skill-candidate-list']);
+        rationale.push('未检测到明确领域，先使用 find-skills 和联网研究进行能力发现。');
+    }
+    return {
+        primarySkills: [...primary],
+        supportingSkills: [...supporting].filter(skillId => !primary.has(skillId)),
+        safetyRequired: true,
+        requiredEvidence: [...evidence],
+        rationale,
+    };
+}
+export function evaluateSkillInstallSafety(input) {
+    const findings = [];
+    const sourceUrl = input.sourceUrl?.trim();
+    const command = input.installCommand?.trim() ?? '';
+    const corpus = [command, ...(input.files ?? []).map(file => `${file.path}\n${file.content}`)].join('\n');
+    if (sourceUrl && !sourceUrl.startsWith('https://')) {
+        findings.push({ rule: 'https-required', severity: 'block', message: 'Skill 来源必须使用 HTTPS。' });
+    }
+    if (/\b(curl|wget|iwr|Invoke-WebRequest)\b[\s\S]*(\|\s*(bash|sh)|\|\s*(iex|Invoke-Expression))/i.test(corpus)) {
+        findings.push({ rule: 'no-pipe-to-shell', severity: 'block', message: '禁止下载脚本后直接管道执行。' });
+    }
+    if (/\b(Invoke-Expression|iex)\b/i.test(corpus)) {
+        findings.push({ rule: 'no-download-exec', severity: 'block', message: '禁止使用 Invoke-Expression/iex 执行远程内容。' });
+    }
+    if (/\brm\s+-rf\s+\/(?:\s|$)|Remove-Item[\s\S]*-Recurse[\s\S]*-Force/i.test(corpus)) {
+        findings.push({ rule: 'no-destructive-install', severity: 'block', message: '安装过程不得包含危险递归删除。' });
+    }
+    if (/\bpostinstall\b|\bpreinstall\b|\binstall\s*:/i.test(corpus)) {
+        findings.push({ rule: 'review-package-lifecycle-scripts', severity: 'warn', message: '发现生命周期脚本，需要人工审查。' });
+    }
+    if (/\bnpx\b|\bnpm\b/i.test(command)) {
+        findings.push({ rule: 'npm-supply-chain-review', severity: 'warn', message: 'npm/npx 安装需要签名、来源和 lockfile 审查。' });
+    }
+    const requiredChecks = new Set(DEFAULT_REQUIRED_CHECKS);
+    if (/\bnpx\b|\bnpm\b/i.test(command))
+        requiredChecks.add('npm-audit-signatures');
+    if (sourceUrl?.includes('github.com'))
+        requiredChecks.add('review-repository-activity');
+    if (input.files?.some(file => file.path.includes('scripts/')))
+        requiredChecks.add('review-executable-scripts');
+    const blocked = findings.some(finding => finding.severity === 'block');
+    return {
+        blocked,
+        risk: blocked ? 'blocked' : findings.some(finding => finding.severity === 'warn') ? 'medium' : 'low',
+        findings,
+        requiredChecks: [...requiredChecks],
+    };
+}
+export function renderSkillRepositoryMarkdown() {
+    const lines = [
+        '# SCALE Skill 仓库',
+        '',
+        '这个仓库视图用于让 Agent 按任务渐进式发现、激活和编排 skills/MCP/CLI，而不是一次性把所有能力塞进上下文。',
+        '',
+        '## 渐进式披露',
+        '',
+        '1. 启动时只读取 Skill 元数据和一句话描述。',
+        '2. 任务命中时才读取完整 SKILL.md。',
+        '3. scripts、references、assets 只在明确需要时懒加载。',
+        '',
+        '## 安全安装',
+        '',
+        '- 安装前必须执行安全扫描，阻断 `curl | bash`、`Invoke-Expression`、危险删除和非 HTTPS 来源。',
+        '- npm/npx 来源必须补充 `npm audit signatures`、来源仓库、许可证和版本/commit 固定检查。',
+        '- 任何第三方 Skill 都先进入隔离审查，再写入项目或全局 skills 目录。',
+        '',
+        '## 供应链防护清单',
+        '',
+        '- review-skill-frontmatter',
+        '- inspect-scripts-directory',
+        '- verify-license-and-source',
+        '- pin-source-revision',
+        '- npm-audit-signatures',
+        '',
+        '## Skill 目录',
+        '',
+        '| ID | 类别 | 信任 | 主要用途 | 组合建议 |',
+        '| --- | --- | --- | --- | --- |',
+    ];
+    for (const entry of SKILL_REPOSITORY) {
+        lines.push(`| \`${entry.id}\` | ${entry.category} | ${entry.trust} | ${entry.orchestration.primaryUse} | ${entry.orchestration.combineWith.join(', ') || '-'} |`);
+    }
+    return lines.join('\n');
+}
+function skill(input) {
+    return {
+        id: input.id,
+        name: input.name,
+        category: input.category,
+        description: input.description,
+        sourceUrl: input.sourceUrl,
+        installCommand: input.installCommand,
+        trust: input.trust,
+        progressiveDisclosure: {
+            startup: '只读取 name、description、tags、sourceUrl 等元数据。',
+            activation: '任务意图命中后读取完整 SKILL.md。',
+            lazyResources: ['scripts/', 'references/', 'assets/'],
+        },
+        orchestration: {
+            primaryUse: input.primaryUse,
+            combineWith: input.combineWith,
+            requiredEvidence: input.evidence,
+        },
+        safety: {
+            requiresReview: input.trust !== 'official',
+            requiredChecks: [...DEFAULT_REQUIRED_CHECKS],
+        },
+    };
+}
+function matches(text, keywords) {
+    return keywords.some(keyword => text.includes(keyword.toLowerCase()));
+}
+function add(target, values) {
+    for (const value of values)
+        target.add(value);
+}
+//# sourceMappingURL=SkillRepository.js.map

package/dist/skills/SkillRepository.js.map

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

package/dist/tools/ToolCapabilityRegistry.d.ts

@@ -0,0 +1,46 @@
+export type ToolCapabilityCategory = 'skill' | 'cli' | 'mcp';
+export type ToolCapabilityStatus = 'installed' | 'missing';
+export interface ToolCatalogEntry {
+    id: string;
+    name: string;
+    category: ToolCapabilityCategory;
+    requiredFor: string[];
+    recommendedFor?: string[];
+    skillId?: string;
+    command?: string;
+    versionArgs?: string[];
+    envFlag?: string;
+    source?: string;
+}
+export interface ToolCapabilityEntry extends ToolCatalogEntry {
+    installed: boolean;
+    status: ToolCapabilityStatus;
+    checkedPaths: string[];
+    detectedPath?: string;
+    version?: string;
+    missingReason?: string;
+}
+export interface ToolCapabilitySummary {
+    total: number;
+    installed: number;
+    missing: number;
+}
+export interface ToolCapabilityReport {
+    ok: boolean;
+    summary: ToolCapabilitySummary;
+    tools: ToolCapabilityEntry[];
+}
+export interface ToolCapabilityRegistryOptions {
+    projectDir?: string;
+    homeDir?: string;
+    toolIds?: string[];
+    env?: Record<string, string | undefined>;
+    commandExists?: (command: string) => boolean;
+    runVersion?: (command: string, args: string[]) => {
+        ok: boolean;
+        stdout?: string;
+        stderr?: string;
+    };
+}
+export declare const TOOL_CAPABILITY_CATALOG: ToolCatalogEntry[];
+export declare function inspectToolCapabilities(options?: ToolCapabilityRegistryOptions): ToolCapabilityReport;

package/dist/tools/ToolCapabilityRegistry.js

@@ -0,0 +1,223 @@
+import { execFileSync } from 'node:child_process';
+import { existsSync } from 'node:fs';
+import { homedir } from 'node:os';
+import { join, resolve } from 'node:path';
+export const TOOL_CAPABILITY_CATALOG = [
+    {
+        id: 'web-access',
+        name: 'Web Access',
+        category: 'skill',
+        skillId: 'web-access',
+        requiredFor: ['webResearch'],
+        recommendedFor: ['browserAutomation'],
+        source: 'https://github.com/eze-is/web-access',
+    },
+    {
+        id: 'frontend-design',
+        name: 'Frontend Design',
+        category: 'skill',
+        skillId: 'frontend-design',
+        requiredFor: ['ui'],
+        source: 'https://github.com/anthropics/skills/tree/main/skills/frontend-design',
+    },
+    {
+        id: 'ui-ux-pro-max',
+        name: 'UI/UX Pro Max',
+        category: 'skill',
+        skillId: 'ui-ux-pro-max',
+        requiredFor: ['ui'],
+        source: 'https://github.com/nextlevelbuilder/ui-ux-pro-max-skill',
+    },
+    {
+        id: 'awesome-design-md',
+        name: 'Awesome Design.md',
+        category: 'skill',
+        skillId: 'awesome-design-md',
+        requiredFor: [],
+        recommendedFor: ['ui'],
+        source: 'https://github.com/VoltAgent/awesome-design-md',
+    },
+    {
+        id: 'agent-browser',
+        name: 'Agent Browser',
+        category: 'cli',
+        command: 'agent-browser',
+        versionArgs: ['--version'],
+        requiredFor: ['browserAutomation'],
+        recommendedFor: ['ui', 'e2e'],
+        source: 'https://github.com/vercel-labs/agent-browser',
+    },
+    {
+        id: 'playwright',
+        name: 'Playwright',
+        category: 'cli',
+        command: 'npx',
+        versionArgs: ['playwright', '--version'],
+        requiredFor: ['e2e'],
+        recommendedFor: ['browserAutomation', 'ui'],
+        source: 'https://playwright.dev',
+    },
+    {
+        id: 'mcp-chrome-devtools',
+        name: 'Chrome DevTools MCP',
+        category: 'mcp',
+        envFlag: 'SCALE_MCP_CHROME_DEVTOOLS',
+        requiredFor: ['browserAutomation'],
+        recommendedFor: ['ui', 'e2e'],
+        source: 'https://github.com/ChromeDevTools/chrome-devtools-mcp',
+    },
+    {
+        id: 'desktop-cua',
+        name: 'CUA',
+        category: 'cli',
+        command: 'cua',
+        versionArgs: ['--version'],
+        requiredFor: ['desktopAutomation'],
+        source: 'https://github.com/trycua/cua',
+    },
+    {
+        id: 'codex-cli',
+        name: 'Codex CLI',
+        category: 'cli',
+        command: 'codex',
+        versionArgs: ['--version'],
+        requiredFor: [],
+        recommendedFor: ['externalCli', 'review'],
+        source: 'https://github.com/openai/codex',
+    },
+    {
+        id: 'gemini-cli',
+        name: 'Gemini CLI',
+        category: 'cli',
+        command: 'gemini',
+        versionArgs: ['--version'],
+        requiredFor: [],
+        recommendedFor: ['externalCli', 'review'],
+        source: 'https://github.com/google-gemini/gemini-cli',
+    },
+    {
+        id: 'opencode-cli',
+        name: 'OpenCode CLI',
+        category: 'cli',
+        command: 'opencode',
+        versionArgs: ['--version'],
+        requiredFor: [],
+        recommendedFor: ['externalCli', 'review'],
+        source: 'https://github.com/sst/opencode',
+    },
+];
+export function inspectToolCapabilities(options = {}) {
+    const projectDir = resolve(options.projectDir ?? process.cwd());
+    const homeDir = options.homeDir ?? homedir();
+    const env = options.env ?? process.env;
+    const selected = new Set(options.toolIds ?? TOOL_CAPABILITY_CATALOG.map(tool => tool.id));
+    const tools = TOOL_CAPABILITY_CATALOG
+        .filter(tool => selected.has(tool.id))
+        .map(tool => inspectToolCapability(tool, {
+        projectDir,
+        homeDir,
+        env,
+        commandExists: options.commandExists ?? defaultCommandExists,
+        runVersion: options.runVersion ?? defaultRunVersion,
+    }));
+    const installed = tools.filter(tool => tool.installed).length;
+    const missing = tools.length - installed;
+    return {
+        ok: missing === 0,
+        summary: {
+            total: tools.length,
+            installed,
+            missing,
+        },
+        tools,
+    };
+}
+function inspectToolCapability(tool, deps) {
+    if (tool.category === 'skill')
+        return inspectSkillTool(tool, deps);
+    if (tool.category === 'cli')
+        return inspectCliTool(tool, deps);
+    return inspectMcpTool(tool, deps);
+}
+function inspectSkillTool(tool, deps) {
+    const checkedPaths = skillCandidatePaths(tool.skillId ?? tool.id, deps.projectDir, deps.homeDir);
+    const detectedPath = checkedPaths.find(path => existsSync(path));
+    return {
+        ...tool,
+        checkedPaths,
+        detectedPath,
+        installed: Boolean(detectedPath),
+        status: detectedPath ? 'installed' : 'missing',
+        missingReason: detectedPath ? undefined : 'SKILL.md was not found in project or user skill directories',
+    };
+}
+function inspectCliTool(tool, deps) {
+    const command = tool.command ?? tool.id;
+    const checkedPaths = [`PATH:${command}`];
+    if (!deps.commandExists(command)) {
+        return {
+            ...tool,
+            checkedPaths,
+            installed: false,
+            status: 'missing',
+            missingReason: `Command not found: ${command}`,
+        };
+    }
+    const version = deps.runVersion(command, tool.versionArgs ?? ['--version']);
+    return {
+        ...tool,
+        checkedPaths,
+        installed: true,
+        status: 'installed',
+        version: version.ok ? (version.stdout ?? '').trim() : undefined,
+        missingReason: version.ok ? undefined : version.stderr ?? 'Version command failed',
+    };
+}
+function inspectMcpTool(tool, deps) {
+    const envFlag = tool.envFlag ?? `SCALE_MCP_${tool.id.toUpperCase().replace(/[^A-Z0-9]/g, '_')}`;
+    const installed = truthy(deps.env[envFlag]);
+    return {
+        ...tool,
+        checkedPaths: [`env:${envFlag}`],
+        installed,
+        status: installed ? 'installed' : 'missing',
+        missingReason: installed ? undefined : `MCP availability flag is not set: ${envFlag}`,
+    };
+}
+function skillCandidatePaths(skillId, projectDir, homeDir) {
+    return [
+        join(projectDir, '.agents', 'skills', skillId, 'SKILL.md'),
+        join(projectDir, '.codex', 'skills', skillId, 'SKILL.md'),
+        join(projectDir, '.claude', 'skills', skillId, 'SKILL.md'),
+        join(homeDir, '.agents', 'skills', skillId, 'SKILL.md'),
+        join(homeDir, '.codex', 'skills', skillId, 'SKILL.md'),
+        join(homeDir, '.claude', 'skills', skillId, 'SKILL.md'),
+    ];
+}
+function defaultCommandExists(command) {
+    try {
+        execFileSync(process.platform === 'win32' ? 'where.exe' : 'which', [command], { stdio: 'ignore' });
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+function defaultRunVersion(command, args) {
+    try {
+        const stdout = execFileSync(command, args, { encoding: 'utf-8', timeout: 5000, stdio: ['ignore', 'pipe', 'pipe'] });
+        return { ok: true, stdout };
+    }
+    catch (error) {
+        return {
+            ok: false,
+            stderr: error instanceof Error ? error.message : String(error),
+        };
+    }
+}
+function truthy(value) {
+    if (!value)
+        return false;
+    return ['1', 'true', 'yes', 'on', 'enabled'].includes(value.toLowerCase());
+}
+//# sourceMappingURL=ToolCapabilityRegistry.js.map