knit-mcp 0.7.1 → 0.8.0

package/README.md

@@ -59,6 +59,27 @@ Adds the Knit MCP server to your Claude Code config (`~/.claude.json`). No per-p
 
 **Supported shells:** macOS, Linux, WSL, Git Bash, and Windows PowerShell. The generated hooks use POSIX-style single-quoted `node -e '…'` payloads. Windows `cmd.exe` does not treat single quotes as delimiters and is not supported as the hook-runner shell — on Windows, use PowerShell (default in modern Windows Terminal) or Git Bash. If you hit a hook error on Windows, file an issue with the shell you're using.
 
+### Quiet mode (no hook enforcement)
+
+Knit ships Protocol Guard in `warn` mode by default — hooks print reminders, they never block. If you want it fully silent (no PreToolUse classification gate, no reminder messages), run this once inside Claude Code:
+
+> `knit_set_protocol_strictness({ level: "off" })`
+
+The other hooks (LEARN compliance, KB metrics, final build verification) stay as observability nudges — they print, they don't gate. To remove them too, see Uninstall below.
+
+### Uninstall
+
+```bash
+rm -rf ~/.knit                                 # all per-project + global memory
+```
+
+Then:
+1. Remove `"knit-brain"` from `mcpServers` in `~/.claude.json`
+2. Delete the `<!-- knit:start --> ... <!-- knit:end -->` block from each project's `CLAUDE.md`
+3. Remove `_knitOwned` entries from each project's `.claude/settings.local.json` (or delete the file if Knit was the only thing in it)
+
+Total time: ~30 seconds per project. Knit doesn't write anywhere else on your machine.
+
 ## How data is stored
 
 Knit data is centralized — not in every repo's working tree:

package/dist/{cache-BVFD5F5Y.js → cache-RRKF2IZ5.js}

@@ -2,13 +2,13 @@ import {
   detectProjectRoot,
   getBrain,
   refreshBrain
-} from "./chunk-X6TGTET3.js";
-import "./chunk-3XR77YJM.js";
-import "./chunk-SLN5ABF5.js";
-import "./chunk-7PPC6IG6.js";
+} from "./chunk-WN4AQFMO.js";
+import "./chunk-N7R4P42P.js";
+import "./chunk-MOOVNMIN.js";
+import "./chunk-JJ367RK5.js";
 import "./chunk-M3YZOJNW.js";
 import "./chunk-BAUQEFYY.js";
-import "./chunk-HBMF62U4.js";
+import "./chunk-SBJMHDBM.js";
 export {
   detectProjectRoot,
   getBrain,

package/dist/{instructions-33TUHLTK.js → chunk-4PFEG4GQ.js}

@@ -24,6 +24,7 @@ The protocol enforces a 4-tier classifier:
 - Complex: cross-domain, types/auth-touching, high-fanout, or any task spanning more than one commit \u2014 full 6 phases with auto plan mode on RESEARCH.
 
 Knit provides inputs; you make the calls. When in doubt, under-classify \u2014 easier to escalate mid-task than to downgrade.`;
+
 export {
   KNIT_INSTRUCTIONS
 };

package/dist/{chunk-7PPC6IG6.js → chunk-JJ367RK5.js}

@@ -271,6 +271,162 @@ function detectGit(root) {
   return { isRepo, defaultBranch, hasRemote };
 }
 
+// src/generators/claude-md.ts
+var KNIT_MARKER_START = "<!-- knit:start -->";
+var KNIT_MARKER_END = "<!-- knit:end -->";
+var LEGACY_ENGRAM_MARKER_START = "<!-- engram:start -->";
+var LEGACY_ENGRAM_MARKER_END = "<!-- engram:end -->";
+function generateClaudeMd(config, knowledge, falsePositives) {
+  const sections = [
+    generateHeader(config),
+    generateSessionStartup(),
+    knowledge ? generateProjectMap(knowledge) : null,
+    generateDomainArchitecture(config),
+    falsePositives && falsePositives.length > 0 ? generateFalsePositives(falsePositives) : null,
+    generateBuildGates(config),
+    generateTierVocabulary(),
+    generateWorkflowPointer()
+  ];
+  const body = sections.filter(Boolean).join("\n\n---\n\n");
+  return `${KNIT_MARKER_START}
+
+${body}
+
+${KNIT_MARKER_END}
+`;
+}
+function spliceKnitBlock(existing, newBlock) {
+  const markerPairs = [
+    [KNIT_MARKER_START, KNIT_MARKER_END],
+    [LEGACY_ENGRAM_MARKER_START, LEGACY_ENGRAM_MARKER_END]
+  ];
+  for (const [startMarker, endMarker] of markerPairs) {
+    const startIdx = existing.indexOf(startMarker);
+    const endIdx = existing.indexOf(endMarker);
+    if (startIdx !== -1 && endIdx !== -1 && endIdx > startIdx) {
+      const before = existing.slice(0, startIdx);
+      const after = existing.slice(endIdx + endMarker.length);
+      return { content: before + newBlock.trimEnd() + after, mode: "replaced" };
+    }
+  }
+  return { content: existing, mode: "sidecar-needed" };
+}
+function generateHeader(config) {
+  const stackParts = [
+    config.stack.language !== "unknown" ? config.stack.language : null,
+    config.stack.framework
+  ].filter(Boolean);
+  const stackDesc = stackParts.length > 0 ? `${stackParts.join(" + ")} project. ` : "";
+  return `# ${config.name}
+
+${stackDesc}Knit-powered workflow. The protocol depth is fetched on demand via \`knit_get_workflow({phase})\` \u2014 this file holds only project-specific facts.`;
+}
+function generateSessionStartup() {
+  return `## Session start
+
+First action: call \`knit_load_session\`. One MCP call returns last sessions, handoff, learnings, false positives. If \`handoff.md\` exists at the repo root, resume that work first.
+
+Protocol Guard runs in \`warn\` mode by default \u2014 adjust with \`knit_set_protocol_strictness\`.`;
+}
+function generateProjectMap(knowledge) {
+  const { summary } = knowledge;
+  let content = `## Project Map (auto-generated)
+
+`;
+  if (summary.entryPoints.length > 0) {
+    content += `**Entry points:** \`${summary.entryPoints.join("`, `")}\`
+`;
+  }
+  if (summary.highFanoutFiles.length > 0) {
+    const shown = summary.highFanoutFiles.slice(0, 5);
+    content += `**High-fanout (change carefully):** \`${shown.join("`, `")}\``;
+    if (summary.highFanoutFiles.length > 5) {
+      content += ` (+${summary.highFanoutFiles.length - 5} more \u2014 \`knit_find_fanout\`)`;
+    }
+    content += "\n";
+  }
+  if (summary.untestedFiles.length > 0) {
+    const shown = summary.untestedFiles.slice(0, 3);
+    content += `**Untested:** \`${shown.join("`, `")}\``;
+    if (summary.untestedFiles.length > 3) {
+      content += ` (+${summary.untestedFiles.length - 3} more \u2014 \`knit_query_tests({filter:"untested"})\`)`;
+    }
+    content += "\n";
+  }
+  if (summary.largestFiles.length > 0) {
+    const top3 = summary.largestFiles.slice(0, 3);
+    const list = top3.map((f) => `\`${f.path}\` (${f.lines})`).join(", ");
+    content += `**Largest:** ${list}
+`;
+  }
+  content += `
+**Stats:** ${summary.totalFiles} files, ${summary.totalLines.toLocaleString()} lines`;
+  const langs = Object.entries(summary.languageBreakdown).sort((a, b) => b[1] - a[1]).slice(0, 3).map(([ext, count]) => `${ext}: ${count}`);
+  if (langs.length > 0) content += ` (${langs.join(", ")})`;
+  return content;
+}
+function generateDomainArchitecture(config) {
+  if (!config.domains || config.domains.length === 0) {
+    return `## Domain Architecture
+
+No domains detected. Use \`knit_setup_project\` to describe your project \u2014 Knit will configure domains and review agents.`;
+  }
+  const rows = config.domains.map((d) => {
+    const patterns = d.filePatterns.slice(0, 3).join(", ");
+    const agents = d.agents.join(", ");
+    return `### ${d.name}
+**Files:** \`${patterns}\`
+**Concern:** ${d.description}
+**Review agents:** \`${agents}\``;
+  }).join("\n\n");
+  return `## Domain Architecture
+
+${rows}`;
+}
+function generateFalsePositives(fps) {
+  const items = fps.slice(0, 10).map((fp) => `- **${fp.summary}** \u2014 ${fp.lesson}`).join("\n");
+  return `## Known False Positives
+
+Review agents should NOT re-flag these \u2014 they're confirmed non-issues from prior sessions:
+
+${items}`;
+}
+function generateBuildGates(config) {
+  const gates = [];
+  if (config.stack.typecheckCommand) gates.push(`- \`${config.stack.typecheckCommand}\``);
+  if (config.stack.lintCommand) gates.push(`- \`${config.stack.lintCommand}\``);
+  if (config.stack.testFramework) {
+    const pm = config.packageManager === "unknown" ? "npm" : config.packageManager;
+    gates.push(`- \`${pm} test\``);
+  }
+  if (config.stack.buildCommand) gates.push(`- \`${config.stack.buildCommand}\``);
+  if (gates.length === 0) {
+    return `## Build Gates
+
+No build gates auto-detected. Add typecheck/lint/test/build commands to your package.json.`;
+  }
+  return `## Build Gates
+
+All must pass before commit:
+
+${gates.join("\n")}`;
+}
+function generateTierVocabulary() {
+  return `## Tier vocabulary
+
+| Tier | When |
+|------|------|
+| **Inquiry** | Read-only ("what", "where", "audit") \u2014 just answer. |
+| **Trivial** | One-line fix \u2014 execute \u2192 verify. |
+| **Standard** | Single-domain bug fix or feature \u2014 research \u2192 execute \u2192 review. |
+| **Complex** | Cross-domain, touches types/auth, high-fanout, or multi-commit arc \u2014 full 6 phases + auto plan mode. |`;
+}
+function generateWorkflowPointer() {
+  return `## Workflow on demand
+
+Fetch any phase via \`knit_get_workflow({phase})\`. Call with no phase to list available sections.`;
+}
+
 export {
   VOLTAGENT_PINNED_SHA,
   VOLTAGENT_REF,
@@ -278,5 +434,11 @@ export {
   categoryOf,
   rawAgentUrl,
   isBundledCore,
-  scanProject
+  scanProject,
+  KNIT_MARKER_START,
+  KNIT_MARKER_END,
+  LEGACY_ENGRAM_MARKER_START,
+  LEGACY_ENGRAM_MARKER_END,
+  generateClaudeMd,
+  spliceKnitBlock
 };

package/dist/{chunk-SLN5ABF5.js → chunk-MOOVNMIN.js}

@@ -358,166 +358,7 @@ function buildReverseDependencies(importGraph) {
   return reverse;
 }
 
-// src/generators/claude-md.ts
-var KNIT_MARKER_START = "<!-- knit:start -->";
-var KNIT_MARKER_END = "<!-- knit:end -->";
-var LEGACY_ENGRAM_MARKER_START = "<!-- engram:start -->";
-var LEGACY_ENGRAM_MARKER_END = "<!-- engram:end -->";
-function generateClaudeMd(config, knowledge, falsePositives) {
-  const sections = [
-    generateHeader(config),
-    generateSessionStartup(),
-    knowledge ? generateProjectMap(knowledge) : null,
-    generateDomainArchitecture(config),
-    falsePositives && falsePositives.length > 0 ? generateFalsePositives(falsePositives) : null,
-    generateBuildGates(config),
-    generateTierVocabulary(),
-    generateWorkflowPointer()
-  ];
-  const body = sections.filter(Boolean).join("\n\n---\n\n");
-  return `${KNIT_MARKER_START}
-
-${body}
-
-${KNIT_MARKER_END}
-`;
-}
-function spliceKnitBlock(existing, newBlock) {
-  const markerPairs = [
-    [KNIT_MARKER_START, KNIT_MARKER_END],
-    [LEGACY_ENGRAM_MARKER_START, LEGACY_ENGRAM_MARKER_END]
-  ];
-  for (const [startMarker, endMarker] of markerPairs) {
-    const startIdx = existing.indexOf(startMarker);
-    const endIdx = existing.indexOf(endMarker);
-    if (startIdx !== -1 && endIdx !== -1 && endIdx > startIdx) {
-      const before = existing.slice(0, startIdx);
-      const after = existing.slice(endIdx + endMarker.length);
-      return { content: before + newBlock.trimEnd() + after, mode: "replaced" };
-    }
-  }
-  return { content: existing, mode: "sidecar-needed" };
-}
-function generateHeader(config) {
-  const stackParts = [
-    config.stack.language !== "unknown" ? config.stack.language : null,
-    config.stack.framework
-  ].filter(Boolean);
-  const stackDesc = stackParts.length > 0 ? `${stackParts.join(" + ")} project. ` : "";
-  return `# ${config.name}
-
-${stackDesc}Knit-powered workflow. The protocol depth is fetched on demand via \`knit_get_workflow({phase})\` \u2014 this file holds only project-specific facts.`;
-}
-function generateSessionStartup() {
-  return `## Session start
-
-First action: call \`knit_load_session\`. One MCP call returns last sessions, handoff, learnings, false positives. If \`handoff.md\` exists at the repo root, resume that work first.
-
-Protocol Guard runs in \`warn\` mode by default \u2014 adjust with \`knit_set_protocol_strictness\`.`;
-}
-function generateProjectMap(knowledge) {
-  const { summary } = knowledge;
-  let content = `## Project Map (auto-generated)
-
-`;
-  if (summary.entryPoints.length > 0) {
-    content += `**Entry points:** \`${summary.entryPoints.join("`, `")}\`
-`;
-  }
-  if (summary.highFanoutFiles.length > 0) {
-    const shown = summary.highFanoutFiles.slice(0, 5);
-    content += `**High-fanout (change carefully):** \`${shown.join("`, `")}\``;
-    if (summary.highFanoutFiles.length > 5) {
-      content += ` (+${summary.highFanoutFiles.length - 5} more \u2014 \`knit_find_fanout\`)`;
-    }
-    content += "\n";
-  }
-  if (summary.untestedFiles.length > 0) {
-    const shown = summary.untestedFiles.slice(0, 3);
-    content += `**Untested:** \`${shown.join("`, `")}\``;
-    if (summary.untestedFiles.length > 3) {
-      content += ` (+${summary.untestedFiles.length - 3} more \u2014 \`knit_query_tests({filter:"untested"})\`)`;
-    }
-    content += "\n";
-  }
-  if (summary.largestFiles.length > 0) {
-    const top3 = summary.largestFiles.slice(0, 3);
-    const list = top3.map((f) => `\`${f.path}\` (${f.lines})`).join(", ");
-    content += `**Largest:** ${list}
-`;
-  }
-  content += `
-**Stats:** ${summary.totalFiles} files, ${summary.totalLines.toLocaleString()} lines`;
-  const langs = Object.entries(summary.languageBreakdown).sort((a, b) => b[1] - a[1]).slice(0, 3).map(([ext, count]) => `${ext}: ${count}`);
-  if (langs.length > 0) content += ` (${langs.join(", ")})`;
-  return content;
-}
-function generateDomainArchitecture(config) {
-  if (!config.domains || config.domains.length === 0) {
-    return `## Domain Architecture
-
-No domains detected. Use \`knit_setup_project\` to describe your project \u2014 Knit will configure domains and review agents.`;
-  }
-  const rows = config.domains.map((d) => {
-    const patterns = d.filePatterns.slice(0, 3).join(", ");
-    const agents = d.agents.join(", ");
-    return `### ${d.name}
-**Files:** \`${patterns}\`
-**Concern:** ${d.description}
-**Review agents:** \`${agents}\``;
-  }).join("\n\n");
-  return `## Domain Architecture
-
-${rows}`;
-}
-function generateFalsePositives(fps) {
-  const items = fps.slice(0, 10).map((fp) => `- **${fp.summary}** \u2014 ${fp.lesson}`).join("\n");
-  return `## Known False Positives
-
-Review agents should NOT re-flag these \u2014 they're confirmed non-issues from prior sessions:
-
-${items}`;
-}
-function generateBuildGates(config) {
-  const gates = [];
-  if (config.stack.typecheckCommand) gates.push(`- \`${config.stack.typecheckCommand}\``);
-  if (config.stack.lintCommand) gates.push(`- \`${config.stack.lintCommand}\``);
-  if (config.stack.testFramework) {
-    const pm = config.packageManager === "unknown" ? "npm" : config.packageManager;
-    gates.push(`- \`${pm} test\``);
-  }
-  if (config.stack.buildCommand) gates.push(`- \`${config.stack.buildCommand}\``);
-  if (gates.length === 0) {
-    return `## Build Gates
-
-No build gates auto-detected. Add typecheck/lint/test/build commands to your package.json.`;
-  }
-  return `## Build Gates
-
-All must pass before commit:
-
-${gates.join("\n")}`;
-}
-function generateTierVocabulary() {
-  return `## Tier vocabulary
-
-| Tier | When |
-|------|------|
-| **Inquiry** | Read-only ("what", "where", "audit") \u2014 just answer. |
-| **Trivial** | One-line fix \u2014 execute \u2192 verify. |
-| **Standard** | Single-domain bug fix or feature \u2014 research \u2192 execute \u2192 review. |
-| **Complex** | Cross-domain, touches types/auth, high-fanout, or multi-commit arc \u2014 full 6 phases + auto plan mode. |`;
-}
-function generateWorkflowPointer() {
-  return `## Workflow on demand
-
-Fetch any phase via \`knit_get_workflow({phase})\`. Call with no phase to list available sections.`;
-}
-
 export {
   buildKnowledge,
-  buildReverseDependencies,
-  KNIT_MARKER_START,
-  generateClaudeMd,
-  spliceKnitBlock
+  buildReverseDependencies
 };