lat.md 0.10.0 → 0.10.2

package/README.md

@@ -1,9 +1,13 @@
-# lat.md
+<p align="center">
+  <img src="templates/logo-dark.svg" alt="lat.md" width="500">
+</p>
 
-[![CI](https://github.com/1st1/lat.md/actions/workflows/ci.yml/badge.svg)](https://github.com/1st1/lat.md/actions/workflows/ci.yml)
-[![npm](https://img.shields.io/npm/v/lat.md)](https://www.npmjs.com/package/lat.md)
+<p align="center">
+  <a href="https://github.com/1st1/lat.md/actions/workflows/ci.yml"><img src="https://github.com/1st1/lat.md/actions/workflows/ci.yml/badge.svg" alt="CI"></a>
+  <a href="https://www.npmjs.com/package/lat.md"><img src="https://img.shields.io/npm/v/lat.md" alt="npm"></a>
+</p>
 
-A knowledge graph for your codebase, written in markdown.
+<p align="center">A knowledge graph for your codebase, written in markdown.</p>
 
 ## The problem
 

package/dist/src/cli/check.js

@@ -3,7 +3,7 @@ import { existsSync } from 'node:fs';
 import { basename, dirname, extname, join, relative } from 'node:path';
 import { listLatticeFiles, loadAllSections, extractRefs, flattenSections, parseFrontmatter, parseSections, buildFileIndex, resolveRef, } from '../lattice.js';
 import { scanCodeRefs } from '../code-refs.js';
-import { SOURCE_EXTENSIONS } from '../source-parser.js';
+import { SOURCE_EXTENSIONS, clearSymbolCache } from '../source-parser.js';
 import { walkEntries } from '../walk.js';
 import { INIT_VERSION, readInitVersion } from '../init-version.js';
 function filePart(id) {
@@ -82,6 +82,7 @@ async function tryResolveSourceRef(target, projectRoot) {
     }
 }
 export async function checkMd(latticeDir) {
+    clearSymbolCache();
     const projectRoot = dirname(latticeDir);
     const files = await listLatticeFiles(latticeDir);
     const allSections = await loadAllSections(latticeDir);

package/dist/src/source-parser.d.ts

@@ -10,6 +10,8 @@ export type SourceSymbol = {
 /** All source file extensions that lat can parse (derived from grammarMap). */
 export declare const SOURCE_EXTENSIONS: ReadonlySet<string>;
 export declare function parseSourceSymbols(filePath: string, content: string): Promise<SourceSymbol[]>;
+/** Clear the symbol cache. Call between top-level operations. */
+export declare function clearSymbolCache(): void;
 /**
  * Check whether a source file path (relative to projectRoot) has a given symbol.
  * Used by lat check to validate source code wiki links lazily.

package/dist/src/source-parser.js

@@ -173,33 +173,43 @@ function extractPySymbols(tree) {
         const node = root.child(i);
         const startLine = node.startPosition.row + 1;
         const endLine = node.endPosition.row + 1;
-        if (node.type === 'function_definition') {
-            const name = extractName(node);
+        // Unwrap decorated_definition to get the inner function/class
+        const inner = node.type === 'decorated_definition'
+            ? node.childForFieldName('definition')
+            : node;
+        if (!inner)
+            continue;
+        if (inner.type === 'function_definition') {
+            const name = extractName(inner);
             if (name) {
                 symbols.push({
                     name,
                     kind: 'function',
                     startLine,
                     endLine,
-                    signature: firstLine(node.text),
+                    signature: firstLine(inner.text),
                 });
             }
         }
-        else if (node.type === 'class_definition') {
-            const name = extractName(node);
+        else if (inner.type === 'class_definition') {
+            const name = extractName(inner);
             if (name) {
                 symbols.push({
                     name,
                     kind: 'class',
                     startLine,
                     endLine,
-                    signature: firstLine(node.text),
+                    signature: firstLine(inner.text),
                 });
                 // Extract methods
-                const body = node.childForFieldName('body');
+                const body = inner.childForFieldName('body');
                 if (body) {
                     for (let j = 0; j < body.namedChildCount; j++) {
-                        const member = body.namedChild(j);
+                        let member = body.namedChild(j);
+                        // Unwrap decorated methods
+                        if (member.type === 'decorated_definition') {
+                            member = member.childForFieldName('definition') ?? member;
+                        }
                         if (member.type === 'function_definition') {
                             const methodName = extractName(member);
                             if (methodName) {
@@ -217,11 +227,11 @@ function extractPySymbols(tree) {
                 }
             }
         }
-        else if (node.type === 'expression_statement' &&
-            node.namedChildCount === 1 &&
-            node.namedChild(0).type === 'assignment') {
+        else if (inner.type === 'expression_statement' &&
+            inner.namedChildCount === 1 &&
+            inner.namedChild(0).type === 'assignment') {
             // Top-level assignment: FOO = ...
-            const assign = node.namedChild(0);
+            const assign = inner.namedChild(0);
             const left = assign.childForFieldName('left');
             if (left && left.type === 'identifier') {
                 symbols.push({
@@ -467,8 +477,17 @@ function extractGoSymbols(tree) {
  * Handles plain identifiers and pointer declarators (*name).
  */
 function cFuncName(declarator) {
-    if (declarator.type === 'function_declarator') {
-        const inner = declarator.childForFieldName('declarator');
+    // Unwrap pointer_declarator layers (for functions returning pointers,
+    // e.g. `JSRuntime *JS_NewRuntime(void)` → pointer_declarator > function_declarator)
+    let node = declarator;
+    while (node.type === 'pointer_declarator') {
+        const child = node.childForFieldName('declarator');
+        if (!child)
+            return null;
+        node = child;
+    }
+    if (node.type === 'function_declarator') {
+        const inner = node.childForFieldName('declarator');
         if (!inner)
             return null;
         if (inner.type === 'identifier')
@@ -500,6 +519,13 @@ function cVarName(declarator) {
             return null;
         node = inner;
     }
+    // Unwrap array_declarator (e.g. `char js_version[]`)
+    if (node.type === 'array_declarator') {
+        const inner = node.childForFieldName('declarator');
+        if (!inner)
+            return null;
+        node = inner;
+    }
     if (node.type === 'identifier')
         return node.text;
     if (node.type === 'pointer_declarator') {
@@ -591,7 +617,8 @@ function collectCNodes(parent, symbols) {
                 });
             }
         }
-        else if (node.type === 'preproc_def') {
+        else if (node.type === 'preproc_def' ||
+            node.type === 'preproc_function_def') {
             const name = extractName(node);
             if (name) {
                 symbols.push({
@@ -624,19 +651,32 @@ export async function parseSourceSymbols(filePath, content) {
     const tree = p.parse(content);
     if (!tree)
         return [];
-    if (ext === '.py') {
-        return extractPySymbols(tree);
-    }
-    if (ext === '.rs') {
-        return extractRustSymbols(tree);
-    }
-    if (ext === '.go') {
-        return extractGoSymbols(tree);
+    try {
+        if (ext === '.py') {
+            return extractPySymbols(tree);
+        }
+        if (ext === '.rs') {
+            return extractRustSymbols(tree);
+        }
+        if (ext === '.go') {
+            return extractGoSymbols(tree);
+        }
+        if (ext === '.c' || ext === '.h') {
+            return extractCSymbols(tree);
+        }
+        return extractTsSymbols(tree);
     }
-    if (ext === '.c' || ext === '.h') {
-        return extractCSymbols(tree);
+    finally {
+        tree.delete();
     }
-    return extractTsSymbols(tree);
+}
+// Per-invocation cache for parsed source symbols, keyed by absolute file path.
+// Prevents re-parsing the same file when multiple wiki links reference it
+// (e.g. 20+ links to quickjs.c would otherwise parse a 60K-line file 20 times).
+const symbolCache = new Map();
+/** Clear the symbol cache. Call between top-level operations. */
+export function clearSymbolCache() {
+    symbolCache.clear();
 }
 /**
  * Check whether a source file path (relative to projectRoot) has a given symbol.
@@ -644,24 +684,33 @@ export async function parseSourceSymbols(filePath, content) {
  */
 export async function resolveSourceSymbol(filePath, symbolPath, projectRoot) {
     const absPath = join(projectRoot, filePath);
-    let content;
-    try {
-        content = readFileSync(absPath, 'utf-8');
-    }
-    catch {
-        return { found: false, symbols: [] };
+    let cached = symbolCache.get(absPath);
+    if (!cached) {
+        let content;
+        try {
+            content = readFileSync(absPath, 'utf-8');
+        }
+        catch {
+            cached = { symbols: [] };
+            symbolCache.set(absPath, cached);
+            return { found: false, symbols: [] };
+        }
+        try {
+            const symbols = await parseSourceSymbols(filePath, content);
+            cached = { symbols };
+        }
+        catch (err) {
+            cached = {
+                symbols: [],
+                error: `failed to parse "${filePath}": ${err instanceof Error ? err.message : String(err)}`,
+            };
+        }
+        symbolCache.set(absPath, cached);
     }
-    let symbols;
-    try {
-        symbols = await parseSourceSymbols(filePath, content);
-    }
-    catch (err) {
-        return {
-            found: false,
-            symbols: [],
-            error: `failed to parse "${filePath}": ${err instanceof Error ? err.message : String(err)}`,
-        };
+    if (cached.error) {
+        return { found: false, symbols: cached.symbols, error: cached.error };
     }
+    const { symbols } = cached;
     const parts = symbolPath.split('#');
     if (parts.length === 1) {
         // Simple symbol: getConfigDir

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "lat.md",
-  "version": "0.10.0",
+  "version": "0.10.2",
   "description": "A knowledge graph for your codebase, written in markdown",
   "type": "module",
   "packageManager": "pnpm@10.30.2",

package/templates/logo-dark.svg

@@ -0,0 +1,182 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 73224 16688" fill="#444">
+  <defs>
+    <path id="g2591" d="M934 -512V-251H1094V-512ZM298 -512V-251H457V-512ZM616 -147V114H775V-147ZM-20 -147V114H138V-147ZM934 219V480H1094V219ZM298 219V480H457V219ZM616 584V845H775V584ZM-20 584V845H138V584ZM934 950V1211H1094V950ZM298 950V1211H457V950ZM616 1315V1576H775V1315ZM-20 1315V1576H138V1315Z"/>
+    <path id="g2588" d="M-20 -512V1576H1253V-512Z"/>
+  </defs>
+  <use href="#g2591" transform="translate(0,0) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2588" transform="translate(1356,0) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2588" transform="translate(2712,0) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2591" transform="translate(21696,0) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2588" transform="translate(23052,0) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2588" transform="translate(24408,0) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2591" transform="translate(69156,0) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2588" transform="translate(70512,0) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2588" transform="translate(71868,0) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2591" transform="translate(0,2384) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2588" transform="translate(1356,2384) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2588" transform="translate(2712,2384) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2591" transform="translate(21696,2384) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2588" transform="translate(23052,2384) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2588" transform="translate(24408,2384) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2591" transform="translate(69156,2384) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2588" transform="translate(70512,2384) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2588" transform="translate(71868,2384) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2591" transform="translate(0,4768) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2588" transform="translate(1356,4768) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2588" transform="translate(2712,4768) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2591" transform="translate(6780,4768) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2588" transform="translate(8136,4768) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2588" transform="translate(9492,4768) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2588" transform="translate(10848,4768) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2588" transform="translate(12204,4768) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2588" transform="translate(13560,4768) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2588" transform="translate(14916,4768) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2591" transform="translate(18984,4768) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2588" transform="translate(20340,4768) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2588" transform="translate(21696,4768) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2588" transform="translate(23052,4768) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2588" transform="translate(24408,4768) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2588" transform="translate(25764,4768) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2588" transform="translate(27120,4768) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2591" transform="translate(37968,4768) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2588" transform="translate(39324,4768) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2588" transform="translate(40680,4768) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2588" transform="translate(42036,4768) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2588" transform="translate(43392,4768) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2588" transform="translate(44748,4768) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2588" transform="translate(46104,4768) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2588" transform="translate(47460,4768) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2588" transform="translate(48816,4768) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2588" transform="translate(50172,4768) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2588" transform="translate(51528,4768) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2588" transform="translate(52884,4768) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2588" transform="translate(54240,4768) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2588" transform="translate(55596,4768) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2591" transform="translate(61020,4768) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2588" transform="translate(62376,4768) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2588" transform="translate(63732,4768) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2588" transform="translate(65088,4768) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2588" transform="translate(66444,4768) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2588" transform="translate(67800,4768) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2588" transform="translate(69156,4768) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2588" transform="translate(70512,4768) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2588" transform="translate(71868,4768) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2591" transform="translate(0,7152) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2588" transform="translate(1356,7152) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2588" transform="translate(2712,7152) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2591" transform="translate(13560,7152) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2588" transform="translate(14916,7152) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2588" transform="translate(16272,7152) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2591" transform="translate(21696,7152) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2588" transform="translate(23052,7152) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2588" transform="translate(24408,7152) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2591" transform="translate(37968,7152) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2588" transform="translate(39324,7152) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2588" transform="translate(40680,7152) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2591" transform="translate(46104,7152) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2588" transform="translate(47460,7152) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2588" transform="translate(48816,7152) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2591" transform="translate(54240,7152) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2588" transform="translate(55596,7152) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2588" transform="translate(56952,7152) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2591" transform="translate(59664,7152) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2588" transform="translate(61020,7152) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2588" transform="translate(62376,7152) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2591" transform="translate(69156,7152) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2588" transform="translate(70512,7152) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2588" transform="translate(71868,7152) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2591" transform="translate(0,9536) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2588" transform="translate(1356,9536) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2588" transform="translate(2712,9536) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2591" transform="translate(6780,9536) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2588" transform="translate(8136,9536) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2588" transform="translate(9492,9536) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2588" transform="translate(10848,9536) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2588" transform="translate(12204,9536) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2588" transform="translate(13560,9536) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2588" transform="translate(14916,9536) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2588" transform="translate(16272,9536) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2591" transform="translate(21696,9536) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2588" transform="translate(23052,9536) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2588" transform="translate(24408,9536) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2591" transform="translate(37968,9536) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2588" transform="translate(39324,9536) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2588" transform="translate(40680,9536) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2591" transform="translate(46104,9536) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2588" transform="translate(47460,9536) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2588" transform="translate(48816,9536) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2591" transform="translate(54240,9536) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2588" transform="translate(55596,9536) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2588" transform="translate(56952,9536) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2591" transform="translate(59664,9536) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2588" transform="translate(61020,9536) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2588" transform="translate(62376,9536) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2591" transform="translate(69156,9536) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2588" transform="translate(70512,9536) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2588" transform="translate(71868,9536) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2591" transform="translate(0,11920) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2588" transform="translate(1356,11920) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2588" transform="translate(2712,11920) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2591" transform="translate(5424,11920) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2588" transform="translate(6780,11920) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2588" transform="translate(8136,11920) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2591" transform="translate(13560,11920) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2588" transform="translate(14916,11920) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2588" transform="translate(16272,11920) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2591" transform="translate(21696,11920) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2588" transform="translate(23052,11920) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2588" transform="translate(24408,11920) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2591" transform="translate(37968,11920) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2588" transform="translate(39324,11920) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2588" transform="translate(40680,11920) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2591" transform="translate(46104,11920) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2588" transform="translate(47460,11920) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2588" transform="translate(48816,11920) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2591" transform="translate(54240,11920) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2588" transform="translate(55596,11920) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2588" transform="translate(56952,11920) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2591" transform="translate(59664,11920) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2588" transform="translate(61020,11920) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2588" transform="translate(62376,11920) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2591" transform="translate(67800,11920) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2588" transform="translate(69156,11920) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2588" transform="translate(70512,11920) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2588" transform="translate(71868,11920) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2591" transform="translate(0,14304) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2588" transform="translate(1356,14304) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2588" transform="translate(2712,14304) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2591" transform="translate(6780,14304) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2588" transform="translate(8136,14304) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2588" transform="translate(9492,14304) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2588" transform="translate(10848,14304) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2588" transform="translate(12204,14304) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2588" transform="translate(13560,14304) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2591" transform="translate(14916,14304) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2588" transform="translate(16272,14304) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2588" transform="translate(17628,14304) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2591" transform="translate(23052,14304) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2588" transform="translate(24408,14304) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2588" transform="translate(25764,14304) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2588" transform="translate(27120,14304) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2591" transform="translate(31188,14304) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2588" transform="translate(32544,14304) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2588" transform="translate(33900,14304) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2591" transform="translate(37968,14304) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2588" transform="translate(39324,14304) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2588" transform="translate(40680,14304) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2591" transform="translate(46104,14304) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2588" transform="translate(47460,14304) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2588" transform="translate(48816,14304) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2591" transform="translate(54240,14304) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2588" transform="translate(55596,14304) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2588" transform="translate(56952,14304) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2591" transform="translate(61020,14304) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2588" transform="translate(62376,14304) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2588" transform="translate(63732,14304) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2588" transform="translate(65088,14304) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2588" transform="translate(66444,14304) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2588" transform="translate(67800,14304) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2591" transform="translate(69156,14304) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2588" transform="translate(70512,14304) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2588" transform="translate(71868,14304) scale(1,-1) translate(0,-1901)"/>
+</svg>

package/templates/logo-light.svg

@@ -0,0 +1,182 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 73224 16688" fill="#ddd">
+  <defs>
+    <path id="g2588" d="M-20 -512V1576H1253V-512Z"/>
+    <path id="g2591" d="M934 -512V-251H1094V-512ZM298 -512V-251H457V-512ZM616 -147V114H775V-147ZM-20 -147V114H138V-147ZM934 219V480H1094V219ZM298 219V480H457V219ZM616 584V845H775V584ZM-20 584V845H138V584ZM934 950V1211H1094V950ZM298 950V1211H457V950ZM616 1315V1576H775V1315ZM-20 1315V1576H138V1315Z"/>
+  </defs>
+  <use href="#g2591" transform="translate(0,0) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2588" transform="translate(1356,0) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2588" transform="translate(2712,0) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2591" transform="translate(21696,0) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2588" transform="translate(23052,0) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2588" transform="translate(24408,0) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2591" transform="translate(69156,0) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2588" transform="translate(70512,0) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2588" transform="translate(71868,0) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2591" transform="translate(0,2384) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2588" transform="translate(1356,2384) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2588" transform="translate(2712,2384) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2591" transform="translate(21696,2384) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2588" transform="translate(23052,2384) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2588" transform="translate(24408,2384) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2591" transform="translate(69156,2384) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2588" transform="translate(70512,2384) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2588" transform="translate(71868,2384) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2591" transform="translate(0,4768) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2588" transform="translate(1356,4768) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2588" transform="translate(2712,4768) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2591" transform="translate(6780,4768) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2588" transform="translate(8136,4768) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2588" transform="translate(9492,4768) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2588" transform="translate(10848,4768) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2588" transform="translate(12204,4768) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2588" transform="translate(13560,4768) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2588" transform="translate(14916,4768) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2591" transform="translate(18984,4768) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2588" transform="translate(20340,4768) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2588" transform="translate(21696,4768) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2588" transform="translate(23052,4768) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2588" transform="translate(24408,4768) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2588" transform="translate(25764,4768) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2588" transform="translate(27120,4768) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2591" transform="translate(37968,4768) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2588" transform="translate(39324,4768) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2588" transform="translate(40680,4768) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2588" transform="translate(42036,4768) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2588" transform="translate(43392,4768) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2588" transform="translate(44748,4768) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2588" transform="translate(46104,4768) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2588" transform="translate(47460,4768) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2588" transform="translate(48816,4768) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2588" transform="translate(50172,4768) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2588" transform="translate(51528,4768) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2588" transform="translate(52884,4768) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2588" transform="translate(54240,4768) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2588" transform="translate(55596,4768) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2591" transform="translate(61020,4768) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2588" transform="translate(62376,4768) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2588" transform="translate(63732,4768) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2588" transform="translate(65088,4768) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2588" transform="translate(66444,4768) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2588" transform="translate(67800,4768) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2588" transform="translate(69156,4768) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2588" transform="translate(70512,4768) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2588" transform="translate(71868,4768) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2591" transform="translate(0,7152) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2588" transform="translate(1356,7152) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2588" transform="translate(2712,7152) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2591" transform="translate(13560,7152) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2588" transform="translate(14916,7152) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2588" transform="translate(16272,7152) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2591" transform="translate(21696,7152) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2588" transform="translate(23052,7152) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2588" transform="translate(24408,7152) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2591" transform="translate(37968,7152) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2588" transform="translate(39324,7152) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2588" transform="translate(40680,7152) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2591" transform="translate(46104,7152) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2588" transform="translate(47460,7152) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2588" transform="translate(48816,7152) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2591" transform="translate(54240,7152) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2588" transform="translate(55596,7152) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2588" transform="translate(56952,7152) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2591" transform="translate(59664,7152) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2588" transform="translate(61020,7152) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2588" transform="translate(62376,7152) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2591" transform="translate(69156,7152) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2588" transform="translate(70512,7152) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2588" transform="translate(71868,7152) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2591" transform="translate(0,9536) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2588" transform="translate(1356,9536) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2588" transform="translate(2712,9536) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2591" transform="translate(6780,9536) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2588" transform="translate(8136,9536) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2588" transform="translate(9492,9536) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2588" transform="translate(10848,9536) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2588" transform="translate(12204,9536) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2588" transform="translate(13560,9536) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2588" transform="translate(14916,9536) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2588" transform="translate(16272,9536) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2591" transform="translate(21696,9536) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2588" transform="translate(23052,9536) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2588" transform="translate(24408,9536) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2591" transform="translate(37968,9536) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2588" transform="translate(39324,9536) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2588" transform="translate(40680,9536) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2591" transform="translate(46104,9536) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2588" transform="translate(47460,9536) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2588" transform="translate(48816,9536) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2591" transform="translate(54240,9536) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2588" transform="translate(55596,9536) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2588" transform="translate(56952,9536) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2591" transform="translate(59664,9536) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2588" transform="translate(61020,9536) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2588" transform="translate(62376,9536) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2591" transform="translate(69156,9536) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2588" transform="translate(70512,9536) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2588" transform="translate(71868,9536) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2591" transform="translate(0,11920) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2588" transform="translate(1356,11920) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2588" transform="translate(2712,11920) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2591" transform="translate(5424,11920) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2588" transform="translate(6780,11920) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2588" transform="translate(8136,11920) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2591" transform="translate(13560,11920) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2588" transform="translate(14916,11920) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2588" transform="translate(16272,11920) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2591" transform="translate(21696,11920) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2588" transform="translate(23052,11920) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2588" transform="translate(24408,11920) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2591" transform="translate(37968,11920) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2588" transform="translate(39324,11920) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2588" transform="translate(40680,11920) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2591" transform="translate(46104,11920) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2588" transform="translate(47460,11920) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2588" transform="translate(48816,11920) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2591" transform="translate(54240,11920) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2588" transform="translate(55596,11920) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2588" transform="translate(56952,11920) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2591" transform="translate(59664,11920) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2588" transform="translate(61020,11920) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2588" transform="translate(62376,11920) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2591" transform="translate(67800,11920) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2588" transform="translate(69156,11920) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2588" transform="translate(70512,11920) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2588" transform="translate(71868,11920) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2591" transform="translate(0,14304) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2588" transform="translate(1356,14304) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2588" transform="translate(2712,14304) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2591" transform="translate(6780,14304) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2588" transform="translate(8136,14304) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2588" transform="translate(9492,14304) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2588" transform="translate(10848,14304) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2588" transform="translate(12204,14304) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2588" transform="translate(13560,14304) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2591" transform="translate(14916,14304) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2588" transform="translate(16272,14304) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2588" transform="translate(17628,14304) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2591" transform="translate(23052,14304) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2588" transform="translate(24408,14304) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2588" transform="translate(25764,14304) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2588" transform="translate(27120,14304) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2591" transform="translate(31188,14304) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2588" transform="translate(32544,14304) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2588" transform="translate(33900,14304) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2591" transform="translate(37968,14304) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2588" transform="translate(39324,14304) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2588" transform="translate(40680,14304) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2591" transform="translate(46104,14304) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2588" transform="translate(47460,14304) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2588" transform="translate(48816,14304) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2591" transform="translate(54240,14304) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2588" transform="translate(55596,14304) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2588" transform="translate(56952,14304) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2591" transform="translate(61020,14304) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2588" transform="translate(62376,14304) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2588" transform="translate(63732,14304) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2588" transform="translate(65088,14304) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2588" transform="translate(66444,14304) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2588" transform="translate(67800,14304) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2591" transform="translate(69156,14304) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2588" transform="translate(70512,14304) scale(1,-1) translate(0,-1901)"/>
+  <use href="#g2588" transform="translate(71868,14304) scale(1,-1) translate(0,-1901)"/>
+</svg>

package/templates/lat-prompt-hook.sh

@@ -1,16 +0,0 @@
-#!/bin/bash
-# lat.md prompt hook for Claude Code
-# Injected by `lat init` — reminds the agent to consult lat.md before working.
-#
-# This hook fires on every user prompt submission. It adds a short instruction
-# telling the agent to run `lat search` and `lat expand` so that lat.md context
-# is consulted before any code changes.
-
-cat <<'HOOK_JSON'
-{
-  "hookSpecificOutput": {
-    "hookEventName": "UserPromptSubmit",
-    "additionalContext": "Before starting work on this task:\n1. Run `lat search` with a query relevant to the task and read the results to understand the design intent.\n2. If the prompt contains [[refs]], run `lat expand` on the full prompt text to resolve them.\n3. After completing work, run `lat check` to validate all links and code refs.\nDo not skip these steps."
-  }
-}
-HOOK_JSON