@vpxa/kb 0.1.1 → 0.1.3

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

@@ -1,241 +1,4 @@
-import { fork } from "node:child_process";
-import { dirname, resolve } from "node:path";
-import { fileURLToPath } from "node:url";
-import { batch, check, health, replayClear, replayList, replayTrim } from "@kb/tools";
-import { ctx } from "../context.js";
-import {
-  executeCliBatchOperation,
-  extractStrFlag,
-  parseBatchPayload,
-  printCheckResult,
-  readInput
-} from "../helpers.js";
-const __dirname = dirname(fileURLToPath(import.meta.url));
-const systemCommands = [
-  {
-    name: "status",
-    description: "Show knowledge base index status and statistics",
-    run: async () => {
-      const { store } = await ctx();
-      const stats = await store.getStats();
-      const paths = await store.listSourcePaths();
-      console.log("Knowledge Base Status");
-      console.log("\u2500".repeat(40));
-      console.log(`  Records:  ${stats.totalRecords}`);
-      console.log(`  Files:    ${stats.totalFiles}`);
-      console.log(`  Indexed:  ${stats.lastIndexedAt ?? "Never"}`);
-      console.log(`  Backend:  ${stats.storeBackend}`);
-      console.log(`  Model:    ${stats.embeddingModel}`);
-      console.log("");
-      console.log("Content Types:");
-      for (const [type, count] of Object.entries(stats.contentTypeBreakdown)) {
-        console.log(`  ${type}: ${count}`);
-      }
-      if (paths.length > 0) {
-        console.log("");
-        console.log(`Files (${paths.length} total):`);
-        for (const p of paths.slice(0, 20)) console.log(`  ${p}`);
-        if (paths.length > 20) console.log(`  ... and ${paths.length - 20} more`);
-      }
-    }
-  },
-  {
-    name: "reindex",
-    description: "Re-index the knowledge base from configured sources",
-    usage: "kb reindex [--full]",
-    run: async (args) => {
-      const full = args.includes("--full");
-      const { store, indexer, curated, config } = await ctx();
-      console.log("Indexing sources...");
-      const progressCb = (p) => {
-        if (p.phase === "chunking" && p.currentFile) {
-          process.stdout.write(`\r  [${p.filesProcessed + 1}/${p.filesTotal}] ${p.currentFile}`);
-        }
-        if (p.phase === "done") process.stdout.write("\n");
-      };
-      let result;
-      if (full) {
-        console.log("Dropping existing index for full reindex...");
-        result = await indexer.reindexAll(config, progressCb);
-      } else {
-        result = await indexer.index(config, progressCb);
-      }
-      console.log(
-        `Done: ${result.filesProcessed} files, ${result.chunksCreated} chunks in ${(result.durationMs / 1e3).toFixed(1)}s`
-      );
-      console.log("Building FTS index...");
-      await store.createFtsIndex();
-      console.log("Re-indexing curated entries...");
-      const curatedResult = await curated.reindexAll();
-      console.log(`Curated: ${curatedResult.indexed} entries restored`);
-    }
-  },
-  {
-    name: "serve",
-    description: "Start the MCP server (stdio or HTTP)",
-    usage: "kb serve [--transport stdio|http] [--port N]",
-    run: async (args) => {
-      const serverEntry = resolve(__dirname, "..", "..", "..", "server", "dist", "index.js");
-      const transport = extractStrFlag(args, "--transport", "stdio");
-      const port = extractStrFlag(args, "--port", "3210");
-      const child = fork(serverEntry, [], {
-        stdio: transport === "stdio" ? ["pipe", "pipe", "inherit", "ipc"] : "inherit",
-        env: {
-          ...process.env,
-          KB_TRANSPORT: transport,
-          KB_PORT: port
-        }
-      });
-      if (transport === "stdio" && child.stdin && child.stdout) {
-        process.stdin.pipe(child.stdin);
-        child.stdout.pipe(process.stdout);
-      }
-      child.on("exit", (code) => process.exit(code ?? 0));
-      process.on("SIGINT", () => child.kill("SIGINT"));
-      process.on("SIGTERM", () => child.kill("SIGTERM"));
-      await new Promise(() => {
-      });
-    }
-  },
-  {
-    name: "init",
-    description: "Initialize a knowledge base in the current directory",
-    usage: "kb init [--force]",
-    run: async (args) => {
-      const force = args.includes("--force");
-      const { initProject } = await import("./init.js");
-      await initProject({ force });
-    }
-  },
-  {
-    name: "check",
-    description: "Run incremental typecheck and lint",
-    usage: "kb check [--cwd <dir>] [--files f1,f2] [--skip-types] [--skip-lint]",
-    run: async (args) => {
-      const cwd = extractStrFlag(args, "--cwd", "").trim() || void 0;
-      const filesValue = extractStrFlag(args, "--files", "");
-      const files = filesValue.split(",").map((item) => item.trim()).filter(Boolean);
-      let skipTypes = false;
-      if (args.includes("--skip-types")) {
-        args.splice(args.indexOf("--skip-types"), 1);
-        skipTypes = true;
-      }
-      let skipLint = false;
-      if (args.includes("--skip-lint")) {
-        args.splice(args.indexOf("--skip-lint"), 1);
-        skipLint = true;
-      }
-      const result = await check({
-        cwd,
-        files: files.length > 0 ? files : void 0,
-        skipTypes,
-        skipLint
-      });
-      printCheckResult(result);
-      if (!result.passed) process.exitCode = 1;
-    }
-  },
-  {
-    name: "batch",
-    description: "Execute built-in operations from JSON input",
-    usage: "kb batch [--file path] [--concurrency N]",
-    run: async (args) => {
-      const filePath = extractStrFlag(args, "--file", "").trim() || void 0;
-      const overrideConcurrency = (() => {
-        const idx = args.indexOf("--concurrency");
-        if (idx === -1 || idx + 1 >= args.length) return 0;
-        const val = Number.parseInt(args.splice(idx, 2)[1], 10);
-        return Number.isNaN(val) ? 0 : val;
-      })();
-      const input = await readInput(filePath);
-      if (!input.trim()) {
-        console.error("Usage: kb batch [--file path] [--concurrency N]");
-        process.exit(1);
-      }
-      const payload = parseBatchPayload(input);
-      const concurrency = overrideConcurrency > 0 ? overrideConcurrency : payload.concurrency;
-      const needsContext = payload.operations.some((operation) => operation.type !== "check");
-      const context = needsContext ? await ctx() : null;
-      const result = await batch(
-        payload.operations,
-        async (operation) => executeCliBatchOperation(operation, context),
-        { concurrency }
-      );
-      console.log(JSON.stringify(result, null, 2));
-      if (result.some((item) => item.status === "error")) process.exitCode = 1;
-    }
-  },
-  {
-    name: "health",
-    description: "Run project health checks on the current directory",
-    usage: "kb health [path]",
-    run: async (args) => {
-      const targetPath = args.shift();
-      const result = health(targetPath);
-      console.log(`Project Health: ${result.path}`);
-      console.log("\u2500".repeat(50));
-      for (const check2 of result.checks) {
-        const icon = check2.status === "pass" ? "+" : check2.status === "warn" ? "~" : "X";
-        console.log(`  [${icon}] ${check2.name}: ${check2.message}`);
-      }
-      console.log("\u2500".repeat(50));
-      console.log(`Score: ${result.score}% \u2014 ${result.summary}`);
-    }
-  },
-  {
-    name: "replay",
-    description: "Show recent tool invocation audit trail",
-    usage: "kb replay [--last N] [--tool <name>] [--source mcp|cli]",
-    run: async (args) => {
-      const last = Number.parseInt(args[args.indexOf("--last") + 1], 10) || 20;
-      const toolFilter = args.includes("--tool") ? args[args.indexOf("--tool") + 1] : void 0;
-      const sourceFilter = args.includes("--source") ? args[args.indexOf("--source") + 1] : void 0;
-      const entries = replayList({ last, tool: toolFilter, source: sourceFilter });
-      if (entries.length === 0) {
-        console.log("No replay entries. Activity is logged when tools are invoked.");
-        return;
-      }
-      console.log(`Replay Log (${entries.length} entries)
-`);
-      for (const e of entries) {
-        const time = e.ts.split("T")[1]?.split(".")[0] ?? e.ts;
-        const status = e.status === "ok" ? "\u2713" : "\u2717";
-        console.log(`${time} ${status} ${e.tool} (${e.durationMs}ms) [${e.source}]`);
-        console.log(`  in:  ${e.input}`);
-        console.log(`  out: ${e.output}`);
-      }
-      replayTrim();
-    }
-  },
-  {
-    name: "replay-clear",
-    description: "Clear the replay audit trail",
-    run: async () => {
-      replayClear();
-      console.log("Replay log cleared.");
-    }
-  },
-  {
-    name: "tui",
-    description: "Launch interactive terminal dashboard (human monitoring)",
-    run: async () => {
-      try {
-        const { launch } = await import("@kb/tui");
-        const { store, embedder, config } = await ctx();
-        launch({ store, embedder, config });
-      } catch (err) {
-        if (err.code === "ERR_MODULE_NOT_FOUND") {
-          console.error(
-            "TUI requires ink and react. Install them with:\n  pnpm add -D ink react @types/react"
-          );
-          process.exit(1);
-        }
-        throw err;
-      }
-    }
-  }
-];
-export {
-  systemCommands
-};
-//# sourceMappingURL=system.js.map
+import{fork as f}from"node:child_process";import{dirname as m,resolve as h}from"node:path";import{fileURLToPath as g}from"node:url";import{batch as y,check as x,health as k,replayClear as w,replayList as $,replayTrim as b}from"../../../tools/dist/index.js";import{ctx as p}from"../context.js";import{executeCliBatchOperation as I,extractStrFlag as a,parseBatchPayload as R,printCheckResult as N,readInput as T}from"../helpers.js";const C=m(g(import.meta.url)),E=[{name:"status",description:"Show knowledge base index status and statistics",run:async()=>{const{store:e}=await p(),s=await e.getStats(),t=await e.listSourcePaths();console.log("Knowledge Base Status"),console.log("\u2500".repeat(40)),console.log(`  Records:  ${s.totalRecords}`),console.log(`  Files:    ${s.totalFiles}`),console.log(`  Indexed:  ${s.lastIndexedAt??"Never"}`),console.log(`  Backend:  ${s.storeBackend}`),console.log(`  Model:    ${s.embeddingModel}`),console.log(""),console.log("Content Types:");for(const[n,o]of Object.entries(s.contentTypeBreakdown))console.log(`  ${n}: ${o}`);if(t.length>0){console.log(""),console.log(`Files (${t.length} total):`);for(const n of t.slice(0,20))console.log(`  ${n}`);t.length>20&&console.log(`  ... and ${t.length-20} more`)}}},{name:"reindex",description:"Re-index the knowledge base from configured sources",usage:"kb reindex [--full]",run:async e=>{const s=e.includes("--full"),{store:t,indexer:n,curated:o,config:i}=await p();console.log("Indexing sources...");const l=r=>{r.phase==="chunking"&&r.currentFile&&process.stdout.write(`\r  [${r.filesProcessed+1}/${r.filesTotal}] ${r.currentFile}`),r.phase==="done"&&process.stdout.write(`
+`)};let c;s?(console.log("Dropping existing index for full reindex..."),c=await n.reindexAll(i,l)):c=await n.index(i,l),console.log(`Done: ${c.filesProcessed} files, ${c.chunksCreated} chunks in ${(c.durationMs/1e3).toFixed(1)}s`),console.log("Building FTS index..."),await t.createFtsIndex(),console.log("Re-indexing curated entries...");const d=await o.reindexAll();console.log(`Curated: ${d.indexed} entries restored`)}},{name:"serve",description:"Start the MCP server (stdio or HTTP)",usage:"kb serve [--transport stdio|http] [--port N]",run:async e=>{const s=h(C,"..","..","..","server","dist","index.js"),t=a(e,"--transport","stdio"),n=a(e,"--port","3210"),o=f(s,[],{stdio:t==="stdio"?["pipe","pipe","inherit","ipc"]:"inherit",env:{...process.env,KB_TRANSPORT:t,KB_PORT:n}});t==="stdio"&&o.stdin&&o.stdout&&(process.stdin.pipe(o.stdin),o.stdout.pipe(process.stdout)),o.on("exit",i=>process.exit(i??0)),process.on("SIGINT",()=>o.kill("SIGINT")),process.on("SIGTERM",()=>o.kill("SIGTERM")),await new Promise(()=>{})}},{name:"init",description:"Initialize a knowledge base in the current directory",usage:"kb init [--force]",run:async e=>{const s=e.includes("--force"),{initProject:t}=await import("./init.js");await t({force:s})}},{name:"check",description:"Run incremental typecheck and lint",usage:"kb check [--cwd <dir>] [--files f1,f2] [--skip-types] [--skip-lint]",run:async e=>{const s=a(e,"--cwd","").trim()||void 0,n=a(e,"--files","").split(",").map(c=>c.trim()).filter(Boolean);let o=!1;e.includes("--skip-types")&&(e.splice(e.indexOf("--skip-types"),1),o=!0);let i=!1;e.includes("--skip-lint")&&(e.splice(e.indexOf("--skip-lint"),1),i=!0);const l=await x({cwd:s,files:n.length>0?n:void 0,skipTypes:o,skipLint:i});N(l),l.passed||(process.exitCode=1)}},{name:"batch",description:"Execute built-in operations from JSON input",usage:"kb batch [--file path] [--concurrency N]",run:async e=>{const s=a(e,"--file","").trim()||void 0,t=(()=>{const r=e.indexOf("--concurrency");if(r===-1||r+1>=e.length)return 0;const u=Number.parseInt(e.splice(r,2)[1],10);return Number.isNaN(u)?0:u})(),n=await T(s);n.trim()||(console.error("Usage: kb batch [--file path] [--concurrency N]"),process.exit(1));const o=R(n),i=t>0?t:o.concurrency,c=o.operations.some(r=>r.type!=="check")?await p():null,d=await y(o.operations,async r=>I(r,c),{concurrency:i});console.log(JSON.stringify(d,null,2)),d.some(r=>r.status==="error")&&(process.exitCode=1)}},{name:"health",description:"Run project health checks on the current directory",usage:"kb health [path]",run:async e=>{const s=e.shift(),t=k(s);console.log(`Project Health: ${t.path}`),console.log("\u2500".repeat(50));for(const n of t.checks){const o=n.status==="pass"?"+":n.status==="warn"?"~":"X";console.log(`  [${o}] ${n.name}: ${n.message}`)}console.log("\u2500".repeat(50)),console.log(`Score: ${t.score}% \u2014 ${t.summary}`)}},{name:"replay",description:"Show recent tool invocation audit trail",usage:"kb replay [--last N] [--tool <name>] [--source mcp|cli]",run:async e=>{const s=Number.parseInt(e[e.indexOf("--last")+1],10)||20,t=e.includes("--tool")?e[e.indexOf("--tool")+1]:void 0,n=e.includes("--source")?e[e.indexOf("--source")+1]:void 0,o=$({last:s,tool:t,source:n});if(o.length===0){console.log("No replay entries. Activity is logged when tools are invoked.");return}console.log(`Replay Log (${o.length} entries)
+`);for(const i of o){const l=i.ts.split("T")[1]?.split(".")[0]??i.ts,c=i.status==="ok"?"\u2713":"\u2717";console.log(`${l} ${c} ${i.tool} (${i.durationMs}ms) [${i.source}]`),console.log(`  in:  ${i.input}`),console.log(`  out: ${i.output}`)}b()}},{name:"replay-clear",description:"Clear the replay audit trail",run:async()=>{w(),console.log("Replay log cleared.")}},{name:"tui",description:"Launch interactive terminal dashboard (human monitoring)",run:async()=>{try{const{launch:e}=await import("../../../tui/dist/index.js"),{store:s,embedder:t,config:n}=await p();e({store:s,embedder:t,config:n})}catch(e){throw e.code==="ERR_MODULE_NOT_FOUND"&&(console.error(`TUI requires ink and react. Install them with:
+  pnpm add -D ink react @types/react`),process.exit(1)),e}}}];export{E as systemCommands};

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

@@ -1,388 +1,2 @@
-import {
-  addToWorkset,
-  deleteWorkset,
-  getWorkset,
-  laneCreate,
-  laneDiff,
-  laneDiscard,
-  laneList,
-  laneMerge,
-  laneStatus,
-  listWorksets,
-  queueClear,
-  queueCreate,
-  queueDelete,
-  queueDone,
-  queueFail,
-  queueGet,
-  queueList,
-  queueNext,
-  queuePush,
-  removeFromWorkset,
-  saveWorkset,
-  stashClear,
-  stashDelete,
-  stashGet,
-  stashList,
-  stashSet
-} from "@kb/tools";
-import {
-  extractStrFlag,
-  parseMaybeJsonString,
-  printWorkset,
-  readStdin,
-  splitCsv
-} from "../helpers.js";
-const workspaceCommands = [
-  {
-    name: "workset",
-    description: "Manage saved file sets",
-    usage: "kb workset <action> [name] [--files f1,f2] [--description desc]",
-    run: async (args) => {
-      const action = args.shift()?.trim();
-      const files = splitCsv(extractStrFlag(args, "--files", ""));
-      const description = extractStrFlag(args, "--description", "").trim() || void 0;
-      const name = args.shift()?.trim();
-      if (!action) {
-        console.error("Usage: kb workset <action> [name] [--files f1,f2] [--description desc]");
-        console.error("Actions: save, get, list, delete, add, remove");
-        process.exit(1);
-      }
-      switch (action) {
-        case "save": {
-          if (!name || files.length === 0) {
-            console.error("Usage: kb workset save <name> --files f1,f2 [--description desc]");
-            process.exit(1);
-          }
-          const workset = saveWorkset(name, files, { description });
-          console.log(`Saved workset: ${workset.name}`);
-          printWorkset(workset);
-          return;
-        }
-        case "get": {
-          if (!name) {
-            console.error("Usage: kb workset get <name>");
-            process.exit(1);
-          }
-          const workset = getWorkset(name);
-          if (!workset) {
-            console.log(`No workset found: ${name}`);
-            return;
-          }
-          printWorkset(workset);
-          return;
-        }
-        case "list": {
-          const worksets = listWorksets();
-          if (worksets.length === 0) {
-            console.log("No worksets saved.");
-            return;
-          }
-          console.log(`Worksets (${worksets.length})`);
-          console.log("\u2500".repeat(60));
-          for (const workset of worksets) {
-            printWorkset(workset);
-            console.log("");
-          }
-          return;
-        }
-        case "delete": {
-          if (!name) {
-            console.error("Usage: kb workset delete <name>");
-            process.exit(1);
-          }
-          const deleted = deleteWorkset(name);
-          console.log(deleted ? `Deleted workset: ${name}` : `No workset found: ${name}`);
-          return;
-        }
-        case "add": {
-          if (!name || files.length === 0) {
-            console.error("Usage: kb workset add <name> --files f1,f2");
-            process.exit(1);
-          }
-          const workset = addToWorkset(name, files);
-          console.log(`Updated workset: ${workset.name}`);
-          printWorkset(workset);
-          return;
-        }
-        case "remove": {
-          if (!name || files.length === 0) {
-            console.error("Usage: kb workset remove <name> --files f1,f2");
-            process.exit(1);
-          }
-          const workset = removeFromWorkset(name, files);
-          if (!workset) {
-            console.log(`No workset found: ${name}`);
-            return;
-          }
-          console.log(`Updated workset: ${workset.name}`);
-          printWorkset(workset);
-          return;
-        }
-        default:
-          console.error(`Unknown workset action: ${action}`);
-          console.error("Actions: save, get, list, delete, add, remove");
-          process.exit(1);
-      }
-    }
-  },
-  {
-    name: "stash",
-    description: "Persist and retrieve named intermediate values",
-    usage: "kb stash <set|get|list|delete|clear> [key] [value]",
-    run: async (args) => {
-      const action = args.shift()?.trim();
-      const key = args.shift()?.trim();
-      if (!action) {
-        console.error("Usage: kb stash <set|get|list|delete|clear> [key] [value]");
-        process.exit(1);
-      }
-      switch (action) {
-        case "set": {
-          if (!key) {
-            console.error("Usage: kb stash set <key> <value>");
-            process.exit(1);
-          }
-          const inlineValue = args.join(" ");
-          const stdinValue = inlineValue.trim() ? "" : await readStdin();
-          const rawValue = inlineValue || stdinValue;
-          const entry = stashSet(key, parseMaybeJsonString(rawValue));
-          console.log(`Stored stash entry: ${entry.key}`);
-          console.log(`  Type: ${entry.type}`);
-          console.log(`  Stored: ${entry.storedAt}`);
-          return;
-        }
-        case "get": {
-          if (!key) {
-            console.error("Usage: kb stash get <key>");
-            process.exit(1);
-          }
-          const entry = stashGet(key);
-          if (!entry) {
-            console.log(`No stash entry found: ${key}`);
-            return;
-          }
-          console.log(JSON.stringify(entry, null, 2));
-          return;
-        }
-        case "list": {
-          const entries = stashList();
-          if (entries.length === 0) {
-            console.log("No stash entries saved.");
-            return;
-          }
-          console.log(`Stash entries (${entries.length})`);
-          console.log("\u2500".repeat(60));
-          for (const entry of entries) {
-            console.log(`${entry.key} (${entry.type})`);
-            console.log(`  Stored: ${entry.storedAt}`);
-          }
-          return;
-        }
-        case "delete": {
-          if (!key) {
-            console.error("Usage: kb stash delete <key>");
-            process.exit(1);
-          }
-          const deleted = stashDelete(key);
-          console.log(deleted ? `Deleted stash entry: ${key}` : `No stash entry found: ${key}`);
-          return;
-        }
-        case "clear": {
-          const count = stashClear();
-          console.log(`Cleared ${count} stash entr${count === 1 ? "y" : "ies"}.`);
-          return;
-        }
-        default:
-          console.error(`Unknown stash action: ${action}`);
-          console.error("Actions: set, get, list, delete, clear");
-          process.exit(1);
-      }
-    }
-  },
-  {
-    name: "lane",
-    description: "Manage verified lanes \u2014 isolated file copies for parallel exploration",
-    usage: "kb lane <create|list|status|diff|merge|discard> [name] [--files f1,f2]",
-    run: async (args) => {
-      const action = args.shift();
-      if (!action || !["create", "list", "status", "diff", "merge", "discard"].includes(action)) {
-        console.error(
-          "Usage: kb lane <create|list|status|diff|merge|discard> [name] [--files f1,f2]"
-        );
-        process.exit(1);
-      }
-      if (action === "list") {
-        const lanes = laneList();
-        if (lanes.length === 0) {
-          console.log("No active lanes.");
-          return;
-        }
-        for (const lane of lanes) {
-          console.log(
-            `${lane.name}  (${lane.sourceFiles.length} files, created ${lane.createdAt})`
-          );
-        }
-        return;
-      }
-      const name = args.shift();
-      if (!name) {
-        console.error(`Lane name is required for "${action}".`);
-        process.exit(1);
-      }
-      switch (action) {
-        case "create": {
-          const filesStr = extractStrFlag(args, "--files", "");
-          if (!filesStr) {
-            console.error("Usage: kb lane create <name> --files file1.ts,file2.ts");
-            process.exit(1);
-          }
-          const files = filesStr.split(",").map((f) => f.trim());
-          const meta = laneCreate(name, files);
-          console.log(`Lane "${meta.name}" created with ${meta.sourceFiles.length} files.`);
-          break;
-        }
-        case "status": {
-          const result = laneStatus(name);
-          console.log(`Lane: ${result.name}`);
-          console.log(
-            `Modified: ${result.modified} | Added: ${result.added} | Deleted: ${result.deleted}`
-          );
-          for (const entry of result.entries) {
-            console.log(`  ${entry.status.padEnd(10)} ${entry.file}`);
-          }
-          break;
-        }
-        case "diff": {
-          const result = laneDiff(name);
-          console.log(
-            `Lane: ${result.name} \u2014 ${result.modified} modified, ${result.added} added, ${result.deleted} deleted`
-          );
-          for (const entry of result.entries) {
-            if (entry.diff) {
-              console.log(`
---- ${entry.file} (${entry.status})`);
-              console.log(entry.diff);
-            }
-          }
-          break;
-        }
-        case "merge": {
-          const result = laneMerge(name);
-          console.log(`Merged ${result.filesMerged} files from lane "${result.name}".`);
-          for (const f of result.files) console.log(`  ${f}`);
-          break;
-        }
-        case "discard": {
-          const ok = laneDiscard(name);
-          console.log(ok ? `Lane "${name}" discarded.` : `Lane "${name}" not found.`);
-          break;
-        }
-      }
-    }
-  },
-  {
-    name: "queue",
-    description: "Manage task queues for sequential agent operations",
-    usage: "kb queue <create|push|next|done|fail|get|list|clear|delete> [name] [args]",
-    run: async (args) => {
-      const action = args.shift();
-      if (!action || !["create", "push", "next", "done", "fail", "get", "list", "clear", "delete"].includes(
-        action
-      )) {
-        console.error(
-          "Usage: kb queue <create|push|next|done|fail|get|list|clear|delete> [name] [args]"
-        );
-        process.exit(1);
-      }
-      if (action === "list") {
-        const queues = queueList();
-        if (queues.length === 0) {
-          console.log("No queues.");
-          return;
-        }
-        for (const q of queues) {
-          console.log(
-            `${q.name}  pending:${q.pending} done:${q.done} failed:${q.failed} total:${q.total}`
-          );
-        }
-        return;
-      }
-      const name = args.shift();
-      if (!name) {
-        console.error(`Queue name is required for "${action}".`);
-        process.exit(1);
-      }
-      switch (action) {
-        case "create": {
-          const q = queueCreate(name);
-          console.log(`Queue "${q.name}" created.`);
-          break;
-        }
-        case "push": {
-          const title = args.join(" ") || "Untitled task";
-          const item = queuePush(name, title);
-          console.log(`Pushed "${item.title}" (${item.id}) to queue "${name}".`);
-          break;
-        }
-        case "next": {
-          const item = queueNext(name);
-          if (!item) {
-            console.log(`No pending items in queue "${name}".`);
-          } else {
-            console.log(`Next: ${item.title} (${item.id})`);
-          }
-          break;
-        }
-        case "done": {
-          const id = args.shift();
-          if (!id) {
-            console.error("Usage: kb queue done <name> <id>");
-            process.exit(1);
-          }
-          const item = queueDone(name, id);
-          console.log(`Marked "${item.title}" as done.`);
-          break;
-        }
-        case "fail": {
-          const id = args.shift();
-          const error = args.join(" ") || "Unknown error";
-          if (!id) {
-            console.error("Usage: kb queue fail <name> <id> [error message]");
-            process.exit(1);
-          }
-          const item = queueFail(name, id, error);
-          console.log(`Marked "${item.title}" as failed: ${error}`);
-          break;
-        }
-        case "get": {
-          const q = queueGet(name);
-          if (!q) {
-            console.log(`Queue "${name}" not found.`);
-            return;
-          }
-          console.log(`Queue: ${q.name} (${q.items.length} items)`);
-          for (const item of q.items) {
-            const extra = item.error ? ` \u2014 ${item.error}` : "";
-            console.log(`  ${item.status.padEnd(12)} ${item.id}  ${item.title}${extra}`);
-          }
-          break;
-        }
-        case "clear": {
-          const removed = queueClear(name);
-          console.log(`Cleared ${removed} completed/failed items from queue "${name}".`);
-          break;
-        }
-        case "delete": {
-          const ok = queueDelete(name);
-          console.log(ok ? `Queue "${name}" deleted.` : `Queue "${name}" not found.`);
-          break;
-        }
-      }
-    }
-  }
-];
-export {
-  workspaceCommands
-};
-//# sourceMappingURL=workspace.js.map
+import{addToWorkset as c,deleteWorkset as d,getWorkset as f,laneCreate as u,laneDiff as g,laneDiscard as m,laneList as k,laneMerge as $,laneStatus as p,listWorksets as h,queueClear as w,queueCreate as b,queueDelete as x,queueDone as y,queueFail as q,queueGet as v,queueList as U,queueNext as N,queuePush as S,removeFromWorkset as C,saveWorkset as M,stashClear as L,stashDelete as D,stashGet as W,stashList as A,stashSet as Q}from"../../../tools/dist/index.js";import{extractStrFlag as i,parseMaybeJsonString as F,printWorkset as a,readStdin as j,splitCsv as V}from"../helpers.js";const G=[{name:"workset",description:"Manage saved file sets",usage:"kb workset <action> [name] [--files f1,f2] [--description desc]",run:async n=>{const r=n.shift()?.trim(),s=V(i(n,"--files","")),e=i(n,"--description","").trim()||void 0,o=n.shift()?.trim();switch(r||(console.error("Usage: kb workset <action> [name] [--files f1,f2] [--description desc]"),console.error("Actions: save, get, list, delete, add, remove"),process.exit(1)),r){case"save":{(!o||s.length===0)&&(console.error("Usage: kb workset save <name> --files f1,f2 [--description desc]"),process.exit(1));const t=M(o,s,{description:e});console.log(`Saved workset: ${t.name}`),a(t);return}case"get":{o||(console.error("Usage: kb workset get <name>"),process.exit(1));const t=f(o);if(!t){console.log(`No workset found: ${o}`);return}a(t);return}case"list":{const t=h();if(t.length===0){console.log("No worksets saved.");return}console.log(`Worksets (${t.length})`),console.log("\u2500".repeat(60));for(const l of t)a(l),console.log("");return}case"delete":{o||(console.error("Usage: kb workset delete <name>"),process.exit(1));const t=d(o);console.log(t?`Deleted workset: ${o}`:`No workset found: ${o}`);return}case"add":{(!o||s.length===0)&&(console.error("Usage: kb workset add <name> --files f1,f2"),process.exit(1));const t=c(o,s);console.log(`Updated workset: ${t.name}`),a(t);return}case"remove":{(!o||s.length===0)&&(console.error("Usage: kb workset remove <name> --files f1,f2"),process.exit(1));const t=C(o,s);if(!t){console.log(`No workset found: ${o}`);return}console.log(`Updated workset: ${t.name}`),a(t);return}default:console.error(`Unknown workset action: ${r}`),console.error("Actions: save, get, list, delete, add, remove"),process.exit(1)}}},{name:"stash",description:"Persist and retrieve named intermediate values",usage:"kb stash <set|get|list|delete|clear> [key] [value]",run:async n=>{const r=n.shift()?.trim(),s=n.shift()?.trim();switch(r||(console.error("Usage: kb stash <set|get|list|delete|clear> [key] [value]"),process.exit(1)),r){case"set":{s||(console.error("Usage: kb stash set <key> <value>"),process.exit(1));const e=n.join(" "),o=e.trim()?"":await j(),l=Q(s,F(e||o));console.log(`Stored stash entry: ${l.key}`),console.log(`  Type: ${l.type}`),console.log(`  Stored: ${l.storedAt}`);return}case"get":{s||(console.error("Usage: kb stash get <key>"),process.exit(1));const e=W(s);if(!e){console.log(`No stash entry found: ${s}`);return}console.log(JSON.stringify(e,null,2));return}case"list":{const e=A();if(e.length===0){console.log("No stash entries saved.");return}console.log(`Stash entries (${e.length})`),console.log("\u2500".repeat(60));for(const o of e)console.log(`${o.key} (${o.type})`),console.log(`  Stored: ${o.storedAt}`);return}case"delete":{s||(console.error("Usage: kb stash delete <key>"),process.exit(1));const e=D(s);console.log(e?`Deleted stash entry: ${s}`:`No stash entry found: ${s}`);return}case"clear":{const e=L();console.log(`Cleared ${e} stash entr${e===1?"y":"ies"}.`);return}default:console.error(`Unknown stash action: ${r}`),console.error("Actions: set, get, list, delete, clear"),process.exit(1)}}},{name:"lane",description:"Manage verified lanes \u2014 isolated file copies for parallel exploration",usage:"kb lane <create|list|status|diff|merge|discard> [name] [--files f1,f2]",run:async n=>{const r=n.shift();if((!r||!["create","list","status","diff","merge","discard"].includes(r))&&(console.error("Usage: kb lane <create|list|status|diff|merge|discard> [name] [--files f1,f2]"),process.exit(1)),r==="list"){const e=k();if(e.length===0){console.log("No active lanes.");return}for(const o of e)console.log(`${o.name}  (${o.sourceFiles.length} files, created ${o.createdAt})`);return}const s=n.shift();switch(s||(console.error(`Lane name is required for "${r}".`),process.exit(1)),r){case"create":{const e=i(n,"--files","");e||(console.error("Usage: kb lane create <name> --files file1.ts,file2.ts"),process.exit(1));const o=e.split(",").map(l=>l.trim()),t=u(s,o);console.log(`Lane "${t.name}" created with ${t.sourceFiles.length} files.`);break}case"status":{const e=p(s);console.log(`Lane: ${e.name}`),console.log(`Modified: ${e.modified} | Added: ${e.added} | Deleted: ${e.deleted}`);for(const o of e.entries)console.log(`  ${o.status.padEnd(10)} ${o.file}`);break}case"diff":{const e=g(s);console.log(`Lane: ${e.name} \u2014 ${e.modified} modified, ${e.added} added, ${e.deleted} deleted`);for(const o of e.entries)o.diff&&(console.log(`
+--- ${o.file} (${o.status})`),console.log(o.diff));break}case"merge":{const e=$(s);console.log(`Merged ${e.filesMerged} files from lane "${e.name}".`);for(const o of e.files)console.log(`  ${o}`);break}case"discard":{const e=m(s);console.log(e?`Lane "${s}" discarded.`:`Lane "${s}" not found.`);break}}}},{name:"queue",description:"Manage task queues for sequential agent operations",usage:"kb queue <create|push|next|done|fail|get|list|clear|delete> [name] [args]",run:async n=>{const r=n.shift();if((!r||!["create","push","next","done","fail","get","list","clear","delete"].includes(r))&&(console.error("Usage: kb queue <create|push|next|done|fail|get|list|clear|delete> [name] [args]"),process.exit(1)),r==="list"){const e=U();if(e.length===0){console.log("No queues.");return}for(const o of e)console.log(`${o.name}  pending:${o.pending} done:${o.done} failed:${o.failed} total:${o.total}`);return}const s=n.shift();switch(s||(console.error(`Queue name is required for "${r}".`),process.exit(1)),r){case"create":{const e=b(s);console.log(`Queue "${e.name}" created.`);break}case"push":{const e=n.join(" ")||"Untitled task",o=S(s,e);console.log(`Pushed "${o.title}" (${o.id}) to queue "${s}".`);break}case"next":{const e=N(s);console.log(e?`Next: ${e.title} (${e.id})`:`No pending items in queue "${s}".`);break}case"done":{const e=n.shift();e||(console.error("Usage: kb queue done <name> <id>"),process.exit(1));const o=y(s,e);console.log(`Marked "${o.title}" as done.`);break}case"fail":{const e=n.shift(),o=n.join(" ")||"Unknown error";e||(console.error("Usage: kb queue fail <name> <id> [error message]"),process.exit(1));const t=q(s,e,o);console.log(`Marked "${t.title}" as failed: ${o}`);break}case"get":{const e=v(s);if(!e){console.log(`Queue "${s}" not found.`);return}console.log(`Queue: ${e.name} (${e.items.length} items)`);for(const o of e.items){const t=o.error?` \u2014 ${o.error}`:"";console.log(`  ${o.status.padEnd(12)} ${o.id}  ${o.title}${t}`)}break}case"clear":{const e=w(s);console.log(`Cleared ${e} completed/failed items from queue "${s}".`);break}case"delete":{const e=x(s);console.log(e?`Queue "${s}" deleted.`:`Queue "${s}" not found.`);break}}}}];export{G as workspaceCommands};

package/packages/cli/dist/context.js

@@ -1,14 +1 @@
-import { initKB } from "./kb-init.js";
-let _ctx = null;
-async function ctx() {
-  if (!_ctx) _ctx = await initKB();
-  return _ctx;
-}
-function getCtx() {
-  return _ctx;
-}
-export {
-  ctx,
-  getCtx
-};
-//# sourceMappingURL=context.js.map
+import{initKB as n}from"./kb-init.js";let t=null;async function o(){return t||(t=await n()),t}function r(){return t}export{o as ctx,r as getCtx};