ctxloom-pro 1.0.26 → 1.0.28

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

@@ -168,7 +168,7 @@ var init_VectorStore = __esm({
 import express from "express";
 import cors from "cors";
 import path38 from "path";
-import fs30 from "fs";
+import fs31 from "fs";
 import { fileURLToPath as fileURLToPath2 } from "url";
 
 // server/loader.ts
@@ -8307,6 +8307,18 @@ var Schema9 = external_exports.object({
 var Schema10 = external_exports.object({
   show_files: external_exports.boolean().optional().default(false).describe(
     "Include member file paths in output (default: false for compact output)"
+  ),
+  limit: external_exports.number().int().min(1).max(200).optional().default(50).describe(
+    "Maximum number of communities to return per call (default: 50, max: 200)"
+  ),
+  offset: external_exports.number().int().min(0).optional().default(0).describe(
+    "Number of communities to skip before returning results \u2014 for paging (default: 0)"
+  ),
+  min_size: external_exports.number().int().min(1).optional().default(2).describe(
+    "Skip communities smaller than this (default: 2 \u2014 single-file communities are usually noise)"
+  ),
+  detail_level: external_exports.enum(["standard", "minimal"]).default("standard").describe(
+    '"standard" (default) returns paged community list. "minimal" returns counts only \u2014 useful for a quick size check before paging.'
   )
 });
 
@@ -8348,9 +8360,13 @@ var Schema13 = external_exports.object({
 });
 
 // ../../packages/core/src/tools/wiki-generate.ts
+import fs16 from "fs";
 var Schema14 = external_exports.object({
   force: external_exports.boolean().optional().default(false).describe(
     "Regenerate all pages even if content unchanged (default: false)"
+  ),
+  detail_level: external_exports.enum(["standard", "minimal"]).default("standard").describe(
+    '"standard" (default) lists each written page with size. "minimal" returns counts only.'
   )
 });
 
@@ -8381,7 +8397,7 @@ var Schema16 = external_exports.object({
 });
 
 // ../../packages/core/src/tools/refactor-preview.ts
-import fs16 from "fs";
+import fs17 from "fs";
 import path19 from "path";
 var Schema17 = external_exports.object({
   symbol: external_exports.string().min(1).describe("Symbol name to rename (exact match, case-sensitive)"),
@@ -8407,7 +8423,7 @@ var Schema18 = external_exports.object({
 init_embedder();
 init_VectorStore();
 init_logger();
-import fs17 from "fs";
+import fs18 from "fs";
 import path20 from "path";
 var Schema19 = external_exports.object({
   query: external_exports.string().min(1).describe("Search query \u2014 natural language or code fragment"),
@@ -8420,7 +8436,7 @@ var Schema19 = external_exports.object({
 });
 
 // ../../packages/core/src/tools/apply-refactor.ts
-import fs18 from "fs";
+import fs19 from "fs";
 import path21 from "path";
 var Schema20 = external_exports.object({
   symbol: external_exports.string().min(1).describe("Symbol name to rename (exact, case-sensitive)"),
@@ -8448,7 +8464,7 @@ var Schema21 = external_exports.object({
 });
 
 // ../../packages/core/src/tools/full-text-search.ts
-import fs19 from "fs";
+import fs20 from "fs";
 import path22 from "path";
 var Schema22 = external_exports.object({
   query: external_exports.string().min(1).describe("Search term \u2014 literal or /regex/"),
@@ -8474,7 +8490,7 @@ var Schema24 = external_exports.object({
 });
 
 // ../../packages/core/src/tools/graph-snapshot.ts
-import fs20 from "fs";
+import fs21 from "fs";
 import path23 from "path";
 var schema = external_exports.object({
   name: external_exports.string().min(1).max(64).regex(/^[\w.-]+$/, "Name may only contain letters, digits, dots, underscores, hyphens").describe(
@@ -8486,7 +8502,7 @@ var schema = external_exports.object({
 });
 
 // ../../packages/core/src/tools/graph-diff.ts
-import fs21 from "fs";
+import fs22 from "fs";
 import path24 from "path";
 var schema2 = external_exports.object({
   baseline: external_exports.string().min(1).describe('Name of the baseline snapshot (the "before" state).'),
@@ -8520,7 +8536,7 @@ var Schema26 = external_exports.object({
 });
 
 // ../../packages/core/src/rules/loadConfig.ts
-import fs22 from "fs/promises";
+import fs23 from "fs/promises";
 import path25 from "path";
 
 // ../../node_modules/js-yaml/dist/js-yaml.mjs
@@ -11146,24 +11162,24 @@ var Schema27 = external_exports.object({
 });
 
 // ../../packages/core/src/tools/ruleManager.ts
-import fs23 from "fs";
+import fs24 from "fs";
 import path26 from "path";
 
 // ../../packages/core/src/review/AuthorResolver.ts
-import fs24 from "fs/promises";
+import fs25 from "fs/promises";
 import path27 from "path";
 
 // ../../packages/core/src/review/CodeownersWriter.ts
-import fs25 from "fs/promises";
+import fs26 from "fs/promises";
 import path28 from "path";
 
 // ../../packages/core/src/review/loadConfig.ts
-import fs26 from "fs/promises";
+import fs27 from "fs/promises";
 import path29 from "path";
 
 // ../../packages/core/src/security/PathValidator.ts
 import path30 from "path";
-import fs27 from "fs";
+import fs28 from "fs";
 var MAX_FILE_SIZE = 5 * 1024 * 1024;
 
 // ../../packages/core/src/index.ts
@@ -11463,7 +11479,7 @@ function buildOwnershipRouter(ctx) {
 
 // server/routes/file.ts
 import { Router as Router7 } from "express";
-import fs28 from "fs/promises";
+import fs29 from "fs/promises";
 import path33 from "path";
 function buildFileRouter(ctx) {
   const router = Router7();
@@ -11476,7 +11492,7 @@ function buildFileRouter(ctx) {
       return res.status(403).json({ error: "forbidden" });
     }
     try {
-      const content = await fs28.readFile(abs, "utf-8");
+      const content = await fs29.readFile(abs, "utf-8");
       const ext = path33.extname(abs).slice(1);
       res.json({ content, lines: content.split("\n").length, ext });
     } catch {
@@ -11514,7 +11530,7 @@ function buildOpenRouter(ctx) {
 // server/routes/tokens.ts
 import { Router as Router9 } from "express";
 import path35 from "path";
-import fs29 from "fs";
+import fs30 from "fs";
 var CHARS_PER_TOKEN = 4;
 var cache = null;
 function buildTokensRouter(ctx) {
@@ -11531,7 +11547,7 @@ function buildTokensRouter(ctx) {
     for (const file of files) {
       const absPath = path35.join(ctx.root, file);
       try {
-        const content = fs29.readFileSync(absPath, "utf-8");
+        const content = fs30.readFileSync(absPath, "utf-8");
         fullChars += content.length;
         const skeleton = await skeletonizer.skeletonize(absPath);
         skeletonChars += skeleton.length;
@@ -11797,7 +11813,7 @@ async function startDashboard(options) {
     }
     const snapshotDir = path38.join(targetRoot, ".ctxloom");
     try {
-      activeWatcher = fs30.watch(snapshotDir, (_event, filename) => {
+      activeWatcher = fs31.watch(snapshotDir, (_event, filename) => {
         if (!filename || !filename.includes("snapshot")) return;
         if (debounce) clearTimeout(debounce);
         debounce = setTimeout(async () => {
@@ -11826,7 +11842,7 @@ async function startDashboard(options) {
     }
   }));
   const clientDist = path38.join(__dirname2, "../dashboard/client");
-  const clientDistExists = fs30.existsSync(path38.join(clientDist, "index.html"));
+  const clientDistExists = fs31.existsSync(path38.join(clientDist, "index.html"));
   if (clientDistExists) {
     app.use(express.static(clientDist, { dotfiles: "allow" }));
     app.get(/.*/, (_req, res) => {

package/dist/{chunk-GI354NTO.js → chunk-3AF7Z7DD.js}

@@ -5269,6 +5269,18 @@ import { z as z10 } from "zod";
 var Schema10 = z10.object({
   show_files: z10.boolean().optional().default(false).describe(
     "Include member file paths in output (default: false for compact output)"
+  ),
+  limit: z10.number().int().min(1).max(200).optional().default(50).describe(
+    "Maximum number of communities to return per call (default: 50, max: 200)"
+  ),
+  offset: z10.number().int().min(0).optional().default(0).describe(
+    "Number of communities to skip before returning results \u2014 for paging (default: 0)"
+  ),
+  min_size: z10.number().int().min(1).optional().default(2).describe(
+    "Skip communities smaller than this (default: 2 \u2014 single-file communities are usually noise)"
+  ),
+  detail_level: z10.enum(["standard", "minimal"]).default("standard").describe(
+    '"standard" (default) returns paged community list. "minimal" returns counts only \u2014 useful for a quick size check before paging.'
   )
 });
 function escapeXML10(text) {
@@ -5279,30 +5291,53 @@ function registerCommunityListTool(registry, ctx) {
     "ctx_community_list",
     {
       name: "ctx_community_list",
-      description: "Return all architectural communities detected via Louvain clustering of the import graph. Each community is a cluster of tightly-coupled files (a feature area, module, or layer). Use this to understand high-level codebase structure before diving into details.",
+      description: "Return architectural communities detected via Louvain clustering of the import graph. Each community is a cluster of tightly-coupled files (a feature area, module, or layer). Paged by default (limit=50, min_size=2). Use this to understand high-level codebase structure before diving into details; raise `limit` or page via `offset` for full coverage.",
       inputSchema: {
         type: "object",
         properties: {
           show_files: {
             type: "boolean",
             description: "Include member file paths in output (default: false)"
+          },
+          limit: {
+            type: "number",
+            description: "Maximum communities to return (default: 50, max: 200)"
+          },
+          offset: {
+            type: "number",
+            description: "Number of communities to skip for paging (default: 0)"
+          },
+          min_size: {
+            type: "number",
+            description: "Skip communities smaller than this (default: 2)"
+          },
+          detail_level: {
+            type: "string",
+            enum: ["standard", "minimal"],
+            description: '"standard" returns the paged list. "minimal" returns counts only.'
           }
         }
       }
     },
     async (args) => {
-      const { show_files } = Schema10.parse(args);
+      const { show_files, limit, offset, min_size, detail_level } = Schema10.parse(args);
       const graph = await ctx.getGraph();
       const files = graph.allFiles();
       if (files.length === 0) {
         return '<communities total="0" edge_count="0" />';
       }
       const detector = new CommunityDetector(graph);
-      const communities = detector.detect();
+      const allCommunities = detector.detect();
+      const filtered = allCommunities.filter((c) => c.files.length >= min_size).sort((a, b) => b.files.length - a.files.length);
+      if (detail_level === "minimal") {
+        return `<communities detail_level="minimal" total="${allCommunities.length}" filtered_total="${filtered.length}" edge_count="${graph.edgeCount()}" total_files="${files.length}" />`;
+      }
+      const page = filtered.slice(offset, offset + limit);
+      const hasMore = offset + page.length < filtered.length;
       const lines = [
-        `<communities total="${communities.length}" edge_count="${graph.edgeCount()}" total_files="${files.length}">`
+        `<communities total="${allCommunities.length}" filtered_total="${filtered.length}" showing="${page.length}" offset="${offset}" limit="${limit}" min_size="${min_size}" has_more="${hasMore}" edge_count="${graph.edgeCount()}" total_files="${files.length}">`
       ];
-      for (const c of communities.sort((a, b) => b.files.length - a.files.length)) {
+      for (const c of page) {
         if (show_files) {
           lines.push(`  <community id="${c.id}" name="${escapeXML10(c.name)}" size="${c.files.length}">`);
           for (const f of c.files.sort()) {
@@ -5668,43 +5703,62 @@ function registerSurprisingConnectionsTool(registry, ctx) {
 
 // packages/core/src/tools/wiki-generate.ts
 import { z as z14 } from "zod";
+import fs14 from "fs";
 var Schema14 = z14.object({
   force: z14.boolean().optional().default(false).describe(
     "Regenerate all pages even if content unchanged (default: false)"
+  ),
+  detail_level: z14.enum(["standard", "minimal"]).default("standard").describe(
+    '"standard" (default) lists each written page with size. "minimal" returns counts only.'
   )
 });
 function escapeXML14(text) {
   return text.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;").replace(/"/g, "&quot;");
 }
+function safeFileSize(filePath) {
+  try {
+    return fs14.statSync(filePath).size;
+  } catch {
+    return 0;
+  }
+}
 function registerWikiGenerateTool(registry, ctx) {
   registry.register(
     "ctx_wiki_generate",
     {
       name: "ctx_wiki_generate",
-      description: "Generate structural Markdown wiki pages for each Louvain community. Writes to .ctxloom/wiki/: one page per community with its files, public API, dependency map, and hub file skeleton. Pages are hash-cached \u2014 only updated when content changes. No LLM required \u2014 purely structural, always reproducible.",
+      description: "Generate structural Markdown wiki pages for each Louvain community. Writes to .ctxloom/wiki/: one page per community with its files, public API, dependency map, and hub file skeleton. Pages are hash-cached \u2014 only updated when content changes. Returns per-page metadata (path, size) for written pages and a count for skipped pages; read the listed paths directly when the body is needed.",
       inputSchema: {
         type: "object",
         properties: {
           force: {
             type: "boolean",
             description: "Regenerate all pages even if content is unchanged (default: false)"
+          },
+          detail_level: {
+            type: "string",
+            enum: ["standard", "minimal"],
+            description: '"standard" lists written pages with size. "minimal" returns counts only.'
           }
         }
       }
     },
     async (args) => {
-      const { force } = Schema14.parse(args);
+      const { force, detail_level } = Schema14.parse(args);
       const [graph, skeletonizer] = await Promise.all([ctx.getGraph(), ctx.getSkeletonizer()]);
       const generator = new WikiGenerator(graph, ctx.projectRoot, skeletonizer);
       const result = await generator.generate(force);
+      if (detail_level === "minimal") {
+        return `<wiki_generate detail_level="minimal" wiki_dir="${escapeXML14(result.wikiDir)}" written="${result.written.length}" skipped="${result.skipped.length}" />`;
+      }
       const lines = [
         `<wiki_generate wiki_dir="${escapeXML14(result.wikiDir)}" written="${result.written.length}" skipped="${result.skipped.length}">`
       ];
       for (const p of result.written) {
-        lines.push(`  <page community="${escapeXML14(p.communityName)}" file="${escapeXML14(p.filePath)}" status="written" />`);
-      }
-      for (const p of result.skipped) {
-        lines.push(`  <page community="${escapeXML14(p.communityName)}" file="${escapeXML14(p.filePath)}" status="skipped" />`);
+        const size = safeFileSize(p.filePath);
+        lines.push(
+          `  <page community="${escapeXML14(p.communityName)}" file="${escapeXML14(p.filePath)}" size="${size}" status="written" />`
+        );
       }
       lines.push("</wiki_generate>");
       return lines.join("\n");
@@ -5907,7 +5961,7 @@ function registerGitDiffReviewTool(registry, ctx) {
 
 // packages/core/src/tools/refactor-preview.ts
 import { z as z17 } from "zod";
-import fs14 from "fs";
+import fs15 from "fs";
 import path17 from "path";
 var Schema17 = z17.object({
   symbol: z17.string().min(1).describe("Symbol name to rename (exact match, case-sensitive)"),
@@ -5922,7 +5976,7 @@ function escapeXML17(text) {
 function scanFile(filePath, symbol, newName) {
   let content;
   try {
-    content = fs14.readFileSync(filePath, "utf-8");
+    content = fs15.readFileSync(filePath, "utf-8");
   } catch {
     return [];
   }
@@ -6152,7 +6206,7 @@ function registerExecutionFlowTool(registry, ctx) {
 
 // packages/core/src/tools/cross-repo-search.ts
 import { z as z19 } from "zod";
-import fs15 from "fs";
+import fs16 from "fs";
 import path18 from "path";
 var RepoRegistry = class {
   filePath;
@@ -6163,16 +6217,16 @@ var RepoRegistry = class {
   }
   load() {
     try {
-      if (!fs15.existsSync(this.filePath)) return [];
-      return JSON.parse(fs15.readFileSync(this.filePath, "utf-8"));
+      if (!fs16.existsSync(this.filePath)) return [];
+      return JSON.parse(fs16.readFileSync(this.filePath, "utf-8"));
     } catch {
       return [];
     }
   }
   save() {
     const dir = path18.dirname(this.filePath);
-    if (!fs15.existsSync(dir)) fs15.mkdirSync(dir, { recursive: true });
-    fs15.writeFileSync(this.filePath, JSON.stringify(this.repos, null, 2), "utf-8");
+    if (!fs16.existsSync(dir)) fs16.mkdirSync(dir, { recursive: true });
+    fs16.writeFileSync(this.filePath, JSON.stringify(this.repos, null, 2), "utf-8");
   }
   list() {
     return [...this.repos];
@@ -6313,7 +6367,7 @@ function registerCrossRepoSearchTool(registry, _ctx, registryFilePath) {
 
 // packages/core/src/tools/apply-refactor.ts
 import { z as z20 } from "zod";
-import fs16 from "fs";
+import fs17 from "fs";
 import path19 from "path";
 var Schema20 = z20.object({
   symbol: z20.string().min(1).describe("Symbol name to rename (exact, case-sensitive)"),
@@ -6331,7 +6385,7 @@ function escapeXML20(text) {
 function applyToFile(absPath, symbol, newName, dryRun) {
   let content;
   try {
-    content = fs16.readFileSync(absPath, "utf-8");
+    content = fs17.readFileSync(absPath, "utf-8");
   } catch {
     return 0;
   }
@@ -6340,7 +6394,7 @@ function applyToFile(absPath, symbol, newName, dryRun) {
   const occurrences = (content.match(regex) ?? []).length;
   if (occurrences === 0) return 0;
   if (!dryRun) {
-    fs16.writeFileSync(absPath, content.replace(regex, newName), "utf-8");
+    fs17.writeFileSync(absPath, content.replace(regex, newName), "utf-8");
   }
   return occurrences;
 }
@@ -6513,7 +6567,7 @@ function registerDetectChangesTool(registry, ctx) {
 
 // packages/core/src/tools/full-text-search.ts
 import { z as z22 } from "zod";
-import fs17 from "fs";
+import fs18 from "fs";
 import path20 from "path";
 var Schema22 = z22.object({
   query: z22.string().min(1).describe("Search term \u2014 literal or /regex/"),
@@ -6539,7 +6593,7 @@ function buildPattern(query, caseSensitive) {
 function scanFile2(absPath, pattern, contextLines) {
   let content;
   try {
-    content = fs17.readFileSync(absPath, "utf-8");
+    content = fs18.readFileSync(absPath, "utf-8");
   } catch {
     return null;
   }
@@ -6825,7 +6879,7 @@ function registerGetWorkflowTool(registry, _ctx) {
 }
 
 // packages/core/src/tools/graph-snapshot.ts
-import fs18 from "fs";
+import fs19 from "fs";
 import path21 from "path";
 import { z as z25 } from "zod";
 var schema = z25.object({
@@ -6838,12 +6892,12 @@ var schema = z25.object({
 });
 function saveNamedSnapshot(graph, name, rootDir, overwrite = false) {
   const snapshotsDir = path21.resolve(rootDir, ".ctxloom", "snapshots");
-  fs18.mkdirSync(snapshotsDir, { recursive: true });
+  fs19.mkdirSync(snapshotsDir, { recursive: true });
   const snapshotPath = path21.resolve(snapshotsDir, `${name}.json`);
   if (!snapshotPath.startsWith(snapshotsDir + path21.sep)) {
     throw new Error(`Invalid snapshot name: "${name}"`);
   }
-  if (fs18.existsSync(snapshotPath) && !overwrite) {
+  if (fs19.existsSync(snapshotPath) && !overwrite) {
     throw new Error(`Snapshot "${name}" already exists. Pass overwrite: true to replace it.`);
   }
   const files = graph.allFiles();
@@ -6859,13 +6913,13 @@ function saveNamedSnapshot(graph, name, rootDir, overwrite = false) {
     forwardEdges
   };
   const tmp = snapshotPath + ".tmp";
-  fs18.writeFileSync(tmp, JSON.stringify(data, null, 2), "utf-8");
-  fs18.renameSync(tmp, snapshotPath);
+  fs19.writeFileSync(tmp, JSON.stringify(data, null, 2), "utf-8");
+  fs19.renameSync(tmp, snapshotPath);
 }
 function listNamedSnapshots(rootDir) {
   const snapshotsDir = path21.join(rootDir, ".ctxloom", "snapshots");
-  if (!fs18.existsSync(snapshotsDir)) return [];
-  return fs18.readdirSync(snapshotsDir).filter((f) => f.endsWith(".json")).map((f) => f.slice(0, -5)).sort();
+  if (!fs19.existsSync(snapshotsDir)) return [];
+  return fs19.readdirSync(snapshotsDir).filter((f) => f.endsWith(".json")).map((f) => f.slice(0, -5)).sort();
 }
 function registerGraphSnapshotTool(registry, ctx) {
   registry.register(
@@ -6913,7 +6967,7 @@ function registerGraphSnapshotTool(registry, ctx) {
 }
 
 // packages/core/src/tools/graph-diff.ts
-import fs19 from "fs";
+import fs20 from "fs";
 import path22 from "path";
 import { z as z26 } from "zod";
 var schema2 = z26.object({
@@ -6926,11 +6980,11 @@ function loadSnapshot(name, rootDir) {
   if (!snapshotPath.startsWith(snapshotsDir + path22.sep)) {
     throw new Error(`Invalid snapshot name: "${name}"`);
   }
-  if (!fs19.existsSync(snapshotPath)) {
+  if (!fs20.existsSync(snapshotPath)) {
     throw new Error(`Snapshot "${name}" not found. Run ctx_graph_snapshot first.`);
   }
   try {
-    return JSON.parse(fs19.readFileSync(snapshotPath, "utf-8"));
+    return JSON.parse(fs20.readFileSync(snapshotPath, "utf-8"));
   } catch (e) {
     throw new Error(`Snapshot "${name}" is corrupted: ${e instanceof Error ? e.message : String(e)}`);
   }
@@ -7295,7 +7349,7 @@ var RulesConfigError = class extends Error {
 };
 
 // packages/core/src/rules/loadConfig.ts
-import fs20 from "fs/promises";
+import fs21 from "fs/promises";
 import path23 from "path";
 import yaml from "js-yaml";
 import { z as z30 } from "zod";
@@ -7314,7 +7368,7 @@ async function loadRulesConfig(rootDir) {
   const filePath = path23.join(rootDir, ".ctxloom", "rules.yml");
   let raw;
   try {
-    raw = await fs20.readFile(filePath, "utf-8");
+    raw = await fs21.readFile(filePath, "utf-8");
   } catch (err) {
     if (err.code === "ENOENT") return null;
     throw new RulesConfigError(`Failed to read rules config: ${String(err)}`);
@@ -7679,7 +7733,7 @@ function createToolRegistry(ctx) {
 }
 
 // packages/core/src/tools/ruleManager.ts
-import fs21 from "fs";
+import fs22 from "fs";
 import path24 from "path";
 var RULE_FILES = [
   ".cursorrules",
@@ -7707,17 +7761,17 @@ var RuleManager = class {
       const fullPath = path24.join(this.projectRoot, ruleFile);
       try {
         this.pathValidator.validate(fullPath);
-        if (fs21.existsSync(fullPath)) {
-          const stat = fs21.statSync(fullPath);
+        if (fs22.existsSync(fullPath)) {
+          const stat = fs22.statSync(fullPath);
           if (stat.isFile()) {
-            const content = fs21.readFileSync(fullPath, "utf-8");
+            const content = fs22.readFileSync(fullPath, "utf-8");
             rules.push({
               name: ruleFile,
               path: ruleFile,
               content
             });
           } else if (stat.isDirectory()) {
-            const dirEntries = fs21.readdirSync(fullPath);
+            const dirEntries = fs22.readdirSync(fullPath);
             for (const entry of dirEntries) {
               const entryPath = path24.join(fullPath, entry);
               try {
@@ -7725,9 +7779,9 @@ var RuleManager = class {
               } catch {
                 continue;
               }
-              const entryStat = fs21.statSync(entryPath);
+              const entryStat = fs22.statSync(entryPath);
               if (entryStat.isFile()) {
-                const content = fs21.readFileSync(entryPath, "utf-8");
+                const content = fs22.readFileSync(entryPath, "utf-8");
                 rules.push({
                   name: `${ruleFile}/${entry}`,
                   path: `${ruleFile}/${entry}`,
@@ -7770,7 +7824,7 @@ var RuleManager = class {
 };
 
 // packages/core/src/review/AuthorResolver.ts
-import fs22 from "fs/promises";
+import fs23 from "fs/promises";
 import path25 from "path";
 import yaml2 from "js-yaml";
 var AuthorResolver = class {
@@ -7796,7 +7850,7 @@ var AuthorResolver = class {
   /** Write a new mapping to the cache file. */
   async writeCache(email, handle) {
     this.cache = { ...this.cache, [email]: handle };
-    await fs22.writeFile(
+    await fs23.writeFile(
       path25.join(this.ctxloomDir, "authors-cache.json"),
       JSON.stringify(this.cache, null, 2)
     );
@@ -7808,7 +7862,7 @@ var AuthorResolver = class {
   async loadYml() {
     const file = path25.join(this.ctxloomDir, "authors.yml");
     try {
-      const raw = await fs22.readFile(file, "utf8");
+      const raw = await fs23.readFile(file, "utf8");
       const parsed = yaml2.load(raw);
       if (!parsed) return;
       this.mappings = parsed.mappings ?? {};
@@ -7819,7 +7873,7 @@ var AuthorResolver = class {
   async loadCache() {
     const file = path25.join(this.ctxloomDir, "authors-cache.json");
     try {
-      const raw = await fs22.readFile(file, "utf8");
+      const raw = await fs23.readFile(file, "utf8");
       this.cache = JSON.parse(raw);
     } catch {
     }
@@ -7844,7 +7898,7 @@ async function resolveViaGitHubApi(email, owner, repo, token) {
 }
 
 // packages/core/src/review/CodeownersWriter.ts
-import fs23 from "fs/promises";
+import fs24 from "fs/promises";
 import path26 from "path";
 var MARKER_START = "# <ctxloom:start> \u2014 managed by ctxloom review-suggest; do not edit between markers";
 var MARKER_START_DETECT = "# <ctxloom:start>";
@@ -7877,15 +7931,15 @@ ${block}
 async function generateCODEOWNERS(codeownersPath, rules) {
   let existing = "";
   try {
-    existing = await fs23.readFile(codeownersPath, "utf8");
+    existing = await fs24.readFile(codeownersPath, "utf8");
   } catch {
   }
   const block = buildCodeownersBlock(rules);
   return mergeIntoFile(existing, block);
 }
 async function writeCODEOWNERS(codeownersPath, content) {
-  await fs23.mkdir(path26.dirname(codeownersPath), { recursive: true });
-  await fs23.writeFile(codeownersPath, content, "utf8");
+  await fs24.mkdir(path26.dirname(codeownersPath), { recursive: true });
+  await fs24.writeFile(codeownersPath, content, "utf8");
 }
 
 // packages/core/src/review/types.ts
@@ -8070,7 +8124,7 @@ function matchGlob(pattern, value) {
 }
 
 // packages/core/src/review/loadConfig.ts
-import fs24 from "fs/promises";
+import fs25 from "fs/promises";
 import path27 from "path";
 import yaml3 from "js-yaml";
 function freshDefaults() {
@@ -8084,7 +8138,7 @@ function freshDefaults() {
 async function loadReviewConfig(root) {
   const file = path27.join(root, ".ctxloom", "review.yml");
   try {
-    const raw = await fs24.readFile(file, "utf8");
+    const raw = await fs25.readFile(file, "utf8");
     const parsed = yaml3.load(raw);
     if (!parsed) return freshDefaults();
     return {
@@ -8100,12 +8154,12 @@ async function loadReviewConfig(root) {
 
 // packages/core/src/security/PathValidator.ts
 import path28 from "path";
-import fs25 from "fs";
+import fs26 from "fs";
 var MAX_FILE_SIZE = 5 * 1024 * 1024;
 var PathValidator = class {
   canonicalRoot;
   constructor(projectRoot) {
-    this.canonicalRoot = fs25.realpathSync(path28.resolve(projectRoot));
+    this.canonicalRoot = fs26.realpathSync(path28.resolve(projectRoot));
   }
   /**
    * Validates that the given input path resolves within the project root.
@@ -8118,7 +8172,7 @@ var PathValidator = class {
     const resolved = path28.resolve(this.canonicalRoot, inputPath);
     let canonical;
     try {
-      canonical = fs25.realpathSync(resolved);
+      canonical = fs26.realpathSync(resolved);
     } catch {
       canonical = resolved;
     }
@@ -8147,11 +8201,11 @@ var PathValidator = class {
    */
   readFile(inputPath) {
     const absPath = this.validate(inputPath);
-    const stat = fs25.statSync(absPath);
+    const stat = fs26.statSync(absPath);
     if (stat.size > MAX_FILE_SIZE) {
       throw new Error(`File too large: ${inputPath} (${Math.round(stat.size / 1024)}KB, max ${MAX_FILE_SIZE / 1024 / 1024}MB)`);
     }
-    return fs25.readFileSync(absPath, "utf-8");
+    return fs26.readFileSync(absPath, "utf-8");
   }
   /**
    * Checks if a path exists and is within the project root.
@@ -8741,4 +8795,4 @@ export {
   track,
   captureError
 };
-//# sourceMappingURL=chunk-GI354NTO.js.map
+//# sourceMappingURL=chunk-3AF7Z7DD.js.map

package/dist/index.js

@@ -34,7 +34,7 @@ import {
   startTrial,
   track,
   writeCODEOWNERS
-} from "./chunk-GI354NTO.js";
+} from "./chunk-3AF7Z7DD.js";
 import {
   VectorStore
 } from "./chunk-NEHYSE2Y.js";
@@ -125,7 +125,10 @@ function buildContext() {
       if (!_ruleManager) _ruleManager = new RuleManager(PROJECT_ROOT, ctx.getPathValidator());
       return _ruleManager;
     },
-    isStoreInitialized: () => _storePromise !== null,
+    isStoreInitialized: () => {
+      if (_storePromise !== null) return true;
+      return fs.existsSync(path.join(DB_PATH, "code_embeddings.lance"));
+    },
     isGraphInitialized: () => _graphPromise !== null,
     isParserInitialized: () => _parserPromise !== null
   };
@@ -613,7 +616,7 @@ try {
 } catch {
 }
 var args = process.argv.slice(2);
-var ctxloomVersion = "1.0.26".length > 0 ? "1.0.26" : "dev";
+var ctxloomVersion = "1.0.28".length > 0 ? "1.0.28" : "dev";
 if (args.includes("--version") || args.includes("-v")) {
   process.stdout.write(`ctxloom ${ctxloomVersion}
 `);
@@ -686,7 +689,7 @@ async function checkLicense() {
   if (command !== void 0 && LICENSE_GATE_BYPASS_COMMANDS.has(command)) return;
   const ciKey = process.env["CTXLOOM_LICENSE_KEY"];
   if (ciKey) {
-    const { ApiClient } = await import("./src-BRXQZ22F.js");
+    const { ApiClient } = await import("./src-DZ5Z7KVU.js");
     const client = new ApiClient(process.env["CTXLOOM_API_BASE"]);
     try {
       const result = await client.validate(ciKey, "ci-ephemeral");
@@ -924,11 +927,12 @@ async function main() {
 `);
       const indexStart = Date.now();
       const result = await indexDirectory(root, (file, i, total) => {
+        if (!isTTY) return;
         const trimmed = file.length > 60 ? "\u2026" + file.slice(-59) : file;
         process.stdout.write(`\r  ${style.dim(`[${i}/${total}]`)} ${style.dim(trimmed)}\x1B[K`);
       });
       const indexMs = Date.now() - indexStart;
-      process.stdout.write("\r\x1B[K");
+      if (isTTY) process.stdout.write("\r\x1B[K");
       const errLabel = result.errors === 0 ? style.dim("0 errors") : style.warn(`${result.errors} error${result.errors === 1 ? "" : "s"}`);
       process.stdout.write(`  ${success(`Indexed ${style.bold(String(result.indexed))} files`)} ${style.dim("\xB7")} ${errLabel} ${style.dim(`\xB7 ${(indexMs / 1e3).toFixed(1)}s`)}
 
@@ -1247,7 +1251,7 @@ Suggested reviewers for ${files.length} file(s):`);
         process.stderr.write("[ctxloom] --limit must be a non-negative integer (0 for unlimited)\n");
         process.exit(2);
       }
-      const { loadRulesConfig, RulesChecker, formatText, formatJson, RulesConfigError } = await import("./src-BRXQZ22F.js");
+      const { loadRulesConfig, RulesChecker, formatText, formatJson, RulesConfigError } = await import("./src-DZ5Z7KVU.js");
       let config;
       try {
         config = await loadRulesConfig(root);
@@ -1271,7 +1275,7 @@ Suggested reviewers for ${files.length} file(s):`);
       }
       let graph;
       if (useSnapshot) {
-        const { DependencyGraph: DG } = await import("./src-BRXQZ22F.js");
+        const { DependencyGraph: DG } = await import("./src-DZ5Z7KVU.js");
         graph = new DG();
         const loaded = await graph.loadSnapshotOnly(root);
         if (!loaded) {
@@ -1280,7 +1284,7 @@ Suggested reviewers for ${files.length} file(s):`);
         }
       } else {
         process.stderr.write("[ctxloom] Building dependency graph...\n");
-        const { ASTParser: ASTParser2, DependencyGraph: DependencyGraph2 } = await import("./src-BRXQZ22F.js");
+        const { ASTParser: ASTParser2, DependencyGraph: DependencyGraph2 } = await import("./src-DZ5Z7KVU.js");
         let parser;
         try {
           parser = new ASTParser2();

package/dist/{src-BRXQZ22F.js → src-DZ5Z7KVU.js}

@@ -80,7 +80,7 @@ import {
   startTrial,
   track,
   writeCODEOWNERS
-} from "./chunk-GI354NTO.js";
+} from "./chunk-3AF7Z7DD.js";
 import {
   VectorStore
 } from "./chunk-NEHYSE2Y.js";
@@ -182,4 +182,4 @@ export {
   track,
   writeCODEOWNERS
 };
-//# sourceMappingURL=src-BRXQZ22F.js.map
+//# sourceMappingURL=src-DZ5Z7KVU.js.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ctxloom-pro",
-  "version": "1.0.26",
+  "version": "1.0.28",
   "description": "ctxloom — The Universal Code Context Engine. A local-first MCP server providing intelligent code context via hybrid Vector + AST + Graph search with Skeletonization (92% token reduction).",
   "type": "module",
   "main": "dist/index.js",