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

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

@@ -1,11 +0,0 @@
-import type { CmdContext, Styler } from '../context.js';
-export type { CmdContext };
-export declare function makeStyler(): Styler;
-export declare function resolveContext(opts: {
-    dir?: string;
-    color?: boolean;
-}): CmdContext;
-export declare function resolveCheckContext(opts: {
-    dir?: string;
-    color?: boolean;
-}, target?: string): CmdContext;

package/dist/src/cli/context.js

@@ -1,58 +0,0 @@
-import { statSync } from 'node:fs';
-import { dirname, resolve } from 'node:path';
-import { styleText } from 'node:util';
-import { findLatticeDir } from '../project-discovery.js';
-export function makeStyler() {
-    return {
-        bold: (s) => styleText('bold', s),
-        dim: (s) => styleText('dim', s),
-        red: (s) => styleText('red', s),
-        cyan: (s) => styleText('cyan', s),
-        white: (s) => styleText('white', s),
-        green: (s) => styleText('green', s),
-        yellow: (s) => styleText('yellow', s),
-        boldWhite: (s) => styleText(['bold', 'white'], s),
-    };
-}
-export function resolveContext(opts) {
-    const color = opts.color !== false;
-    if (!color) {
-        process.env.NO_COLOR = '1';
-    }
-    const latDir = findLatticeDir(opts.dir) ?? '';
-    if (!latDir) {
-        console.error(styleText('red', 'No lat.md directory found'));
-        console.error(styleText('dim', 'Run `lat init` to create one.'));
-        process.exit(1);
-    }
-    const projectRoot = dirname(latDir);
-    return { latDir, projectRoot, styler: makeStyler(), mode: 'cli' };
-}
-export function resolveCheckContext(opts, target) {
-    if (target === undefined)
-        return resolveContext(opts);
-    if (opts.color === false) {
-        process.env.NO_COLOR = '1';
-    }
-    const projectRoot = resolve(opts.dir ?? process.cwd());
-    const latDir = resolve(projectRoot, target);
-    try {
-        if (!statSync(latDir).isDirectory()) {
-            console.error(styleText('red', `Check target is not a directory: ${target}`));
-            process.exit(1);
-        }
-    }
-    catch (error) {
-        if (error.code !== 'ENOENT')
-            throw error;
-        console.error(styleText('red', `Check directory not found: ${target}`));
-        process.exit(1);
-    }
-    return {
-        latDir,
-        projectRoot,
-        styler: makeStyler(),
-        mode: 'cli',
-        headless: true,
-    };
-}

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

@@ -1,7 +0,0 @@
-import type { CmdContext, CmdResult } from '../context.js';
-/**
- * Resolve [[refs]] in text and return the expanded output.
- * Returns null if there are no wiki links, or if resolution fails.
- */
-export declare function expandPrompt(ctx: CmdContext, text: string): Promise<string | null>;
-export declare function expandCommand(ctx: CmdContext, text: string): Promise<CmdResult>;

package/dist/src/cli/expand.js

@@ -1,141 +0,0 @@
-import { join, relative } from 'node:path';
-import { findSections, } from '../lattice-model.js';
-import { UNTRUSTED_NOTICE, quoteUntrusted, cleanUntrustedId, } from '../untrusted.js';
-import { commandProjectAnalysis, commandProjectSession, } from '../project-analysis.js';
-const WIKI_LINK_RE = /\[\[([^\]]+)\]\]/g;
-function formatLocation(section, projectRoot) {
-    const relPath = relative(process.cwd(), join(projectRoot, section.filePath));
-    return `${cleanUntrustedId(relPath)}:${section.startLine}-${section.endLine}`;
-}
-/**
- * Resolve [[refs]] in text and return the expanded output.
- * Returns null if there are no wiki links, or if resolution fails.
- */
-export async function expandPrompt(ctx, text) {
-    const refs = [...text.matchAll(WIKI_LINK_RE)];
-    if (refs.length === 0)
-        return null;
-    const { allSections } = await commandProjectAnalysis(ctx);
-    const resolved = new Map();
-    const externalResolved = new Map();
-    const external = await commandProjectSession(ctx).external();
-    const errors = [];
-    for (const match of refs) {
-        const target = match[1];
-        if (resolved.has(target) || externalResolved.has(target))
-            continue;
-        try {
-            if (external.parse(target)) {
-                externalResolved.set(target, await external.resolve(target));
-                continue;
-            }
-        }
-        catch (error) {
-            errors.push(error.message);
-            continue;
-        }
-        const unknownExternal = external.unknownTargetMessage(target);
-        if (unknownExternal) {
-            errors.push(unknownExternal);
-            continue;
-        }
-        const matches = findSections(allSections, target);
-        if (matches.length >= 1) {
-            resolved.set(target, {
-                target,
-                best: matches[0],
-                alternatives: matches.slice(1),
-            });
-        }
-        else {
-            errors.push(`No section found for [[${target}]]`);
-        }
-    }
-    if (errors.length > 0)
-        return null;
-    // Replace [[refs]] inline
-    let output = text.replace(WIKI_LINK_RE, (_match, target) => {
-        if (externalResolved.has(target))
-            return `[[${target}]]`;
-        const ref = resolved.get(target);
-        return `[[${cleanUntrustedId(ref.best.section.id)}]]`;
-    });
-    // Append context block as nested outliner
-    output += '\n\n<lat-context>\n';
-    output += UNTRUSTED_NOTICE + '\n';
-    for (const [target, value] of externalResolved) {
-        output += `* \`[[${target}]]\` is referring to:\n`;
-        output += `  * ${value.source.repo} @ ${value.source.commit} via ${value.provider}\n`;
-        output += `    * ${value.target.repositoryPath}:${value.startLine}-${value.endLine}\n`;
-        for (const line of value.content.split('\n'))
-            output += `    | ${line}\n`;
-    }
-    for (const ref of resolved.values()) {
-        const isExact = ref.best.reason === 'exact match' ||
-            ref.best.reason.startsWith('file stem expanded');
-        const all = isExact ? [ref.best] : [ref.best, ...ref.alternatives];
-        if (isExact) {
-            output += `* \`[[${ref.target}]]\` is referring to:\n`;
-        }
-        else {
-            output += `* \`[[${ref.target}]]\` might be referring to either of the following:\n`;
-        }
-        for (const m of all) {
-            const reason = isExact ? '' : ` (${cleanUntrustedId(m.reason)})`;
-            output += `  * [[${cleanUntrustedId(m.section.id)}]]${reason}\n`;
-            output += `    * ${formatLocation(m.section, ctx.projectRoot)}\n`;
-            if (m.section.firstParagraph) {
-                output += `    * ${quoteUntrusted(m.section.firstParagraph)}\n`;
-            }
-        }
-    }
-    output += '</lat-context>\n';
-    return output;
-}
-export async function expandCommand(ctx, text) {
-    const result = await expandPrompt(ctx, text);
-    if (result === null) {
-        const refs = [...text.matchAll(WIKI_LINK_RE)];
-        if (refs.length === 0) {
-            return { output: text };
-        }
-        // Resolution failed — find which ref is broken
-        const { allSections } = await commandProjectAnalysis(ctx);
-        const external = await commandProjectSession(ctx).external();
-        for (const match of refs) {
-            const target = match[1];
-            try {
-                if (external.parse(target)) {
-                    await external.resolve(target);
-                    continue;
-                }
-            }
-            catch (error) {
-                return {
-                    output: ctx.styler.red(error.message),
-                    isError: true,
-                };
-            }
-            const unknownExternal = external.unknownTargetMessage(target);
-            if (unknownExternal) {
-                return {
-                    output: ctx.styler.red(unknownExternal),
-                    isError: true,
-                };
-            }
-            const matches = findSections(allSections, target);
-            if (matches.length === 0) {
-                const s = ctx.styler;
-                return {
-                    output: s.red(`No section found for [[${target}]]`) +
-                        ' (no exact, substring, or fuzzy matches).\n' +
-                        s.dim('Ask the user to correct the reference.'),
-                    isError: true,
-                };
-            }
-        }
-        // All refs matched individually but expansion still failed — shouldn't happen
-        return { output: text };
-    }
-    return { output: result };
-}

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

@@ -1,11 +0,0 @@
-import type { CmdContext, CmdResult } from '../context.js';
-export type ExternalAddOptions = {
-    commit?: string;
-    prefix?: string;
-    defaultFileExtension?: string;
-    strategy?: string;
-    fetchUrl?: string;
-};
-export declare function externalListCommand(ctx: CmdContext, json?: boolean): Promise<CmdResult>;
-export declare function externalShowCommand(ctx: CmdContext, query: string, json?: boolean): Promise<CmdResult>;
-export declare function externalAddCommand(ctx: CmdContext, handleValue: string | undefined, repoValue: string | undefined, options: ExternalAddOptions): Promise<CmdResult>;

package/dist/src/cli/external.js

@@ -1,185 +0,0 @@
-import { createInterface } from 'node:readline/promises';
-import { addCanonicalExternalSource, describeExternalSources, inferExternalFetchUrl, loadExternalSources, normalizeExternalDefaultFileExtension, normalizeExternalRepoUrl, parseExternalTarget, resolveExternalCommit, } from '../external-sources.js';
-import { selectMenu } from './select-menu.js';
-function shellArg(value) {
-    return /^[a-zA-Z0-9_./:@=-]+$/.test(value)
-        ? value
-        : `'${value.replaceAll("'", "'\\''")}'`;
-}
-function formatDescription(value) {
-    const lines = [
-        `${value.handle}`,
-        `  Repository: ${value.repo}`,
-        `  Commit: ${value.effectiveCommit}${value.effectiveCommit !== value.canonicalCommit ? ` (canonical: ${value.canonicalCommit})` : ''}`,
-        `  Strategy: ${value.effectiveStrategy}${value.effectiveStrategy !== value.strategy ? ` (canonical: ${value.strategy})` : ''}`,
-        `  Prefix: ${value.prefix || '(none)'}`,
-        `  Default file extension: ${value.defaultFileExtension || '(none)'}`,
-        `  Cache: ${value.cache ? `${value.cache.strategy} @ ${value.cache.commit}` : '(empty)'}`,
-    ];
-    if (value.fetchUrl)
-        lines.push(`  Fetch URL: ${value.fetchUrl}`);
-    if (value.localPath)
-        lines.push(`  Local path: ${value.localPath}`);
-    if (value.localError)
-        lines.push(`  Local error: ${value.localError}`);
-    lines.push('  Suggested checkout:');
-    for (const command of value.checkout) {
-        lines.push(`    ${[command.command, ...command.args].map(shellArg).join(' ')}`);
-    }
-    return lines.join('\n');
-}
-export async function externalListCommand(ctx, json = false) {
-    const snapshot = await loadExternalSources(ctx.latDir, ctx.projectRoot);
-    if (!snapshot.validCanonical) {
-        return {
-            output: snapshot.errors
-                .map((error) => `${error.file}: ${error.message}`)
-                .join('\n'),
-            isError: true,
-        };
-    }
-    const descriptions = describeExternalSources(ctx.latDir, snapshot);
-    return {
-        output: json
-            ? JSON.stringify(descriptions, null, 2)
-            : descriptions.length
-                ? descriptions.map(formatDescription).join('\n\n')
-                : 'No external sources configured',
-    };
-}
-export async function externalShowCommand(ctx, query, json = false) {
-    const snapshot = await loadExternalSources(ctx.latDir, ctx.projectRoot);
-    const colon = query.indexOf(':');
-    const handle = colon === -1 ? query : query.slice(0, colon);
-    const source = describeExternalSources(ctx.latDir, snapshot).find((item) => item.handle === handle);
-    if (!source) {
-        return {
-            output: `External source "${handle}" is not configured`,
-            isError: true,
-        };
-    }
-    let target = null;
-    if (colon !== -1) {
-        try {
-            target = parseExternalTarget(query, snapshot);
-        }
-        catch (error) {
-            return { output: error.message, isError: true };
-        }
-    }
-    const value = target
-        ? {
-            ...source,
-            target: target.identity,
-            repositoryPath: target.repositoryPath,
-        }
-        : source;
-    return {
-        output: json
-            ? JSON.stringify(value, null, 2)
-            : formatDescription(source) +
-                (target
-                    ? `\n  Target: ${target.identity}\n  Repository path: ${target.repositoryPath}`
-                    : ''),
-    };
-}
-async function question(rl, label, current) {
-    if (current)
-        return current;
-    const answer = (await rl.question(`${label}: `)).trim();
-    if (!answer)
-        throw new Error(`${label} is required`);
-    return answer;
-}
-export async function externalAddCommand(ctx, handleValue, repoValue, options) {
-    const interactive = !!process.stdin.isTTY;
-    if (!interactive &&
-        (!handleValue || !repoValue || !options.commit || !options.strategy)) {
-        return {
-            output: 'Non-interactive use requires handle, repo, --commit, and --strategy',
-            isError: true,
-        };
-    }
-    let rl = null;
-    const getReadline = () => {
-        rl ??= createInterface({ input: process.stdin, output: process.stdout });
-        return rl;
-    };
-    const closeReadline = () => {
-        rl?.close();
-        rl = null;
-    };
-    try {
-        const handle = await question(getReadline(), 'Handle', handleValue);
-        const repo = normalizeExternalRepoUrl(await question(getReadline(), 'Repository', repoValue));
-        const ref = await question(getReadline(), 'Commit or ref', options.commit);
-        const prefix = options.prefix ??
-            (interactive
-                ? (await getReadline().question('Prefix (optional): ')).trim()
-                : '');
-        const defaultFileExtensionValue = options.defaultFileExtension ??
-            (interactive
-                ? (await getReadline().question('Default file extension (optional): ')).trim()
-                : '');
-        const defaultFileExtension = defaultFileExtensionValue
-            ? normalizeExternalDefaultFileExtension(defaultFileExtensionValue)
-            : '';
-        let strategy = options.strategy;
-        if (!strategy && interactive) {
-            const inferred = inferExternalFetchUrl(repo);
-            // selectMenu reads raw keypresses directly. Detach readline first so it
-            // cannot consume the selection's Enter key or remain paused afterward.
-            closeReadline();
-            strategy =
-                (await selectMenu(inferred
-                    ? [
-                        {
-                            label: 'Fetch individual files (recommended)',
-                            value: 'fetch',
-                        },
-                        { label: 'Use a Lat-managed checkout', value: 'checkout' },
-                    ]
-                    : [
-                        {
-                            label: 'Use a Lat-managed checkout (recommended)',
-                            value: 'checkout',
-                        },
-                        { label: 'Fetch individual files', value: 'fetch' },
-                    ], 'How should Lat read this source?')) ?? undefined;
-        }
-        if (strategy !== 'fetch' && strategy !== 'checkout') {
-            return { output: 'strategy must be fetch or checkout', isError: true };
-        }
-        let fetchUrl = options.fetchUrl;
-        if (strategy === 'fetch' &&
-            !fetchUrl &&
-            !inferExternalFetchUrl(repo) &&
-            interactive) {
-            fetchUrl = await question(getReadline(), 'Fetch URL template');
-        }
-        const commit = await resolveExternalCommit(repo, ref);
-        if (interactive) {
-            const confirmation = (await getReadline().question(`Add external source "${handle}" at commit "${commit}" using "${strategy}"? [Y/n] `))
-                .trim()
-                .toLowerCase();
-            if (confirmation === 'n' || confirmation === 'no')
-                return { output: 'Aborted' };
-        }
-        await addCanonicalExternalSource(ctx.latDir, {
-            handle,
-            repo,
-            commit,
-            ...(prefix ? { prefix } : {}),
-            ...(defaultFileExtension ? { defaultFileExtension } : {}),
-            strategy: strategy,
-            ...(fetchUrl ? { fetchUrl } : {}),
-        });
-        return { output: `Added external source ${handle} at ${commit}` };
-    }
-    catch (error) {
-        return { output: error.message, isError: true };
-    }
-    finally {
-        closeReadline();
-    }
-}

package/dist/src/cli/gen-index.d.ts

@@ -1,45 +0,0 @@
-export declare function mdEscapeLabel(value: string): string;
-export declare function mdEscapeDest(value: string): string;
-export type IndexEntrySource = {
-    /** Filesystem entry name: "notes.md" for a file, "guides" for a directory. */
-    name: string;
-    /**
-     * Link destination relative to the index file being written: the child's
-     * own filename ("notes.md"), or its own index file for a directory
-     * ("guides/guides.md"). This is what actually resolves on disk — unlike
-     * the wiki-link stem, it keeps the .md extension.
-     */
-    dest: string;
-    /** Absolute path to read the title/summary from (the file itself, or a directory's own index file). */
-    readFrom: string;
-};
-/**
- * Render the generated bullet list for a directory index, one entry per
- * child, sorted by title. Each entry links through the wiki-link stem
- * (`entryToStem`-compatible) using a real Markdown link so the title can
- * carry a human-written summary — which is exactly why it must be escaped:
- * the title is repository text landing inside `[...]`.
- */
-export declare function renderIndexEntries(entries: IndexEntrySource[]): Promise<string>;
-/**
- * Compute, for each line, whether it lies inside a fenced code block.
- * Marker and bullet-run detection must skip fenced lines — otherwise a
- * documentation example that shows the marker syntax (or a sample bullet
- * list) inside a ``` block gets mistaken for the real thing and rewritten.
- */
-export declare function fencedLineMask(lines: string[]): boolean[];
-export type SpliceResult = {
-    ok: true;
-    content: string;
-} | {
-    ok: false;
-    message: string;
-};
-/**
- * Splice a freshly rendered entry list into an index file's content inside
- * `<!-- lat:index:begin -->` / `<!-- lat:index:end -->` markers, preserving
- * everything outside that region byte for byte. An unmarked file is
- * migrated by wrapping the first contiguous run of local index entry
- * bullets; a malformed marker pair is refused rather than guessed at.
- */
-export declare function spliceIndexContent(existingContent: string | null, dirLabel: string, renderedList: string): SpliceResult;