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

package/dist/src/fork/frontmatter-fields.d.ts

@@ -1,36 +0,0 @@
-/**
- * The fork's frontmatter surface, kept out of upstream's type module so a
- * field added later costs one edit here instead of two upstream.
- *
- * Upstream reads `require-code-mention` out of the block with a regex and asks
- * nothing else of it. This fork parses the block as YAML and hands the whole
- * `lat:` mapping to its own checks, which means it also has to report the two
- * ways that parse can go wrong.
- */
-/**
- * Every field this build reads out of the `lat:` mapping. Kept in one place so
- * a field added later is covered by the misplacement check without a second
- * edit — the trap this list guards against is silent, so it must not depend on
- * whoever adds the next field remembering to register it twice.
- */
-export declare const LAT_FIELDS: readonly ["require-code-mention", "mode", "require-mode", "status", "reviewed-hash", "tags"];
-/**
- * Something wrong with the frontmatter itself, carried out of the parser for a
- * caller to report. Both kinds fail OPEN if they stay quiet: a misplaced or
- * unparseable `require-code-mention` turns a validation off and `lat check`
- * then reports success on a file that is no longer being validated.
- */
-export type FrontmatterProblem = {
-    kind: 'root-level-field';
-    field: string;
-} | {
-    kind: 'parse-error';
-    message: string;
-};
-/** Mixed into upstream's `LatFrontmatter` rather than replacing it. */
-export type ForkFrontmatter = {
-    /** Every key under the `lat:` mapping, parsed but not mapped to a field. */
-    raw: Record<string, unknown>;
-    /** Populated only when something is wrong; absent on a healthy document. */
-    problems?: FrontmatterProblem[];
-};

package/dist/src/fork/frontmatter-fields.js

@@ -1,23 +0,0 @@
-/**
- * The fork's frontmatter surface, kept out of upstream's type module so a
- * field added later costs one edit here instead of two upstream.
- *
- * Upstream reads `require-code-mention` out of the block with a regex and asks
- * nothing else of it. This fork parses the block as YAML and hands the whole
- * `lat:` mapping to its own checks, which means it also has to report the two
- * ways that parse can go wrong.
- */
-/**
- * Every field this build reads out of the `lat:` mapping. Kept in one place so
- * a field added later is covered by the misplacement check without a second
- * edit — the trap this list guards against is silent, so it must not depend on
- * whoever adds the next field remembering to register it twice.
- */
-export const LAT_FIELDS = [
-    'require-code-mention',
-    'mode',
-    'require-mode',
-    'status',
-    'reviewed-hash',
-    'tags',
-];

package/dist/src/format.d.ts

@@ -1,16 +0,0 @@
-import type { SourceSpan } from './search/types.js';
-import type { Section, SectionMatch } from './lattice-model.js';
-import type { CmdContext, Styler } from './context.js';
-export declare function formatSectionId(id: string, s: Styler): string;
-export declare function formatSectionPreview(ctx: CmdContext, section: Section, opts?: {
-    reason?: string;
-    score?: number;
-    text?: string;
-    debug?: string;
-    spans?: SourceSpan[];
-}): string;
-export declare function formatResultList(ctx: CmdContext, header: string, matches: SectionMatch[], opts?: {
-    showScores?: boolean;
-    preview?: 'passage' | 'intro' | 'both';
-}): string;
-export declare function formatNavHints(ctx: CmdContext): string;

package/dist/src/format.js

@@ -1,76 +0,0 @@
-import { join, relative } from 'node:path';
-export function formatSectionId(id, s) {
-    const parts = id.split('#');
-    return parts.length === 1
-        ? s.boldWhite(parts[0])
-        : s.dim(parts.slice(0, -1).join('#') + '#') +
-            s.boldWhite(parts[parts.length - 1]);
-}
-export function formatSectionPreview(ctx, section, opts) {
-    const s = ctx.styler;
-    const relPath = relative(process.cwd(), join(ctx.projectRoot, section.filePath));
-    const kind = section.id.includes('#') ? 'Section' : 'File';
-    const details = [
-        opts?.reason,
-        opts?.debug,
-        opts?.score === undefined ? undefined : `score: ${opts.score.toFixed(6)}`,
-    ].filter((detail) => detail !== undefined);
-    const detailsSuffix = details.length > 0 ? ' ' + s.dim(`(${details.join(', ')})`) : '';
-    const lines = [
-        `${s.dim('*')} ${s.dim(kind + ':')} [[${formatSectionId(section.id, s)}]]${detailsSuffix}`,
-        `  ${s.dim('Defined in')} ${s.cyan(relPath)}${s.dim(`:${section.startLine}-${section.endLine}`)}`,
-    ];
-    if (opts?.spans?.length)
-        lines.push(`  ${s.dim('Matched lines:')} ${opts.spans.map((span) => `${span.startLine}-${span.endLine}`).join(', ')}`);
-    const text = opts?.text ?? section.firstParagraph;
-    if (text)
-        lines.push('', ...text.split('\n').map((line) => `  ${s.dim('>')} ${line}`));
-    return lines.join('\n');
-}
-export function formatResultList(ctx, header, matches, opts) {
-    const lines = ['', `## ${header}`, ''];
-    for (let i = 0; i < matches.length; i++) {
-        if (i > 0)
-            lines.push('');
-        lines.push(formatSectionPreview(ctx, matches[i].section, {
-            reason: matches[i].reason,
-            spans: opts?.preview === 'intro'
-                ? undefined
-                : matches[i].evidence?.[0]?.spans,
-            score: opts?.showScores ? matches[i].rankScore : undefined,
-            text: opts?.preview === 'intro'
-                ? undefined
-                : matches[i].evidence?.length
-                    ? (opts?.preview === 'both'
-                        ? matches[i].section.firstParagraph + '\n\n'
-                        : '') + matches[i].evidence[0].text
-                    : undefined,
-            debug: opts?.showScores && matches[i].rankScore !== undefined
-                ? JSON.stringify({
-                    lexicalRank: matches[i].lexicalRank,
-                    semanticRank: matches[i].semanticRank,
-                    lexicalScore: matches[i].lexicalScore,
-                    semanticSimilarity: matches[i].semanticSimilarity,
-                    lexicalContribution: matches[i].lexicalRank
-                        ? 1 / (60 + matches[i].lexicalRank)
-                        : 0,
-                    semanticContribution: matches[i].semanticRank
-                        ? 1 / (60 + matches[i].semanticRank)
-                        : 0,
-                    ...matches[i].diagnostics,
-                })
-                : undefined,
-        }));
-    }
-    lines.push('');
-    return lines.join('\n');
-}
-export function formatNavHints(ctx) {
-    const s = ctx.styler;
-    const hints = ctx.mode === 'cli'
-        ? `${s.dim('*')} \`lat section "section#id"\` \u2014 show full content with outgoing/incoming refs\n` +
-            `${s.dim('*')} \`lat search "new query"\` \u2014 search for something else`
-        : `${s.dim('*')} \`lat_section\` \u2014 show full content with outgoing/incoming refs\n` +
-            `${s.dim('*')} \`lat_search\` \u2014 search for something else`;
-    return `\n## To navigate further:\n\n${hints}`;
-}

package/dist/src/init-version.d.ts

@@ -1,10 +0,0 @@
-/**
- * Bump this number whenever `lat init` setup or defaults change in a way that
- * requires users to re-run it (e.g. new hooks, generated files, MCP config, or
- * a configuration migration).
- */
-export declare const INIT_VERSION = 7;
-export declare function readInitVersion(latDir: string): number | null;
-export declare function readFileHash(latDir: string, relPath: string): string | null;
-export declare function contentHash(content: string): string;
-export declare function writeInitMeta(latDir: string, fileHashes: Record<string, string>): void;

package/dist/src/init-version.js

@@ -1,49 +0,0 @@
-import { createHash } from 'node:crypto';
-import { existsSync, mkdirSync, readFileSync, writeFileSync } from 'node:fs';
-import { join } from 'node:path';
-/**
- * Bump this number whenever `lat init` setup or defaults change in a way that
- * requires users to re-run it (e.g. new hooks, generated files, MCP config, or
- * a configuration migration).
- */
-export const INIT_VERSION = 7;
-function cachePath(latDir) {
-    return join(latDir, '.cache', 'lat_init.json');
-}
-function readMeta(latDir) {
-    const p = cachePath(latDir);
-    if (!existsSync(p))
-        return null;
-    try {
-        return JSON.parse(readFileSync(p, 'utf-8'));
-    }
-    catch {
-        return null;
-    }
-}
-export function readInitVersion(latDir) {
-    const meta = readMeta(latDir);
-    if (!meta)
-        return null;
-    return typeof meta.init_version === 'number' ? meta.init_version : null;
-}
-export function readFileHash(latDir, relPath) {
-    const meta = readMeta(latDir);
-    return meta?.file_hashes?.[relPath] ?? null;
-}
-export function contentHash(content) {
-    return createHash('sha256').update(content).digest('hex');
-}
-export function writeInitMeta(latDir, fileHashes) {
-    const cacheDir = join(latDir, '.cache');
-    mkdirSync(cacheDir, { recursive: true });
-    // Merge with existing hashes so we don't lose entries from agents
-    // that weren't selected this run
-    const existing = readMeta(latDir);
-    const mergedHashes = { ...existing?.file_hashes, ...fileHashes };
-    const data = {
-        init_version: INIT_VERSION,
-        file_hashes: mergedHashes,
-    };
-    writeFileSync(cachePath(latDir), JSON.stringify(data, null, 2) + '\n');
-}

package/dist/src/lattice-model.d.ts

@@ -1,84 +0,0 @@
-import type { SearchEvidence, SearchDiagnostics } from './search/types.js';
-import type { ForkFrontmatter } from './fork/frontmatter-fields.js';
-export type Section = {
-    id: string;
-    heading: string;
-    depth: number;
-    file: string;
-    filePath: string;
-    children: Section[];
-    startLine: number;
-    endLine: number;
-    firstParagraph: string;
-    /** GitHub-compatible anchor generated from the rendered heading text. */
-    githubSlug?: string;
-};
-export type Ref = {
-    target: string;
-    fromSection: string;
-    file: string;
-    line: number;
-};
-/** An ordinary markdown destination or an undefined reference-style link. */
-export type MdLink = {
-    /** Destination exactly as authored, percent-escapes and all. */
-    url: string;
-    kind: 'link' | 'image' | 'definition';
-    line: number;
-} | {
-    /** Authored label that should have a matching definition. */
-    identifier: string;
-    /** Full reference syntax exactly as authored. */
-    source: string;
-    kind: 'linkReference' | 'imageReference';
-    style: 'full' | 'collapsed' | 'shortcut' | 'definition';
-    line: number;
-};
-export type LatFrontmatter = {
-    requireCodeMention?: boolean;
-} & ForkFrontmatter;
-export declare function flattenSections(sections: Section[]): Section[];
-/**
- * Build an index mapping path suffixes to their full vault-relative paths.
- * Used by resolveRef to allow short references when a suffix is unambiguous.
- *
- * For a file like `lat.md/guides/setup`, indexes both `guides/setup` and `setup`.
- * This ensures backward-compatible short refs after the vault root moved to the
- * project root (so section IDs now include the `lat.md/` prefix).
- */
-export declare function buildFileIndex(sections: Section[]): Map<string, string[]>;
-export type SectionSlugIndex = ReadonlyMap<string, string>;
-/**
- * Map GitHub-slugged heading paths back to canonical, literal-heading ids.
- * Every path segment accepts either representation so an implicit literal h1
- * can still prefix slugged child headings during short-ref resolution.
- */
-export declare function buildSectionSlugIndex(sections: Section[]): Map<string, string>;
-export type ResolveResult = {
-    resolved: string;
-    ambiguous: string[] | null;
-    /** When ambiguous but exactly one candidate has the section, suggest it. */
-    suggested: string | null;
-};
-/**
- * Resolve a potentially short reference to its canonical full-path form.
- * If the file segment of the ref is a bare stem that uniquely maps to one
- * full path, expands it. Otherwise returns the ref unchanged.
- *
- * When ambiguous (multiple files share the stem), returns all candidates.
- * If exactly one candidate actually contains the referenced section,
- * `suggested` is set to that candidate so the caller can propose a fix.
- */
-export declare function resolveRef(target: string, sectionIds: Set<string>, fileIndex: Map<string, string[]>, slugIndex?: SectionSlugIndex): ResolveResult;
-export type SectionMatch = {
-    section: Section;
-    reason: string;
-    rankScore?: number;
-    semanticSimilarity?: number;
-    lexicalScore?: number;
-    semanticRank?: number;
-    lexicalRank?: number;
-    evidence?: SearchEvidence[];
-    diagnostics?: SearchDiagnostics;
-};
-export declare function findSections(sections: Section[], query: string): SectionMatch[];