peaks-loop 4.0.54 → 4.1.1

package/dist/services/recommendations/capability-seed-sources-mcp-server.js

@@ -0,0 +1,233 @@
+/**
+ * Tail slice of `seedCapabilitySources` — the `sourceGroup: 'mcp-server'`
+ * entries — hoisted VERBATIM out of `capability-seed-sources.ts` for the
+ * 300-line cap (C-family wave 4, leaf c4w1-artifacts). No element was
+ * rewritten; the parent composes `[<head>, ...this]` so the exported array
+ * stays element-for-element identical in the original order.
+ */
+export const capabilitySeedMcpServerSources = [
+    {
+        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',
+        trustSignals: {
+            notes: [
+                'Catalog/reference only; do not vendor, install, or execute upstream skills from the capability map.',
+                'Inspect upstream skill content before applying any method and never persist sensitive upstream examples.'
+            ]
+        },
+        discoveryStatus: 'indexed',
+        items: [
+            'mattpocock-skills.product-prd-methods',
+            'mattpocock-skills.engineering-diagnosis',
+            'mattpocock-skills.tdd-method',
+            'mattpocock-skills.qa-triage',
+            'mattpocock-skills.handoff-context',
+            'mattpocock-skills.git-guardrails'
+        ]
+    },
+    {
+        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: '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: '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/services/recommendations/capability-seed-sources.js

@@ -1,34 +1,129 @@
+import { capabilitySeedMcpServerSources } from './capability-seed-sources-mcp-server.js';
 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: 'codegraph', sourceType: 'repo', sourceGroup: 'access-repo', title: 'codegraph', url: 'https://github.com/colbymchenry/codegraph', trustSignals: { notes: ['Use through peaks codegraph only; do not run upstream install flows from the capability map.', 'Local project indexing can create .codegraph artifacts; do not commit generated databases unless explicitly requested.'] }, discoveryStatus: 'indexed', items: ['codegraph.project-indexing', 'codegraph.semantic-query', 'codegraph.impact-analysis', 'codegraph.context-pack'] },
-    { 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', trustSignals: { notes: ['Catalog/reference only; do not vendor, install, or execute upstream skills from the capability map.', 'Inspect upstream skill content before applying any method and never persist sensitive upstream examples.'] }, discoveryStatus: 'indexed', items: ['mattpocock-skills.product-prd-methods', 'mattpocock-skills.engineering-diagnosis', 'mattpocock-skills.tdd-method', 'mattpocock-skills.qa-triage', 'mattpocock-skills.handoff-context', 'mattpocock-skills.git-guardrails'] },
-    { 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: '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: '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'] }
+    {
+        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: 'codegraph',
+        sourceType: 'repo',
+        sourceGroup: 'access-repo',
+        title: 'codegraph',
+        url: 'https://github.com/colbymchenry/codegraph',
+        trustSignals: {
+            notes: [
+                'Use through peaks codegraph only; do not run upstream install flows from the capability map.',
+                'Local project indexing can create .codegraph artifacts; do not commit generated databases unless explicitly requested.'
+            ]
+        },
+        discoveryStatus: 'indexed',
+        items: [
+            'codegraph.project-indexing',
+            'codegraph.semantic-query',
+            'codegraph.impact-analysis',
+            'codegraph.context-pack'
+        ]
+    },
+    {
+        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']
+    },
+    // Tail slice (the sourceGroup 'mcp-server' entries, original order preserved)
+    // hoisted VERBATIM to ./capability-seed-sources-mcp-server.js for the 300-line
+    // cap — compose here so seedCapabilitySources stays element-for-element equal.
+    ...capabilitySeedMcpServerSources
 ];

package/dist/services/recommendations/installed-capability-detector.d.ts

@@ -9,9 +9,9 @@
  * the question from evidence that already exists on disk — no install
  * side effect, no network, no subprocess:
  *
- *   - `everything-claude-code.*` — satisfied when the ECC cache is
- *     populated (`~/.peaks/cache/ecc-installed.json` + at least one
- *     cached/materialized agent).
+ *   - `everything-claude-code.*` — satisfied when the ECC agents are readable,
+ *     i.e. `~/.peaks/agents/ecc/` holds at least one agent (landed by
+ *     `peaks ecc install` from the `ecc-universal` dependency).
  *   - a source that maps to an npm package — satisfied when that package
  *     (or its `.bin` shim) is present in the project's `node_modules`.
  *
@@ -23,8 +23,8 @@ export type InstalledCapabilityProbe = {
     readonly projectRoot: string;
     /** Override for tests; defaults to `<projectRoot>/node_modules`. */
     readonly nodeModulesDir?: string;
-    /** Override for tests; defaults to a live ECC cache probe. */
-    readonly eccCacheAvailable?: boolean;
+    /** Override for tests; defaults to a live probe of the materialized copy. */
+    readonly eccAgentsAvailable?: boolean;
 };
 /**
  * Return the capabilityIds whose acquisition is already satisfied.

package/dist/services/recommendations/installed-capability-detector.js

@@ -9,9 +9,9 @@
  * the question from evidence that already exists on disk — no install
  * side effect, no network, no subprocess:
  *
- *   - `everything-claude-code.*` — satisfied when the ECC cache is
- *     populated (`~/.peaks/cache/ecc-installed.json` + at least one
- *     cached/materialized agent).
+ *   - `everything-claude-code.*` — satisfied when the ECC agents are readable,
+ *     i.e. `~/.peaks/agents/ecc/` holds at least one agent (landed by
+ *     `peaks ecc install` from the `ecc-universal` dependency).
  *   - a source that maps to an npm package — satisfied when that package
  *     (or its `.bin` shim) is present in the project's `node_modules`.
  *
@@ -20,7 +20,7 @@
  */
 import { existsSync } from 'node:fs';
 import { join } from 'node:path';
-import { hasMaterializedEccAgents, listCachedAgents } from 'peaks-loop-mut';
+import { hasMaterializedEccAgents } from 'peaks-loop-mut';
 import { seedCapabilityItems } from './capability-seed-items.js';
 const ECC_SOURCE_ID = 'everything-claude-code';
 /**
@@ -42,12 +42,13 @@ function packagePresent(nodeModulesDir, packageName) {
         return false;
     }
 }
-function eccCacheAvailable() {
+function eccAgentsAvailable() {
     try {
-        // Cached agents imply the manifest + sha dir exist; the materialized
-        // plugin-free copy is checked independently so a hand-populated
-        // `~/.peaks/agents/ecc/` still counts as satisfied.
-        return listCachedAgents().length > 0 || hasMaterializedEccAgents();
+        // The materialized copy is what the LLM can dispatch, so it is the only
+        // evidence that counts. The cache probe this replaced
+        // (`listCachedAgents()`, reading `~/.peaks/cache/ecc-<sha>/`) described
+        // something downloaded but not necessarily usable.
+        return hasMaterializedEccAgents();
     }
     catch {
         return false;
@@ -59,7 +60,7 @@ function eccCacheAvailable() {
  */
 export function detectInstalledCapabilityIds(probe) {
     const nodeModulesDir = probe.nodeModulesDir ?? join(probe.projectRoot, 'node_modules');
-    const eccAvailable = probe.eccCacheAvailable ?? eccCacheAvailable();
+    const eccAvailable = probe.eccAgentsAvailable ?? eccAgentsAvailable();
     const installed = new Set();
     for (const item of seedCapabilityItems) {
         if (item.sourceId === ECC_SOURCE_ID) {

package/dist/services/release/release-state.d.ts

@@ -8,7 +8,7 @@
  *
  * Persistence: `.peaks/release-state.json` in the project root.
  */
-export type ReleaseStage = 'planned' | 'canary-10' | 'canary-50' | 'promoted' | 'watching' | 'done' | 'rolled-back' | 'hotfixed';
+export type ReleaseStage = 'planned' | 'canary-10' | 'canary-50' | 'promoted' | 'watching' | 'done' | 'rolled-back';
 export declare function isValidStageTransition(from: ReleaseStage, to: ReleaseStage): boolean;
 export declare function isReleaseStage(value: string): value is ReleaseStage;
 export interface ReleaseRecord {
@@ -27,7 +27,7 @@ export interface ReleaseState {
     readonly version: 1;
     /** Active release (the one being canary'd / watched). */
     readonly active: ReleaseRecord | null;
-    /** History of completed / rolled-back / hotfixed releases. */
+    /** History of completed / rolled-back releases. */
     readonly history: readonly ReleaseRecord[];
 }
 export declare const EMPTY_RELEASE_STATE: ReleaseState;

package/dist/services/release/release-state.js

@@ -10,19 +10,37 @@
  */
 import { existsSync, readFileSync, writeFileSync, mkdirSync } from 'node:fs';
 import { dirname, resolve } from 'node:path';
-/** Valid stage transitions. */
+/**
+ * Valid stage transitions.
+ *
+ * There is deliberately no `'hotfixed'` stage. A hotfix is a *launch mode* of
+ * the normal pipeline, not a place a release sits: `hotfixRelease` rolls the
+ * old release back into history and starts the hotfix version at `canary-10`,
+ * which then walks canary-10 → canary-50 → promoted → done like any other
+ * release. The old `'hotfixed'` stage was declared here but no command ever
+ * entered it, and it could not have worked: its only out-edges were
+ * `watching`/`rolled-back`, so a release parked there could never reach
+ * `canary-50` or `promoted` — hence never `promotedAt`, never a completed
+ * watch window, never `done`.
+ */
 const VALID_TRANSITIONS = {
-    'planned': ['canary-10', 'rolled-back'],
+    planned: ['canary-10', 'rolled-back'],
     'canary-10': ['canary-50', 'rolled-back'],
     'canary-50': ['promoted', 'rolled-back'],
-    'promoted': ['watching', 'rolled-back'],
-    'watching': ['done', 'rolled-back', 'hotfixed'],
-    'done': [],
-    'rolled-back': ['hotfixed', 'planned'],
-    'hotfixed': ['watching', 'rolled-back']
+    // 'watching' is the declared intermediate but is unreachable in practice
+    // (no command transitions into it), so 'done' is reachable from 'promoted'.
+    promoted: ['watching', 'done', 'rolled-back'],
+    watching: ['done', 'rolled-back'],
+    done: [],
+    'rolled-back': ['planned']
 };
 export function isValidStageTransition(from, to) {
-    return VALID_TRANSITIONS[from].includes(to);
+    // `from` is typed, but it is read out of `.peaks/release-state.json`, which
+    // nothing validates (`readReleaseState` casts the parsed JSON). A state file
+    // written by an older peaks-loop may name a stage this table no longer has
+    // (e.g. the dropped 'hotfixed'), so an unknown source must read as "no such
+    // transition" rather than crash the CLI out of the lookup.
+    return (VALID_TRANSITIONS[from] ?? []).includes(to);
 }
 export function isReleaseStage(value) {
     return Object.prototype.hasOwnProperty.call(VALID_TRANSITIONS, value);
@@ -75,15 +93,18 @@ export function transitionRelease(state, to, note, now = new Date()) {
         return { error: 'no active release' };
     const from = state.active.currentStage;
     if (!isValidStageTransition(from, to)) {
-        return { error: `invalid transition: ${from} → ${to} (allowed from ${from}: ${VALID_TRANSITIONS[from].join(', ') || 'none'})` };
+        return {
+            error: `invalid transition: ${from} → ${to} (allowed from ${from}: ${VALID_TRANSITIONS[from].join(', ') || 'none'})`
+        };
     }
-    const stageHistory = [...state.active.stageHistory, { stage: to, at: now.toISOString(), ...(note !== undefined ? { note } : {}) }];
+    const stageHistory = [
+        ...state.active.stageHistory,
+        { stage: to, at: now.toISOString(), ...(note !== undefined ? { note } : {}) }
+    ];
     const promoted = to === 'promoted'
         ? { ...state.active, currentStage: to, stageHistory, promotedAt: now.toISOString() }
         : { ...state.active, currentStage: to, stageHistory };
-    const done = to === 'done'
-        ? { ...promoted, doneAt: now.toISOString() }
-        : promoted;
+    const done = to === 'done' ? { ...promoted, doneAt: now.toISOString() } : promoted;
     return { state: { ...state, active: done } };
 }
 /** Roll back the active release and move it to history. */
@@ -94,7 +115,11 @@ export function rollbackRelease(state, note, now = new Date()) {
     if (!isValidStageTransition(from, 'rolled-back')) {
         return { error: `cannot rollback from ${from}` };
     }
-    const newEntry = { stage: 'rolled-back', at: now.toISOString(), ...(note !== undefined ? { note } : {}) };
+    const newEntry = {
+        stage: 'rolled-back',
+        at: now.toISOString(),
+        ...(note !== undefined ? { note } : {})
+    };
     const stageHistory = [...state.active.stageHistory, newEntry];
     const record = { ...state.active, currentStage: 'rolled-back', stageHistory };
     return { state: { version: 1, active: null, history: [...state.history, record] }, record };
@@ -120,7 +145,11 @@ export function hotfixRelease(state, hotfixVersion, note, now = new Date()) {
         ],
         createdAt: now.toISOString()
     };
-    return { state: { ...currentState, active: record }, record, ...(priorRecord !== null ? { rolledBack: priorRecord } : {}) };
+    return {
+        state: { ...currentState, active: record },
+        record,
+        ...(priorRecord !== null ? { rolledBack: priorRecord } : {})
+    };
 }
 /** Compute the watch window. */
 export function watchWindow(record, now = new Date()) {

package/dist/services/release/version-precheck-layer-changeset.d.ts

@@ -0,0 +1,2 @@
+import type { LayerResult, PrecheckOptions } from './version-precheck-support.js';
+export declare function runChangesetStaged(opts: PrecheckOptions): LayerResult;

package/dist/services/release/version-precheck-layer-changeset.js

@@ -0,0 +1,43 @@
+// src/services/release/version-precheck-layer-changeset.ts
+//
+// Wave-5 class-A hoist (rid 2026-10-01-wave5-w5-3-compact-release): Layer C
+// (`runChangesetStaged`) moved VERBATIM out of `version-precheck-service.ts`
+// (:285-320 at the split) for the 300-raw-line cap. The parent re-exports it
+// so './version-precheck-service.js' keeps the public name.
+import { readdirSync } from 'node:fs';
+import { join } from 'node:path';
+// ---------------------------------------------------------------------------
+// Layer C — changesetStaged (mirrors publish.yml gate-changeset step)
+// ---------------------------------------------------------------------------
+export function runChangesetStaged(opts) {
+    const changesetDir = join(opts.projectRoot, '.changeset');
+    let files = [];
+    try {
+        files = readdirSync(changesetDir);
+    }
+    catch {
+        return {
+            status: 'ok',
+            message: '.changeset/ directory is absent — no changeset is staged',
+            remediation: '',
+            observed: { stagedFiles: [] }
+        };
+    }
+    const staged = files.filter((f) => f.endsWith('.md') && f !== 'README.md');
+    if (staged.length === 0) {
+        return {
+            status: 'ok',
+            message: '.changeset/ has no staged *.md files',
+            remediation: '',
+            observed: { stagedFiles: [] }
+        };
+    }
+    return {
+        status: 'warning',
+        message: `.changeset/ has ${staged.length} staged change(s): ${staged.join(', ')}`,
+        remediation: 'publish.yml gate-changeset will BLOCK publish with these staged files. ' +
+            'Either: (a) run `peaks changeset publish` to drain the staged changesets, ' +
+            '(b) move them out of .changeset/, or (c) re-run with --strict to enforce blocker exit here.',
+        observed: { stagedFiles: staged }
+    };
+}