ctxloom-pro 1.3.1 → 1.4.0

package/README.md

@@ -47,7 +47,7 @@ The full first-run flow is **one install + one trial + one init per project.** E
 npm install -g ctxloom-pro
 ```
 
-> **For local trial / dev use the unpinned command above is fine.** For unattended CI usage, pin to the exact version (`ctxloom-pro@1.3.1`) so future CLI releases don't silently desync your agent-spec coverage — see the workflow example below.
+> **For local trial / dev use the unpinned command above is fine.** For unattended CI usage, pin to the exact version (`ctxloom-pro@1.4.0`) so future CLI releases don't silently desync your agent-spec coverage — see the workflow example below.
 
 ### 2 — Start your free trial (once per email)
 
@@ -346,7 +346,7 @@ jobs:
       # Exact pin (not `@^1`) so future CLI releases that add/remove MCP
       # tools don't silently desync your reviewer-agent specs. Bump on
       # every release; see CHANGELOG.md for the live version table.
-      - run: npm install -g ctxloom-pro@1.3.1
+      - run: npm install -g ctxloom-pro@1.4.0
       - run: ctxloom index
       - run: ctxloom rules check --json
 ```

package/apps/dashboard/dist/server/index.js

@@ -166,12 +166,12 @@ var init_VectorStore = __esm({
 // server/index.ts
 import express from "express";
 import cors from "cors";
-import path45 from "path";
-import fs33 from "fs";
+import path46 from "path";
+import fs34 from "fs";
 import { fileURLToPath as fileURLToPath2 } from "url";
 
 // server/loader.ts
-import path39 from "path";
+import path40 from "path";
 
 // ../../packages/core/src/graph/DependencyGraph.ts
 import fs7 from "fs";
@@ -3181,8 +3181,8 @@ var CoChangeIndex = class _CoChangeIndex {
     if (event.isBulk || event.isMerge) return;
     const paths = event.files.map((f) => f.path);
     if (paths.length === 0) return;
-    for (const path46 of paths) {
-      this.nodeCounts.set(path46, (this.nodeCounts.get(path46) ?? 0) + 1);
+    for (const path47 of paths) {
+      this.nodeCounts.set(path47, (this.nodeCounts.get(path47) ?? 0) + 1);
     }
     for (let i = 0; i < paths.length; i++) {
       for (let j = i + 1; j < paths.length; j++) {
@@ -3329,8 +3329,8 @@ var ChurnIndex = class _ChurnIndex {
    */
   snapshot() {
     const nodes = {};
-    for (const [path46, raw] of this.nodes) {
-      nodes[path46] = {
+    for (const [path47, raw] of this.nodes) {
+      nodes[path47] = {
         commits: raw.commits,
         churnLines: raw.churnLines,
         bugCommits: raw.bugCommits,
@@ -3345,8 +3345,8 @@ var ChurnIndex = class _ChurnIndex {
    */
   static load(s) {
     const idx = new _ChurnIndex();
-    for (const [path46, raw] of Object.entries(s.nodes)) {
-      idx.nodes.set(path46, {
+    for (const [path47, raw] of Object.entries(s.nodes)) {
+      idx.nodes.set(path47, {
         commits: raw.commits,
         churnLines: raw.churnLines,
         bugCommits: raw.bugCommits,
@@ -3359,8 +3359,8 @@ var ChurnIndex = class _ChurnIndex {
   // -------------------------------------------------------------------------
   // Private helpers
   // -------------------------------------------------------------------------
-  getOrCreate(path46) {
-    const existing = this.nodes.get(path46);
+  getOrCreate(path47) {
+    const existing = this.nodes.get(path47);
     if (existing !== void 0) return existing;
     const fresh = {
       commits: 0,
@@ -3369,7 +3369,7 @@ var ChurnIndex = class _ChurnIndex {
       authorCounts: {},
       lastTouch: 0
     };
-    this.nodes.set(path46, fresh);
+    this.nodes.set(path47, fresh);
     return fresh;
   }
 };
@@ -3450,12 +3450,12 @@ var OwnershipIndex = class _OwnershipIndex {
    */
   snapshot() {
     const nodes = {};
-    for (const [path46, raw] of this.nodes) {
+    for (const [path47, raw] of this.nodes) {
       const authorWeights = {};
       for (const [email, entry] of Object.entries(raw.authorWeights)) {
         authorWeights[email] = { ...entry };
       }
-      nodes[path46] = { authorWeights, lastTouch: raw.lastTouch };
+      nodes[path47] = { authorWeights, lastTouch: raw.lastTouch };
     }
     return { version: 1, nodes };
   }
@@ -3464,23 +3464,23 @@ var OwnershipIndex = class _OwnershipIndex {
    */
   static load(s) {
     const idx = new _OwnershipIndex();
-    for (const [path46, raw] of Object.entries(s.nodes)) {
+    for (const [path47, raw] of Object.entries(s.nodes)) {
       const authorWeights = {};
       for (const [email, entry] of Object.entries(raw.authorWeights)) {
         authorWeights[email] = { ...entry };
       }
-      idx.nodes.set(path46, { authorWeights, lastTouch: raw.lastTouch });
+      idx.nodes.set(path47, { authorWeights, lastTouch: raw.lastTouch });
     }
     return idx;
   }
   // -------------------------------------------------------------------------
   // Private helpers
   // -------------------------------------------------------------------------
-  getOrCreate(path46) {
-    const existing = this.nodes.get(path46);
+  getOrCreate(path47) {
+    const existing = this.nodes.get(path47);
     if (existing !== void 0) return existing;
     const fresh = { authorWeights: {}, lastTouch: 0 };
-    this.nodes.set(path46, fresh);
+    this.nodes.set(path47, fresh);
     return fresh;
   }
 };
@@ -4718,8 +4718,8 @@ function getErrorMap() {
 
 // ../../node_modules/zod/v3/helpers/parseUtil.js
 var makeIssue = (params) => {
-  const { data, path: path46, errorMaps, issueData } = params;
-  const fullPath = [...path46, ...issueData.path || []];
+  const { data, path: path47, errorMaps, issueData } = params;
+  const fullPath = [...path47, ...issueData.path || []];
   const fullIssue = {
     ...issueData,
     path: fullPath
@@ -4835,11 +4835,11 @@ var errorUtil;
 
 // ../../node_modules/zod/v3/types.js
 var ParseInputLazyPath = class {
-  constructor(parent, value, path46, key) {
+  constructor(parent, value, path47, key) {
     this._cachedPath = [];
     this.parent = parent;
     this.data = value;
-    this._path = path46;
+    this._path = path47;
     this._key = key;
   }
   get path() {
@@ -11318,6 +11318,18 @@ var Schema29 = external_exports.object({
   project_root: ProjectRootField
 });
 
+// ../../packages/core/src/tools/minimal-context.ts
+import { execSync } from "child_process";
+var Schema30 = external_exports.object({
+  task: external_exports.string().max(200).optional().describe(
+    "Free-text description of what you're about to do (e.g. 'review PR 142', 'rename emitTelemetry'). The tool routes by regex to the most-fitting suggested-first-tool. Capped at 200 chars; control characters stripped."
+  ),
+  project_root: ProjectRootField,
+  max_response_tokens: external_exports.number().int().positive().optional(),
+  on_budget_exceeded: external_exports.enum(["skeleton", "truncate", "error"]).optional(),
+  response_format: external_exports.enum(["full", "skeleton", "auto"]).optional()
+});
+
 // ../../packages/core/src/tools/ruleManager.ts
 import fs25 from "fs";
 import path27 from "path";
@@ -11429,7 +11441,7 @@ function resolveTelemetryLevel() {
 }
 var TELEMETRY_LEVEL = resolveTelemetryLevel();
 var TELEMETRY_DISABLED = TELEMETRY_LEVEL === "off";
-var CTXLOOM_VERSION = "1.3.1".length > 0 ? "1.3.1" : "dev";
+var CTXLOOM_VERSION = "1.4.0".length > 0 ? "1.4.0" : "dev";
 var POSTHOG_HOST = "https://eu.i.posthog.com";
 var POSTHOG_KEY = process.env["POSTHOG_API_KEY"] ?? (true ? "phc_CiDkmFLcZ2K6uCpcoSUQLmFrnnUvsyXGhSxopX5TVKE6" : "");
 var SENTRY_DSN = process.env["SENTRY_DSN"] ?? (true ? "https://81c94a0f04a8e242dee493ac1e17f733@o4508531702497280.ingest.de.sentry.io/4511256875368528" : "");
@@ -11584,9 +11596,57 @@ init_logger();
 import fs30 from "fs";
 import path38 from "path";
 
+// ../../packages/core/src/install/installer.ts
+import fs31 from "fs";
+import path39 from "path";
+
+// ../../packages/core/src/install/templates.ts
+var SESSION_START_HEADER = `#!/usr/bin/env bash
+# ctxloom \u2014 agent-harness session-start hook
+# Generated by \`ctxloom init\`. Re-run \`ctxloom init\` to update.
+# Manual edits will be overwritten on the next install.
+
+set -e
+`;
+var SESSION_START_BODY = `DB=".ctxloom/graph.db"
+
+if [ -f "$DB" ]; then
+  # \`ctxloom status --json\` is cached + sub-100ms \u2014 keeps the hook
+  # under its 2s timeout even on cold disk.
+  STATS=$(ctxloom status --json 2>/dev/null || echo '{"nodes":0,"edges":0}')
+  NODES=$(echo "$STATS" | grep -oE '"nodes":\\s*[0-9]+' | grep -oE '[0-9]+' || echo "?")
+  EDGES=$(echo "$STATS" | grep -oE '"edges":\\s*[0-9]+' | grep -oE '[0-9]+' || echo "?")
+
+  cat <<EOF
+[ctxloom] Knowledge graph ready (\${NODES} nodes, \${EDGES} edges).
+
+Start every workflow with \\\`ctx_get_minimal_context(task="...")\\\`.
+It returns ~150 tokens of orientation + a task-aware
+suggested_first_tool. Follow the meta.next_tool_suggestions on
+every response.
+
+Prefer ctxloom MCP tools over Grep/Glob/Read:
+  - ctx_detect_changes for code review
+  - ctx_blast_radius / ctx_get_call_graph before refactoring
+  - ctx_architecture_overview for orientation
+EOF
+else
+  cat <<EOF
+[ctxloom] No knowledge graph found here.
+Run: ctxloom build
+
+Then restart this session to enable graph-powered queries.
+EOF
+fi
+`;
+var SESSION_START_FULL = SESSION_START_HEADER + "\n" + SESSION_START_BODY;
+
+// ../../packages/core/src/install/hmacBlock.ts
+import crypto6 from "crypto";
+
 // server/loader.ts
 async function loadContext(root) {
-  const absRoot = path39.resolve(root);
+  const absRoot = path40.resolve(root);
   const overlay = new GitOverlayStore(absRoot);
   const gitEnabled = await overlay.loadSnapshot();
   const graph = new DependencyGraph();
@@ -11839,21 +11899,21 @@ function buildOwnershipRouter(ctx) {
 
 // server/routes/file.ts
 import { Router as Router7 } from "express";
-import fs31 from "fs/promises";
-import path40 from "path";
+import fs32 from "fs/promises";
+import path41 from "path";
 function buildFileRouter(ctx) {
   const router = Router7();
   router.get("/", async (req, res) => {
     const rel = req.query.path;
     if (!rel) return res.status(400).json({ error: "missing path" });
-    const abs = path40.resolve(ctx.root, rel);
-    const rootBoundary = ctx.root.endsWith(path40.sep) ? ctx.root : ctx.root + path40.sep;
+    const abs = path41.resolve(ctx.root, rel);
+    const rootBoundary = ctx.root.endsWith(path41.sep) ? ctx.root : ctx.root + path41.sep;
     if (abs !== ctx.root && !abs.startsWith(rootBoundary)) {
       return res.status(403).json({ error: "forbidden" });
     }
     try {
-      const content = await fs31.readFile(abs, "utf-8");
-      const ext = path40.extname(abs).slice(1);
+      const content = await fs32.readFile(abs, "utf-8");
+      const ext = path41.extname(abs).slice(1);
       res.json({ content, lines: content.split("\n").length, ext });
     } catch {
       res.status(404).json({ error: "not found" });
@@ -11865,7 +11925,7 @@ function buildFileRouter(ctx) {
 // server/routes/open.ts
 import { Router as Router8 } from "express";
 import { execFile as execFile2 } from "child_process";
-import path41 from "path";
+import path42 from "path";
 function tryOpen(bin, abs) {
   return new Promise((resolve) => {
     execFile2(bin, [abs], { timeout: 5e3 }, (err) => resolve(!err));
@@ -11876,8 +11936,8 @@ function buildOpenRouter(ctx) {
   router.post("/", async (req, res) => {
     const rel = req.body?.path;
     if (!rel || typeof rel !== "string") return res.status(400).json({ error: "missing path" });
-    const abs = path41.resolve(ctx.root, rel);
-    const rootBoundary = ctx.root.endsWith(path41.sep) ? ctx.root : ctx.root + path41.sep;
+    const abs = path42.resolve(ctx.root, rel);
+    const rootBoundary = ctx.root.endsWith(path42.sep) ? ctx.root : ctx.root + path42.sep;
     if (abs !== ctx.root && !abs.startsWith(rootBoundary)) {
       return res.status(403).json({ error: "forbidden" });
     }
@@ -11889,8 +11949,8 @@ function buildOpenRouter(ctx) {
 
 // server/routes/tokens.ts
 import { Router as Router9 } from "express";
-import path42 from "path";
-import fs32 from "fs";
+import path43 from "path";
+import fs33 from "fs";
 var CHARS_PER_TOKEN = 4;
 var cache = null;
 function buildTokensRouter(ctx) {
@@ -11905,9 +11965,9 @@ function buildTokensRouter(ctx) {
     let fullChars = 0;
     let skeletonChars = 0;
     for (const file of files) {
-      const absPath = path42.join(ctx.root, file);
+      const absPath = path43.join(ctx.root, file);
       try {
-        const content = fs32.readFileSync(absPath, "utf-8");
+        const content = fs33.readFileSync(absPath, "utf-8");
         fullChars += content.length;
         const skeleton = await skeletonizer.skeletonize(absPath);
         skeletonChars += skeleton.length;
@@ -12008,18 +12068,18 @@ function buildFileTrendsRouter(ctx) {
 
 // server/routes/projects.ts
 import { Router as Router12 } from "express";
-import path44 from "path";
+import path45 from "path";
 
 // server/projects.ts
 import { existsSync as existsSync5, readFileSync as readFileSync4 } from "fs";
 import os8 from "os";
-import path43 from "path";
-import crypto6 from "crypto";
+import path44 from "path";
+import crypto7 from "crypto";
 var HOME = os8.homedir();
-var REGISTRY_PATH = path43.join(HOME, ".ctxloom", "repos.json");
+var REGISTRY_PATH = path44.join(HOME, ".ctxloom", "repos.json");
 function slugFor(root) {
-  const abs = path43.resolve(root);
-  return crypto6.createHash("sha1").update(abs).digest("hex").slice(0, 12);
+  const abs = path44.resolve(root);
+  return crypto7.createHash("sha1").update(abs).digest("hex").slice(0, 12);
 }
 function readRegistry() {
   if (!existsSync5(REGISTRY_PATH)) return [];
@@ -12033,27 +12093,27 @@ function readRegistry() {
   }
 }
 function listProjects(defaultRoot) {
-  const absDefault = path43.resolve(defaultRoot);
+  const absDefault = path44.resolve(defaultRoot);
   const out = [
     {
       slug: slugFor(absDefault),
-      name: path43.basename(absDefault) || absDefault,
+      name: path44.basename(absDefault) || absDefault,
       root: absDefault,
       isDefault: true,
-      hasSnapshot: existsSync5(path43.join(absDefault, ".ctxloom"))
+      hasSnapshot: existsSync5(path44.join(absDefault, ".ctxloom"))
     }
   ];
   const seen = /* @__PURE__ */ new Set([absDefault]);
   for (const entry of readRegistry()) {
-    const abs = path43.resolve(entry.root);
+    const abs = path44.resolve(entry.root);
     if (seen.has(abs)) continue;
     seen.add(abs);
     const item = {
       slug: slugFor(abs),
-      name: entry.name ?? (path43.basename(abs) || abs),
+      name: entry.name ?? (path44.basename(abs) || abs),
       root: abs,
       isDefault: false,
-      hasSnapshot: existsSync5(path43.join(abs, ".ctxloom"))
+      hasSnapshot: existsSync5(path44.join(abs, ".ctxloom"))
     };
     if (entry.alias !== void 0) item.alias = entry.alias;
     out.push(item);
@@ -12106,7 +12166,7 @@ function buildProjectsRouter(deps) {
     } catch (err) {
       const detail = err instanceof Error ? err.message : String(err);
       res.status(500).json({
-        error: `failed to switch to ${path44.basename(target.root)}: ${detail}`
+        error: `failed to switch to ${path45.basename(target.root)}: ${detail}`
       });
     }
   });
@@ -12163,7 +12223,7 @@ function buildTelemetryRouter() {
 }
 
 // server/index.ts
-var __dirname2 = path45.dirname(fileURLToPath2(import.meta.url));
+var __dirname2 = path46.dirname(fileURLToPath2(import.meta.url));
 async function startDashboard(options) {
   const { root, port, open } = options;
   console.log(`ctxloom dashboard \u2014 loading context from ${root}...`);
@@ -12222,9 +12282,9 @@ async function startDashboard(options) {
       }
       activeWatcher = null;
     }
-    const snapshotDir = path45.join(targetRoot, ".ctxloom");
+    const snapshotDir = path46.join(targetRoot, ".ctxloom");
     try {
-      activeWatcher = fs33.watch(snapshotDir, (_event, filename) => {
+      activeWatcher = fs34.watch(snapshotDir, (_event, filename) => {
         if (!filename || !filename.includes("snapshot")) return;
         if (debounce) clearTimeout(debounce);
         debounce = setTimeout(async () => {
@@ -12253,12 +12313,12 @@ async function startDashboard(options) {
       attachSnapshotWatcher(newRoot);
     }
   }));
-  const clientDist = path45.join(__dirname2, "../dashboard/client");
-  const clientDistExists = fs33.existsSync(path45.join(clientDist, "index.html"));
+  const clientDist = path46.join(__dirname2, "../dashboard/client");
+  const clientDistExists = fs34.existsSync(path46.join(clientDist, "index.html"));
   if (clientDistExists) {
     app.use(express.static(clientDist, { dotfiles: "allow" }));
     app.get(/.*/, (_req, res) => {
-      res.sendFile(path45.join(clientDist, "index.html"), { dotfiles: "allow" });
+      res.sendFile(path46.join(clientDist, "index.html"), { dotfiles: "allow" });
     });
   } else {
     app.get(/^\/(?!api\/).*/, (_req, res) => {