kontex-cli 1.0.0

package/dist/index.js

@@ -0,0 +1,330 @@
+#!/usr/bin/env bun
+// @bun
+var __require = import.meta.require;
+
+// src/index.ts
+import { Command } from "commander";
+
+// src/commands/login.ts
+import { login } from "kontex-core";
+function registerLoginCommand(program) {
+  program.command("login").description("Authenticate with GitHub using OAuth Device Flow").action(async () => {
+    try {
+      await login();
+    } catch (e) {
+      console.error("Login failed:", e instanceof Error ? e.message : e);
+      process.exit(1);
+    }
+  });
+}
+
+// src/commands/logout.ts
+import { logout } from "kontex-core";
+function registerLogoutCommand(program) {
+  program.command("logout").description("Remove GitHub OAuth token from the OS keychain").action(async () => {
+    try {
+      await logout();
+    } catch (e) {
+      console.error("Logout failed:", e instanceof Error ? e.message : e);
+      process.exit(1);
+    }
+  });
+}
+
+// src/commands/init.ts
+import { initProject } from "kontex-core";
+function registerInitCommand(program) {
+  program.command("init").description("Initialize kontex in the current project").option("--ai", "Run LLM extraction pass").option("--no-hooks", "Skip git hook installation").option("--force", "Re-run init even if .context/ exists").action(async (opts) => {
+    try {
+      await initProject(process.cwd(), { ai: opts.ai, noHooks: opts.noHooks, force: opts.force });
+    } catch (e) {
+      console.error("Init failed:", e instanceof Error ? e.message : e);
+      process.exit(1);
+    }
+  });
+}
+
+// src/commands/compile.ts
+import { compile, loadConfig } from "kontex-core";
+function registerCompileCommand(program) {
+  program.command("compile").description("Regenerate .context/KONTEX.md").option("--budget <tokens>", "Override token budget", parseInt).action(async (opts) => {
+    try {
+      const config = loadConfig(process.cwd());
+      if (opts.budget)
+        config.compile.tokenBudget = opts.budget;
+      await compile(process.cwd(), config);
+      console.log("\u2713 KONTEX.md compiled");
+    } catch (e) {
+      console.error("Compile failed:", e instanceof Error ? e.message : e);
+      process.exit(1);
+    }
+  });
+}
+
+// src/commands/find.ts
+import { findMemories } from "kontex-core";
+function registerFindCommand(program) {
+  program.command("find <query>").description("Semantic search across memory").option("--limit <n>", "Number of results", parseInt, 5).action(async (query, opts) => {
+    try {
+      const results = await findMemories(query, opts.limit, process.cwd());
+      if (results.length === 0) {
+        console.log("No matching memories found.");
+        return;
+      }
+      console.log(`
+Found ${results.length} result(s):
+`);
+      for (const [i, r] of results.entries()) {
+        console.log(`${i + 1}. ${r.verified ? "\u2713" : "\u25CB"} ${r.uri} (${r.type}, similarity: ${r.similarity.toFixed(2)})`);
+        console.log(`   ${r.content.slice(0, 150).replace(/\n/g, " ")}
+`);
+      }
+    } catch (e) {
+      console.error("Search failed:", e instanceof Error ? e.message : e);
+      process.exit(1);
+    }
+  });
+}
+
+// src/commands/status.ts
+import { loadConfig as loadConfig2, loadAllEntries, isAuthenticated } from "kontex-core";
+import { existsSync, statSync } from "fs";
+import { join } from "path";
+function registerStatusCommand(program) {
+  program.command("status").description("Show memory store health").action(async () => {
+    try {
+      const cwd = process.cwd();
+      const config = loadConfig2(cwd);
+      const entries = loadAllEntries(cwd);
+      console.log(`Auth: ${await isAuthenticated() ? "authenticated" : "not authenticated \u2014 run `kontex login`"}`);
+      const verified = entries.filter((e) => e.verified);
+      console.log(`Memory entries: ${entries.length} (${verified.length} verified, ${entries.length - verified.length} unverified)`);
+      const types = new Map;
+      for (const e of entries)
+        types.set(e.type, (types.get(e.type) ?? 0) + 1);
+      if (types.size)
+        console.log(`Types: ${[...types.entries()].map(([t, c]) => `${t}: ${c}`).join(" | ")}`);
+      const customMd = join(cwd, ".context", "KONTEX.md");
+      if (existsSync(customMd)) {
+        const s = statSync(customMd);
+        console.log(`KONTEX.md: compiled ${timeSince(s.mtime)}`);
+      } else
+        console.log("KONTEX.md: not found \u2014 run `kontex compile`");
+      console.log(`LLM: ${config.llm.provider} / ${config.llm.model}`);
+      const stale = entries.filter((e) => e.stale);
+      if (stale.length > 0)
+        console.log(`
+\u26A0 ${stale.length} stale entries \u2014 run \`kontex audit\``);
+    } catch (e) {
+      console.error("Status failed:", e instanceof Error ? e.message : e);
+      process.exit(1);
+    }
+  });
+}
+function timeSince(date) {
+  const s = Math.floor((Date.now() - date.getTime()) / 1000);
+  if (s < 60)
+    return `${s}s ago`;
+  const m = Math.floor(s / 60);
+  if (m < 60)
+    return `${m}m ago`;
+  const h = Math.floor(m / 60);
+  if (h < 24)
+    return `${h}h ago`;
+  return `${Math.floor(h / 24)}d ago`;
+}
+
+// src/commands/audit.ts
+import { loadAllEntries as loadAllEntries2 } from "kontex-core";
+import { readFileSync, unlinkSync } from "fs";
+import { join as join2 } from "path";
+import readline from "readline";
+function registerAuditCommand(program) {
+  program.command("audit").description("Interactive review of stale and unverified entries").action(async () => {
+    try {
+      const cwd = process.cwd();
+      const entries = loadAllEntries2(cwd);
+      const stale = entries.filter((e) => e.stale);
+      const unverified = entries.filter((e) => !e.verified && !e.stale);
+      if (stale.length === 0 && unverified.length === 0) {
+        console.log("\u2713 Memory store is healthy.");
+        return;
+      }
+      console.log(`
+kontex audit
+`);
+      if (stale.length > 0)
+        console.log(`\u26A0  ${stale.length} stale entries`);
+      if (unverified.length > 0)
+        console.log(`\u25CB  ${unverified.length} unverified entries`);
+      console.log(`
+---
+`);
+      const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
+      const ask = (q) => new Promise((r) => rl.question(q, r));
+      for (const entry of stale) {
+        console.log(`
+\u26A0 STALE: ${entry.uri} (${entry.type})`);
+        console.log(`  ${entry.l0 || entry.content.slice(0, 100)}`);
+        const action = await ask("  [d]elete  [k]eep  [v]iew  > ");
+        if (action === "d") {
+          if (await ask("  Confirm? (y/n) > ") === "y") {
+            try {
+              unlinkSync(join2(cwd, ".context", `${entry.uri}.md`));
+              console.log("  \u2713 Deleted");
+            } catch {
+              console.log("  \u2717 Not found");
+            }
+          }
+        } else if (action === "v") {
+          try {
+            console.log(`
+` + readFileSync(join2(cwd, ".context", `${entry.uri}.md`), "utf-8"));
+          } catch {
+            console.log("  \u2717 Not found");
+          }
+        }
+      }
+      for (const entry of unverified) {
+        console.log(`
+\u25CB UNVERIFIED: ${entry.uri} (${entry.type}, refs: ${entry.ref_count})`);
+        console.log(`  ${entry.l0 || entry.content.slice(0, 100)}`);
+        const action = await ask("  [d]elete  [p]romote  [k]eep  > ");
+        if (action === "d") {
+          if (await ask("  Confirm? (y/n) > ") === "y") {
+            try {
+              unlinkSync(join2(cwd, ".context", `${entry.uri}.md`));
+              console.log("  \u2713 Deleted");
+            } catch {
+              console.log("  \u2717 Not found");
+            }
+          }
+        } else if (action === "p") {
+          try {
+            const { default: matter } = await import("gray-matter");
+            const filePath = join2(cwd, ".context", `${entry.uri}.md`);
+            const parsed = matter(readFileSync(filePath, "utf-8"));
+            parsed.data.verified = true;
+            parsed.data.updated = new Date().toISOString();
+            const { writeFileSync } = await import("fs");
+            writeFileSync(filePath, matter.stringify(parsed.content, parsed.data), "utf-8");
+            console.log("  \u2713 Promoted");
+          } catch {
+            console.log("  \u2717 Failed");
+          }
+        }
+      }
+      rl.close();
+      console.log(`
+\u2713 Audit complete.
+`);
+    } catch (e) {
+      console.error("Audit failed:", e instanceof Error ? e.message : e);
+      process.exit(1);
+    }
+  });
+}
+
+// src/commands/daemon.ts
+import { runDecay, loadConfig as loadConfig3 } from "kontex-core";
+function registerDaemonCommand(program) {
+  program.command("daemon").argument("[action]", "start | stop | status", "start").description("Background compression daemon").action(async (action) => {
+    const cwd = process.cwd();
+    if (action === "start") {
+      console.log(`Running decay cycle...
+`);
+      const result = await runDecay(cwd, loadConfig3(cwd));
+      console.log(`Promoted: ${result.promoted.length}
+Expired: ${result.expired.length}
+Archived: ${result.archived.length}
+Flagged stale: ${result.flaggedStale.length}`);
+      console.log(`
+\u2713 Decay cycle complete.`);
+    } else if (action === "status") {
+      console.log("Daemon status: manual mode");
+    } else if (action === "stop") {
+      console.log("Daemon stopped.");
+    } else {
+      console.error(`Unknown action: ${action}`);
+      process.exit(1);
+    }
+  });
+}
+
+// src/commands/hooks.ts
+import { HOOK_TEMPLATES } from "kontex-core";
+import { writeFileSync, mkdirSync, existsSync as existsSync2, chmodSync } from "fs";
+import { join as join3 } from "path";
+function registerHooksCommand(program) {
+  program.command("hooks").argument("<action>", "install").description("Manage git hooks").action((action) => {
+    if (action !== "install") {
+      console.error(`Unknown action: ${action}`);
+      process.exit(1);
+    }
+    const cwd = process.cwd();
+    if (!existsSync2(join3(cwd, ".git"))) {
+      console.error("Not a git repository.");
+      process.exit(1);
+    }
+    const hooksDir = join3(cwd, ".git", "hooks");
+    mkdirSync(hooksDir, { recursive: true });
+    for (const [name, content] of Object.entries(HOOK_TEMPLATES)) {
+      const p = join3(hooksDir, name);
+      writeFileSync(p, content + `
+`, "utf-8");
+      chmodSync(p, 493);
+    }
+    console.log("\u2713 Installed git hooks (pre-commit, post-commit, post-merge)");
+  });
+}
+
+// src/commands/mcp.ts
+import { createMCPServer } from "kontex-core";
+function registerMcpCommand(program) {
+  program.command("mcp").description("Start the MCP server (used by AI tools)").action(async () => {
+    try {
+      await createMCPServer(process.env.KONTEX_WORKSPACE || process.cwd());
+    } catch (e) {
+      console.error("MCP server failed:", e instanceof Error ? e.message : e);
+      process.exit(1);
+    }
+  });
+}
+
+// src/commands/hook.ts
+import { handlePreCommit, handlePostCommit } from "kontex-core";
+function registerHookCommand(program) {
+  const hookCmd = program.command("hook").description("Internal: called by git hooks");
+  hookCmd.command("pre-commit").option("--staged <files>", "Staged files").action(async (opts) => {
+    try {
+      await handlePreCommit(opts.staged ?? "", process.cwd());
+    } catch {}
+  });
+  hookCmd.command("post-commit").option("--sha <sha>", "Commit SHA").option("--author <email>", "Author").action(async (opts) => {
+    try {
+      await handlePostCommit(opts.sha ?? "", opts.author ?? "", process.cwd());
+    } catch {}
+  });
+  hookCmd.command("post-merge").action(async () => {
+    try {
+      const { handlePostMerge } = await import("kontex-core");
+      await handlePostMerge(process.cwd());
+    } catch {}
+  });
+}
+
+// src/index.ts
+var program = new Command;
+program.name("kontex").description("Persistent, git-native memory for AI-assisted development").version("1.0.0");
+registerLoginCommand(program);
+registerLogoutCommand(program);
+registerInitCommand(program);
+registerCompileCommand(program);
+registerFindCommand(program);
+registerStatusCommand(program);
+registerAuditCommand(program);
+registerDaemonCommand(program);
+registerHooksCommand(program);
+registerMcpCommand(program);
+registerHookCommand(program);
+program.parse();

package/package.json

@@ -0,0 +1,58 @@
+{
+  "name": "kontex-cli",
+  "version": "1.0.0",
+  "description": "CLI for kontex — thin commander wrapper over kontex-core",
+  "type": "module",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/ArekBee/kontex.git",
+    "directory": "packages/kontex-cli"
+  },
+  "homepage": "https://github.com/ArekBee/kontex#readme",
+  "bugs": {
+    "url": "https://github.com/ArekBee/kontex/issues"
+  },
+  "keywords": [
+    "kontex",
+    "cli",
+    "ai",
+    "memory",
+    "context",
+    "llm",
+    "mcp",
+    "coding-assistant"
+  ],
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "bin": {
+    "kontex": "dist/index.js"
+  },
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "scripts": {
+    "build": "bun build ./src/index.ts --outdir ./dist --target bun --packages external",
+    "test": "bun test",
+    "dev": "bun --watch src/index.ts",
+    "lint": "eslint src/"
+  },
+  "dependencies": {
+    "kontex-core": "workspace:*",
+    "commander": "^13.1.0",
+    "chalk": "^5.4.0"
+  },
+  "devDependencies": {
+    "bun-types": "^1.1.0",
+    "typescript": "^5.7.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}