@kaddo/cli 3.68.0 → 3.69.0

package/dist/index.js

@@ -1361,8 +1361,8 @@ function loadConfig(dir) {
   const parsed = configSchema.safeParse(raw ?? {});
   if (!parsed.success) {
     const issues = parsed.error.issues.map((i) => {
-      const path8 = i.path.join(".");
-      return path8 ? `  - ${path8}: ${i.message}` : `  - ${i.message}`;
+      const path9 = i.path.join(".");
+      return path9 ? `  - ${path9}: ${i.message}` : `  - ${i.message}`;
     }).join("\n");
     throw new ConfigError(`Invalid .kaddo/config.yml:
 ${issues}`);
@@ -6732,10 +6732,10 @@ function analyzeGuard(touchedFiles, artifacts, silentWithoutOwnership) {
 import { parse as parseYaml4, stringify as stringifyYaml2 } from "yaml";
 var IGNORE_FILE = ".kaddo/ignores.yml";
 function loadIgnores(dir) {
-  const path8 = join(dir, IGNORE_FILE);
-  if (!exists(path8)) return [];
+  const path9 = join(dir, IGNORE_FILE);
+  if (!exists(path9)) return [];
   try {
-    const raw = readFile(path8);
+    const raw = readFile(path9);
     const parsed = parseYaml4(raw);
     return Array.isArray(parsed) ? parsed : [];
   } catch {
@@ -6743,7 +6743,7 @@ function loadIgnores(dir) {
   }
 }
 function saveIgnore(dir, entry) {
-  const path8 = join(dir, IGNORE_FILE);
+  const path9 = join(dir, IGNORE_FILE);
   const existing = loadIgnores(dir);
   const idx = existing.findIndex((e) => e.artifact_id === entry.artifact_id);
   if (idx >= 0) {
@@ -6751,17 +6751,17 @@ function saveIgnore(dir, entry) {
   } else {
     existing.push(entry);
   }
-  writeFile(path8, stringifyYaml2(existing));
+  writeFile(path9, stringifyYaml2(existing));
 }
 function isIgnored(ignores, artifactId) {
   return ignores.find((e) => e.artifact_id === artifactId);
 }
 function removeIgnore(dir, artifactId) {
-  const path8 = join(dir, IGNORE_FILE);
+  const path9 = join(dir, IGNORE_FILE);
   const existing = loadIgnores(dir);
   const filtered = existing.filter((e) => e.artifact_id !== artifactId);
   if (filtered.length === existing.length) return false;
-  writeFile(path8, stringifyYaml2(filtered));
+  writeFile(path9, stringifyYaml2(filtered));
   return true;
 }
 
@@ -6783,11 +6783,11 @@ function moduleArtifactCoverage(dir, id) {
   };
 }
 function loadMappedModules(dir) {
-  const path8 = join(dir, DESCRIPTOR_PATH);
-  if (!exists(path8)) return [];
+  const path9 = join(dir, DESCRIPTOR_PATH);
+  if (!exists(path9)) return [];
   let parsed;
   try {
-    parsed = parseYaml5(readFile(path8));
+    parsed = parseYaml5(readFile(path9));
   } catch {
     return [];
   }
@@ -7531,7 +7531,7 @@ function buildGuardHistory(dir) {
     const d = hotspotDir(t.code_path);
     hotspotMap.set(d, (hotspotMap.get(d) ?? 0) + 1);
   }
-  const hotspots = [...hotspotMap.entries()].map(([path8, warnings]) => ({ path: path8, warnings })).sort((a, b) => b.warnings - a.warnings);
+  const hotspots = [...hotspotMap.entries()].map(([path9, warnings]) => ({ path: path9, warnings })).sort((a, b) => b.warnings - a.warnings);
   return {
     available: true,
     total_runs: sorted.length,
@@ -10102,10 +10102,10 @@ function slugify2(name) {
   return name.trim().toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-+|-+$/g, "");
 }
 function readModulesDescriptor(dir) {
-  const path8 = join(dir, DESCRIPTOR_PATH2);
-  if (!exists(path8)) return { version: 1, modules: [] };
+  const path9 = join(dir, DESCRIPTOR_PATH2);
+  if (!exists(path9)) return { version: 1, modules: [] };
   try {
-    const parsed = parseYaml9(readFile(path8));
+    const parsed = parseYaml9(readFile(path9));
     return { version: parsed.version ?? 1, modules: parsed.modules ?? [] };
   } catch {
     return { version: 1, modules: [] };
@@ -10485,7 +10485,7 @@ function sectionParagraph(md, title) {
   }
   return "";
 }
-function parseCapsule(id, path8, md) {
+function parseCapsule(id, path9, md) {
   const { data } = matter3(md);
   const updatedAt = data.updated_at ? String(data.updated_at) : void 0;
   let ageDays = null;
@@ -10495,7 +10495,7 @@ function parseCapsule(id, path8, md) {
   }
   return {
     id,
-    path: path8,
+    path: path9,
     system: data.system ? String(data.system) : id,
     owner: data.owner ? String(data.owner) : void 0,
     updatedAt,
@@ -10581,9 +10581,9 @@ function buildGraph(dir, config, opts = {}, now = /* @__PURE__ */ new Date()) {
   ];
   const presentLayers = [];
   for (const layer2 of layerDocs) {
-    const path8 = layer2.files.map((f) => `${KNOWLEDGE3}/${f}`).find((rel) => exists(join(dir, rel)));
-    if (path8) {
-      addNode({ id: layer2.id, type: layer2.type, label: layer2.label, path: path8 });
+    const path9 = layer2.files.map((f) => `${KNOWLEDGE3}/${f}`).find((rel) => exists(join(dir, rel)));
+    if (path9) {
+      addNode({ id: layer2.id, type: layer2.type, label: layer2.label, path: path9 });
       presentLayers.push(layer2.id);
     }
   }
@@ -12119,10 +12119,10 @@ function resolveNextStep(dir, now = /* @__PURE__ */ new Date()) {
   const q = (rel) => analyzeKnowledgeArtifact(dir, rel);
   const resolveAgent = (agent) => {
     const file = agent.endsWith(".md") ? agent : `${agent}.md`;
-    const path8 = agentInstallPath(file);
-    const installed = isFile(join(dir, path8));
+    const path9 = agentInstallPath(file);
+    const installed = isFile(join(dir, path9));
     const group = agentGroupOf(file);
-    return { agentPath: path8, agentInstalled: installed, installCommand: installed ? void 0 : `kaddo add agents --group ${group}` };
+    return { agentPath: path9, agentInstalled: installed, installCommand: installed ? void 0 : `kaddo add agents --group ${group}` };
   };
   const moduleRepo = isModule(config);
   const coreRepo = isCore(config);
@@ -18492,6 +18492,110 @@ async function runReady(id, opts = {}) {
   outro2(`Work Item ${wi.id} is ready.`);
 }
 
+// src/commands/admin.ts
+import path8 from "path";
+import { fileURLToPath as fileURLToPath2 } from "url";
+import net from "net";
+function isPortAvailable(port, host) {
+  return new Promise((resolve) => {
+    const server = net.createServer();
+    server.once("error", () => resolve(false));
+    server.once("listening", () => {
+      server.close();
+      resolve(true);
+    });
+    server.listen(port, host);
+  });
+}
+function resolveStaticDir() {
+  const __dirname = path8.dirname(fileURLToPath2(import.meta.url));
+  const candidates = [
+    path8.resolve(__dirname, "..", "..", "admin", "dist"),
+    path8.resolve(__dirname, "..", "node_modules", "@kaddo", "admin", "dist")
+  ];
+  for (const c of candidates) {
+    if (exists(join(c, "index.html"))) return c;
+  }
+  return null;
+}
+async function runAdmin(opts = {}) {
+  const dir = cwd();
+  const port = opts.port ?? 4173;
+  const host = opts.host ?? "127.0.0.1";
+  const config = loadConfig(dir);
+  if (!config) {
+    console.log("");
+    console.log("Kaddo Admin could not start.");
+    console.log("");
+    console.log("No Kaddo project was detected in the current directory.");
+    console.log("");
+    console.log("Run:");
+    console.log("  kaddo init");
+    console.log("");
+    console.log("or execute this command from a Kaddo project.");
+    console.log("");
+    process.exit(1);
+  }
+  const available = await isPortAvailable(port, host);
+  if (!available) {
+    console.log("");
+    console.log(`Port ${port} is already in use.`);
+    console.log("");
+    console.log("Use:");
+    console.log(`  kaddo admin --port <port>`);
+    console.log("");
+    process.exit(1);
+  }
+  const staticDir = resolveStaticDir();
+  if (!staticDir) {
+    console.error("Admin frontend not built. Run `pnpm -r build` first.");
+    process.exit(1);
+  }
+  const { createAdminServer, SQLiteAdminStorage } = await import("@kaddo/admin-server");
+  const dbDir = join(dir, ".kaddo", "admin");
+  ensureDir(dbDir);
+  const dbPath = join(dbDir, "admin.db");
+  const storage = new SQLiteAdminStorage(dbPath);
+  await storage.initialize();
+  const server = await createAdminServer({
+    projectDir: dir,
+    storage,
+    staticDir,
+    host,
+    port
+  });
+  const address = await server.start();
+  console.log("");
+  console.log("Kaddo Admin");
+  console.log("");
+  console.log(`Project: ${config.project.name}`);
+  console.log(`Mode: local`);
+  console.log(`Address: ${address}`);
+  console.log("");
+  console.log(`Session: active`);
+  console.log(`Storage: SQLite`);
+  console.log(`Project source: Kaddo Core`);
+  console.log("");
+  console.log("Press Ctrl+C to stop.");
+  console.log("");
+  if (!opts.noOpen) {
+    try {
+      const { default: open } = await import("open");
+      await open(address);
+    } catch {
+    }
+  }
+  const shutdown = async () => {
+    console.log("");
+    console.log("Shutting down...");
+    await server.stop();
+    console.log("Kaddo Admin stopped.");
+    process.exit(0);
+  };
+  process.on("SIGINT", shutdown);
+  process.on("SIGTERM", shutdown);
+}
+
 // src/index.ts
 var require2 = createRequire(import.meta.url);
 var { version } = require2("../package.json");
@@ -18516,8 +18620,8 @@ var capsuleCmd = program.command("capsule").description("Export this project as
 capsuleCmd.command("export").description("Write a Knowledge Capsule about this project to .kaddo/exports/").option("--scope <scope>", 'Export scope: "system" includes all mapped modules').option("--module <id>", "Export a capsule for a specific mapped module").action((opts) => {
   runCapsuleExport(opts);
 });
-capsuleCmd.command("add <path>").description("Register an external Knowledge Capsule as project context (.kaddo/external.yml)").action((path8) => {
-  runCapsuleAdd(path8);
+capsuleCmd.command("add <path>").description("Register an external Knowledge Capsule as project context (.kaddo/external.yml)").action((path9) => {
+  runCapsuleAdd(path9);
 });
 var graphCmd = program.command("graph").description("Export the lightweight, file-based knowledge graph of the project");
 graphCmd.command("export").description("Write the knowledge graph to .kaddo/graph.json and .kaddo/graph.mmd").option("--scope <scope>", "Graph scope: active (default) or all").option("--format <format>", "Output format: json, mermaid (default: both)").action((opts) => {
@@ -18635,6 +18739,9 @@ modulesCmd.command("validate").description("Validate registered modules against
 program.command("add [module]").description("Install an optional Kaddo module (adr, incident, rfc, migration, legacy, agents, skills, standards, security, stack, git-strategy)").option("--all", "For `add agents` / `add skills`: install every item (not just the recommended set)").option("--group <name>", "For `add agents`: business|product|tech|delivery|utilities. For `add skills`: delivery|tech|integration").action((moduleName, opts) => {
   runAdd(moduleName ?? "", { all: opts.all, group: opts.group });
 });
+program.command("admin").description("Start Kaddo Admin \u2014 a local web interface for the project knowledge").option("--port <port>", "Server port (default: 4173)", parseInt).option("--host <host>", "Server host (default: 127.0.0.1)").option("--no-open", "Do not open the browser automatically").action(async (opts) => {
+  await runAdmin({ port: opts.port, host: opts.host, noOpen: opts.open === false });
+});
 program.parseAsync(process.argv).catch((err) => {
   console.error(err);
   process.exit(1);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kaddo/cli",
-  "version": "3.68.0",
+  "version": "3.69.0",
   "description": "Knowledge Driven Development toolkit",
   "license": "MIT",
   "repository": {
@@ -20,6 +20,10 @@
   ],
   "type": "module",
   "main": "./dist/index.js",
+  "exports": {
+    ".": "./dist/index.js",
+    "./core": "./dist/core.js"
+  },
   "bin": {
     "kaddo": "./dist/index.js"
   },
@@ -45,7 +49,8 @@
     "gray-matter": "^4.0.3",
     "minimatch": "^10.2.5",
     "yaml": "^2.4.2",
-    "zod": "^3.23.8"
+    "zod": "^3.23.8",
+    "open": "^10.1.0"
   },
   "devDependencies": {
     "@types/node": "^20.14.0",