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

package/dist/src/config.js

@@ -1,83 +0,0 @@
-import { execSync } from 'node:child_process';
-import { existsSync, readFileSync, writeFileSync, mkdirSync } from 'node:fs';
-import { join, resolve } from 'node:path';
-import xdg from '@folder/xdg';
-// ── XDG config directory ────────────────────────────────────────────
-export function getConfigDir() {
-    return join(xdg().config, 'lat');
-}
-export function getConfigPath() {
-    return join(getConfigDir(), 'config.json');
-}
-export function readConfig() {
-    const configPath = getConfigPath();
-    if (!existsSync(configPath))
-        return {};
-    try {
-        return JSON.parse(readFileSync(configPath, 'utf-8'));
-    }
-    catch (err) {
-        process.stderr.write(`Error: failed to parse config ${configPath}: ${err.message}\n`);
-        process.exit(1);
-    }
-}
-export function writeConfig(config) {
-    const dir = getConfigDir();
-    mkdirSync(dir, { recursive: true });
-    writeFileSync(getConfigPath(), JSON.stringify(config, null, 2) + '\n');
-}
-// ── Per-repo embedding backend preference ───────────────────────────
-/** Durable per-repo backend choice, or undefined if none recorded. */
-export function getRepoEmbedding(latDir) {
-    return readConfig().repos?.[resolve(latDir)]?.embedding;
-}
-/** Record (or clear, with `null`) the durable per-repo backend choice. */
-export function setRepoEmbedding(latDir, embedding) {
-    const key = resolve(latDir);
-    const config = readConfig();
-    const repos = config.repos ?? {};
-    if (embedding === null)
-        delete repos[key];
-    else
-        repos[key] = { embedding };
-    config.repos = repos;
-    writeConfig(config);
-}
-// ── Centralized LLM key resolution ─────────────────────────────────
-/**
- * Returns the LLM key from (in priority order):
- * 1. LAT_LLM_KEY environment variable
- * 2. LAT_LLM_KEY_FILE — path to a file containing the key
- * 3. LAT_LLM_KEY_HELPER — shell command that prints the key
- * 4. llm_key field in ~/.config/lat/config.json
- *
- * Returns undefined if none is set.
- */
-export function getLlmKey() {
-    const envKey = process.env.LAT_LLM_KEY;
-    if (envKey)
-        return envKey;
-    const file = process.env.LAT_LLM_KEY_FILE;
-    if (file) {
-        const content = readFileSync(file, 'utf-8').trim();
-        if (!content) {
-            throw new Error(`LAT_LLM_KEY_FILE (${file}) is empty.`);
-        }
-        return content;
-    }
-    const helper = process.env.LAT_LLM_KEY_HELPER;
-    if (helper) {
-        const result = execSync(helper, {
-            encoding: 'utf-8',
-            timeout: 10_000,
-        }).trim();
-        if (!result) {
-            throw new Error('LAT_LLM_KEY_HELPER command returned an empty string.');
-        }
-        return result;
-    }
-    const config = readConfig();
-    if (config.llm_key)
-        return config.llm_key;
-    return undefined;
-}

package/dist/src/context.d.ts

@@ -1,26 +0,0 @@
-import type { MarkdownProjectSession } from './project-analysis.js';
-export type Styler = {
-    bold: (s: string) => string;
-    dim: (s: string) => string;
-    red: (s: string) => string;
-    cyan: (s: string) => string;
-    white: (s: string) => string;
-    green: (s: string) => string;
-    yellow: (s: string) => string;
-    boldWhite: (s: string) => string;
-};
-export declare const plainStyler: Styler;
-export type CmdContext = {
-    latDir: string;
-    projectRoot: string;
-    styler: Styler;
-    mode: 'cli' | 'mcp';
-    /** The check target was supplied explicitly instead of discovered as lat.md. */
-    headless?: boolean;
-    /** Lazy Markdown analysis shared by nested operations in this request. */
-    analysis?: MarkdownProjectSession;
-};
-export type CmdResult = {
-    output: string;
-    isError?: boolean;
-};

package/dist/src/context.js

@@ -1,11 +0,0 @@
-const identity = (s) => s;
-export const plainStyler = {
-    bold: identity,
-    dim: identity,
-    red: identity,
-    cyan: identity,
-    white: identity,
-    green: identity,
-    yellow: identity,
-    boldWhite: identity,
-};

package/dist/src/document-formats.d.ts

@@ -1,7 +0,0 @@
-/** Document formats that external sources can resolve by heading. */
-export declare const DOCUMENT_FILE_EXTENSIONS: ReadonlySet<string>;
-export type DocumentFormat = 'asciidoc' | 'markdown' | 'restructuredtext';
-export declare function documentFormat(path: string): DocumentFormat | null;
-export declare function isDocumentPath(path: string): boolean;
-export declare function stripDocumentExtension(path: string): string;
-export declare function documentFormatLabel(format: DocumentFormat): string;

package/dist/src/document-formats.js

@@ -1,39 +0,0 @@
-/** Document formats that external sources can resolve by heading. */
-export const DOCUMENT_FILE_EXTENSIONS = new Set([
-    '.adoc',
-    '.asciidoc',
-    '.md',
-    '.rst',
-]);
-export function documentFormat(path) {
-    const lower = path.toLowerCase();
-    if (lower.endsWith('.md'))
-        return 'markdown';
-    if (lower.endsWith('.rst'))
-        return 'restructuredtext';
-    if (lower.endsWith('.adoc') || lower.endsWith('.asciidoc')) {
-        return 'asciidoc';
-    }
-    return null;
-}
-export function isDocumentPath(path) {
-    return documentFormat(path) !== null;
-}
-export function stripDocumentExtension(path) {
-    const lower = path.toLowerCase();
-    for (const extension of DOCUMENT_FILE_EXTENSIONS) {
-        if (lower.endsWith(extension))
-            return path.slice(0, -extension.length);
-    }
-    return path;
-}
-export function documentFormatLabel(format) {
-    switch (format) {
-        case 'asciidoc':
-            return 'AsciiDoc';
-        case 'markdown':
-            return 'Markdown';
-        case 'restructuredtext':
-            return 'reStructuredText';
-    }
-}

package/dist/src/extensions/alert-marker.d.ts

@@ -1,25 +0,0 @@
-import type { Data, Literal, Root } from 'mdast';
-import type { Options } from 'mdast-util-to-markdown';
-export declare const ALERT_KINDS: readonly ["NOTE", "TIP", "IMPORTANT", "WARNING", "CAUTION"];
-export type AlertKind = (typeof ALERT_KINDS)[number];
-export interface AlertMarker extends Literal {
-    type: 'alertMarker';
-    value: AlertKind;
-    data?: Data;
-}
-/** Promote GitHub alert markers so serialization does not escape their brackets. */
-export declare function markAlertMarkers(tree: Root): void;
-export declare function alertMarkerToMarkdown(): Options;
-declare module 'mdast' {
-    interface RootContentMap {
-        alertMarker: AlertMarker;
-    }
-    interface PhrasingContentMap {
-        alertMarker: AlertMarker;
-    }
-}
-declare module 'mdast-util-to-markdown' {
-    interface ConstructNameMap {
-        alertMarker: 'alertMarker';
-    }
-}

package/dist/src/extensions/alert-marker.js

@@ -1,55 +0,0 @@
-import { visit } from 'unist-util-visit';
-export const ALERT_KINDS = [
-    'NOTE',
-    'TIP',
-    'IMPORTANT',
-    'WARNING',
-    'CAUTION',
-];
-const ALERT_PATTERN = /^\[!(NOTE|TIP|IMPORTANT|WARNING|CAUTION)\](?:\r?\n|$)/;
-/** Promote GitHub alert markers so serialization does not escape their brackets. */
-export function markAlertMarkers(tree) {
-    visit(tree, 'blockquote', (node) => {
-        const firstBlock = node.children[0];
-        if (firstBlock?.type !== 'paragraph')
-            return;
-        const firstInline = firstBlock.children[0];
-        if (firstInline?.type !== 'text')
-            return;
-        const match = firstInline.value.match(ALERT_PATTERN);
-        if (!match)
-            return;
-        const marker = {
-            type: 'alertMarker',
-            value: match[1],
-        };
-        const start = firstInline.position?.start;
-        if (start) {
-            const markerLength = match[0].replace(/\r?\n$/, '').length;
-            marker.position = {
-                start,
-                end: {
-                    line: start.line,
-                    column: start.column + markerLength,
-                    ...(start.offset === undefined
-                        ? {}
-                        : { offset: start.offset + markerLength }),
-                },
-            };
-        }
-        const remaining = firstInline.value.slice(match[0].length);
-        const replacement = [marker];
-        if (remaining !== '')
-            replacement.push({ type: 'text', value: remaining });
-        firstBlock.children.splice(0, 1, ...replacement);
-    });
-}
-function alertMarkerHandler(node, _parent, state, _info) {
-    const exit = state.enter('alertMarker');
-    const value = `[!${node.value}]\n`;
-    exit();
-    return value;
-}
-export function alertMarkerToMarkdown() {
-    return { handlers: { alertMarker: alertMarkerHandler } };
-}

package/dist/src/extensions/wiki-link/from-markdown.d.ts

@@ -1,5 +0,0 @@
-/**
- * mdast-util extension to turn wiki-link micromark tokens into mdast nodes.
- */
-import type { Extension } from 'mdast-util-from-markdown';
-export declare function wikiLinkFromMarkdown(): Extension;

package/dist/src/extensions/wiki-link/from-markdown.js

@@ -1,34 +0,0 @@
-/**
- * mdast-util extension to turn wiki-link micromark tokens into mdast nodes.
- */
-function enterWikiLink(token) {
-    const node = {
-        type: 'wikiLink',
-        value: '',
-        data: { alias: null },
-    };
-    this.enter(node, token);
-}
-function exitWikiLinkTarget(token) {
-    const target = this.sliceSerialize(token);
-    const node = this.stack[this.stack.length - 1];
-    node.value = target;
-}
-function exitWikiLinkAlias(token) {
-    const alias = this.sliceSerialize(token);
-    const node = this.stack[this.stack.length - 1];
-    node.data.alias = alias;
-}
-function exitWikiLink(token) {
-    this.exit(token);
-}
-export function wikiLinkFromMarkdown() {
-    return {
-        enter: { wikiLink: enterWikiLink },
-        exit: {
-            wikiLinkTarget: exitWikiLinkTarget,
-            wikiLinkAlias: exitWikiLinkAlias,
-            wikiLink: exitWikiLink,
-        },
-    };
-}

package/dist/src/extensions/wiki-link/index.d.ts

@@ -1,4 +0,0 @@
-export { wikiLinkSyntax } from './syntax.js';
-export { wikiLinkFromMarkdown } from './from-markdown.js';
-export { wikiLinkToMarkdown } from './to-markdown.js';
-export type { WikiLink } from './types.js';

package/dist/src/extensions/wiki-link/index.js

@@ -1,3 +0,0 @@
-export { wikiLinkSyntax } from './syntax.js';
-export { wikiLinkFromMarkdown } from './from-markdown.js';
-export { wikiLinkToMarkdown } from './to-markdown.js';

package/dist/src/extensions/wiki-link/syntax.d.ts

@@ -1,14 +0,0 @@
-/**
- * Micromark syntax extension for wiki links: [[target]] and [[target|alias]].
- *
- * Produces the following token types:
- *   - wikiLink          (the entire construct)
- *   - wikiLinkMarker    ([[ and ]])
- *   - wikiLinkData      (everything between markers)
- *   - wikiLinkTarget    (the target portion)
- *   - wikiLinkAliasMarker (the | divider)
- *   - wikiLinkAlias     (the alias portion)
- */
-import type { Extension } from 'micromark-util-types';
-import './types.js';
-export declare function wikiLinkSyntax(): Extension;

package/dist/src/extensions/wiki-link/syntax.js

@@ -1,121 +0,0 @@
-/**
- * Micromark syntax extension for wiki links: [[target]] and [[target|alias]].
- *
- * Produces the following token types:
- *   - wikiLink          (the entire construct)
- *   - wikiLinkMarker    ([[ and ]])
- *   - wikiLinkData      (everything between markers)
- *   - wikiLinkTarget    (the target portion)
- *   - wikiLinkAliasMarker (the | divider)
- *   - wikiLinkAlias     (the alias portion)
- */
-import './types.js';
-const ALIAS_DIVIDER = '|';
-const OPEN = '[[';
-const CLOSE = ']]';
-function tokenize(effects, ok, nok) {
-    let openCursor = 0;
-    let closeCursor = 0;
-    let aliasCursor = 0;
-    let hasData = false;
-    let hasAlias = false;
-    return start;
-    function start(code) {
-        if (code !== OPEN.charCodeAt(openCursor))
-            return nok(code);
-        effects.enter('wikiLink');
-        effects.enter('wikiLinkMarker');
-        return consumeOpen(code);
-    }
-    function consumeOpen(code) {
-        if (openCursor === OPEN.length) {
-            effects.exit('wikiLinkMarker');
-            return consumeDataStart(code);
-        }
-        if (code !== OPEN.charCodeAt(openCursor))
-            return nok(code);
-        effects.consume(code);
-        openCursor++;
-        return consumeOpen;
-    }
-    function consumeDataStart(code) {
-        if (code === null || code < -2)
-            return nok(code);
-        effects.enter('wikiLinkData');
-        effects.enter('wikiLinkTarget');
-        return consumeTarget(code);
-    }
-    function consumeTarget(code) {
-        if (code === ALIAS_DIVIDER.charCodeAt(aliasCursor)) {
-            if (!hasData)
-                return nok(code);
-            effects.exit('wikiLinkTarget');
-            effects.enter('wikiLinkAliasMarker');
-            return consumeAliasMarker(code);
-        }
-        if (code === CLOSE.charCodeAt(closeCursor)) {
-            if (!hasData)
-                return nok(code);
-            effects.exit('wikiLinkTarget');
-            effects.exit('wikiLinkData');
-            effects.enter('wikiLinkMarker');
-            return consumeClose(code);
-        }
-        // No line endings or EOF inside wiki links
-        if (code === null || code < -2)
-            return nok(code);
-        if (code !== -2 && code !== -1 && code !== 32) {
-            hasData = true;
-        }
-        effects.consume(code);
-        return consumeTarget;
-    }
-    function consumeAliasMarker(code) {
-        if (aliasCursor === ALIAS_DIVIDER.length) {
-            effects.exit('wikiLinkAliasMarker');
-            effects.enter('wikiLinkAlias');
-            return consumeAlias(code);
-        }
-        if (code !== ALIAS_DIVIDER.charCodeAt(aliasCursor))
-            return nok(code);
-        effects.consume(code);
-        aliasCursor++;
-        return consumeAliasMarker;
-    }
-    function consumeAlias(code) {
-        if (code === CLOSE.charCodeAt(closeCursor)) {
-            if (!hasAlias)
-                return nok(code);
-            effects.exit('wikiLinkAlias');
-            effects.exit('wikiLinkData');
-            effects.enter('wikiLinkMarker');
-            return consumeClose(code);
-        }
-        if (code === null || code < -2)
-            return nok(code);
-        if (code !== -2 && code !== -1 && code !== 32) {
-            hasAlias = true;
-        }
-        effects.consume(code);
-        return consumeAlias;
-    }
-    function consumeClose(code) {
-        if (closeCursor === CLOSE.length) {
-            effects.exit('wikiLinkMarker');
-            effects.exit('wikiLink');
-            return ok(code);
-        }
-        if (code !== CLOSE.charCodeAt(closeCursor))
-            return nok(code);
-        effects.consume(code);
-        closeCursor++;
-        return consumeClose;
-    }
-}
-export function wikiLinkSyntax() {
-    return {
-        text: {
-            91: { tokenize }, // '[' character code
-        },
-    };
-}

package/dist/src/extensions/wiki-link/to-markdown.d.ts

@@ -1,5 +0,0 @@
-/**
- * mdast-util extension to serialize wiki-link nodes back to markdown.
- */
-import type { Options } from 'mdast-util-to-markdown';
-export declare function wikiLinkToMarkdown(): Options;

package/dist/src/extensions/wiki-link/to-markdown.js

@@ -1,28 +0,0 @@
-/**
- * mdast-util extension to serialize wiki-link nodes back to markdown.
- */
-function handler(node, _parent, state, _info) {
-    const exit = state.enter('wikiLink');
-    const target = state.safe(node.value, { before: '[', after: ']' });
-    let value;
-    if (node.data.alias) {
-        const alias = state.safe(node.data.alias, { before: '[', after: ']' });
-        value = `[[${target}|${alias}]]`;
-    }
-    else {
-        value = `[[${target}]]`;
-    }
-    exit();
-    return value;
-}
-export function wikiLinkToMarkdown() {
-    return {
-        unsafe: [
-            { character: '[', inConstruct: ['phrasing', 'label', 'reference'] },
-            { character: ']', inConstruct: ['label', 'reference'] },
-        ],
-        handlers: {
-            wikiLink: handler,
-        },
-    };
-}

package/dist/src/extensions/wiki-link/types.d.ts

@@ -1,34 +0,0 @@
-import type { Data, Literal } from 'mdast';
-/**
- * mdast node for a wiki-style link like [[target]] or [[target|alias]].
- */
-export interface WikiLink extends Literal {
-    type: 'wikiLink';
-    value: string;
-    data: Data & {
-        alias: string | null;
-    };
-}
-declare module 'mdast' {
-    interface RootContentMap {
-        wikiLink: WikiLink;
-    }
-    interface PhrasingContentMap {
-        wikiLink: WikiLink;
-    }
-}
-declare module 'micromark-util-types' {
-    interface TokenTypeMap {
-        wikiLink: 'wikiLink';
-        wikiLinkMarker: 'wikiLinkMarker';
-        wikiLinkData: 'wikiLinkData';
-        wikiLinkTarget: 'wikiLinkTarget';
-        wikiLinkAliasMarker: 'wikiLinkAliasMarker';
-        wikiLinkAlias: 'wikiLinkAlias';
-    }
-}
-declare module 'mdast-util-to-markdown' {
-    interface ConstructNameMap {
-        wikiLink: 'wikiLink';
-    }
-}

package/dist/src/extensions/wiki-link/types.js

@@ -1 +0,0 @@
-export {};

package/dist/src/external-documents.d.ts

@@ -1,56 +0,0 @@
-import { type Section } from './lattice-model.js';
-import { type DocumentFormat } from './document-formats.js';
-import type { ParserImportObserver } from './parser-import.js';
-import type { ViewDocumentTree } from './view/protocol.js';
-export type ExternalDocumentSection = {
-    title: string;
-    depth: number;
-    anchor: string;
-    aliases: string[];
-    hierarchy: string[];
-    startLine: number;
-    endLine: number;
-};
-/** Serializable document facts retained after a format parser discards its AST. */
-export type ExternalDocumentAnalysis = {
-    format: DocumentFormat;
-    title: string;
-    sections: ExternalDocumentSection[];
-};
-export type ExternalDocumentCacheStatus = 'disabled' | 'hit' | 'miss';
-export type ExternalDocumentAnalysisTimings = {
-    hashMs: number;
-    cacheReadMs: number;
-    cacheWriteMs: number;
-    parseMs: number;
-    cacheStatus: ExternalDocumentCacheStatus;
-};
-export type ExternalDocumentFileAnalysis = {
-    path: string;
-    document: ExternalDocumentAnalysis;
-    timings: ExternalDocumentAnalysisTimings;
-};
-export type AnalyzeExternalDocumentOptions = {
-    identity?: string;
-    cache?: boolean;
-    runtime?: ExternalDocumentParserRuntime;
-    onFileAnalyzed?: (analysis: ExternalDocumentFileAnalysis) => void;
-    onParserImport?: ParserImportObserver;
-};
-/** Accept legacy AsciiDoc source listings whose delimiter lengths do not match. */
-export declare function asciidocCompatibleContent(content: string): string;
-export declare function analyzeExternalDocument(path: string, content: string, onParserImport?: ParserImportObserver, importDetail?: string): Promise<ExternalDocumentAnalysis>;
-/** Request-scoped owner for external document parser work. */
-export declare class ExternalDocumentParserRuntime {
-    readonly analyses: Map<string, Promise<ExternalDocumentFileAnalysis>>;
-    clear(): void;
-}
-/** Return the shared parsed-cache path for one external document identity. */
-export declare function externalDocumentAnalysisCachePath(latDir: string, identity: string): string;
-/** Analyze an external document through the shared persistent parser cache. */
-export declare function analyzeExternalDocumentCached(path: string, content: string, latDir: string, options?: AnalyzeExternalDocumentOptions): Promise<ExternalDocumentFileAnalysis>;
-export declare function findExternalDocumentSection(analysis: ExternalDocumentAnalysis, fragment: string): ExternalDocumentSection | undefined;
-/** Project format-neutral document sections into the existing browser TOC model. */
-export declare function externalDocumentSections(path: string, analysis: ExternalDocumentAnalysis): Section[];
-/** Add zero-size alias anchors to the normalized external document tree. */
-export declare function addExternalDocumentAliasAnchors(source: ViewDocumentTree, analysis: ExternalDocumentAnalysis): ViewDocumentTree;