@plebeiantech/lat.md 0.12.3-fork.17 → 0.12.3-fork.20

package/dist/src/cli/init.js

@@ -1,19 +1,21 @@
-import { existsSync, cpSync, mkdirSync, writeFileSync, readFileSync, } from 'node:fs';
-import { join, resolve } from 'node:path';
+import { agentInvocation } from './agent-invocation.js';
+import { projectWritePath, writeProjectFile, } from '@plebeiantech/lat.md-core/project-write';
+import { existsSync, cpSync, mkdirSync, readFileSync } from 'node:fs';
+import { dirname, join, resolve } from 'node:path';
 import { execSync } from 'node:child_process';
 import { createInterface } from 'node:readline/promises';
 import { styleText } from 'node:util';
 import { createEmbedder } from '@lat.md/embed';
 import { findTemplatesDir } from './templates.js';
 import { readAgentsTemplate, readCursorRulesTemplate, readPiExtensionTemplate, readOpenCodePluginTemplate, readSkillTemplate, } from './gen.js';
-import { getLlmKey, getRepoEmbedding, setRepoEmbedding } from '../config.js';
-import { makeStyler } from './context.js';
+import { getLlmKey, getRepoEmbedding, setRepoEmbedding, } from '@plebeiantech/lat.md-core/config';
+import { makeStyler } from '@plebeiantech/lat.md-core/cli/context';
 import { closeDb, getStoredModel, openDb } from '../search/db.js';
 import { modelKey } from '../search/embedder.js';
 import { reindexCommand } from './reindex.js';
-import { INIT_VERSION, writeInitMeta, readInitVersion, readFileHash, contentHash, } from '../init-version.js';
+import { INIT_VERSION, writeInitMeta, readInitVersion, readFileHash, contentHash, } from '@plebeiantech/lat.md-core/init-version';
 import { getLocalVersion, fetchLatestVersion } from '../version.js';
-import { selectMenu } from './select-menu.js';
+import { selectMenu, } from '@plebeiantech/lat.md-core/cli/select-menu';
 import { checklistMenu } from './checklist-menu.js';
 import { writeForkInstructions } from './fork-instructions.js';
 import { offerRequireMode, writeForkScaffold } from './fork-scaffold.js';
@@ -124,7 +126,8 @@ function isLatHookEntry(entry) {
  * Remove all lat-owned hook entries from settings, then add fresh ones.
  * Preserves any non-lat hooks the user may have configured.
  */
-export function syncLatHooks(settingsPath, style, agent = 'claude') {
+export function syncLatHooks(settingsPath, style, agent = 'claude', root = dirname(dirname(settingsPath))) {
+    projectWritePath(root, settingsPath);
     let settings = {};
     if (existsSync(settingsPath)) {
         const raw = readFileSync(settingsPath, 'utf-8');
@@ -176,7 +179,7 @@ export function syncLatHooks(settingsPath, style, agent = 'claude') {
             },
         ],
     });
-    writeFileSync(settingsPath, JSON.stringify(settings, null, 2) + '\n');
+    writeProjectFile(root, settingsPath, JSON.stringify(settings, null, 2) + '\n');
 }
 function cursorHooksTemplate(style) {
     return (JSON.stringify({
@@ -197,7 +200,7 @@ function cursorHooksTemplate(style) {
 }
 // ── Gitignore helper ─────────────────────────────────────────────────
 function ensureGitignored(root, entry) {
-    const gitignorePath = join(root, '.gitignore');
+    const gitignorePath = projectWritePath(root, join(root, '.gitignore'));
     const gitDir = join(root, '.git');
     // Check if already ignored
     if (existsSync(gitignorePath)) {
@@ -233,12 +236,12 @@ function ensureGitignored(root, entry) {
         let content = readFileSync(gitignorePath, 'utf-8');
         if (!content.endsWith('\n'))
             content += '\n';
-        writeFileSync(gitignorePath, content + entry + '\n');
+        writeProjectFile(root, gitignorePath, content + entry + '\n');
         console.log(styleText('green', `  Added ${entry}`) + ' to .gitignore');
     }
     else if (existsSync(gitDir)) {
         // Create .gitignore with the entry
-        writeFileSync(gitignorePath, entry + '\n');
+        writeProjectFile(root, gitignorePath, entry + '\n');
         console.log(styleText('green', `  Created .gitignore`) + ` with ${entry}`);
     }
     else {
@@ -261,7 +264,8 @@ function mcpCommand() {
         args: [...args, 'mcp'],
     };
 }
-function hasMcpServer(configPath, key) {
+function hasMcpServer(root, configPath, key) {
+    projectWritePath(root, configPath);
     if (!existsSync(configPath))
         return false;
     try {
@@ -273,7 +277,8 @@ function hasMcpServer(configPath, key) {
         return false;
     }
 }
-function addMcpServer(configPath, key, style) {
+function addMcpServer(root, configPath, key, style) {
+    projectWritePath(root, configPath);
     let cfg = { [key]: {} };
     if (existsSync(configPath)) {
         const raw = readFileSync(configPath, 'utf-8');
@@ -288,14 +293,15 @@ function addMcpServer(configPath, key, style) {
     }
     cfg[key].lat = styledMcpCommand(style);
     mkdirSync(join(configPath, '..'), { recursive: true });
-    writeFileSync(configPath, JSON.stringify(cfg, null, 2) + '\n');
+    writeProjectFile(root, configPath, JSON.stringify(cfg, null, 2) + '\n');
 }
 // ── Codex TOML MCP helpers ────────────────────────────────────────────
 /**
  * Check whether `.codex/config.toml` already contains an `[mcp_servers.lat]`
  * table.  We use a simple regex match — no TOML parser needed.
  */
-function hasCodexMcpServer(configPath) {
+function hasCodexMcpServer(root, configPath) {
+    projectWritePath(root, configPath);
     if (!existsSync(configPath))
         return false;
     try {
@@ -320,7 +326,8 @@ function hasCodexMcpServer(configPath) {
  * args = ["mcp"]
  * ```
  */
-function addCodexMcpServer(configPath, style) {
+function addCodexMcpServer(root, configPath, style) {
+    projectWritePath(root, configPath);
     const cmd = styledMcpCommand(style);
     // Format args as a TOML inline array of quoted strings
     const argsToml = '[' + cmd.args.map((a) => `"${a}"`).join(', ') + ']';
@@ -331,10 +338,10 @@ function addCodexMcpServer(configPath, style) {
         if (!content.endsWith('\n'))
             content += '\n';
         content += '\n' + block;
-        writeFileSync(configPath, content);
+        writeProjectFile(root, configPath, content);
     }
     else {
-        writeFileSync(configPath, block);
+        writeProjectFile(root, configPath, block);
     }
 }
 // ── Template file helpers ─────────────────────────────────────────────
@@ -345,11 +352,11 @@ function addCodexMcpServer(configPath, style) {
  * Returns the hash of the written content, or null if the file was skipped.
  */
 async function writeTemplateFile(root, latDir, relPath, template, genTarget, label, indent, ask) {
-    const absPath = join(root, relPath);
+    const absPath = projectWritePath(root, join(root, relPath));
     const templateHash = contentHash(template);
     if (!existsSync(absPath)) {
         mkdirSync(join(absPath, '..'), { recursive: true });
-        writeFileSync(absPath, template);
+        writeProjectFile(root, absPath, template);
         console.log(styleText('green', `${indent}Created ${label}`));
         return templateHash;
     }
@@ -364,7 +371,7 @@ async function writeTemplateFile(root, latDir, relPath, template, genTarget, lab
     }
     if (storedHash && currentHash === storedHash) {
         // Unmodified by user — safe to overwrite with new template
-        writeFileSync(absPath, template);
+        writeProjectFile(root, absPath, template);
         console.log(styleText('green', `${indent}Updated ${label}`));
         return templateHash;
     }
@@ -372,7 +379,7 @@ async function writeTemplateFile(root, latDir, relPath, template, genTarget, lab
     console.log(styleText('yellow', `${indent}${label}`) +
         ' exists and may contain your own content.');
     if (await ask(`${indent}Overwrite with latest lat template?`)) {
-        writeFileSync(absPath, template);
+        writeProjectFile(root, absPath, template);
         console.log(styleText('green', `${indent}Updated ${label}`));
         return templateHash;
     }
@@ -414,12 +421,12 @@ function wrapWithMarkers(template) {
  * Returns the hash of the written template content, or null if skipped.
  */
 async function appendTemplateSection(root, latDir, relPath, template, label, indent, ask) {
-    const absPath = join(root, relPath);
+    const absPath = projectWritePath(root, join(root, relPath));
     const templateHash = contentHash(template);
     const wrapped = wrapWithMarkers(template);
     if (!existsSync(absPath)) {
         mkdirSync(join(absPath, '..'), { recursive: true });
-        writeFileSync(absPath, wrapped);
+        writeProjectFile(root, absPath, wrapped);
         console.log(styleText('green', `${indent}Created ${label}`));
         return templateHash;
     }
@@ -443,7 +450,7 @@ async function appendTemplateSection(root, latDir, relPath, template, label, ind
             const updated = currentContent.slice(0, beginIdx) +
                 wrapped +
                 currentContent.slice(endWithNl);
-            writeFileSync(absPath, updated);
+            writeProjectFile(root, absPath, updated);
             console.log(styleText('green', `${indent}Updated ${label}`));
             return templateHash;
         }
@@ -457,7 +464,7 @@ async function appendTemplateSection(root, latDir, relPath, template, label, ind
             const updated = currentContent.slice(0, beginIdx) +
                 wrapped +
                 currentContent.slice(endWithNl);
-            writeFileSync(absPath, updated);
+            writeProjectFile(root, absPath, updated);
             console.log(styleText('green', `${indent}Updated ${label}`));
             return templateHash;
         }
@@ -470,7 +477,7 @@ async function appendTemplateSection(root, latDir, relPath, template, label, ind
     const storedHash = readFileHash(latDir, relPath);
     if (storedHash && currentHash === storedHash) {
         // Unmodified old-style file — migrate: wrap existing content with markers
-        writeFileSync(absPath, wrapWithMarkers(currentContent));
+        writeProjectFile(root, absPath, wrapWithMarkers(currentContent));
         console.log(styleText('green', `${indent}Migrated ${label}`) + ' to marker format');
         // Return hash of what's now in the section (the old content)
         return currentHash;
@@ -480,7 +487,7 @@ async function appendTemplateSection(root, latDir, relPath, template, label, ind
     if (!content.endsWith('\n'))
         content += '\n';
     content += '\n' + wrapped;
-    writeFileSync(absPath, content);
+    writeProjectFile(root, absPath, content);
     console.log(styleText('green', `${indent}Appended lat section to ${label}`));
     return templateHash;
 }
@@ -508,10 +515,10 @@ async function setupClaudeCode(root, latDir, template, hashes, ask, style) {
     console.log('');
     console.log(styleText('dim', '  Hooks inject lat.md workflow reminders into every prompt and remind'));
     console.log(styleText('dim', '  the agent to update lat.md/ before finishing.'));
-    const claudeDir = join(root, '.claude');
+    const claudeDir = projectWritePath(root, join(root, '.claude'));
     const settingsPath = join(claudeDir, 'settings.json');
     mkdirSync(claudeDir, { recursive: true });
-    syncLatHooks(settingsPath, style);
+    syncLatHooks(settingsPath, style, 'claude', root);
     console.log(styleText('green', '  Hooks') +
         ' synced (UserPromptSubmit + Stop + PostToolUse)');
     // .claude/skills/lat-md/SKILL.md — skill for authoring lat.md files
@@ -528,11 +535,11 @@ async function setupClaudeCode(root, latDir, template, hashes, ask, style) {
     console.log(styleText('dim', '  Agents can call `lat` from the command line, but an MCP server gives lat'));
     console.log(styleText('dim', '  more visibility and makes agents more likely to use it proactively.'));
     const mcpPath = join(root, '.mcp.json');
-    if (hasMcpServer(mcpPath, 'mcpServers')) {
+    if (hasMcpServer(root, mcpPath, 'mcpServers')) {
         console.log(styleText('green', '  MCP server') + ' already configured');
     }
     else {
-        addMcpServer(mcpPath, 'mcpServers', style);
+        addMcpServer(root, mcpPath, 'mcpServers', style);
         console.log(styleText('green', '  MCP server') + ' registered in .mcp.json');
     }
     // Ensure .mcp.json is gitignored (it contains local absolute paths)
@@ -555,11 +562,11 @@ async function setupCursor(root, latDir, hashes, ask, style) {
     console.log(styleText('dim', '  Agents can call `lat` from the command line, but an MCP server gives lat'));
     console.log(styleText('dim', '  more visibility and makes agents more likely to use it proactively.'));
     const mcpPath = join(root, '.cursor', 'mcp.json');
-    if (hasMcpServer(mcpPath, 'mcpServers')) {
+    if (hasMcpServer(root, mcpPath, 'mcpServers')) {
         console.log(styleText('green', '  MCP server') + ' already configured');
     }
     else {
-        addMcpServer(mcpPath, 'mcpServers', style);
+        addMcpServer(root, mcpPath, 'mcpServers', style);
         console.log(styleText('green', '  MCP server') + ' registered in .cursor/mcp.json');
     }
     // Ensure .cursor is gitignored (hooks and MCP config may contain local paths)
@@ -580,11 +587,11 @@ async function setupCopilot(root, latDir, hashes, ask, style) {
     console.log(styleText('dim', '  Agents can call `lat` from the command line, but an MCP server gives lat'));
     console.log(styleText('dim', '  more visibility and makes agents more likely to use it proactively.'));
     const mcpPath = join(root, '.vscode', 'mcp.json');
-    if (hasMcpServer(mcpPath, 'servers')) {
+    if (hasMcpServer(root, mcpPath, 'servers')) {
         console.log(styleText('green', '  MCP server') + ' already configured');
     }
     else {
-        addMcpServer(mcpPath, 'servers', style);
+        addMcpServer(root, mcpPath, 'servers', style);
         console.log(styleText('green', '  MCP server') + ' registered in .vscode/mcp.json');
     }
     // .agents/skills/lat-md/SKILL.md — skill for authoring lat.md files
@@ -597,7 +604,7 @@ async function setupPi(root, latDir, hashes, ask, style) {
     console.log('');
     console.log(styleText('dim', '  The Pi extension registers lat tools and hooks into the agent lifecycle'));
     console.log(styleText('dim', '  to inject search context and validate lat.md/ before finishing.'));
-    const template = readPiExtensionTemplate().replace('__LAT_BIN__', latBinString(style));
+    const template = readPiExtensionTemplate().replace('__LAT_INVOCATION__', () => JSON.stringify(agentInvocation(style, resolveLatInvocation())));
     const hash = await writeTemplateFile(root, latDir, '.pi/extensions/lat.ts', template, 'pi-extension.ts', 'Extension (.pi/extensions/lat.ts)', '  ', ask);
     if (hash)
         hashes['.pi/extensions/lat.ts'] = hash;
@@ -618,7 +625,7 @@ async function setupOpenCode(root, latDir, hashes, ask, style) {
     console.log('');
     console.log(styleText('dim', '  The OpenCode plugin registers lat tools and hooks into the session'));
     console.log(styleText('dim', '  lifecycle to validate lat.md/ when the agent finishes.'));
-    const template = readOpenCodePluginTemplate().replace('__LAT_BIN__', latBinString(style));
+    const template = readOpenCodePluginTemplate().replace('__LAT_INVOCATION__', () => JSON.stringify(agentInvocation(style, resolveLatInvocation())));
     const hash = await writeTemplateFile(root, latDir, '.opencode/plugins/lat.ts', template, 'opencode-plugin.ts', 'Plugin (.opencode/plugins/lat.ts)', '  ', ask);
     if (hash)
         hashes['.opencode/plugins/lat.ts'] = hash;
@@ -634,10 +641,10 @@ async function setupCodex(root, latDir, hashes, ask, style) {
     console.log('');
     console.log(styleText('dim', '  Hooks inject lat.md workflow reminders into every prompt and remind'));
     console.log(styleText('dim', '  the agent to update lat.md/ before finishing.'));
-    const codexDir = join(root, '.codex');
+    const codexDir = projectWritePath(root, join(root, '.codex'));
     const hooksPath = join(codexDir, 'hooks.json');
     mkdirSync(codexDir, { recursive: true });
-    syncLatHooks(hooksPath, style, 'codex');
+    syncLatHooks(hooksPath, style, 'codex', root);
     console.log(styleText('green', '  Hooks') +
         ' synced (UserPromptSubmit + Stop + PostToolUse)');
     // .codex/config.toml — MCP server registration
@@ -645,11 +652,11 @@ async function setupCodex(root, latDir, hashes, ask, style) {
     console.log(styleText('dim', '  Agents can call `lat` from the command line, but an MCP server gives lat'));
     console.log(styleText('dim', '  more visibility and makes agents more likely to use it proactively.'));
     const mcpPath = join(root, '.codex', 'config.toml');
-    if (hasCodexMcpServer(mcpPath)) {
+    if (hasCodexMcpServer(root, mcpPath)) {
         console.log(styleText('green', '  MCP server') + ' already configured');
     }
     else {
-        addCodexMcpServer(mcpPath, style);
+        addCodexMcpServer(root, mcpPath, style);
         console.log(styleText('green', '  MCP server') + ' registered in .codex/config.toml');
     }
     // Ensure .codex is gitignored (config contains local absolute paths)
@@ -844,13 +851,14 @@ export function readLogo() {
     return readFileSync(join(findTemplatesDir(), 'logo.txt'), 'utf-8');
 }
 export function ensureLatLocalConfigIgnored(latDir) {
-    const path = join(latDir, '.gitignore');
+    const root = dirname(latDir);
+    const path = projectWritePath(root, join(latDir, '.gitignore'));
     const entry = 'config.local.yaml';
     const current = existsSync(path) ? readFileSync(path, 'utf8') : '';
     if (current.split(/\r?\n/).includes(entry))
         return;
     const prefix = current && !current.endsWith('\n') ? `${current}\n` : current;
-    writeFileSync(path, `${prefix}${entry}\n`);
+    writeProjectFile(root, path, `${prefix}${entry}\n`);
 }
 export async function initCmd(targetDir) {
     console.log(styleText('cyan', readLogo()));
@@ -875,6 +883,7 @@ export async function initCmd(targetDir) {
     }
     const root = resolve(targetDir ?? process.cwd());
     const latDir = join(root, 'lat.md');
+    projectWritePath(root, latDir);
     const storedInitVersion = readInitVersion(latDir);
     const interactive = process.stdin.isTTY ?? false;
     // Readline is created AFTER the selectMenu loop below.
@@ -1060,7 +1069,7 @@ export async function initCmd(targetDir) {
             styleText('cyan', 'lat check') +
             ' to validate your setup.');
         // Suggest ripgrep if not available
-        const { hasRipgrep } = await import('../code-refs.js');
+        const { hasRipgrep } = await import('@plebeiantech/lat.md-core/code-refs');
         if (!(await hasRipgrep())) {
             console.log('');
             console.log(styleText('yellow', 'Tip:') +

package/dist/src/cli/reindex.d.ts

@@ -1,4 +1,4 @@
-import type { CmdContext, CmdResult } from '../context.js';
+import type { CmdContext, CmdResult } from '@plebeiantech/lat.md-core/context';
 /**
  * Rebuild the embedding index. Honors the durable per-repo backend preference:
  * a repo pinned to local rebuilds local and ignores the key. `--local` forces

package/dist/src/cli/reindex.js

@@ -2,9 +2,9 @@ import { writeIndex } from '../search/cache.js';
 import readline from 'node:readline/promises';
 import { ensureMeta, setStoredModel, ensureSectionsSchema, dropSections, } from '../search/db.js';
 import { embedderFromEnv, localEmbedder, modelKey, EmbeddingAuthError, } from '../search/embedder.js';
-import { getLlmKey, getRepoEmbedding, setRepoEmbedding } from '../config.js';
+import { getLlmKey, getRepoEmbedding, setRepoEmbedding, } from '@plebeiantech/lat.md-core/config';
 import { indexSections } from '../search/index.js';
-import { commandProjectAnalysis } from '../project-analysis.js';
+import { commandProjectAnalysis } from '@plebeiantech/lat.md-core/project-analysis';
 const SPINNER = ['⠋', '⠙', '⠹', '⠸', '⠼', '⠴', '⠦', '⠧', '⠇', '⠏'];
 async function confirmUseLocal(ctx, status, assumeYes) {
     const s = ctx.styler;

package/dist/src/cli/search.d.ts

@@ -1,8 +1,8 @@
-import type { CmdContext, CmdResult, Styler } from '../context.js';
+import type { CmdContext, CmdResult, Styler } from '@plebeiantech/lat.md-core/context';
 import { type IndexStats } from '../search/index.js';
-import type { SectionMatch } from '../lattice-model.js';
-import type { Section } from '../lattice-model.js';
-import { type MarkdownProjectAnalysis } from '../project-analysis.js';
+import type { SectionMatch } from '@plebeiantech/lat.md-core/lattice-model';
+import type { Section } from '@plebeiantech/lat.md-core/lattice-model';
+import { type MarkdownProjectAnalysis } from '@plebeiantech/lat.md-core/project-analysis';
 export type SearchResult = {
     query: string;
     matches: SectionMatch[];

package/dist/src/cli/search.js

@@ -4,37 +4,46 @@ import { hasIndex } from '../search/db.js';
 import { embeddingFingerprint } from '../search/chunks.js';
 import { writeIndex } from '../search/cache.js';
 import { dirname, join } from 'node:path';
-import { openDb, getStoredModel, setStoredModel, ensureSectionsSchema, closeDb, } from '../search/db.js';
+import { openDb, setStoredModel, ensureSectionsSchema, closeDb, } from '../search/db.js';
 import { embedderForIndex, modelKey, ReindexRequiredError, EmbeddingAuthError, } from '../search/embedder.js';
 import { indexSections, projectFingerprint, } from '../search/index.js';
-import { searchSections } from '../search/search.js';
-import { resolveSearchMatches, searchIndexedSections, } from '../search/query.js';
-import { analyzeMarkdownProject, commandProjectAnalysis, } from '../project-analysis.js';
-import { formatSectionPreview, formatNavHints } from '../format.js';
-import { provenanceNote, formatProvenanceNote } from './check-status.js';
-async function withDb(latDir, progress, project, cacheDir, fn) {
-    if (hasIndex(cacheDir ?? join(latDir, '.cache'))) {
+import { searchSections, prepareSearchQuery } from '../search/search.js';
+import { indexMetadata, sameIndexMetadata, resolveSearchMatches, searchIndexedSections, } from '../search/query.js';
+import { analyzeMarkdownProject, commandProjectAnalysis, } from '@plebeiantech/lat.md-core/project-analysis';
+import { formatSectionPreview, formatNavHints, } from '@plebeiantech/lat.md-core/format';
+import { provenanceNote, formatProvenanceNote, } from '@plebeiantech/lat.md-core/cli/check-status';
+async function withDb(latDir, progress, project, cacheDir, fn, prepare) {
+    for (let attempt = 0; hasIndex(cacheDir ?? join(latDir, '.cache')); attempt++) {
+        if (attempt >= 3)
+            throw new Error('Search index keeps changing; retry shortly.');
+        const metadataDb = openDb(latDir, cacheDir, true);
+        let metadata;
+        try {
+            metadata = await indexMetadata(metadataDb);
+        }
+        finally {
+            await closeDb(metadataDb);
+        }
+        const stored = metadata.get('embedding_model') ?? null;
+        const embedder = await embedderForIndex(stored, latDir);
+        if (metadata.get('fingerprint') !== embeddingFingerprint(embedder))
+            throw new ReindexRequiredError('Search chunking or embedding model changed; run lat reindex.');
+        if (!stored ||
+            metadata.get('lexical_version') !== LEXICAL_VERSION ||
+            metadata.get('project_hash') !== projectFingerprint(project))
+            break;
+        await prepare?.(embedder);
         const db = openDb(latDir, cacheDir, true);
         try {
-            const stored = await getStoredModel(db);
-            const embedder = await embedderForIndex(stored, latDir);
-            const metadata = new Map((await db.execute('SELECT key,value FROM meta')).rows.map((row) => [
-                row.key,
-                row.value,
-            ]));
-            if (metadata.get('fingerprint') !== embeddingFingerprint(embedder))
-                throw new ReindexRequiredError('Search chunking or embedding model changed; run lat reindex.');
-            if (stored &&
-                metadata.get('lexical_version') === LEXICAL_VERSION &&
-                metadata.get('project_hash') === projectFingerprint(project)) {
-                progress?.afterIndex?.({
-                    added: 0,
-                    updated: 0,
-                    removed: 0,
-                    unchanged: project.sections.length,
-                }, false);
-                return await fn(db, embedder, project);
-            }
+            if (!sameIndexMetadata(metadata, await indexMetadata(db)))
+                continue;
+            progress?.afterIndex?.({
+                added: 0,
+                updated: 0,
+                removed: 0,
+                unchanged: project.sections.length,
+            }, false);
+            return await fn(db, embedder, project);
         }
         finally {
             await closeDb(db);
@@ -48,6 +57,7 @@ async function withDb(latDir, progress, project, cacheDir, fn) {
         const stats = await indexSections(latDir, db, embedder, undefined, project);
         await setStoredModel(db, modelKey(embedder));
         progress?.afterIndex?.(stats, isEmpty);
+        await prepare?.(embedder);
         return fn(db, embedder, project);
     });
 }
@@ -77,12 +87,15 @@ export async function runSearch(latDir, query, limit, progress, opts) {
         (await analyzeMarkdownProject(latDir, dirname(latDir), {
             executor: 'auto',
         }));
+    let vector;
     return withDb(latDir, progress, project, opts?.cacheDir, async (db, embedder, analyzed) => {
-        const results = await searchSections(db, query, embedder, limit, opts?.minSimilarity);
+        const results = await searchSections(db, query, embedder, limit, opts?.minSimilarity, vector);
         return {
             query,
             matches: resolveSearchMatches(results, analyzed.sectionById),
         };
+    }, async (embedder) => {
+        vector = await prepareSearchQuery(query, embedder, limit, opts?.minSimilarity);
     });
 }
 /**

package/dist/src/cli/ui-build-server.d.ts

@@ -1,4 +1,4 @@
-import type { CmdContext, CmdResult } from '../context.js';
+import type { CmdContext, CmdResult } from '@plebeiantech/lat.md-core/context';
 import { buildServerView, type ServerViewBuildOptions, type ServerViewBuildResult } from '../view/server-build.js';
 export type ServerViewBuildTarget = 'node' | 'vercel';
 export type UiBuildServerOptions = ServerViewBuildOptions & {

package/dist/src/cli/ui-build.d.ts

@@ -1,4 +1,4 @@
-import type { CmdContext, CmdResult } from '../context.js';
+import type { CmdContext, CmdResult } from '@plebeiantech/lat.md-core/context';
 import { type StaticViewBuildOptions } from '../view/static-build.js';
 /** Export the current vault as a serverless, read-only Lat UI. */
 export declare function uiBuildCommand(ctx: CmdContext, output?: string, options?: StaticViewBuildOptions): Promise<CmdResult>;

package/dist/src/cli/ui.d.ts

@@ -1,4 +1,4 @@
-import type { CmdContext, CmdResult } from '../context.js';
+import type { CmdContext, CmdResult } from '@plebeiantech/lat.md-core/context';
 import { type ViewServer, type ViewServerOptions } from '../view/server.js';
 type UiCommandOptions = ViewServerOptions & {
     openBrowser?: (url: string) => Promise<void>;

package/dist/src/fork/antigravity-hook.js

@@ -1,11 +1,11 @@
 import { existsSync, openSync, readSync, closeSync, statSync } from 'node:fs';
 import { dirname, isAbsolute, resolve } from 'node:path';
-import { findLatticeDir, findSections } from '../lattice.js';
-import { commandProjectAnalysis } from '../project-analysis.js';
-import { plainStyler } from '../context.js';
-import { expandPrompt } from '../cli/expand.js';
+import { findLatticeDir, findSections, } from '@plebeiantech/lat.md-core/lattice';
+import { commandProjectAnalysis } from '@plebeiantech/lat.md-core/project-analysis';
+import { plainStyler, } from '@plebeiantech/lat.md-core/context';
+import { expandPrompt } from '@plebeiantech/lat.md-core/cli/expand';
 import { runSearch } from '../cli/search.js';
-import { getSection, formatSectionOutput } from '../cli/section.js';
+import { getSection, formatSectionOutput, } from '@plebeiantech/lat.md-core/cli/section';
 import { getStopStatus, formatStopReason, } from '../cli/hook.js';
 import { computeCommentBlock } from '../cli/comment-guard.js';
 import { taggedDocsForFiles, federateTags } from '../knowledge/index.js';
@@ -328,7 +328,7 @@ export async function handleAntigravityPostToolUse(rawInput, writeOutput = true)
         const latDir = findLatticeDir(workspacePath) ?? findLatticeDir();
         if (latDir) {
             try {
-                const { checkIndex } = await import('../cli/check.js');
+                const { checkIndex } = await import('@plebeiantech/lat.md-core/cli/check');
                 await checkIndex(latDir, undefined, { fix: true });
             }
             catch { }

package/dist/src/fork/antigravity-init.d.ts

@@ -11,7 +11,7 @@ export type SetupAntigravityOptions = {
     appendTemplateSection: (root: string, latDir: string, relPath: string, template: string, label: string, indent: string, ask: (message: string) => Promise<boolean>) => Promise<string | null>;
     writeTemplateFile: (root: string, latDir: string, relPath: string, template: string, genTarget: string | null, label: string, indent: string, ask: (message: string) => Promise<boolean>) => Promise<string | null>;
     ensureGitignored: (root: string, entry: string) => void;
-    hasMcpServer: (configPath: string, key: string) => boolean;
-    addMcpServer: (configPath: string, key: string, style: 'global' | 'local' | 'npx') => void;
+    hasMcpServer: (root: string, configPath: string, key: string) => boolean;
+    addMcpServer: (root: string, configPath: string, key: string, style: 'global' | 'local' | 'npx') => void;
 };
 export declare function setupAntigravity(opts: SetupAntigravityOptions): Promise<void>;

package/dist/src/fork/antigravity-init.js

@@ -113,11 +113,11 @@ export async function setupAntigravity(opts) {
     catch { }
     ensureGitignored(root, '.gemini');
     const mcpPath = join(root, '.mcp.json');
-    if (hasMcpServer(mcpPath, 'mcpServers')) {
+    if (hasMcpServer(root, mcpPath, 'mcpServers')) {
         console.log(styleText('green', '  MCP server') + ' already configured');
     }
     else {
-        addMcpServer(mcpPath, 'mcpServers', style);
+        addMcpServer(root, mcpPath, 'mcpServers', style);
         console.log(styleText('green', '  MCP server') + ' registered in .mcp.json');
     }
     ensureGitignored(root, '.mcp.json');

package/dist/src/graph-export.js

@@ -11,12 +11,12 @@ import { execFile } from 'node:child_process';
 import { createHash } from 'node:crypto';
 import { join, relative } from 'node:path';
 import { promisify } from 'node:util';
-import { extractRefs, buildFileIndex, buildSectionSlugIndex, parseSections, parseFrontmatter, resolveRef, } from './lattice.js';
-import { scanCodeRefs } from './code-refs.js';
-import { DIATAXIS_MODES, MODE_DIRS } from './cli/check-mode.js';
-import { readProvenance } from './cli/check-status.js';
-import { cleanUntrustedId } from './untrusted.js';
-import { toPosix } from './path.js';
+import { extractRefs, buildFileIndex, buildSectionSlugIndex, parseSections, parseFrontmatter, resolveRef, } from '@plebeiantech/lat.md-core/lattice';
+import { scanCodeRefs } from '@plebeiantech/lat.md-core/code-refs';
+import { DIATAXIS_MODES, MODE_DIRS, } from '@plebeiantech/lat.md-core/cli/check-mode';
+import { readProvenance } from '@plebeiantech/lat.md-core/cli/check-status';
+import { cleanUntrustedId } from '@plebeiantech/lat.md-core/untrusted';
+import { toPosix } from '@plebeiantech/lat.md-core/path';
 const execFileAsync = promisify(execFile);
 /** Bytes. Node's `execFile` default is 1 MB, which a large document exceeds. */
 const GIT_MAX_BUFFER = 256 * 1024 * 1024;
@@ -192,7 +192,7 @@ export async function buildGraph(files, projectRoot, includeCode) {
 }
 /** Read the working tree's lat.md files straight off disk. */
 export async function loadWorkingTreeFiles(latticeDir, projectRoot) {
-    const { listLatticeFiles } = await import('./lattice.js');
+    const { listLatticeFiles } = await import('@plebeiantech/lat.md-core/lattice');
     const { readFile } = await import('node:fs/promises');
     const paths = await listLatticeFiles(latticeDir);
     const files = [];

package/dist/src/knowledge/index.js

@@ -1,7 +1,7 @@
 import { readFile } from 'node:fs/promises';
 import { join } from 'node:path';
-import { parseFrontmatter } from '../lattice.js';
-import { UNTRUSTED_NOTICE, quoteUntrusted, cleanUntrustedId, } from '../untrusted.js';
+import { parseFrontmatter } from '@plebeiantech/lat.md-core/lattice';
+import { UNTRUSTED_NOTICE, quoteUntrusted, cleanUntrustedId, } from '@plebeiantech/lat.md-core/untrusted';
 import { tagsToTerms, capHits } from './ranking.js';
 const STORE_GROUP_LABELS = {
     cq: 'cq:',

package/dist/src/mcp/server.js

@@ -2,16 +2,16 @@ import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
 import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
 import { z } from 'zod';
 import { dirname } from 'node:path';
-import { findLatticeDir } from '../project-discovery.js';
-import { plainStyler } from '../context.js';
-import { locateCommand } from '../cli/locate.js';
-import { sectionCommand } from '../cli/section.js';
+import { findLatticeDir } from '@plebeiantech/lat.md-core/project-discovery';
+import { plainStyler, } from '@plebeiantech/lat.md-core/context';
+import { locateCommand } from '@plebeiantech/lat.md-core/cli/locate';
+import { sectionCommand } from '@plebeiantech/lat.md-core/cli/section';
 import { searchCommand } from '../cli/search.js';
 import { DEFAULT_SEARCH_LIMIT, DEFAULT_MIN_SIMILARITY, } from '../search/search.js';
-import { expandCommand } from '../cli/expand.js';
-import { checkAllCommand } from '../cli/check.js';
-import { refsCommand } from '../cli/refs.js';
-import { externalListCommand, externalShowCommand } from '../cli/external.js';
+import { expandCommand } from '@plebeiantech/lat.md-core/cli/expand';
+import { checkAllCommand } from '@plebeiantech/lat.md-core/cli/check';
+import { refsCommand } from '@plebeiantech/lat.md-core/cli/refs';
+import { externalListCommand, externalShowCommand, } from '@plebeiantech/lat.md-core/cli/external';
 function toMcp(result) {
     const content = [{ type: 'text', text: result.output }];
     return result.isError ? { content, isError: true } : { content };

package/dist/src/search/cache.d.ts

@@ -1,3 +1,3 @@
 import { SearchDb } from './db.js';
-/** Build a private staging database; readers only open snapshots of search.db. */
+/** Build a private staging database; access locks protect copies and publication of search.db. */
 export declare function writeIndex<T>(latDir: string, cacheDir: string | undefined, rebuild: boolean, work: (db: SearchDb, storedModel: string | null) => Promise<T>): Promise<T>;