peaks-cli 1.0.0

package/dist/src/services/recommendations/capability-seed-items.d.ts

@@ -0,0 +1,2 @@
+import type { CapabilityItem } from './recommendation-types.js';
+export declare const seedCapabilityItems: CapabilityItem[];

package/dist/src/services/recommendations/capability-seed-items.js

@@ -0,0 +1,131 @@
+export const seedCapabilityItems = [
+    {
+        capabilityId: 'everything-claude-code.code-review-agent',
+        sourceId: 'everything-claude-code',
+        name: 'Code Review Agent',
+        itemType: 'agent',
+        category: 'code-review',
+        workflows: ['code-refactor', 'development-complete'],
+        audience: ['engineer'],
+        riskLevel: 'low',
+        inputContract: 'git-diff or changed-file summary',
+        outputContract: 'review-report',
+        fallback: { mode: 'built-in-review-checklist', qualityImpact: 'lower', nextAction: 'Use Peaks built-in code review checklist if the external agent is unavailable.' },
+        presentation: { displayName: { en: 'Code Review Agent', 'zh-CN': '代码评审代理' }, description: { en: 'Reviews code changes for quality, maintainability, tests, and risks.', 'zh-CN': '用于在代码改动后检查质量、可维护性、测试和风险。' } }
+    },
+    {
+        capabilityId: 'everything-claude-code.security-review-agent',
+        sourceId: 'everything-claude-code',
+        name: 'Security Review Agent',
+        itemType: 'agent',
+        category: 'security-review',
+        workflows: ['code-refactor', 'development-complete'],
+        audience: ['engineer'],
+        riskLevel: 'medium',
+        inputContract: 'git-diff or changed-file summary',
+        outputContract: 'security-review-report',
+        fallback: { mode: 'built-in-security-checklist', qualityImpact: 'lower', nextAction: 'Use Peaks built-in security checklist if the external agent is unavailable.' },
+        presentation: { displayName: { en: 'Security Review Agent', 'zh-CN': '安全评审代理' }, description: { en: 'Checks auth, user input, filesystem, external calls, and secret-handling risks.', 'zh-CN': '检查认证、用户输入、文件系统、外部调用和密钥处理风险。' } }
+    },
+    {
+        capabilityId: 'everything-claude-code.language-standards',
+        sourceId: 'everything-claude-code',
+        name: 'Language Coding Standards',
+        itemType: 'rule',
+        category: 'coding-standards',
+        workflows: ['code-refactor', 'development-start', 'project-standards'],
+        audience: ['engineer'],
+        riskLevel: 'low',
+        inputContract: 'project-language and existing project standards',
+        outputContract: 'project-local rules baseline',
+        fallback: { mode: 'peaks-built-in-standards', qualityImpact: 'same', nextAction: 'Use Peaks curated baseline and preserve existing project conventions.' },
+        presentation: { displayName: { en: 'Language Coding Standards', 'zh-CN': '语言编码规范' }, description: { en: 'Provides language coding standards for project-local Peaks rules.', 'zh-CN': '为项目内 Peaks 规则提供语言编码规范来源。' } }
+    },
+    {
+        capabilityId: 'everything-claude-code.code-review-guidance',
+        sourceId: 'everything-claude-code',
+        name: 'Code Review Guidance',
+        itemType: 'rule',
+        category: 'code-review',
+        workflows: ['code-refactor', 'development-complete', 'project-standards'],
+        audience: ['engineer', 'qa'],
+        riskLevel: 'low',
+        inputContract: 'project-local diff and test evidence',
+        outputContract: 'code-review rules baseline',
+        fallback: { mode: 'peaks-built-in-review-checklist', qualityImpact: 'same', nextAction: 'Use Peaks curated code review baseline if the external source is unavailable.' },
+        presentation: { displayName: { en: 'Code Review Guidance', 'zh-CN': '代码评审指导' }, description: { en: 'Provides review guidance for project-local Peaks rules and QA preflight.', 'zh-CN': '为项目内 Peaks 规则和 QA preflight 提供代码评审指导。' } }
+    },
+    {
+        capabilityId: 'everything-claude-code.security-review-guidance',
+        sourceId: 'everything-claude-code',
+        name: 'Security Review Guidance',
+        itemType: 'rule',
+        category: 'security-review',
+        workflows: ['code-refactor', 'development-complete', 'project-standards'],
+        audience: ['engineer', 'qa'],
+        riskLevel: 'low',
+        inputContract: 'project-local diff and sensitive-boundary summary',
+        outputContract: 'security-review rules baseline',
+        fallback: { mode: 'peaks-built-in-security-checklist', qualityImpact: 'same', nextAction: 'Use Peaks curated security baseline if the external source is unavailable.' },
+        presentation: { displayName: { en: 'Security Review Guidance', 'zh-CN': '安全评审指导' }, description: { en: 'Provides security review guidance for project-local Peaks rules and QA preflight.', 'zh-CN': '为项目内 Peaks 规则和 QA preflight 提供安全评审指导。' } }
+    },
+    {
+        capabilityId: 'context7.docs-lookup',
+        sourceId: 'context7',
+        name: 'Context7 Docs Lookup',
+        itemType: 'mcp',
+        category: 'docs-lookup',
+        workflows: ['code-refactor', 'product-refactor', 'frontend-design'],
+        audience: ['engineer', 'product'],
+        riskLevel: 'low',
+        inputContract: 'library or API documentation request',
+        outputContract: 'documentation-summary',
+        fallback: { mode: 'manual-docs-input', qualityImpact: 'lower', nextAction: 'Ask the user to provide the relevant documentation link or pasted excerpt.' },
+        presentation: { displayName: { en: 'Documentation Lookup', 'zh-CN': '文档查询能力' }, description: { en: 'Fetches current library and API documentation for implementation planning.', 'zh-CN': '用于获取当前库和 API 文档，辅助实现规划。' } }
+    },
+    capability('playwright-mcp.browser-validation', 'playwright-mcp', 'Playwright MCP Browser Validation', 'mcp', 'browser-validation', ['engineer', 'qa'], 'medium', 'manual-browser-test', 'Use local Playwright or manual browser verification.', 'Playwright Browser Validation', 'Playwright 浏览器验证', 'Validates UI flows through controlled browser automation.', '通过受控浏览器自动化验证 UI 流程。'),
+    capability('chrome-devtools-mcp.browser-debug', 'chrome-devtools-mcp', 'Chrome DevTools Browser Debug', 'mcp', 'browser-debug', ['engineer', 'qa'], 'medium', 'manual-devtools-inspection', 'Use browser screenshots, console logs, and network traces supplied by the user.', 'Chrome DevTools Debug', 'Chrome DevTools 调试', 'Inspects runtime UI, console, network, and performance behavior.', '检查运行时 UI、控制台、网络和性能行为。'),
+    capability('figma-context-mcp.design-context', 'figma-context-mcp', 'Figma Design Context', 'mcp', 'design-context', ['designer', 'engineer'], 'medium', 'manual-design-input', 'Ask the user for screenshots, tokens, or exported design notes.', 'Figma Design Context', 'Figma 设计上下文', 'Reads design context for UI implementation planning.', '读取设计上下文以辅助 UI 实现规划。'),
+    capability('searchcode-mcp.code-search', 'searchcode-mcp', 'SearchCode MCP', 'mcp', 'code-search', ['engineer'], 'medium', 'local-code-search', 'Use local Grep/Glob and ask before sending private code externally.', 'External Code Search', '外部代码搜索', 'Searches code examples or repositories outside the current workspace.', '搜索当前工作区外部的代码示例或仓库。'),
+    capability('mysql-mcp.database-inspection', 'mysql-mcp-server', 'MySQL Database Inspection', 'mcp', 'database-inspection', ['engineer'], 'high', 'schema-excerpt-input', 'Ask the user for schema excerpts or sanitized query plans.', 'MySQL Inspection', 'MySQL 检查', 'Inspects MySQL schema and data through an MCP boundary.', '通过 MCP 边界检查 MySQL schema 与数据。'),
+    capability('agent-browser.browser-agent', 'agent-browser', 'Agent Browser', 'agent', 'browser-agent', ['engineer', 'qa'], 'medium', 'manual-browser-walkthrough', 'Use screenshots and manual test steps if agent browser is unavailable.', 'Agent Browser', '浏览器代理', 'Supports browser-based validation and interaction planning.', '支持基于浏览器的验证和交互规划。'),
+    capability('minimax-skills.worker-guidance', 'minimax-skills', 'MiniMax Worker Guidance', 'skill', 'worker-guidance', ['engineer'], 'medium', 'peaks-worker-contract', 'Use Peaks built-in minimax-worker contract and review handoff.', 'MiniMax Worker Guidance', 'MiniMax Worker 指南', 'Guides MiniMax coding/test worker delegation.', '指导 MiniMax 编码/测试 worker 委托。'),
+    capability('claude-mem.memory-persistence', 'claude-mem', 'Claude Memory Persistence', 'skill', 'memory', ['engineer'], 'medium', 'peaks-txt-context-capsule', 'Use peaks-txt context capsules without storing secrets.', 'Memory Persistence', '记忆持久化', 'Persists reusable context when explicitly approved.', '在明确授权时持久化可复用上下文。'),
+    capability('shadcn-ui.component-system', 'shadcn-ui', 'shadcn/ui Component System', 'doc', 'ui-components', ['engineer', 'designer'], 'low', 'project-local-ui-patterns', 'Use existing project components and design tokens.', 'Component System Reference', '组件系统参考', 'Provides component and design-system references for UI planning.', '为 UI 规划提供组件和设计系统参考。'),
+    capability('openspec.spec-workflow', 'openspec', 'OpenSpec Workflow', 'workflow', 'spec-workflow', ['product', 'engineer'], 'low', 'peaks-prd-rd-qa-artifacts', 'Use Peaks built-in PRD/RD/QA artifact flow.', 'OpenSpec Workflow', 'OpenSpec 规格流程', 'Supports spec-first product and engineering governance.', '支持规格优先的产品与工程治理。'),
+    capability('gitnexus.repo-intelligence', 'gitnexus', 'GitNexus Repository Intelligence', 'cli', 'repo-intelligence', ['engineer'], 'medium', 'local-repo-scan', 'Use local project scanning through Peaks RD.', 'Repository Intelligence', '仓库智能分析', 'Repository intelligence should be proxied through Peaks before use.', '仓库智能分析应先通过 Peaks 代理边界再使用。'),
+    capability('claude-code-best-practice.workflow-guidance', 'claude-code-best-practice', 'Claude Code Best Practice', 'doc', 'workflow-guidance', ['engineer'], 'low', 'peaks-built-in-rules', 'Use Peaks built-in workflow and review rules.', 'Claude Code Best Practice', 'Claude Code 最佳实践', 'Guidance for Claude Code engineering workflows.', 'Claude Code 工程工作流指导。'),
+    capability('superpowers.workflow-methodology', 'superpowers', 'Superpowers Methodology', 'workflow', 'workflow-methodology', ['product', 'engineer'], 'low', 'peaks-workflow-route', 'Use Peaks route/autonomous plans.', 'Superpowers Methodology', 'Superpowers 方法论', 'Workflow and artifact methodology reference.', '工作流与 artifact 方法论参考。'),
+    capability('penpot.design-source', 'penpot', 'Penpot Design Source', 'doc', 'design-source', ['designer', 'engineer'], 'medium', 'manual-design-input', 'Ask for exported design notes or screenshots.', 'Penpot Design Source', 'Penpot 设计来源', 'Design-source reference for UI planning.', '用于 UI 规划的设计来源参考。'),
+    capability('gstack.product-stack-guidance', 'gstack', 'Product Stack Guidance', 'doc', 'product-guidance', ['product'], 'low', 'peaks-prd', 'Use peaks-prd for product goals and non-goals.', 'Product Stack Guidance', '产品栈指导', 'Product and startup stack guidance reference.', '产品与创业栈指导参考。'),
+    capability('awesome-design-md.design-reference', 'awesome-design-md', 'Design Markdown Reference', 'doc', 'design-reference', ['designer', 'engineer'], 'low', 'peaks-ui-visual-direction', 'Use peaks-ui to define visual direction and interaction constraints.', 'Design Reference', '设计参考', 'Design markdown examples and inspiration.', '设计 markdown 示例与灵感。'),
+    capability('reactbits.ui-reference', 'reactbits', 'React Bits UI Reference', 'doc', 'ui-reference', ['engineer', 'designer'], 'low', 'project-local-ui-patterns', 'Use project-local UI patterns and accessibility checks.', 'React UI Reference', 'React UI 参考', 'React UI and motion reference for frontend design.', 'React UI 与动效参考。'),
+    capability('context-mode.context-management', 'context-mode', 'Context Management', 'mcp', 'context-management', ['engineer'], 'medium', 'peaks-txt-context-capsule', 'Use peaks-txt context capsules and avoid saving secrets.', 'Context Management', '上下文管理', 'Manages reusable context across workflows.', '管理跨工作流可复用上下文。'),
+    capability('ruflo-access-repo.workflow-reference', 'ruflo-access-repo', 'Ruflo Workflow Reference', 'doc', 'workflow-reference', ['engineer'], 'medium', 'peaks-autonomous-planning', 'Use Peaks autonomous planning references without executing external code.', 'Workflow Reference', '工作流参考', 'Catalog-only workflow orchestration reference.', '仅作为目录化的工作流编排参考。'),
+    capability('modelcontextprotocol-servers.collection', 'modelcontextprotocol-servers', 'MCP Server Collection', 'doc', 'mcp-collection', ['engineer'], 'medium', 'future-peaks-mcp-catalog', 'Use future Peaks MCP catalog review before selecting individual servers.', 'MCP Collection', 'MCP 集合', 'Catalog-only MCP server collection reference.', '仅作为目录化的 MCP server 集合参考。'),
+    capability('andrej-karpathy-skills.guidance', 'andrej-karpathy-skills', 'Engineering Guidance', 'doc', 'engineering-guidance', ['engineer'], 'low', 'project-local-standards', 'Use project-local standards before external guidance.', 'Engineering Guidance', '工程指导', 'External engineering guidance reference.', '外部工程指导参考。'),
+    capability('mattpocock-skills.typescript-guidance', 'mattpocock-skills', 'TypeScript Guidance', 'doc', 'typescript-guidance', ['engineer'], 'low', 'project-local-typescript-standards', 'Use project-local TypeScript standards first.', 'TypeScript Guidance', 'TypeScript 指导', 'External TypeScript guidance reference.', '外部 TypeScript 指导参考。'),
+    capability('impeccable.quality-guidance', 'impeccable', 'Quality Guidance', 'doc', 'quality-guidance', ['engineer'], 'low', 'peaks-review-gates', 'Use Peaks review gates as authoritative.', 'Quality Guidance', '质量指导', 'Quality reference catalog entry.', '质量参考目录项。'),
+    capability('vercel-agent-skills.skill-pack', 'vercel-agent-skills', 'Vercel Agent Skills Pack', 'skill', 'skill-pack', ['engineer'], 'medium', 'external-skill-catalog', 'Inspect individual skills before use.', 'Agent Skills Pack', '代理技能包', 'Catalog-only external skill pack.', '仅作为目录化的外部技能包。'),
+    capability('darwin-skill.external-skill', 'darwin-skill', 'Darwin Skill', 'skill', 'external-skill', ['engineer'], 'medium', 'external-skill-catalog', 'Inspect for project fit and safety before use.', 'Darwin Skill', 'Darwin 技能', 'Catalog-only external skill reference.', '仅作为目录化的外部技能参考。'),
+    capability('taste-skill.design-critique', 'taste-skill', 'Design Critique', 'skill', 'design-critique', ['designer', 'engineer'], 'low', 'peaks-ui-constraints', 'Use Peaks UI constraints as authoritative.', 'Design Critique', '设计品味评审', 'External design critique reference.', '外部设计评审参考。'),
+    capability('ui-ux-pro-max-skill.design-guidance', 'ui-ux-pro-max-skill', 'UI/UX Guidance', 'skill', 'design-guidance', ['designer', 'engineer'], 'medium', 'peaks-ui-constraints', 'Clarify product goals and accessibility constraints first.', 'UI/UX Guidance', 'UI/UX 指导', 'External UI/UX guidance reference.', '外部 UI/UX 指导参考。'),
+    capability('ruflo-mcp-server.workflow-reference', 'ruflo-mcp-server', 'Ruflo Workflow Reference', 'doc', 'workflow-reference', ['engineer'], 'medium', 'peaks-autonomous-planning', 'Use as orchestration inspiration only.', 'Workflow Reference', '工作流参考', 'Catalog-only workflow orchestration reference.', '仅作为目录化的工作流编排参考。'),
+    capability('anthropic-skills.skill-pack', 'anthropic-skills', 'Anthropic Skills Pack', 'skill', 'skill-pack', ['engineer'], 'medium', 'external-skill-catalog', 'Inspect individual skills before use.', 'Skills Pack', '技能包', 'Catalog-only external skill pack.', '仅作为目录化的外部技能包。'),
+    capability('vercel-skills.skill-pack', 'vercel-skills', 'Vercel Skills Pack', 'skill', 'skill-pack', ['engineer'], 'medium', 'external-skill-catalog', 'Inspect individual skills before use.', 'Skills Pack', '技能包', 'Catalog-only external skill pack.', '仅作为目录化的外部技能包。'),
+    capability('azure-skills.cloud-skill-pack', 'azure-skills', 'Azure Skills Pack', 'skill', 'cloud-skill-pack', ['engineer'], 'high', 'cloud-capability-catalog', 'Require explicit confirmation and credentials for cloud actions.', 'Azure Skills Pack', 'Azure 技能包', 'Catalog-only cloud skill pack.', '仅作为目录化的云技能包。')
+];
+function capability(capabilityId, sourceId, name, itemType, category, audience, riskLevel, fallbackMode, nextAction, displayNameEn, displayNameZh, descriptionEn, descriptionZh) {
+    return {
+        capabilityId,
+        sourceId,
+        name,
+        itemType,
+        category,
+        workflows: ['capability-map'],
+        audience,
+        riskLevel,
+        fallback: { mode: fallbackMode, qualityImpact: fallbackMode.startsWith('peaks-') ? 'same' : 'lower', nextAction },
+        presentation: { displayName: { en: displayNameEn, 'zh-CN': displayNameZh }, description: { en: descriptionEn, 'zh-CN': descriptionZh } }
+    };
+}

package/dist/src/services/recommendations/capability-seed-mappings.d.ts

@@ -0,0 +1,2 @@
+import type { CapabilityLandingMapping } from './recommendation-types.js';
+export declare const seedCapabilityLandingMappings: CapabilityLandingMapping[];

package/dist/src/services/recommendations/capability-seed-mappings.js

@@ -0,0 +1,42 @@
+export const seedCapabilityLandingMappings = [
+    mapping({ capabilityId: 'ruflo-access-repo.workflow-reference', sourceId: 'ruflo-access-repo', sourceGroup: 'access-repo', landingKind: 'catalog', target: 'peaks autonomous planning reference', guidance: 'Use as workflow orchestration inspiration only; Peaks owns execution boundaries.' }),
+    mapping({ capabilityId: 'context7.docs-lookup', sourceId: 'context7', sourceGroup: 'access-repo', landingKind: 'cli', target: 'peaks recommend', commandPreview: 'peaks recommend --workflow code-refactor --json', guidance: 'Use for current library/API documentation lookup through approved MCP access.' }),
+    mapping({ capabilityId: 'playwright-mcp.browser-validation', sourceId: 'playwright-mcp', sourceGroup: 'access-repo', landingKind: 'skill', target: 'peaks-qa', skillName: 'peaks-qa', guidance: 'Use for browser and E2E validation after user-approved app targets are available.' }),
+    mapping({ capabilityId: 'chrome-devtools-mcp.browser-debug', sourceId: 'chrome-devtools-mcp', sourceGroup: 'access-repo', landingKind: 'skill', target: 'peaks-ui', skillName: 'peaks-ui', guidance: 'Use for runtime UI, console, network, and performance inspection.' }),
+    mapping({ capabilityId: 'context-mode.context-management', sourceId: 'context-mode', sourceGroup: 'access-repo', landingKind: 'skill', target: 'peaks-txt', skillName: 'peaks-txt', guidance: 'Use only for explicit context management; durable memory requires user opt-in.' }),
+    mapping({ capabilityId: 'modelcontextprotocol-servers.collection', sourceId: 'modelcontextprotocol-servers', sourceGroup: 'access-repo', landingKind: 'catalog', target: 'future peaks mcp catalog', guidance: 'Treat as an unscanned MCP collection; do not auto-install unknown servers.' }),
+    mapping({ capabilityId: 'searchcode-mcp.code-search', sourceId: 'searchcode-mcp', sourceGroup: 'access-repo', landingKind: 'skill', target: 'peaks-rd', skillName: 'peaks-rd', guidance: 'Use for external code discovery only after confirming queries do not expose secrets or private code.' }),
+    mapping({ capabilityId: 'mysql-mcp.database-inspection', sourceId: 'mysql-mcp-server', sourceGroup: 'access-repo', landingKind: 'catalog', target: 'database capability boundary', guidance: 'Database access requires explicit credentials and confirmation before any write query.' }),
+    mapping({ capabilityId: 'figma-context-mcp.design-context', sourceId: 'figma-context-mcp', sourceGroup: 'access-repo', landingKind: 'skill', target: 'peaks-ui', skillName: 'peaks-ui', guidance: 'Use for design-to-code context only with user-authorized Figma access.' }),
+    mapping({ capabilityId: 'everything-claude-code.code-review-agent', sourceId: 'everything-claude-code', sourceGroup: 'mcp-server', landingKind: 'skill', target: 'peaks-rd', skillName: 'peaks-rd', guidance: 'Use as code review capability after local diff and test evidence exist.' }),
+    mapping({ capabilityId: 'everything-claude-code.code-review-guidance', sourceId: 'everything-claude-code', sourceGroup: 'mcp-server', landingKind: 'skill', target: 'peaks-qa', skillName: 'peaks-qa', guidance: 'Use as project-local code review standards guidance during QA preflight.' }),
+    mapping({ capabilityId: 'everything-claude-code.language-standards', sourceId: 'everything-claude-code', sourceGroup: 'mcp-server', landingKind: 'skill', target: 'peaks-rd', skillName: 'peaks-rd', guidance: 'Use as curated language standards source during RD standards preflight.' }),
+    mapping({ capabilityId: 'everything-claude-code.security-review-agent', sourceId: 'everything-claude-code', sourceGroup: 'mcp-server', landingKind: 'skill', target: 'peaks-rd', skillName: 'peaks-rd', guidance: 'Use as security review capability after local diff and test evidence exist.' }),
+    mapping({ capabilityId: 'everything-claude-code.security-review-guidance', sourceId: 'everything-claude-code', sourceGroup: 'mcp-server', landingKind: 'skill', target: 'peaks-qa', skillName: 'peaks-qa', guidance: 'Use as project-local security review standards guidance during QA preflight.' }),
+    mapping({ capabilityId: 'andrej-karpathy-skills.guidance', sourceId: 'andrej-karpathy-skills', sourceGroup: 'mcp-server', landingKind: 'skill', target: 'peaks-rd', skillName: 'peaks-rd', guidance: 'Use as engineering guidance inspiration after project-local standards are scanned.' }),
+    mapping({ capabilityId: 'mattpocock-skills.typescript-guidance', sourceId: 'mattpocock-skills', sourceGroup: 'mcp-server', landingKind: 'skill', target: 'peaks-rd', skillName: 'peaks-rd', guidance: 'Use as TypeScript guidance only when it fits project-local conventions.' }),
+    mapping({ capabilityId: 'impeccable.quality-guidance', sourceId: 'impeccable', sourceGroup: 'mcp-server', landingKind: 'catalog', target: 'quality reference catalog', guidance: 'Use as quality inspiration; Peaks review gates remain authoritative.' }),
+    mapping({ capabilityId: 'vercel-agent-skills.skill-pack', sourceId: 'vercel-agent-skills', sourceGroup: 'mcp-server', landingKind: 'catalog', target: 'external skill catalog', guidance: 'Catalog only until individual skills are inspected and approved.' }),
+    mapping({ capabilityId: 'agent-browser.browser-agent', sourceId: 'agent-browser', sourceGroup: 'mcp-server', landingKind: 'skill', target: 'peaks-qa', skillName: 'peaks-qa', guidance: 'Use for browser validation; never submit forms or mutate authenticated state without explicit permission.' }),
+    mapping({ capabilityId: 'minimax-skills.worker-guidance', sourceId: 'minimax-skills', sourceGroup: 'mcp-server', landingKind: 'cli', target: 'peaks minimax-worker', commandPreview: 'peaks minimax-worker --json', guidance: 'Use Peaks worker command only after reviewing inputs; add --confirm manually when explicit external-provider approval exists.' }),
+    mapping({ capabilityId: 'claude-mem.memory-persistence', sourceId: 'claude-mem', sourceGroup: 'mcp-server', landingKind: 'skill', target: 'peaks-txt', skillName: 'peaks-txt', guidance: 'Use only with explicit durable-memory consent and never store secrets.' }),
+    mapping({ capabilityId: 'shadcn-ui.component-system', sourceId: 'shadcn-ui', sourceGroup: 'mcp-server', landingKind: 'skill', target: 'peaks-ui', skillName: 'peaks-ui', guidance: 'Use as a component-system reference, not as an unreviewed generated UI default.' }),
+    mapping({ capabilityId: 'darwin-skill.external-skill', sourceId: 'darwin-skill', sourceGroup: 'mcp-server', landingKind: 'catalog', target: 'external skill catalog', guidance: 'Catalog only until inspected for project fit and safety.' }),
+    mapping({ capabilityId: 'claude-code-best-practice.workflow-guidance', sourceId: 'claude-code-best-practice', sourceGroup: 'mcp-server', landingKind: 'skill', target: 'peaks-rd', skillName: 'peaks-rd', guidance: 'Use as Claude Code workflow reference while preserving Peaks gates.' }),
+    mapping({ capabilityId: 'openspec.spec-workflow', sourceId: 'openspec', sourceGroup: 'mcp-server', landingKind: 'skill', target: 'peaks-prd', skillName: 'peaks-prd', guidance: 'Use for spec-first product and engineering artifact structure.' }),
+    mapping({ capabilityId: 'gitnexus.repo-intelligence', sourceId: 'gitnexus', sourceGroup: 'mcp-server', landingKind: 'fallback', target: 'future peaks mcp gitnexus proxy', guidance: 'Do not install globally; future use should be proxied through Peaks.' }),
+    mapping({ capabilityId: 'taste-skill.design-critique', sourceId: 'taste-skill', sourceGroup: 'mcp-server', landingKind: 'skill', target: 'peaks-ui', skillName: 'peaks-ui', guidance: 'Use as design critique inspiration, with Peaks UI constraints staying authoritative.' }),
+    mapping({ capabilityId: 'ui-ux-pro-max-skill.design-guidance', sourceId: 'ui-ux-pro-max-skill', sourceGroup: 'mcp-server', landingKind: 'skill', target: 'peaks-ui', skillName: 'peaks-ui', guidance: 'Use as UI/UX guidance after product goals and accessibility constraints are clear.' }),
+    mapping({ capabilityId: 'ruflo-mcp-server.workflow-reference', sourceId: 'ruflo-mcp-server', sourceGroup: 'mcp-server', landingKind: 'catalog', target: 'peaks autonomous planning reference', guidance: 'Use as orchestration inspiration only; Peaks owns execution boundaries.' }),
+    mapping({ capabilityId: 'superpowers.workflow-methodology', sourceId: 'superpowers', sourceGroup: 'mcp-server', landingKind: 'skill', target: 'peaks-prd', skillName: 'peaks-prd', guidance: 'Use as workflow methodology reference for artifact sequencing.' }),
+    mapping({ capabilityId: 'penpot.design-source', sourceId: 'penpot', sourceGroup: 'mcp-server', landingKind: 'skill', target: 'peaks-ui', skillName: 'peaks-ui', guidance: 'Use as design-source context only with user-authorized project access.' }),
+    mapping({ capabilityId: 'gstack.product-stack-guidance', sourceId: 'gstack', sourceGroup: 'mcp-server', landingKind: 'skill', target: 'peaks-prd', skillName: 'peaks-prd', guidance: 'Use as product-stack guidance, not as a substitute for user goals.' }),
+    mapping({ capabilityId: 'awesome-design-md.design-reference', sourceId: 'awesome-design-md', sourceGroup: 'mcp-server', landingKind: 'skill', target: 'peaks-ui', skillName: 'peaks-ui', guidance: 'Use as visual/reference material while preserving product-specific design direction.' }),
+    mapping({ capabilityId: 'anthropic-skills.skill-pack', sourceId: 'anthropic-skills', sourceGroup: 'mcp-server', landingKind: 'catalog', target: 'external skill catalog', guidance: 'Catalog only until individual skills are inspected and approved.' }),
+    mapping({ capabilityId: 'vercel-skills.skill-pack', sourceId: 'vercel-skills', sourceGroup: 'mcp-server', landingKind: 'catalog', target: 'external skill catalog', guidance: 'Catalog only until individual skills are inspected and approved.' }),
+    mapping({ capabilityId: 'reactbits.ui-reference', sourceId: 'reactbits', sourceGroup: 'mcp-server', landingKind: 'skill', target: 'peaks-ui', skillName: 'peaks-ui', guidance: 'Use as UI and motion inspiration after checking license, accessibility, and performance.' }),
+    mapping({ capabilityId: 'azure-skills.cloud-skill-pack', sourceId: 'azure-skills', sourceGroup: 'mcp-server', landingKind: 'catalog', target: 'cloud capability catalog', guidance: 'Cloud actions can affect cost and infrastructure; require explicit confirmation and credentials.' })
+];
+function mapping(input) {
+    return { ...input, dryRunOnly: true };
+}

package/dist/src/services/recommendations/capability-seed-sources.d.ts

@@ -0,0 +1,2 @@
+import type { CapabilitySource } from './recommendation-types.js';
+export declare const seedCapabilitySources: CapabilitySource[];

package/dist/src/services/recommendations/capability-seed-sources.js

@@ -0,0 +1,35 @@
+export const seedCapabilitySources = [
+    { sourceId: 'ruflo-access-repo', sourceType: 'repo', sourceGroup: 'access-repo', title: 'Ruflo', url: 'https://github.com/ruvnet/ruflo', trustSignals: { notes: ['Workflow orchestration reference; do not execute or install from the capability map.'] }, discoveryStatus: 'unscanned', items: ['ruflo-access-repo.workflow-reference'] },
+    { sourceId: 'context7', sourceType: 'repo', sourceGroup: 'access-repo', title: 'Context7', url: 'https://github.com/upstash/context7', trustSignals: { sourceReputation: 'commonly used docs lookup MCP capability' }, discoveryStatus: 'indexed', items: ['context7.docs-lookup'] },
+    { sourceId: 'playwright-mcp', sourceType: 'repo', sourceGroup: 'access-repo', title: 'Playwright MCP', url: 'https://github.com/microsoft/playwright-mcp', trustSignals: { sourceReputation: 'Microsoft browser automation MCP server' }, discoveryStatus: 'indexed', items: ['playwright-mcp.browser-validation'] },
+    { sourceId: 'chrome-devtools-mcp', sourceType: 'website', sourceGroup: 'access-repo', title: 'Chrome DevTools MCP', url: 'https://www.pulsemcp.com/servers/chrome-devtools', trustSignals: { notes: ['Browser inspection and performance debugging capability.'] }, discoveryStatus: 'indexed', items: ['chrome-devtools-mcp.browser-debug'] },
+    { sourceId: 'context-mode', sourceType: 'repo', sourceGroup: 'access-repo', title: 'Context Mode', url: 'https://github.com/mksglu/context-mode', trustSignals: { notes: ['Context and memory management reference.'] }, discoveryStatus: 'indexed', items: ['context-mode.context-management'] },
+    { sourceId: 'modelcontextprotocol-servers', sourceType: 'mcp-collection', sourceGroup: 'access-repo', title: 'Model Context Protocol Servers', url: 'https://github.com/modelcontextprotocol/servers', trustSignals: { sourceReputation: 'official MCP server collection' }, discoveryStatus: 'unscanned', items: ['modelcontextprotocol-servers.collection'] },
+    { sourceId: 'searchcode-mcp', sourceType: 'website', sourceGroup: 'access-repo', title: 'SearchCode MCP', url: 'https://www.pulsemcp.com/servers/searchcode', trustSignals: { notes: ['External code search capability; avoid sending secrets or private snippets without approval.'] }, discoveryStatus: 'indexed', items: ['searchcode-mcp.code-search'] },
+    { sourceId: 'mysql-mcp-server', sourceType: 'repo', sourceGroup: 'access-repo', title: 'MySQL MCP Server', url: 'https://github.com/designcomputer/mysql_mcp_server', trustSignals: { notes: ['Database access requires explicit credentials and write-query confirmation.'] }, discoveryStatus: 'indexed', items: ['mysql-mcp.database-inspection'] },
+    { sourceId: 'figma-context-mcp', sourceType: 'repo', sourceGroup: 'access-repo', title: 'Figma Context MCP', url: 'https://github.com/glips/figma-context-mcp', trustSignals: { notes: ['Design context extraction requires explicit user-authorized design access.'] }, discoveryStatus: 'indexed', items: ['figma-context-mcp.design-context'] },
+    { sourceId: 'everything-claude-code', sourceType: 'repo', sourceGroup: 'mcp-server', title: 'everything-claude-code', url: 'https://github.com/affaan-m/everything-claude-code', trustSignals: { sourceReputation: 'hackathon-winning Claude Code resource collection', notes: ['Treat as a source bundle; deep indexing is required before broad automatic use.'] }, discoveryStatus: 'indexed', items: ['everything-claude-code.code-review-agent', 'everything-claude-code.code-review-guidance', 'everything-claude-code.language-standards', 'everything-claude-code.security-review-agent', 'everything-claude-code.security-review-guidance'] },
+    { sourceId: 'andrej-karpathy-skills', sourceType: 'skills-package', sourceGroup: 'mcp-server', title: 'andrej-karpathy-skills', url: 'https://github.com/multica-ai/andrej-karpathy-skills', discoveryStatus: 'unscanned', items: ['andrej-karpathy-skills.guidance'] },
+    { sourceId: 'mattpocock-skills', sourceType: 'skills-package', sourceGroup: 'mcp-server', title: 'mattpocock/skills', url: 'https://github.com/mattpocock/skills', discoveryStatus: 'unscanned', items: ['mattpocock-skills.typescript-guidance'] },
+    { sourceId: 'impeccable', sourceType: 'repo', sourceGroup: 'mcp-server', title: 'impeccable', url: 'https://github.com/pbakaus/impeccable', discoveryStatus: 'unscanned', items: ['impeccable.quality-guidance'] },
+    { sourceId: 'vercel-agent-skills', sourceType: 'skills-package', sourceGroup: 'mcp-server', title: 'Vercel Agent Skills', url: 'https://github.com/vercel-labs/agent-skills', discoveryStatus: 'unscanned', items: ['vercel-agent-skills.skill-pack'] },
+    { sourceId: 'agent-browser', sourceType: 'repo', sourceGroup: 'mcp-server', title: 'Agent Browser', url: 'https://github.com/vercel-labs/agent-browser', discoveryStatus: 'indexed', items: ['agent-browser.browser-agent'] },
+    { sourceId: 'minimax-skills', sourceType: 'skills-package', sourceGroup: 'mcp-server', title: 'MiniMax Skills', url: 'https://github.com/MiniMax-AI/skills', discoveryStatus: 'indexed', items: ['minimax-skills.worker-guidance'] },
+    { sourceId: 'claude-mem', sourceType: 'repo', sourceGroup: 'mcp-server', title: 'claude-mem', url: 'https://github.com/thedotmack/claude-mem', discoveryStatus: 'indexed', items: ['claude-mem.memory-persistence'] },
+    { sourceId: 'shadcn-ui', sourceType: 'repo', sourceGroup: 'mcp-server', title: 'shadcn/ui', url: 'https://github.com/shadcn-ui/ui', discoveryStatus: 'indexed', items: ['shadcn-ui.component-system'] },
+    { sourceId: 'darwin-skill', sourceType: 'skills-package', sourceGroup: 'mcp-server', title: 'darwin-skill', url: 'https://github.com/alchaincyf/darwin-skill', discoveryStatus: 'unscanned', items: ['darwin-skill.external-skill'] },
+    { sourceId: 'claude-code-best-practice', sourceType: 'repo', sourceGroup: 'mcp-server', title: 'Claude Code Best Practice', url: 'https://github.com/shanraisshan/claude-code-best-practice', discoveryStatus: 'indexed', items: ['claude-code-best-practice.workflow-guidance'] },
+    { sourceId: 'openspec', sourceType: 'repo', sourceGroup: 'mcp-server', title: 'OpenSpec', url: 'https://github.com/Fission-AI/OpenSpec', discoveryStatus: 'indexed', items: ['openspec.spec-workflow'] },
+    { sourceId: 'gitnexus', sourceType: 'repo', sourceGroup: 'mcp-server', title: 'GitNexus', url: 'https://github.com/abhigyanpatwari/GitNexus', discoveryStatus: 'unscanned', items: ['gitnexus.repo-intelligence'] },
+    { sourceId: 'taste-skill', sourceType: 'skills-package', sourceGroup: 'mcp-server', title: 'taste-skill', url: 'https://github.com/Leonxlnx/taste-skill', discoveryStatus: 'unscanned', items: ['taste-skill.design-critique'] },
+    { sourceId: 'ui-ux-pro-max-skill', sourceType: 'skills-package', sourceGroup: 'mcp-server', title: 'ui-ux-pro-max-skill', url: 'https://github.com/nextlevelbuilder/ui-ux-pro-max-skill', discoveryStatus: 'unscanned', items: ['ui-ux-pro-max-skill.design-guidance'] },
+    { sourceId: 'ruflo-mcp-server', sourceType: 'repo', sourceGroup: 'mcp-server', title: 'Ruflo', url: 'https://github.com/ruvnet/ruflo', discoveryStatus: 'unscanned', items: ['ruflo-mcp-server.workflow-reference'] },
+    { sourceId: 'superpowers', sourceType: 'repo', sourceGroup: 'mcp-server', title: 'Superpowers', url: 'https://github.com/obra/superpowers', discoveryStatus: 'indexed', items: ['superpowers.workflow-methodology'] },
+    { sourceId: 'penpot', sourceType: 'repo', sourceGroup: 'mcp-server', title: 'Penpot', url: 'https://github.com/penpot/penpot', discoveryStatus: 'indexed', items: ['penpot.design-source'] },
+    { sourceId: 'gstack', sourceType: 'repo', sourceGroup: 'mcp-server', title: 'gstack', url: 'https://github.com/garrytan/gstack', discoveryStatus: 'indexed', items: ['gstack.product-stack-guidance'] },
+    { sourceId: 'awesome-design-md', sourceType: 'repo', sourceGroup: 'mcp-server', title: 'awesome-design-md', url: 'https://github.com/VoltAgent/awesome-design-md', discoveryStatus: 'indexed', items: ['awesome-design-md.design-reference'] },
+    { sourceId: 'anthropic-skills', sourceType: 'skills-package', sourceGroup: 'mcp-server', title: 'Anthropic Skills', url: 'https://github.com/anthropics/skills', discoveryStatus: 'unscanned', items: ['anthropic-skills.skill-pack'] },
+    { sourceId: 'vercel-skills', sourceType: 'skills-package', sourceGroup: 'mcp-server', title: 'Vercel Skills', url: 'https://github.com/vercel-labs/skills', discoveryStatus: 'unscanned', items: ['vercel-skills.skill-pack'] },
+    { sourceId: 'reactbits', sourceType: 'website', sourceGroup: 'mcp-server', title: 'React Bits', url: 'https://reactbits.dev/', discoveryStatus: 'indexed', items: ['reactbits.ui-reference'] },
+    { sourceId: 'azure-skills', sourceType: 'skills-package', sourceGroup: 'mcp-server', title: 'Azure Skills', url: 'https://github.com/microsoft/azure-skills', trustSignals: { notes: ['Cloud operations require explicit user confirmation and credential boundaries.'] }, discoveryStatus: 'unscanned', items: ['azure-skills.cloud-skill-pack'] }
+];

package/dist/src/services/recommendations/recommendation-service.d.ts

@@ -0,0 +1,8 @@
+import type { RecommendationPlan } from './recommendation-types.js';
+export type RecommendationWorkflow = 'code-refactor' | 'product-refactor' | 'frontend-design';
+export type CreateRecommendationPlanOptions = {
+    workflow: RecommendationWorkflow;
+    language?: string;
+    installedCapabilityIds?: string[];
+};
+export declare function createRecommendationPlan(options: CreateRecommendationPlanOptions): RecommendationPlan;

package/dist/src/services/recommendations/recommendation-service.js

@@ -0,0 +1,106 @@
+import { resolveCapabilityAvailability } from './capability-availability.js';
+import { seedCapabilityItems } from './seed-capability-catalog.js';
+function getWorkflowItems(workflow) {
+    return seedCapabilityItems.filter((item) => item.workflows.includes(workflow));
+}
+function localize(language, zh, en) {
+    return language.startsWith('zh') ? zh : en;
+}
+function getWorkflowSummary(workflow, language) {
+    if (workflow === 'code-refactor') {
+        return localize(language, '建议先为代码重构准备代码评审和文档查询能力；缺失能力会以 fallback 方式显式展示。', 'Prepare code review and documentation lookup capabilities for code refactor; missing capabilities are shown with explicit fallbacks.');
+    }
+    if (workflow === 'product-refactor') {
+        return localize(language, '建议先围绕产品理解成本、交互路径和验收标准生成推荐计划。', 'Prepare a recommendation plan around product comprehension cost, interaction flow, and acceptance criteria.');
+    }
+    return localize(language, '建议先准备前端设计、浏览器验证和文档查询能力。', 'Prepare frontend design, browser validation, and documentation lookup capabilities.');
+}
+function getPreferredCapabilityId(workflow) {
+    if (workflow === 'code-refactor') {
+        return 'everything-claude-code.code-review-agent';
+    }
+    return 'context7.docs-lookup';
+}
+function toFallbackActionId(capabilityId) {
+    return `use-fallback-${capabilityId.replaceAll('.', '-')}`;
+}
+function getNextActions(workflow, availability) {
+    const preferredCapabilityId = getPreferredCapabilityId(workflow);
+    const preferredAvailability = availability.find((item) => item.capabilityId === preferredCapabilityId);
+    const fallbackActions = availability
+        .filter((item) => item.status !== 'available')
+        .map((item) => ({
+        id: toFallbackActionId(item.capabilityId),
+        type: 'use-fallback',
+        capabilityId: item.capabilityId,
+        requiresApproval: true,
+        riskLevel: item.risk
+    }));
+    if (preferredAvailability?.status !== 'available') {
+        return fallbackActions;
+    }
+    const invokeAction = workflow === 'code-refactor'
+        ? {
+            id: 'run-code-review',
+            type: 'invoke-capability',
+            capabilityId: preferredCapabilityId,
+            requiresApproval: false,
+            riskLevel: preferredAvailability.risk
+        }
+        : {
+            id: 'lookup-docs',
+            type: 'invoke-capability',
+            capabilityId: preferredCapabilityId,
+            requiresApproval: false,
+            riskLevel: preferredAvailability.risk
+        };
+    return [...fallbackActions, invokeAction];
+}
+export function createRecommendationPlan(options) {
+    const language = options.language ?? 'en';
+    const workflowItems = getWorkflowItems(options.workflow);
+    const availabilityOptions = options.installedCapabilityIds
+        ? { installedCapabilityIds: options.installedCapabilityIds }
+        : {};
+    const availability = resolveCapabilityAvailability(workflowItems, availabilityOptions);
+    const missingCapabilities = availability.filter((item) => item.status !== 'available');
+    const requiredCapabilities = workflowItems.map((item) => item.capabilityId);
+    const recommendedOption = {
+        id: 'recommended-foundation-route',
+        label: 'foundation-route',
+        why: 'Use available capabilities and expose missing ones before execution.',
+        requiredCapabilities,
+        ...(missingCapabilities.length > 0 ? { fallbackPath: 'explicit-fallback' } : {})
+    };
+    return {
+        intent: options.workflow,
+        workflow: options.workflow,
+        profile: 'solo-guided-auto',
+        audience: ['engineer'],
+        options: [recommendedOption],
+        requiredCapabilities,
+        availability,
+        fallbacks: missingCapabilities.map((item) => item.fallback),
+        decisionRequired: missingCapabilities.length > 0,
+        machine: {
+            nextActions: getNextActions(options.workflow, availability),
+            constraints: ['do-not-install-capabilities', 'do-not-mutate-remote-state'],
+            stopConditions: ['missing-required-capability-without-fallback']
+        },
+        presentation: {
+            language,
+            summary: getWorkflowSummary(options.workflow, language),
+            options: [
+                {
+                    id: 'recommended-foundation-route',
+                    label: localize(language, '使用推荐基础路线', 'Use recommended foundation route'),
+                    why: localize(language, '先检查能力是否可用，再决定执行或降级，避免模型发散。', 'Check capability availability before execution or fallback to avoid model drift.')
+                }
+            ],
+            warnings: missingCapabilities.map((item) => localize(language, `缺少能力：${item.capabilityId}，将使用 fallback。`, `Missing capability: ${item.capabilityId}; fallback will be used.`)),
+            explanations: [
+                localize(language, '机器层保持稳定英文契约，给人看的摘要跟随当前语言。', 'The machine layer keeps stable English contracts while human summaries follow the selected language.')
+            ]
+        }
+    };
+}

package/dist/src/services/recommendations/recommendation-types.d.ts

@@ -0,0 +1,129 @@
+export type CapabilitySourceType = 'repo' | 'skills-package' | 'mcp-collection' | 'website' | 'local-install';
+export type CapabilityItemType = 'skill' | 'agent' | 'mcp' | 'rule' | 'hook' | 'template' | 'workflow' | 'doc' | 'cli';
+export type CapabilityAvailabilityStatus = 'available' | 'installable' | 'disabled' | 'unknown';
+export type RiskLevel = 'low' | 'medium' | 'high';
+export type CapabilitySourceGroup = 'access-repo' | 'mcp-server';
+export type CapabilityLandingKind = 'cli' | 'skill' | 'catalog' | 'fallback';
+export type CapabilityMapSourceFilter = CapabilitySourceGroup | 'all';
+export type LocalizedText = Record<string, string>;
+export type CapabilityFallback = {
+    mode: string;
+    qualityImpact: string;
+    nextAction?: string;
+};
+export type CapabilitySource = {
+    sourceId: string;
+    sourceType: CapabilitySourceType;
+    sourceGroup?: CapabilitySourceGroup;
+    title: string;
+    url: string;
+    trustSignals?: {
+        sourceReputation?: string;
+        stars?: number;
+        installs?: number;
+        maintainer?: string;
+        notes?: string[];
+    };
+    discoveryStatus: 'unscanned' | 'indexed' | 'verified' | 'deprecated';
+    items: string[];
+};
+export type CapabilityItem = {
+    capabilityId: string;
+    sourceId: string;
+    name: string;
+    itemType: CapabilityItemType;
+    category: string;
+    workflows: string[];
+    audience: string[];
+    riskLevel: RiskLevel;
+    inputContract?: string;
+    outputContract?: string;
+    fallback: CapabilityFallback;
+    presentation: {
+        displayName: LocalizedText;
+        description: LocalizedText;
+    };
+};
+export type CapabilityAvailability = {
+    capabilityId: string;
+    type: 'skill' | 'mcp' | 'cli' | 'agent' | 'profile';
+    status: CapabilityAvailabilityStatus;
+    requiredFor: string[];
+    installPlan?: {
+        available: boolean;
+        commandPreview?: string;
+        requiresApproval: boolean;
+    };
+    fallback: CapabilityFallback;
+    risk: RiskLevel;
+};
+export type CapabilityLandingMapping = {
+    capabilityId: string;
+    sourceId: string;
+    sourceGroup: CapabilitySourceGroup;
+    landingKind: CapabilityLandingKind;
+    target: string;
+    commandPreview?: string;
+    skillName?: string;
+    guidance: string;
+    dryRunOnly: boolean;
+};
+export type CapabilityMapPlan = {
+    dryRunOnly: true;
+    executionPolicy: {
+        allowInstall: false;
+        allowClone: false;
+        allowConfigWrite: false;
+        allowSecretExfiltration: false;
+    };
+    proxyPolicy?: {
+        requiredForExternalAccess: true;
+        httpProxy: string;
+    };
+    sources: CapabilitySource[];
+    items: CapabilityItem[];
+    mappings: CapabilityLandingMapping[];
+    availability: CapabilityAvailability[];
+    constraints: string[];
+    warnings: string[];
+};
+export type RecommendationOption = {
+    id: string;
+    label: string;
+    why: string;
+    requiredCapabilities: string[];
+    fallbackPath?: string;
+};
+export type RecommendationPlan = {
+    intent: string;
+    workflow: string;
+    profile: string;
+    audience: string[];
+    options: RecommendationOption[];
+    requiredCapabilities: string[];
+    availability: CapabilityAvailability[];
+    fallbacks: CapabilityFallback[];
+    decisionRequired: boolean;
+    machine: {
+        nextActions: Array<{
+            id: string;
+            type: 'invoke-capability' | 'use-fallback';
+            capabilityId?: string;
+            requiresApproval: boolean;
+            riskLevel: RiskLevel;
+        }>;
+        constraints: string[];
+        stopConditions: string[];
+    };
+    presentation: {
+        language: string;
+        summary: string;
+        options: Array<{
+            id: string;
+            label: string;
+            why: string;
+        }>;
+        warnings: string[];
+        explanations: string[];
+    };
+};

package/dist/src/services/recommendations/recommendation-types.js

@@ -0,0 +1 @@
+export {};

package/dist/src/services/recommendations/seed-capability-catalog.d.ts

@@ -0,0 +1,3 @@
+export { seedCapabilityItems } from './capability-seed-items.js';
+export { seedCapabilityLandingMappings } from './capability-seed-mappings.js';
+export { seedCapabilitySources } from './capability-seed-sources.js';

package/dist/src/services/recommendations/seed-capability-catalog.js

@@ -0,0 +1,3 @@
+export { seedCapabilityItems } from './capability-seed-items.js';
+export { seedCapabilityLandingMappings } from './capability-seed-mappings.js';
+export { seedCapabilitySources } from './capability-seed-sources.js';

package/dist/src/services/refactor/refactor-service.d.ts

@@ -0,0 +1,9 @@
+export type RefactorMode = 'solo' | 'rd';
+export type RefactorDryRun = {
+    mode: RefactorMode;
+    implementationAllowed: false;
+    hardGates: string[];
+    requiredArtifacts: string[];
+    nextActions: string[];
+};
+export declare function createRefactorDryRun(mode: RefactorMode): RefactorDryRun;

package/dist/src/services/refactor/refactor-service.js

@@ -0,0 +1,33 @@
+export function createRefactorDryRun(mode) {
+    return {
+        mode,
+        implementationAllowed: false,
+        hardGates: [
+            'Understand the project before changes',
+            'Prefer existing project standards over Peaks built-ins',
+            'Require UT coverage >= 95%',
+            'Treat missing, unknown, or unverifiable coverage as failing',
+            'Coverage success only allows analysis and spec generation',
+            'Split broad refactors into minimal functional slices',
+            'Generate strict verifiable spec before each slice',
+            'Require peaks-prd and peaks-qa artifacts even for direct peaks-rd refactor',
+            'Require 100% acceptance for each slice',
+            'Commit code and intermediate artifacts before the next slice'
+        ],
+        requiredArtifacts: [
+            'project-scan.md',
+            'coverage-report.md',
+            'feature-slice-map.md',
+            'slice-spec.md',
+            'acceptance-spec.md',
+            'validation-report.md',
+            'artifact-retention-report.md',
+            'commit-required.md'
+        ],
+        nextActions: [
+            'Run doctor checks',
+            'Initialize or link the remote artifact repository',
+            'Generate the first refactor slice spec before implementation'
+        ]
+    };
+}

package/dist/src/services/sc/index.d.ts

@@ -0,0 +1 @@
+export * from './sc-service.js';

package/dist/src/services/sc/index.js

@@ -0,0 +1 @@
+export * from './sc-service.js';