@quolu/lattice 0.1.0 → 0.12.2

package/sensor/dist/bin/{codegraph.js → lattice-sensor.js}

@@ -1,27 +1,27 @@
 #!/usr/bin/env node
 "use strict";
 /**
- * CodeGraph CLI
+ * LatticeSensor CLI
  *
- * Command-line interface for CodeGraph code intelligence.
+ * Command-line interface for LatticeSensor code intelligence.
  *
  * Usage:
- *   codegraph                    Run interactive installer (when no args)
- *   codegraph install            Run interactive installer
- *   codegraph uninstall          Remove CodeGraph from your agents
- *   codegraph init [path]        Initialize CodeGraph in a project
- *   codegraph uninit [path]      Remove CodeGraph from a project
- *   codegraph index [path]       Index all files in the project
- *   codegraph sync [path]        Sync changes since last index
- *   codegraph status [path]      Show index status
- *   codegraph query <search>     Search for symbols
- *   codegraph files [options]    Show project file structure
- *   codegraph context <task>     Build context for a task
- *   codegraph callers <symbol>   Find what calls a function/method
- *   codegraph callees <symbol>   Find what a function/method calls
- *   codegraph impact <symbol>    Analyze what code is affected by changing a symbol
- *   codegraph affected [files]   Find test files affected by changes
- *   codegraph upgrade [version]  Update CodeGraph to the latest release
+ *   lattice sensor                    Refuse: no standalone installer
+ *   lattice sensor install            Refuse: host wiring is owned by dotagents
+ *   lattice sensor uninstall          Refuse: retirement is owned by dotagents
+ *   lattice sensor init [path]        Initialize LatticeSensor in a project
+ *   lattice sensor uninit [path]      Remove LatticeSensor from a project
+ *   lattice sensor index [path]       Index all files in the project
+ *   lattice sensor sync [path]        Sync changes since last index
+ *   lattice sensor status [path]      Show index status
+ *   lattice sensor query <search>     Search for symbols
+ *   lattice sensor files [options]    Show project file structure
+ *   lattice sensor context <task>     Build context for a task
+ *   lattice sensor callers <symbol>   Find what calls a function/method
+ *   lattice sensor callees <symbol>   Find what a function/method calls
+ *   lattice sensor impact <symbol>    Analyze what code is affected by changing a symbol
+ *   lattice sensor affected [files]   Find test files affected by changes
+ *   lattice sensor upgrade [version]  Update LatticeSensor to the latest release
  */
 var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
     if (k2 === undefined) k2 = k;
@@ -75,6 +75,7 @@ const path = __importStar(require("path"));
 const fs = __importStar(require("fs"));
 const directory_1 = require("../directory");
 const identifier_segments_1 = require("../search/identifier-segments");
+const query_utils_1 = require("../search/query-utils");
 const worktree_1 = require("../sync/worktree");
 const shimmer_progress_1 = require("../ui/shimmer-progress");
 const glyphs_1 = require("../ui/glyphs");
@@ -88,18 +89,18 @@ const telemetry_1 = require("../telemetry");
 // Decided once, before `--color`/`--no-color` are stripped from argv below
 // (#1281). Piped/redirected stdout, NO_COLOR, or --no-color -> plain output.
 const COLORS_ENABLED = (0, color_1.ansiColorsEnabled)();
-// Lazy-load heavy modules (CodeGraph, runInstaller) to keep CLI startup fast.
-async function loadCodeGraph() {
+// Lazy-load heavy modules (LatticeSensor, runInstaller) to keep CLI startup fast.
+async function loadLatticeSensor() {
     try {
         return await Promise.resolve().then(() => __importStar(require('../index')));
     }
     catch (err) {
         const msg = err instanceof Error ? err.message : String(err);
         const [red, reset] = COLORS_ENABLED ? ['\x1b[31m', '\x1b[0m'] : ['', ''];
-        console.error(`${red}${(0, glyphs_1.getGlyphs)().err}${reset} Failed to load CodeGraph modules.`);
+        console.error(`${red}${(0, glyphs_1.getGlyphs)().err}${reset} Failed to load LatticeSensor modules.`);
         console.error(`\n  Node: ${process.version}  Platform: ${process.platform} ${process.arch}`);
         console.error(`\n  Error: ${msg}`);
-        console.error('\n  Try reinstalling with: npm install -g @colbymchenry/codegraph\n');
+        console.error('\n  Reinstall the owning package with: npm install -g @quolu/lattice@latest\n');
         process.exit(1);
     }
 }
@@ -107,7 +108,7 @@ async function loadCodeGraph() {
 // which fails for ESM-only packages. This bypasses the transformation.
 // eslint-disable-next-line @typescript-eslint/no-implied-eval
 const importESM = new Function('specifier', 'return import(specifier)');
-// Block CodeGraph on Node.js 25.x — V8's turboshaft WASM JIT has a Zone
+// Block LatticeSensor on Node.js 25.x — V8's turboshaft WASM JIT has a Zone
 // allocator bug that reliably crashes when compiling tree-sitter
 // grammars (see #54, #81, #140). The previous behaviour was a soft
 // console.warn that scrolls off-screen before the OOM crash 30 seconds
@@ -116,19 +117,19 @@ const importESM = new Function('specifier', 'return import(specifier)');
 // who patched V8 themselves or want to test a future fix.
 const nodeVersion = process.versions.node;
 const nodeMajor = parseInt(nodeVersion.split('.')[0] ?? '0', 10);
-if (nodeMajor >= 25) {
+if ((0, node_version_check_1.isNode25Affected)(nodeMajor)) {
     process.stderr.write((0, node_version_check_1.buildNode25BlockBanner)(nodeVersion) + '\n');
-    if (!process.env.CODEGRAPH_ALLOW_UNSAFE_NODE) {
+    if (!process.env.LATTICE_SENSOR_ALLOW_UNSAFE_NODE) {
         process.exit(1);
     }
     // Override active — banner shown for visibility, continuing.
 }
 // Enforce the supported Node floor. `engines` in package.json only *warns* on
 // install (unless engine-strict), so hard-block here to actually keep users off
-// unsupported versions. Mirrors the 25+ block above. See package.json `engines`.
+// unsupported versions. Mirrors the Node 25 block above. See package.json `engines`.
 if (nodeMajor < node_version_check_1.MIN_NODE_MAJOR) {
     process.stderr.write((0, node_version_check_1.buildNodeTooOldBanner)(nodeVersion) + '\n');
-    if (!process.env.CODEGRAPH_ALLOW_UNSAFE_NODE) {
+    if (!process.env.LATTICE_SENSOR_ALLOW_UNSAFE_NODE) {
         process.exit(1);
     }
     // Override active — banner shown for visibility, continuing.
@@ -145,12 +146,10 @@ if (nodeMajor < node_version_check_1.MIN_NODE_MAJOR) {
 // CPU core with no recovery (#799, #850). Installed before the command branch
 // so it also covers a synchronous throw during startup. See ./fatal-handler.
 (0, fatal_handler_1.installFatalHandlers)();
-// Check if running with no arguments - run installer
+// The absorbed sensor has no standalone installer. Lattice owns host wiring.
 if (process.argv.length === 2) {
-    Promise.resolve().then(() => __importStar(require('../installer'))).then(({ runInstaller }) => runInstaller()).catch((err) => {
-        console.error('Installation failed:', err instanceof Error ? err.message : String(err));
-        process.exit(1);
-    });
+    console.error('Lattice sensor requires an explicit command. Use `lattice sensor init|sync [path] --json`.');
+    process.exit(2);
 }
 else {
     // Normal CLI flow
@@ -164,8 +163,8 @@ function main() {
     // `--version` and `-V`; intercept the spellings it can't — lowercase `-v` and
     // single-dash `-version` — before any parsing. (commander's version short flag
     // is the capital `-V`, and its parser rejects a multi-character single-dash
-    // flag.) The bare `codegraph version` subcommand is registered further down so
-    // the affordance also shows up in `codegraph --help`.
+    // flag.) The bare `lattice sensor version` subcommand is registered further down so
+    // the affordance also shows up in `lattice sensor --help`.
     const firstArg = process.argv[2];
     if (firstArg === '-v' || firstArg === '-version') {
         console.log(packageJson.version);
@@ -215,7 +214,7 @@ function main() {
         gray: (s) => `${colors.gray}${s}${colors.reset}`,
     };
     program
-        .name('codegraph')
+        .name('lattice-sensor')
         .description('Code intelligence and knowledge graph for any codebase')
         .version(packageJson.version)
         // Parsed manually before commander runs (any argv position works); declared
@@ -234,7 +233,7 @@ function main() {
     program.hook('preAction', (_thisCommand, actionCommand) => {
         try {
             // The detached daemon re-invokes `serve --mcp` internally — not a user action.
-            if (process.env.CODEGRAPH_DAEMON_INTERNAL)
+            if (process.env.LATTICE_SENSOR_DAEMON_INTERNAL)
                 return;
             const name = actionCommand.name();
             if (name === 'telemetry')
@@ -252,17 +251,17 @@ function main() {
     // =============================================================================
     /**
      * Resolve project path from argument or current directory
-     * Walks up parent directories to find nearest initialized CodeGraph project
-     * (must have .codegraph/codegraph.db, not just .codegraph/lessons.db)
+     * Walks up parent directories to find nearest initialized LatticeSensor project
+     * (must have .lattice/sensor/sensor.db, not just .lattice/sensor/lessons.db)
      */
     function resolveProjectPath(pathArg) {
         const absolutePath = path.resolve(pathArg || process.cwd());
-        // If exact path is initialized (has codegraph.db), use it
+        // If exact path is initialized (has sensor.db), use it
         if ((0, directory_1.isInitialized)(absolutePath)) {
             return absolutePath;
         }
-        // Walk up to find nearest parent with CodeGraph initialized
-        // Note: findNearestCodeGraphRoot finds any .codegraph folder, but we need one with codegraph.db
+        // Walk up to find nearest parent with LatticeSensor initialized
+        // Note: findNearestLatticeSensorRoot finds any .lattice/sensor folder, but we need one with sensor.db
         let current = absolutePath;
         const root = path.parse(current).root;
         while (current !== root) {
@@ -421,14 +420,14 @@ function main() {
             clack.note(breakdown, 'Error breakdown');
             if (projectPath) {
                 writeErrorLog(projectPath, result.errors);
-                clack.log.info('See .codegraph/errors.log for details');
+                clack.log.info('See .lattice/sensor/errors.log for details');
             }
             if (result.filesIndexed > 0) {
                 clack.log.info(`The index is fully usable ${(0, glyphs_1.getGlyphs)().dash} only the failed files are missing.`);
             }
         }
         else if (projectPath) {
-            const logPath = path.join((0, directory_1.getCodeGraphDir)(projectPath), 'errors.log');
+            const logPath = path.join((0, directory_1.getLatticeSensorDir)(projectPath), 'errors.log');
             if (fs.existsSync(logPath)) {
                 fs.unlinkSync(logPath);
             }
@@ -440,7 +439,7 @@ function main() {
      * gitignores its child repos" layout (#1156), where `init` at the parent
      * correctly indexes ~nothing while `init` inside each child works — name those
      * repos and offer to index them. An interactive terminal gets a yes/no prompt
-     * that writes `includeIgnored` to codegraph.json and re-indexes; a
+     * that writes `includeIgnored` to lattice-sensor.json and re-indexes; a
      * non-interactive run just prints the one-line opt-in snippet. The caller gates
      * this on `nodesCreated === 0`, so a project that DID index real content is
      * never nagged about the gitignored reference clones it deliberately keeps out
@@ -497,10 +496,10 @@ function main() {
         return result;
     }
     /**
-     * Write detailed error log to .codegraph/errors.log
+     * Write detailed error log to .lattice/sensor/errors.log
      */
     function writeErrorLog(projectPath, errors) {
-        const cgDir = (0, directory_1.getCodeGraphDir)(projectPath);
+        const cgDir = (0, directory_1.getLatticeSensorDir)(projectPath);
         if (!fs.existsSync(cgDir))
             return;
         const logPath = path.join(cgDir, 'errors.log');
@@ -523,7 +522,7 @@ function main() {
             }
         }
         const lines = [
-            `CodeGraph Error Log - ${new Date().toISOString()}`,
+            `LatticeSensor Error Log - ${new Date().toISOString()}`,
             `${errorsByFile.size} files with errors`,
             '',
         ];
@@ -550,18 +549,18 @@ function main() {
     // Commands
     // =============================================================================
     /**
-     * codegraph init [path]
+     * lattice sensor init [path]
      */
     program
         .command('init [path]')
-        .description('Initialize CodeGraph in a project directory and build the initial index')
+        .description('Initialize LatticeSensor in a project directory and build the initial index')
         .option('-i, --index', 'Deprecated: indexing now runs by default; flag accepted for backward compatibility')
         .option('-f, --force', 'Initialize even if the path looks like your home directory or a filesystem root')
         .option('-v, --verbose', 'Show detailed worker lifecycle and memory info')
         .action(async (pathArg, options) => {
         const projectPath = path.resolve(pathArg || process.cwd());
         const clack = await importESM('@clack/prompts');
-        clack.intro('Initializing CodeGraph');
+        clack.intro('Initializing LatticeSensor');
         try {
             // Refuse to index your home directory / a filesystem root — it pulls in
             // caches, other projects, and your whole tree (a multi-GB index + watcher
@@ -576,17 +575,12 @@ function main() {
             }
             if ((0, directory_1.isInitialized)(projectPath)) {
                 clack.log.warn(`Already initialized in ${projectPath}`);
-                clack.log.info('Use "codegraph index" to re-index or "codegraph sync" to update');
-                try {
-                    const { offerWatchFallback } = await Promise.resolve().then(() => __importStar(require('../installer')));
-                    await offerWatchFallback(clack, projectPath);
-                }
-                catch { /* non-fatal */ }
+                clack.log.info('Use "lattice sensor init" to re-index or "lattice sensor sync" to update');
                 clack.outro('');
                 return;
             }
-            const { default: CodeGraph, getDatabasePath } = await loadCodeGraph();
-            const cg = await CodeGraph.init(projectPath, { index: false });
+            const { default: LatticeSensor, getDatabasePath } = await loadLatticeSensor();
+            const cg = await LatticeSensor.init(projectPath, { index: false });
             clack.log.success(`Initialized in ${projectPath}`);
             // Indexing runs by default now. The legacy -i/--index flag is still
             // accepted (so existing muscle memory and scripts don't break) but is a
@@ -622,11 +616,6 @@ function main() {
             if (result.nodesCreated === 0) {
                 await offerIndexIgnoredRepos(clack, projectPath, runIndex, { interactive: true });
             }
-            try {
-                const { offerWatchFallback } = await Promise.resolve().then(() => __importStar(require('../installer')));
-                await offerWatchFallback(clack, projectPath);
-            }
-            catch { /* non-fatal */ }
             clack.outro('Done');
             cg.destroy();
         }
@@ -636,17 +625,17 @@ function main() {
         }
     });
     /**
-     * codegraph uninit [path]
+     * lattice sensor uninit [path]
      */
     program
         .command('uninit [path]')
-        .description('Remove CodeGraph from a project (deletes .codegraph/ directory)')
+        .description('Remove LatticeSensor from a project (deletes .lattice/sensor/ directory)')
         .option('-f, --force', 'Skip confirmation prompt')
         .action(async (pathArg, options) => {
         const projectPath = resolveProjectPath(pathArg);
         try {
             if (!(0, directory_1.isInitialized)(projectPath)) {
-                warn(`CodeGraph is not initialized in ${projectPath}`);
+                warn(`LatticeSensor is not initialized in ${projectPath}`);
                 return;
             }
             if (!options.force) {
@@ -654,7 +643,7 @@ function main() {
                 const readline = await Promise.resolve().then(() => __importStar(require('readline')));
                 const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
                 const answer = await new Promise((resolve) => {
-                    rl.question(chalk.yellow(`${(0, glyphs_1.getGlyphs)().warn} This will permanently delete all CodeGraph data. Continue? (y/N) `), resolve);
+                    rl.question(chalk.yellow(`${(0, glyphs_1.getGlyphs)().warn} This will permanently delete all LatticeSensor data. Continue? (y/N) `), resolve);
                 });
                 rl.close();
                 if (answer.toLowerCase() !== 'y') {
@@ -662,8 +651,8 @@ function main() {
                     return;
                 }
             }
-            const { default: CodeGraph } = await loadCodeGraph();
-            const cg = CodeGraph.openSync(projectPath);
+            const { default: LatticeSensor } = await loadLatticeSensor();
+            const cg = LatticeSensor.openSync(projectPath);
             cg.uninitialize();
             // Clean up any git sync hooks we installed (no-op if none / not a repo).
             try {
@@ -674,7 +663,7 @@ function main() {
                 }
             }
             catch { /* non-fatal */ }
-            success(`Removed CodeGraph from ${projectPath}`);
+            success(`Removed LatticeSensor from ${projectPath}`);
             // Churn signal — and flush now, since after an uninit there may be no
             // "next run" to deliver it.
             try {
@@ -689,7 +678,7 @@ function main() {
         }
     });
     /**
-     * codegraph index [path]
+     * lattice sensor index [path]
      */
     program
         .command('index [path]')
@@ -708,13 +697,13 @@ function main() {
                 process.exit(1);
             }
             if (!(0, directory_1.isInitialized)(projectPath)) {
-                error(`CodeGraph not initialized in ${projectPath}`);
-                info('Run "codegraph init" first');
+                error(`LatticeSensor not initialized in ${projectPath}`);
+                info('Run "lattice sensor init" first');
                 process.exit(1);
             }
-            const { default: CodeGraph, getDatabasePath } = await loadCodeGraph();
+            const { default: LatticeSensor, getDatabasePath } = await loadLatticeSensor();
             // `index` is a FULL re-index — identical to a fresh `init`. RECREATE the
-            // database from scratch (discard .codegraph/codegraph.db + its WAL) rather
+            // database from scratch (discard .lattice/sensor/sensor.db + its WAL) rather
             // than opening the old graph and DELETE-ing every row. The clear-then-index
             // approach reported "0 nodes" without the clear (#874); the recreate keeps
             // that fixed AND avoids the failure mode where, on a large or pre-fix
@@ -722,7 +711,7 @@ function main() {
             // enough to trip the liveness watchdog before scanning even began (#1067).
             // recreate() hands back a fresh, empty instance — no clear() needed. For
             // fast incremental updates use `sync`.
-            const cg = await CodeGraph.recreate(projectPath);
+            const cg = await LatticeSensor.recreate(projectPath);
             // Supervise the indexer: self-terminate if orphaned (parent shim killed)
             // or if the main thread wedges — neither was guarded on this path (#999).
             // The DB + WAL paths let the liveness watchdog tell a slow store on
@@ -777,7 +766,7 @@ function main() {
         }
     });
     /**
-     * codegraph sync [path]
+     * lattice sensor sync [path]
      */
     program
         .command('sync [path]')
@@ -788,19 +777,19 @@ function main() {
         try {
             if (!(0, directory_1.isInitialized)(projectPath)) {
                 if (!options.quiet) {
-                    error(`CodeGraph not initialized in ${projectPath}`);
+                    error(`LatticeSensor not initialized in ${projectPath}`);
                 }
                 process.exit(1);
             }
-            const { default: CodeGraph } = await loadCodeGraph();
-            const cg = await CodeGraph.open(projectPath);
+            const { default: LatticeSensor } = await loadLatticeSensor();
+            const cg = await LatticeSensor.open(projectPath);
             if (options.quiet) {
                 await cg.sync();
                 cg.destroy();
                 return;
             }
             const clack = await importESM('@clack/prompts');
-            clack.intro('Syncing CodeGraph');
+            clack.intro('Syncing LatticeSensor');
             process.stdout.write(`${colors.dim}${(0, glyphs_1.getGlyphs)().rail}${colors.reset}\n`);
             const progress = (0, shimmer_progress_1.createShimmerProgress)();
             const result = await cg.sync({
@@ -833,7 +822,7 @@ function main() {
         }
     });
     /**
-     * codegraph status [path]
+     * lattice sensor status [path]
      */
     program
         .command('status [path]')
@@ -853,19 +842,19 @@ function main() {
                         initialized: false,
                         version: packageJson.version,
                         projectPath,
-                        indexPath: (0, directory_1.getCodeGraphDir)(projectPath),
+                        indexPath: (0, directory_1.getLatticeSensorDir)(projectPath),
                         lastIndexed: null,
                     }));
                     return;
                 }
-                console.log(chalk.bold('\nCodeGraph Status\n'));
+                console.log(chalk.bold('\nLatticeSensor Status\n'));
                 info(`Project: ${projectPath}`);
                 warn('Not initialized');
-                info('Run "codegraph init" to initialize');
+                info('Run "lattice sensor init" to initialize');
                 return;
             }
-            const { default: CodeGraph } = await loadCodeGraph();
-            const cg = await CodeGraph.open(projectPath);
+            const { default: LatticeSensor } = await loadLatticeSensor();
+            const cg = await LatticeSensor.open(projectPath);
             const stats = cg.getStats();
             const changes = cg.getChangedFiles();
             const backend = cg.getBackend();
@@ -883,7 +872,7 @@ function main() {
                     initialized: true,
                     version: packageJson.version,
                     projectPath,
-                    indexPath: (0, directory_1.getCodeGraphDir)(projectPath),
+                    indexPath: (0, directory_1.getLatticeSensorDir)(projectPath),
                     lastIndexed: lastIndexedMs != null ? new Date(lastIndexedMs).toISOString() : null,
                     fileCount: stats.fileCount,
                     nodeCount: stats.nodeCount,
@@ -919,23 +908,23 @@ function main() {
                 cg.destroy();
                 return;
             }
-            console.log(chalk.bold('\nCodeGraph Status\n'));
+            console.log(chalk.bold('\nLatticeSensor Status\n'));
             // Project info
             console.log(chalk.cyan('Project:'), projectPath);
             if (worktreeMismatch) {
                 warn((0, worktree_1.worktreeMismatchWarning)(worktreeMismatch));
             }
             if (indexState === 'indexing') {
-                warn('The last index run never finished (killed mid-index?) — the index is truncated. Re-run "codegraph index".');
+                warn('The last index run never finished (killed mid-index?) — the index is truncated. Re-run "lattice sensor index".');
             }
             else if (indexState === 'partial') {
-                warn('The last index run silently dropped files — the index is partial. Re-run "codegraph index".');
+                warn('The last index run silently dropped files — the index is partial. Re-run "lattice sensor index".');
             }
             else if (indexState === 'failed') {
-                warn('The last index run failed — results may be incomplete. Re-run "codegraph index".');
+                warn('The last index run failed — results may be incomplete. Re-run "lattice sensor index".');
             }
             if (pendingRefs > 0) {
-                warn(`${formatNumber(pendingRefs)} references from an interrupted run are awaiting resolution — some callers/impact edges are missing. Run "codegraph sync" to resolve them.`);
+                warn(`${formatNumber(pendingRefs)} references from an interrupted run are awaiting resolution — some callers/impact edges are missing. Run "lattice sensor sync" to resolve them.`);
             }
             console.log();
             // Index stats
@@ -988,7 +977,7 @@ function main() {
                 if (changes.removed.length > 0) {
                     console.log(`  Removed:   ${changes.removed.length} files`);
                 }
-                info('Run "codegraph sync" to update the index');
+                info('Run "lattice sensor sync" to update the index');
             }
             else {
                 success('Index is up to date');
@@ -999,7 +988,7 @@ function main() {
             if (reindexRecommended) {
                 const builtWith = buildInfo.version ? `v${buildInfo.version.replace(/^v/, '')}` : 'an earlier version';
                 warn(`Index was built by ${builtWith}; re-index to pick up this engine's improvements.`);
-                info('Run "codegraph index" (full rebuild) or "codegraph sync"');
+                info('Run "lattice sensor index" (full rebuild) or "lattice sensor sync"');
                 console.log();
             }
             cg.destroy();
@@ -1010,7 +999,7 @@ function main() {
         }
     });
     /**
-     * codegraph query <search>
+     * lattice sensor query <search>
      */
     program
         .command('query <search>')
@@ -1023,11 +1012,11 @@ function main() {
         const projectPath = resolveProjectPath(options.path);
         try {
             if (!(0, directory_1.isInitialized)(projectPath)) {
-                error(`CodeGraph not initialized in ${projectPath}`);
+                error(`LatticeSensor not initialized in ${projectPath}`);
                 process.exit(1);
             }
-            const { default: CodeGraph } = await loadCodeGraph();
-            const cg = await CodeGraph.open(projectPath);
+            const { default: LatticeSensor } = await loadLatticeSensor();
+            const cg = await LatticeSensor.open(projectPath);
             const limit = parseInt(options.limit || '10', 10);
             const rawResults = cg.searchNodes(search, {
                 limit,
@@ -1077,9 +1066,9 @@ function main() {
         }
     });
     /**
-     * codegraph explore <query...>
+     * lattice sensor explore <query...>
      *
-     * The CLI face of the MCP codegraph_explore tool — same handler, same
+     * The CLI face of the MCP lattice_sensor_explore tool — same handler, same
      * output (source of the relevant symbols grouped by file + the call path
      * among them). Exists so agents WITHOUT the MCP tools — Task-tool
      * subagents (which don't inherit MCP tools, #704) and non-MCP harnesses —
@@ -1087,24 +1076,24 @@ function main() {
      */
     program
         .command('explore <query...>')
-        .description('Explore an area: relevant symbols\' source + call paths in one shot (same output as the codegraph_explore MCP tool)')
+        .description('Explore an area: relevant symbols\' source + call paths in one shot (same output as the lattice_sensor_explore MCP tool)')
         .option('-p, --path <path>', 'Project path')
         .option('--max-files <number>', 'Maximum number of files to include source from')
         .action(async (queryParts, options) => {
         const projectPath = resolveProjectPath(options.path);
         try {
             if (!(0, directory_1.isInitialized)(projectPath)) {
-                error(`CodeGraph isn't available here — no .codegraph/ index exists in ${projectPath}. If you are an AI agent: continue with your usual tools; indexing is the user's decision, do not run it yourself. (The project owner can enable CodeGraph with 'codegraph init'.)`);
+                error(`LatticeSensor isn't available here — no .lattice/sensor/ index exists in ${projectPath}. If you are an AI agent: continue with your usual tools; indexing is the user's decision, do not run it yourself. (The project owner can enable LatticeSensor with 'lattice sensor init'.)`);
                 process.exit(1);
             }
-            const { default: CodeGraph } = await loadCodeGraph();
-            const cg = await CodeGraph.open(projectPath);
+            const { default: LatticeSensor } = await loadLatticeSensor();
+            const cg = await LatticeSensor.open(projectPath);
             const { ToolHandler } = await Promise.resolve().then(() => __importStar(require('../mcp/tools')));
             const handler = new ToolHandler(cg);
             const args = { query: queryParts.join(' ') };
             if (options.maxFiles)
                 args.maxFiles = parseInt(options.maxFiles, 10);
-            const result = await handler.execute('codegraph_explore', args);
+            const result = await handler.execute('lattice_sensor_explore', args);
             console.log(result.content[0]?.text ?? '');
             cg.destroy();
             if (result.isError)
@@ -1116,13 +1105,13 @@ function main() {
         }
     });
     /**
-     * codegraph prompt-hook  (hidden)
+     * lattice sensor prompt-hook  (hidden)
      *
      * A Claude Code `UserPromptSubmit` hook entry point. Reads `{prompt, cwd}` JSON
-     * on stdin; for a structural/flow/impact prompt it runs `codegraph_explore` on
+     * on stdin; for a structural/flow/impact prompt it runs `lattice_sensor_explore` on
      * the indexed project and prints the result to stdout, which Claude injects into
      * the agent's context — so the agent's reflex grep/read has nothing left to find
-     * and reliably uses CodeGraph (the adoption problem). Installed by the installer
+     * and reliably uses LatticeSensor (the adoption problem). Installed by the installer
      * into Claude's settings.json (opt-in, default-yes).
      *
      * LOAD-BEARING: this must NEVER break the user's prompt. Every failure path —
@@ -1131,12 +1120,12 @@ function main() {
      */
     program
         .command('prompt-hook', { hidden: true })
-        .description('Claude UserPromptSubmit hook: inject CodeGraph context for structural prompts (reads {prompt,cwd} JSON on stdin)')
+        .description('Claude UserPromptSubmit hook: inject LatticeSensor context for structural prompts (reads {prompt,cwd} JSON on stdin)')
         .action(async () => {
         try {
             // Kill-switch: lets a user disable the nudge without uninstalling /
             // editing settings.json (CI, low-power machines, personal preference).
-            if (process.env.CODEGRAPH_NO_PROMPT_HOOK === '1' || process.env.CODEGRAPH_PROMPT_HOOK === '0')
+            if (process.env.LATTICE_SENSOR_NO_PROMPT_HOOK === '1' || process.env.LATTICE_SENSOR_PROMPT_HOOK === '0')
                 return;
             if (process.stdin.isTTY)
                 return; // invoked by hand, no piped payload
@@ -1197,12 +1186,12 @@ function main() {
                 return;
             } // nothing reachable — the agent's normal tools apply
             // A "pass projectPath" line for indexed sub-projects we did NOT front-load.
-            // Follow-up codegraph_explore calls against a sub-project (cwd isn't its
+            // Follow-up lattice_sensor_explore calls against a sub-project (cwd isn't its
             // index root) need an explicit projectPath, so spell it out.
             const nudge = (projects, lead) => `${lead}\n${projects.map((p) => `  - projectPath: "${p}"`).join('\n')}\n`;
             if (plan.exploreRoot) {
-                const { default: CodeGraph } = await loadCodeGraph();
-                const cg = await CodeGraph.open(plan.exploreRoot);
+                const { default: LatticeSensor } = await loadLatticeSensor();
+                const cg = await LatticeSensor.open(plan.exploreRoot);
                 try {
                     const others = plan.nudgeProjects.length
                         ? `\n${nudge(plan.nudgeProjects, 'Other indexed projects in this workspace — pass projectPath to query them:')}`
@@ -1215,17 +1204,17 @@ function main() {
                     if (keyworded || tokenVerified) {
                         const { ToolHandler } = await Promise.resolve().then(() => __importStar(require('../mcp/tools')));
                         const handler = new ToolHandler(cg);
-                        const result = await handler.execute('codegraph_explore', { query: prompt });
+                        const result = await handler.execute('lattice_sensor_explore', { query: prompt });
                         const text = result.content[0]?.text ?? '';
                         if (!result.isError && text.trim()) {
                             // Cap the injection so a large-repo explore can't flood the prompt.
                             const MAX = 16000;
-                            const body = text.length > MAX ? `${text.slice(0, MAX)}\n…(truncated; call codegraph_explore for the rest)` : text;
+                            const body = text.length > MAX ? `${text.slice(0, MAX)}\n…(truncated; call lattice_sensor_explore for the rest)` : text;
                             // For a front-loaded SUB-project, a follow-up explore needs its path.
                             const more = plan.viaSubScan
-                                ? `call codegraph_explore with projectPath: "${plan.exploreRoot}" for more`
-                                : 'call codegraph_explore for more';
-                            process.stdout.write(`<codegraph_context note="Structural context from CodeGraph for this prompt — treat returned source as already read; ${more}.">\n${body}${others}\n</codegraph_context>\n`);
+                                ? `call lattice_sensor_explore with projectPath: "${plan.exploreRoot}" for more`
+                                : 'call lattice_sensor_explore for more';
+                            process.stdout.write(`<lattice_sensor_context note="Structural context from LatticeSensor for this prompt — treat returned source as already read; ${more}.">\n${body}${others}\n</lattice_sensor_context>\n`);
                             gate(keyworded ? 'high-keyword' : 'high-token');
                         }
                         else {
@@ -1264,11 +1253,11 @@ function main() {
                         .join('\n');
                     const exampleQuery = related.slice(0, 3).map((m) => m.name).join(' ');
                     const projectHint = plan.viaSubScan ? ` with projectPath: "${plan.exploreRoot}"` : '';
-                    process.stdout.write(`<codegraph_context note="CodeGraph found indexed symbols matching this prompt — query the graph before searching files.">\n` +
-                        `This project's CodeGraph index contains symbols matching this request:\n${lines}\n` +
-                        `Call codegraph_explore ONCE${projectHint} with the relevant names in one query (e.g. "${exampleQuery}") ` +
+                    process.stdout.write(`<lattice_sensor_context note="LatticeSensor found indexed symbols matching this prompt — query the graph before searching files.">\n` +
+                        `This project's LatticeSensor index contains symbols matching this request:\n${lines}\n` +
+                        `Call lattice_sensor_explore ONCE${projectHint} with the relevant names in one query (e.g. "${exampleQuery}") ` +
                         `to get their source, call paths, and blast radius — cheaper and more complete than Read/Grep.\n${others}` +
-                        `</codegraph_context>\n`);
+                        `</lattice_sensor_context>\n`);
                     gate('medium-segment');
                 }
                 finally {
@@ -1278,9 +1267,9 @@ function main() {
             else {
                 // Several indexed sub-projects, none a clear match — don't guess; tell
                 // the agent they exist and how to query one.
-                process.stdout.write(`<codegraph_context note="CodeGraph is available for this workspace's indexed sub-projects — query one by passing projectPath to codegraph_explore.">\n` +
-                    nudge(plan.nudgeProjects, "This workspace's CodeGraph indexes live in sub-projects. To use CodeGraph, call codegraph_explore with the projectPath of the relevant one:") +
-                    `</codegraph_context>\n`);
+                process.stdout.write(`<lattice_sensor_context note="LatticeSensor is available for this workspace's indexed sub-projects — query one by passing projectPath to lattice_sensor_explore.">\n` +
+                    nudge(plan.nudgeProjects, "This workspace's LatticeSensor indexes live in sub-projects. To use LatticeSensor, call lattice_sensor_explore with the projectPath of the relevant one:") +
+                    `</lattice_sensor_context>\n`);
                 gate('nudge-projects');
             }
         }
@@ -1289,18 +1278,18 @@ function main() {
         }
     });
     /**
-     * codegraph node [name]
+     * lattice sensor node [name]
      *
-     * The CLI face of the MCP codegraph_node tool: one symbol's source +
+     * The CLI face of the MCP lattice_sensor_node tool: one symbol's source +
      * caller/callee trail, or a whole file with line numbers + dependents
      * (Read-parity). Same subagent/non-MCP rationale as `explore`.
      *
      * `name` is OPTIONAL because `--file` (file-read mode) carries no symbol —
-     * a required `<name>` made `codegraph node -f <file>` unreachable (#1044).
+     * a required `<name>` made `lattice sensor node -f <file>` unreachable (#1044).
      */
     program
         .command('node [name]')
-        .description('One symbol\'s source + caller/callee trail, or read a file with line numbers + dependents (same output as the codegraph_node MCP tool)')
+        .description('One symbol\'s source + caller/callee trail, or read a file with line numbers + dependents (same output as the lattice_sensor_node MCP tool)')
         .option('-p, --path <path>', 'Project path')
         .option('-f, --file <file>', 'Treat as file mode (or disambiguate a symbol to this file)')
         .option('--offset <number>', 'File mode: 1-based start line')
@@ -1308,20 +1297,20 @@ function main() {
         .option('--symbols-only', 'File mode: just the symbol map + dependents')
         .action(async (name, options) => {
         // Need a symbol (positional) OR a file (--file / a path-like positional).
-        // With [name] optional, a bare `codegraph node` reaches here with neither
+        // With [name] optional, a bare `lattice sensor node` reaches here with neither
         // and must be told what to pass, rather than crashing downstream.
         if (!name && !options.file) {
-            error("Pass a symbol name (e.g. 'codegraph node parseToken') or a file (e.g. 'codegraph node -f src/auth.ts', or 'codegraph node src/auth.ts').");
+            error("Pass a symbol name (e.g. 'lattice sensor node parseToken') or a file (e.g. 'lattice sensor node -f src/auth.ts', or 'lattice sensor node src/auth.ts').");
             process.exit(1);
         }
         const projectPath = resolveProjectPath(options.path);
         try {
             if (!(0, directory_1.isInitialized)(projectPath)) {
-                error(`CodeGraph isn't available here — no .codegraph/ index exists in ${projectPath}. If you are an AI agent: continue with your usual tools; indexing is the user's decision, do not run it yourself. (The project owner can enable CodeGraph with 'codegraph init'.)`);
+                error(`LatticeSensor isn't available here — no .lattice/sensor/ index exists in ${projectPath}. If you are an AI agent: continue with your usual tools; indexing is the user's decision, do not run it yourself. (The project owner can enable LatticeSensor with 'lattice sensor init'.)`);
                 process.exit(1);
             }
-            const { default: CodeGraph } = await loadCodeGraph();
-            const cg = await CodeGraph.open(projectPath);
+            const { default: LatticeSensor } = await loadLatticeSensor();
+            const cg = await LatticeSensor.open(projectPath);
             const { ToolHandler } = await Promise.resolve().then(() => __importStar(require('../mcp/tools')));
             const handler = new ToolHandler(cg);
             // A name with a path separator is a file read; otherwise a symbol
@@ -1354,7 +1343,7 @@ function main() {
                 args.limit = parseInt(options.limit, 10);
             if (options.symbolsOnly)
                 args.symbolsOnly = true;
-            const result = await handler.execute('codegraph_node', args);
+            const result = await handler.execute('lattice_sensor_node', args);
             console.log(result.content[0]?.text ?? '');
             cg.destroy();
             if (result.isError)
@@ -1366,7 +1355,7 @@ function main() {
         }
     });
     /**
-     * codegraph files [path]
+     * lattice sensor files [path]
      */
     program
         .command('files')
@@ -1382,14 +1371,14 @@ function main() {
         const projectPath = resolveProjectPath(options.path);
         try {
             if (!(0, directory_1.isInitialized)(projectPath)) {
-                error(`CodeGraph not initialized in ${projectPath}`);
+                error(`LatticeSensor not initialized in ${projectPath}`);
                 process.exit(1);
             }
-            const { default: CodeGraph } = await loadCodeGraph();
-            const cg = await CodeGraph.open(projectPath);
+            const { default: LatticeSensor } = await loadLatticeSensor();
+            const cg = await LatticeSensor.open(projectPath);
             let files = cg.getFiles();
             if (files.length === 0) {
-                info('No files indexed. Run "codegraph index" first.');
+                info('No files indexed. Run "lattice sensor index" first.');
                 cg.destroy();
                 return;
             }
@@ -1474,9 +1463,9 @@ function main() {
     });
     /**
      * Normalize a user-supplied file path to the project-relative, forward-slash
-     * form CodeGraph stores in the index. Accepts an absolute path, a `./`-prefixed
+     * form LatticeSensor stores in the index. Accepts an absolute path, a `./`-prefixed
      * path, or Windows back-slashes; an empty string when the input is blank. Used
-     * by `codegraph affected` so `./src/x.ts`, `/abs/repo/src/x.ts`, and
+     * by `lattice sensor affected` so `./src/x.ts`, `/abs/repo/src/x.ts`, and
      * `src/x.ts` all match the same indexed file. (#825)
      */
     function normalizeIndexPath(filePath, projectPath) {
@@ -1553,20 +1542,20 @@ function main() {
         renderNode(root, '', true, 0);
     }
     /**
-     * codegraph daemon — interactive manager for the background daemons. Arrow keys
+     * lattice sensor daemon — interactive manager for the background daemons. Arrow keys
      * to pick one (the current project's daemon floats to the top, auto-selected),
      * enter to stop it. Falls back to a plain list when output isn't a TTY.
      */
     program
         .command('daemon')
         .aliases(['daemons'])
-        .description('Manage running CodeGraph background daemons — pick one and press enter to stop it')
+        .description('Manage running LatticeSensor background daemons — pick one and press enter to stop it')
         .action(async () => {
         const { listDaemons, stopDaemonAt, stopAllDaemons } = await Promise.resolve().then(() => __importStar(require('../mcp/daemon-registry')));
         const { runDaemonPicker } = await Promise.resolve().then(() => __importStar(require('../mcp/daemon-manager')));
         const daemons = listDaemons();
         if (daemons.length === 0) {
-            info('No CodeGraph daemons running.');
+            info('No LatticeSensor daemons running.');
             return;
         }
         // No TTY (piped / CI / non-interactive) — can't do arrow-key selection, so
@@ -1579,7 +1568,7 @@ function main() {
         }
         // The current project's daemon floats to the top and is pre-selected.
         let cwdRoot = null;
-        const found = (0, directory_1.findNearestCodeGraphRoot)(process.cwd());
+        const found = (0, directory_1.findNearestLatticeSensorRoot)(process.cwd());
         if (found) {
             try {
                 cwdRoot = fs.realpathSync(found);
@@ -1589,7 +1578,7 @@ function main() {
             }
         }
         const clack = await importESM('@clack/prompts');
-        clack.intro('CodeGraph daemons');
+        clack.intro('LatticeSensor daemons');
         await runDaemonPicker({
             list: listDaemons,
             stop: stopDaemonAt,
@@ -1603,7 +1592,7 @@ function main() {
         });
     });
     /**
-     * codegraph serve
+     * lattice sensor serve
      */
     program
         // Hidden from `--help`: this is the stdio entry point an AI agent launches
@@ -1612,7 +1601,7 @@ function main() {
         // invoked — hiding only removes it from the listing. See the interactive-TTY
         // guard below, which explains this to anyone who runs it by hand.
         .command('serve', { hidden: true })
-        .description('Start CodeGraph as an MCP server for AI assistants')
+        .description('Start LatticeSensor as an MCP server for AI assistants')
         .option('-p, --path <path>', 'Project path (optional for MCP mode, uses rootUri from client)')
         .option('--mcp', 'Run as MCP server (stdio transport)')
         .option('--no-watch', 'Disable the file watcher (no auto-sync; useful on slow filesystems like WSL2 /mnt drives)')
@@ -1621,7 +1610,7 @@ function main() {
         // Commander sets watch=false when --no-watch is passed. Route it through
         // the same env-var chokepoint the watcher and MCP server already honor.
         if (options.watch === false) {
-            process.env.CODEGRAPH_NO_WATCH = '1';
+            process.env.LATTICE_SENSOR_NO_WATCH = '1';
         }
         try {
             if (options.mcp) {
@@ -1631,13 +1620,13 @@ function main() {
                 // stdin is an interactive TTY, explain instead of hanging. The agent's
                 // pipe and the detached daemon both have a non-TTY stdin, so this only
                 // ever fires for a person who typed it.
-                if (process.stdin.isTTY && !process.env.CODEGRAPH_DAEMON_INTERNAL) {
-                    console.error(chalk.bold('\nCodeGraph MCP server\n'));
+                if (process.stdin.isTTY && !process.env.LATTICE_SENSOR_DAEMON_INTERNAL) {
+                    console.error(chalk.bold('\nLatticeSensor MCP server\n'));
                     console.error("This is the MCP server your AI agent (Claude Code, Cursor, Codex, opencode, …)");
                     console.error("starts automatically — you don't run it yourself.");
-                    console.error(`\nIt's already wired up by ${chalk.cyan('codegraph install')}. To check on things:`);
-                    console.error(`  ${chalk.cyan('codegraph status')}   ${chalk.dim('— is this project indexed and healthy?')}`);
-                    console.error(`  ${chalk.cyan('codegraph daemon')}   ${chalk.dim('— list or stop background MCP servers')}`);
+                    console.error(`\nIt's already wired up by ${chalk.cyan('lattice sensor install')}. To check on things:`);
+                    console.error(`  ${chalk.cyan('lattice sensor status')}   ${chalk.dim('— is this project indexed and healthy?')}`);
+                    console.error(`  ${chalk.cyan('lattice sensor daemon')}   ${chalk.dim('— list or stop background MCP servers')}`);
                     console.error(chalk.dim('\n(Running it directly only does something when an MCP client drives it over stdin.)'));
                     return;
                 }
@@ -1650,28 +1639,28 @@ function main() {
             else {
                 // Default: show info about MCP mode.
                 // Use stderr so stdout stays clean for any piped/stdio usage.
-                console.error(chalk.bold('\nCodeGraph MCP Server\n'));
+                console.error(chalk.bold('\nLatticeSensor MCP Server\n'));
                 console.error(chalk.blue((0, glyphs_1.getGlyphs)().info) + ' Use --mcp flag to start the MCP server');
                 console.error('\nTo use with Claude Code, add to your MCP configuration:');
                 console.error(chalk.dim(`
 {
   "mcpServers": {
-    "codegraph": {
-      "command": "codegraph",
+    "lattice-sensor": {
+      "command": "lattice-sensor",
       "args": ["serve", "--mcp"]
     }
   }
 }
 `));
                 console.error('Available tools:');
-                console.error(chalk.cyan('  codegraph_explore') + '   - Primary: source of the relevant symbols for any question');
-                console.error(chalk.cyan('  codegraph_search') + '    - Search for code symbols');
-                console.error(chalk.cyan('  codegraph_callers') + '   - Find callers of a symbol');
-                console.error(chalk.cyan('  codegraph_callees') + '   - Find what a symbol calls');
-                console.error(chalk.cyan('  codegraph_impact') + '    - Analyze impact of changes');
-                console.error(chalk.cyan('  codegraph_node') + '      - Get symbol details');
-                console.error(chalk.cyan('  codegraph_files') + '     - Get project file structure');
-                console.error(chalk.cyan('  codegraph_status') + '    - Get index status');
+                console.error(chalk.cyan('  lattice_sensor_explore') + '   - Primary: source of the relevant symbols for any question');
+                console.error(chalk.cyan('  lattice_sensor_search') + '    - Search for code symbols');
+                console.error(chalk.cyan('  lattice_sensor_callers') + '   - Find callers of a symbol');
+                console.error(chalk.cyan('  lattice_sensor_callees') + '   - Find what a symbol calls');
+                console.error(chalk.cyan('  lattice_sensor_impact') + '    - Analyze impact of changes');
+                console.error(chalk.cyan('  lattice_sensor_node') + '      - Get symbol details');
+                console.error(chalk.cyan('  lattice_sensor_files') + '     - Get project file structure');
+                console.error(chalk.cyan('  lattice_sensor_status') + '    - Get index status');
             }
         }
         catch (err) {
@@ -1680,7 +1669,7 @@ function main() {
         }
     });
     /**
-     * codegraph unlock [path]
+     * lattice sensor unlock [path]
      */
     program
         .command('unlock [path]')
@@ -1689,10 +1678,10 @@ function main() {
         const projectPath = resolveProjectPath(pathArg);
         try {
             if (!(0, directory_1.isInitialized)(projectPath)) {
-                error(`CodeGraph not initialized in ${projectPath}`);
+                error(`LatticeSensor not initialized in ${projectPath}`);
                 return;
             }
-            const lockPath = path.join((0, directory_1.getCodeGraphDir)(projectPath), 'codegraph.lock');
+            const lockPath = path.join((0, directory_1.getLatticeSensorDir)(projectPath), 'sensor.lock');
             if (!fs.existsSync(lockPath)) {
                 info(`No lock file found ${(0, glyphs_1.getGlyphs)().dash} nothing to do`);
                 return;
@@ -1706,9 +1695,9 @@ function main() {
         }
     });
     /**
-     * codegraph callers <symbol>
+     * lattice sensor callers <symbol>
      *
-     * CLI parity with the MCP graph tools (codegraph_callers/callees/impact) so the
+     * CLI parity with the MCP graph tools (lattice_sensor_callers/callees/impact) so the
      * traversal queries work in scripts, CI, and git hooks without a running MCP
      * server.
      */
@@ -1722,11 +1711,11 @@ function main() {
         const projectPath = resolveProjectPath(options.path);
         try {
             if (!(0, directory_1.isInitialized)(projectPath)) {
-                error(`CodeGraph not initialized in ${projectPath}`);
+                error(`LatticeSensor not initialized in ${projectPath}`);
                 process.exit(1);
             }
-            const { default: CodeGraph } = await loadCodeGraph();
-            const cg = await CodeGraph.open(projectPath);
+            const { default: LatticeSensor } = await loadLatticeSensor();
+            const cg = await LatticeSensor.open(projectPath);
             const limit = parseInt(options.limit || '20', 10);
             const matches = cg.searchNodes(symbol, { limit: 50 });
             if (matches.length === 0) {
@@ -1781,7 +1770,7 @@ function main() {
         }
     });
     /**
-     * codegraph callees <symbol>
+     * lattice sensor callees <symbol>
      */
     program
         .command('callees <symbol>')
@@ -1793,11 +1782,11 @@ function main() {
         const projectPath = resolveProjectPath(options.path);
         try {
             if (!(0, directory_1.isInitialized)(projectPath)) {
-                error(`CodeGraph not initialized in ${projectPath}`);
+                error(`LatticeSensor not initialized in ${projectPath}`);
                 process.exit(1);
             }
-            const { default: CodeGraph } = await loadCodeGraph();
-            const cg = await CodeGraph.open(projectPath);
+            const { default: LatticeSensor } = await loadLatticeSensor();
+            const cg = await LatticeSensor.open(projectPath);
             const limit = parseInt(options.limit || '20', 10);
             const matches = cg.searchNodes(symbol, { limit: 50 });
             if (matches.length === 0) {
@@ -1851,7 +1840,7 @@ function main() {
         }
     });
     /**
-     * codegraph impact <symbol>
+     * lattice sensor impact <symbol>
      */
     program
         .command('impact <symbol>')
@@ -1863,11 +1852,11 @@ function main() {
         const projectPath = resolveProjectPath(options.path);
         try {
             if (!(0, directory_1.isInitialized)(projectPath)) {
-                error(`CodeGraph not initialized in ${projectPath}`);
+                error(`LatticeSensor not initialized in ${projectPath}`);
                 process.exit(1);
             }
-            const { default: CodeGraph } = await loadCodeGraph();
-            const cg = await CodeGraph.open(projectPath);
+            const { default: LatticeSensor } = await loadLatticeSensor();
+            const cg = await LatticeSensor.open(projectPath);
             const depth = Math.min(Math.max(parseInt(options.depth || '2', 10), 1), 10);
             const matches = cg.searchNodes(symbol, { limit: 50 });
             if (matches.length === 0) {
@@ -1941,14 +1930,14 @@ function main() {
         }
     });
     /**
-     * codegraph affected [files...]
+     * lattice sensor affected [files...]
      *
      * Find test files affected by the given source files.
      * Traces dependency edges transitively to find test files that depend on changed code.
      *
      * Usage:
-     *   git diff --name-only | codegraph affected --stdin
-     *   codegraph affected src/lib/components/Editor.svelte src/routes/+page.svelte
+     *   git diff --name-only | lattice sensor affected --stdin
+     *   lattice sensor affected src/lib/components/Editor.svelte src/routes/+page.svelte
      */
     program
         .command('affected [files...]')
@@ -1963,7 +1952,7 @@ function main() {
         const projectPath = resolveProjectPath(options.path);
         try {
             if (!(0, directory_1.isInitialized)(projectPath)) {
-                error(`CodeGraph not initialized in ${projectPath}`);
+                error(`LatticeSensor not initialized in ${projectPath}`);
                 process.exit(1);
             }
             // Collect changed files from args or stdin
@@ -1985,18 +1974,9 @@ function main() {
                     info('No files provided. Use file arguments or --stdin.');
                 process.exit(0);
             }
-            const { default: CodeGraph } = await loadCodeGraph();
-            const cg = await CodeGraph.open(projectPath);
+            const { default: LatticeSensor } = await loadLatticeSensor();
+            const cg = await LatticeSensor.open(projectPath);
             const maxDepth = parseInt(options.depth || '5', 10);
-            // Common test file patterns
-            const defaultTestPatterns = [
-                /\.spec\./,
-                /\.test\./,
-                /\/__tests__\//,
-                /\/tests?\//,
-                /\/e2e\//,
-                /\/spec\//,
-            ];
             // Custom filter pattern
             let customFilter = null;
             if (options.filter) {
@@ -2008,17 +1988,17 @@ function main() {
                     .replace(/\*/g, '[^/]*');
                 customFilter = new RegExp(regex);
             }
-            function isTestFile(filePath) {
+            function matchesTestFile(filePath) {
                 if (customFilter)
                     return customFilter.test(filePath);
-                return defaultTestPatterns.some(p => p.test(filePath));
+                return (0, query_utils_1.isRunnableTestFile)(filePath);
             }
             // BFS to find all transitive dependents of changed files, filtered to test files
             const affectedTests = new Set();
             const allDependents = new Set();
             for (const file of changedFiles) {
                 // If the changed file is itself a test file, include it
-                if (isTestFile(file)) {
+                if (matchesTestFile(file)) {
                     affectedTests.add(file);
                     continue;
                 }
@@ -2036,7 +2016,7 @@ function main() {
                             continue;
                         visited.add(dep);
                         allDependents.add(dep);
-                        if (isTestFile(dep)) {
+                        if (matchesTestFile(dep)) {
                             affectedTests.add(dep);
                         }
                         else {
@@ -2078,127 +2058,26 @@ function main() {
         }
     });
     /**
-     * codegraph install
+     * Standalone install/uninstall retired by ADR 0059.
+     * Host wiring and retirement are owned by dotagents; this internal sensor
+     * cannot register or remove MCP servers or packages.
      */
     program
-        .command('install')
-        .description('Install codegraph MCP server into one or more agents (Claude Code, Cursor, Codex CLI, opencode, Hermes Agent)')
-        .option('-t, --target <ids>', 'Target agent(s): comma-separated ids, or "auto"|"all"|"none". Default: prompt')
-        .option('-l, --location <where>', 'Install location: "global" or "local". Default: prompt')
-        .option('-y, --yes', 'Non-interactive: defaults to --location=global --target=auto, auto-allow on')
-        .option('--no-permissions', 'Skip writing the auto-allow permissions list (Claude Code only)')
-        .option('--print-config <id>', 'Print MCP config snippet for the named agent and exit (no file writes)')
-        .option('--refresh', 'Rewrite what previous installs configured, for already-configured agents only (never adds new ones). Run automatically by `codegraph upgrade`')
-        .action(async (opts) => {
-        if (opts.printConfig) {
-            const { getTarget, listTargetIds } = await Promise.resolve().then(() => __importStar(require('../installer/targets/registry')));
-            const target = getTarget(opts.printConfig);
-            if (!target) {
-                const known = listTargetIds().join(', ');
-                error(`Unknown target "${opts.printConfig}". Known: ${known}.`);
-                process.exit(1);
-            }
-            const loc = (opts.location === 'local' ? 'local' : 'global');
-            process.stdout.write(target.printConfig(loc));
-            return;
-        }
-        // --refresh: non-interactive sweep that re-writes what previous
-        // installs configured (instructions section, MCP entry, legacy-hook
-        // cleanups) for already-configured agents, so those surfaces match
-        // THIS binary's templates. Skips everything else — never a first
-        // install, never touches permissions or the prompt hook. Sweeps both
-        // locations unless --location narrows it.
-        if (opts.refresh) {
-            const { refreshTargets } = await Promise.resolve().then(() => __importStar(require('../installer')));
-            const { ALL_TARGETS } = await Promise.resolve().then(() => __importStar(require('../installer/targets/registry')));
-            if (opts.location && opts.location !== 'global' && opts.location !== 'local') {
-                error(`--location must be "global" or "local" (got "${opts.location}").`);
-                process.exit(1);
-            }
-            const locs = opts.location
-                ? [opts.location]
-                : ['global', 'local'];
-            let changed = 0;
-            for (const loc of locs) {
-                for (const report of refreshTargets(ALL_TARGETS, loc)) {
-                    for (const p of report.changedPaths) {
-                        changed += 1;
-                        console.log(`  ${report.displayName}: refreshed ${p}`);
-                    }
-                }
-            }
-            if (changed === 0) {
-                console.log('All configured agent surfaces are already current.');
-            }
-            return;
-        }
-        const { runInstallerWithOptions } = await Promise.resolve().then(() => __importStar(require('../installer')));
-        if (opts.location && opts.location !== 'global' && opts.location !== 'local') {
-            error(`--location must be "global" or "local" (got "${opts.location}").`);
-            process.exit(1);
-        }
-        try {
-            // Commander's `--no-permissions` makes `opts.permissions === false`;
-            // omitting the flag leaves it `true` (the positive-form default).
-            // We MUST treat the default-true as "user did not override — let
-            // the orchestrator prompt" and only forward an explicit `false`
-            // (or `true` when --yes implies it). Otherwise the auto-allow
-            // prompt is silently skipped on every interactive run.
-            const explicitNoPermissions = opts.permissions === false;
-            const autoAllow = explicitNoPermissions
-                ? false
-                : opts.yes
-                    ? true
-                    : undefined;
-            await runInstallerWithOptions({
-                target: opts.target,
-                location: opts.location,
-                autoAllow,
-                yes: opts.yes,
-            });
-        }
-        catch (err) {
-            error(err instanceof Error ? err.message : String(err));
-            process.exit(1);
-        }
+        .command("install")
+        .description("Retired: use the dotagents Lattice host wiring")
+        .action(() => {
+        error("Retired: Lattice sensor does not install independent MCP wiring.");
+        process.exit(1);
     });
-    /**
-     * codegraph uninstall
-     *
-     * Inverse of `install`. Removes the codegraph MCP server entry,
-     * instructions block, and permissions from every agent (or a
-     * `--target` subset). Prompts global-vs-local when not given. Does NOT
-     * delete the `.codegraph/` index — that's `codegraph uninit`.
-     */
     program
-        .command('uninstall')
-        .description('Remove codegraph from your agents (Claude Code, Cursor, Codex CLI, opencode, Hermes Agent)')
-        .option('-t, --target <ids>', 'Target agent(s): comma-separated ids, or "all". Default: all')
-        .option('-l, --location <where>', 'Uninstall location: "global" or "local". Default: prompt')
-        .option('-y, --yes', 'Non-interactive: defaults to --location=global --target=all')
-        .option('--keep-cli', 'Remove agent configs only — leave the codegraph CLI installed')
-        .action(async (opts) => {
-        const { runUninstaller } = await Promise.resolve().then(() => __importStar(require('../installer')));
-        if (opts.location && opts.location !== 'global' && opts.location !== 'local') {
-            error(`--location must be "global" or "local" (got "${opts.location}").`);
-            process.exit(1);
-        }
-        try {
-            await runUninstaller({
-                target: opts.target,
-                location: opts.location,
-                yes: opts.yes,
-                keepCli: opts.keepCli,
-                cliFilename: __filename,
-            });
-        }
-        catch (err) {
-            error(err instanceof Error ? err.message : String(err));
-            process.exit(1);
-        }
+        .command("uninstall")
+        .description("Retired: use the dotagents Lattice sensor retirement transaction")
+        .action(() => {
+        error("Retired: use the dotagents host cutover transaction.");
+        process.exit(1);
     });
     /**
-     * codegraph telemetry [on|off|status]
+     * lattice sensor telemetry [on|off|status]
      */
     program
         .command('telemetry [action]')
@@ -2214,7 +2093,7 @@ function main() {
                 success('Telemetry disabled. Buffered, unsent data was deleted.');
             }
             const effective = t.getStatus();
-            if (effective.decidedBy === 'DO_NOT_TRACK' || effective.decidedBy === 'CODEGRAPH_TELEMETRY') {
+            if (effective.decidedBy === 'DO_NOT_TRACK' || effective.decidedBy === 'LATTICE_SENSOR_TELEMETRY') {
                 warn(`The ${effective.decidedBy} environment variable overrides this choice — ` +
                     `effective state right now: ${effective.enabled ? 'enabled' : 'disabled'}.`);
             }
@@ -2227,7 +2106,7 @@ function main() {
         const s = t.getStatus();
         const decidedBy = {
             DO_NOT_TRACK: 'DO_NOT_TRACK environment variable',
-            CODEGRAPH_TELEMETRY: 'CODEGRAPH_TELEMETRY environment variable',
+            LATTICE_SENSOR_TELEMETRY: 'LATTICE_SENSOR_TELEMETRY environment variable',
             config: 'your saved choice',
             default: 'default',
         };
@@ -2237,12 +2116,12 @@ function main() {
         console.log(chalk.dim(`\nExactly what is collected (and never collected): ${telemetry_1.TELEMETRY_DOCS}\n`));
     });
     /**
-     * codegraph upgrade [version]
+     * lattice sensor upgrade [version]
      *
      * ADR 0049 Decision 4: upstream's self-update path (bundle install.sh/.ps1
      * download, npm reinstall, GitHub release resolution) is disabled for
      * Lattice — running it would silently overwrite this fork's ADR 0047/0048
-     * improvements with an upstream CodeGraph build and reach
+     * improvements with an upstream LatticeSensor build and reach
      * raw.githubusercontent.com / api.github.com / GitHub release assets, which
      * the MCP surface contract forbids. The command stays registered (so it
      * doesn't look unrecognized) but refuses to run and points at Lattice's own
@@ -2250,30 +2129,30 @@ function main() {
      */
     program
         .command('upgrade [version]')
-        .description('Disabled on Lattice — see the Lattice release channel instead of upstream CodeGraph')
+        .description('Disabled on Lattice — see the Lattice release channel instead of upstream LatticeSensor')
         .option('--check', 'Check whether an update is available without installing')
         .option('-f, --force', 'Reinstall even if already on the target version')
         .action(async () => {
-        error('Disabled: `codegraph upgrade` self-updates from the upstream CodeGraph project ' +
+        error('Disabled: `lattice sensor upgrade` self-updates from the upstream LatticeSensor project ' +
             '(GitHub releases / npm), which would overwrite Lattice sensor\'s own fork changes. ' +
             'Update Lattice through its own release channel instead.');
         process.exit(1);
     });
     /**
-     * codegraph version
+     * lattice sensor version
      *
      * The bare-noun form of `--version`. commander already provides `--version`
      * and `-V`, and the `-v` / `-version` spellings are intercepted before parse
-     * (see top of main). This subcommand makes `codegraph version` work and lists
-     * the version affordance in `codegraph --help`.
+     * (see top of main). This subcommand makes `lattice sensor version` work and lists
+     * the version affordance in `lattice sensor --help`.
      */
     program
         .command('version')
-        .description('Print the installed CodeGraph version (also: -v, --version)')
+        .description('Print the installed LatticeSensor version (also: -v, --version)')
         .action(() => {
         console.log(packageJson.version);
     });
     // Parse and run
     program.parse();
 } // end main()
-//# sourceMappingURL=codegraph.js.map
+//# sourceMappingURL=lattice-sensor.js.map