@harness-engineering/cli 1.25.7 → 1.26.1

package/dist/{chunk-JJQ3TW2E.js → chunk-2BPPS6YQ.js}

@@ -1,7 +1,7 @@
 import {
   assessProjectDefinition,
   handleAssessProject
-} from "./chunk-XVJRFP7W.js";
+} from "./chunk-K56DTX7G.js";
 import {
   getBusinessKnowledgeResource
 } from "./chunk-RC5ZY3EV.js";
@@ -12,37 +12,37 @@ import {
   handleCreateSelfReview,
   handleRequestPeerReview,
   requestPeerReviewDefinition
-} from "./chunk-GVNT2YC7.js";
+} from "./chunk-WZ7UHPT3.js";
 import {
   getSecurityTrendsDefinition,
   handleGetSecurityTrends,
   handleRunSecurityScan,
   runSecurityScanDefinition
-} from "./chunk-MLOGYWLY.js";
+} from "./chunk-3AMQYWGT.js";
 import {
   handleRunCodeReview,
   runCodeReviewDefinition,
   sortFindingsBySeverity
-} from "./chunk-2DF6OZLG.js";
+} from "./chunk-DBIX3X4H.js";
 import {
   handleValidateProject,
   validateToolDefinition
-} from "./chunk-LTCEV7VF.js";
+} from "./chunk-NY7DTZ6K.js";
 import {
   checkDependenciesDefinition,
   handleCheckDependencies
-} from "./chunk-YRBNAHH4.js";
+} from "./chunk-BK4DJIIY.js";
 import {
   resolveProjectConfig
-} from "./chunk-IQO7IINR.js";
+} from "./chunk-TSVYBDDE.js";
 import {
   checkDocsDefinition,
   handleCheckDocs
-} from "./chunk-AS5DQT4S.js";
+} from "./chunk-56A6OXVA.js";
 import {
   detectEntropyDefinition,
   handleDetectEntropy
-} from "./chunk-D3XL2FLX.js";
+} from "./chunk-PNNFCVW4.js";
 import {
   checkPerformanceDefinition,
   getCriticalPathsDefinition,
@@ -52,7 +52,7 @@ import {
   handleGetPerfBaselines,
   handleUpdatePerfBaselines,
   updatePerfBaselinesDefinition
-} from "./chunk-PCOU2UXU.js";
+} from "./chunk-RAVD7QLY.js";
 import {
   resultToMcpResponse
 } from "./chunk-EPUKTTJZ.js";
@@ -61,7 +61,7 @@ import {
 } from "./chunk-W6Y7ZW3Y.js";
 import {
   resolveConfig
-} from "./chunk-TQRCODRJ.js";
+} from "./chunk-VKS3F46M.js";
 import {
   GENERATED_HEADER_CLAUDE,
   GENERATED_HEADER_CODEX,
@@ -83,7 +83,7 @@ import {
 } from "./chunk-6B6UN6SG.js";
 import {
   loadGraphStore
-} from "./chunk-JPZY7ZQX.js";
+} from "./chunk-OLW7BJ5N.js";
 import {
   CompactionPipeline,
   DEFAULT_TOKEN_BUDGET,
@@ -101,7 +101,7 @@ import {
   scanForInjection,
   serializeEnvelope,
   writeTaint
-} from "./chunk-ZIYLIYN4.js";
+} from "./chunk-YC4EYIER.js";
 import {
   Err,
   Ok
@@ -109,6 +109,9 @@ import {
 import {
   SkillMetadataSchema
 } from "./chunk-HIK6OEUF.js";
+import {
+  logger
+} from "./chunk-EBJQ6N4M.js";
 import {
   CLIError,
   ExitCode,
@@ -701,7 +704,7 @@ ${skippedMsg}`
 async function handleInitProject(input) {
   const i = input;
   try {
-    const { TemplateEngine } = await import("./engine-P7EE2IWO.js");
+    const { TemplateEngine } = await import("./engine-4L4CDTHU.js");
     const engine = new TemplateEngine(resolveTemplatesDir());
     const safePath = sanitizePath(i.path);
     const detected = tryDetectFramework(engine, safePath, i);
@@ -723,7 +726,7 @@ var listPersonasDefinition = {
   inputSchema: { type: "object", properties: {} }
 };
 async function handleListPersonas() {
-  const { listPersonas } = await import("./loader-SKHF3JVV.js");
+  const { listPersonas } = await import("./loader-UZOXCWFC.js");
   const result = listPersonas(resolvePersonasDir());
   return resultToMcpResponse(result);
 }
@@ -747,10 +750,10 @@ async function handleGeneratePersonaArtifacts(input) {
   if (!/^[a-z0-9][a-z0-9._-]*$/i.test(input.name)) {
     return resultToMcpResponse(Err(new Error(`Invalid persona name: ${input.name}`)));
   }
-  const { loadPersona } = await import("./loader-SKHF3JVV.js");
-  const { generateRuntime } = await import("./runtime-7LYAW7GU.js");
-  const { generateAgentsMd } = await import("./agents-md-QPO3H5HX.js");
-  const { generateCIWorkflow } = await import("./ci-workflow-FJYRFZYQ.js");
+  const { loadPersona } = await import("./loader-UZOXCWFC.js");
+  const { generateRuntime } = await import("./runtime-PXX7HNB3.js");
+  const { generateAgentsMd } = await import("./agents-md-VI3HLR7E.js");
+  const { generateCIWorkflow } = await import("./ci-workflow-EW37KVPS.js");
   const personasDir = resolvePersonasDir();
   const filePath = path3.join(personasDir, `${input.name}.yaml`);
   if (!filePath.startsWith(personasDir)) {
@@ -805,7 +808,7 @@ async function handleRunPersona(input) {
   if (!/^[a-z0-9][a-z0-9._-]*$/i.test(input.persona)) {
     return resultToMcpResponse(Err(new Error(`Invalid persona name: ${input.persona}`)));
   }
-  const { loadPersona } = await import("./loader-SKHF3JVV.js");
+  const { loadPersona } = await import("./loader-UZOXCWFC.js");
   const { runPersona } = await import("./runner-AAEF2TXY.js");
   const { executeSkill } = await import("./skill-executor-MOCUIAYS.js");
   const personasDir = resolvePersonasDir();
@@ -1344,7 +1347,7 @@ function loadOrGenerateProfile(projectRoot) {
 // src/mcp/tools/event-emitter.ts
 async function emitSkillEvent(projectPath, event) {
   try {
-    const { emitEvent } = await import("./dist-ZV6GO6FA.js");
+    const { emitEvent } = await import("./dist-CJDGASPP.js");
     await emitEvent(projectPath, event);
   } catch {
   }
@@ -1494,7 +1497,7 @@ var createSkillDefinition = {
 };
 async function handleCreateSkill(input) {
   try {
-    const { generateSkillFiles } = await import("./create-skill-6QWJHQYS.js");
+    const { generateSkillFiles } = await import("./create-skill-4T5CBSJ2.js");
     const result = generateSkillFiles({
       name: input.name,
       description: input.description,
@@ -1616,7 +1619,7 @@ async function autoSyncRoadmap(projectPath) {
   try {
     const roadmapFile = path11.join(projectPath, "docs", "roadmap.md");
     if (!fs10.existsSync(roadmapFile)) return;
-    const { parseRoadmap, serializeRoadmap, syncRoadmap, applySyncChanges } = await import("./dist-ZV6GO6FA.js");
+    const { parseRoadmap, serializeRoadmap, syncRoadmap, applySyncChanges } = await import("./dist-CJDGASPP.js");
     const raw = fs10.readFileSync(roadmapFile, "utf-8");
     const parseResult = parseRoadmap(raw);
     if (!parseResult.ok) return;
@@ -1646,7 +1649,7 @@ async function triggerExternalSync(projectPath, roadmapFile) {
       console.warn("[roadmap-sync] GITHUB_TOKEN not found \u2014 external sync skipped");
       return;
     }
-    const { fullSync, GitHubIssuesSyncAdapter } = await import("./dist-ZV6GO6FA.js");
+    const { fullSync, GitHubIssuesSyncAdapter } = await import("./dist-CJDGASPP.js");
     const adapter = new GitHubIssuesSyncAdapter({
       token,
       config: trackerConfig
@@ -1743,12 +1746,12 @@ var manageStateDefinition = {
   }
 };
 async function handleShow(projectPath, input) {
-  const { loadState } = await import("./dist-ZV6GO6FA.js");
+  const { loadState } = await import("./dist-CJDGASPP.js");
   return resultToMcpResponse(await loadState(projectPath, input.stream, input.session));
 }
 async function handleLearn(projectPath, input) {
   if (!input.learning) return mcpError("Error: learning is required for learn action");
-  const { appendLearning } = await import("./dist-ZV6GO6FA.js");
+  const { appendLearning } = await import("./dist-CJDGASPP.js");
   const result = await appendLearning(
     projectPath,
     input.learning,
@@ -1763,7 +1766,7 @@ async function handleLearn(projectPath, input) {
 async function handleFailure(projectPath, input) {
   if (!input.description) return mcpError("Error: description is required for failure action");
   if (!input.failureType) return mcpError("Error: failureType is required for failure action");
-  const { appendFailure } = await import("./dist-ZV6GO6FA.js");
+  const { appendFailure } = await import("./dist-CJDGASPP.js");
   const result = await appendFailure(
     projectPath,
     input.description,
@@ -1782,19 +1785,19 @@ async function handleFailure(projectPath, input) {
   return resultToMcpResponse(Ok({ recorded: true }));
 }
 async function handleArchive(projectPath, input) {
-  const { archiveFailures } = await import("./dist-ZV6GO6FA.js");
+  const { archiveFailures } = await import("./dist-CJDGASPP.js");
   const result = await archiveFailures(projectPath, input.stream, input.session);
   if (!result.ok) return resultToMcpResponse(result);
   return resultToMcpResponse(Ok({ archived: true }));
 }
 async function handleReset(projectPath, input) {
-  const { saveState, DEFAULT_STATE } = await import("./dist-ZV6GO6FA.js");
+  const { saveState, DEFAULT_STATE } = await import("./dist-CJDGASPP.js");
   const result = await saveState(projectPath, { ...DEFAULT_STATE }, input.stream, input.session);
   if (!result.ok) return resultToMcpResponse(result);
   return resultToMcpResponse(Ok({ reset: true }));
 }
 async function handleGate(projectPath, input) {
-  const { runMechanicalGate } = await import("./dist-ZV6GO6FA.js");
+  const { runMechanicalGate } = await import("./dist-CJDGASPP.js");
   const result = await runMechanicalGate(projectPath);
   if (result.ok) {
     await emitSkillEvent(projectPath, {
@@ -1814,7 +1817,7 @@ async function handleGate(projectPath, input) {
 }
 async function handleSaveHandoff(projectPath, input) {
   if (!input.handoff) return mcpError("Error: handoff is required for save-handoff action");
-  const { saveHandoff } = await import("./dist-ZV6GO6FA.js");
+  const { saveHandoff } = await import("./dist-CJDGASPP.js");
   const result = await saveHandoff(
     projectPath,
     input.handoff,
@@ -1836,7 +1839,7 @@ async function handleSaveHandoff(projectPath, input) {
   return resultToMcpResponse(Ok({ saved: true }));
 }
 async function handleLoadHandoff(projectPath, input) {
-  const { loadHandoff } = await import("./dist-ZV6GO6FA.js");
+  const { loadHandoff } = await import("./dist-CJDGASPP.js");
   return resultToMcpResponse(await loadHandoff(projectPath, input.stream, input.session));
 }
 async function handleAppendEntry(projectPath, input) {
@@ -1844,7 +1847,7 @@ async function handleAppendEntry(projectPath, input) {
   if (!input.authorSkill) return mcpError("Error: authorSkill is required for append_entry action");
   if (!input.content) return mcpError("Error: content is required for append_entry action");
   if (input.session) {
-    const { appendSessionEntry } = await import("./dist-ZV6GO6FA.js");
+    const { appendSessionEntry } = await import("./dist-CJDGASPP.js");
     const result = await appendSessionEntry(
       projectPath,
       input.session,
@@ -1857,7 +1860,7 @@ async function handleAppendEntry(projectPath, input) {
   if (input.section !== "decisions") {
     return mcpError("Error: session is required for non-decisions sections");
   }
-  const { loadState, saveState } = await import("./dist-ZV6GO6FA.js");
+  const { loadState, saveState } = await import("./dist-CJDGASPP.js");
   const lr = await loadState(projectPath, input.stream);
   if (!lr.ok) return resultToMcpResponse(lr);
   lr.value.decisions.push({
@@ -1875,7 +1878,7 @@ async function handleUpdateEntryStatus(projectPath, input) {
   if (!input.entryId) return mcpError("Error: entryId is required for update_entry_status action");
   if (!input.newStatus)
     return mcpError("Error: newStatus is required for update_entry_status action");
-  const { updateSessionEntryStatus } = await import("./dist-ZV6GO6FA.js");
+  const { updateSessionEntryStatus } = await import("./dist-CJDGASPP.js");
   const result = await updateSessionEntryStatus(
     projectPath,
     input.session,
@@ -1888,7 +1891,7 @@ async function handleUpdateEntryStatus(projectPath, input) {
 async function handleReadSection(projectPath, input) {
   if (!input.session) return mcpError("Error: session is required for read_section action");
   if (!input.section) return mcpError("Error: section is required for read_section action");
-  const { readSessionSection } = await import("./dist-ZV6GO6FA.js");
+  const { readSessionSection } = await import("./dist-CJDGASPP.js");
   const result = await readSessionSection(
     projectPath,
     input.session,
@@ -1898,13 +1901,13 @@ async function handleReadSection(projectPath, input) {
 }
 async function handleReadSections(projectPath, input) {
   if (!input.session) return mcpError("Error: session is required for read_sections action");
-  const { readSessionSections } = await import("./dist-ZV6GO6FA.js");
+  const { readSessionSections } = await import("./dist-CJDGASPP.js");
   const result = await readSessionSections(projectPath, input.session);
   return resultToMcpResponse(result);
 }
 async function handleArchiveSession(projectPath, input) {
   if (!input.session) return mcpError("Error: session is required for archive_session action");
-  const { archiveSession } = await import("./dist-ZV6GO6FA.js");
+  const { archiveSession } = await import("./dist-CJDGASPP.js");
   const result = await archiveSession(projectPath, input.session);
   if (!result.ok) return resultToMcpResponse(result);
   await autoSyncRoadmap(projectPath);
@@ -1984,7 +1987,7 @@ var listStreamsDefinition = {
 };
 async function handleListStreams(input) {
   try {
-    const { listStreams, loadStreamIndex } = await import("./dist-ZV6GO6FA.js");
+    const { listStreams, loadStreamIndex } = await import("./dist-CJDGASPP.js");
     const projectPath = sanitizePath(input.path);
     const indexResult = await loadStreamIndex(projectPath);
     const streamsResult = await listStreams(projectPath);
@@ -2022,7 +2025,7 @@ var checkPhaseGateDefinition = {
 };
 async function handleCheckPhaseGate(input) {
   try {
-    const { runCheckPhaseGate } = await import("./check-phase-gate-TNY64AOS.js");
+    const { runCheckPhaseGate } = await import("./check-phase-gate-CXR3VM22.js");
     const result = await runCheckPhaseGate({ cwd: sanitizePath(input.path) });
     if (result.ok) {
       return { content: [{ type: "text", text: JSON.stringify(result.value) }] };
@@ -2078,7 +2081,7 @@ async function handleValidateCrossCheck(input) {
     };
   }
   try {
-    const { runCrossCheck } = await import("./validate-cross-check-GQX7OVCR.js");
+    const { runCrossCheck } = await import("./validate-cross-check-BKCNLZYG.js");
     const specsDir = path12.resolve(projectPath, input.specsDir ?? "docs/specs");
     if (!specsDir.startsWith(projectPath)) {
       return {
@@ -2801,7 +2804,7 @@ async function handleGenerateSlashCommands(input) {
 // src/mcp/resources/state.ts
 async function getStateResource(projectRoot) {
   try {
-    const { loadState, migrateToStreams } = await import("./dist-ZV6GO6FA.js");
+    const { loadState, migrateToStreams } = await import("./dist-CJDGASPP.js");
     await migrateToStreams(projectRoot);
     const result = await loadState(projectRoot);
     if (result.ok) {
@@ -2919,7 +2922,7 @@ async function handleQueryGraph(input) {
     const projectPath = sanitizePath(input.path);
     const store = await loadGraphStore(projectPath);
     if (!store) return graphNotFoundError();
-    const { ContextQL } = await import("./dist-HPWNWCT6.js");
+    const { ContextQL } = await import("./dist-NCNAXUFD.js");
     const cql = new ContextQL(store);
     const result = cql.execute({
       rootNodeIds: input.rootNodeIds,
@@ -3001,7 +3004,7 @@ async function handleSearchSimilar(input) {
     const projectPath = sanitizePath(input.path);
     const store = await loadGraphStore(projectPath);
     if (!store) return graphNotFoundError();
-    const { FusionLayer } = await import("./dist-HPWNWCT6.js");
+    const { FusionLayer } = await import("./dist-NCNAXUFD.js");
     const fusion = new FusionLayer(store);
     const results = fusion.search(input.query, input.topK ?? 10);
     if (input.mode === "summary") {
@@ -3056,7 +3059,7 @@ async function handleFindContextFor(input) {
     const projectPath = sanitizePath(input.path);
     const store = await loadGraphStore(projectPath);
     if (!store) return graphNotFoundError();
-    const { FusionLayer, ContextQL } = await import("./dist-HPWNWCT6.js");
+    const { FusionLayer, ContextQL } = await import("./dist-NCNAXUFD.js");
     const fusion = new FusionLayer(store);
     const cql = new ContextQL(store);
     const tokenBudget = input.tokenBudget ?? 4e3;
@@ -3161,7 +3164,7 @@ async function handleGetRelationships(input) {
     const projectPath = sanitizePath(input.path);
     const store = await loadGraphStore(projectPath);
     if (!store) return graphNotFoundError();
-    const { ContextQL } = await import("./dist-HPWNWCT6.js");
+    const { ContextQL } = await import("./dist-NCNAXUFD.js");
     const cql = new ContextQL(store);
     const direction = input.direction ?? "both";
     const bidirectional = direction === "both" || direction === "inbound";
@@ -3279,7 +3282,7 @@ async function handleGetImpact(input) {
     const projectPath = sanitizePath(input.path);
     const store = await loadGraphStore(projectPath);
     if (!store) return graphNotFoundError();
-    const { ContextQL } = await import("./dist-HPWNWCT6.js");
+    const { ContextQL } = await import("./dist-NCNAXUFD.js");
     let targetNodeId = input.nodeId;
     if (!targetNodeId && input.filePath) {
       const fileNodes = store.findNodes({ type: "file" });
@@ -3400,7 +3403,7 @@ var ingestSourceDefinition = {
       path: { type: "string", description: "Path to project root" },
       source: {
         type: "string",
-        enum: ["code", "knowledge", "git", "all"],
+        enum: ["code", "knowledge", "git", "business-signals", "diagrams", "all"],
         description: "Type of source to ingest"
       }
     },
@@ -3411,9 +3414,9 @@ async function handleIngestSource(input) {
   try {
     const projectPath = sanitizePath(input.path);
     const graphDir = path16.join(projectPath, ".harness", "graph");
-    const { GraphStore, CodeIngestor, TopologicalLinker, KnowledgeIngestor, GitIngestor } = await import("./dist-HPWNWCT6.js");
-    const fs17 = await import("fs/promises");
-    await fs17.mkdir(graphDir, { recursive: true });
+    const { GraphStore, CodeIngestor, TopologicalLinker, KnowledgeIngestor, GitIngestor } = await import("./dist-NCNAXUFD.js");
+    const fs18 = await import("fs/promises");
+    await fs18.mkdir(graphDir, { recursive: true });
     const store = new GraphStore();
     await store.load(graphDir);
     const results = [];
@@ -3434,6 +3437,18 @@ async function handleIngestSource(input) {
       const gitResult = await gitIngestor.ingest(projectPath);
       results.push(gitResult);
     }
+    if (input.source === "business-signals" || input.source === "all") {
+      const { createExtractionRunner } = await import("./dist-NCNAXUFD.js");
+      const extractedDir = path16.join(projectPath, ".harness", "knowledge", "extracted");
+      const signalsResult = await createExtractionRunner().run(projectPath, store, extractedDir);
+      results.push(signalsResult);
+    }
+    if (input.source === "diagrams" || input.source === "all") {
+      const { DiagramParser } = await import("./dist-NCNAXUFD.js");
+      const diagramParser = new DiagramParser(store);
+      const diagramResult = await diagramParser.ingest(projectPath);
+      results.push(diagramResult);
+    }
     await store.save(graphDir);
     const combined = {
       nodesAdded: results.reduce((s, r) => s + r.nodesAdded, 0),
@@ -3495,7 +3510,7 @@ async function handleDetectAnomalies(input) {
     const projectPath = sanitizePath(input.path);
     const store = await loadGraphStore(projectPath);
     if (!store) return graphNotFoundError();
-    const { GraphAnomalyAdapter } = await import("./dist-HPWNWCT6.js");
+    const { GraphAnomalyAdapter } = await import("./dist-NCNAXUFD.js");
     const adapter = new GraphAnomalyAdapter(store);
     const report = adapter.detect({
       ...input.threshold !== void 0 && { threshold: input.threshold },
@@ -3544,7 +3559,7 @@ async function handleAskGraph(input) {
     const projectPath = sanitizePath(input.path);
     const store = await loadGraphStore(projectPath);
     if (!store) return graphNotFoundError();
-    const { askGraph } = await import("./dist-HPWNWCT6.js");
+    const { askGraph } = await import("./dist-NCNAXUFD.js");
     const result = await askGraph(store, input.question);
     return {
       content: [{ type: "text", text: JSON.stringify(result) }]
@@ -3608,7 +3623,7 @@ async function handleComputeBlastRadius(input) {
     const projectPath = sanitizePath(input.path);
     const store = await loadGraphStore(projectPath);
     if (!store) return graphNotFoundError();
-    const { CascadeSimulator } = await import("./dist-HPWNWCT6.js");
+    const { CascadeSimulator } = await import("./dist-NCNAXUFD.js");
     let targetNodeId = input.nodeId;
     if (!targetNodeId && input.file) {
       const fileNodes = store.findNodes({ type: "file" });
@@ -3809,7 +3824,7 @@ var generateAgentDefinitionsDefinition = {
   }
 };
 async function handleGenerateAgentDefinitions(input) {
-  const { generateAgentDefinitions } = await import("./generate-agent-definitions-3EHPIWBO.js");
+  const { generateAgentDefinitions } = await import("./generate-agent-definitions-CZGUXIIN.js");
   const platforms = input.platform === "all" || !input.platform ? ["claude-code", "gemini-cli"] : [input.platform];
   const results = generateAgentDefinitions({
     platforms: [...platforms],
@@ -4137,7 +4152,7 @@ function shouldTriggerExternalSync(input, response) {
 }
 async function handleManageRoadmap(input) {
   try {
-    const { parseRoadmap, serializeRoadmap, syncRoadmap, applySyncChanges, assignFeature } = await import("./dist-ZV6GO6FA.js");
+    const { parseRoadmap, serializeRoadmap, syncRoadmap, applySyncChanges, assignFeature } = await import("./dist-CJDGASPP.js");
     const { Ok: Ok2 } = await import("./dist-3EWNRFFQ.js");
     const projectPath = sanitizePath(input.path);
     const deps = {
@@ -4576,7 +4591,7 @@ async function handleTransition(validInput, projectPath, id) {
   const transition = transitionResult.data;
   const prompt = renderTransition(transition);
   try {
-    const { saveHandoff } = await import("./dist-ZV6GO6FA.js");
+    const { saveHandoff } = await import("./dist-CJDGASPP.js");
     await saveHandoff(
       projectPath,
       {
@@ -4657,7 +4672,7 @@ async function handleEmitInteraction(input) {
 }
 async function recordInteraction(projectPath, id, type, decision, stream) {
   try {
-    const { loadState, saveState } = await import("./dist-ZV6GO6FA.js");
+    const { loadState, saveState } = await import("./dist-CJDGASPP.js");
     const stateResult = await loadState(projectPath, stream);
     if (stateResult.ok) {
       const state = stateResult.value;
@@ -4818,10 +4833,10 @@ async function handleGatherContext(input) {
     input.include ?? ["state", "learnings", "handoff", "graph", "validation"]
   );
   const errors = [];
-  const statePromise = includeSet.has("state") ? import("./dist-ZV6GO6FA.js").then(
+  const statePromise = includeSet.has("state") ? import("./dist-CJDGASPP.js").then(
     (core) => core.loadState(projectPath, void 0, input.session)
   ) : Promise.resolve(null);
-  const learningsPromise = includeSet.has("learnings") ? import("./dist-ZV6GO6FA.js").then(
+  const learningsPromise = includeSet.has("learnings") ? import("./dist-CJDGASPP.js").then(
     (core) => core.loadBudgetedLearnings(projectPath, {
       intent: input.intent,
       tokenBudget: input.learningsBudget ?? 1e3,
@@ -4830,14 +4845,14 @@ async function handleGatherContext(input) {
       ...input.depth !== void 0 && { depth: input.depth }
     })
   ) : Promise.resolve(null);
-  const handoffPromise = includeSet.has("handoff") ? import("./dist-ZV6GO6FA.js").then(
+  const handoffPromise = includeSet.has("handoff") ? import("./dist-CJDGASPP.js").then(
     (core) => core.loadHandoff(projectPath, void 0, input.session)
   ) : Promise.resolve(null);
   const graphPromise = includeSet.has("graph") ? (async () => {
-    const { loadGraphStore: loadGraphStore2 } = await import("./graph-loader-KXVS3YK3.js");
+    const { loadGraphStore: loadGraphStore2 } = await import("./graph-loader-RDXSEBD7.js");
     const store = await loadGraphStore2(projectPath);
     if (!store) return null;
-    const { FusionLayer, ContextQL } = await import("./dist-HPWNWCT6.js");
+    const { FusionLayer, ContextQL } = await import("./dist-NCNAXUFD.js");
     const fusion = new FusionLayer(store);
     const cql = new ContextQL(store);
     const tokenBudget = input.tokenBudget ?? 4e3;
@@ -4874,11 +4889,11 @@ async function handleGatherContext(input) {
       context: contextBlocks
     };
   })() : Promise.resolve(null);
-  const sessionsPromise = includeSet.has("sessions") && input.session ? import("./dist-ZV6GO6FA.js").then(
+  const sessionsPromise = includeSet.has("sessions") && input.session ? import("./dist-CJDGASPP.js").then(
     (core) => core.readSessionSections(projectPath, input.session)
   ) : Promise.resolve(null);
   const shouldIncludeEvents = input.includeEvents !== void 0 ? input.includeEvents : includeSet.has("events") || !!input.session && !input.include;
-  const eventsPromise = shouldIncludeEvents ? import("./dist-ZV6GO6FA.js").then(async (core) => {
+  const eventsPromise = shouldIncludeEvents ? import("./dist-CJDGASPP.js").then(async (core) => {
     const result = await core.loadEvents(projectPath, {
       session: input.session
     });
@@ -4886,7 +4901,7 @@ async function handleGatherContext(input) {
     return core.formatEventTimeline(result.value);
   }) : Promise.resolve(null);
   const validationPromise = includeSet.has("validation") ? (async () => {
-    const { handleValidateProject: handleValidateProject2 } = await import("./validate-BFFHYHY7.js");
+    const { handleValidateProject: handleValidateProject2 } = await import("./validate-CWGXR7QM.js");
     const result = await handleValidateProject2({ path: projectPath });
     const first = result.content[0];
     return first ? JSON.parse(first.text) : null;
@@ -4989,7 +5004,7 @@ async function handleGatherContext(input) {
   };
   if (input.session) {
     try {
-      const core = await import("./dist-ZV6GO6FA.js");
+      const core = await import("./dist-CJDGASPP.js");
       core.updateSessionIndex(
         projectPath,
         input.session,
@@ -5141,7 +5156,7 @@ async function handleReviewChanges(input) {
   }
 }
 async function runQuickReview(projectPath, diff, diffLines, downgraded, offset, limit) {
-  const { handleAnalyzeDiff: handleAnalyzeDiff2 } = await import("./feedback-Y4FYN3NR.js");
+  const { handleAnalyzeDiff: handleAnalyzeDiff2 } = await import("./feedback-OTIFW5MK.js");
   const result = await handleAnalyzeDiff2({ diff, path: projectPath });
   const firstContent = result.content[0];
   if (!firstContent) throw new Error("Empty analyze_diff response");
@@ -5176,7 +5191,7 @@ function extractFileCount(diffParsed) {
   return files?.length ?? 0;
 }
 async function runStandardReview(projectPath, diff, diffLines, downgraded, offset, limit) {
-  const { handleAnalyzeDiff: handleAnalyzeDiff2, handleCreateSelfReview: handleCreateSelfReview2 } = await import("./feedback-Y4FYN3NR.js");
+  const { handleAnalyzeDiff: handleAnalyzeDiff2, handleCreateSelfReview: handleCreateSelfReview2 } = await import("./feedback-OTIFW5MK.js");
   const [diffResult, reviewResult] = await Promise.all([
     handleAnalyzeDiff2({ diff, path: projectPath }),
     handleCreateSelfReview2({ path: projectPath, diff })
@@ -5211,7 +5226,7 @@ async function runStandardReview(projectPath, diff, diffLines, downgraded, offse
   };
 }
 async function runDeepReview(projectPath, diff, diffLines, _downgraded, offset, limit) {
-  const { handleRunCodeReview: handleRunCodeReview2 } = await import("./review-pipeline-TLKE5OQD.js");
+  const { handleRunCodeReview: handleRunCodeReview2 } = await import("./review-pipeline-65V4EO6O.js");
   const result = await handleRunCodeReview2({
     path: projectPath,
     diff,
@@ -5290,7 +5305,7 @@ async function handleCheckTaskIndependence(input) {
   try {
     const projectPath = sanitizePath(input.path);
     const store = await loadGraphStore(projectPath);
-    const { TaskIndependenceAnalyzer } = await import("./dist-HPWNWCT6.js");
+    const { TaskIndependenceAnalyzer } = await import("./dist-NCNAXUFD.js");
     const analyzer = new TaskIndependenceAnalyzer(store ?? void 0);
     const result = analyzer.analyze({
       tasks: input.tasks,
@@ -5378,7 +5393,7 @@ async function handlePredictConflicts(input) {
   try {
     const projectPath = sanitizePath(input.path);
     const store = await loadGraphStore(projectPath);
-    const { ConflictPredictor } = await import("./dist-HPWNWCT6.js");
+    const { ConflictPredictor } = await import("./dist-NCNAXUFD.js");
     const predictor = new ConflictPredictor(store ?? void 0);
     const result = predictor.predict({
       tasks: input.tasks,
@@ -5484,7 +5499,7 @@ async function handleDetectStaleConstraints(input) {
         isError: true
       };
     }
-    const { loadGraphStore: loadGraphStore2 } = await import("./graph-loader-KXVS3YK3.js");
+    const { loadGraphStore: loadGraphStore2 } = await import("./graph-loader-RDXSEBD7.js");
     const store = await loadGraphStore2(projectPath);
     if (!store) {
       return {
@@ -5505,7 +5520,7 @@ async function handleDetectStaleConstraints(input) {
         ]
       };
     }
-    const { detectStaleConstraints } = await import("./dist-ZV6GO6FA.js");
+    const { detectStaleConstraints } = await import("./dist-CJDGASPP.js");
     const result = detectStaleConstraints(
       store,
       windowDays,
@@ -5625,10 +5640,10 @@ function countCriticalFindings(securityData) {
   return findings.filter((f) => f.severity === "error").length;
 }
 async function runHealthChecks(projectPath) {
-  const { handleAssessProject: handleAssessProject2 } = await import("./assess-project-QU6XIVJK.js");
-  const { handleCheckDependencies: handleCheckDependencies2 } = await import("./architecture-IJLXRHZA.js");
-  const { handleDetectEntropy: handleDetectEntropy2 } = await import("./entropy-HCXRTDFU.js");
-  const { handleRunSecurityScan: handleRunSecurityScan2 } = await import("./security-5XWINYVB.js");
+  const { handleAssessProject: handleAssessProject2 } = await import("./assess-project-Y6W7YDUA.js");
+  const { handleCheckDependencies: handleCheckDependencies2 } = await import("./architecture-ZDDKEVID.js");
+  const { handleDetectEntropy: handleDetectEntropy2 } = await import("./entropy-PBYSIQYS.js");
+  const { handleRunSecurityScan: handleRunSecurityScan2 } = await import("./security-CAYDRZIZ.js");
   const [assessResult, depsResult, entropyResult, securityResult] = await Promise.all([
     handleAssessProject2({
       path: projectPath,
@@ -5683,10 +5698,10 @@ function avg(values) {
 }
 async function runGraphMetrics(projectPath) {
   try {
-    const { loadGraphStore: loadGraphStore2 } = await import("./graph-loader-KXVS3YK3.js");
+    const { loadGraphStore: loadGraphStore2 } = await import("./graph-loader-RDXSEBD7.js");
     const store = await loadGraphStore2(projectPath);
     if (!store) return ZERO_METRICS;
-    const { GraphCouplingAdapter, GraphComplexityAdapter, GraphAnomalyAdapter } = await import("./dist-HPWNWCT6.js");
+    const { GraphCouplingAdapter, GraphComplexityAdapter, GraphAnomalyAdapter } = await import("./dist-NCNAXUFD.js");
     const couplingAdapter = new GraphCouplingAdapter(store);
     const couplingData = couplingAdapter.computeCouplingData();
     const files = couplingData.files;
@@ -6425,7 +6440,7 @@ async function handleGetDecayTrends(input) {
     };
   }
   try {
-    const core = await import("./dist-ZV6GO6FA.js");
+    const core = await import("./dist-CJDGASPP.js");
     const { TimelineManager } = core;
     const manager = new TimelineManager(projectPath);
     const timeline = manager.load();
@@ -6560,7 +6575,7 @@ async function handleCodeOutline(input) {
     };
   }
   try {
-    const { getOutline, formatOutline, EXTENSION_MAP } = await import("./dist-ZV6GO6FA.js");
+    const { getOutline, formatOutline, EXTENSION_MAP } = await import("./dist-CJDGASPP.js");
     const { stat } = await import("fs/promises");
     const stats = await stat(targetPath).catch(() => null);
     if (stats?.isFile()) {
@@ -6579,7 +6594,7 @@ async function handleCodeOutline(input) {
         })
       );
       fileStats.sort((a, b) => b.mtimeMs - a.mtimeMs);
-      const { paginate: paginate2 } = await import("./dist-ZV6GO6FA.js");
+      const { paginate: paginate2 } = await import("./dist-CJDGASPP.js");
       const paged = paginate2(fileStats, input.offset ?? 0, input.limit ?? 30);
       const results = [];
       for (const entry of paged.items) {
@@ -6652,7 +6667,7 @@ async function handleCodeSearch(input) {
     };
   }
   try {
-    const { searchSymbols } = await import("./dist-ZV6GO6FA.js");
+    const { searchSymbols } = await import("./dist-CJDGASPP.js");
     const result = await searchSymbols(input.query, directory, input.glob);
     const lines = [`Search: "${result.query}" \u2014 ${result.matches.length} matches`];
     for (const match of result.matches) {
@@ -6721,7 +6736,7 @@ async function handleCodeUnfold(input) {
   }
   try {
     if (input.symbol) {
-      const { unfoldSymbol } = await import("./dist-ZV6GO6FA.js");
+      const { unfoldSymbol } = await import("./dist-CJDGASPP.js");
       const result = await unfoldSymbol(filePath, input.symbol);
       const header = result.warning ? `${result.file}:${result.startLine}-${result.endLine} ${result.warning}
 ` : `${result.file}:${result.startLine}-${result.endLine}
@@ -6729,7 +6744,7 @@ async function handleCodeUnfold(input) {
       return { content: [{ type: "text", text: header + result.content }] };
     }
     if (input.startLine != null && input.endLine != null) {
-      const { unfoldRange } = await import("./dist-ZV6GO6FA.js");
+      const { unfoldRange } = await import("./dist-CJDGASPP.js");
       const result = await unfoldRange(filePath, input.startLine, input.endLine);
       const header = `${result.file}:${result.startLine}-${result.endLine}
 `;
@@ -6791,7 +6806,7 @@ async function handleCheckTraceability(input) {
         isError: true
       };
     }
-    const { queryTraceability } = await import("./dist-HPWNWCT6.js");
+    const { queryTraceability } = await import("./dist-NCNAXUFD.js");
     const options = {};
     if (input.spec) options.specPath = input.spec;
     if (input.feature) options.featureName = input.feature;
@@ -6914,7 +6929,7 @@ async function handlePredictFailures(input) {
     };
   }
   try {
-    const core = await import("./dist-ZV6GO6FA.js");
+    const core = await import("./dist-CJDGASPP.js");
     const { TimelineManager, PredictionEngine, SpecImpactEstimator } = core;
     const manager = new TimelineManager(projectPath);
     const includeRoadmap = input.includeRoadmap !== false;
@@ -7016,6 +7031,699 @@ async function handleRecommendSkills(input) {
   };
 }
 
+// src/mcp/tools/advise-skills.ts
+import path21 from "path";
+
+// src/commands/advise-skills.ts
+import { Command as Command2 } from "commander";
+import fs17 from "fs";
+import path20 from "path";
+import chalk from "chalk";
+
+// src/skill/content-matcher-types.ts
+var TIER_THRESHOLDS = {
+  apply: 0.6,
+  reference: 0.35,
+  consider: 0.15
+};
+var SCORING_WEIGHTS = {
+  keyword: 0.35,
+  stack: 0.25,
+  termOverlap: 0.25,
+  domain: 0.15
+};
+var DOMAIN_KEYWORD_MAP = {
+  design: [
+    "layout",
+    "responsive",
+    "typography",
+    "color",
+    "theme",
+    "dark mode",
+    "ui",
+    "ux",
+    "component",
+    "palette",
+    "breakpoint",
+    "grid",
+    "elevation",
+    "shadow",
+    "motion",
+    "animation",
+    "css"
+  ],
+  auth: [
+    "authentication",
+    "authorization",
+    "oauth",
+    "session",
+    "token",
+    "jwt",
+    "login",
+    "signup",
+    "password",
+    "credential",
+    "rbac",
+    "permission",
+    "identity"
+  ],
+  data: [
+    "database",
+    "schema",
+    "migration",
+    "query",
+    "sql",
+    "nosql",
+    "orm",
+    "model",
+    "table",
+    "transaction",
+    "prisma",
+    "drizzle"
+  ],
+  security: [
+    "security",
+    "vulnerability",
+    "xss",
+    "csrf",
+    "injection",
+    "sanitiz",
+    "encrypt",
+    "hash",
+    "owasp",
+    "cve",
+    "audit"
+  ],
+  a11y: [
+    "accessibility",
+    "a11y",
+    "aria",
+    "screen reader",
+    "screen-reader",
+    "wcag",
+    "contrast",
+    "keyboard navigation",
+    "focus management"
+  ],
+  perf: [
+    "performance",
+    "latency",
+    "throughput",
+    "cache",
+    "lazy load",
+    "bundle size",
+    "tree shaking",
+    "code splitting",
+    "lighthouse",
+    "optimization",
+    "bundle"
+  ],
+  testing: [
+    "test",
+    "coverage",
+    "mock",
+    "stub",
+    "fixture",
+    "assertion",
+    "snapshot",
+    "e2e",
+    "integration test",
+    "unit test",
+    "tdd"
+  ],
+  api: [
+    "api",
+    "endpoint",
+    "rest",
+    "graphql",
+    "openapi",
+    "swagger",
+    "route",
+    "middleware",
+    "webhook",
+    "grpc"
+  ],
+  infra: [
+    "docker",
+    "kubernetes",
+    "ci/cd",
+    "ci",
+    "cd",
+    "deploy",
+    "terraform",
+    "aws",
+    "gcp",
+    "azure",
+    "cloud",
+    "container",
+    "helm"
+  ],
+  mobile: [
+    "mobile",
+    "ios",
+    "android",
+    "react native",
+    "react-native",
+    "flutter",
+    "app store",
+    "push notification"
+  ]
+};
+
+// src/skill/signal-extractor.ts
+var STEM_SUFFIXES = [
+  "ation",
+  "tion",
+  "sion",
+  "ment",
+  "ness",
+  "ible",
+  "able",
+  "ive",
+  "ous",
+  "ful",
+  "ing",
+  "ity",
+  "ly",
+  "ed",
+  "er",
+  "es",
+  "s"
+];
+function simpleStem(word) {
+  const w = word.toLowerCase();
+  if (w.length <= 4) return w;
+  for (const suffix of STEM_SUFFIXES) {
+    if (w.endsWith(suffix) && w.length - suffix.length >= 3) {
+      return w.slice(0, -suffix.length);
+    }
+  }
+  return w;
+}
+function extractSpecKeywords(specText) {
+  const match = specText.match(/\*\*Keywords?:\*\*\s*(.+)/i);
+  if (!match?.[1]) return [];
+  return match[1].split(",").map((k) => k.trim()).filter((k) => k.length > 0);
+}
+var STACK_SIGNAL_MAP = {
+  react: "react",
+  "react-dom": "react",
+  "react-native": "react-native",
+  next: "next",
+  vue: "vue",
+  nuxt: "nuxt",
+  angular: "angular",
+  svelte: "svelte",
+  express: "express",
+  fastify: "fastify",
+  nestjs: "nest",
+  "@nestjs/core": "nest",
+  typescript: "typescript",
+  tailwindcss: "tailwind",
+  prisma: "prisma",
+  "@prisma/client": "prisma",
+  "drizzle-orm": "drizzle",
+  graphql: "graphql",
+  "@trpc/server": "trpc",
+  trpc: "trpc",
+  vitest: "vitest",
+  jest: "jest",
+  playwright: "playwright",
+  cypress: "cypress",
+  vite: "vite",
+  webpack: "webpack",
+  zod: "zod",
+  mongoose: "mongoose",
+  redis: "redis",
+  ioredis: "redis",
+  "socket.io": "websocket",
+  ws: "websocket"
+};
+function detectStackFromDeps(dependencies, devDependencies) {
+  const signals = /* @__PURE__ */ new Set();
+  const allDeps = { ...dependencies, ...devDependencies };
+  for (const pkgName of Object.keys(allDeps)) {
+    const signal = STACK_SIGNAL_MAP[pkgName];
+    if (signal) {
+      signals.add(signal);
+    }
+  }
+  return [...signals].sort();
+}
+function inferDomain(specText) {
+  const lower = specText.toLowerCase();
+  const domains = [];
+  for (const [domain, markers] of Object.entries(DOMAIN_KEYWORD_MAP)) {
+    const hits = markers.filter((m) => lower.includes(m)).length;
+    if (hits >= 2) {
+      domains.push(domain);
+    }
+  }
+  return domains.sort();
+}
+function extractSignals(specText, dependencies, devDependencies, contextKeywords, taskText) {
+  const specKeywords = extractSpecKeywords(specText);
+  if (contextKeywords) {
+    const existing = new Set(specKeywords);
+    for (const kw of contextKeywords) {
+      if (!existing.has(kw)) {
+        specKeywords.push(kw);
+        existing.add(kw);
+      }
+    }
+  }
+  const stackSignals = detectStackFromDeps(dependencies, devDependencies);
+  const featureDomain = inferDomain(specText);
+  return {
+    specKeywords,
+    specText,
+    stackSignals,
+    featureDomain,
+    ...taskText !== void 0 && { taskText }
+  };
+}
+
+// src/skill/content-matcher.ts
+function computeKeywordOverlap(skillKeywords, specKeywords) {
+  if (skillKeywords.length === 0 || specKeywords.length === 0) return 0;
+  const stemTokens = (keywords) => {
+    const tokens = /* @__PURE__ */ new Set();
+    for (const kw of keywords) {
+      const parts = kw.toLowerCase().split(/[-_\s]+/);
+      for (const part of parts) {
+        if (part.length > 0) {
+          tokens.add(simpleStem(part));
+        }
+      }
+    }
+    return tokens;
+  };
+  const skillStems = stemTokens(skillKeywords);
+  const specStems = stemTokens(specKeywords);
+  let intersectionCount = 0;
+  for (const stem of skillStems) {
+    if (specStems.has(stem)) intersectionCount++;
+  }
+  const unionSize = (/* @__PURE__ */ new Set([...skillStems, ...specStems])).size;
+  return unionSize > 0 ? intersectionCount / unionSize : 0;
+}
+function computeStackMatch(skillSignals, projectSignals) {
+  if (skillSignals.length === 0) return 0;
+  const projectSet = new Set(projectSignals.map((s) => s.toLowerCase()));
+  const matched = skillSignals.filter((s) => projectSet.has(s.toLowerCase())).length;
+  return matched / skillSignals.length;
+}
+function computeTermOverlap(skillDescription, specText) {
+  if (!skillDescription || !specText) return 0;
+  const tokenize = (text) => text.toLowerCase().split(/[\s\-_,.;:!?()[\]{}"'`]+/).filter((t) => t.length > 3).map(simpleStem);
+  const descTokens = tokenize(skillDescription);
+  if (descTokens.length === 0) return 0;
+  const specTokenSet = new Set(tokenize(specText));
+  const matched = descTokens.filter((t) => specTokenSet.has(t)).length;
+  return matched / descTokens.length;
+}
+function computeDomainMatch(entry, featureDomains) {
+  if (featureDomains.length === 0 || entry.keywords.length === 0) return 0;
+  const skillKeywordsLower = entry.keywords.map((k) => k.toLowerCase());
+  for (const domain of featureDomains) {
+    const domainKeywords = DOMAIN_KEYWORD_MAP[domain];
+    if (!domainKeywords) continue;
+    const hasMatch = skillKeywordsLower.some(
+      (kw) => domainKeywords.some((dk) => kw.includes(dk) || dk.includes(kw))
+    );
+    if (hasMatch) return 1;
+  }
+  return 0;
+}
+function classifyTier(score) {
+  if (score >= TIER_THRESHOLDS.apply) return "apply";
+  if (score >= TIER_THRESHOLDS.reference) return "reference";
+  if (score >= TIER_THRESHOLDS.consider) return "consider";
+  return null;
+}
+var WHEN_RULES = [
+  { name: /scan|audit|i18n|lint/, when: "End of phase" },
+  { name: /test/, keywords: /test|tdd|coverage|mock|e2e|snapshot/, when: "Testing" },
+  {
+    name: /a11y|contrast|wcag|color.accessib/,
+    keywords: /contrast|wcag/,
+    when: "After styling"
+  },
+  { keywords: /css|tailwind|typography|font|color|palette/, when: "During styling" },
+  { keywords: /alignment|whitespace|spacing|grid/, when: "Layout review" },
+  { keywords: /motion|animation|transition|parallax/, when: "During polish" },
+  { keywords: /architect|pattern|api|schema|data.model/, when: "Architecture decisions" },
+  { name: /^(gof-|js-)/, when: "Architecture decisions" }
+];
+function matchesWhenRule(rule, nameLower, keywordsLower) {
+  const nameHit = rule.name ? rule.name.test(nameLower) : false;
+  const kwHit = rule.keywords ? rule.keywords.test(keywordsLower) : false;
+  if (rule.name && rule.keywords) return nameHit || kwHit;
+  return nameHit || kwHit;
+}
+function inferWhen(name, entry) {
+  const nameLower = name.toLowerCase();
+  const keywordsLower = entry.keywords.map((k) => k.toLowerCase()).join(" ");
+  for (const rule of WHEN_RULES) {
+    if (matchesWhenRule(rule, nameLower, keywordsLower)) return rule.when;
+  }
+  return "During implementation";
+}
+function scoreSkillByContent(entry, signals) {
+  const keywordScore = computeKeywordOverlap(entry.keywords, signals.specKeywords);
+  const stackScore = computeStackMatch(entry.stackSignals, signals.stackSignals);
+  const textToMatch = signals.taskText ?? signals.specText;
+  const descScore = computeTermOverlap(entry.description, textToMatch);
+  const domainScore = computeDomainMatch(entry, signals.featureDomain);
+  return SCORING_WEIGHTS.keyword * keywordScore + SCORING_WEIGHTS.stack * stackScore + SCORING_WEIGHTS.termOverlap * descScore + SCORING_WEIGHTS.domain * domainScore;
+}
+function buildMatchReasons(entry, signals) {
+  const reasons = [];
+  const matchedKeywords = entry.keywords.filter(
+    (kw) => signals.specKeywords.some(
+      (sk) => kw.toLowerCase().includes(sk.toLowerCase()) || sk.toLowerCase().includes(kw.toLowerCase())
+    )
+  );
+  if (matchedKeywords.length > 0) {
+    reasons.push(`Keywords: ${matchedKeywords.join(", ")}`);
+  }
+  const projectSignalSet = new Set(signals.stackSignals.map((s) => s.toLowerCase()));
+  const matchedStack = entry.stackSignals.filter((s) => projectSignalSet.has(s.toLowerCase()));
+  if (matchedStack.length > 0) {
+    reasons.push(`Stack: ${matchedStack.join(", ")}`);
+  }
+  if (signals.featureDomain.length > 0) {
+    reasons.push(`Domain: ${signals.featureDomain.join(", ")}`);
+  }
+  return reasons;
+}
+function inferCategory(entry) {
+  const keywordsLower = entry.keywords.map((k) => k.toLowerCase()).join(" ");
+  if (/design|layout|responsive|css|ui|ux|theme|color/.test(keywordsLower)) return "design";
+  if (/auth|oauth|session|token|jwt|login/.test(keywordsLower)) return "security";
+  if (/a11y|accessibility|aria|wcag/.test(keywordsLower)) return "a11y";
+  if (/perf|performance|cache|optimization|lighthouse/.test(keywordsLower)) return "perf";
+  if (/test|tdd|coverage|mock|e2e/.test(keywordsLower)) return "testing";
+  if (/database|sql|orm|migration|schema/.test(keywordsLower)) return "data";
+  if (/api|rest|graphql|endpoint/.test(keywordsLower)) return "api";
+  if (/docker|kubernetes|deploy|ci|terraform/.test(keywordsLower)) return "infra";
+  if (/react|vue|angular|svelte|next/.test(keywordsLower)) return "framework";
+  return "patterns";
+}
+function scoreAllSkills(index, signals) {
+  const scored = [];
+  for (const [name, entry] of Object.entries(index.skills)) {
+    const score = scoreSkillByContent(entry, signals);
+    if (score >= TIER_THRESHOLDS.consider) {
+      scored.push({ name, entry, score });
+    }
+  }
+  return scored;
+}
+function expandRelatedSkills(scored, index) {
+  const matchedNames = new Set(scored.map((s) => s.name));
+  const expansions = [];
+  for (const match of scored) {
+    if (match.score < TIER_THRESHOLDS.reference) continue;
+    for (const relatedName of match.entry.relatedSkills) {
+      if (matchedNames.has(relatedName)) continue;
+      const relatedEntry = index.skills[relatedName];
+      if (!relatedEntry) continue;
+      const boostedScore = match.score * 0.6;
+      if (boostedScore >= TIER_THRESHOLDS.consider) {
+        matchedNames.add(relatedName);
+        expansions.push({
+          name: relatedName,
+          entry: relatedEntry,
+          score: boostedScore,
+          parentName: match.name
+        });
+      }
+    }
+  }
+  return expansions;
+}
+function buildMatchList(scored, expansions, signals) {
+  const matches = [];
+  for (const { name, entry, score } of scored) {
+    const tier = classifyTier(score);
+    if (!tier) continue;
+    matches.push({
+      skillName: name,
+      score: Math.round(score * 100) / 100,
+      tier,
+      matchReasons: buildMatchReasons(entry, signals),
+      category: inferCategory(entry),
+      when: inferWhen(name, entry)
+    });
+  }
+  for (const { name, entry, score, parentName } of expansions) {
+    const tier = classifyTier(score);
+    if (!tier) continue;
+    matches.push({
+      skillName: name,
+      score: Math.round(score * 100) / 100,
+      tier,
+      matchReasons: [`Related to: ${parentName}`, ...buildMatchReasons(entry, signals)],
+      category: inferCategory(entry),
+      when: inferWhen(name, entry)
+    });
+  }
+  matches.sort((a, b) => b.score - a.score);
+  return matches;
+}
+function matchContent(index, signals) {
+  const startTime = performance.now();
+  const scored = scoreAllSkills(index, signals);
+  const expansions = expandRelatedSkills(scored, index);
+  const matches = buildMatchList(scored, expansions, signals);
+  return {
+    matches,
+    signalsUsed: signals,
+    scanDuration: Math.round(performance.now() - startTime)
+  };
+}
+
+// src/skill/skills-md-writer.ts
+function generateSkillsMd(featureName, result, totalSkillCount) {
+  const lines = [];
+  lines.push(`# Recommended Skills: ${featureName}`);
+  lines.push("");
+  lines.push("> Auto-generated by Pipeline Skill Advisor. Review and adjust as needed.");
+  const apply = result.matches.filter((m) => m.tier === "apply");
+  const reference = result.matches.filter((m) => m.tier === "reference");
+  const consider = result.matches.filter((m) => m.tier === "consider");
+  if (apply.length > 0) {
+    lines.push("");
+    lines.push("## Apply (invoke during execution)");
+    lines.push("");
+    lines.push(...renderTable(apply));
+  }
+  if (reference.length > 0) {
+    lines.push("");
+    lines.push("## Reference (load as context)");
+    lines.push("");
+    lines.push(...renderTable(reference));
+  }
+  if (consider.length > 0) {
+    lines.push("");
+    lines.push("## Consider");
+    lines.push("");
+    lines.push(...renderTable(consider));
+  }
+  lines.push("");
+  lines.push("---");
+  const skillsScanned = totalSkillCount ?? result.matches.length;
+  const keywords = result.signalsUsed.specKeywords.length;
+  const stack = result.signalsUsed.stackSignals.length;
+  const domains = result.signalsUsed.featureDomain.length;
+  lines.push(
+    `*Scanned ${skillsScanned} skills in ${result.scanDuration}ms. Signals: ${keywords} keywords, ${stack} stack markers, ${domains} domains.*`
+  );
+  lines.push("");
+  return lines.join("\n");
+}
+function renderTable(matches) {
+  const lines = [];
+  lines.push("| Skill | Purpose | When | Relevance |");
+  lines.push("|-------|---------|------|-----------|");
+  for (const match of matches) {
+    const purpose = match.matchReasons.join("; ");
+    lines.push(`| \`${match.skillName}\` | ${purpose} | ${match.when} | ${match.score} |`);
+  }
+  return lines;
+}
+
+// src/commands/advise-skills.ts
+function readPackageDeps(cwd) {
+  const pkgPath = path20.join(cwd, "package.json");
+  if (!fs17.existsSync(pkgPath)) return { deps: {}, devDeps: {} };
+  try {
+    const pkg = JSON.parse(fs17.readFileSync(pkgPath, "utf-8"));
+    const deps = typeof pkg.dependencies === "object" && pkg.dependencies !== null ? pkg.dependencies : {};
+    const devDeps = typeof pkg.devDependencies === "object" && pkg.devDependencies !== null ? pkg.devDependencies : {};
+    return { deps, devDeps };
+  } catch {
+    return { deps: {}, devDeps: {} };
+  }
+}
+function readSpecText(specPath) {
+  if (!fs17.existsSync(specPath)) {
+    throw new Error(`Spec not found: ${specPath}`);
+  }
+  return fs17.readFileSync(specPath, "utf-8");
+}
+function filterMatchesByTier(result, top, thorough) {
+  const applySkills = result.matches.filter((m) => m.tier === "apply").slice(0, top);
+  const refSkills = result.matches.filter((m) => m.tier === "reference").slice(0, top * 2);
+  const considerSkills = thorough ? result.matches.filter((m) => m.tier === "consider").slice(0, top) : [];
+  return { ...result, matches: [...applySkills, ...refSkills, ...considerSkills] };
+}
+function extractFeatureName(specText, specPath) {
+  const titleMatch = specText.match(/^#\s+(.+)/m);
+  return titleMatch?.[1] ?? path20.basename(path20.dirname(specPath));
+}
+async function runAdviseSkills(options) {
+  const cwd = options.cwd ?? process.cwd();
+  const specPath = path20.resolve(cwd, options.specPath);
+  const specText = readSpecText(specPath);
+  const { deps, devDeps } = readPackageDeps(cwd);
+  const signals = extractSignals(specText, deps, devDeps);
+  const configResult = resolveConfig();
+  const tierOverrides = configResult.ok ? configResult.value.skills?.tierOverrides : void 0;
+  const index = loadOrRebuildIndex("claude-code", cwd, tierOverrides);
+  const totalSkills = Object.keys(index.skills).length;
+  const result = matchContent(index, signals);
+  const filteredResult = filterMatchesByTier(result, options.top ?? 5, !!options.thorough);
+  const featureName = extractFeatureName(specText, specPath);
+  const skillsMdPath = path20.join(path20.dirname(specPath), "SKILLS.md");
+  const md = generateSkillsMd(featureName, filteredResult, totalSkills);
+  fs17.writeFileSync(skillsMdPath, md, "utf-8");
+  return { result: filteredResult, skillsMdPath, featureName, totalSkills };
+}
+function formatOutput(featureName, result, skillsMdPath, totalSkills) {
+  const apply = result.matches.filter((m) => m.tier === "apply");
+  const ref = result.matches.filter((m) => m.tier === "reference");
+  const consider = result.matches.filter((m) => m.tier === "consider");
+  const lines = [];
+  lines.push(`Skill Advisor: Found ${result.matches.length} relevant skills for "${featureName}"`);
+  lines.push("");
+  if (apply.length > 0) {
+    lines.push(chalk.green(`  Apply (${apply.length}):`));
+    for (const m of apply) {
+      lines.push(`    ${m.skillName}  (${m.score}) \u2014 ${m.when}`);
+    }
+  }
+  if (ref.length > 0) {
+    lines.push(chalk.blue(`  Reference (${ref.length}):`));
+    for (const m of ref) {
+      lines.push(`    ${m.skillName}  (${m.score}) \u2014 ${m.when}`);
+    }
+  }
+  if (consider.length > 0) {
+    lines.push(chalk.dim(`  Consider (${consider.length}):`));
+    for (const m of consider) {
+      lines.push(`    ${m.skillName}  (${m.score}) \u2014 ${m.when}`);
+    }
+  }
+  lines.push("");
+  lines.push(`Scanned ${totalSkills} skills in ${result.scanDuration}ms`);
+  lines.push(`Written to ${skillsMdPath}`);
+  return lines.join("\n");
+}
+function createAdviseSkillsCommand() {
+  return new Command2("advise-skills").description("Content-based skill recommendations for a spec").requiredOption("--spec-path <path>", "Path to the spec (proposal.md)").option("--thorough", "Include Consider tier in output").option("--top <n>", "Max skills per tier (default 5)", parseInt).option("--json", "Output as JSON").action(async (opts) => {
+    try {
+      const { result, skillsMdPath, featureName, totalSkills } = await runAdviseSkills({
+        specPath: opts.specPath,
+        thorough: opts.thorough,
+        top: opts.top
+      });
+      if (opts.json) {
+        logger.info(JSON.stringify(result, null, 2));
+      } else {
+        logger.info(formatOutput(featureName, result, skillsMdPath, totalSkills));
+      }
+    } catch (err) {
+      logger.error(err.message);
+      process.exit(1);
+    }
+  });
+}
+
+// src/mcp/tools/advise-skills.ts
+var adviseSkillsDefinition = {
+  name: "advise_skills",
+  description: "Content-based skill recommendations for a spec or feature description. Returns tiered matches with purpose and timing guidance.",
+  inputSchema: {
+    type: "object",
+    properties: {
+      path: {
+        type: "string",
+        description: "Project root path (defaults to cwd)"
+      },
+      specPath: {
+        type: "string",
+        description: "Path to the spec file (proposal.md), relative to project root"
+      },
+      thorough: {
+        type: "boolean",
+        description: "Include Consider tier in output"
+      },
+      top: {
+        type: "number",
+        description: "Max skills per tier (default 5 apply, 10 reference)"
+      }
+    },
+    required: ["specPath"]
+  }
+};
+async function handleAdviseSkills(input) {
+  const projectRoot = input.path || process.cwd();
+  const specRelPath = input.specPath;
+  const thorough = input.thorough || false;
+  const top = input.top || 5;
+  try {
+    const { result, skillsMdPath, featureName, totalSkills } = await runAdviseSkills({
+      specPath: specRelPath,
+      cwd: projectRoot,
+      thorough,
+      top
+    });
+    const response = {
+      featureName,
+      skillsPath: path21.relative(projectRoot, skillsMdPath).replaceAll("\\", "/"),
+      totalScanned: totalSkills,
+      scanDuration: result.scanDuration,
+      apply: result.matches.filter((m) => m.tier === "apply").map((m) => ({
+        skill: m.skillName,
+        score: m.score,
+        when: m.when,
+        reasons: m.matchReasons
+      })),
+      reference: result.matches.filter((m) => m.tier === "reference").map((m) => ({
+        skill: m.skillName,
+        score: m.score,
+        when: m.when,
+        reasons: m.matchReasons
+      })),
+      consider: result.matches.filter((m) => m.tier === "consider").map((m) => ({
+        skill: m.skillName,
+        score: m.score,
+        when: m.when,
+        reasons: m.matchReasons
+      }))
+    };
+    return {
+      content: [{ type: "text", text: JSON.stringify(response, null, 2) }]
+    };
+  } catch (err) {
+    return {
+      content: [{ type: "text", text: JSON.stringify({ error: err.message }) }]
+    };
+  }
+}
+
 // src/mcp/tools/compact.ts
 init_dist();
 var COMPACT_TOOL_DEFAULT_BUDGET = 2e3;
@@ -7104,7 +7812,7 @@ function handleContentMode(content, pipeline, budget, source) {
   };
 }
 async function handleIntentMode(projectPath, intent, pipeline, budget, filterContent) {
-  const { loadGraphStore: loadGraphStore2 } = await import("./graph-loader-KXVS3YK3.js");
+  const { loadGraphStore: loadGraphStore2 } = await import("./graph-loader-RDXSEBD7.js");
   const store = await loadGraphStore2(projectPath);
   if (!store) {
     return {
@@ -7117,7 +7825,7 @@ async function handleIntentMode(projectPath, intent, pipeline, budget, filterCon
       isError: true
     };
   }
-  const { PackedSummaryCache, FusionLayer, ContextQL } = await import("./dist-HPWNWCT6.js");
+  const { PackedSummaryCache, FusionLayer, ContextQL } = await import("./dist-NCNAXUFD.js");
   const cache = new PackedSummaryCache(store);
   const cachedEnvelope = cache.get(intent);
   if (cachedEnvelope) {
@@ -7330,7 +8038,7 @@ async function handleDetectConstraintEmergence(input) {
     }
     const nodePath = await import("path");
     const historyPath = nodePath.resolve(projectPath, ".harness/arch/violation-history.json");
-    const { ViolationHistoryManager, detectEmergentConstraints } = await import("./dist-ZV6GO6FA.js");
+    const { ViolationHistoryManager, detectEmergentConstraints } = await import("./dist-CJDGASPP.js");
     const manager = new ViolationHistoryManager(historyPath);
     const history = manager.load();
     const options = { windowWeeks, minOccurrences };
@@ -7415,6 +8123,7 @@ var TOOL_DEFINITIONS = [
   checkTraceabilityDefinition,
   predictFailuresDefinition,
   recommendSkillsDefinition,
+  adviseSkillsDefinition,
   computeBlastRadiusDefinition,
   dispatchSkillsDefinition,
   compactToolDefinition,
@@ -7475,6 +8184,7 @@ var TOOL_HANDLERS = {
   check_traceability: handleCheckTraceability,
   predict_failures: handlePredictFailures,
   recommend_skills: handleRecommendSkills,
+  advise_skills: handleAdviseSkills,
   compute_blast_radius: handleComputeBlastRadius,
   dispatch_skills: handleDispatchSkills,
   compact: handleCompact,
@@ -7580,7 +8290,7 @@ async function appendUpdateNotification(result, resolvedRoot) {
       shouldRunCheck,
       readCheckState,
       spawnBackgroundCheck
-    } = await import("./dist-ZV6GO6FA.js");
+    } = await import("./dist-CJDGASPP.js");
     const { CLI_VERSION } = await import("./version-CUI434OP.js");
     const configInterval = readConfigInterval(resolvedRoot);
     const DEFAULT_INTERVAL = 864e5;
@@ -7674,6 +8384,8 @@ async function startServer(toolFilter) {
 }
 
 export {
+  loadOrRebuildIndex,
+  createAdviseSkillsCommand,
   generateSlashCommands,
   handleOrphanDeletion,
   createGenerateSlashCommandsCommand,
@@ -7681,7 +8393,6 @@ export {
   persistToolingConfig,
   ensureHarnessGitignore,
   appendFrameworkAgents,
-  loadOrRebuildIndex,
   isSnapshotFresh,
   loadCachedSnapshot,
   captureHealthSnapshot,