@quolu/lattice 0.1.0 → 0.12.2

package/sensor/dist/index.js

@@ -1,6 +1,6 @@
 "use strict";
 /**
- * CodeGraph
+ * LatticeSensor
  *
  * A local-first code intelligence system that builds a semantic
  * knowledge graph from any codebase.
@@ -42,7 +42,7 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.CodeGraph = exports.MCPServer = exports.LockUnavailableError = exports.FileWatcher = exports.MemoryMonitor = exports.throttle = exports.debounce = exports.processInBatches = exports.FileLock = exports.Mutex = exports.defaultLogger = exports.silentLogger = exports.getLogger = exports.setLogger = exports.ConfigError = exports.VectorError = exports.SearchError = exports.DatabaseError = exports.ParseError = exports.FileError = exports.CodeGraphError = exports.loadAllGrammars = exports.loadGrammarsForLanguages = exports.initGrammars = exports.getSupportedLanguages = exports.isGrammarLoaded = exports.isLanguageSupported = exports.detectLanguage = exports.CODEGRAPH_DIR = exports.findNearestCodeGraphRoot = exports.isInitialized = exports.getCodeGraphDir = exports.QueryBuilder = exports.DatabaseConnection = exports.getDatabasePath = void 0;
+exports.LatticeSensor = exports.MCPServer = exports.LockUnavailableError = exports.FileWatcher = exports.MemoryMonitor = exports.throttle = exports.debounce = exports.processInBatches = exports.FileLock = exports.Mutex = exports.defaultLogger = exports.silentLogger = exports.getLogger = exports.setLogger = exports.ConfigError = exports.VectorError = exports.SearchError = exports.DatabaseError = exports.ParseError = exports.FileError = exports.LatticeSensorError = exports.loadAllGrammars = exports.loadGrammarsForLanguages = exports.initGrammars = exports.getSupportedLanguages = exports.isGrammarLoaded = exports.isLanguageSupported = exports.detectLanguage = exports.LATTICE_SENSOR_DIR = exports.findNearestLatticeSensorRoot = exports.isInitialized = exports.getLatticeSensorDir = exports.QueryBuilder = exports.DatabaseConnection = exports.getDatabasePath = void 0;
 const path = __importStar(require("path"));
 const db_1 = require("./db");
 const wal_valve_1 = require("./db/wal-valve");
@@ -64,7 +64,7 @@ const resolver_pool_1 = require("./resolution/resolver-pool");
 // Re-export types for consumers
 __exportStar(require("./types"), exports);
 // Storage building blocks for embedded/SDK consumers that drive the graph
-// directly (open a DB, run prepared queries) rather than through the CodeGraph
+// directly (open a DB, run prepared queries) rather than through the LatticeSensor
 // facade. Exposed from the package entry so they no longer require deep imports
 // into dist/ (issue #354).
 var db_2 = require("./db");
@@ -73,10 +73,10 @@ Object.defineProperty(exports, "DatabaseConnection", { enumerable: true, get: fu
 var queries_2 = require("./db/queries");
 Object.defineProperty(exports, "QueryBuilder", { enumerable: true, get: function () { return queries_2.QueryBuilder; } });
 var directory_3 = require("./directory");
-Object.defineProperty(exports, "getCodeGraphDir", { enumerable: true, get: function () { return directory_3.getCodeGraphDir; } });
+Object.defineProperty(exports, "getLatticeSensorDir", { enumerable: true, get: function () { return directory_3.getLatticeSensorDir; } });
 Object.defineProperty(exports, "isInitialized", { enumerable: true, get: function () { return directory_3.isInitialized; } });
-Object.defineProperty(exports, "findNearestCodeGraphRoot", { enumerable: true, get: function () { return directory_3.findNearestCodeGraphRoot; } });
-Object.defineProperty(exports, "CODEGRAPH_DIR", { enumerable: true, get: function () { return directory_3.CODEGRAPH_DIR; } });
+Object.defineProperty(exports, "findNearestLatticeSensorRoot", { enumerable: true, get: function () { return directory_3.findNearestLatticeSensorRoot; } });
+Object.defineProperty(exports, "LATTICE_SENSOR_DIR", { enumerable: true, get: function () { return directory_3.LATTICE_SENSOR_DIR; } });
 var extraction_2 = require("./extraction");
 Object.defineProperty(exports, "detectLanguage", { enumerable: true, get: function () { return extraction_2.detectLanguage; } });
 Object.defineProperty(exports, "isLanguageSupported", { enumerable: true, get: function () { return extraction_2.isLanguageSupported; } });
@@ -86,7 +86,7 @@ Object.defineProperty(exports, "initGrammars", { enumerable: true, get: function
 Object.defineProperty(exports, "loadGrammarsForLanguages", { enumerable: true, get: function () { return extraction_2.loadGrammarsForLanguages; } });
 Object.defineProperty(exports, "loadAllGrammars", { enumerable: true, get: function () { return extraction_2.loadAllGrammars; } });
 var errors_1 = require("./errors");
-Object.defineProperty(exports, "CodeGraphError", { enumerable: true, get: function () { return errors_1.CodeGraphError; } });
+Object.defineProperty(exports, "LatticeSensorError", { enumerable: true, get: function () { return errors_1.LatticeSensorError; } });
 Object.defineProperty(exports, "FileError", { enumerable: true, get: function () { return errors_1.FileError; } });
 Object.defineProperty(exports, "ParseError", { enumerable: true, get: function () { return errors_1.ParseError; } });
 Object.defineProperty(exports, "DatabaseError", { enumerable: true, get: function () { return errors_1.DatabaseError; } });
@@ -110,11 +110,11 @@ Object.defineProperty(exports, "LockUnavailableError", { enumerable: true, get:
 var mcp_1 = require("./mcp");
 Object.defineProperty(exports, "MCPServer", { enumerable: true, get: function () { return mcp_1.MCPServer; } });
 /**
- * Main CodeGraph class
+ * Main LatticeSensor class
  *
  * Provides the primary interface for interacting with the code knowledge graph.
  */
-class CodeGraph {
+class LatticeSensor {
     db;
     queries;
     projectRoot;
@@ -136,7 +136,7 @@ class CodeGraph {
         this.db = db;
         this.queries = queries;
         this.projectRoot = projectRoot;
-        this.fileLock = new utils_1.FileLock(path.join((0, directory_2.getCodeGraphDir)(projectRoot), 'codegraph.lock'));
+        this.fileLock = new utils_1.FileLock(path.join((0, directory_2.getLatticeSensorDir)(projectRoot), 'sensor.lock'));
         this.wireLayers();
     }
     /**
@@ -161,9 +161,9 @@ class CodeGraph {
         this.contextBuilder = (0, context_1.createContextBuilder)(this.projectRoot, this.queries, this.traverser);
     }
     /**
-     * Heal a stale database handle in place. If `.codegraph/` was removed and
+     * Heal a stale database handle in place. If `.lattice/sensor/` was removed and
      * recreated at the SAME path while this instance held the DB open — a git
-     * worktree removed and re-added, or `rm -rf .codegraph` + `codegraph init` —
+     * worktree removed and re-added, or `rm -rf .lattice/sensor` + `lattice sensor init` —
      * our open fd points at the now-unlinked inode and can never see the new
      * index, so every query returns the pre-removal snapshot until the process
      * restarts (#925). When that's detected, open the live file at the same path,
@@ -198,20 +198,20 @@ class CodeGraph {
     // Lifecycle Methods
     // ===========================================================================
     /**
-     * Initialize a new CodeGraph project
+     * Initialize a new LatticeSensor project
      *
-     * Creates the .CodeGraph directory, database, and configuration.
+     * Creates the .LatticeSensor directory, database, and configuration.
      *
      * @param projectRoot - Path to the project root directory
      * @param options - Initialization options
-     * @returns A new CodeGraph instance
+     * @returns A new LatticeSensor instance
      */
     static async init(projectRoot, options = {}) {
         await (0, extraction_1.initGrammars)();
         const resolvedRoot = path.resolve(projectRoot);
         // Check if already initialized
         if ((0, directory_1.isInitialized)(resolvedRoot)) {
-            throw new Error(`CodeGraph already initialized in ${resolvedRoot}`);
+            throw new Error(`LatticeSensor already initialized in ${resolvedRoot}`);
         }
         // Create directory structure
         (0, directory_1.createDirectory)(resolvedRoot);
@@ -219,7 +219,7 @@ class CodeGraph {
         const dbPath = (0, db_1.getDatabasePath)(resolvedRoot);
         const db = db_1.DatabaseConnection.initialize(dbPath);
         const queries = new queries_1.QueryBuilder(db.getDb());
-        const instance = new CodeGraph(db, queries, resolvedRoot);
+        const instance = new LatticeSensor(db, queries, resolvedRoot);
         // Run initial indexing if requested
         if (options.index) {
             await instance.indexAll({ onProgress: options.onProgress });
@@ -233,7 +233,7 @@ class CodeGraph {
         const resolvedRoot = path.resolve(projectRoot);
         // Check if already initialized
         if ((0, directory_1.isInitialized)(resolvedRoot)) {
-            throw new Error(`CodeGraph already initialized in ${resolvedRoot}`);
+            throw new Error(`LatticeSensor already initialized in ${resolvedRoot}`);
         }
         // Create directory structure
         (0, directory_1.createDirectory)(resolvedRoot);
@@ -241,32 +241,32 @@ class CodeGraph {
         const dbPath = (0, db_1.getDatabasePath)(resolvedRoot);
         const db = db_1.DatabaseConnection.initialize(dbPath);
         const queries = new queries_1.QueryBuilder(db.getDb());
-        return new CodeGraph(db, queries, resolvedRoot);
+        return new LatticeSensor(db, queries, resolvedRoot);
     }
     /**
-     * Open an existing CodeGraph project
+     * Open an existing LatticeSensor project
      *
      * @param projectRoot - Path to the project root directory
      * @param options - Open options
-     * @returns A CodeGraph instance
+     * @returns A LatticeSensor instance
      */
     static async open(projectRoot, options = {}) {
         await (0, extraction_1.initGrammars)();
         const resolvedRoot = path.resolve(projectRoot);
         // Check if initialized
         if (!(0, directory_1.isInitialized)(resolvedRoot)) {
-            throw new Error(`CodeGraph not initialized in ${resolvedRoot}. Run init() first.`);
+            throw new Error(`LatticeSensor not initialized in ${resolvedRoot}. Run init() first.`);
         }
         // Validate directory structure
         const validation = (0, directory_1.validateDirectory)(resolvedRoot);
         if (!validation.valid) {
-            throw new Error(`Invalid CodeGraph directory: ${validation.errors.join(', ')}`);
+            throw new Error(`Invalid LatticeSensor directory: ${validation.errors.join(', ')}`);
         }
         // Open database
         const dbPath = (0, db_1.getDatabasePath)(resolvedRoot);
         const db = db_1.DatabaseConnection.open(dbPath);
         const queries = new queries_1.QueryBuilder(db.getDb());
-        const instance = new CodeGraph(db, queries, resolvedRoot);
+        const instance = new LatticeSensor(db, queries, resolvedRoot);
         // Sync if requested
         if (options.sync) {
             await instance.sync();
@@ -275,11 +275,11 @@ class CodeGraph {
     }
     /**
      * Rebuild the project's database from scratch and return a fresh, empty
-     * instance — the "same result as a fresh init" semantics that `codegraph
+     * instance — the "same result as a fresh init" semantics that `lattice sensor
      * index` documents.
      *
      * Unlike `open()` followed by `clear()`, this DISCARDS the existing
-     * `.codegraph/codegraph.db` (and its `-wal`/`-shm` sidecars) before
+     * `.lattice/sensor/sensor.db` (and its `-wal`/`-shm` sidecars) before
      * re-initializing, instead of opening the old database and DELETE-ing every
      * row. On a large or pre-fix poisoned index — e.g. an old graph that scanned
      * an ignored gitlink corpus (#1065) into ~1.6M nodes with a multi-GB WAL —
@@ -295,7 +295,7 @@ class CodeGraph {
         // Check if initialized — recreate REBUILDS an existing project; it is not a
         // first-time `init`.
         if (!(0, directory_1.isInitialized)(resolvedRoot)) {
-            throw new Error(`CodeGraph not initialized in ${resolvedRoot}. Run init() first.`);
+            throw new Error(`LatticeSensor not initialized in ${resolvedRoot}. Run init() first.`);
         }
         const dbPath = (0, db_1.getDatabasePath)(resolvedRoot);
         try {
@@ -307,13 +307,13 @@ class CodeGraph {
             // an actionable instruction instead of a generic failure.
             const reason = err instanceof Error ? err.message : String(err);
             throw new Error(`Could not rebuild the index — the database file is in use (${reason}). ` +
-                `Stop any running CodeGraph MCP server/daemon for this project and retry, ` +
-                `or remove the ${(0, directory_2.getCodeGraphDir)(resolvedRoot)} directory and run "codegraph init".`);
+                `Stop any running LatticeSensor MCP server/daemon for this project and retry, ` +
+                `or remove the ${(0, directory_2.getLatticeSensorDir)(resolvedRoot)} directory and run "lattice sensor init".`);
         }
         // Re-create an empty, freshly-schema'd database at the same path.
         const db = db_1.DatabaseConnection.initialize(dbPath);
         const queries = new queries_1.QueryBuilder(db.getDb());
-        return new CodeGraph(db, queries, resolvedRoot);
+        return new LatticeSensor(db, queries, resolvedRoot);
     }
     /**
      * Open synchronously (without sync)
@@ -322,27 +322,27 @@ class CodeGraph {
         const resolvedRoot = path.resolve(projectRoot);
         // Check if initialized
         if (!(0, directory_1.isInitialized)(resolvedRoot)) {
-            throw new Error(`CodeGraph not initialized in ${resolvedRoot}. Run init() first.`);
+            throw new Error(`LatticeSensor not initialized in ${resolvedRoot}. Run init() first.`);
         }
         // Validate directory structure
         const validation = (0, directory_1.validateDirectory)(resolvedRoot);
         if (!validation.valid) {
-            throw new Error(`Invalid CodeGraph directory: ${validation.errors.join(', ')}`);
+            throw new Error(`Invalid LatticeSensor directory: ${validation.errors.join(', ')}`);
         }
         // Open database
         const dbPath = (0, db_1.getDatabasePath)(resolvedRoot);
         const db = db_1.DatabaseConnection.open(dbPath);
         const queries = new queries_1.QueryBuilder(db.getDb());
-        return new CodeGraph(db, queries, resolvedRoot);
+        return new LatticeSensor(db, queries, resolvedRoot);
     }
     /**
-     * Check if a directory has been initialized as a CodeGraph project
+     * Check if a directory has been initialized as a LatticeSensor project
      */
     static isInitialized(projectRoot) {
         return (0, directory_1.isInitialized)(path.resolve(projectRoot));
     }
     /**
-     * Close the CodeGraph instance and release resources
+     * Close the LatticeSensor instance and release resources
      */
     close() {
         this.unwatch();
@@ -379,16 +379,16 @@ class CodeGraph {
             // growth by backfilling PASSIVEly on a worker thread (never blocking
             // the writer or the #850 watchdog heartbeat); runMaintenance below does
             // the final fold-up before the interval is restored in the finally.
-            // Kill switch: CODEGRAPH_NO_WAL_DEFER=1. Non-WAL journal modes (some
+            // Kill switch: LATTICE_SENSOR_NO_WAL_DEFER=1. Non-WAL journal modes (some
             // network filesystems) have no WAL to defer — skip.
             // Fast-init: on a COMPLETELY fresh DB, trade crash-durability for speed
             // during the bulk build (journal in memory, no fsync). Safe because the
             // DB is disposable until the index completes — index_state stays
             // 'indexing' and a crashed init is re-run from scratch; existing DBs
             // (re-index/sync) never take this path. Kill switch:
-            // CODEGRAPH_NO_FAST_INIT=1 (same pattern as CODEGRAPH_NO_WAL_DEFER).
+            // LATTICE_SENSOR_NO_FAST_INIT=1 (same pattern as LATTICE_SENSOR_NO_WAL_DEFER).
             const freshDb = this.queries.getNodeAndEdgeCount().nodes === 0;
-            const fastInit = process.env.CODEGRAPH_NO_FAST_INIT !== '1' && freshDb;
+            const fastInit = process.env.LATTICE_SENSOR_NO_FAST_INIT !== '1' && freshDb;
             if (fastInit) {
                 try {
                     this.db.getDb().pragma('journal_mode = MEMORY');
@@ -396,7 +396,7 @@ class CodeGraph {
                 }
                 catch { /* keep WAL */ }
             }
-            const deferWal = !fastInit && process.env.CODEGRAPH_NO_WAL_DEFER !== '1' && this.db.getJournalMode() === 'wal';
+            const deferWal = !fastInit && process.env.LATTICE_SENSOR_NO_WAL_DEFER !== '1' && this.db.getJournalMode() === 'wal';
             let walValve = null;
             let priorAutocheckpoint = 1000;
             // Set when the fastInit+pool path below defers autocheckpointing, so the
@@ -412,7 +412,7 @@ class CodeGraph {
                 const before = this.queries.getNodeAndEdgeCount();
                 // Mark the index as in-flight BEFORE any writes: a run killed
                 // mid-index (OOM, SIGKILL, the #850 liveness watchdog) leaves this
-                // marker behind, so `codegraph status` can tell a truncated index
+                // marker behind, so `lattice sensor status` can tell a truncated index
                 // from a completed one instead of silently serving partial results.
                 try {
                     this.queries.setMetadata('index_state', 'indexing');
@@ -440,7 +440,7 @@ class CodeGraph {
                 finally {
                     const tFts = Date.now();
                     this.db.endBulkNodeLoad();
-                    if (process.env.CODEGRAPH_SYNTH_TIMINGS)
+                    if (process.env.LATTICE_SENSOR_SYNTH_TIMINGS)
                         console.error(`[phase-timing] fts-rebuild: ${Date.now() - tFts}ms`);
                 }
                 // Fold the parse phase's WAL BEFORE the first post-parse reads
@@ -463,7 +463,7 @@ class CodeGraph {
                     // Cross-file finalization (e.g. NestJS RouterModule prefixes). Runs
                     // before resolution so updated names show up in subsequent reads.
                     this.resolver.runPostExtract();
-                    if (process.env.CODEGRAPH_SYNTH_TIMINGS)
+                    if (process.env.LATTICE_SENSOR_SYNTH_TIMINGS)
                         console.error(`[phase-timing] resolver-reinit: ${Date.now() - tReinit}ms`);
                 }
                 // Resolve references to create call/import/extends edges
@@ -515,7 +515,7 @@ class CodeGraph {
                             total: totalPasses,
                         });
                     });
-                    if (process.env.CODEGRAPH_SYNTH_TIMINGS)
+                    if (process.env.LATTICE_SENSOR_SYNTH_TIMINGS)
                         console.error(`[phase-timing] resolution: ${Date.now() - tResolve}ms`);
                     // Second pass: chained calls whose method lives on a supertype the
                     // receiver conforms to (protocol-extension / inherited / default-
@@ -523,13 +523,13 @@ class CodeGraph {
                     // built, so it runs after resolution (#750).
                     const tChained = Date.now();
                     await this.resolver.resolveChainedCallsViaConformance();
-                    if (process.env.CODEGRAPH_SYNTH_TIMINGS)
+                    if (process.env.LATTICE_SENSOR_SYNTH_TIMINGS)
                         console.error(`[synth-timing] chainedConformance: ${Date.now() - tChained}ms`);
                     // Same lifecycle for `this.<member>` callback registrations whose
                     // member is inherited from a supertype (#808).
                     const tDeferred = Date.now();
                     await this.resolver.resolveDeferredThisMemberRefs();
-                    if (process.env.CODEGRAPH_SYNTH_TIMINGS)
+                    if (process.env.LATTICE_SENSOR_SYNTH_TIMINGS)
                         console.error(`[synth-timing] deferredThisMember: ${Date.now() - tDeferred}ms`);
                 }
                 // Refresh planner stats + checkpoint the WAL after bulk writes.
@@ -546,7 +546,7 @@ class CodeGraph {
                         await walValve.drain();
                     }
                     await this.db.runMaintenance();
-                    if (process.env.CODEGRAPH_SYNTH_TIMINGS)
+                    if (process.env.LATTICE_SENSOR_SYNTH_TIMINGS)
                         console.error(`[phase-timing] maintenance: ${Date.now() - tMaint}ms`);
                 }
                 // The orchestrator only sees extraction-phase counts; resolution and
@@ -555,19 +555,19 @@ class CodeGraph {
                 if (result.success && result.filesIndexed > 0) {
                     const tCount = Date.now();
                     const after = this.queries.getNodeAndEdgeCount();
-                    if (process.env.CODEGRAPH_SYNTH_TIMINGS)
+                    if (process.env.LATTICE_SENSOR_SYNTH_TIMINGS)
                         console.error(`[phase-timing] count-recompute: ${Date.now() - tCount}ms`);
                     result.nodesCreated = after.nodes - before.nodes;
                     result.edgesCreated = after.edges - before.edges;
                 }
-                // Stamp the index with the engine that built it, so `codegraph status`
-                // and `codegraph upgrade` can recommend a re-index when the running
+                // Stamp the index with the engine that built it, so `lattice sensor status`
+                // and `lattice sensor upgrade` can recommend a re-index when the running
                 // engine produces richer extraction than the one on disk. Only on a
                 // real full index — a sync touches a subset, so it must NOT advance the
                 // extraction stamp (the bulk would still be stale). See extraction-version.ts.
                 if (result.success && result.filesIndexed > 0) {
                     try {
-                        this.queries.setMetadata('indexed_with_version', version_1.CodeGraphPackageVersion);
+                        this.queries.setMetadata('indexed_with_version', version_1.LatticeSensorPackageVersion);
                         this.queries.setMetadata('indexed_with_extraction_version', String(extraction_version_1.EXTRACTION_VERSION));
                     }
                     catch { /* metadata is advisory — never fail an index over it */ }
@@ -590,7 +590,7 @@ class CodeGraph {
                             this.queries.setMetadata('index_files_discovered', String(discovered));
                             this.queries.setMetadata('index_files_accounted', String(accounted));
                             result.errors.push({
-                                message: `Index is missing ${shortfall} of ${discovered} discovered files (indexed ${result.filesIndexed}, skipped ${result.filesSkipped}, errored ${result.filesErrored}). The index is PARTIAL — re-run \`codegraph index\`.`,
+                                message: `Index is missing ${shortfall} of ${discovered} discovered files (indexed ${result.filesIndexed}, skipped ${result.filesSkipped}, errored ${result.filesErrored}). The index is PARTIAL — re-run \`lattice sensor index\`.`,
                                 severity: 'warning',
                                 code: 'index_partial',
                             });
@@ -679,9 +679,9 @@ class CodeGraph {
             // not the change size, so small syncs on big indexes hurt most. The
             // valve bounds WAL growth off-thread; runMaintenance at the end does
             // the final fold-up before the interval is restored in the finally.
-            // Same kill switch as indexAll: CODEGRAPH_NO_WAL_DEFER=1. Idle valve
+            // Same kill switch as indexAll: LATTICE_SENSOR_NO_WAL_DEFER=1. Idle valve
             // cost is one timer, so watcher-frequency syncs stay cheap.
-            const deferWal = process.env.CODEGRAPH_NO_WAL_DEFER !== '1' && this.db.getJournalMode() === 'wal';
+            const deferWal = process.env.LATTICE_SENSOR_NO_WAL_DEFER !== '1' && this.db.getJournalMode() === 'wal';
             let walValve = null;
             let priorAutocheckpoint = 1000;
             if (deferWal) {
@@ -733,7 +733,7 @@ class CodeGraph {
                         // Scope resolution to changed files (git fast path — bounded set)
                         const tRefLoad = Date.now();
                         const unresolvedRefs = this.queries.getUnresolvedReferencesByFiles(result.changedFilePaths);
-                        if (process.env.CODEGRAPH_SYNTH_TIMINGS)
+                        if (process.env.LATTICE_SENSOR_SYNTH_TIMINGS)
                             console.error(`[phase-timing] sync-ref-load: ${Date.now() - tRefLoad}ms (${unresolvedRefs.length} refs)`);
                         options.onProgress?.({
                             phase: 'resolving',
@@ -771,7 +771,7 @@ class CodeGraph {
                                 total: retryable.length,
                             });
                         }
-                        if (process.env.CODEGRAPH_SYNTH_TIMINGS)
+                        if (process.env.LATTICE_SENSOR_SYNTH_TIMINGS)
                             console.error(`[phase-timing] sync-failed-ref-retry: ${Date.now() - tRetry}ms (${retryable.length} refs)`);
                     }
                     else {
@@ -808,7 +808,7 @@ class CodeGraph {
                 // status='failed' for the #1240 retry above), so any pending row now
                 // is such an orphan — or a row from an older engine's scoped pass.
                 // Grind them down with the batched resolver; this also makes a bare
-                // `codegraph sync` the recovery command for a wedged index. On a
+                // `lattice sensor sync` the recovery command for a wedged index. On a
                 // healthy index this is one COUNT query.
                 const orphanCount = this.queries.getUnresolvedReferencesCount();
                 if (orphanCount > 0) {
@@ -976,7 +976,7 @@ class CodeGraph {
     /**
      * Most recent index timestamp (ms since epoch) across all tracked files, or
      * null when nothing is indexed yet. Lets library consumers check index
-     * freshness without shelling out to `codegraph status --json`. (#329)
+     * freshness without shelling out to `lattice sensor status --json`. (#329)
      */
     getLastIndexedAt() {
         return this.queries.getLastIndexedAt();
@@ -988,7 +988,7 @@ class CodeGraph {
      * `'partial'` means the run finished but silently dropped files
      * (discovered > indexed+skipped+errored); `'failed'` means it reported
      * failure. `null` = index predates this marker. Surfaced by
-     * `codegraph status`.
+     * `lattice sensor status`.
      */
     getIndexState() {
         const raw = this.queries.getMetadata('index_state');
@@ -1012,8 +1012,8 @@ class CodeGraph {
      * True when the on-disk index was built by an engine whose extraction is
      * older than the one now running — i.e. a re-index would add data a migration
      * can't backfill. False when there's no index yet (nothing to refresh) or the
-     * stamp is current. This is the signal behind `codegraph status`'s re-index
-     * hint and `codegraph upgrade`'s reminder.
+     * stamp is current. This is the signal behind `lattice sensor status`'s re-index
+     * hint and `lattice sensor upgrade`'s reminder.
      */
     isIndexStale() {
         if (this.queries.getLastIndexedAt() == null)
@@ -1097,8 +1097,8 @@ class CodeGraph {
     }
     /**
      * Active SQLite backend for this project's connection (`node-sqlite` — Node's
-     * built-in real-SQLite module). Surfaced via `codegraph status` and the
-     * `codegraph_status` MCP tool alongside the effective journal mode.
+     * built-in real-SQLite module). Surfaced via `lattice sensor status` and the
+     * `lattice_sensor_status` MCP tool alongside the effective journal mode.
      */
     getBackend() {
         return this.db.getBackend();
@@ -1107,7 +1107,7 @@ class CodeGraph {
      * The journal mode actually in effect ('wal', 'delete', …). 'wal' means
      * readers never block on a concurrent writer; anything else means they can,
      * which is the precondition for the "database is locked" failures in issue
-     * #238. Surfaced via `codegraph status` and the `codegraph_status` MCP tool.
+     * #238. Surfaced via `lattice sensor status` and the `lattice_sensor_status` MCP tool.
      */
     getJournalMode() {
         return this.db.getJournalMode();
@@ -1215,7 +1215,7 @@ class CodeGraph {
             const singleWordVariants = variants.filter((v) => variantToWord.get(v).length >= 5);
             const counts = this.queries.getSegmentNameCounts(singleWordVariants);
             const rare = [...counts.entries()]
-                .filter(([, n]) => n >= 2 && n <= CodeGraph.SEGMENT_RARITY_CEILING)
+                .filter(([, n]) => n >= 2 && n <= LatticeSensor.SEGMENT_RARITY_CEILING)
                 .sort((a, b) => a[1] - b[1])
                 .slice(0, 2);
             for (const [variant] of rare) {
@@ -1347,9 +1347,9 @@ class CodeGraph {
      * Find the project's "primary route file" — the file with the densest
      * concentration of framework-emitted `route` nodes (≥3 routes, ≥30%
      * of all non-test routes). Used to inline the routing config in
-     * `codegraph_explore` responses on small realworld template repos
+     * `lattice_sensor_explore` responses on small realworld template repos
      * (rails-realworld, laravel-realworld, drupal-admintoolbar, …) where
-     * Glob+Read of `routes.rb`/`urls.py`/etc. otherwise beats codegraph.
+     * Glob+Read of `routes.rb`/`urls.py`/etc. otherwise beats lattice sensor.
      */
     getTopRouteFile() {
         return this.queries.getTopRouteFile();
@@ -1630,17 +1630,17 @@ class CodeGraph {
         this.close();
     }
     /**
-     * Completely remove CodeGraph from the project.
-     * This closes the database and deletes the .CodeGraph directory.
+     * Completely remove LatticeSensor from the project.
+     * This closes the database and deletes the .LatticeSensor directory.
      *
-     * WARNING: This permanently deletes all CodeGraph data for the project.
+     * WARNING: This permanently deletes all LatticeSensor data for the project.
      */
     uninitialize() {
         this.close();
         (0, directory_1.removeDirectory)(this.projectRoot);
     }
 }
-exports.CodeGraph = CodeGraph;
+exports.LatticeSensor = LatticeSensor;
 // Default export
-exports.default = CodeGraph;
+exports.default = LatticeSensor;
 //# sourceMappingURL=index.js.map