trail-code 0.0.0-stage → 0.28.0-semantic.3

package/dist/context/map-dir.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"map-dir.d.ts","sourceRoot":"","sources":["../../src/context/map-dir.ts"],"names":[],"mappings":"AAgCA,iEAAiE;AACjE,eAAO,MAAM,aAAa,QAA0B,CAAC;AACrD,wCAAwC;AACxC,eAAO,MAAM,aAAa,UAAU,CAAC;AAErC;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAM9C;AAED,8FAA8F;AAC9F,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAEhE"}

package/dist/context/map-dir.js

@@ -0,0 +1,81 @@
+/**
+ * Where a repo's code map lives.
+ *
+ * In a repo on trail, `.trail/cache/`: inside the one folder a team commits,
+ * and kept out of git by `.trail/.gitignore`, so neither the repo's own
+ * `.gitignore` nor a root `.ignore` has to name it. Everywhere else `graft/`,
+ * as before. Being a hidden folder, `.trail/cache/` is skipped by a grep from
+ * the repo root; the agent reaches it through `trail ask` and the path the
+ * session-start hook names, and a grep given that path searches it.
+ *
+ * A map still in `graft/` from before the repo moved to trail is renamed into
+ * place the first time anyone asks where the map is, so a session never
+ * rebuilds what's already on disk.
+ */
+import { WINHIDE } from "../util/child-process.js";
+import { execFileSync } from "node:child_process";
+import { existsSync, mkdirSync, readFileSync, renameSync, writeFileSync } from "node:fs";
+import { join } from "node:path";
+import { repoWiredForTrail } from "../brand.js";
+/** Write `entry` into `.trail/.gitignore` so the cache stays out of git. */
+function ignoreInTrailDir(root, entry) {
+    const trailDir = join(root, '.trail');
+    mkdirSync(trailDir, { recursive: true });
+    const giPath = join(trailDir, '.gitignore');
+    let current = '';
+    try {
+        current = readFileSync(giPath, 'utf8');
+    }
+    catch { /* new file */ }
+    if (!current.split('\n').some(l => l.trim() === entry.trim())) {
+        writeFileSync(giPath, current ? `${current.trimEnd()}\n${entry}\n` : `${entry}\n`);
+    }
+}
+/** The map's folder in a repo on trail, relative to the repo. */
+export const TRAIL_MAP_DIR = join(".trail", "cache");
+/** The map's folder everywhere else. */
+export const GRAFT_MAP_DIR = "graft";
+/**
+ * Absolute path of `root`'s code map folder. A repo is on trail once its
+ * hooks say so or it has `.trail/learnings/`, which `trail init` makes before
+ * anything else, so nothing it writes lands in `graft/` first.
+ */
+export function mapDirFor(root) {
+    const trail = join(root, TRAIL_MAP_DIR);
+    if (existsSync(trail))
+        return trail;
+    if (!existsSync(join(root, ".trail", "learnings")) && !repoWiredForTrail(root))
+        return join(root, GRAFT_MAP_DIR);
+    moveOldMap(root, trail);
+    return trail;
+}
+/** Whether `dir` is a repo's trail map folder, which `.trail/.gitignore` keeps out of git. */
+export function isTrailMapDir(root, dir) {
+    return join(root, TRAIL_MAP_DIR) === join(dir);
+}
+/**
+ * `graft/` holding a map from before the repo moved to trail: renamed to
+ * `.trail/cache/`. Left alone when git tracks it (a map committed back when
+ * it was shared), since moving it would delete committed files.
+ */
+function moveOldMap(root, to) {
+    const from = join(root, GRAFT_MAP_DIR);
+    if (!existsSync(join(from, "INDEX.md")) && !existsSync(join(from, ".graph")))
+        return;
+    try {
+        execFileSync("git", ["ls-files", "--error-unmatch", "--", "graft/INDEX.md"], { ...WINHIDE, cwd: root, stdio: "ignore", timeout: 3000 });
+        return;
+    }
+    catch {
+        // untracked, or not a git checkout: ours to move
+    }
+    try {
+        mkdirSync(join(root, ".trail"), { recursive: true });
+        ignoreInTrailDir(root, "cache/");
+        renameSync(from, to);
+    }
+    catch {
+        // Another process moved it first, or it can't move: the next build makes a new one.
+    }
+}
+//# sourceMappingURL=map-dir.js.map

package/dist/context/map-dir.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"map-dir.js","sourceRoot":"","sources":["../../src/context/map-dir.ts"],"names":[],"mappings":"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"}

package/dist/context/node-file.d.ts

@@ -0,0 +1,109 @@
+/** A source file a node was derived from, with its content hash at generation time. */
+export interface SourceRef {
+    path: string;
+    hash: string;
+}
+/** A directed edge to another node (by slug). */
+export interface NodeLink {
+    to: string;
+    relation: string;
+    description?: string;
+}
+/** A single node in the graph — one markdown file. */
+export interface ContextNode {
+    name: string;
+    slug: string;
+    /** Coarse category from extraction: system | service | api | concept | … */
+    type: string;
+    /** Prose description that becomes the node body. */
+    summary: string;
+    /** Source files that produced this node (empty only for hand-authored nodes). */
+    sources: SourceRef[];
+    /** sha256 over the sorted `path:hash` lines of {@link sources}. */
+    sourcesDigest: string;
+    /** Outbound edges. */
+    links: NodeLink[];
+    /** Free-form region below the generated block, preserved across re-runs. */
+    human: string;
+}
+/** The generated index written alongside the node files. */
+export interface Manifest {
+    version: number;
+    /** Human label for the model that built the graph, e.g. "openrouter:openai/gpt-4o-mini". */
+    model: string;
+    /** sha256 over every source file's `path:hash` — the whole-graph fingerprint. */
+    repoDigest: string;
+    /** Every source file `init` processed, with its hash. The staleness ground-truth. */
+    files: SourceRef[];
+    /** Node roster (a subset of each node's frontmatter, for fast reads). */
+    nodes: Array<{
+        slug: string;
+        name: string;
+        type: string;
+        sources: string[];
+        sourcesDigest: string;
+    }>;
+}
+export declare const MANIFEST_VERSION = 1;
+/** Gitignored cache dir (per-file summaries + extractions), never committed. */
+export declare const CACHE_DIR = ".cache";
+/** Turn a display name into a stable, filesystem- and link-safe slug. */
+export declare function slugify(name: string): string;
+/** sha256 over the sorted `path:hash` lines of a set of sources. */
+export declare function digestSources(sources: SourceRef[]): string;
+/** Absolute path of a repo's code map: `graft/`, or `.trail/cache/` in a repo
+ * on trail (see context/map-dir.ts). An explicit `--dir` wins. `graft/` is
+ * visible (not dot-prefixed) on purpose: default ripgrep skips hidden dirs, so
+ * a grep can land on its cards; under trail the hooks name the path instead. */
+export declare function contextDirFor(root: string, override?: string): string;
+/** Why `.graft/` is ignored, which is a different reason: not that it is cheap
+ *  to regenerate, but that it holds a token. */
+export declare const LINK_NOTE = "graft's brain link \u2014 holds a read token, never commit it.";
+export declare function ensureGitignored(root: string, contextDir: string, note?: string): void;
+/**
+ * Keep the card tree greppable even though it's gitignored, by writing a root
+ * `.ignore` that re-admits it.
+ *
+ * The cards exist so that a `grep <symbol>` lands on a ~150-token card instead of
+ * a whole source file. Making the graph a local cache (and so gitignored) silently
+ * broke that: **ripgrep honours `.gitignore`**, and every ripgrep-backed search
+ * tool inherits the blind spot — verified by a card that names a symbol which
+ * default `rg` will not return and `rg -uu` finds instantly. `.ignore` is read at
+ * higher precedence than `.gitignore`, so re-admitting the tree there restores
+ * search without git ever tracking a byte of it.
+ *
+ * The two negative entries matter as much as the positive one: `.cache/` holds a
+ * multi-MB parse memo and `.graph/` holds `wiring.json`, and dropping either into
+ * every repo-wide search would be worse than the problem being fixed.
+ *
+ * Same contract as {@link ensureGitignored}: idempotent, skips a context dir
+ * outside `root`, and swallows write failures — a build that already succeeded
+ * must not fail over a convenience file.
+ */
+export declare function ensureSearchable(root: string, contextDir: string): void;
+/** Serialize a node to its full markdown file contents. */
+export declare function renderNodeFile(node: ContextNode): string;
+/**
+ * Write a node file, preserving any existing human region. Returns the file
+ * path written.
+ */
+export declare function writeNode(dir: string, node: ContextNode): string;
+/** A node file parsed back off disk (frontmatter only; body is not needed for `check`). */
+export interface ParsedNode {
+    slug: string;
+    name: string;
+    type: string;
+    sources: SourceRef[];
+    sourcesDigest: string;
+    links: NodeLink[];
+}
+/** Read and parse every concept-node `.md` in a context dir (skips INDEX.md
+ * and root-level per-file cards). */
+export declare function readNodes(dir: string): ParsedNode[];
+/** List the node files present (slug → filename), for pruning deleted nodes. */
+export declare function existingNodeSlugs(dir: string): Set<string>;
+/** Delete a node file by slug. */
+export declare function deleteNode(dir: string, slug: string): void;
+export declare function writeManifest(dir: string, manifest: Manifest): void;
+export declare function readManifest(dir: string): Manifest | undefined;
+//# sourceMappingURL=node-file.d.ts.map

package/dist/context/node-file.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"node-file.d.ts","sourceRoot":"","sources":["../../src/context/node-file.ts"],"names":[],"mappings":"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"}

package/dist/context/node-file.js

@@ -0,0 +1,390 @@
+/**
+ * The on-disk format of the context graph: a folder of plain markdown files
+ * under `.context/`, one per node. The files ARE the graph — the frontmatter
+ * carries the machine-readable node (identity, source provenance, edges) and
+ * the body is human/agent-readable prose. There is no database.
+ *
+ * Layout of a node file:
+ *
+ *   ---                         ← YAML frontmatter (canonical, machine-owned)
+ *   name / slug / type
+ *   sources: [{path, hash}]     ← provenance + the staleness key
+ *   sources_digest
+ *   links: [{to, relation}]     ← edges (canonical form)
+ *   ---
+ *   <!-- context:generated:start -->
+ *   ## Summary … ## Related …   ← regenerated on every `init`
+ *   <!-- context:generated:end -->
+ *   ## Notes …                  ← anything a human writes is preserved verbatim
+ *
+ * `.context/manifest.json` is a generated index over all nodes plus the full
+ * file→hash map `init` saw, so `check` can detect drift in O(files) without an
+ * LLM and without re-reading every node body.
+ */
+import { readFileSync, writeFileSync, mkdirSync, existsSync, readdirSync, rmSync } from "node:fs";
+import { join } from "node:path";
+import { spawnSync } from "node:child_process";
+import { matter } from "../util/front-matter.js";
+import { contentHash, normalizeName } from "../util/id.js";
+import { relPosix, stripTrailingSlashes } from "../util/paths.js";
+// Value-only import of a constant; `write.ts` pulls in nothing from here, so no cycle.
+import { GRAPH_DIR } from "../graph/write.js";
+import { mapDirFor, isTrailMapDir } from "./map-dir.js";
+/** Write `entry` into `.trail/.gitignore` so the cache stays out of git. */
+function ignoreInTrailDir(root, entry) {
+    const trailDir = join(root, '.trail');
+    mkdirSync(trailDir, { recursive: true });
+    const giPath = join(trailDir, '.gitignore');
+    let current = '';
+    try {
+        current = readFileSync(giPath, 'utf8');
+    }
+    catch { /* new file */ }
+    if (!current.split('\n').some(l => l.trim() === entry.trim())) {
+        writeFileSync(giPath, current ? `${current.trimEnd()}\n${entry}\n` : `${entry}\n`);
+    }
+}
+export const MANIFEST_VERSION = 1;
+const GEN_START = "<!-- context:generated:start -->";
+const GEN_END = "<!-- context:generated:end -->";
+const MANIFEST_FILE = "manifest.json";
+/** Gitignored cache dir (per-file summaries + extractions), never committed. */
+export const CACHE_DIR = ".cache";
+/** Env kill switch — same truthy parsing as `GRAFT_NO_REFRESH` in ../graph/refresh.ts. */
+function envTruthy(name) {
+    const v = process.env[name];
+    return v !== undefined && v !== "" && v !== "0" && v !== "false";
+}
+/** Turn a display name into a stable, filesystem- and link-safe slug. */
+export function slugify(name) {
+    const base = normalizeName(name)
+        .replace(/[^a-z0-9]+/g, "-")
+        .replace(/^-+|-+$/g, "");
+    return base || "node";
+}
+/** sha256 over the sorted `path:hash` lines of a set of sources. */
+export function digestSources(sources) {
+    const lines = sources
+        .map((s) => `${s.path}:${s.hash}`)
+        .sort()
+        .join("\n");
+    return contentHash(lines);
+}
+/** Absolute path of a repo's code map: `graft/`, or `.trail/cache/` in a repo
+ * on trail (see context/map-dir.ts). An explicit `--dir` wins. `graft/` is
+ * visible (not dot-prefixed) on purpose: default ripgrep skips hidden dirs, so
+ * a grep can land on its cards; under trail the hooks name the path instead. */
+export function contextDirFor(root, override) {
+    if (override)
+        return override;
+    return mapDirFor(root);
+}
+/**
+ * Make sure the repo's root `.gitignore` ignores the graft output dir. The
+ * graph is a local, regenerable cache (like `node_modules`), not a committed
+ * artifact, so every `graft build` adds the entry itself the first time — the
+ * user never has to think about it. No-ops when the entry is already present,
+ * when git already ignores the dir by other means (`.git/info/exclude`, a parent
+ * `.gitignore`, `core.excludesFile`), or when the dir lives outside `root` (a
+ * custom `--dir` elsewhere, which can't be expressed as a repo-relative ignore).
+ * Best-effort: an unwritable `.gitignore` must never abort a build, so write
+ * failures are swallowed.
+ */
+const GRAPH_CACHE_NOTE = "graft's local graph cache — regenerable, not committed (run `graft build`).";
+/** Why `.graft/` is ignored, which is a different reason: not that it is cheap
+ *  to regenerate, but that it holds a token. */
+export const LINK_NOTE = "graft's brain link — holds a read token, never commit it.";
+export function ensureGitignored(root, contextDir, note = GRAPH_CACHE_NOTE) {
+    if (envTruthy("GRAFT_NO_GITIGNORE"))
+        return;
+    // trail's map: `.trail/.gitignore` keeps it out, and the repo's own file is never touched.
+    if (isTrailMapDir(root, contextDir)) {
+        try {
+            ignoreInTrailDir(root, "cache/");
+        }
+        catch { /* best-effort */ }
+        return;
+    }
+    const rel = relPosix(root, contextDir);
+    if (rel === "" || rel.startsWith(".."))
+        return; // dir is at/above the repo root — nothing sane to ignore
+    const bare = stripTrailingSlashes(rel); // "graft" (or a `--dir` subpath like "tools/ctx")
+    // Root-ANCHORED, so it ignores exactly this repo's `graft/` and not a directory named
+    // `graft` at any depth. An unanchored `graft/` also matched `.claude/skills/graft/`, so
+    // committing the skill graft just wrote was silently dropped (#79). `rel` is always
+    // repo-relative here, so a leading `/` is always safe (incl. a `--dir` subpath).
+    const entry = `/${bare}/`;
+    const path = join(root, ".gitignore");
+    let current = "";
+    try {
+        current = readFileSync(path, "utf8");
+    }
+    catch { /* no .gitignore yet — we create one */ }
+    // Accept the anchored form AND the older unanchored `graft/` / `graft`, so existing
+    // repos aren't double-appended and a hand-anchored entry survives the next build.
+    const present = current.split("\n").some((l) => {
+        const t = l.trim();
+        return t === entry || t === `${bare}/` || t === bare;
+    });
+    if (present)
+        return;
+    // Not in `.gitignore` itself, but git may already ignore the dir through `.git/info/exclude`,
+    // a parent `.gitignore` or `core.excludesFile`. Then there is nothing to add, and appending
+    // would dirty the checkout again on every build for a user who keeps tooling noise out of
+    // the tracked `.gitignore` on purpose.
+    if (gitAlreadyIgnores(root, bare))
+        return;
+    const gap = current === "" ? "" : current.endsWith("\n") ? "\n" : "\n\n";
+    const block = `${gap}# ${note}\n${entry}\n`;
+    try {
+        writeFileSync(path, current + block);
+    }
+    catch { /* best-effort — build already succeeded */ }
+}
+/** Variables that point git at a different repo than the one in `cwd` (a git hook exports
+ *  `GIT_DIR` and `GIT_INDEX_FILE`, a wrapper may export the rest). Left in the child's
+ *  environment they make `check-ignore` answer for that other repo. */
+const GIT_REPO_ENV = [
+    "GIT_DIR", "GIT_WORK_TREE", "GIT_INDEX_FILE", "GIT_COMMON_DIR", "GIT_OBJECT_DIRECTORY", "GIT_NAMESPACE",
+];
+/** True when `root` is a git work tree whose ignore rules (every source git reads: `.gitignore`
+ *  files, `.git/info/exclude`, `core.excludesFile`) already cover the directory `rel/`. Any
+ *  failure (git missing, not a repo, timeout) answers false, so the caller falls back to
+ *  writing the entry. The trailing slash makes git treat the path as a directory, so dir-only
+ *  patterns like `graft/` match. A negation rule (an allowlist `.gitignore` that re-includes
+ *  directories) can judge a not-yet-created path differently from an existing one, so callers
+ *  create the dir first. `core.fsmonitor` is off because it would run a command named by the
+ *  repo's own config. */
+function gitAlreadyIgnores(root, rel) {
+    try {
+        const env = { ...process.env };
+        for (const k of GIT_REPO_ENV)
+            delete env[k];
+        const r = spawnSync("git", ["-c", "core.fsmonitor=false", "check-ignore", "-q", "--", `${rel}/`], {
+            cwd: root, env, stdio: "ignore", timeout: 5000, windowsHide: true,
+        });
+        return r.status === 0;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Keep the card tree greppable even though it's gitignored, by writing a root
+ * `.ignore` that re-admits it.
+ *
+ * The cards exist so that a `grep <symbol>` lands on a ~150-token card instead of
+ * a whole source file. Making the graph a local cache (and so gitignored) silently
+ * broke that: **ripgrep honours `.gitignore`**, and every ripgrep-backed search
+ * tool inherits the blind spot — verified by a card that names a symbol which
+ * default `rg` will not return and `rg -uu` finds instantly. `.ignore` is read at
+ * higher precedence than `.gitignore`, so re-admitting the tree there restores
+ * search without git ever tracking a byte of it.
+ *
+ * The two negative entries matter as much as the positive one: `.cache/` holds a
+ * multi-MB parse memo and `.graph/` holds `wiring.json`, and dropping either into
+ * every repo-wide search would be worse than the problem being fixed.
+ *
+ * Same contract as {@link ensureGitignored}: idempotent, skips a context dir
+ * outside `root`, and swallows write failures — a build that already succeeded
+ * must not fail over a convenience file.
+ */
+export function ensureSearchable(root, contextDir) {
+    if (envTruthy("GRAFT_NO_IGNORE"))
+        return;
+    // trail's map is reached by the path the hooks name, not by a grep from the root: no `.ignore`.
+    if (isTrailMapDir(root, contextDir))
+        return;
+    const rel = relPosix(root, contextDir);
+    if (rel === "" || rel.startsWith(".."))
+        return; // outside the repo — nothing to re-admit
+    const dir = stripTrailingSlashes(rel);
+    const entry = `!${dir}/`;
+    const path = join(root, ".ignore");
+    let current = "";
+    try {
+        current = readFileSync(path, "utf8");
+    }
+    catch { /* no .ignore yet — we create one */ }
+    // Any mention of the negation means a human (or a previous build) has already
+    // had an opinion here; leave it alone rather than append a second copy.
+    if (current.split("\n").some((l) => l.trim() === entry))
+        return;
+    const gap = current === "" ? "" : current.endsWith("\n") ? "\n" : "\n\n";
+    const block = `${gap}# graft's cards are gitignored but should stay greppable: ripgrep reads\n` +
+        `# .ignore before .gitignore, so this re-admits the tree to search only.\n` +
+        `${entry}\n${dir}/${CACHE_DIR}/\n${dir}/${GRAPH_DIR}/\n`;
+    try {
+        writeFileSync(path, current + block);
+    }
+    catch { /* best-effort */ }
+}
+/** Render the generated body (Summary + Related) for a node. */
+function renderGenerated(node) {
+    const lines = [`## Summary`, ``, node.summary.trim() || "_(no summary)_", ``];
+    if (node.links.length > 0) {
+        lines.push(`## Related`, ``);
+        for (const link of [...node.links].sort((a, b) => a.to.localeCompare(b.to))) {
+            const rel = link.relation.replace(/_/g, " ");
+            const tail = link.description ? ` — ${link.description}` : "";
+            lines.push(`- ${rel} [[${link.to}]]${tail}`);
+        }
+        lines.push(``);
+    }
+    return lines.join("\n");
+}
+/** Default human region for a brand-new node (preserved verbatim afterwards). */
+function defaultHuman() {
+    return `\n## Notes\n\n_Anything written below the generated block is preserved when the graph is regenerated._\n`;
+}
+/** Serialize a node to its full markdown file contents. */
+export function renderNodeFile(node) {
+    const data = {
+        name: node.name,
+        slug: node.slug,
+        type: node.type,
+        sources: node.sources.map((s) => ({ path: s.path, hash: s.hash })),
+        sources_digest: node.sourcesDigest,
+        links: node.links.map((l) => l.description ? { to: l.to, relation: l.relation, description: l.description } : { to: l.to, relation: l.relation }),
+        generator: { version: MANIFEST_VERSION },
+    };
+    const body = `${GEN_START}\n${renderGenerated(node)}${GEN_END}\n${node.human}`;
+    // gray-matter appends a trailing newline; keep output stable across runs.
+    return matter.stringify(body, data);
+}
+/**
+ * Extract the human region (everything after the generated-end marker) from an
+ * existing node file so it survives regeneration. If the markers are missing
+ * (a hand-deleted or foreign file), returns a fresh default region.
+ */
+function preserveHuman(existingContent) {
+    const idx = existingContent.indexOf(GEN_END);
+    if (idx === -1)
+        return defaultHuman();
+    return existingContent.slice(idx + GEN_END.length).replace(/^\n/, "");
+}
+/**
+ * Write a node file, preserving any existing human region. Returns the file
+ * path written.
+ */
+export function writeNode(dir, node) {
+    mkdirSync(dir, { recursive: true });
+    const path = join(dir, `${node.slug}.md`);
+    if (existsSync(path)) {
+        const parsed = matter(readFileSync(path, "utf8"));
+        node = { ...node, human: preserveHuman(parsed.content) };
+    }
+    else {
+        node = { ...node, human: node.human || defaultHuman() };
+    }
+    writeFileSync(path, renderNodeFile(node));
+    return path;
+}
+/**
+ * Stems of per-file wiring cards that sit at the graft/ top level — i.e. cards
+ * for source files in the repo root. Those cards share a directory with concept
+ * nodes (`graft/<stem>.md`) but are recorded in `manifest.files`, not
+ * `manifest.nodes`. Nested file cards live in subdirs and are never scanned here.
+ *
+ * Incomplete on its own (#261): the graph can write a root card for a source
+ * that the concept pipeline never recorded (different extension lists), so the
+ * stem is absent from `manifest.files`. Combined with isRootFileCard().
+ */
+function rootFileCardStems(dir) {
+    const manifest = readManifest(dir);
+    if (!manifest)
+        return new Set();
+    const stems = new Set();
+    for (const f of manifest.files) {
+        if (f.path.includes("/"))
+            continue;
+        stems.add(f.path.replace(/\.[^./]+$/, ""));
+    }
+    return stems;
+}
+function hasConceptSlug(fm) {
+    return fm.slug != null && String(fm.slug).length > 0;
+}
+/** `writeCovers` used to stamp `covers: []` onto slug-less root file cards. */
+function isCoversOnlyFileCard(fm) {
+    if (hasConceptSlug(fm) || !("covers" in fm))
+        return false;
+    return fm.name == null && fm.type == null && fm.sources == null;
+}
+/** Wiring cards start with `# <source path with extension>`, optionally followed
+ * by ` · [[slug]]` up-links. A hand-dropped `notes.md` does not. */
+function isWiringCardHeading(content) {
+    const line = content.trimStart().split(/\r?\n/, 1)[0] ?? "";
+    return /^# [^\s#]+\.[A-Za-z0-9]{1,12}(?:\s|$)/.test(line);
+}
+/**
+ * A top-level `.md` that is a per-file wiring card, not a concept node.
+ * Real concepts always carry `slug` in frontmatter and are never skipped.
+ * A hand-dropped `notes.md` has no slug, no `covers`, and no file-path heading,
+ * so it still surfaces as indexDrift (#215 / #261).
+ */
+function isRootFileCard(stem, fm, content, fileCardStems) {
+    if (hasConceptSlug(fm))
+        return false;
+    if (fileCardStems.has(stem))
+        return true;
+    if (isCoversOnlyFileCard(fm))
+        return true;
+    return isWiringCardHeading(content);
+}
+/** Read and parse every concept-node `.md` in a context dir (skips INDEX.md
+ * and root-level per-file cards). */
+export function readNodes(dir) {
+    if (!existsSync(dir))
+        return [];
+    const fileCardStems = rootFileCardStems(dir);
+    const out = [];
+    for (const entry of readdirSync(dir)) {
+        if (!entry.endsWith(".md") || entry === "INDEX.md")
+            continue;
+        const parsed = matter(readFileSync(join(dir, entry), "utf8"));
+        const fm = parsed.data;
+        const fallbackSlug = entry.replace(/\.md$/, "");
+        if (isRootFileCard(fallbackSlug, fm, parsed.content, fileCardStems))
+            continue;
+        out.push({
+            slug: String(fm.slug ?? fallbackSlug),
+            name: String(fm.name ?? ""),
+            type: String(fm.type ?? ""),
+            sources: Array.isArray(fm.sources) ? fm.sources : [],
+            sourcesDigest: String(fm.sources_digest ?? ""),
+            links: Array.isArray(fm.links) ? fm.links : [],
+        });
+    }
+    return out;
+}
+/** List the node files present (slug → filename), for pruning deleted nodes. */
+export function existingNodeSlugs(dir) {
+    if (!existsSync(dir))
+        return new Set();
+    return new Set(readdirSync(dir)
+        .filter((e) => e.endsWith(".md") && e !== "INDEX.md")
+        .map((e) => e.replace(/\.md$/, "")));
+}
+/** Delete a node file by slug. */
+export function deleteNode(dir, slug) {
+    const path = join(dir, `${slug}.md`);
+    if (existsSync(path))
+        rmSync(path);
+}
+export function writeManifest(dir, manifest) {
+    mkdirSync(dir, { recursive: true });
+    writeFileSync(join(dir, MANIFEST_FILE), JSON.stringify(manifest, null, 2) + "\n");
+}
+export function readManifest(dir) {
+    const path = join(dir, MANIFEST_FILE);
+    if (!existsSync(path))
+        return undefined;
+    try {
+        return JSON.parse(readFileSync(path, "utf8"));
+    }
+    catch {
+        return undefined;
+    }
+}
+//# sourceMappingURL=node-file.js.map

package/dist/context/node-file.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"node-file.js","sourceRoot":"","sources":["../../src/context/node-file.ts"],"names":[],"mappings":"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"}