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

package/dist/src/view/store.js

@@ -1,13 +1,14 @@
+import { repositoryFilePath } from '@plebeiantech/lat.md-core/repository-path';
 import { randomUUID } from 'node:crypto';
 import { watch as watchFiles } from 'node:fs';
 import { readFile, realpath, rename, rm, stat, writeFile, } from 'node:fs/promises';
 import { basename, extname, isAbsolute, relative, resolve, sep, } from 'node:path';
-import { createCodeReferenceDiscovery, LAT_REF_RE, } from '../code-refs.js';
-import { createExternalResolver, } from '../external-sources.js';
-import { listLatticeFiles } from '../project-discovery.js';
-import { analyzeMarkdownPath } from '../markdown-analysis-cache.js';
-import { isSourceFileExtension } from '../source-formats.js';
-import { toPosix } from '../path.js';
+import { createCodeReferenceDiscovery, LAT_REF_RE, } from '@plebeiantech/lat.md-core/code-refs';
+import { createExternalResolver, } from '@plebeiantech/lat.md-core/external-sources';
+import { listLatticeFiles } from '@plebeiantech/lat.md-core/project-discovery';
+import { analyzeMarkdownPath } from '@plebeiantech/lat.md-core/markdown-analysis-cache';
+import { isSourceFileExtension } from '@plebeiantech/lat.md-core/source-formats';
+import { toPosix } from '@plebeiantech/lat.md-core/path';
 import { renderMarkdown } from './markdown.js';
 import { buildViewDiagnostics } from './diagnostics.js';
 import { applyDocumentEdit, ViewDocumentConflictError, } from './document-edit.js';
@@ -16,7 +17,7 @@ import { buildViewGraph } from './graph.js';
 import { buildViewTableOfContents } from './table-of-contents.js';
 import { emptyViewGitSnapshot, findViewGitRepository, readViewGitSnapshot, sameViewGitSnapshot, } from './git.js';
 import { DEFAULT_VIEW_LOGO_TEXT } from './protocol.js';
-import { createMarkdownWikiLinkResolver, getViewExternal, getViewSource, ViewDocumentNotFoundError, } from './repository.js';
+import { createMarkdownWikiLinkResolver, getViewExternal, getViewSource, ViewDocumentNotFoundError, ViewSourceNotFoundError, } from './repository.js';
 import { buildViewReferenceIndex, renderSectionBackReferences, } from './references.js';
 import { rewriteLocalFileLink } from './source-target.js';
 const DEFAULT_DEBOUNCE_MS = 75;
@@ -75,7 +76,10 @@ async function loadCodeReferenceFiles(projectRoot, refs) {
     const files = new Map();
     await Promise.all([...refsByFile].map(async ([path, fileRefs]) => {
         try {
-            const content = await readFile(resolve(projectRoot, path), 'utf8');
+            const safePath = await repositoryFilePath(projectRoot, path);
+            if (!safePath)
+                return;
+            const content = await readFile(safePath, 'utf8');
             files.set(path, { path, lines: content.split('\n'), refs: fileRefs });
         }
         catch {
@@ -84,16 +88,18 @@ async function loadCodeReferenceFiles(projectRoot, refs) {
     }));
     return files;
 }
-async function scanCodeState(projectRoot, excludedPaths = []) {
+async function scanCodeState(projectRoot, excludedPaths = [], publishable) {
     const discovery = createCodeReferenceDiscovery(projectRoot);
     const [scan, sourceFiles] = await Promise.all([
         discovery.scan(),
         discovery.listSourceFiles(),
     ]);
     const allowed = (path) => !excludedCodePath(projectRoot, path, excludedPaths);
-    const files = sourceFiles.filter(allowed);
-    const refs = scan.refs.filter((ref) => allowed(ref.file));
+    const candidates = sourceFiles.filter(allowed);
+    const decisions = await Promise.all(candidates.map((path) => publishable?.(projectPath(projectRoot, path)) ?? true));
+    const files = candidates.filter((_, index) => decisions[index]);
     const scope = new Set(files.map((path) => projectPath(projectRoot, path)));
+    const refs = scan.refs.filter((ref) => allowed(ref.file) && scope.has(ref.file));
     return {
         files: await loadCodeReferenceFiles(projectRoot, refs),
         scope,
@@ -269,7 +275,7 @@ export class ViewStore {
         const requestedPath = section
             ? toPosix(relative(this.latDir, resolve(this.projectRoot, section.filePath)))
             : 'section-output.md';
-        const resolver = await createMarkdownWikiLinkResolver(this.latDir, requestedPath, snapshot.allSections, snapshot.references, snapshot.external);
+        const resolver = await createMarkdownWikiLinkResolver(this.latDir, requestedPath, snapshot.allSections, snapshot.references, snapshot.external, this.options.publishable);
         return (await renderMarkdown(markdown, requestedPath, resolver)).tree;
     }
     async getDocument(requestedPath) {
@@ -284,7 +290,7 @@ export class ViewStore {
         if (!file) {
             throw new ViewDocumentNotFoundError('Markdown document not found');
         }
-        const resolver = await createMarkdownWikiLinkResolver(this.latDir, requestedPath, snapshot.allSections, snapshot.references, snapshot.external);
+        const resolver = await createMarkdownWikiLinkResolver(this.latDir, requestedPath, snapshot.allSections, snapshot.references, snapshot.external, this.options.publishable);
         const rendered = await renderMarkdown(file.content, requestedPath, resolver, {
             errors: [...(snapshot.diagnostics.get(requestedPath) ?? [])],
             rewriteMarkdownLink: (url) => rewriteLocalFileLink(url, requestedPath),
@@ -319,7 +325,7 @@ export class ViewStore {
                 return [headingId, node.id];
             })),
             errors,
-            backReferences: await renderSectionBackReferences(snapshot.references, file.sections, this.latDir, this.projectRoot, (path) => createMarkdownWikiLinkResolver(this.latDir, path, snapshot.allSections, snapshot.references, snapshot.external)),
+            backReferences: await renderSectionBackReferences(snapshot.references, file.sections, this.latDir, this.projectRoot, (path) => createMarkdownWikiLinkResolver(this.latDir, path, snapshot.allSections, snapshot.references, snapshot.external, this.options.publishable)),
             frontmatter: {
                 requireCodeMention: file.frontmatter.requireCodeMention === true,
             },
@@ -350,6 +356,9 @@ export class ViewStore {
         return { path: requestedPath, content: await readFile(path, 'utf8') };
     }
     async getDocumentResource(requestedPath) {
+        if (this.options.publishable &&
+            !(await this.options.publishable(projectPath(this.projectRoot, resolve(this.latDir, requestedPath)))))
+            throw new ViewDocumentNotFoundError(`Resource is excluded from publication: ${requestedPath}`);
         if (!requestedPath ||
             requestedPath.includes('\\') ||
             isAbsolute(requestedPath) ||
@@ -402,13 +411,16 @@ export class ViewStore {
         this.editTail = operation.then(() => undefined, () => undefined);
         return operation;
     }
-    getSource(requestedPath, requestedSymbol = '', origin, requestedLine = 0) {
+    async getSource(requestedPath, requestedSymbol = '', origin, requestedLine = 0) {
+        if (this.options.publishable &&
+            !(await this.options.publishable(requestedPath)))
+            throw new ViewSourceNotFoundError(`Source is excluded from publication: ${requestedPath}`);
         const snapshot = this.snapshotValue;
-        return getViewSource(this.latDir, this.projectRoot, requestedPath, requestedSymbol, origin, requestedLine, snapshot.allSections, snapshot.references);
+        return getViewSource(this.latDir, this.projectRoot, requestedPath, requestedSymbol, origin, requestedLine, snapshot.allSections, snapshot.references, this.options.publishable);
     }
     getExternal(target) {
         const snapshot = this.snapshotValue;
-        return getViewExternal(this.latDir, this.projectRoot, target, snapshot.external, snapshot.allSections, snapshot.references);
+        return getViewExternal(this.latDir, this.projectRoot, target, snapshot.external, snapshot.allSections, snapshot.references, this.options.publishable);
     }
     refresh(paths) {
         if (this.closed)
@@ -581,7 +593,7 @@ export class ViewStore {
             paths.some((path) => path === '.gitignore' || path.endsWith('/.gitignore')) ||
             codePaths.some((path) => !this.codeScope.has(path) && !this.ignoredCodePaths.has(path));
         if (refreshCodeScope) {
-            const nextCode = await scanCodeState(this.projectRoot, this.options.codeExcludePaths);
+            const nextCode = await scanCodeState(this.projectRoot, this.options.codeExcludePaths, this.options.publishable);
             codeFiles = nextCode.files;
             this.codeScope = nextCode.scope;
             this.ignoredCodePaths.clear();
@@ -639,7 +651,7 @@ export async function createViewStore(latDir, projectRoot, options = {}) {
     const [realLatDir, markdownPaths, codeState, gitRepository] = await Promise.all([
         realpath(latDir),
         listLatticeFiles(latDir),
-        scanCodeState(projectRoot, options.codeExcludePaths),
+        scanCodeState(projectRoot, options.codeExcludePaths, options.publishable),
         options.git === false
             ? Promise.resolve(null)
             : findViewGitRepository(projectRoot, latDir),

package/dist/src/view/table-of-contents.d.ts

@@ -1,5 +1,5 @@
 import type { Root } from 'mdast';
-import { type Section } from '../lattice-model.js';
+import { type Section } from '@plebeiantech/lat.md-core/lattice-model';
 import type { ViewDocumentError, ViewDocumentTocItem } from './protocol.js';
 export type ViewTableOfContentsOptions = {
     errors?: readonly ViewDocumentError[];

package/dist/src/view/table-of-contents.js

@@ -1,4 +1,4 @@
-import { flattenSections } from '../lattice-model.js';
+import { flattenSections, } from '@plebeiantech/lat.md-core/lattice-model';
 function sectionAtLine(sections, line) {
     let owner = null;
     for (const section of sections) {

package/dist/src/view/vercel-server-build.d.ts

@@ -1,4 +1,4 @@
-import type { CmdContext } from '../context.js';
+import type { CmdContext } from '@plebeiantech/lat.md-core/context';
 import { buildServerView, type ServerViewBuildOptions, type ServerViewBuildResult } from './server-build.js';
 import { type VercelBuildOptions, type VercelBuildResult } from './vercel-build.js';
 export type VercelServerBuildDependencies = {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@plebeiantech/lat.md",
-  "version": "0.12.3-fork.17",
+  "version": "0.12.3-fork.20",
   "description": "A knowledge graph for your codebase, written in markdown",
   "type": "module",
   "license": "MIT",
@@ -71,55 +71,41 @@
     "three": "^0.185.1",
     "topojson-client": "^3.1.0",
     "tsx": "^4.21.0",
-    "typescript": "^5.7.0",
+    "typescript": "7.0.2",
     "vite": "^7.0.0",
     "vitest": "^3.0.0",
+    "web-tree-sitter": "^0.26.6",
+    "micromark-extension-gfm-table": "^2.1.1",
+    "mdast-util-gfm-table": "^2.0.0",
+    "remark-math": "^6.0.0",
+    "@folder/xdg": "^4.0.1",
     "@lat.md/server": "0.1.0"
   },
   "dependencies": {
     "@asciidoctor/core": "4.0.6",
-    "@folder/xdg": "^4.0.1",
     "@libsql/client": "^0.17.0",
     "@modelcontextprotocol/sdk": "^1.27.1",
-    "@repomix/tree-sitter-wasms": "^0.1.17",
     "@tursodatabase/database": "0.7.2",
     "@vercel/nft": "^1.10.0",
     "commander": "^14.0.3",
     "diff": "^8.0.4",
     "express": "^5.2.1",
     "fs-native-extensions": "1.5.1",
-    "github-slugger": "^2.0.0",
-    "ignore-walk": "^8.0.0",
-    "mdast-util-gfm-autolink-literal": "^2.0.1",
-    "mdast-util-gfm-footnote": "^2.1.0",
-    "mdast-util-gfm-strikethrough": "^2.0.0",
-    "mdast-util-gfm-table": "^2.0.0",
-    "mdast-util-gfm-task-list-item": "^2.0.0",
-    "mdast-util-to-markdown": "^2.1.0",
-    "micromark-extension-gfm-autolink-literal": "^2.1.0",
-    "micromark-extension-gfm-footnote": "^2.1.0",
-    "micromark-extension-gfm-strikethrough": "^2.1.0",
-    "micromark-extension-gfm-table": "^2.1.1",
-    "micromark-extension-gfm-task-list-item": "^2.1.0",
     "rehype-katex": "^7.0.1",
     "rehype-raw": "^7.0.0",
     "rehype-sanitize": "^6.0.0",
     "rehype-slug": "^6.0.0",
     "remark-emoji": "^5.0.2",
-    "remark-frontmatter": "^5.0.0",
-    "remark-math": "^6.0.0",
-    "remark-parse": "^11.0.0",
     "remark-rehype": "^11.1.2",
-    "remark-stringify": "^11.0.0",
     "rst-compiler": "0.5.9",
     "unified": "^11.0.0",
     "unist-util-visit": "^5.0.0",
-    "web-tree-sitter": "^0.26.6",
     "yaml": "^2.8.2",
     "zod": "^4.3.6",
     "@lat.md/embed": "0.2.1",
-    "@lat.md/stemmer": "0.1.0",
-    "@lat.md/embed-minilm-fp16": "0.1.0"
+    "@plebeiantech/lat.md-core": "0.12.3-fork.20",
+    "@lat.md/embed-minilm-fp16": "0.1.0",
+    "@lat.md/stemmer": "0.1.0"
   },
   "scripts": {
     "build": "tsc && tsx scripts/fork-vendor-ui-server.ts && pnpm build:view",
@@ -131,12 +117,16 @@
     "setup:rust": "pnpm --filter @lat.md/embed setup:rust",
     "build:wasm": "pnpm --filter @lat.md/embed build:wasm",
     "build:weights": "pnpm --filter @lat.md/embed-minilm-fp16 build:weights",
-    "build:packages": "pnpm --filter @lat.md/server build && pnpm --filter @lat.md/stemmer build && pnpm --filter @lat.md/embed build && pnpm --filter @lat.md/embed-minilm-fp16 build",
+    "build:packages": "pnpm build:core && pnpm --filter @lat.md/server build && pnpm --filter @lat.md/stemmer build && pnpm --filter @lat.md/embed build && pnpm --filter @lat.md/embed-minilm-fp16 build",
     "test": "vitest run",
     "test:watch": "vitest",
-    "typecheck": "pnpm --filter @lat.md/server build && tsc --noEmit && tsc --noEmit -p view/tsconfig.json",
-    "format": "prettier --write \"src/**/*.ts\" \"packages/server/src/**/*.ts\" \"view/**/*.{ts,tsx,css,html}\"",
-    "format:check": "prettier --check \"src/**/*.ts\" \"packages/server/src/**/*.ts\" \"view/**/*.{ts,tsx,css,html}\"",
-    "cook-test-rag": "tsx scripts/cook-test-rag.ts"
+    "typecheck": "pnpm build:core && pnpm --filter @lat.md/server build && tsc --noEmit && tsc --noEmit -p view/tsconfig.json",
+    "format": "prettier --write \"src/**/*.ts\" \"packages/core/src/**/*.ts\" \"packages/server/src/**/*.ts\" \"view/**/*.{ts,tsx,css,html}\"",
+    "format:check": "prettier --check \"src/**/*.ts\" \"packages/core/src/**/*.ts\" \"packages/server/src/**/*.ts\" \"view/**/*.{ts,tsx,css,html}\"",
+    "cook-test-rag": "tsx scripts/cook-test-rag.ts",
+    "build:core": "pnpm --filter @plebeiantech/lat.md-core build",
+    "build:action": "pnpm build:core && node scripts/build-check-action.mjs",
+    "test:core": "node --test scripts/test-core-distribution.js",
+    "test:action": "node --test scripts/test-check-action.js"
   }
 }

package/templates/AGENTS.md

@@ -9,7 +9,7 @@ Use Lat's knowledge graph to ground each task before changing code.
 
 After EVERY task, before responding to the user:
 
-- [ ] Update `lat.md/` if you added or changed meaningful functionality, architecture, tests, behavior, or planned work. Keep it a focused snapshot of current/planned state, not a journal/changelog.
+- [ ] Update `lat.md/` if you added or changed meaningful implemented functionality, architecture, tests, or behavior. Keep it a focused snapshot of the current implemented state, not a journal/changelog. Plans may be drafted in `lat.md/` alongside implementation, with the intent that by commit time they describe what was implemented. Otherwise, keep proposals, hypothetical designs, and future work outside `lat.md/` unless the user explicitly requests them there.
 - [ ] Run `lat check` — all validations must pass
 - [ ] Do not skip these steps. Do not consider your task done until both are complete.
 
@@ -19,7 +19,7 @@ After EVERY task, before responding to the user:
 
 Lat.md is the project's structured knowledge graph for architecture, design decisions, behavior, and tests.
 
-The graph lives in `lat.md/` as cross-linked Markdown describing **what** the project does and **why**. Use it to ground work in actual architecture, and keep it a focused current/planned snapshot rather than a journal or changelog.
+The graph lives in `lat.md/` as cross-linked Markdown describing **what** the project does and **why**. Use it to ground work in actual architecture, and keep it a focused snapshot of the current implemented state rather than a journal or changelog.
 
 Project-specific lat documentation belongs in `lat.md/`. Do not modify this generated instruction file or a generated `lat-md` `SKILL.md` to record project guidance: both are owned by lat tooling and may be replaced by a later `lat init`.
 

package/templates/cursor-rules.md

@@ -9,7 +9,7 @@ Use Lat's knowledge graph to ground each task before changing code.
 
 After EVERY task, before responding to the user:
 
-- [ ] Update `lat.md/` if you added or changed meaningful functionality, architecture, tests, behavior, or planned work. Keep it a focused snapshot of current/planned state, not a journal/changelog.
+- [ ] Update `lat.md/` if you added or changed meaningful implemented functionality, architecture, tests, or behavior. Keep it a focused snapshot of the current implemented state, not a journal/changelog. Plans may be drafted in `lat.md/` alongside implementation, with the intent that by commit time they describe what was implemented. Otherwise, keep proposals, hypothetical designs, and future work outside `lat.md/` unless the user explicitly requests them there.
 - [ ] Use the `lat_check` tool — all validations must pass
 - [ ] Do not skip these steps. Do not consider your task done until both are complete.
 
@@ -19,7 +19,7 @@ After EVERY task, before responding to the user:
 
 Lat.md is the project's structured knowledge graph for architecture, design decisions, behavior, and tests.
 
-The graph lives in `lat.md/` as cross-linked Markdown describing **what** the project does and **why**. Use it to ground work in actual architecture, and keep it a focused current/planned snapshot rather than a journal or changelog.
+The graph lives in `lat.md/` as cross-linked Markdown describing **what** the project does and **why**. Use it to ground work in actual architecture, and keep it a focused snapshot of the current implemented state rather than a journal or changelog.
 
 # Tools
 

package/templates/opencode-plugin.ts

@@ -1,11 +1,11 @@
 import { type Plugin, tool } from "@opencode-ai/plugin"
-import { execSync } from "child_process"
+import { execSync, execFileSync } from "child_process"
 
-/** Absolute path to the lat binary, injected by `lat init`. */
-const LAT = "__LAT_BIN__"
+/** Executable and prefix arguments, injected by `lat init`. */
+const LAT = __LAT_INVOCATION__
 
 function run(args: string[]): string {
-  return execSync(`${LAT} ${args.join(" ")}`, {
+  return execFileSync(LAT.command, [...LAT.args, ...args], {
     cwd: process.cwd(),
     encoding: "utf-8",
     timeout: 30_000,
@@ -33,7 +33,7 @@ export const LatPlugin: Plugin = async (ctx) => {
           ),
         },
         async execute(args) {
-          const cliArgs = ["search", JSON.stringify(args.query)]
+          const cliArgs = ["search", args.query]
           if (args.limit) cliArgs.push("--limit", String(args.limit))
           const output = tryRun(cliArgs)
           return output || "No results found."
@@ -49,7 +49,7 @@ export const LatPlugin: Plugin = async (ctx) => {
           ),
         },
         async execute(args) {
-          const output = tryRun(["section", JSON.stringify(args.query)])
+          const output = tryRun(["section", args.query])
           return output || "Section not found."
         },
       }),
@@ -61,7 +61,7 @@ export const LatPlugin: Plugin = async (ctx) => {
           query: tool.schema.string("Section name to locate"),
         },
         async execute(args) {
-          const output = tryRun(["locate", JSON.stringify(args.query)])
+          const output = tryRun(["locate", args.query])
           return output || "No sections matching query."
         },
       }),
@@ -87,7 +87,7 @@ export const LatPlugin: Plugin = async (ctx) => {
           text: tool.schema.string("Text containing [[refs]] to expand"),
         },
         async execute(args) {
-          const output = tryRun(["expand", JSON.stringify(args.text)])
+          const output = tryRun(["expand", args.text])
           return output || args.text
         },
       }),
@@ -101,7 +101,7 @@ export const LatPlugin: Plugin = async (ctx) => {
           ),
         },
         async execute(args) {
-          const output = tryRun(["refs", JSON.stringify(args.query)])
+          const output = tryRun(["refs", args.query])
           return output || "No references found."
         },
       }),

package/templates/pi-extension.ts

@@ -30,12 +30,12 @@ function collapsibleResult(
   );
 }
 
-/** Absolute path to the lat binary, injected by `lat init`. */
-const LAT = "__LAT_BIN__";
+/** Executable and prefix arguments, injected by `lat init`. */
+const LAT = __LAT_INVOCATION__;
 
 function run(args: string[], cwd?: string): string {
-  const { execSync } = require("child_process") as typeof import("child_process");
-  return execSync(`${LAT} ${args.join(" ")}`, {
+  const { execFileSync } = require("child_process") as typeof import('child_process');
+  return execFileSync(LAT.command, [...LAT.args, ...args], {
     cwd: cwd ?? process.cwd(),
     encoding: "utf-8",
     timeout: 30_000,
@@ -69,7 +69,7 @@ export default function (pi: ExtensionAPI) {
       ),
     }),
     async execute(_id, params) {
-      const args = ["search", JSON.stringify(params.query)];
+      const args = ["search", params.query];
       if (params.limit) args.push("--limit", String(params.limit));
       const output = tryRun(args);
       return {
@@ -99,7 +99,7 @@ export default function (pi: ExtensionAPI) {
       }),
     }),
     async execute(_id, params) {
-      const output = tryRun(["section", JSON.stringify(params.query)]);
+      const output = tryRun(["section", params.query]);
       return {
         content: [
           { type: "text", text: output || "Section not found." },
@@ -126,7 +126,7 @@ export default function (pi: ExtensionAPI) {
       query: Type.String({ description: "Section name to locate" }),
     }),
     async execute(_id, params) {
-      const output = tryRun(["locate", JSON.stringify(params.query)]);
+      const output = tryRun(["locate", params.query]);
       return {
         content: [
           { type: "text", text: output || "No sections matching query." },
@@ -179,7 +179,7 @@ export default function (pi: ExtensionAPI) {
       text: Type.String({ description: "Text containing [[refs]] to expand" }),
     }),
     async execute(_id, params) {
-      const output = tryRun(["expand", JSON.stringify(params.text)]);
+      const output = tryRun(["expand", params.text]);
       return {
         content: [{ type: "text", text: output || params.text }],
       };
@@ -205,7 +205,7 @@ export default function (pi: ExtensionAPI) {
       }),
     }),
     async execute(_id, params) {
-      const output = tryRun(["refs", JSON.stringify(params.query)]);
+      const output = tryRun(["refs", params.query]);
       return {
         content: [{ type: "text", text: output || "No references found." }],
       };
@@ -276,7 +276,7 @@ export default function (pi: ExtensionAPI) {
       "Use `lat_section` to read the full content of relevant matches.",
       "Do not read files, write code, or run commands until you have searched.",
       "",
-      "Remember: `lat.md/` must stay in sync with meaningful codebase state. If you change behavior, architecture, tests, or planned work, update the relevant current-state sections and run `lat_check` before finishing. Do not use `lat.md/` as a journal/changelog or add notes for insignificant details.",
+      "Remember: `lat.md/` must stay in sync with meaningful codebase state. If you change implemented behavior, architecture, or tests, update the relevant current-state sections and run `lat_check` before finishing. Plans may be drafted in `lat.md/` alongside implementation, with the intent that by commit time they describe what was implemented. Otherwise, keep proposals, hypothetical designs, and future work outside `lat.md/` unless the user explicitly requests them there. Do not use `lat.md/` as a journal/changelog or add notes for insignificant details.",
     ].join("\n");
 
     return {
@@ -307,7 +307,7 @@ export default function (pi: ExtensionAPI) {
     let needsSync = false;
     let codeLines = 0;
     try {
-      const { execSync } = require("child_process") as typeof import("child_process");
+      const { execSync } = require("child_process") as typeof import('child_process');
       const numstat = execSync("git diff HEAD --numstat", {
         encoding: "utf-8",
         cwd: process.cwd(),

package/templates/skill/SKILL.md

@@ -16,7 +16,7 @@ Project-specific lat documentation belongs in `lat.md/`. Do not modify this gene
 
 `lat.md/` files describe **what** the project does and **why** — domain concepts, key design decisions, business logic, and test specifications. They do NOT duplicate source code. Think of each section as an anchor that source code references back to.
 
-Treat `lat.md/` as a focused snapshot of the current state of affairs or planned features. Do not use it as a journal or changelog, and do not grow it just to record insignificant implementation details.
+Treat `lat.md/` as a focused snapshot of the current implemented state. Plans may be drafted in `lat.md/` alongside implementation, with the intent that by commit time they describe what was implemented. Otherwise, keep proposals, hypothetical designs, and future work outside `lat.md/` unless the user explicitly requests them there. A planning-only task does not require a knowledge-graph update. Do not use it as a journal or changelog, and do not grow it just to record insignificant implementation details.
 
 Good candidates for sections:
 - Architecture decisions and their rationale
@@ -29,6 +29,7 @@ Bad candidates:
 - Step-by-step code walkthroughs (the code itself is the walkthrough)
 - Auto-generated API docs (use tools for that)
 - Journal/changelog entries for each change
+- Proposals, planned features, hypothetical designs, or promises of future behavior, unless explicitly requested by the user or drafted alongside implementation to describe implemented behavior by commit time
 - Temporary notes or TODOs
 - Insignificant implementation details that do not change the current-state model
 

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

@@ -1,56 +0,0 @@
-import { type LatFrontmatter, type MdLink, type Ref, type Section, type SectionSlugIndex } from '../lattice-model.js';
-import { type ScanResult } from '../code-refs.js';
-import { type ResolveSourceSymbolOptions } from '../source-parser.js';
-import { type ExternalResolver, type ResolvedExternalContent } from '../external-sources.js';
-import type { Profiler } from '../profiler.js';
-import { type MarkdownAnalysisExecutor, type MarkdownProjectAnalysis } from '../project-analysis.js';
-import type { LocalMarkdownDiagnostic } from '../markdown-validation.js';
-export type CheckSectionIndex = {
-    sectionIds: Set<string>;
-    fileIndex: Map<string, string[]>;
-    slugIndex: SectionSlugIndex;
-};
-/** Lazy, command-scoped cache shared by every validator in one check run. */
-export declare class CheckRunContext {
-    readonly latticeDir: string;
-    readonly projectRoot: string;
-    readonly profile?: Profiler | undefined;
-    readonly executor: MarkdownAnalysisExecutor;
-    private projectPromise?;
-    private codeRefsPromise?;
-    private externalResolverPromise?;
-    private reconciledExternalPromise?;
-    private sourceSymbolCacheCleared;
-    private readonly sourceParserRuntime;
-    private readonly headingPromises;
-    private readonly externalContentPromises;
-    private readonly repositoryLinkErrorPromises;
-    private readonly auxiliaryFilePromises;
-    constructor(latticeDir: string, projectRoot: string, profile?: Profiler | undefined, executor?: MarkdownAnalysisExecutor);
-    private time;
-    private timeSync;
-    private recordAnalysis;
-    private recordParserImport;
-    private recordSourceAnalysis;
-    private recordExternalDocumentAnalysis;
-    sourceSymbolOptions(): ResolveSourceSymbolOptions;
-    clearSourceSymbolCache(): void;
-    project(): Promise<MarkdownProjectAnalysis>;
-    entries(): Promise<string[]>;
-    markdownFiles(): Promise<string[]>;
-    private file;
-    content(file: string): Promise<string>;
-    sections(file: string): Promise<Section[]>;
-    refs(file: string): Promise<Ref[]>;
-    links(file: string): Promise<MdLink[]>;
-    frontmatter(file: string): Promise<LatFrontmatter>;
-    diagnostics(file: string): Promise<LocalMarkdownDiagnostic[]>;
-    allSections(): Promise<Section[]>;
-    sectionIndex(): Promise<CheckSectionIndex>;
-    headings(file: string): Promise<Set<string>>;
-    codeRefs(): Promise<ScanResult>;
-    private loadExternalResolver;
-    externalResolver(): Promise<ExternalResolver>;
-    resolveExternal(target: string): Promise<ResolvedExternalContent>;
-    resolveRepositoryLink(target: string, resolveLink: () => Promise<string | null>): Promise<string | null>;
-}