knit-mcp 0.6.4 → 0.7.0

package/dist/{tools-PB7IDFNS.js → tools-KRPOUYNT.js}

@@ -5,7 +5,7 @@ import {
   pruneSessionsByAge,
   searchSessions,
   sessionCount
-} from "./chunk-Y3I4NAKM.js";
+} from "./chunk-3XR77YJM.js";
 import {
   scanProject
 } from "./chunk-7PPC6IG6.js";
@@ -14,7 +14,7 @@ import {
   buildGlobalLearning,
   getRecentGlobalLearnings,
   searchGlobalLearnings
-} from "./chunk-FEOG4WTP.js";
+} from "./chunk-TRZ3LD6B.js";
 import {
   addEntry,
   getFalsePositives,
@@ -26,17 +26,19 @@ import {
 import {
   canonicalRepoRoot,
   classificationMarkerPath,
+  featuresConfigPath,
   knowledgebasePath,
   learningsDir,
+  projectAgentsDir,
   projectDataDir,
   protocolConfigPath,
   sessionsLogPath,
   teamsPath,
   worktreesRegistryPath
-} from "./chunk-YI37OAJ7.js";
+} from "./chunk-HBMF62U4.js";
 
 // src/mcp/handlers.ts
-import { writeFileSync as writeFileSync4, readFileSync as readFileSync4, readdirSync, existsSync as existsSync4 } from "fs";
+import { writeFileSync as writeFileSync4, readFileSync as readFileSync4, readdirSync, existsSync as existsSync4, renameSync as renameSync2, unlinkSync } from "fs";
 import { join as join2 } from "path";
 import { statSync as statSync2 } from "fs";
 
@@ -81,9 +83,9 @@ var SECTIONS = {
   tools
 };
 function overview(_) {
-  return `# Engram workflow \u2014 overview
+  return `# Knit workflow \u2014 overview
 
-This protocol is a decision aid. Read once, follow loosely, escalate when something doesn't fit. The principle: engram gives you data; you make the calls.
+This protocol is a decision aid. Read once, follow loosely, escalate when something doesn't fit. The principle: Knit gives you data; you make the calls.
 
 **Navigation:** call \`knit_get_workflow({phase})\` with any of:
 - \`overview\` (this) \xB7 \`tier\` \xB7 \`phases\`
@@ -95,7 +97,7 @@ Start of every session: call \`knit_load_session\` first. It returns prior sessi
 When in doubt: under-classify. Easier to escalate mid-task than to downgrade.`;
 }
 function tier(_) {
-  return `# Tier classification \u2014 you decide, engram informs
+  return `# Tier classification \u2014 you decide, Knit informs
 
 Four tiers. You read the user's message and decide. No regex, no auto-rules.
 
@@ -377,7 +379,7 @@ function spawnWorktree(rootPath, teamName, taskDescription) {
   const repoRoot = canonicalRepoRoot(rootPath);
   const slug = slugify(teamName);
   const ts = Date.now();
-  const branch = `engram/team-${slug}-${ts}`;
+  const branch = `knit/team-${slug}-${ts}`;
   const worktreePath = resolve(dirname(repoRoot), `${basename(repoRoot)}-knit-${slug}-${ts}`);
   if (existsSync(worktreePath)) {
     throw new Error(`Worktree path already exists: ${worktreePath}`);
@@ -692,6 +694,108 @@ function redactSecrets(input) {
   return out;
 }
 
+// src/mcp/features.ts
+var TOOL_REGISTRY = [
+  // ── Tier 1 — Memory + retrieval (8) ─────────────────────────────
+  { tool: "knit_load_session", tier: 1, category: "memory", rationale: "Session-start primer; universal" },
+  { tool: "knit_search_learnings", tier: 1, category: "memory", rationale: "Project-local learnings lookup; universal" },
+  { tool: "knit_search_global_learnings", tier: 1, category: "memory", rationale: "Cross-project learnings pool; seeded by default" },
+  { tool: "knit_search_sessions", tier: 1, category: "memory", rationale: '"Have I done this before?" \u2014 universal' },
+  { tool: "knit_record_learning", tier: 1, category: "memory", rationale: "LEARN step persistence; universal" },
+  { tool: "knit_record_global_learning", tier: 1, category: "memory", rationale: "Cross-project memory write; useful from day one" },
+  { tool: "knit_save_session_summary", tier: 1, category: "memory", rationale: "Session-end persistence; universal" },
+  { tool: "knit_save_handoff", tier: 1, category: "memory", rationale: "Context-degradation handoff; universal" },
+  // ── Tier 1 — Knowledge graph (5) ────────────────────────────────
+  { tool: "knit_query_imports", tier: 1, category: "knowledge-graph", rationale: "Core differentiator; returns empty honestly on docs-only projects" },
+  { tool: "knit_query_exports", tier: 1, category: "knowledge-graph", rationale: "Core differentiator; same honest-empty behavior" },
+  { tool: "knit_query_dependents", tier: 1, category: "knowledge-graph", rationale: "Core differentiator" },
+  { tool: "knit_query_tests", tier: 1, category: "knowledge-graph", rationale: "Core differentiator" },
+  { tool: "knit_find_fanout", tier: 1, category: "knowledge-graph", rationale: "Core differentiator" },
+  // ── Tier 1 — Workflow + classification (4) ──────────────────────
+  { tool: "knit_classify_task", tier: 1, category: "workflow", rationale: "Tier router; called before any non-trivial task" },
+  { tool: "knit_build_context", tier: 1, category: "workflow", rationale: "Domain Context Object builder" },
+  { tool: "knit_get_workflow", tier: 1, category: "workflow", rationale: "On-demand phase depth fetcher" },
+  { tool: "knit_get_suggestions", tier: 1, category: "workflow", rationale: "Adaptive warnings from past patterns" },
+  // ── Tier 1 — False positives + reflection (3) ───────────────────
+  { tool: "knit_record_false_positive", tier: 1, category: "fp-reflection", rationale: "Universal \u2014 reviewer agents flag FPs on any project" },
+  { tool: "knit_get_false_positives", tier: 1, category: "fp-reflection", rationale: "Universal" },
+  { tool: "knit_reflect", tier: 1, category: "fp-reflection", rationale: 'Returns "not enough data" on sparse projects; always available' },
+  // ── Tier 1 — Protocol Guard config (2) ──────────────────────────
+  { tool: "knit_set_protocol_strictness", tier: 1, category: "protocol-config", rationale: "Universal \u2014 every install ships Protocol Guard" },
+  { tool: "knit_get_protocol_strictness", tier: 1, category: "protocol-config", rationale: "Universal" },
+  // ── Tier 1 — Diagnostics + meta (4) ─────────────────────────────
+  { tool: "knit_brain_status", tier: 1, category: "diagnostics", rationale: "Health + token-accounting; universal" },
+  { tool: "knit_list_features", tier: 1, category: "diagnostics", rationale: "The discoverability escape hatch itself" },
+  { tool: "knit_enable_feature", tier: 1, category: "diagnostics", rationale: "Flip on a Tier-2/3 feature flag \u2014 must always be reachable so hidden tools are recoverable" },
+  { tool: "knit_disable_feature", tier: 1, category: "diagnostics", rationale: "Flip off a previously-enabled feature flag" },
+  // ── Tier 2 — Team worktrees (9) ─────────────────────────────────
+  { tool: "knit_spawn_team_worktree", tier: 2, category: "teams", rationale: "Multi-domain parallel write orchestration", enable_via: 'knit_enable_feature("teams") or auto-exposed when \u22653 domains detected' },
+  { tool: "knit_finalize_team_worktree", tier: 2, category: "teams", rationale: "Merge/discard a team worktree", enable_via: 'knit_enable_feature("teams")' },
+  { tool: "knit_list_team_worktrees", tier: 2, category: "teams", rationale: "Active team worktree registry", enable_via: 'knit_enable_feature("teams")' },
+  { tool: "knit_define_team", tier: 2, category: "teams", rationale: "Custom team definition", enable_via: 'knit_enable_feature("teams")' },
+  { tool: "knit_get_teams", tier: 2, category: "teams", rationale: "List configured teams", enable_via: 'knit_enable_feature("teams")' },
+  { tool: "knit_get_team_prompt", tier: 2, category: "teams", rationale: "Team-specific agent prompt", enable_via: 'knit_enable_feature("teams")' },
+  { tool: "knit_start_team_review", tier: 2, category: "teams", rationale: "Begin a multi-team review", enable_via: 'knit_enable_feature("teams")' },
+  { tool: "knit_post_team_findings", tier: 2, category: "teams", rationale: "Submit team findings to shared board", enable_via: 'knit_enable_feature("teams")' },
+  { tool: "knit_get_board_summary", tier: 2, category: "teams", rationale: "Roll up team findings", enable_via: 'knit_enable_feature("teams")' },
+  // ── Tier 2 — Subagents (1) ──────────────────────────────────────
+  { tool: "knit_install_agent", tier: 2, category: "subagents", rationale: "VoltAgent subagent installer", enable_via: 'Auto-exposed when .claude/agents/ exists or knit_enable_feature("subagents")' },
+  // ── Tier 3 — Admin (1) ──────────────────────────────────────────
+  { tool: "knit_prune_sessions", tier: 3, category: "admin", rationale: "Manual session pruning; auto-prune handles this normally", enable_via: 'knit_enable_feature("admin")' },
+  // ── Tier 3 — One-time setup (1) ─────────────────────────────────
+  { tool: "knit_setup_project", tier: 3, category: "admin", rationale: "Initial bootstrap only; hidden after first run", enable_via: 'knit_enable_feature("admin") or pass through auto-init' }
+];
+function isToolActive(info, shape) {
+  if (info.tier === 1) return true;
+  if (info.tier === 3) return shape.enabledFeatures.has("admin");
+  if (info.category === "teams") {
+    return shape.domainCount >= 3 || shape.enabledFeatures.has("teams");
+  }
+  if (info.category === "subagents") {
+    return shape.hasInstalledSubagents || shape.enabledFeatures.has("subagents");
+  }
+  return false;
+}
+function computeFeatureListing(shape) {
+  const active = [];
+  const available = [];
+  const by_category = {
+    memory: { active: 0, available: 0 },
+    "knowledge-graph": { active: 0, available: 0 },
+    workflow: { active: 0, available: 0 },
+    "fp-reflection": { active: 0, available: 0 },
+    "protocol-config": { active: 0, available: 0 },
+    diagnostics: { active: 0, available: 0 },
+    teams: { active: 0, available: 0 },
+    subagents: { active: 0, available: 0 },
+    admin: { active: 0, available: 0 }
+  };
+  for (const info of TOOL_REGISTRY) {
+    if (isToolActive(info, shape)) {
+      active.push({ name: info.tool, tier: info.tier, category: info.category });
+      by_category[info.category].active++;
+    } else {
+      available.push({
+        name: info.tool,
+        tier: info.tier,
+        category: info.category,
+        reason: info.rationale,
+        enable_via: info.enable_via
+      });
+      by_category[info.category].available++;
+    }
+  }
+  return {
+    active,
+    available,
+    totals: { active: active.length, available: available.length, total: TOOL_REGISTRY.length },
+    by_category
+  };
+}
+function isEnableableFeature(name) {
+  return name === "teams" || name === "subagents" || name === "admin";
+}
+
 // src/engine/teams.ts
 import { readFileSync as readFileSync2, writeFileSync as writeFileSync2, statSync, existsSync as existsSync2, mkdirSync as mkdirSync2 } from "fs";
 import { dirname as dirname2 } from "path";
@@ -1059,6 +1163,112 @@ function handleBrainStatus(_params, brain) {
     instruction: "Brain is ready. Next: call knit_classify_task with the files you plan to touch to get your tier and phases."
   });
 }
+function loadEnabledFeatures(rootPath) {
+  const enabled = /* @__PURE__ */ new Set();
+  try {
+    const path = featuresConfigPath(rootPath);
+    if (!existsSync4(path)) return enabled;
+    const parsed = JSON.parse(readFileSync4(path, "utf-8"));
+    if (Array.isArray(parsed?.enabled)) {
+      for (const name of parsed.enabled) {
+        if (isEnableableFeature(name)) enabled.add(name);
+      }
+    }
+  } catch {
+  }
+  return enabled;
+}
+function saveEnabledFeatures(rootPath, enabled) {
+  const path = featuresConfigPath(rootPath);
+  const payload = {
+    enabled: [...enabled].sort(),
+    updatedAt: (/* @__PURE__ */ new Date()).toISOString()
+  };
+  const tmpPath = `${path}.tmp-${process.pid}-${Date.now()}`;
+  try {
+    writeFileSync4(tmpPath, JSON.stringify(payload, null, 2), "utf-8");
+    renameSync2(tmpPath, path);
+  } catch (err) {
+    try {
+      unlinkSync(tmpPath);
+    } catch {
+    }
+    throw err;
+  }
+}
+function detectProjectShape(brain) {
+  return {
+    hasAnalyzableCode: brain.knowledge.summary.totalFiles >= 10,
+    domainCount: brain.config.domains?.length ?? 0,
+    hasInstalledSubagents: existsSync4(projectAgentsDir(brain.rootPath)),
+    sessionCount: sessionCount(brain.rootPath),
+    enabledFeatures: loadEnabledFeatures(brain.rootPath)
+  };
+}
+function handleListFeatures(_params, brain) {
+  const shape = detectProjectShape(brain);
+  const listing = computeFeatureListing(shape);
+  return JSON.stringify({
+    ...listing,
+    project_shape: {
+      has_analyzable_code: shape.hasAnalyzableCode,
+      domain_count: shape.domainCount,
+      has_installed_subagents: shape.hasInstalledSubagents,
+      session_count: shape.sessionCount,
+      enabled_features: [...shape.enabledFeatures]
+    },
+    instruction: 'If a tool you want is in `available` rather than `active`, the `enable_via` field tells you how to switch it on. Most commonly: knit_enable_feature({ feature: "teams" | "subagents" | "admin" }).'
+  });
+}
+function handleEnableFeature(params, brain) {
+  const feature = (params.feature || "").trim().toLowerCase();
+  if (!isEnableableFeature(feature)) {
+    return JSON.stringify({
+      status: "error",
+      error: `Invalid feature: "${params.feature}". Valid values: teams, subagents, admin.`
+    });
+  }
+  const enabled = loadEnabledFeatures(brain.rootPath);
+  const wasAlreadyOn = enabled.has(feature);
+  enabled.add(feature);
+  if (!wasAlreadyOn) {
+    saveEnabledFeatures(brain.rootPath, enabled);
+  }
+  return JSON.stringify({
+    status: wasAlreadyOn ? "already-enabled" : "enabled",
+    feature,
+    enabled_features: [...enabled].sort(),
+    instruction: "New tools may now appear in tools/list on the next request. Call knit_list_features to confirm."
+  });
+}
+function handleDisableFeature(params, brain) {
+  const feature = (params.feature || "").trim().toLowerCase();
+  if (!isEnableableFeature(feature)) {
+    return JSON.stringify({
+      status: "error",
+      error: `Invalid feature: "${params.feature}". Valid values: teams, subagents, admin.`
+    });
+  }
+  const enabled = loadEnabledFeatures(brain.rootPath);
+  const wasOn = enabled.delete(feature);
+  if (wasOn) {
+    saveEnabledFeatures(brain.rootPath, enabled);
+  }
+  return JSON.stringify({
+    status: wasOn ? "disabled" : "already-disabled",
+    feature,
+    enabled_features: [...enabled].sort(),
+    instruction: "Disabled tools will be filtered out of tools/list on the next request."
+  });
+}
+function detectsInquiryIntent(description) {
+  if (!description) return false;
+  const inquiryStart = /^\s*(what|where|how|why|when|which|who|can|could|should|does|do|is|are|will|would|tell\s+me|show\s+me|find|list|status\s+of|audit|explain|investigate|analyze|review|describe|summari[sz]e|inspect)\b/i;
+  const inquiryVerb = /\b(audit|explain|investigate|analy[sz]e|review|examine|describe|summari[sz]e|enumerate|inspect)\b/i;
+  const actionDirective = /\b(fix|implement|build|add|refactor|ship|deploy|write|create|update|modify|change|edit|migrate|rename|delete|remove|install|setup|configure|merge|publish|release|patch)\s+(this|that|it|the|a|an|all|every|my|our|your)\b/i;
+  if (actionDirective.test(description)) return false;
+  return inquiryStart.test(description) || inquiryVerb.test(description);
+}
 function handleClassifyTask(params, brain) {
   const rawFiles = (params.files_to_touch || "").split(",").map((f) => f.trim()).filter(Boolean);
   const files = rawFiles.filter((f) => f !== "unknown");
@@ -1069,6 +1279,27 @@ function handleClassifyTask(params, brain) {
     const importers = brain.reverseDeps[file] || [];
     if (importers.length >= 3) crossDomainRipple.push(`${file} is high-fanout (${importers.length} dependents)`);
   }
+  if (detectsInquiryIntent(params.description || "")) {
+    try {
+      writeClassificationMarker(brain.rootPath, {
+        turnId: `${Date.now()}-${process.pid}`,
+        classifiedAt: (/* @__PURE__ */ new Date()).toISOString(),
+        tier: "inquiry",
+        files
+      });
+    } catch {
+    }
+    return JSON.stringify({
+      tier: "inquiry",
+      affected_domains: [...domains],
+      phases: [],
+      files_count: files.length,
+      cross_domain_ripple: crossDomainRipple,
+      auto_plan_mode: false,
+      instruction: "Read-only task. Answer directly \u2014 no plan mode, no LEARN unless something durable surfaced. If scope grows into writes, re-classify with knit_classify_task.",
+      reasoning: `Inquiry: read-only intent detected${files.length > 0 ? `, ${files.length} file(s) referenced for context` : ""}`
+    });
+  }
   const isTypes = files.some((f) => f.includes("types") || f.includes("schema"));
   const isAuth = files.some((f) => f.includes("auth") || f.includes("security"));
   const isNewProject = files.length === 0 || rawFiles.includes("unknown");
@@ -1085,14 +1316,21 @@ function handleClassifyTask(params, brain) {
     });
   } catch {
   }
-  return JSON.stringify({
+  const verbose = params.verbose === "true" || params.verbose === "1";
+  const base = {
     tier: tier2,
     affected_domains: [...domains],
     phases: phases2,
+    auto_plan_mode: tier2 === "complex",
+    instruction
+  };
+  if (!verbose) {
+    return JSON.stringify(base);
+  }
+  return JSON.stringify({
+    ...base,
     files_count: files.length,
     cross_domain_ripple: crossDomainRipple,
-    auto_plan_mode: tier2 === "complex",
-    instruction,
     reasoning: tier2 === "complex" ? `Complex: ${domains.size} domains affected${isTypes ? ", touches shared types" : ""}${isAuth ? ", security-sensitive" : ""}` : tier2 === "standard" ? `Standard: ${domains.size} domain(s), ${files.length} file(s)` : `Trivial: 1 domain, simple change`
   });
 }
@@ -1493,7 +1731,15 @@ function handleSearchGlobalLearnings(params, _brain) {
     instruction: matches.length === 0 ? "No cross-project matches. This area might be new across all your projects." : `Found ${matches.length} cross-project learning(s). Review before duplicating work.`
   });
 }
-function handleLoadSession(_params, brain) {
+function parseLoadSessionInclude(raw) {
+  if (!raw) return /* @__PURE__ */ new Set();
+  return new Set(
+    raw.split(",").map((s) => s.trim().toLowerCase()).filter(Boolean)
+  );
+}
+function handleLoadSession(params, brain) {
+  const include = parseLoadSessionInclude(params.include);
+  const wantAll = include.has("all");
   const root = brain.rootPath;
   const sessionsFile = sessionsLogPath(root);
   let lastSession = null;
@@ -1502,45 +1748,67 @@ function handleLoadSession(_params, brain) {
     const sessions = content.split(/^## Session/m).slice(1);
     if (sessions.length > 0) {
       const last = sessions[sessions.length - 1].trim();
-      lastSession = last.slice(0, 300);
+      lastSession = last.slice(0, 200);
     }
   }
   const handoffPath = join2(root, "handoff.md");
   let handoff2 = null;
   if (existsSync4(handoffPath)) {
-    handoff2 = readFileSync4(handoffPath, "utf-8").slice(0, 2e3);
-  }
-  const topLearnings = brain.knowledgeBase.entries.filter((e) => e.accessCount > 0).sort((a, b) => b.accessCount - a.accessCount).slice(0, 5).map((e) => ({ summary: e.summary, lesson: e.lesson, tags: e.tags, accessed: e.accessCount }));
-  const fps = brain.knowledgeBase.entries.filter((e) => e.tags.includes("#false-positive")).map((e) => ({ summary: e.summary, lesson: e.lesson }));
-  const teamsFile = teamsPath(root);
-  let teams = [];
-  if (existsSync4(teamsFile)) {
-    try {
-      const t = JSON.parse(readFileSync4(teamsFile, "utf-8"));
-      teams = t.map((team) => team.name);
-    } catch {
-    }
+    handoff2 = readFileSync4(handoffPath, "utf-8").slice(0, 1500);
   }
-  const knowledge = {
+  const learningsLimit = wantAll || include.has("full_learnings") ? 5 : 3;
+  const topLearnings = brain.knowledgeBase.entries.filter((e) => e.accessCount > 0).sort((a, b) => b.accessCount - a.accessCount).slice(0, learningsLimit).map((e) => ({ summary: e.summary, lesson: e.lesson, tags: e.tags, accessed: e.accessCount }));
+  const fpsLimit = wantAll || include.has("full_learnings") ? 50 : 5;
+  const fps = brain.knowledgeBase.entries.filter((e) => e.tags.includes("#false-positive")).slice(0, fpsLimit).map((e) => ({ summary: e.summary, lesson: e.lesson }));
+  const wantFullKnowledge = wantAll || include.has("full_knowledge");
+  const knowledge = wantFullKnowledge ? {
     files: brain.knowledge.summary.totalFiles,
     imports: Object.keys(brain.knowledge.importGraph).length,
     high_fanout: brain.knowledge.summary.highFanoutFiles,
     untested: brain.knowledge.summary.untestedFiles.slice(0, 5)
+  } : {
+    files: brain.knowledge.summary.totalFiles,
+    imports: Object.keys(brain.knowledge.importGraph).length,
+    high_fanout_count: brain.knowledge.summary.highFanoutFiles.length,
+    untested_count: brain.knowledge.summary.untestedFiles.length
   };
-  const metrics = {
-    total_sessions: brain.knowledgeBase.metrics.totalSessions,
-    total_learnings: brain.knowledgeBase.entries.length,
-    cache_hits: brain.knowledgeBase.metrics.cacheHits
-  };
-  const recentSessions = getRecentSessions(root, 3).map((s) => ({
-    date: s.date,
-    branch: s.branch ?? null,
-    summary: s.summary ?? "",
-    tags: s.tags ?? [],
-    outcome: s.outcome
-  }));
-  const patterns = reflect(brain.knowledgeBase).slice(0, 3).map((p) => ({ type: p.type, description: p.description, confidence: p.confidence }));
-  return JSON.stringify({
+  let teams;
+  if (wantAll || include.has("teams")) {
+    const teamsFile = teamsPath(root);
+    if (existsSync4(teamsFile)) {
+      try {
+        const t = JSON.parse(readFileSync4(teamsFile, "utf-8"));
+        teams = t.map((team) => team.name);
+      } catch {
+        teams = [];
+      }
+    } else {
+      teams = [];
+    }
+  }
+  let metrics;
+  if (wantAll || include.has("metrics")) {
+    metrics = {
+      total_sessions: brain.knowledgeBase.metrics.totalSessions,
+      total_learnings: brain.knowledgeBase.entries.length,
+      cache_hits: brain.knowledgeBase.metrics.cacheHits
+    };
+  }
+  let recentSessions;
+  if (wantAll || include.has("recent_sessions")) {
+    recentSessions = getRecentSessions(root, 3).map((s) => ({
+      date: s.date,
+      branch: s.branch ?? null,
+      summary: s.summary ?? "",
+      tags: s.tags ?? [],
+      outcome: s.outcome
+    }));
+  }
+  let patterns;
+  if (wantAll || include.has("patterns")) {
+    patterns = reflect(brain.knowledgeBase).slice(0, 3).map((p) => ({ type: p.type, description: p.description, confidence: p.confidence }));
+  }
+  const response = {
     session_context: {
       last_session: lastSession,
       handoff: handoff2,
@@ -1549,16 +1817,17 @@ function handleLoadSession(_params, brain) {
     intelligence: {
       top_learnings: topLearnings,
       false_positives: fps,
-      patterns
+      ...patterns !== void 0 ? { patterns } : {}
     },
     project: {
       knowledge,
-      teams,
-      metrics,
-      recent_sessions: recentSessions
+      ...teams !== void 0 ? { teams } : {},
+      ...metrics !== void 0 ? { metrics } : {},
+      ...recentSessions !== void 0 ? { recent_sessions: recentSessions } : {}
     },
-    instruction: handoff2 ? "UNFINISHED WORK DETECTED. Read the handoff above \u2014 pick up where the last session left off. Do NOT start fresh." : topLearnings.length > 0 ? `Session loaded. ${topLearnings.length} key learnings available. ${fps.length} false positives to suppress. Call knit_classify_task to begin.` : recentSessions.length > 0 ? `Session loaded. ${recentSessions.length} recent sessions on file. Call knit_classify_task to begin.` : "Fresh brain \u2014 no past learnings yet. Call knit_classify_task to begin your first task."
-  });
+    instruction: handoff2 ? "UNFINISHED WORK DETECTED. Read the handoff above \u2014 pick up where the last session left off. Do NOT start fresh." : topLearnings.length > 0 ? `Session loaded. ${topLearnings.length} key learnings, ${fps.length} false positives. Call knit_classify_task to begin. Use include=patterns,teams,metrics,recent_sessions,full_learnings,full_knowledge for more.` : "Fresh brain \u2014 no past learnings yet. Call knit_classify_task to begin."
+  };
+  return JSON.stringify(response);
 }
 function handleSaveSessionSummary(params, brain) {
   const validOutcomes = ["shipped", "wip", "failed", "unknown"];
@@ -1741,73 +2010,73 @@ function getToolDefinitions() {
     // ── Query (read the brain) ───────────────────────────────────
     {
       name: "knit_query_imports",
-      description: "Who imports this file? Returns the reverse dependency list \u2014 call before editing to know the blast radius.",
+      description: "Reverse deps for a file \u2014 who imports it.",
       inputSchema: { type: "object", properties: { file_path: { type: "string", description: "Relative file path." } }, required: ["file_path"] }
     },
     {
       name: "knit_query_dependents",
-      description: "What does this file import? Returns the file's own dependencies.",
+      description: "Forward deps for a file \u2014 what it imports.",
       inputSchema: { type: "object", properties: { file_path: { type: "string", description: "Relative file path." } }, required: ["file_path"] }
     },
     {
       name: "knit_query_exports",
-      description: "What does this file expose? Functions, classes, interfaces, types, constants.",
+      description: "Exports from a file: functions, classes, types, constants.",
       inputSchema: { type: "object", properties: { file_path: { type: "string", description: "Relative file path." } }, required: ["file_path"] }
     },
     {
       name: "knit_query_tests",
-      description: 'Is this file tested? Or pass filter="untested" to list all untested files.',
+      description: 'Tests for a file, or list all untested files with filter="untested".',
       inputSchema: { type: "object", properties: { file_path: { type: "string", description: "Relative file path (optional)." }, filter: { type: "string", description: '"untested" to list all untested files.' } } }
     },
     {
       name: "knit_find_fanout",
-      description: "High-fanout files \u2014 imported by many others. These are the contracts; change carefully.",
+      description: "High-fanout files \u2014 imported by many others.",
       inputSchema: { type: "object", properties: { min_importers: { type: "string", description: "Minimum importers to qualify (default: 3)." } } }
     },
     {
       name: "knit_search_learnings",
-      description: "Search past learnings by domain tag. Returns prior lessons and mistakes to avoid.",
+      description: "Search learnings by domain tag.",
       inputSchema: { type: "object", properties: { domains: { type: "string", description: "Comma-separated domain tags." } }, required: ["domains"] }
     },
     {
       name: "knit_get_false_positives",
-      description: "Confirmed non-issues. Pass to review agents so they don't re-flag them.",
+      description: "List confirmed non-issues to suppress in review prompts.",
       inputSchema: { type: "object", properties: {} }
     },
     {
       name: "knit_brain_status",
-      description: "Brain health + token-accounting: learnings, hit rate, CLAUDE.md size, session count.",
+      description: "Brain health: learnings, hit rate, CLAUDE.md size, session count.",
       inputSchema: { type: "object", properties: {} }
     },
     // ── Update (write to the brain) ──────────────────────────────
     {
       name: "knit_classify_task",
-      description: "Call first on every task. Classifies tier (trivial/standard/complex), returns phases + domains + auto plan mode flag. Also triggers project auto-init.",
-      inputSchema: { type: "object", properties: { files_to_touch: { type: "string", description: 'Comma-separated files, or "unknown" for new projects.' }, description: { type: "string", description: "Brief task description." } }, required: ["files_to_touch"] }
+      description: "Call first on every task. Returns tier (inquiry/trivial/standard/complex), phases, auto_plan_mode.",
+      inputSchema: { type: "object", properties: { files_to_touch: { type: "string", description: 'Comma-separated files, or "unknown" for new projects.' }, description: { type: "string", description: "Brief task description." }, verbose: { type: "string", description: '"true" to include reasoning + cross_domain_ripple + files_count (debug fields).' } }, required: ["files_to_touch"] }
     },
     {
       name: "knit_build_context",
-      description: "Build a context object for the current task: domains, ripple effects, pitfalls, false positives.",
+      description: "Build the Domain Context Object: affected domains, ripple, pitfalls, false positives.",
       inputSchema: { type: "object", properties: { files_to_touch: { type: "string", description: "Comma-separated files." } }, required: ["files_to_touch"] }
     },
     {
       name: "knit_record_learning",
-      description: "Record a non-obvious, reusable insight. Quality check first: would session N+1 searching this tag be glad it exists? If no, skip.",
+      description: "Record a non-obvious, reusable insight. Skip if a future search wouldn't be glad it exists.",
       inputSchema: { type: "object", properties: { summary: { type: "string", description: "One-line summary." }, domains: { type: "string", description: "Comma-separated domains." }, approach: { type: "string", description: "What approach was taken." }, outcome: { type: "string", description: "success | partial | failure." }, lesson: { type: "string", description: "What to repeat or avoid." }, tags: { type: "string", description: 'Space-separated tags (e.g. "#api #auth").' } }, required: ["summary", "lesson", "tags"] }
     },
     {
       name: "knit_record_false_positive",
-      description: "Mark a finding as a confirmed non-issue so future review agents stop re-flagging it.",
+      description: "Mark a finding as confirmed non-issue so future reviewers suppress it.",
       inputSchema: { type: "object", properties: { summary: { type: "string", description: "What was flagged." }, reason: { type: "string", description: "Why it's not a real issue." }, tags: { type: "string", description: "Domain tags." } }, required: ["summary", "reason"] }
     },
     {
       name: "knit_save_handoff",
-      description: "Save state for the next session when context degrades. failed_attempts is the load-bearing field.",
+      description: "Save state for the next session. failed_attempts is the load-bearing field.",
       inputSchema: { type: "object", properties: { goal: { type: "string", description: "What we're trying to accomplish." }, current_state: { type: "string", description: "Where we are now." }, files_in_flight: { type: "string", description: "Files being modified." }, what_changed: { type: "string", description: "Commits and edits." }, failed_attempts: { type: "string", description: "What was tried and why it failed." }, decisions_made: { type: "string", description: "Important choices." }, next_step: { type: "string", description: "ONE most important next thing." } }, required: ["goal", "current_state", "failed_attempts", "next_step"] }
     },
     {
       name: "knit_setup_project",
-      description: "Describe a project (especially non-code: research, legal, marketing). Generates domain-specific teams.",
+      description: "Bootstrap domain teams for a non-code project (research/legal/marketing).",
       inputSchema: {
         type: "object",
         properties: {
@@ -1822,12 +2091,12 @@ function getToolDefinitions() {
     // ── Teams (parallel review board) ────────────────────────────
     {
       name: "knit_get_teams",
-      description: "List agent teams configured for this project.",
+      description: "List teams configured for this project.",
       inputSchema: { type: "object", properties: {} }
     },
     {
       name: "knit_define_team",
-      description: "Create or update a custom agent team.",
+      description: "Create or update a custom team.",
       inputSchema: { type: "object", properties: { name: { type: "string", description: "Team name." }, role: { type: "string", description: "Team role." }, focus: { type: "string", description: "Team focus area." }, agents: { type: "string", description: "Comma-separated agent types." }, file_patterns: { type: "string", description: "Comma-separated globs." }, checklist: { type: "string", description: "Pipe-separated review items." } }, required: ["name", "role", "focus"] }
     },
     {
@@ -1837,12 +2106,12 @@ function getToolDefinitions() {
     },
     {
       name: "knit_get_team_prompt",
-      description: "Get the prompt for a team, including other teams' findings.",
+      description: "Get a team's prompt with other teams' findings included.",
       inputSchema: { type: "object", properties: { team_name: { type: "string", description: "Team name." }, files_to_review: { type: "string", description: "Comma-separated files." } }, required: ["team_name"] }
     },
     {
       name: "knit_post_team_findings",
-      description: "Post a team's findings to the shared board.",
+      description: "Post team findings to the shared board.",
       inputSchema: { type: "object", properties: { team_name: { type: "string", description: "Team posting." }, findings: { type: "string", description: "JSON array of findings." } }, required: ["team_name", "findings"] }
     },
     {
@@ -1853,12 +2122,12 @@ function getToolDefinitions() {
     // ── Session memory ───────────────────────────────────────────
     {
       name: "knit_load_session",
-      description: "Call at session start. Returns last sessions, handoff, top learnings, false positives, teams, project knowledge in one round trip.",
-      inputSchema: { type: "object", properties: {} }
+      description: "Call at session start. Returns handoff, top learnings, false positives by default. Opt in to more via include=patterns,teams,metrics,recent_sessions,full_learnings,full_knowledge,all.",
+      inputSchema: { type: "object", properties: { include: { type: "string", description: "Comma-separated optional sections." } } }
     },
     {
       name: "knit_save_session_summary",
-      description: "Opt-in. Record a narrative summary if this session accomplished something a future session would search for. Quality check first.",
+      description: "Opt-in. Record a session summary a future search would want to find.",
       inputSchema: {
         type: "object",
         properties: {
@@ -1873,7 +2142,7 @@ function getToolDefinitions() {
     },
     {
       name: "knit_prune_sessions",
-      description: "Prune entries older than max_age_days (default 90) from this project's sessions.jsonl. Atomic rewrite. Also runs automatically on auto-init.",
+      description: "Prune sessions older than max_age_days (default 90). Atomic rewrite.",
       inputSchema: {
         type: "object",
         properties: {
@@ -1883,7 +2152,7 @@ function getToolDefinitions() {
     },
     {
       name: "knit_search_sessions",
-      description: "Search past sessions by free text over summary + tags + branch. Check before duplicating prior work.",
+      description: 'Search past sessions by free text. "Have I done this before?"',
       inputSchema: {
         type: "object",
         properties: {
@@ -1896,7 +2165,7 @@ function getToolDefinitions() {
     // ── Workflow on demand ───────────────────────────────────────
     {
       name: "knit_get_workflow",
-      description: "Fetch protocol depth for one phase. Sections: overview, tier, phases, research, ideate, plan, execute, optimize, review, tdd, learn, handoff, ship, tools. Omit phase to list all.",
+      description: "Fetch one workflow section: overview, tier, phases, research, ideate, plan, execute, optimize, review, tdd, learn, handoff, ship, tools. Omit phase to list all.",
       inputSchema: {
         type: "object",
         properties: {
@@ -1907,7 +2176,7 @@ function getToolDefinitions() {
     // ── Parallel team worktrees ──────────────────────────────────
     {
       name: "knit_spawn_team_worktree",
-      description: "Create a git worktree for a team. Multiple agents within the team can work in parallel inside it without colliding with other teams.",
+      description: "Create a git worktree for a team so they can write in parallel without colliding.",
       inputSchema: {
         type: "object",
         properties: {
@@ -1919,7 +2188,7 @@ function getToolDefinitions() {
     },
     {
       name: "knit_list_team_worktrees",
-      description: "List active team worktrees. Pass include_finalized=true for full history.",
+      description: "List active team worktrees. include_finalized=true for full history.",
       inputSchema: {
         type: "object",
         properties: {
@@ -1930,7 +2199,7 @@ function getToolDefinitions() {
     // ── Cross-project learnings (Model C — global pool) ─────────
     {
       name: "knit_record_global_learning",
-      description: "Opt-in. Record a learning to the cross-project pool when the insight generalizes beyond this project (e.g., Stripe webhook signature rules). Per-project knit_record_learning stays primary.",
+      description: "Opt-in. Record a learning to the cross-project pool when it generalizes beyond this project.",
       inputSchema: {
         type: "object",
         properties: {
@@ -1944,7 +2213,7 @@ function getToolDefinitions() {
     },
     {
       name: "knit_search_global_learnings",
-      description: "Search the cross-project learnings pool. Use to check whether a similar lesson has been recorded in any project on this machine.",
+      description: "Search the cross-project learnings pool across all projects on this machine.",
       inputSchema: {
         type: "object",
         properties: {
@@ -1957,17 +2226,17 @@ function getToolDefinitions() {
     // ── Pattern reflection (now backed by Model C, useful with ≥3 entries) ──
     {
       name: "knit_reflect",
-      description: "Detect patterns across recorded learnings (per-project + global pool). Returns recurring themes, repeated failures, domain co-occurrences. Needs \u22653 learnings to surface anything meaningful.",
+      description: "Detect patterns across learnings. Needs \u22653 entries to surface anything.",
       inputSchema: { type: "object", properties: {} }
     },
     {
       name: "knit_get_suggestions",
-      description: 'Adaptive suggestions for the current task based on past patterns in given domains. "Based on history, watch out for X."',
+      description: 'Adaptive warnings from past patterns. "Based on history, watch out for X."',
       inputSchema: { type: "object", properties: { domains: { type: "string", description: "Comma-separated domains for this task." } }, required: ["domains"] }
     },
     {
       name: "knit_install_agent",
-      description: "Install or refresh one subagent. Writes <project>/.claude/agents/knit-<name>.md, personalized with project context. Use mid-session if a team needs an agent that isn't on disk yet.",
+      description: "Install one VoltAgent subagent into .claude/agents/, personalized with project context.",
       inputSchema: {
         type: "object",
         properties: {
@@ -1979,7 +2248,7 @@ function getToolDefinitions() {
     },
     {
       name: "knit_finalize_team_worktree",
-      description: "Merge or discard a team's worktree. Merge surfaces conflict files without destroying the worktree on failure.",
+      description: "Merge or discard a team's worktree. Surfaces conflicts without destroying the worktree.",
       inputSchema: {
         type: "object",
         properties: {
@@ -1992,16 +2261,51 @@ function getToolDefinitions() {
     // ── Protocol Guard ───────────────────────────────────────────
     {
       name: "knit_set_protocol_strictness",
-      description: "Set Protocol Guard strictness for this project. off = no checks. warn = reminder only (default). block = hard-fail Edit/Write without prior knit_classify_task.",
+      description: "Set Protocol Guard strictness: off | warn (default) | block.",
       inputSchema: { type: "object", properties: { level: { type: "string", description: "One of: off | warn | block." } }, required: ["level"] }
     },
     {
       name: "knit_get_protocol_strictness",
-      description: "Read current Protocol Guard strictness level for this project.",
+      description: "Read current Protocol Guard strictness.",
+      inputSchema: { type: "object", properties: {} }
+    },
+    // ── Meta — feature discoverability ───────────────────────────
+    {
+      name: "knit_list_features",
+      description: "List active vs hidden Knit tools and why. Call when a tool you expect isn't available.",
       inputSchema: { type: "object", properties: {} }
+    },
+    {
+      name: "knit_enable_feature",
+      description: "Enable a Tier-2/3 feature flag (teams, subagents, admin). Persisted.",
+      inputSchema: {
+        type: "object",
+        properties: { feature: { type: "string", description: "One of: teams, subagents, admin." } },
+        required: ["feature"]
+      }
+    },
+    {
+      name: "knit_disable_feature",
+      description: "Disable a feature flag. Auto-exposed tools stay visible regardless.",
+      inputSchema: {
+        type: "object",
+        properties: { feature: { type: "string", description: "One of: teams, subagents, admin." } },
+        required: ["feature"]
+      }
     }
   ];
 }
+function getActiveToolDefinitions(shape) {
+  const all = getToolDefinitions();
+  if (!shape) return all;
+  const activeNames = new Set(
+    TOOL_REGISTRY.filter((info) => isToolActive(info, shape)).map((info) => info.tool)
+  );
+  return all.filter((def) => activeNames.has(def.name));
+}
+function getActiveToolDefinitionsForBrain(brain) {
+  return getActiveToolDefinitions(detectProjectShape(brain));
+}
 var handlers = {
   knit_query_imports: handleQueryImports,
   knit_query_dependents: handleQueryDependents,
@@ -2037,7 +2341,10 @@ var handlers = {
   knit_get_suggestions: handleGetSuggestions,
   knit_install_agent: handleInstallAgent,
   knit_set_protocol_strictness: handleSetProtocolStrictness,
-  knit_get_protocol_strictness: handleGetProtocolStrictness
+  knit_get_protocol_strictness: handleGetProtocolStrictness,
+  knit_list_features: handleListFeatures,
+  knit_enable_feature: handleEnableFeature,
+  knit_disable_feature: handleDisableFeature
 };
 function handleToolCall(toolName, params, brain) {
   if (params.file_path) {
@@ -2059,6 +2366,8 @@ function handleToolCall(toolName, params, brain) {
   return handler(params, brain);
 }
 export {
+  getActiveToolDefinitions,
+  getActiveToolDefinitionsForBrain,
   getToolDefinitions,
   handleToolCall
 };