@plebeiantech/lat.md 0.12.3-fork.1

package/dist/src/cli/index.js

@@ -0,0 +1,307 @@
+#!/usr/bin/env node
+// Suppress deprecation warnings from transitive dependencies unless --verbose
+if (!process.argv.includes('--verbose')) {
+    process.noDeprecation = true;
+}
+import { existsSync, readFileSync } from 'node:fs';
+import { dirname, join } from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { Command } from 'commander';
+import { resolveCheckContext, resolveContext } from './context.js';
+/** Reserve `-- <directory>` for an explicit check target. */
+function splitCheckTarget(args) {
+    let commandIndex = -1;
+    for (let i = 0; i < args.length; i++) {
+        const arg = args[i];
+        if (arg === '--dir') {
+            i++;
+            continue;
+        }
+        if (arg.startsWith('--dir='))
+            continue;
+        if (arg.startsWith('-'))
+            continue;
+        commandIndex = i;
+        break;
+    }
+    if (commandIndex === -1 || args[commandIndex] !== 'check') {
+        return { args };
+    }
+    const separatorIndex = args.indexOf('--', commandIndex + 1);
+    if (separatorIndex === -1)
+        return { args };
+    const targets = args.slice(separatorIndex + 1);
+    if (targets.length !== 1 || targets[0] === '') {
+        console.error('error: `lat check --` expects exactly one directory after `--`');
+        process.exit(1);
+    }
+    return {
+        args: args.slice(0, separatorIndex),
+        target: targets[0],
+    };
+}
+const checkTargetArgs = splitCheckTarget(process.argv.slice(2));
+function findPackageJson() {
+    let dir = dirname(fileURLToPath(import.meta.url));
+    while (true) {
+        const candidate = join(dir, 'package.json');
+        try {
+            return JSON.parse(readFileSync(candidate, 'utf-8')).version;
+        }
+        catch { }
+        const parent = dirname(dir);
+        if (parent === dir)
+            return '0.0.0';
+        dir = parent;
+    }
+}
+function handleResult(result) {
+    if (result.isError) {
+        console.error(result.output);
+        process.exit(1);
+    }
+    if (result.output)
+        console.log(result.output);
+}
+const version = findPackageJson();
+const program = new Command();
+program
+    .name('lat')
+    .description('Anchor source code to high-level concepts defined in markdown')
+    .version(version)
+    .option('--dir <path>', 'project root to look for lat.md in (default: cwd)')
+    .option('--no-color', 'disable color output')
+    .option('--verbose', 'show deprecation warnings and extra diagnostics');
+program
+    .command('locate')
+    .description('Find sections by id')
+    .argument('<query>', 'section id to search for')
+    .action(async (query) => {
+    const ctx = resolveContext(program.opts());
+    const { locateCommand } = await import('./locate.js');
+    handleResult(await locateCommand(ctx, query));
+});
+program
+    .command('section')
+    .description('Show a section with its content, outgoing refs, and incoming refs')
+    .argument('<query>', 'section id to look up')
+    .action(async (query) => {
+    const ctx = resolveContext(program.opts());
+    const { sectionCommand } = await import('./section.js');
+    handleResult(await sectionCommand(ctx, query));
+});
+program
+    .command('ui')
+    .description('Open lat.md in a local browser')
+    .action(async () => {
+    const ctx = resolveContext(program.opts());
+    const { uiCommand } = await import('./ui.js');
+    handleResult(await uiCommand(ctx));
+});
+program
+    .command('refs')
+    .description('Find references to a section')
+    .argument('<query>', 'section id to find references for')
+    .option('--scope <scope>', 'where to search: md, code, or md+code', 'md+code')
+    .action(async (query, opts) => {
+    const scope = opts.scope;
+    if (scope !== 'md' && scope !== 'code' && scope !== 'md+code') {
+        console.error(`Unknown scope: ${scope}. Use md, code, or md+code.`);
+        process.exit(1);
+    }
+    const ctx = resolveContext(program.opts());
+    const { refsCommand } = await import('./refs.js');
+    handleResult(await refsCommand(ctx, query, scope));
+});
+const check = program
+    .command('check')
+    .usage('[subcommand] [-- <directory>]')
+    .description('Validate markdown, links, code references, and structure')
+    .option('--fix', 'generate/update directory index files from frontmatter')
+    .action(async (opts) => {
+    const ctx = resolveCheckContext(program.opts(), checkTargetArgs.target);
+    const { checkAllCommand } = await import('./check.js');
+    handleResult(await checkAllCommand(ctx, { fix: opts.fix }));
+});
+check
+    .command('md')
+    .usage('[-- <directory>]')
+    .description('Validate wiki links in markdown files')
+    .action(async () => {
+    const ctx = resolveCheckContext(program.opts(), checkTargetArgs.target);
+    const { checkMdCommand } = await import('./check.js');
+    handleResult(await checkMdCommand(ctx));
+});
+check
+    .command('links')
+    .usage('[-- <directory>]')
+    .description('Validate relative markdown links')
+    .action(async () => {
+    const ctx = resolveCheckContext(program.opts(), checkTargetArgs.target);
+    const { checkLinksCommand } = await import('./check.js');
+    handleResult(await checkLinksCommand(ctx));
+});
+check
+    .command('code-refs')
+    .usage('[-- <directory>]')
+    .description('Validate @lat code references and coverage')
+    .action(async () => {
+    const ctx = resolveCheckContext(program.opts(), checkTargetArgs.target);
+    const { checkCodeRefsCommand } = await import('./check.js');
+    handleResult(await checkCodeRefsCommand(ctx));
+});
+check
+    .command('index')
+    .usage('[-- <directory>]')
+    .description('Validate directory index files')
+    // No `.option('--fix', ...)` here: the parent `check` command already
+    // declares `--fix` (see line ~133 above), and commander resolves a flag
+    // shared by parent and child against the PARENT, leaving this action's
+    // own `opts.fix` permanently `undefined`. Re-adding a same-named option
+    // on this subcommand silently reintroduces that no-op bug (lat-t1y.31) —
+    // read it off `check.opts()` instead.
+    .action(async () => {
+    const ctx = resolveCheckContext(program.opts(), checkTargetArgs.target);
+    const { checkIndexCommand } = await import('./check.js');
+    handleResult(await checkIndexCommand(ctx, { fix: check.opts().fix }));
+});
+check
+    .command('sections')
+    .usage('[-- <directory>]')
+    .description('Validate section leading paragraphs')
+    .action(async () => {
+    const ctx = resolveCheckContext(program.opts(), checkTargetArgs.target);
+    const { checkSectionsCommand } = await import('./check.js');
+    handleResult(await checkSectionsCommand(ctx));
+});
+check
+    .command('mode')
+    .usage('[-- <directory>]')
+    .description('Validate Diátaxis modes and document shape')
+    .action(async () => {
+    const ctx = resolveCheckContext(program.opts(), checkTargetArgs.target);
+    const { checkModeCommand } = await import('./check.js');
+    handleResult(await checkModeCommand(ctx));
+});
+check
+    .command('status')
+    .usage('[-- <directory>]')
+    .description('Validate provenance status and detect stale reviews')
+    .action(async () => {
+    const ctx = resolveCheckContext(program.opts(), checkTargetArgs.target);
+    const { checkStatusCommand } = await import('./check.js');
+    handleResult(await checkStatusCommand(ctx));
+});
+async function runExpand(text, opts) {
+    if (opts.stdin) {
+        const chunks = [];
+        for await (const chunk of process.stdin) {
+            chunks.push(chunk);
+        }
+        text = Buffer.concat(chunks).toString('utf-8');
+    }
+    if (!text) {
+        console.error('Provide text as an argument or use --stdin');
+        process.exit(1);
+    }
+    const ctx = resolveContext(program.opts());
+    const { expandCommand } = await import('./expand.js');
+    const result = await expandCommand(ctx, text);
+    if (result.isError) {
+        console.error(result.output);
+        process.exit(1);
+    }
+    // Use stdout.write (no trailing newline) for piping
+    process.stdout.write(result.output);
+}
+program
+    .command('expand')
+    .description('Expand [[refs]] in text to lat.md section locations')
+    .argument('[text]', 'text containing [[refs]]')
+    .option('--stdin', 'read text from stdin')
+    .action(runExpand);
+// Deprecated alias — hidden from --help
+program
+    .command('prompt', { hidden: true })
+    .argument('[text]')
+    .option('--stdin')
+    .action(async (text, opts) => {
+    console.error('Warning: `lat prompt` is deprecated, use `lat expand` instead.');
+    await runExpand(text, opts);
+});
+program
+    .command('search')
+    .description('Semantic search across lat.md sections')
+    .argument('[query]', 'search query in plain English')
+    .option('--limit <n>', 'max results', '5')
+    .action(async (query, opts) => {
+    const ctx = resolveContext(program.opts());
+    const { searchCommand, cliProgress } = await import('./search.js');
+    const progress = cliProgress(ctx.styler);
+    const result = await searchCommand(ctx, query, { limit: parseInt(opts.limit) }, progress);
+    handleResult(result);
+});
+program
+    .command('reindex')
+    .description('Rebuild the embedding index; switch backends if needed')
+    .option('--local', 'use the local offline model (ignore LAT_LLM_KEY)')
+    .option('--remote', 'use the hosted API from LAT_LLM_KEY (override a local pin)')
+    .option('--yes', 'assume yes to prompts (non-interactive)')
+    .action(async (opts) => {
+    const ctx = resolveContext(program.opts());
+    const { reindexCommand } = await import('./reindex.js');
+    handleResult(await reindexCommand(ctx, opts));
+});
+program
+    .command('gen')
+    .description('Generate a file to stdout (agents.md, claude.md, cursor-rules.md)')
+    .argument('<target>', 'file to generate: agents.md, claude.md, cursor-rules.md')
+    .action(async (target) => {
+    const { genCmd } = await import('./gen.js');
+    await genCmd(target);
+});
+program
+    .command('init')
+    .description('Initialize a lat.md directory')
+    .argument('[dir]', 'target directory (default: cwd)')
+    .action(async (dir) => {
+    const { initCmd } = await import('./init.js');
+    await initCmd(dir);
+});
+program
+    .command('hook')
+    .description('Handle agent hook events (called by agent hooks, not directly)')
+    .argument('<agent>', 'agent name (claude, cursor)')
+    .argument('<event>', 'hook event (claude: UserPromptSubmit|Stop, cursor: stop)')
+    .action(async (agent, event) => {
+    const { hookCmd } = await import('./hook.js');
+    await hookCmd(agent, event);
+});
+program
+    .command('mcp')
+    .description('Start the MCP server (stdio transport)')
+    .action(async () => {
+    const { startMcpServer } = await import('../mcp/server.js');
+    await startMcpServer();
+});
+program
+    .command('config')
+    .description('Show configuration file path')
+    .action(async () => {
+    const { getConfigPath } = await import('../config.js');
+    const configPath = getConfigPath();
+    const exists = existsSync(configPath);
+    console.log(`Config file: ${configPath}${exists ? '' : ' (not found)'}`);
+});
+program
+    .command('graph')
+    .description('Export the knowledge graph, or reconstruct it at a git revision')
+    .option('--format <format>', 'output format: json, mermaid, dot', 'json')
+    .option('--at <rev>', 'reconstruct the graph at a git revision')
+    .option('--since <rev>', 'diff the graph since a git revision')
+    .action(async (opts) => {
+    const ctx = resolveContext(program.opts());
+    const { graphCommand } = await import('./graph.js');
+    handleResult(await graphCommand(ctx, opts));
+});
+await program.parseAsync(checkTargetArgs.args, { from: 'user' });

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

@@ -0,0 +1,9 @@
+type LatCommandStyle = 'global' | 'local' | 'npx';
+/**
+ * Remove all lat-owned hook entries from settings, then add fresh ones.
+ * Preserves any non-lat hooks the user may have configured.
+ */
+export declare function syncLatHooks(settingsPath: string, style: LatCommandStyle, agent?: 'claude' | 'codex'): void;
+export declare function readLogo(): string;
+export declare function initCmd(targetDir?: string): Promise<void>;
+export {};