@plebeiantech/lat.md 0.12.3-fork.8 → 0.13.4-fork.1

package/dist/src/cli/refs.js

@@ -1,229 +0,0 @@
-import { readFile } from 'node:fs/promises';
-import { existsSync } from 'node:fs';
-import { extname, join, relative } from 'node:path';
-import { listLatticeFiles, loadAllSections, findSections, extractRefs, flattenSections, buildFileIndex, buildSectionSlugIndex, resolveRef, } from '../lattice.js';
-import { formatResultList } from '../format.js';
-import { scanCodeRefs } from '../code-refs.js';
-/** Extensions recognized as source code for ref queries. */
-const SOURCE_EXTS = new Set([
-    '.ts',
-    '.tsx',
-    '.js',
-    '.jsx',
-    '.py',
-    '.rs',
-    '.go',
-    '.c',
-    '.h',
-]);
-/**
- * Check if a query looks like a source file path (has a recognized extension
- * and the file exists on disk).
- */
-function isSourceQuery(query, projectRoot) {
-    const hashIdx = query.indexOf('#');
-    const filePart = hashIdx === -1 ? query : query.slice(0, hashIdx);
-    const symbolPart = hashIdx === -1 ? '' : query.slice(hashIdx + 1);
-    const ext = extname(filePart);
-    if (!SOURCE_EXTS.has(ext))
-        return null;
-    if (!existsSync(join(projectRoot, filePart)))
-        return null;
-    return { filePart, symbolPart };
-}
-/**
- * Find references to a source file or symbol across lat.md and code files.
- * For file-level queries (no #symbol), matches all wiki links targeting
- * that file or any symbol in it.
- */
-async function findSourceRefs(latDir, projectRoot, query, scope) {
-    const hashIdx = query.indexOf('#');
-    const filePart = hashIdx === -1 ? query : query.slice(0, hashIdx);
-    const isFileLevel = hashIdx === -1;
-    const queryLower = query.toLowerCase();
-    const fileLower = filePart.toLowerCase();
-    // Build a synthetic Section for the target
-    const target = {
-        id: query,
-        heading: hashIdx === -1 ? filePart : query.slice(hashIdx + 1),
-        depth: 0,
-        file: filePart,
-        filePath: filePart,
-        children: [],
-        startLine: 0,
-        endLine: 0,
-        firstParagraph: '',
-    };
-    // Try to get real line info from the source parser
-    try {
-        const { resolveSourceSymbol } = await import('../source-parser.js');
-        if (hashIdx !== -1) {
-            const symbolPart = query.slice(hashIdx + 1);
-            const { found, symbols } = await resolveSourceSymbol(filePart, symbolPart, projectRoot);
-            if (found) {
-                const parts = symbolPart.split('#');
-                const sym = symbols.find((s) => parts.length === 1
-                    ? s.name === parts[0] && !s.parent
-                    : s.name === parts[1] && s.parent === parts[0]);
-                if (sym) {
-                    target.startLine = sym.startLine;
-                    target.endLine = sym.endLine;
-                    target.firstParagraph = sym.signature;
-                }
-            }
-        }
-    }
-    catch {
-        // source parser unavailable — proceed without line info
-    }
-    const allSections = await loadAllSections(latDir);
-    const flat = flattenSections(allSections);
-    const mdRefs = [];
-    const codeRefs = [];
-    if (scope === 'md' || scope === 'md+code') {
-        const files = await listLatticeFiles(latDir);
-        const matchingFromSections = new Set();
-        for (const file of files) {
-            const content = await readFile(file, 'utf-8');
-            const fileRefs = extractRefs(file, content, projectRoot);
-            for (const ref of fileRefs) {
-                const targetLower = ref.target.toLowerCase();
-                const matches = isFileLevel
-                    ? targetLower === fileLower || targetLower.startsWith(fileLower + '#')
-                    : targetLower === queryLower;
-                if (matches) {
-                    matchingFromSections.add(ref.fromSection.toLowerCase());
-                }
-            }
-        }
-        if (matchingFromSections.size > 0) {
-            const referrers = flat.filter((s) => matchingFromSections.has(s.id.toLowerCase()));
-            for (const s of referrers) {
-                mdRefs.push({ section: s, reason: 'wiki link' });
-            }
-        }
-    }
-    if (scope === 'code' || scope === 'md+code') {
-        const { refs: scannedRefs } = await scanCodeRefs(projectRoot);
-        for (const ref of scannedRefs) {
-            const targetLower = ref.target.toLowerCase();
-            const matches = isFileLevel
-                ? targetLower === fileLower || targetLower.startsWith(fileLower + '#')
-                : targetLower === queryLower;
-            if (matches) {
-                const displayPath = relative(process.cwd(), join(projectRoot, ref.file));
-                codeRefs.push(`${displayPath}:${ref.line}`);
-            }
-        }
-    }
-    return { kind: 'found', target, mdRefs, codeRefs };
-}
-/**
- * Find all sections and code locations that reference a given section or
- * source file. Accepts section ids (full-path, short-form) and source file
- * paths (e.g. src/app.rs#foo). Source file queries match wiki links directly
- * without section resolution.
- */
-export async function findRefs(ctx, query, scope) {
-    query = query.replace(/^\[\[|\]\]$/g, '');
-    // Source file queries bypass section resolution
-    if (isSourceQuery(query, ctx.projectRoot)) {
-        return findSourceRefs(ctx.latDir, ctx.projectRoot, query, scope);
-    }
-    const allSections = await loadAllSections(ctx.latDir);
-    const flat = flattenSections(allSections);
-    const sectionIds = new Set(flat.map((s) => s.id.toLowerCase()));
-    const fileIndex = buildFileIndex(allSections);
-    const slugIndex = buildSectionSlugIndex(allSections);
-    const { resolved } = resolveRef(query, sectionIds, fileIndex, slugIndex);
-    const q = resolved.toLowerCase();
-    let exactMatch = flat.find((s) => s.id.toLowerCase() === q);
-    // If resolveRef didn't land on an exact id, use findSections as fallback
-    const matches = !exactMatch ? findSections(allSections, query) : [];
-    if (!exactMatch && matches.length >= 1) {
-        const top = matches[0];
-        const isConfident = top.reason === 'exact match' ||
-            top.reason.startsWith('file stem expanded') ||
-            top.reason === 'section name match';
-        if (isConfident) {
-            exactMatch = top.section;
-        }
-    }
-    if (!exactMatch) {
-        const suggestions = matches.length > 0 ? matches : findSections(allSections, query);
-        return { kind: 'no-match', suggestions };
-    }
-    const targetId = exactMatch.id.toLowerCase();
-    const mdRefs = [];
-    const codeRefs = [];
-    if (scope === 'md' || scope === 'md+code') {
-        const files = await listLatticeFiles(ctx.latDir);
-        const matchingFromSections = new Set();
-        for (const file of files) {
-            const content = await readFile(file, 'utf-8');
-            const fileRefs = extractRefs(file, content, ctx.projectRoot);
-            for (const ref of fileRefs) {
-                const { resolved: refResolved } = resolveRef(ref.target, sectionIds, fileIndex, slugIndex);
-                if (refResolved.toLowerCase() === targetId) {
-                    matchingFromSections.add(ref.fromSection.toLowerCase());
-                }
-            }
-        }
-        if (matchingFromSections.size > 0) {
-            const referrers = flat.filter((s) => matchingFromSections.has(s.id.toLowerCase()));
-            for (const s of referrers) {
-                mdRefs.push({ section: s, reason: 'wiki link' });
-            }
-        }
-    }
-    if (scope === 'code' || scope === 'md+code') {
-        const { refs: scannedRefs } = await scanCodeRefs(ctx.projectRoot);
-        for (const ref of scannedRefs) {
-            const { resolved: codeResolved } = resolveRef(ref.target, sectionIds, fileIndex, slugIndex);
-            if (codeResolved.toLowerCase() === targetId) {
-                const displayPath = relative(process.cwd(), join(ctx.projectRoot, ref.file));
-                codeRefs.push(`${displayPath}:${ref.line}`);
-            }
-        }
-    }
-    return { kind: 'found', target: exactMatch, mdRefs, codeRefs };
-}
-export async function refsCommand(ctx, query, scope) {
-    const result = await findRefs(ctx, query, scope);
-    if (result.kind === 'no-match') {
-        const s = ctx.styler;
-        if (result.suggestions.length > 0) {
-            const suggestions = result.suggestions
-                .map((m) => `  ${s.dim('*')} ${s.white(m.section.id)} ${s.dim(`(${m.reason})`)}`)
-                .join('\n');
-            return {
-                output: s.red(`No section "${query}" found.`) +
-                    ' Did you mean:\n' +
-                    suggestions,
-                isError: true,
-            };
-        }
-        return {
-            output: s.red(`No section matching "${query}"`),
-            isError: true,
-        };
-    }
-    const { target, mdRefs, codeRefs } = result;
-    if (mdRefs.length === 0 && codeRefs.length === 0) {
-        return {
-            output: ctx.styler.yellow(`No references to "${target.id}" found`),
-            isError: true,
-        };
-    }
-    const s = ctx.styler;
-    const parts = [];
-    if (mdRefs.length > 0) {
-        parts.push(formatResultList(ctx, `References to "${target.id}":`, mdRefs));
-    }
-    if (codeRefs.length > 0) {
-        parts.push('## Code references:' +
-            '\n\n' +
-            codeRefs.map((l) => `${s.dim('*')} ${l}`).join('\n'));
-    }
-    return { output: parts.join('\n') };
-}

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

@@ -1,43 +0,0 @@
-import { type Section, type SectionMatch } from '../lattice.js';
-import type { CmdContext, CmdResult } from '../context.js';
-import { type ProvenanceNote } from './check-status.js';
-export type CodeBackRef = {
-    file: string;
-    line: number;
-    snippet: string;
-};
-export type SourceRef = {
-    target: string;
-    file: string;
-    line: number;
-    endLine: number;
-    snippet: string;
-};
-export type SectionFound = {
-    kind: 'found';
-    section: Section;
-    content: string;
-    /** Provenance of the document holding this section, or null if unmarked. */
-    status: ProvenanceNote | null;
-    outgoingRefs: {
-        target: string;
-        resolved: Section;
-    }[];
-    outgoingSourceRefs: SourceRef[];
-    incomingRefs: SectionMatch[];
-    codeRefs: CodeBackRef[];
-};
-export type SectionResult = SectionFound | {
-    kind: 'no-match';
-    suggestions: SectionMatch[];
-};
-/**
- * Look up a section by id, return its content, outgoing wiki link targets,
- * and incoming references from other sections.
- */
-export declare function getSection(ctx: CmdContext, query: string): Promise<SectionResult>;
-/**
- * Format a successful section result with styling.
- */
-export declare function formatSectionOutput(ctx: CmdContext, result: SectionFound): string;
-export declare function sectionCommand(ctx: CmdContext, query: string): Promise<CmdResult>;

package/dist/src/cli/section.js

@@ -1,252 +0,0 @@
-import { readFile } from 'node:fs/promises';
-import { extname, join, relative } from 'node:path';
-import { loadAllSections, findSections, flattenSections, extractRefs, buildFileIndex, buildSectionSlugIndex, resolveRef, listLatticeFiles, } from '../lattice.js';
-import { scanCodeRefs } from '../code-refs.js';
-import { SOURCE_EXTENSIONS, resolveSourceSymbol } from '../source-parser.js';
-import { formatSectionId, formatNavHints } from '../format.js';
-import { provenanceNote, formatProvenanceNote, } from './check-status.js';
-/**
- * Look up a section by id, return its content, outgoing wiki link targets,
- * and incoming references from other sections.
- */
-export async function getSection(ctx, query) {
-    query = query.replace(/^\[\[|\]\]$/g, '');
-    const allSections = await loadAllSections(ctx.latDir);
-    const matches = findSections(allSections, query);
-    if (matches.length === 0) {
-        return { kind: 'no-match', suggestions: [] };
-    }
-    // Accept the top match if confident
-    const top = matches[0];
-    const isConfident = top.reason === 'exact match' ||
-        top.reason.startsWith('file stem expanded') ||
-        top.reason === 'section name match';
-    if (!isConfident) {
-        return { kind: 'no-match', suggestions: matches };
-    }
-    const section = top.section;
-    // Read raw content between startLine and the end of the last descendant
-    const absPath = join(ctx.projectRoot, section.filePath);
-    const fileContent = await readFile(absPath, 'utf-8');
-    const lines = fileContent.split('\n');
-    const end = fullEndLine(section);
-    const content = lines.slice(section.startLine - 1, end).join('\n');
-    // Find outgoing wiki link targets within this section's content
-    const flat = flattenSections(allSections);
-    const sectionIds = new Set(flat.map((s) => s.id.toLowerCase()));
-    const fileIndex = buildFileIndex(allSections);
-    const slugIndex = buildSectionSlugIndex(allSections);
-    const sectionRefs = extractRefs(absPath, fileContent, ctx.projectRoot);
-    const sectionId = section.id.toLowerCase();
-    const outgoingRefs = [];
-    const outgoingSourceRefs = [];
-    const seen = new Set();
-    for (const ref of sectionRefs) {
-        if (ref.fromSection.toLowerCase() !== sectionId)
-            continue;
-        // Detect source code references by file extension
-        const hashIdx = ref.target.indexOf('#');
-        const filePart = hashIdx === -1 ? ref.target : ref.target.slice(0, hashIdx);
-        const ext = extname(filePart);
-        if (SOURCE_EXTENSIONS.has(ext)) {
-            const targetLower = ref.target.toLowerCase();
-            if (!seen.has(targetLower)) {
-                seen.add(targetLower);
-                const symbolPart = hashIdx === -1 ? '' : ref.target.slice(hashIdx + 1);
-                let line = 0;
-                let endLine = 0;
-                let snippet = '';
-                if (symbolPart) {
-                    const { found, symbols } = await resolveSourceSymbol(filePart, symbolPart, ctx.projectRoot);
-                    if (found) {
-                        const parts = symbolPart.split('#');
-                        const sym = symbols.find((s) => parts.length === 1
-                            ? s.name === parts[0] && !s.parent
-                            : s.name === parts[1] && s.parent === parts[0]);
-                        if (sym) {
-                            line = sym.startLine;
-                            endLine = sym.endLine;
-                            try {
-                                const src = await readFile(join(ctx.projectRoot, filePart), 'utf-8');
-                                const srcLines = src.split('\n');
-                                const start = sym.startLine - 1;
-                                const end = Math.min(srcLines.length, start + 5);
-                                snippet = srcLines.slice(start, end).join('\n');
-                            }
-                            catch {
-                                // file unreadable
-                            }
-                        }
-                    }
-                }
-                outgoingSourceRefs.push({
-                    target: ref.target,
-                    file: filePart,
-                    line,
-                    endLine,
-                    snippet,
-                });
-            }
-            continue;
-        }
-        const { resolved } = resolveRef(ref.target, sectionIds, fileIndex, slugIndex);
-        const resolvedLower = resolved.toLowerCase();
-        if (seen.has(resolvedLower))
-            continue;
-        seen.add(resolvedLower);
-        const targetSection = flat.find((s) => s.id.toLowerCase() === resolvedLower);
-        if (targetSection) {
-            outgoingRefs.push({ target: ref.target, resolved: targetSection });
-        }
-    }
-    // Find incoming references: other sections that link to this one
-    const incomingRefs = [];
-    const files = await listLatticeFiles(ctx.latDir);
-    const incomingSections = new Set();
-    for (const file of files) {
-        const fc = await readFile(file, 'utf-8');
-        const fileRefs = extractRefs(file, fc, ctx.projectRoot);
-        for (const ref of fileRefs) {
-            const { resolved } = resolveRef(ref.target, sectionIds, fileIndex, slugIndex);
-            if (resolved.toLowerCase() === sectionId &&
-                ref.fromSection.toLowerCase() !== sectionId) {
-                if (!incomingSections.has(ref.fromSection.toLowerCase())) {
-                    incomingSections.add(ref.fromSection.toLowerCase());
-                    const fromSection = flat.find((s) => s.id.toLowerCase() === ref.fromSection.toLowerCase());
-                    if (fromSection) {
-                        incomingRefs.push({ section: fromSection, reason: 'wiki link' });
-                    }
-                }
-            }
-        }
-    }
-    // Find code back-references: @lat: comments pointing to this section
-    const codeRefs = [];
-    const { refs: scannedRefs } = await scanCodeRefs(ctx.projectRoot);
-    for (const ref of scannedRefs) {
-        const { resolved: codeResolved } = resolveRef(ref.target, sectionIds, fileIndex, slugIndex);
-        if (codeResolved.toLowerCase() === sectionId) {
-            const absFile = join(ctx.projectRoot, ref.file);
-            let snippet = '';
-            try {
-                const src = await readFile(absFile, 'utf-8');
-                const srcLines = src.split('\n');
-                const start = Math.max(0, ref.line - 1 - 2);
-                const end = Math.min(srcLines.length, ref.line - 1 + 3);
-                snippet = srcLines.slice(start, end).join('\n');
-            }
-            catch {
-                // file unreadable — skip snippet
-            }
-            codeRefs.push({ file: ref.file, line: ref.line, snippet });
-        }
-    }
-    return {
-        kind: 'found',
-        section,
-        content,
-        status: provenanceNote(fileContent),
-        outgoingRefs,
-        outgoingSourceRefs,
-        incomingRefs,
-        codeRefs,
-    };
-}
-function fullEndLine(section) {
-    if (section.children.length === 0)
-        return section.endLine;
-    return fullEndLine(section.children[section.children.length - 1]);
-}
-function truncate(s, max) {
-    return s.length > max ? s.slice(0, max) + '...' : s;
-}
-/**
- * Format a successful section result with styling.
- */
-export function formatSectionOutput(ctx, result) {
-    const s = ctx.styler;
-    const { section, content, status, outgoingRefs, outgoingSourceRefs, incomingRefs, codeRefs, } = result;
-    const relPath = relative(process.cwd(), join(ctx.projectRoot, section.filePath));
-    const loc = `${s.cyan(relPath)}${s.dim(`:${section.startLine}-${section.endLine}`)}`;
-    const quoted = content
-        .split('\n')
-        .map((line) => (line ? `> ${line}` : '>'))
-        .join('\n');
-    const parts = [
-        `${s.bold('[[' + formatSectionId(section.id, s) + ']]')} (${loc})`,
-    ];
-    // Above the text, not below it: a reader who acts on the first line of a
-    // quoted section has already acted before a trailing caveat reaches them.
-    if (status)
-        parts.push(formatProvenanceNote(status, s));
-    parts.push('', quoted);
-    if (outgoingRefs.length > 0 || outgoingSourceRefs.length > 0) {
-        parts.push('', '## This section references:', '');
-        for (const ref of outgoingRefs) {
-            const body = ref.resolved.firstParagraph
-                ? ` ${s.dim('—')} ${truncate(ref.resolved.firstParagraph, 120)}`
-                : '';
-            parts.push(`${s.dim('*')} [[${formatSectionId(ref.resolved.id, s)}]]${body}`);
-        }
-        for (const ref of outgoingSourceRefs) {
-            const loc = ref.line
-                ? ref.endLine && ref.endLine !== ref.line
-                    ? `${s.dim(` (${ref.file}:${ref.line}-${ref.endLine})`)}`
-                    : `${s.dim(` (${ref.file}:${ref.line})`)}`
-                : `${s.dim(` (${ref.file})`)}`;
-            parts.push(`${s.dim('*')} [[${s.cyan(ref.target)}]]${loc}`);
-            if (ref.snippet) {
-                const snippetLines = ref.snippet.split('\n');
-                for (const line of snippetLines) {
-                    parts.push(`  ${s.dim('|')} ${line}`);
-                }
-            }
-        }
-    }
-    if (incomingRefs.length > 0) {
-        parts.push('', '## Referenced by:', '');
-        for (const ref of incomingRefs) {
-            const body = ref.section.firstParagraph
-                ? ` ${s.dim('—')} ${truncate(ref.section.firstParagraph, 120)}`
-                : '';
-            parts.push(`${s.dim('*')} [[${formatSectionId(ref.section.id, s)}]]${body}`);
-        }
-    }
-    if (codeRefs.length > 0) {
-        parts.push('', '## Referenced by code:', '');
-        for (const ref of codeRefs) {
-            const codeRelPath = relative(process.cwd(), join(ctx.projectRoot, ref.file));
-            parts.push(`${s.dim('*')} ${s.cyan(codeRelPath)}${s.dim(`:${ref.line}`)}`);
-            if (ref.snippet) {
-                const snippetLines = ref.snippet.split('\n');
-                for (const line of snippetLines) {
-                    parts.push(`  ${s.dim('|')} ${line}`);
-                }
-            }
-        }
-    }
-    parts.push(formatNavHints(ctx));
-    return parts.join('\n');
-}
-export async function sectionCommand(ctx, query) {
-    const result = await getSection(ctx, query);
-    if (result.kind === 'no-match') {
-        const s = ctx.styler;
-        if (result.suggestions.length > 0) {
-            const suggestions = result.suggestions
-                .map((m) => `  ${s.dim('*')} ${s.white(m.section.id)} ${s.dim(`(${m.reason})`)}`)
-                .join('\n');
-            return {
-                output: s.red(`No section "${query}" found.`) +
-                    ' Did you mean:\n' +
-                    suggestions,
-                isError: true,
-            };
-        }
-        return {
-            output: s.red(`No sections matching "${query}"`),
-            isError: true,
-        };
-    }
-    return { output: formatSectionOutput(ctx, result) };
-}

package/dist/src/cli/select-menu.d.ts

@@ -1,13 +0,0 @@
-export interface SelectOption {
-    label: string;
-    value: string;
-    /** If true, this option uses a distinct highlight style (e.g. for "done" actions). */
-    accent?: boolean;
-}
-/**
- * Display an interactive select menu with arrow-key navigation.
- * Returns the selected option's value, or null if the user pressed Ctrl+C.
- *
- * @param defaultIndex - initial cursor position (defaults to 0)
- */
-export declare function selectMenu(options: SelectOption[], prompt?: string, defaultIndex?: number): Promise<string | null>;

package/dist/src/cli/select-menu.js

@@ -1,100 +0,0 @@
-import { styleText } from 'node:util';
-/**
- * Display an interactive select menu with arrow-key navigation.
- * Returns the selected option's value, or null if the user pressed Ctrl+C.
- *
- * @param defaultIndex - initial cursor position (defaults to 0)
- */
-export async function selectMenu(options, prompt, defaultIndex) {
-    if (options.length === 0)
-        return null;
-    if (!process.stdin.isTTY) {
-        // Non-interactive fallback: return first option
-        return options[0].value;
-    }
-    return new Promise((resolve) => {
-        let cursor = defaultIndex ?? 0;
-        const stdin = process.stdin;
-        // Save original stdin state
-        const wasRaw = stdin.isRaw;
-        stdin.setRawMode(true);
-        stdin.resume();
-        stdin.setEncoding('utf-8');
-        function render() {
-            process.stdout.write('\x1B[?25l'); // hide cursor
-            const lines = [];
-            if (prompt) {
-                lines.push(styleText('bold', prompt));
-            }
-            for (let i = 0; i < options.length; i++) {
-                const opt = options[i];
-                const selected = i === cursor;
-                const pointer = selected ? '❯' : ' ';
-                if (selected) {
-                    if (opt.accent) {
-                        lines.push(`  ${pointer} ${styleText(['bgGreen', 'black', 'bold'], ` ${opt.label} `)}`);
-                    }
-                    else {
-                        lines.push(`  ${pointer} ${styleText(['bgCyan', 'black', 'bold'], ` ${opt.label} `)}`);
-                    }
-                }
-                else {
-                    lines.push(`  ${pointer} ${styleText('dim', opt.label)}`);
-                }
-            }
-            process.stdout.write(lines.join('\n') + '\n');
-        }
-        function clearRender() {
-            const totalLines = options.length + (prompt ? 1 : 0);
-            // Move up and clear each line
-            for (let i = 0; i < totalLines; i++) {
-                process.stdout.write('\x1B[A\x1B[2K');
-            }
-        }
-        function cleanup() {
-            stdin.setRawMode(wasRaw ?? false);
-            stdin.pause();
-            process.stdout.write('\x1B[?25h'); // show cursor
-            stdin.removeListener('data', onData);
-        }
-        function onData(data) {
-            const key = data.toString();
-            // Ctrl+C
-            if (key === '\x03') {
-                clearRender();
-                cleanup();
-                console.log('');
-                process.exit(130);
-            }
-            // Enter
-            if (key === '\r' || key === '\n') {
-                clearRender();
-                cleanup();
-                const selected = options[cursor];
-                // Print the selection
-                if (prompt) {
-                    console.log(styleText('bold', prompt) +
-                        ' ' +
-                        styleText('green', selected.label));
-                }
-                resolve(selected.value);
-                return;
-            }
-            // Arrow keys (escape sequences)
-            if (key === '\x1B[A' || key === 'k') {
-                // Up
-                clearRender();
-                cursor = (cursor - 1 + options.length) % options.length;
-                render();
-            }
-            else if (key === '\x1B[B' || key === 'j') {
-                // Down
-                clearRender();
-                cursor = (cursor + 1) % options.length;
-                render();
-            }
-        }
-        stdin.on('data', onData);
-        render();
-    });
-}

package/dist/src/code-refs.d.ts

@@ -1,17 +0,0 @@
-/** Walk project files for code-ref scanning. Uses walkEntries for .gitignore
- *  support, then additionally skips .md files, lat.md/, .claude/, and sub-projects. */
-export declare function walkFiles(dir: string): Promise<string[]>;
-export declare const LAT_REF_RE: RegExp;
-export type CodeRef = {
-    target: string;
-    file: string;
-    line: number;
-};
-export type ScanResult = {
-    refs: CodeRef[];
-    files: string[];
-    usedRg: boolean;
-};
-/** Check whether ripgrep (`rg`) is available on PATH. */
-export declare function hasRipgrep(): Promise<boolean>;
-export declare function scanCodeRefs(projectRoot: string): Promise<ScanResult>;