@plumpslabs/kuma 2.3.8 → 2.3.9

package/dist/index.js

@@ -1,40 +1,40 @@
 #!/usr/bin/env node
-import {
-  ALL_CONFIG_TYPES,
-  formatInitResults,
-  runInit
-} from "./chunk-L5WU2HTN.js";
 import {
   auditStats,
   queryAudit,
   recordAudit
-} from "./chunk-PTEPJK6M.js";
+} from "./chunk-RI3DKY62.js";
 import {
-  analyzeImpact,
-  autoHeal,
-  detectStaleNodes,
-  formatFlow,
-  formatHealReport,
-  formatImpact,
-  getGraphStats,
-  searchGraph,
-  traceFlow
-} from "./chunk-4OB3XMHT.js";
+  ALL_CONFIG_TYPES,
+  formatInitResults,
+  runInit
+} from "./chunk-L5WU2HTN.js";
 import {
   formatDecisionTemplate,
   getProactiveMemories,
   recordDecision,
   scoreMemoryRelevance
-} from "./chunk-RTGLQDMI.js";
+} from "./chunk-OJALFQ4H.js";
 import {
   buildDriftMessages,
   getGitDiffStat,
   getSessionStats,
   getUnresolvedCount
-} from "./chunk-FL2TLLMX.js";
+} from "./chunk-SPHI2BOO.js";
 import {
   sessionMemory
-} from "./chunk-SLRRDKQ2.js";
+} from "./chunk-R6B3VUSB.js";
+import {
+  analyzeImpact,
+  autoHeal,
+  detectStaleNodes,
+  formatFlow,
+  formatHealReport,
+  formatImpact,
+  getGraphStats,
+  searchGraph,
+  traceFlow
+} from "./chunk-ZKDYTYMS.js";
 import {
   addContextNote,
   addSecurityFinding,
@@ -59,7 +59,7 @@ import {
   saveResearchCache,
   updateDecisionStatus,
   updateTodoStatus
-} from "./chunk-NAM7SCBT.js";
+} from "./chunk-3TX6Q37T.js";
 import {
   getProjectRoot,
   validateFilePath
@@ -140,7 +140,12 @@ var CONTEXT_ALIASES = {
   "drift": "drift",
   "staleness": "drift",
   "code-drift": "drift",
-  "freshness": "drift"
+  "freshness": "drift",
+  // Progressive context synonyms (Issue #25)
+  "progressive": "progressive",
+  "prog": "progressive",
+  "section": "progressive",
+  "sectional": "progressive"
 };
 async function handleContext(params) {
   const rawAction = params.action || "init";
@@ -171,8 +176,10 @@ async function handleContext(params) {
       return handleDigest(params);
     case "drift":
       return handleDrift(params);
+    case "progressive":
+      return handleProgressive(params);
     default:
-      return `Unknown action "${action}". Use: init, research, impact, navigate, changes, rollback, researches, health, sync, visualize, digest, drift`;
+      return `Unknown action "${action}". Use: init, research, impact, navigate, changes, rollback, researches, health, sync, visualize, digest, drift, progressive`;
   }
 }
 async function handleInit(_params) {
@@ -233,8 +240,8 @@ async function handleInit(_params) {
   lines.push(`  \u{1F4DD} Modified: ${summary.modifiedFiles?.length || 0} file(s)`);
   lines.push(`  \u{1F6E0}\uFE0F Tool calls: ${summary.toolCallCount}`);
   try {
-    const { computeSafetyScore, formatSafetyScore } = await import("./safetyScore-GR5N55CU.js");
-    const { saveHealthSnapshot: saveHealthSnapshot2 } = await import("./kumaDb-6D53ERFP.js");
+    const { computeSafetyScore, formatSafetyScore } = await import("./safetyScore-WU27EOG4.js");
+    const { saveHealthSnapshot: saveHealthSnapshot2 } = await import("./kumaDb-IC7UX7PU.js");
     const score = await computeSafetyScore(_params.goal);
     const checksStr = JSON.stringify(score.checks);
     await saveHealthSnapshot2(score.score, score.risk, checksStr, score.summary);
@@ -296,7 +303,7 @@ async function handleResearch(params) {
     lines.push("  \u23F3 No content hash available \u2014 will research fresh");
   }
   lines.push("");
-  lines.push("**Step 3/5: Graph Query**");
+  lines.push("**Step 3/5: Graph Query + Code Scan**");
   try {
     const graphResult = await searchGraph(scope, 15);
     const graphLines = graphResult.split("\n");
@@ -328,6 +335,14 @@ async function handleResearch(params) {
   } catch {
     lines.push("  \u26A0\uFE0F Graph query failed");
   }
+  try {
+    const { scanCodebase } = await import("./kumaCodeScanner-LFJGPJNH.js");
+    const scanResult = await scanCodebase({ scope, maxFiles: 100 });
+    if (scanResult.nodeCount > 0 || scanResult.edgeCount > 0) {
+      lines.push(`  \u{1F52C} Auto-scanned ${scanResult.filesScanned} files \u2192 ${scanResult.nodeCount} nodes, ${scanResult.edgeCount} edges`);
+    }
+  } catch {
+  }
   lines.push("");
   lines.push("**Step 4/5: Impact Analysis**");
   try {
@@ -407,8 +422,8 @@ async function handleResearches(_params) {
 async function handleHealth(_params) {
   sessionMemory.recordToolCall("kuma_context_health", {});
   try {
-    const { computeSafetyScore, formatSafetyScore } = await import("./safetyScore-GR5N55CU.js");
-    const { saveHealthSnapshot: saveHealthSnapshot2 } = await import("./kumaDb-6D53ERFP.js");
+    const { computeSafetyScore, formatSafetyScore } = await import("./safetyScore-WU27EOG4.js");
+    const { saveHealthSnapshot: saveHealthSnapshot2 } = await import("./kumaDb-IC7UX7PU.js");
     const score = await computeSafetyScore();
     const checksStr = JSON.stringify(score.checks);
     await saveHealthSnapshot2(score.score, score.risk, checksStr, score.summary);
@@ -435,8 +450,8 @@ async function handleSync(params) {
   lines.push(`  \u{1F6E0}\uFE0F Tool calls: ${summary.toolCallCount}`);
   lines.push("");
   try {
-    const { computeSafetyScore, formatSafetyScore } = await import("./safetyScore-GR5N55CU.js");
-    const { saveHealthSnapshot: saveHealthSnapshot2 } = await import("./kumaDb-6D53ERFP.js");
+    const { computeSafetyScore, formatSafetyScore } = await import("./safetyScore-WU27EOG4.js");
+    const { saveHealthSnapshot: saveHealthSnapshot2 } = await import("./kumaDb-IC7UX7PU.js");
     const score = await computeSafetyScore(params.goal);
     const checksStr = JSON.stringify(score.checks);
     await saveHealthSnapshot2(score.score, score.risk, checksStr, score.summary);
@@ -447,14 +462,14 @@ async function handleSync(params) {
   }
   lines.push("");
   try {
-    const { getGraphStats: getGraphStats2 } = await import("./kumaGraph-AWP743TJ.js");
+    const { getGraphStats: getGraphStats2 } = await import("./kumaGraph-GUQM75WL.js");
     lines.push("**Knowledge Graph**");
     lines.push(await getGraphStats2());
   } catch {
   }
   lines.push("");
   try {
-    const { getProactiveMemories: getProactiveMemories2 } = await import("./kumaMemory-7TCUDVZX.js");
+    const { getProactiveMemories: getProactiveMemories2 } = await import("./kumaMemory-FMOWIODH.js");
     const memories = getProactiveMemories2();
     if (memories) {
       lines.push("**Relevant Memories**");
@@ -468,7 +483,7 @@ async function handleSync(params) {
 }
 async function handleVisualize(params) {
   const scope = params.scope;
-  const { generateVisualizeReport } = await import("./kumaVisualize-TECABHUY.js");
+  const { generateVisualizeReport } = await import("./kumaVisualize-AFL7STLL.js");
   return await generateVisualizeReport({
     scope,
     type: "flowchart",
@@ -478,11 +493,11 @@ async function handleVisualize(params) {
 async function handleDigest(_params) {
   sessionMemory.recordToolCall("kuma_context_digest", {});
   try {
-    const { generateContextDigest } = await import("./contextDigest-4PCK3DSM.js");
+    const { generateContextDigest } = await import("./contextDigest-5JXLH56Z.js");
     return await generateContextDigest();
   } catch (err) {
     try {
-      const { generateDigest } = await import("./domainRules-LDZPOIGZ.js");
+      const { generateDigest } = await import("./domainRules-ED6EOFVY.js");
       return generateDigest();
     } catch {
       return `Error generating digest: ${err}`;
@@ -492,7 +507,7 @@ async function handleDigest(_params) {
 async function handleDrift(_params) {
   sessionMemory.recordToolCall("kuma_context_drift", {});
   try {
-    const { detectDrift, formatDriftReport, flagStaleRecords } = await import("./kumaDriftDetector-OESI5GTC.js");
+    const { detectDrift, formatDriftReport, flagStaleRecords } = await import("./kumaDriftDetector-QBY6OJOO.js");
     await flagStaleRecords();
     const records = await detectDrift();
     return formatDriftReport(records);
@@ -500,6 +515,42 @@ async function handleDrift(_params) {
     return `Error detecting drift: ${err}`;
   }
 }
+async function handleProgressive(params) {
+  sessionMemory.recordToolCall("kuma_context_progressive", { scope: params.scope, section: params.section });
+  try {
+    const { getProgressiveContext, loadSection } = await import("./kumaProgressiveContext-CVSNPY3W.js");
+    if (params.section) {
+      const validSections = ["domain_rules", "architecture", "gotchas", "decisions", "graph", "changes", "health"];
+      if (!validSections.includes(params.section)) {
+        return `\u26A0\uFE0F Invalid section "${params.section}". Valid sections: ${validSections.join(", ")}`;
+      }
+      const content = await loadSection(params.section, params.scope);
+      return [
+        `\u{1F9E9} **Progressive Context** \u2014 Section: ${params.section}`,
+        `\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501`,
+        "",
+        content
+      ].join("\n");
+    }
+    const result = await getProgressiveContext(params.scope);
+    const lines = [
+      "\u{1F9E9} **Progressive Context**",
+      `\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501`,
+      "",
+      `\u{1F4CB} **Meta**: ${result.meta}`,
+      `\u{1F517} **Skill Boundary**: ${result.boundary.name} \u2014 ${result.boundary.description}`,
+      ""
+    ];
+    for (const section of result.sections) {
+      lines.push(section.content);
+      lines.push("");
+    }
+    lines.push("\u{1F4A1} Use kuma_context({ action: 'progressive', section: 'gotchas', scope: 'auth' }) to load specific context on demand.");
+    return lines.join("\n");
+  } catch (err) {
+    return `Error generating progressive context: ${err}`;
+  }
+}
 function computeProjectHash(scope) {
   try {
     const root = getProjectRoot();
@@ -601,7 +652,25 @@ var MEMORY_ALIASES = {
   // Layers summary
   "layers": "layers",
   "3-layer": "layers",
-  "memory-layers": "layers"
+  "memory-layers": "layers",
+  // Federated synonyms (Issue #27)
+  "federated": "federated",
+  "federated-graph": "federated",
+  "kuma-uri": "federated",
+  "remote-graph": "federated",
+  // Test generation synonyms (Issue #28)
+  "gen_test": "gen_test",
+  "gen-test": "gen_test",
+  "generate-test": "gen_test",
+  "gentest": "gen_test",
+  // Trajectory synonyms
+  "trajectory": "trajectory",
+  "trajectories": "trajectory",
+  "traj": "trajectory",
+  // Skills synonyms
+  "skills": "skills",
+  "distilled-skills": "skills",
+  "skill-list": "skills"
 };
 async function handleMemory(params) {
   const rawAction = params.action || "session";
@@ -639,6 +708,14 @@ async function handleMemory(params) {
       return handleGotchaAction(params);
     case "layers":
       return handleLayersSummary(params);
+    case "federated":
+      return handleFederated(params);
+    case "gen_test":
+      return handleGenTest(params);
+    case "trajectory":
+      return handleTrajectoryList(params);
+    case "skills":
+      return handleSkillsList(params);
     default:
       return `Unknown action "${action}".`;
   }
@@ -649,7 +726,7 @@ async function handleDecision(params) {
     case "template":
       return formatDecisionTemplate();
     case "suggest": {
-      const { shouldRecordDecision } = await import("./kumaMemory-7TCUDVZX.js");
+      const { shouldRecordDecision } = await import("./kumaMemory-FMOWIODH.js");
       const check = shouldRecordDecision();
       return check.worth ? `\u{1F4A1} Decision suggested: "${check.title}"
 Use kuma_memory({ action: 'decision', title: '...', context: '...', rationale: '...', outcome: '...' }) to record.` : "\u2705 No decision needed at this time.";
@@ -727,11 +804,11 @@ async function handleSearch(params) {
   if (!query) return "\u26A0\uFE0F query or scope parameter required.";
   const limit = params.limit || 20;
   const memResults = sessionMemory.searchMemory(query, limit);
-  const { searchGraph: searchGraph2 } = await import("./kumaGraph-AWP743TJ.js");
+  const { searchGraph: searchGraph2 } = await import("./kumaGraph-GUQM75WL.js");
   const graphResults = await searchGraph2(query, Math.min(limit, 10));
   let hybridResults = "";
   try {
-    const { hybridSearch, formatHybridResults } = await import("./kumaSearch-QGB4QVXS.js");
+    const { hybridSearch, formatHybridResults } = await import("./kumaSearch-B5WVYHHD.js");
     const semanticResults = await hybridSearch(query, 8);
     if (semanticResults.length > 0) {
       hybridResults = "\n" + formatHybridResults(query, semanticResults);
@@ -815,7 +892,7 @@ async function handleDecisionLog(params) {
 }
 async function handleMine(params) {
   sessionMemory.recordToolCall("kuma_memory_mine", { scope: params.scope });
-  const { mineHistoricalDecisions } = await import("./kumaMiner-FFXSRHAO.js");
+  const { mineHistoricalDecisions } = await import("./kumaMiner-3RXEOCBP.js");
   return await mineHistoricalDecisions({
     scope: params.scope,
     since: typeof params.since === "string" ? params.since : void 0,
@@ -824,7 +901,7 @@ async function handleMine(params) {
   });
 }
 async function handleLayerAction(layer, params) {
-  const { readLayer, writeLayer } = await import("./domainRules-LDZPOIGZ.js");
+  const { readLayer, writeLayer } = await import("./domainRules-ED6EOFVY.js");
   if (params.content) {
     return writeLayer(layer, params.content);
   }
@@ -832,7 +909,7 @@ async function handleLayerAction(layer, params) {
 }
 async function handleGotchaAction(params) {
   if (params.content && params.scope) {
-    const { addGotcha } = await import("./kumaGotchas-DU5H6N7X.js");
+    const { addGotcha } = await import("./kumaGotchas-5HODT5RI.js");
     return await addGotcha({
       filePath: params.scope,
       description: params.content,
@@ -840,15 +917,46 @@ async function handleGotchaAction(params) {
       workaround: params.description
     });
   }
-  const { listGotchas, syncGotchasToDb } = await import("./kumaGotchas-DU5H6N7X.js");
+  const { listGotchas, syncGotchasToDb } = await import("./kumaGotchas-5HODT5RI.js");
   await syncGotchasToDb();
   return await listGotchas({
     filePath: params.scope,
     severity: params.status
   });
 }
+async function handleFederated(params) {
+  sessionMemory.recordToolCall("kuma_memory_federated", { scope: params.scope, uri: params.uri });
+  if (params.uri) {
+    const { resolveFederatedNode } = await import("./kumaGraph-GUQM75WL.js");
+    return await resolveFederatedNode(params.uri);
+  }
+  const { listFederatedReferences } = await import("./kumaGraph-GUQM75WL.js");
+  return await listFederatedReferences();
+}
+async function handleGenTest(params) {
+  sessionMemory.recordToolCall("kuma_memory_gen_test", { target: params.target });
+  if (params.target) {
+    const id = parseInt(params.target, 10);
+    if (!isNaN(id)) {
+      const { generateTestFromTrajectoryId } = await import("./kumaTrajectory-T6DXGOG4.js");
+      return await generateTestFromTrajectoryId(id);
+    }
+  }
+  const { listGeneratedTests } = await import("./kumaTrajectory-T6DXGOG4.js");
+  return await listGeneratedTests();
+}
+async function handleTrajectoryList(params) {
+  sessionMemory.recordToolCall("kuma_memory_trajectory", {});
+  const { listTrajectories } = await import("./kumaTrajectory-T6DXGOG4.js");
+  return await listTrajectories(params.limit || 10);
+}
+async function handleSkillsList(_params) {
+  sessionMemory.recordToolCall("kuma_memory_skills", {});
+  const { listDistilledSkills } = await import("./kumaTrajectory-T6DXGOG4.js");
+  return await listDistilledSkills();
+}
 async function handleLayersSummary(_params) {
-  const { getLayersSummary } = await import("./domainRules-LDZPOIGZ.js");
+  const { getLayersSummary } = await import("./domainRules-ED6EOFVY.js");
   return getLayersSummary();
 }
 
@@ -1797,6 +1905,14 @@ async function handleSafety(params) {
     case "ast":
     case "validate":
       return handleAstValidation(params);
+    case "checkpoint":
+      return handleCheckpoint(params);
+    case "rollback_label":
+      return handleRollbackLabel(params);
+    case "checkpoint_list":
+      return handleCheckpointList(params);
+    case "contract":
+      return handleContract(params);
     default:
       return `Unknown action "${action}".`;
   }
@@ -1840,7 +1956,7 @@ async function handleLock(params) {
 }
 async function handleHealth2(_params) {
   try {
-    const { computeSafetyScore, formatSafetyScore } = await import("./safetyScore-GR5N55CU.js");
+    const { computeSafetyScore, formatSafetyScore } = await import("./safetyScore-WU27EOG4.js");
     const score = await computeSafetyScore();
     await saveHealthSnapshot(score.score, score.risk, JSON.stringify(score.checks), score.summary);
     return formatSafetyScore(score);
@@ -1947,7 +2063,7 @@ async function handleClean(_params) {
 async function handlePolicy(params) {
   sessionMemory.recordToolCall("kuma_safety_policy", {});
   if (params.command) {
-    const { evaluateCommand, evaluateFilePath } = await import("./kumaPolicyEngine-S2PXN3C7.js");
+    const { evaluateCommand, evaluateFilePath } = await import("./kumaPolicyEngine-ORBWL5PT.js");
     const commandVerdict = evaluateCommand(params.command);
     const lines = [];
     lines.push(`\u{1F4DC} **Policy Check**: ${commandVerdict.allowed ? "\u2705 Allowed" : "\u26D4 Blocked"}`);
@@ -1974,7 +2090,7 @@ async function handlePolicy(params) {
     }
     return lines.join("\n");
   }
-  const { formatPolicyStatus } = await import("./kumaPolicyEngine-S2PXN3C7.js");
+  const { formatPolicyStatus } = await import("./kumaPolicyEngine-ORBWL5PT.js");
   return formatPolicyStatus();
 }
 async function handleAstValidation(params) {
@@ -1990,6 +2106,39 @@ async function handleAstValidation(params) {
   }
   return "\u26A0\uFE0F Provide a scope (file path) or command (code content) to validate.";
 }
+async function handleCheckpoint(params) {
+  sessionMemory.recordToolCall("kuma_safety_checkpoint", { label: params.label });
+  if (!params.label) return "\u26A0\uFE0F label parameter required. Example: kuma_safety({ action: 'checkpoint', label: 'pre-feature-x' })";
+  const { createCheckpoint } = await import("./kumaCheckpoint-XIQWRMGV.js");
+  return await createCheckpoint(params.label, params.description);
+}
+async function handleRollbackLabel(params) {
+  sessionMemory.recordToolCall("kuma_safety_rollback_label", { label: params.label });
+  if (!params.label) return "\u26A0\uFE0F label parameter required. Example: kuma_safety({ action: 'rollback_label', label: 'pre-feature-x' })";
+  const { rollbackToCheckpoint } = await import("./kumaCheckpoint-XIQWRMGV.js");
+  return await rollbackToCheckpoint(params.label);
+}
+async function handleCheckpointList(_params) {
+  sessionMemory.recordToolCall("kuma_safety_checkpoint_list", {});
+  const { listCheckpoints } = await import("./kumaCheckpoint-XIQWRMGV.js");
+  return listCheckpoints();
+}
+async function handleContract(params) {
+  sessionMemory.recordToolCall("kuma_safety_contract", {
+    toolName: params.toolName || "edit",
+    filePath: params.filePath,
+    phase: params.phase || "pre"
+  });
+  const { runContractChecks, listContracts } = await import("./kumaContractEngine-KX27T4N7.js");
+  if (!params.filePath && !params.toolName) {
+    return listContracts();
+  }
+  return await runContractChecks(
+    params.toolName || "edit",
+    params.filePath,
+    params.phase || "pre"
+  );
+}
 var _lastVerifyCall = 0;
 var VERIFY_COOLDOWN_MS = 3e4;
 async function handleVerify(params) {
@@ -2000,7 +2149,7 @@ async function handleVerify(params) {
   }
   _lastVerifyCall = now;
   sessionMemory.recordToolCall("kuma_safety_verify", { scope: params.scope || params.filePath });
-  const { runAutoVerification } = await import("./kumaVerifier-ARSGPZAM.js");
+  const { runAutoVerification } = await import("./kumaVerifier-KAYJHR5K.js");
   return await runAutoVerification({
     scope: params.scope || params.filePath,
     force: params.force,
@@ -2014,12 +2163,13 @@ function registerAllTools(server) {
     "kuma_context",
     "**Call FIRST every session.** Understand your project before making changes. Actions: init (load project brief), research (5-step pipeline: cache\u2192staleness\u2192graph\u2192impact\u2192decision), impact (analyze change effects), navigate (trace code flow), changes (view change log), health (project health score 0-100). RESEARCH IS REQUIRED before editing unfamiliar code.",
     {
-      action: z.enum(["init", "research", "impact", "navigate", "changes", "health", "rollback", "researches", "sync", "visualize", "digest", "drift"]).describe("Action: init=project brief, research=5-step research pipeline (REQUIRED before edits), impact=analyze change effects, navigate=trace code flow, changes=view change log, rollback=undo a change by ID, researches=list all cached research, sync=unified batch state, visualize=Mermaid knowledge graph diagram, digest=ultra-compact <500 token project briefing (Issue #18), drift=detect memory staleness & code drift (Issue #20), health=project health score"),
-      scope: z.string().optional().describe("Research scope for research action (e.g. 'auth', 'database', 'api')"),
+      action: z.enum(["init", "research", "impact", "navigate", "changes", "health", "rollback", "researches", "sync", "visualize", "digest", "drift", "progressive"]).describe("Action: init=project brief, research=5-step research pipeline (REQUIRED before edits), impact=analyze change effects, navigate=trace code flow, changes=view change log, rollback=undo a change by ID, researches=list all cached research, sync=unified batch state, visualize=Mermaid knowledge graph diagram, digest=ultra-compact <500 token project briefing (Issue #18), drift=detect memory staleness & code drift (Issue #20), progressive=progressive context loading (Issue #25), health=project health score"),
+      scope: z.string().optional().describe("Research scope for research/progressive action"),
       target: z.string().optional().describe("Target symbol/file for impact/navigate/changes"),
       goal: z.string().optional().describe("Current goal (for init/health)"),
       since: z.number().optional().describe("Unix timestamp filter for changes"),
-      compact: z.boolean().optional().default(false).describe("Compact output mode")
+      compact: z.boolean().optional().default(false).describe("Compact output mode"),
+      section: z.string().optional().describe("Context section for progressive action (domain_rules, architecture, gotchas, decisions, graph, changes, health)")
     },
     async (params) => {
       try {
@@ -2029,7 +2179,8 @@ function registerAllTools(server) {
           target: params.target,
           goal: params.goal,
           since: params.since,
-          compact: params.compact
+          compact: params.compact,
+          section: params.section
         });
         return { content: [{ type: "text", text }] };
       } catch (err) {
@@ -2041,8 +2192,8 @@ function registerAllTools(server) {
     "kuma_memory",
     "Record and retrieve project knowledge. Actions: decision (ADR-style record/template/suggest), mine (mine historical decisions from git log & code comments), research_save (save research), session (session summary), heal (graph repair), search (search all), changes (change log), todo (persistent todo CRUD), context (inject context notes), benchmark (capture/diff metrics), decision_log (living document with status tracking).",
     {
-      action: z.enum(["decision", "mine", "research_save", "session", "heal", "search", "changes", "todo", "context", "benchmark", "decision_log", "domain_rules", "arch_flow", "gotcha", "layers"]).describe("Memory action: decision=ADR, mine=mine git log & comments, research_save=save, session=summary, heal=repair, search=search, changes=log, todo=manage todos, context=inject notes, benchmark=capture/diff, decision_log=manage decisions, domain_rules=Layer 1 business rules (Issue #17), arch_flow=Layer 2 architecture flow (Issue #17), gotcha=Layer 3 known gotchas (Issue #17/#21), layers=all 3 layers summary"),
-      scope: z.string().optional().describe("Scope for research_save/search/todo/context/mine"),
+      action: z.enum(["decision", "mine", "research_save", "session", "heal", "search", "changes", "todo", "context", "benchmark", "decision_log", "domain_rules", "arch_flow", "gotcha", "layers", "federated", "gen_test", "trajectory", "skills"]).describe("Memory action: decision=ADR, mine=mine git log & comments, research_save=save, session=summary, heal=repair, search=search, changes=log, todo=manage todos, context=inject notes, benchmark=capture/diff, decision_log=manage decisions, domain_rules=Layer 1 business rules (Issue #17), arch_flow=Layer 2 architecture flow (Issue #17), gotcha=Layer 3 known gotchas (Issue #17/#21), layers=all 3 layers summary, federated=resolve federated kuma:// URI (Issue #27), gen_test=generate test from trajectory (Issue #28), trajectory=list trajectories, skills=list distilled skills"),
+      scope: z.string().optional().describe("Scope for research_save/search/todo/context/mine/federated"),
       query: z.string().optional().describe("Search query for search action"),
       content: z.string().optional().describe("Content/notes for research_save / context"),
       record: z.string().optional().describe("JSON record string for research_save"),
@@ -2058,7 +2209,7 @@ function registerAllTools(server) {
       healAction: z.enum(["check", "heal"]).optional().describe("Heal sub-action"),
       topic: z.string().optional().describe("Memory topic for session"),
       limit: z.number().min(1).max(100).optional().describe("Result limit"),
-      target: z.string().optional().describe("File path for changes / decision_log ID"),
+      target: z.string().optional().describe("File path for changes / decision_log ID / trajectory ID"),
       since: z.number().optional().describe("Timestamp filter for changes"),
       compact: z.boolean().optional().default(false).describe("Compact output mode"),
       // Todo params
@@ -2072,7 +2223,9 @@ function registerAllTools(server) {
       // Benchmark params
       label: z.string().optional().describe("Benchmark label"),
       metrics: z.string().optional().describe("Benchmark metrics JSON"),
-      labelB: z.string().optional().describe("Second benchmark label for diff")
+      labelB: z.string().optional().describe("Second benchmark label for diff"),
+      // Federated params (#27)
+      uri: z.string().optional().describe("Federated URI (kuma://project/node-id)")
     },
     async (params) => {
       try {
@@ -2093,7 +2246,8 @@ function registerAllTools(server) {
           topic: params.topic,
           limit: params.limit,
           target: params.target,
-          since: params.since
+          since: params.since,
+          uri: params.uri
         });
         return { content: [{ type: "text", text }] };
       } catch (err) {
@@ -2105,14 +2259,14 @@ function registerAllTools(server) {
     "kuma_safety",
     "Safety checks, policy enforcement, security scanning, integrated auto-verification, and project hygiene. Actions: guard (anti-pattern detection), verify (auto-run scoped tests), check (pre-exec safety), audit (query trail), lock (multi-agent), health (score), security (scan for leaks), gc (garbage collection), doctor (health check), portability (path check), gitignore (auto-config), override (bypass).",
     {
-      action: z.enum(["guard", "verify", "check", "audit", "lock", "health", "override", "security", "gc", "doctor", "portability", "gitignore", "clean", "policy", "ast", "validate"]).describe("Safety action: guard=anti-patterns, verify=auto-run scoped tests, check=pre-exec safety, audit=query trail, lock=multi-agent, health=score, security=scan leaks, gc=garbage collect, doctor=health check, portability=paths, gitignore=config, clean=purge scratch dir & drift, policy=Policy-as-Code engine (Issue #24), ast/validate=AST-based code validation (Issue #22), override=bypass"),
+      action: z.enum(["guard", "verify", "check", "audit", "lock", "health", "override", "security", "gc", "doctor", "portability", "gitignore", "clean", "policy", "ast", "validate", "checkpoint", "rollback_label", "checkpoint_list", "contract"]).describe("Safety action: guard=anti-patterns, verify=auto-run scoped tests, check=pre-exec safety, audit=query trail, lock=multi-agent, health=score, security=scan leaks, gc=garbage collect, doctor=health check, portability=paths, gitignore=config, clean=purge scratch dir & drift, policy=Policy-as-Code engine (Issue #24), ast/validate=AST-based code validation (Issue #22), checkpoint=create atomic snapshot (Issue #29), rollback_label=restore from checkpoint (Issue #29), checkpoint_list=list checkpoints, contract=run contract checks (Issue #26), override=bypass"),
       // Verify params
       scope: z.string().optional().describe("Scope for verify or context (e.g. 'auth', file path)"),
       // Guard params
       guardGoal: z.string().optional().describe("Goal for guard check"),
       guardCheck: z.enum(["all", "anti-pattern", "loop", "drift", "context"]).optional().describe("Guard check type"),
       // Check params
-      filePath: z.string().optional().describe("File path for check/lock/security scan"),
+      filePath: z.string().optional().describe("File path for check/lock/security scan/contract"),
       command: z.string().optional().describe("Command for check"),
       // Audit params
       toolName: z.string().optional().describe("Filter audit by tool name"),
@@ -2126,7 +2280,12 @@ function registerAllTools(server) {
       agentId: z.string().optional().describe("Agent ID for lock"),
       // Override params
       reason: z.string().optional().describe("Reason for safety override"),
-      compact: z.boolean().optional().default(false).describe("Compact output mode")
+      compact: z.boolean().optional().default(false).describe("Compact output mode"),
+      // Checkpoint params (#29)
+      label: z.string().optional().describe("Checkpoint label for checkpoint/rollback_label actions"),
+      description: z.string().optional().describe("Description for checkpoint"),
+      // Contract params (#26)
+      phase: z.enum(["pre", "post"]).optional().describe("Contract check phase")
     },
     async (params) => {
       try {
@@ -2145,7 +2304,10 @@ function registerAllTools(server) {
           lockAction: params.lockAction,
           lockFilePath: params.lockFilePath,
           agentId: params.agentId,
-          reason: params.reason
+          reason: params.reason,
+          label: params.label,
+          description: params.description,
+          phase: params.phase
         });
         return { content: [{ type: "text", text }] };
       } catch (err) {
@@ -2172,6 +2334,7 @@ Usage:
   npx @plumpslabs/kuma init --merge Append to existing files (default)
   npx @plumpslabs/kuma init --skip-existing Skip generation if file exists
   npx @plumpslabs/kuma init --claude --cursor  Generate specific files
+  npx @plumpslabs/kuma studio        Start Kuma Studio web dashboard (knowledge graph visualizer)
   npx @plumpslabs/kuma init --help  Show this help
 
 Available config files:
@@ -2199,7 +2362,7 @@ async function main() {
     console.error("");
     let killedCount = 0;
     try {
-      const { getRunningVerificationPid } = await import("./kumaVerifier-ARSGPZAM.js");
+      const { getRunningVerificationPid } = await import("./kumaVerifier-KAYJHR5K.js");
       const pid = getRunningVerificationPid();
       if (pid) {
         try {
@@ -2291,6 +2454,31 @@ async function main() {
     console.error("");
     process.exit(0);
   }
+  if (args[0] === "studio") {
+    const { fileURLToPath } = await import("url");
+    const { dirname, join } = await import("path");
+    const { spawn } = await import("child_process");
+    const { existsSync } = await import("fs");
+    const distDir = dirname(fileURLToPath(import.meta.url));
+    const studioPath = join(distDir, "..", "packages", "ide", "studio", "dist", "index.js");
+    if (!existsSync(studioPath)) {
+      console.error(`[${SERVER_NAME}] Kuma Studio not found at ${studioPath}`);
+      console.error(`[${SERVER_NAME}] Make sure @plumpslabs/kuma is properly installed.`);
+      console.error(`[${SERVER_NAME}] Or run manually: cd packages/ide/studio && pnpm start`);
+      process.exit(1);
+    }
+    const studioArgs = args.slice(1);
+    const child = spawn("node", [studioPath, ...studioArgs], {
+      stdio: "inherit",
+      cwd: process.cwd()
+    });
+    child.on("exit", (code) => process.exit(code ?? 1));
+    child.on("error", (err) => {
+      console.error(`[${SERVER_NAME}] Failed to start Kuma Studio: ${err.message}`);
+      process.exit(1);
+    });
+    return;
+  }
   if (args[0] === "--hook") {
     process.exit(0);
   }
@@ -2441,7 +2629,7 @@ async function main() {
         console.error(`[${SERVER_NAME}] \u2705 Restored session (${sessionInfo.toolCallCount} previous tool calls)`);
       }
       try {
-        const { buildFromSessionMemory } = await import("./kumaGraph-AWP743TJ.js");
+        const { buildFromSessionMemory } = await import("./kumaGraph-GUQM75WL.js");
         const edgeCount = await buildFromSessionMemory();
         if (edgeCount > 0) {
           console.error(`[${SERVER_NAME}] \u2705 Graph auto-populated with ${edgeCount} entries from session memory`);
@@ -2461,7 +2649,7 @@ async function main() {
         console.error(`[${SERVER_NAME}] \u26A0\uFE0F Scratch directory setup: ${err}`);
       }
       try {
-        const { getDb: getDb2, saveDb } = await import("./kumaDb-6D53ERFP.js");
+        const { getDb: getDb2, saveDb } = await import("./kumaDb-IC7UX7PU.js");
         const db = await getDb2();
         db.run(
           `INSERT INTO sessions (started_at, goal, tool_calls) VALUES (?, ?, ?)`,
@@ -2501,7 +2689,7 @@ fi
         console.error(`[${SERVER_NAME}] \u26A0\uFE0F Auto-capture hook setup: ${err}`);
       }
       try {
-        const { buildSearchVectors } = await import("./kumaSearch-QGB4QVXS.js");
+        const { buildSearchVectors } = await import("./kumaSearch-B5WVYHHD.js");
         const vectors = await buildSearchVectors();
         if (vectors.length > 0) {
           console.error(`[${SERVER_NAME}] \u2705 Search vector cache pre-warmed (${vectors.length} documents)`);