kontexta 4.3.1

package/bundle/standalone/node_modules/kxta-publish/dist/types.d.ts

@@ -0,0 +1,97 @@
+/** Publish configuration (from docs.config.json ⊕ CLI flags). */
+export interface SourceConfig {
+    /** Vault folders to render; each becomes a top-level sidebar group. */
+    folders: string[];
+    /** Absolute path to the project root, if publishing a project folder. */
+    projectPath?: string;
+}
+export interface SiteConfig {
+    title: string;
+    brand: string;
+    logo?: string;
+    hero: boolean;
+    /** Optional subtitle rendered under the hero title. */
+    tagline?: string;
+}
+export interface PublishConfig {
+    source: SourceConfig;
+    site: SiteConfig;
+    /** Output file path, resolved relative to cwd. */
+    output: string;
+    /** Emit an llms.txt file alongside the HTML. */
+    llmsTxt?: boolean;
+    /** Emit OpenGraph / SEO meta tags in the HTML head. */
+    seo?: boolean;
+    /** CSS theme preset. */
+    theme?: "default" | "minimal" | "api-ref" | "flat" | "terminal" | "paper" | "solarized" | "brutalist" | "ocean";
+}
+/** Frontmatter we read from each doc (all optional). */
+export interface Frontmatter {
+    title?: string;
+    group?: string;
+    order?: number;
+    icon?: string;
+}
+/** One markdown doc pulled from the vault. */
+export interface DocFile {
+    id: number;
+    folder: string;
+    path: string;
+    slug: string;
+    frontmatter: Frontmatter;
+    body: string;
+    title: string;
+}
+export interface TocEntry {
+    level: number;
+    text: string;
+    id: string;
+}
+export interface EndpointData {
+    id: string;
+    method: string;
+    path: string;
+    description?: string;
+    badge?: "direct" | "remove" | "evolve";
+    headers?: Record<string, string>;
+    statusCodes?: Record<string, string>;
+    request?: string;
+    response?: string;
+}
+export interface GlossaryTerm {
+    id?: string;
+    term: string;
+    definition: string;
+}
+export interface RenderedDoc {
+    doc: DocFile;
+    html: string;
+    toc: TocEntry[];
+    endpoints: EndpointData[];
+    terms?: GlossaryTerm[];
+}
+export interface NavItem {
+    title: string;
+    slug: string;
+    folder: string;
+    path?: string;
+    icon?: string;
+}
+export interface NavGroup {
+    group: string;
+    items: NavItem[];
+}
+export type SearchType = "page" | "heading" | "endpoint" | "term";
+export interface SearchEntry {
+    title: string;
+    folder: string;
+    slug: string;
+    type: SearchType;
+    url: string;
+    snippet: string;
+}
+/** markdown-it render env: block rules push collected data here. */
+export interface RenderEnv {
+    endpoints: EndpointData[];
+    terms?: GlossaryTerm[];
+}

package/bundle/standalone/node_modules/kxta-publish/dist/types.js

@@ -0,0 +1 @@
+export {};

package/bundle/standalone/node_modules/kxta-publish/package.json

@@ -0,0 +1,25 @@
+{
+  "name": "kxta-publish",
+  "version": "4.3.1",
+  "private": true,
+  "type": "module",
+  "bin": {
+    "kxta-publish": "dist/index.js"
+  },
+  "main": "dist/index.js",
+  "exports": {
+    "./pipeline": "./dist/pipeline.js",
+    "./render/llms": "./dist/render/llms.js",
+    "./render/pdf": "./dist/render/pdf.js"
+  },
+  "dependencies": {
+    "gray-matter": "^4.0.3",
+    "html-to-pdfmake": "^2.5.33",
+    "js-yaml": "^4.1.0",
+    "jsdom": "^29.1.1",
+    "kxta-core": "4.3.1",
+    "markdown-it": "^14.1.0",
+    "pdfmake": "^0.3.11"
+  },
+  "rulesVersion": "2.3.0"
+}

package/bundle/standalone/package.json

@@ -0,0 +1,26 @@
+{
+  "name": "kontexta",
+  "version": "4.3.1",
+  "rulesVersion": "2.3.0",
+  "type": "module",
+  "author": "Safiyu",
+  "private": true,
+  "license": "Apache-2.0",
+  "engines": {
+    "node": ">=22.0.0",
+    "pnpm": ">=9.0.0"
+  },
+  "scripts": {
+    "version:sync": "node scripts/sync-versions.js",
+    "dev": "turbo dev",
+    "build": "turbo build",
+    "test": "turbo test",
+    "lint": "turbo lint"
+  },
+  "devDependencies": {
+    "re2": "1.24.1",
+    "turbo": "^2.5.0",
+    "typescript": "^5.7.0"
+  },
+  "packageManager": "pnpm@10.34.3"
+}

package/dist/chunk-KQTCKRN2.js

@@ -0,0 +1,31 @@
+#!/usr/bin/env node
+
+// src/util/data-dir.ts
+import os from "os";
+import path from "path";
+function defaultDataDir() {
+  const home = os.homedir();
+  switch (process.platform) {
+    case "darwin":
+      return path.join(home, "Library", "Application Support", "kontexta");
+    case "win32":
+      return path.join(
+        process.env.APPDATA ?? path.join(home, "AppData", "Roaming"),
+        "kontexta"
+      );
+    default:
+      return path.join(
+        process.env.XDG_DATA_HOME ?? path.join(home, ".local", "share"),
+        "kontexta"
+      );
+  }
+}
+function resolveDataDir() {
+  const raw = process.env.KONTEXTA_DATA_DIR?.trim();
+  if (raw) return { path: raw, source: "env" };
+  return { path: defaultDataDir(), source: "default" };
+}
+
+export {
+  resolveDataDir
+};

package/dist/doctor-W733U3FD.js

@@ -0,0 +1,46 @@
+#!/usr/bin/env node
+import {
+  resolveDataDir
+} from "./chunk-KQTCKRN2.js";
+
+// src/doctor.ts
+import { createRequire } from "module";
+var require2 = createRequire(import.meta.url);
+function checkNode() {
+  const v = process.versions.node;
+  const major = Number(v.split(".")[0]);
+  const ok = major === 22;
+  return { name: "Node", ok, detail: `v${v}${ok ? "" : " (required: 22.x)"}` };
+}
+function checkDataDir() {
+  const r = resolveDataDir();
+  return { name: "Data dir", ok: true, detail: `${r.path} (source: ${r.source})` };
+}
+function checkNative(mod) {
+  try {
+    require2(mod);
+    return { name: mod, ok: true, detail: "OK" };
+  } catch (e) {
+    return {
+      name: mod,
+      ok: false,
+      detail: `FAIL \u2014 ${e.message}. Try: npm rebuild ${mod}`
+    };
+  }
+}
+async function runDoctor() {
+  const results = [
+    checkNode(),
+    checkDataDir(),
+    checkNative("better-sqlite3"),
+    checkNative("re2")
+  ];
+  for (const r of results) {
+    process.stdout.write(`${r.name}: ${r.detail}
+`);
+  }
+  return results.every((r) => r.ok) ? 0 : 1;
+}
+export {
+  runDoctor
+};

package/dist/index.js

@@ -0,0 +1,45 @@
+#!/usr/bin/env node
+
+// src/index.ts
+import { createRequire } from "module";
+var HELP = `kontexta \u2014 one-click local dashboard + MCP server
+
+Usage:
+  kontexta start         Boot dashboard + MCP on port 3000 (or $PORT)
+  kontexta mcp           Run stdio MCP server (for AI client config)
+  kontexta doctor        Print environment diagnostics
+  kontexta --version     Print version
+  kontexta --help        Print this help
+`;
+(async () => {
+  const arg = process.argv[2];
+  if (!arg || arg === "--help" || arg === "-h") {
+    process.stdout.write(HELP);
+    process.exit(0);
+  }
+  if (arg === "--version" || arg === "-v") {
+    const require2 = createRequire(import.meta.url);
+    const { version } = require2("../package.json");
+    process.stdout.write(`kontexta ${version}
+`);
+    process.exit(0);
+  }
+  if (arg === "mcp") {
+    const { runMcp } = await import("./mcp-DGMGR3MZ.js");
+    await runMcp();
+    process.exit(0);
+  }
+  if (arg === "doctor") {
+    const { runDoctor } = await import("./doctor-W733U3FD.js");
+    process.exit(await runDoctor());
+  }
+  if (arg === "start") {
+    const { runStart } = await import("./start-RCW7AKUK.js");
+    await runStart();
+    process.exit(0);
+  }
+  process.stderr.write(`Unknown command: ${arg}
+`);
+  process.stderr.write(HELP);
+  process.exit(1);
+})();

package/dist/mcp-DGMGR3MZ.js

@@ -0,0 +1,34 @@
+#!/usr/bin/env node
+
+// src/mcp.ts
+import { existsSync } from "fs";
+import { dirname, resolve } from "path";
+import { fileURLToPath, pathToFileURL } from "url";
+function resolveMcpEntry() {
+  const here = dirname(fileURLToPath(import.meta.url));
+  const bundled = resolve(
+    here,
+    "..",
+    "bundle",
+    "standalone",
+    "node_modules",
+    "kontexta-mcp",
+    "dist",
+    "index.js"
+  );
+  if (existsSync(bundled)) return bundled;
+  const dev = resolve(here, "..", "..", "..", "apps", "mcp", "dist", "index.js");
+  if (existsSync(dev)) return dev;
+  throw new Error(
+    "kontexta-mcp entry not found. In dev, run `pnpm -C apps/mcp build` first."
+  );
+}
+async function runMcp() {
+  const entry = resolveMcpEntry();
+  await import(pathToFileURL(entry).href);
+  return new Promise(() => {
+  });
+}
+export {
+  runMcp
+};

package/dist/start-RCW7AKUK.js

@@ -0,0 +1,121 @@
+#!/usr/bin/env node
+import {
+  resolveDataDir
+} from "./chunk-KQTCKRN2.js";
+
+// src/start.ts
+import { spawn } from "child_process";
+import { existsSync } from "fs";
+import { fileURLToPath } from "url";
+import { dirname, resolve } from "path";
+import { setTimeout as delay } from "timers/promises";
+import open from "open";
+
+// src/util/port.ts
+import { createServer } from "net";
+function isFree(port) {
+  return new Promise((resolve2) => {
+    const s = createServer();
+    s.once("error", () => resolve2(false));
+    s.once("listening", () => s.close(() => resolve2(true)));
+    s.listen(port, "127.0.0.1");
+  });
+}
+async function pickPort(preferred, maxTries = 20) {
+  for (let i = 0; i < maxTries; i++) {
+    const p = preferred + i;
+    if (await isFree(p)) return p;
+  }
+  throw new Error(`No free port in range ${preferred}..${preferred + maxTries - 1}`);
+}
+
+// src/start.ts
+function resolveServerEntry() {
+  const here = dirname(fileURLToPath(import.meta.url));
+  const bundled = resolve(here, "..", "bundle", "standalone", "apps", "web", "server.js");
+  if (existsSync(bundled)) return bundled;
+  const dev = resolve(here, "..", "..", "..", "apps", "web", ".next", "standalone", "apps", "web", "server.js");
+  if (existsSync(dev)) return dev;
+  throw new Error(
+    "Web bundle not found. In dev, run `pnpm build` at the repo root. If installed via npm, the bundle should be under packages/cli/bundle/standalone/."
+  );
+}
+async function waitHealth(port, timeoutMs = 3e4) {
+  const deadline = Date.now() + timeoutMs;
+  while (Date.now() < deadline) {
+    try {
+      const res = await fetch(`http://127.0.0.1:${port}/api/health`);
+      if (res.status === 200) return;
+    } catch {
+    }
+    await delay(500);
+  }
+  throw new Error(`Health check timed out after ${timeoutMs}ms`);
+}
+async function runStart() {
+  const nodeMajor = Number(process.versions.node.split(".")[0]);
+  if (nodeMajor !== 22) {
+    process.stderr.write(`kontexta requires Node 22.x LTS (found v${process.versions.node}). See .nvmrc.
+`);
+    process.exit(1);
+  }
+  const data = resolveDataDir();
+  process.stdout.write(`Using data at ${data.path}
+`);
+  const rawPort = process.env.PORT;
+  const preferred = rawPort && /^\d+$/.test(rawPort) ? Number(rawPort) : 3e3;
+  if (rawPort && !/^\d+$/.test(rawPort)) {
+    process.stderr.write(`PORT=${rawPort} is not a valid integer; using 3000
+`);
+  }
+  const port = await pickPort(preferred);
+  if (port !== preferred) {
+    process.stdout.write(`Port ${preferred} busy \u2014 using ${port}
+`);
+  }
+  const server = resolveServerEntry();
+  const child = spawn(process.execPath, [server], {
+    stdio: ["ignore", "inherit", "inherit"],
+    env: {
+      ...process.env,
+      PORT: String(port),
+      KONTEXTA_DATA_DIR: data.path,
+      HOSTNAME: "127.0.0.1"
+    }
+  });
+  let exited = false;
+  const forward = (sig) => {
+    child.kill(sig);
+    setTimeout(() => {
+      if (!exited) child.kill("SIGKILL");
+    }, 5e3).unref();
+  };
+  process.on("SIGTERM", () => forward("SIGTERM"));
+  process.on("SIGINT", () => forward("SIGTERM"));
+  child.on("exit", (code) => {
+    exited = true;
+    process.exit(code ?? 0);
+  });
+  try {
+    await waitHealth(port);
+  } catch (e) {
+    process.stderr.write(`${e.message}
+`);
+    child.kill("SIGKILL");
+    process.exit(1);
+  }
+  const url = `http://127.0.0.1:${port}`;
+  process.stdout.write(`Kontexta is ready at ${url}
+`);
+  if (!process.env.KONTEXTA_NO_OPEN) {
+    try {
+      await open(url);
+    } catch {
+    }
+  }
+  return new Promise(() => {
+  });
+}
+export {
+  runStart
+};

package/package.json

@@ -0,0 +1,89 @@
+{
+  "name": "kontexta",
+  "version": "4.3.1",
+  "description": "One-click local dashboard + MCP server for AI coding agents",
+  "type": "module",
+  "license": "Apache-2.0",
+  "author": "safiyu",
+  "private": false,
+  "publishConfig": {
+    "access": "public"
+  },
+  "homepage": "https://github.com/safiyu/kontexta#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/safiyu/kontexta.git",
+    "directory": "packages/cli"
+  },
+  "bin": {
+    "kontexta": "dist/index.js"
+  },
+  "main": "dist/index.js",
+  "engines": {
+    "node": ">=22"
+  },
+  "files": [
+    "dist",
+    "bundle",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "tsup",
+    "test": "vitest run",
+    "start": "node dist/index.js",
+    "pack:bundle": "node scripts/pack-bundle.mjs",
+    "prepublishOnly": "pnpm run build && pnpm run pack:bundle"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.12.0",
+    "@mozilla/readability": "^0.6.0",
+    "@radix-ui/react-dialog": "^1.1.23",
+    "@radix-ui/react-dropdown-menu": "^2.1.24",
+    "@tiptap/extension-link": "^2.11.0",
+    "@tiptap/extension-table": "^2.11.0",
+    "@tiptap/extension-table-cell": "^2.11.0",
+    "@tiptap/extension-table-header": "^2.11.0",
+    "@tiptap/extension-table-row": "^2.11.0",
+    "@tiptap/pm": "^2.11.0",
+    "@tiptap/react": "^2.11.0",
+    "@tiptap/starter-kit": "^2.11.0",
+    "archiver": "^7.0.1",
+    "better-sqlite3": "^12.10.0",
+    "chokidar": "^4.0.0",
+    "glob": "^11.0.0",
+    "gray-matter": "^4.0.3",
+    "html-to-pdfmake": "^2.5.33",
+    "js-yaml": "^4.1.0",
+    "jsdom": "^29.1.1",
+    "lucide-react": "^1.21.0",
+    "markdown-it": "^14.1.0",
+    "mermaid": "^11",
+    "next": "15.5.18",
+    "next-themes": "^0.4.4",
+    "open": "^10.2.0",
+    "pdfmake": "^0.3.11",
+    "re2": "^1.24.1",
+    "react": "19.2.6",
+    "react-dom": "19.2.6",
+    "react-markdown": "^9.0.0",
+    "remark-gfm": "^4.0.1",
+    "remark-parse": "^11.0.0",
+    "remark-stringify": "^11.0.0",
+    "simple-git": "^3.27.0",
+    "sonner": "^2.0.7",
+    "strip-markdown": "^6.0.0",
+    "turndown": "^7.2.4",
+    "undici": "^7.0.0",
+    "unified": "^11.0.5",
+    "ws": "^8.18.0",
+    "zod": "^3.24.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "tsup": "^8.3.0",
+    "typescript": "^5.7.0",
+    "vitest": "^2.1.0"
+  },
+  "rulesVersion": "2.3.0"
+}