@vpxa/kb 0.1.1 → 0.1.2

package/packages/chunker/dist/treesitter-chunker.js

@@ -1,234 +1,8 @@
-import { extname } from "node:path";
-import { CHUNK_SIZES } from "@kb/core";
-import { CodeChunker } from "./code-chunker.js";
-const LANGUAGE_MODULES = {
-  ".ts": { package: "tree-sitter-typescript", subLanguage: "typescript" },
-  ".tsx": { package: "tree-sitter-typescript", subLanguage: "tsx" },
-  ".mts": { package: "tree-sitter-typescript", subLanguage: "typescript" },
-  ".cts": { package: "tree-sitter-typescript", subLanguage: "typescript" },
-  ".js": { package: "tree-sitter-javascript" },
-  ".jsx": { package: "tree-sitter-javascript" },
-  ".mjs": { package: "tree-sitter-javascript" },
-  ".cjs": { package: "tree-sitter-javascript" },
-  ".py": { package: "tree-sitter-python" },
-  ".go": { package: "tree-sitter-go" },
-  ".rs": { package: "tree-sitter-rust" },
-  ".java": { package: "tree-sitter-java" }
-};
-const DECLARATION_TYPES = /* @__PURE__ */ new Set([
-  // TypeScript / JavaScript
-  "function_declaration",
-  "class_declaration",
-  "interface_declaration",
-  "type_alias_declaration",
-  "enum_declaration",
-  "lexical_declaration",
-  "export_statement",
-  "variable_declaration",
-  "abstract_class_declaration",
-  // Python
-  "function_definition",
-  "class_definition",
-  "decorated_definition",
-  // Go
-  "function_declaration",
-  "method_declaration",
-  "type_declaration",
-  // Rust
-  "function_item",
-  "impl_item",
-  "struct_item",
-  "enum_item",
-  "trait_item",
-  "mod_item",
-  "type_item",
-  // Java
-  "class_declaration",
-  "interface_declaration",
-  "method_declaration",
-  "enum_declaration"
-]);
-class TreeSitterRuntime {
-  static instance = null;
-  // biome-ignore lint/suspicious/noExplicitAny: tree-sitter parser has no published types
-  parser = null;
-  // biome-ignore lint/suspicious/noExplicitAny: tree-sitter language has no published types
-  languages = /* @__PURE__ */ new Map();
-  static async initialize() {
-    if (TreeSitterRuntime.instance) return TreeSitterRuntime.instance;
-    const runtime = new TreeSitterRuntime();
-    if (await runtime.init()) {
-      TreeSitterRuntime.instance = runtime;
-      return runtime;
-    }
-    return null;
-  }
-  static get() {
-    return TreeSitterRuntime.instance;
-  }
-  async init() {
-    try {
-      const parserMod = await import("tree-sitter");
-      const ParserClass = parserMod.default ?? parserMod;
-      this.parser = new ParserClass();
-      for (const [ext, config] of Object.entries(LANGUAGE_MODULES)) {
-        try {
-          const mod = await import(config.package);
-          const resolved = mod.default ?? mod;
-          const lang = config.subLanguage ? resolved[config.subLanguage] : resolved;
-          if (lang) this.languages.set(ext, lang);
-        } catch {
-        }
-      }
-      const loaded = this.languages.size > 0;
-      if (loaded) {
-        console.error(
-          `[KB] Tree-sitter initialized with ${this.languages.size} languages: ${[...this.languages.keys()].join(", ")}`
-        );
-      }
-      return loaded;
-    } catch {
-      return false;
-    }
-  }
-  /** Parse source code with the grammar for the given file extension. */
-  // biome-ignore lint/suspicious/noExplicitAny: tree-sitter tree has no published types
-  parse(content, ext) {
-    const lang = this.languages.get(ext);
-    if (!lang) return null;
-    this.parser.setLanguage(lang);
-    return this.parser.parse(content);
-  }
-  /** Check if a grammar is loaded for the given file extension. */
-  hasLanguage(ext) {
-    return this.languages.has(ext);
-  }
-}
-async function initializeTreeSitter() {
-  const runtime = await TreeSitterRuntime.initialize();
-  return runtime !== null;
-}
-class TreeSitterChunker {
-  maxChunkSize;
-  runtime;
-  regexFallback;
-  constructor(runtime, options) {
-    this.runtime = runtime;
-    this.maxChunkSize = options?.maxChunkSize ?? CHUNK_SIZES.code.max;
-    this.regexFallback = new CodeChunker(options);
-  }
-  chunk(content, metadata) {
-    const ext = extname(metadata.sourcePath).toLowerCase();
-    const tree = this.runtime.parse(content, ext);
-    if (!tree) {
-      return this.regexFallback.chunk(content, metadata);
-    }
-    try {
-      return this.chunkFromAst(tree, content, metadata);
-    } catch {
-      return this.regexFallback.chunk(content, metadata);
-    }
-  }
-  // biome-ignore lint/suspicious/noExplicitAny: tree-sitter tree has no published types
-  chunkFromAst(tree, content, metadata) {
-    const rootNode = tree.rootNode;
-    const chunks = [];
-    const declarations = [];
-    for (let i = 0; i < rootNode.childCount; i++) {
-      const child = rootNode.child(i);
-      if (!child) continue;
-      if (DECLARATION_TYPES.has(child.type)) {
-        let startByte = child.startPosition ? child.startIndex : child.startByte ?? 0;
-        let startRow = child.startPosition?.row ?? 0;
-        let prev = child.previousSibling;
-        while (prev && (prev.type === "comment" || prev.type === "line_comment" || prev.type === "block_comment" || prev.type === "decorator")) {
-          startByte = prev.startIndex ?? prev.startByte ?? startByte;
-          startRow = prev.startPosition?.row ?? startRow;
-          prev = prev.previousSibling;
-        }
-        declarations.push({
-          startByte,
-          endByte: child.endIndex ?? child.endByte ?? content.length,
-          startRow,
-          endRow: child.endPosition?.row ?? content.split("\n").length - 1
-        });
-      }
-    }
-    if (declarations.length === 0) {
-      return this.regexFallback.chunk(content, metadata);
-    }
-    if (declarations[0].startByte > 0) {
-      const preamble = content.slice(0, declarations[0].startByte).trim();
-      if (preamble.length > 0) {
-        chunks.push({
-          text: `// File: ${metadata.sourcePath}
-${preamble}`,
-          sourcePath: metadata.sourcePath,
-          contentType: metadata.contentType,
-          chunkIndex: 0,
-          totalChunks: 0,
-          startLine: 1,
-          endLine: declarations[0].startRow + 1
-        });
-      }
-    }
-    for (const decl of declarations) {
-      let text = content.slice(decl.startByte, decl.endByte).trim();
-      const header = `// File: ${metadata.sourcePath}
-`;
-      text = header + text;
-      if (text.length > this.maxChunkSize) {
-        const subChunks = this.splitByLines(text, this.maxChunkSize);
-        let currentLine = decl.startRow + 1;
-        for (const sub of subChunks) {
-          const subLines = sub.split("\n").length;
-          chunks.push({
-            text: sub,
-            sourcePath: metadata.sourcePath,
-            contentType: metadata.contentType,
-            chunkIndex: chunks.length,
-            totalChunks: 0,
-            startLine: currentLine,
-            endLine: currentLine + subLines - 1
-          });
-          currentLine += subLines;
-        }
-      } else {
-        chunks.push({
-          text,
-          sourcePath: metadata.sourcePath,
-          contentType: metadata.contentType,
-          chunkIndex: chunks.length,
-          totalChunks: 0,
-          startLine: decl.startRow + 1,
-          endLine: decl.endRow + 1
-        });
-      }
-    }
-    return chunks.map((c, i) => ({ ...c, chunkIndex: i, totalChunks: chunks.length }));
-  }
-  splitByLines(text, maxSize) {
-    const lines = text.split("\n");
-    const result = [];
-    let current = [];
-    let currentSize = 0;
-    for (const line of lines) {
-      if (currentSize + line.length + 1 > maxSize && current.length > 0) {
-        result.push(current.join("\n"));
-        current = [line];
-        currentSize = line.length;
-      } else {
-        current.push(line);
-        currentSize += line.length + 1;
-      }
-    }
-    if (current.length > 0) result.push(current.join("\n"));
-    return result;
-  }
-}
-export {
-  TreeSitterChunker,
-  TreeSitterRuntime,
-  initializeTreeSitter
-};
-//# sourceMappingURL=treesitter-chunker.js.map
+import{extname as m}from"node:path";import{CHUNK_SIZES as k}from"@kb/core";import{CodeChunker as y}from"./code-chunker.js";const f={".ts":{package:"tree-sitter-typescript",subLanguage:"typescript"},".tsx":{package:"tree-sitter-typescript",subLanguage:"tsx"},".mts":{package:"tree-sitter-typescript",subLanguage:"typescript"},".cts":{package:"tree-sitter-typescript",subLanguage:"typescript"},".js":{package:"tree-sitter-javascript"},".jsx":{package:"tree-sitter-javascript"},".mjs":{package:"tree-sitter-javascript"},".cjs":{package:"tree-sitter-javascript"},".py":{package:"tree-sitter-python"},".go":{package:"tree-sitter-go"},".rs":{package:"tree-sitter-rust"},".java":{package:"tree-sitter-java"}},b=new Set(["function_declaration","class_declaration","interface_declaration","type_alias_declaration","enum_declaration","lexical_declaration","export_statement","variable_declaration","abstract_class_declaration","function_definition","class_definition","decorated_definition","function_declaration","method_declaration","type_declaration","function_item","impl_item","struct_item","enum_item","trait_item","mod_item","type_item","class_declaration","interface_declaration","method_declaration","enum_declaration"]);class u{static instance=null;parser=null;languages=new Map;static async initialize(){if(u.instance)return u.instance;const t=new u;return await t.init()?(u.instance=t,t):null}static get(){return u.instance}async init(){try{const t=await import("tree-sitter"),r=t.default??t;this.parser=new r;for(const[c,s]of Object.entries(f))try{const o=await import(s.package),e=o.default??o,n=s.subLanguage?e[s.subLanguage]:e;n&&this.languages.set(c,n)}catch{}const i=this.languages.size>0;return i&&console.error(`[KB] Tree-sitter initialized with ${this.languages.size} languages: ${[...this.languages.keys()].join(", ")}`),i}catch{return!1}}parse(t,r){const i=this.languages.get(r);return i?(this.parser.setLanguage(i),this.parser.parse(t)):null}hasLanguage(t){return this.languages.has(t)}}async function w(){return await u.initialize()!==null}class L{maxChunkSize;runtime;regexFallback;constructor(t,r){this.runtime=t,this.maxChunkSize=r?.maxChunkSize??k.code.max,this.regexFallback=new y(r)}chunk(t,r){const i=m(r.sourcePath).toLowerCase(),c=this.runtime.parse(t,i);if(!c)return this.regexFallback.chunk(t,r);try{return this.chunkFromAst(c,t,r)}catch{return this.regexFallback.chunk(t,r)}}chunkFromAst(t,r,i){const c=t.rootNode,s=[],o=[];for(let e=0;e<c.childCount;e++){const n=c.child(e);if(n&&b.has(n.type)){let h=n.startPosition?n.startIndex:n.startByte??0,l=n.startPosition?.row??0,a=n.previousSibling;for(;a&&(a.type==="comment"||a.type==="line_comment"||a.type==="block_comment"||a.type==="decorator");)h=a.startIndex??a.startByte??h,l=a.startPosition?.row??l,a=a.previousSibling;o.push({startByte:h,endByte:n.endIndex??n.endByte??r.length,startRow:l,endRow:n.endPosition?.row??r.split(`
+`).length-1})}}if(o.length===0)return this.regexFallback.chunk(r,i);if(o[0].startByte>0){const e=r.slice(0,o[0].startByte).trim();e.length>0&&s.push({text:`// File: ${i.sourcePath}
+${e}`,sourcePath:i.sourcePath,contentType:i.contentType,chunkIndex:0,totalChunks:0,startLine:1,endLine:o[0].startRow+1})}for(const e of o){let n=r.slice(e.startByte,e.endByte).trim();if(n=`// File: ${i.sourcePath}
+`+n,n.length>this.maxChunkSize){const l=this.splitByLines(n,this.maxChunkSize);let a=e.startRow+1;for(const p of l){const g=p.split(`
+`).length;s.push({text:p,sourcePath:i.sourcePath,contentType:i.contentType,chunkIndex:s.length,totalChunks:0,startLine:a,endLine:a+g-1}),a+=g}}else s.push({text:n,sourcePath:i.sourcePath,contentType:i.contentType,chunkIndex:s.length,totalChunks:0,startLine:e.startRow+1,endLine:e.endRow+1})}return s.map((e,n)=>({...e,chunkIndex:n,totalChunks:s.length}))}splitByLines(t,r){const i=t.split(`
+`),c=[];let s=[],o=0;for(const e of i)o+e.length+1>r&&s.length>0?(c.push(s.join(`
+`)),s=[e],o=e.length):(s.push(e),o+=e.length+1);return s.length>0&&c.push(s.join(`
+`)),c}}export{L as TreeSitterChunker,u as TreeSitterRuntime,w as initializeTreeSitter};

package/packages/cli/dist/commands/analyze.js

@@ -1,112 +1,3 @@
-import { resolve } from "node:path";
-const analyzeCommands = [
-  {
-    name: "analyze",
-    description: "Run analyzer output for a path",
-    usage: "kb analyze <type> <path>",
-    run: async (args) => {
-      const type = args.shift()?.trim() ?? "";
-      const targetPath = args.shift()?.trim() ?? "";
-      if (!type || !targetPath) {
-        console.error("Usage: kb analyze <type> <path>");
-        console.error(
-          "Types: structure, deps, symbols, patterns, entry-points, blast-radius, diagram"
-        );
-        process.exit(1);
-      }
-      const {
-        BlastRadiusAnalyzer,
-        DependencyAnalyzer,
-        DiagramGenerator,
-        EntryPointAnalyzer,
-        PatternAnalyzer,
-        StructureAnalyzer,
-        SymbolAnalyzer
-      } = await import("@kb/analyzers");
-      const absolutePath = resolve(targetPath);
-      let result;
-      switch (type) {
-        case "structure":
-          result = await new StructureAnalyzer().analyze(absolutePath, { format: "markdown" });
-          break;
-        case "deps":
-        case "dependencies":
-          result = await new DependencyAnalyzer().analyze(absolutePath, { format: "markdown" });
-          break;
-        case "symbols":
-          result = await new SymbolAnalyzer().analyze(absolutePath, { format: "markdown" });
-          break;
-        case "patterns":
-          result = await new PatternAnalyzer().analyze(absolutePath, { format: "markdown" });
-          break;
-        case "entry-points":
-          result = await new EntryPointAnalyzer().analyze(absolutePath, { format: "markdown" });
-          break;
-        case "blast-radius":
-          result = await new BlastRadiusAnalyzer().analyze(process.cwd(), {
-            files: [targetPath],
-            format: "markdown"
-          });
-          break;
-        case "diagram":
-          result = await new DiagramGenerator().analyze(absolutePath, {
-            diagramType: "architecture"
-          });
-          break;
-        default:
-          console.error(`Unknown analyze type: ${type}`);
-          console.error(
-            "Types: structure, deps, symbols, patterns, entry-points, blast-radius, diagram"
-          );
-          process.exit(1);
-      }
-      console.log(result.output);
-    }
-  },
-  {
-    name: "onboard",
-    description: "Run all analyses for first-time codebase onboarding",
-    usage: "kb onboard <path> [--generate] [--out-dir <dir>]",
-    run: async (args) => {
-      const { onboard } = await import("@kb/tools");
-      let targetPath = "";
-      let mode = "memory";
-      let outDir;
-      for (let i = 0; i < args.length; i++) {
-        const arg = args[i].trim();
-        if (arg === "--generate") {
-          mode = "generate";
-        } else if (arg === "--out-dir" && i + 1 < args.length) {
-          outDir = args[++i].trim();
-        } else if (!arg.startsWith("--")) {
-          targetPath = arg;
-        }
-      }
-      if (!targetPath) {
-        targetPath = process.cwd();
-      }
-      const absolutePath = resolve(targetPath);
-      console.log(`Onboarding: ${absolutePath} (mode: ${mode})`);
-      console.log("Running analyses...\n");
-      const result = await onboard({
-        path: absolutePath,
-        mode,
-        outDir
-      });
-      for (const step of result.steps) {
-        const icon = step.status === "success" ? "\u2713" : "\u2717";
-        const info = step.status === "success" ? `${step.durationMs}ms, ${step.output.length} chars` : step.error;
-        console.log(`  ${icon} ${step.name} \u2014 ${info}`);
-      }
-      console.log(`
-Total: ${result.totalDurationMs}ms`);
-      if (result.outDir) {
-        console.log(`Output written to: ${result.outDir}`);
-      }
-    }
-  }
-];
-export {
-  analyzeCommands
-};
-//# sourceMappingURL=analyze.js.map
+import{resolve as p}from"node:path";const d=[{name:"analyze",description:"Run analyzer output for a path",usage:"kb analyze <type> <path>",run:async r=>{const i=r.shift()?.trim()??"",a=r.shift()?.trim()??"";(!i||!a)&&(console.error("Usage: kb analyze <type> <path>"),console.error("Types: structure, deps, symbols, patterns, entry-points, blast-radius, diagram"),process.exit(1));const{BlastRadiusAnalyzer:l,DependencyAnalyzer:c,DiagramGenerator:m,EntryPointAnalyzer:n,PatternAnalyzer:e,StructureAnalyzer:t,SymbolAnalyzer:u}=await import("@kb/analyzers"),s=p(a);let o;switch(i){case"structure":o=await new t().analyze(s,{format:"markdown"});break;case"deps":case"dependencies":o=await new c().analyze(s,{format:"markdown"});break;case"symbols":o=await new u().analyze(s,{format:"markdown"});break;case"patterns":o=await new e().analyze(s,{format:"markdown"});break;case"entry-points":o=await new n().analyze(s,{format:"markdown"});break;case"blast-radius":o=await new l().analyze(process.cwd(),{files:[a],format:"markdown"});break;case"diagram":o=await new m().analyze(s,{diagramType:"architecture"});break;default:console.error(`Unknown analyze type: ${i}`),console.error("Types: structure, deps, symbols, patterns, entry-points, blast-radius, diagram"),process.exit(1)}console.log(o.output)}},{name:"onboard",description:"Run all analyses for first-time codebase onboarding",usage:"kb onboard <path> [--generate] [--out-dir <dir>]",run:async r=>{const{onboard:i}=await import("@kb/tools");let a="",l="memory",c;for(let e=0;e<r.length;e++){const t=r[e].trim();t==="--generate"?l="generate":t==="--out-dir"&&e+1<r.length?c=r[++e].trim():t.startsWith("--")||(a=t)}a||(a=process.cwd());const m=p(a);console.log(`Onboarding: ${m} (mode: ${l})`),console.log(`Running analyses...
+`);const n=await i({path:m,mode:l,outDir:c});for(const e of n.steps){const t=e.status==="success"?"\u2713":"\u2717",u=e.status==="success"?`${e.durationMs}ms, ${e.output.length} chars`:e.error;console.log(`  ${t} ${e.name} \u2014 ${u}`)}console.log(`
+Total: ${n.totalDurationMs}ms`),n.outDir&&console.log(`Output written to: ${n.outDir}`)}}];export{d as analyzeCommands};

package/packages/cli/dist/commands/context-cmds.js

@@ -1,155 +1 @@
-import { resolve } from "node:path";
-import {
-  checkpointLatest,
-  checkpointList,
-  checkpointLoad,
-  checkpointSave,
-  diffParse,
-  fileSummary,
-  gitContext,
-  parseOutput
-} from "@kb/tools";
-import {
-  extractBoolFlag,
-  extractNumFlag,
-  extractStrFlag,
-  parseRecordString,
-  printCheckpoint,
-  printDiffFiles,
-  printFileSummary,
-  printGitContext,
-  printParsedOutput,
-  readStdin
-} from "../helpers.js";
-const contextCommands = [
-  {
-    name: "parse-output",
-    description: "Parse build or tool output from stdin",
-    usage: "kb parse-output [--tool tsc|vitest|biome|git-status]",
-    run: async (args) => {
-      const tool = extractStrFlag(args, "--tool", "").trim() || void 0;
-      const input = await readStdin();
-      if (!input.trim()) {
-        console.error("Usage: kb parse-output [--tool tsc|vitest|biome|git-status]");
-        process.exit(1);
-      }
-      printParsedOutput(parseOutput(input, tool));
-    }
-  },
-  {
-    name: "git",
-    description: "Show git branch, status, recent commits, and optional diff stats",
-    usage: "kb git [--cwd path] [--commit-count N] [--diff]",
-    run: async (args) => {
-      const cwd = extractStrFlag(args, "--cwd", "").trim() || void 0;
-      const commitCount = extractNumFlag(args, "--commit-count", 5);
-      const includeDiff = extractBoolFlag(args, "--diff");
-      const result = await gitContext({ cwd, commitCount, includeDiff });
-      printGitContext(result);
-    }
-  },
-  {
-    name: "diff",
-    description: "Parse unified diff text from stdin into structured file changes",
-    usage: "git diff | kb diff",
-    run: async () => {
-      const input = await readStdin();
-      if (!input.trim()) {
-        console.error("Usage: git diff | kb diff");
-        process.exit(1);
-      }
-      printDiffFiles(diffParse({ diff: input }));
-    }
-  },
-  {
-    name: "summarize",
-    description: "Show a structural summary of a file",
-    usage: "kb summarize <path>",
-    run: async (args) => {
-      const targetPath = args.shift()?.trim();
-      if (!targetPath) {
-        console.error("Usage: kb summarize <path>");
-        process.exit(1);
-      }
-      const summary = await fileSummary({ path: resolve(targetPath) });
-      printFileSummary(summary);
-    }
-  },
-  {
-    name: "checkpoint",
-    description: "Save and restore lightweight session checkpoints",
-    usage: "kb checkpoint <save|load|list|latest> [label-or-id] [--data json] [--notes text]",
-    run: async (args) => {
-      const action = args.shift()?.trim();
-      if (!action) {
-        console.error(
-          "Usage: kb checkpoint <save|load|list|latest> [label-or-id] [--data json] [--notes text]"
-        );
-        process.exit(1);
-      }
-      switch (action) {
-        case "save": {
-          const label = args.shift()?.trim();
-          const dataFlag = extractStrFlag(args, "--data", "");
-          const notes = extractStrFlag(args, "--notes", "").trim() || void 0;
-          const stdinData = dataFlag.trim() ? "" : await readStdin();
-          if (!label) {
-            console.error("Usage: kb checkpoint save <label> [--data json] [--notes text]");
-            process.exit(1);
-          }
-          const checkpoint = checkpointSave(label, parseRecordString(dataFlag || stdinData), {
-            notes
-          });
-          printCheckpoint(checkpoint);
-          return;
-        }
-        case "load": {
-          const id = args.shift()?.trim();
-          if (!id) {
-            console.error("Usage: kb checkpoint load <id>");
-            process.exit(1);
-          }
-          const checkpoint = checkpointLoad(id);
-          if (!checkpoint) {
-            console.log(`No checkpoint found: ${id}`);
-            return;
-          }
-          printCheckpoint(checkpoint);
-          return;
-        }
-        case "list": {
-          const checkpoints = checkpointList();
-          if (checkpoints.length === 0) {
-            console.log("No checkpoints saved.");
-            return;
-          }
-          console.log(`Checkpoints (${checkpoints.length})`);
-          console.log("\u2500".repeat(60));
-          for (const checkpoint of checkpoints) {
-            console.log(`${checkpoint.id}`);
-            console.log(`  Label: ${checkpoint.label}`);
-            console.log(`  Created: ${checkpoint.createdAt}`);
-          }
-          return;
-        }
-        case "latest": {
-          const checkpoint = checkpointLatest();
-          if (!checkpoint) {
-            console.log("No checkpoints saved.");
-            return;
-          }
-          printCheckpoint(checkpoint);
-          return;
-        }
-        default:
-          console.error(`Unknown checkpoint action: ${action}`);
-          console.error("Actions: save, load, list, latest");
-          process.exit(1);
-      }
-    }
-  }
-];
-export {
-  contextCommands
-};
-//# sourceMappingURL=context-cmds.js.map
+import{resolve as p}from"node:path";import{checkpointLatest as d,checkpointList as u,checkpointLoad as f,checkpointSave as m,diffParse as h,fileSummary as k,gitContext as g,parseOutput as b}from"@kb/tools";import{extractBoolFlag as x,extractNumFlag as w,extractStrFlag as i,parseRecordString as v,printCheckpoint as c,printDiffFiles as y,printFileSummary as C,printGitContext as S,printParsedOutput as U,readStdin as a}from"../helpers.js";const P=[{name:"parse-output",description:"Parse build or tool output from stdin",usage:"kb parse-output [--tool tsc|vitest|biome|git-status]",run:async e=>{const s=i(e,"--tool","").trim()||void 0,t=await a();t.trim()||(console.error("Usage: kb parse-output [--tool tsc|vitest|biome|git-status]"),process.exit(1)),U(b(t,s))}},{name:"git",description:"Show git branch, status, recent commits, and optional diff stats",usage:"kb git [--cwd path] [--commit-count N] [--diff]",run:async e=>{const s=i(e,"--cwd","").trim()||void 0,t=w(e,"--commit-count",5),o=x(e,"--diff"),n=await g({cwd:s,commitCount:t,includeDiff:o});S(n)}},{name:"diff",description:"Parse unified diff text from stdin into structured file changes",usage:"git diff | kb diff",run:async()=>{const e=await a();e.trim()||(console.error("Usage: git diff | kb diff"),process.exit(1)),y(h({diff:e}))}},{name:"summarize",description:"Show a structural summary of a file",usage:"kb summarize <path>",run:async e=>{const s=e.shift()?.trim();s||(console.error("Usage: kb summarize <path>"),process.exit(1));const t=await k({path:p(s)});C(t)}},{name:"checkpoint",description:"Save and restore lightweight session checkpoints",usage:"kb checkpoint <save|load|list|latest> [label-or-id] [--data json] [--notes text]",run:async e=>{const s=e.shift()?.trim();switch(s||(console.error("Usage: kb checkpoint <save|load|list|latest> [label-or-id] [--data json] [--notes text]"),process.exit(1)),s){case"save":{const t=e.shift()?.trim(),o=i(e,"--data",""),n=i(e,"--notes","").trim()||void 0,r=o.trim()?"":await a();t||(console.error("Usage: kb checkpoint save <label> [--data json] [--notes text]"),process.exit(1));const l=m(t,v(o||r),{notes:n});c(l);return}case"load":{const t=e.shift()?.trim();t||(console.error("Usage: kb checkpoint load <id>"),process.exit(1));const o=f(t);if(!o){console.log(`No checkpoint found: ${t}`);return}c(o);return}case"list":{const t=u();if(t.length===0){console.log("No checkpoints saved.");return}console.log(`Checkpoints (${t.length})`),console.log("\u2500".repeat(60));for(const o of t)console.log(`${o.id}`),console.log(`  Label: ${o.label}`),console.log(`  Created: ${o.createdAt}`);return}case"latest":{const t=d();if(!t){console.log("No checkpoints saved.");return}c(t);return}default:console.error(`Unknown checkpoint action: ${s}`),console.error("Actions: save, load, list, latest"),process.exit(1)}}}];export{P as contextCommands};