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

package/dist/hosts/sections.js

@@ -0,0 +1,127 @@
+/**
+ * Marker-fenced section upsert. Graft owns exactly the region between the
+ * markers; everything else in the file belongs to the user and is preserved.
+ */
+import { readFileSync, writeFileSync, mkdirSync, existsSync } from 'node:fs';
+import { dirname } from 'node:path';
+export const START = '<!-- graft:start -->';
+export const END = '<!-- graft:end -->';
+/** The same block in a repo wired by trail. */
+export const TRAIL_START = '<!-- trail:start -->';
+export const TRAIL_END = '<!-- trail:end -->';
+/**
+ * A brain's rules go in their OWN fenced block, not inside the instruction
+ * block above.
+ *
+ * They have to be separately addressable: the instruction body is static and
+ * rewritten by `init`, while rules change whenever the brain does and are
+ * refreshed on their own. One pair of markers for both would mean every rules
+ * refresh rewrites the instructions too, and `graft uninstall` could not remove
+ * one without the other.
+ */
+export const BRAIN_START = '<!-- graft:brain:start -->';
+export const BRAIN_END = '<!-- graft:brain:end -->';
+export const GRAFT_MARKERS = { start: START, end: END };
+export const TRAIL_MARKERS = { start: TRAIL_START, end: TRAIL_END };
+export const BRAIN_MARKERS = { start: BRAIN_START, end: BRAIN_END };
+/** Every managed region graft may own in a user-owned file. */
+export const ALL_MARKERS = [GRAFT_MARKERS, TRAIL_MARKERS, BRAIN_MARKERS];
+/** The instruction block's markers under each name. */
+export function markersFor(name) {
+    return name === 'trail' ? TRAIL_MARKERS : GRAFT_MARKERS;
+}
+export function fencedBlock(body, eol = '\n', markers = GRAFT_MARKERS) {
+    // Normalize any pre-existing '\r' out of the body first so callers passing
+    // a CRLF (or stray-CR) body never get doubled '\r' when eol is '\r\n'.
+    const normalizedBody = body.replace(/\r/g, '');
+    const block = `${markers.start}\n${normalizedBody.replace(/\s+$/, '')}\n${markers.end}`;
+    return eol === '\n' ? block : block.replace(/\n/g, '\r\n');
+}
+/** The file's dominant line ending: CRLF if any '\r\n' is present, else LF. */
+function detectEol(text) {
+    return text.includes('\r\n') ? '\r\n' : '\n';
+}
+/** Index of a marker that sits alone on its own line, or -1. */
+function markerLineIndex(lines, marker, from = 0) {
+    for (let i = from; i < lines.length; i++) {
+        if (lines[i].trim() === marker)
+            return i;
+    }
+    return -1;
+}
+/** The start and end line of the block fenced by `markers`, or null. */
+function blockSpan(lines, markers) {
+    const s = markerLineIndex(lines, markers.start);
+    const e = s === -1 ? -1 : markerLineIndex(lines, markers.end, s + 1);
+    return s !== -1 && e !== -1 ? { s, e } : null;
+}
+/**
+ * `lines` without the block at `sp`, and the blank line that set it off: the
+ * one after it, or else the one before it. The file's final newline stays.
+ */
+function withoutBlock(lines, sp) {
+    const blank = (i) => i >= 0 && i < lines.length && lines[i].trim() === '';
+    let { s, e } = sp;
+    if (blank(e + 1) && e + 1 < lines.length - 1)
+        e++;
+    else if (blank(s - 1))
+        s--;
+    return [...lines.slice(0, s), ...lines.slice(e + 1)];
+}
+/**
+ * Write `body` into the block fenced by `markers`, keeping the rest of the file.
+ *
+ * `replaces` names blocks this one supersedes: a repo moving from graft's
+ * names to trail's has a `graft:start` block where the `trail:start` one
+ * goes. The block takes the place of its own markers if they're there, or of
+ * the first superseded block, and any other superseded block goes, so the
+ * file never ends up with both.
+ */
+export function upsertSection(filePath, body, markers = GRAFT_MARKERS, replaces = []) {
+    if (!existsSync(filePath)) {
+        const block = fencedBlock(body, '\n', markers);
+        mkdirSync(dirname(filePath), { recursive: true });
+        writeFileSync(filePath, `${block}\n`);
+        return { action: 'created' };
+    }
+    const text = readFileSync(filePath, 'utf8');
+    const eol = detectEol(text);
+    // Split on either eol so lines never carry an embedded '\r' — that keeps
+    // the marker/content comparison clean and lets us rejoin deliberately with
+    // the detected eol instead of relying on '\r' characters riding along
+    // inside array elements (which broke down whenever the block-with-no-
+    // trailing-'\r' element sat next to a '\n' join, e.g. right after END, or
+    // when the block was the entire file).
+    const lines = text.split(/\r\n|\n/);
+    const s = markerLineIndex(lines, markers.start);
+    const e = s === -1 ? -1 : markerLineIndex(lines, markers.end, s + 1);
+    const superseded = replaces.map((m) => blockSpan(lines, m)).filter((sp) => sp !== null);
+    if (superseded.length > 0) {
+        const own = s !== -1 && e !== -1 ? { s, e } : null;
+        const at = own ?? superseded[0];
+        // Bottom up, so the line numbers of the blocks above stay true.
+        let next = lines;
+        for (const sp of [...(own ? [own] : []), ...superseded].sort((a, b) => b.s - a.s)) {
+            next = sp === at
+                ? [...next.slice(0, sp.s), ...fencedBlock(body, '\n', markers).split('\n'), ...next.slice(sp.e + 1)]
+                : withoutBlock(next, sp);
+        }
+        writeFileSync(filePath, next.join(eol));
+        return { action: 'replaced' };
+    }
+    if (s !== -1 && e !== -1) {
+        const current = lines.slice(s, e + 1).join('\n');
+        if (current === fencedBlock(body, '\n', markers))
+            return { action: 'unchanged' };
+        const block = fencedBlock(body, eol, markers);
+        const next = [...lines.slice(0, s), ...block.split(eol), ...lines.slice(e + 1)];
+        writeFileSync(filePath, next.join(eol));
+        return { action: 'replaced' };
+    }
+    const block = fencedBlock(body, eol, markers);
+    const doubleEol = eol + eol;
+    const sep = text.endsWith(doubleEol) ? '' : text.endsWith(eol) ? eol : doubleEol;
+    writeFileSync(filePath, `${text}${sep}${block}${eol}`);
+    return { action: 'appended' };
+}
+//# sourceMappingURL=sections.js.map

package/dist/hosts/sections.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Graft — public API.
+ *
+ * The graph is a folder of linked markdown files (`.context/`) committed to the
+ * repo. Build it from code, then check it stays in sync.
+ *
+ * @example
+ * ```ts
+ * import { Graft } from "@nanonets/graft";
+ *
+ * const engine = new Graft();
+ * await engine.init(".");             // writes .context/*.md + manifest.json
+ *
+ * const result = engine.check(".");   // { ok: boolean, ...drift }
+ * if (!result.ok) process.exitCode = 1;
+ * ```
+ */
+export { Graft, CODE_EXTENSIONS } from "./engine.js";
+export type { InitOptions, CheckRunOptions, BuildResult, BuildProgress, CheckResult } from "./engine.js";
+export { buildContext } from "./context/build.js";
+export type { BuildOptions } from "./context/build.js";
+export { checkContext, formatCheckReport } from "./context/check.js";
+export type { CheckOptions } from "./context/check.js";
+export { checkGraph, formatGraphCheckReport } from "./graph/check.js";
+export type { GraphCheckResult, GraphCheckOptions } from "./graph/check.js";
+export type { ContextNode, NodeLink, SourceRef, Manifest } from "./context/node-file.js";
+export type { EngineConfig, ResolvedConfig } from "./ai/providers.js";
+export { resolveConfig, DEFAULTS, DEFAULT_MODELS } from "./ai/providers.js";
+export type { ChatModel, ChatRequest, ChatResponse, Message, ToolSpec, ToolCall, Usage } from "./ai/llm/types.js";
+export { createChatModel, type ProviderKind, type ChatModelConfig } from "./ai/llm/factory.js";
+export { OpenAIChatModel } from "./ai/llm/openai.js";
+export { AnthropicChatModel } from "./ai/llm/anthropic.js";
+export { LiteLLMChatModel, listLiteLLMModels, DEFAULT_LITELLM_BASE_URL } from "./ai/llm/litellm.js";
+export { OrcaRouterChatModel, listOrcaRouterModels, DEFAULT_ORCAROUTER_BASE_URL } from "./ai/llm/orcarouter.js";
+export { ChatSynthesizer } from "./ai/synthesize.js";
+export type { Synthesizer, SynthNode, SynthLink, FileSummary } from "./ai/synthesize.js";
+export { ChatSummarizer } from "./ai/summarize.js";
+export type { Summarizer } from "./ai/summarize.js";
+export { ChatCruxSummarizer } from "./ai/crux.js";
+export type { CruxSummarizer, FileCruxInput, NodeCrux, NodeRef } from "./ai/crux.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AACH,OAAO,EAAE,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AACrD,YAAY,EAAE,WAAW,EAAE,eAAe,EAAE,WAAW,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAEzG,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,YAAY,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AACvD,OAAO,EAAE,YAAY,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AACrE,YAAY,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AACvD,OAAO,EAAE,UAAU,EAAE,sBAAsB,EAAE,MAAM,kBAAkB,CAAC;AACtE,YAAY,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAC5E,YAAY,EAAE,WAAW,EAAE,QAAQ,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AAEzF,YAAY,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACtE,OAAO,EAAE,aAAa,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAG5E,YAAY,EAAE,SAAS,EAAE,WAAW,EAAE,YAAY,EAAE,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAClH,OAAO,EAAE,eAAe,EAAE,KAAK,YAAY,EAAE,KAAK,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAC/F,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAC3D,OAAO,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,wBAAwB,EAAE,MAAM,qBAAqB,CAAC;AACpG,OAAO,EAAE,mBAAmB,EAAE,oBAAoB,EAAE,2BAA2B,EAAE,MAAM,wBAAwB,CAAC;AAGhH,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AACrD,YAAY,EAAE,WAAW,EAAE,SAAS,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACzF,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACnD,YAAY,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAClD,YAAY,EAAE,cAAc,EAAE,aAAa,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC"}

package/dist/index.js

@@ -0,0 +1,32 @@
+/**
+ * Graft — public API.
+ *
+ * The graph is a folder of linked markdown files (`.context/`) committed to the
+ * repo. Build it from code, then check it stays in sync.
+ *
+ * @example
+ * ```ts
+ * import { Graft } from "@nanonets/graft";
+ *
+ * const engine = new Graft();
+ * await engine.init(".");             // writes .context/*.md + manifest.json
+ *
+ * const result = engine.check(".");   // { ok: boolean, ...drift }
+ * if (!result.ok) process.exitCode = 1;
+ * ```
+ */
+export { Graft, CODE_EXTENSIONS } from "./engine.js";
+export { buildContext } from "./context/build.js";
+export { checkContext, formatCheckReport } from "./context/check.js";
+export { checkGraph, formatGraphCheckReport } from "./graph/check.js";
+export { resolveConfig, DEFAULTS, DEFAULT_MODELS } from "./ai/providers.js";
+export { createChatModel } from "./ai/llm/factory.js";
+export { OpenAIChatModel } from "./ai/llm/openai.js";
+export { AnthropicChatModel } from "./ai/llm/anthropic.js";
+export { LiteLLMChatModel, listLiteLLMModels, DEFAULT_LITELLM_BASE_URL } from "./ai/llm/litellm.js";
+export { OrcaRouterChatModel, listOrcaRouterModels, DEFAULT_ORCAROUTER_BASE_URL } from "./ai/llm/orcarouter.js";
+// Engine ops, for advanced/custom setups.
+export { ChatSynthesizer } from "./ai/synthesize.js";
+export { ChatSummarizer } from "./ai/summarize.js";
+export { ChatCruxSummarizer } from "./ai/crux.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AACH,OAAO,EAAE,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAGrD,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAElD,OAAO,EAAE,YAAY,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAErE,OAAO,EAAE,UAAU,EAAE,sBAAsB,EAAE,MAAM,kBAAkB,CAAC;AAKtE,OAAO,EAAE,aAAa,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAI5E,OAAO,EAAE,eAAe,EAA2C,MAAM,qBAAqB,CAAC;AAC/F,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAC3D,OAAO,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,wBAAwB,EAAE,MAAM,qBAAqB,CAAC;AACpG,OAAO,EAAE,mBAAmB,EAAE,oBAAoB,EAAE,2BAA2B,EAAE,MAAM,wBAAwB,CAAC;AAEhH,0CAA0C;AAC1C,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAErD,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAEnD,OAAO,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC"}

package/dist/ingest/fs.d.ts

@@ -0,0 +1,79 @@
+/** Directories that are dependency/build output, never source. */
+export declare const SKIP_DIRS: Set<string>;
+/** Files above this size are generated/vendored in practice, not hand-written code. */
+export declare const MAX_FILE_BYTES = 1000000;
+/**
+ * Whether a directory named `name` should be skipped when walking a repo tree:
+ * any dot-prefixed directory (`.git`, `.github`, `.vscode`, ...) or one of
+ * {@link SKIP_DIRS} not named in `includes`. The single source of truth for
+ * "is this dir source" — `skippedPath` and `walkFilesystem` below and the
+ * git-child discovery in `graph/scopes.ts` share it, so they can never
+ * independently drift on what counts as skippable.
+ *
+ * `includes` is the explicit, per-repo `graft build --include-dir` override
+ * (persisted via `util/state.ts`'s `readIncludeDirs`, threaded in by each
+ * caller) — a name in it is removed from the effective skip set for THIS
+ * repo's walks. Absent/empty ≡ today's default behavior. It lifts only
+ * graft's own skip list: in a Git repo, Git's ignore rules stay authoritative
+ * (see {@link walkDir}).
+ *
+ * KNOWN LIMITATION: a dot-directory is skipped WHOLESALE and is NEVER
+ * overridable, even via `includes` — unlike `SKIP_DIRS`, there is no path to
+ * un-skip one. A repo that keeps real, hand-written source under a
+ * dot-prefixed directory is out of scope.
+ */
+export declare function shouldSkipDir(name: string, includes?: ReadonlySet<string>): boolean;
+/**
+ * Recursively list all files under a directory. Skips dot-directories,
+ * dependency/build directories (node_modules, dist, …) not named in
+ * `includes`, and files over 1 MB.
+ * In a Git worktree, tracked files plus untracked, non-ignored files come from
+ * `git ls-files`; this gives indexing exactly Git's nested `.gitignore`,
+ * negation, and global-exclude semantics. Non-Git directories retain the plain
+ * filesystem walk. `includes` lifts only the built-in skip list — it never
+ * overrides Git's ignore rules (un-ignore or `git add -f` a directory to
+ * index it, the same contract as tracked-but-ignored files).
+ *
+ * Two INDEPENDENT opt-ins cross the repository boundary, because Git models two
+ * different relationships and only one of them is a dependency the parent pins:
+ *
+ *   - `followSubmodules` follows a GITLINK — an index entry with mode `160000`,
+ *     a commit the superproject versions.
+ *   - `followNestedRepos` follows a nested clone the parent's index knows
+ *     nothing about. Manifest-driven multi-repo tools (west, repo, gclient,
+ *     tsrc, mr, …) all check dependencies out this way, and so does anyone who
+ *     clones an upstream into the tree to patch it locally.
+ *
+ * Both default to false, preserving the historical superproject boundary. Each
+ * child keeps its own ignore rules; uninitialized submodules and gitignored
+ * nested clones remain absent either way (`--exclude-standard` never emits
+ * them, so there is nothing to follow).
+ */
+export interface WalkOptions {
+    /** Include initialized Git submodules (gitlinks) recursively. Default false. */
+    followSubmodules?: boolean;
+    /** Include nested Git clones the parent index does not track. Default false. */
+    followNestedRepos?: boolean;
+}
+/**
+ * Directory `walkDir` actually enumerates.
+ *
+ * `path.resolve` does not follow a symlink, and git discovers the repo from the
+ * child cwd. Unwrap a symlink-to-directory once so the walk runs inside the
+ * target. Ordinary directories stay as `resolve(dir)` — not `realpath` — so a
+ * macOS `/var/folders/…` scratch path is the path the caller handed us.
+ *
+ * A broken symlink throws instead of the `scandir ENOENT` `readdirSync` would
+ * raise after git fails. Internal symlink policy is not decided here.
+ */
+export declare function canonicalWalkRoot(dir: string): string;
+/**
+ * Recursively list source files under `dir`. A directory symlink as the *input
+ * root* is unwrapped once ({@link canonicalWalkRoot}); emitted paths are remapped
+ * onto the caller-facing root so `relPosix` stays `src/foo.ts` rather than a
+ * `../` escape through the physical path (macOS `/tmp` → `/private/tmp`).
+ * Symlinks *inside* the tree are not followed: git still `lstat`s each listed
+ * path, and the filesystem walk still requires `Dirent.isFile` / `isDirectory`.
+ */
+export declare function walkDir(dir: string, includes?: ReadonlySet<string>, opts?: WalkOptions): string[];
+//# sourceMappingURL=fs.d.ts.map

package/dist/ingest/fs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fs.d.ts","sourceRoot":"","sources":["../../src/ingest/fs.ts"],"names":[],"mappings":"AAQA,kEAAkE;AAClE,eAAO,MAAM,SAAS,aAgBpB,CAAC;AAEH,uFAAuF;AACvF,eAAO,MAAM,cAAc,UAAY,CAAC;AAExC;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,WAAW,CAAC,MAAM,CAAC,GAAG,OAAO,CAInF;AAED;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,MAAM,WAAW,WAAW;IAC1B,gFAAgF;IAChF,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,gFAAgF;IAChF,iBAAiB,CAAC,EAAE,OAAO,CAAC;CAC7B;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CA0BrD;AAoBD;;;;;;;GAOG;AACH,wBAAgB,OAAO,CACrB,GAAG,EAAE,MAAM,EACX,QAAQ,CAAC,EAAE,WAAW,CAAC,MAAM,CAAC,EAC9B,IAAI,GAAE,WAAgB,GACrB,MAAM,EAAE,CAKV"}

package/dist/ingest/fs.js

@@ -0,0 +1,306 @@
+/**
+ * Filesystem walking used by `init`/`check` to enumerate a repo's source files.
+ */
+import { WINHIDE } from "../util/child-process.js";
+import { spawnSync } from "node:child_process";
+import { existsSync, lstatSync, readdirSync, realpathSync, statSync } from "node:fs";
+import { isAbsolute, join, relative, resolve, sep } from "node:path";
+/** Directories that are dependency/build output, never source. */
+export const SKIP_DIRS = new Set([
+    "node_modules",
+    "dist",
+    "build",
+    // The underscore spelling that Sphinx, CMake, Jekyll and the OCaml tools all
+    // emit. Left out, a materialized build tree lands in the graph as ordinary
+    // source: one repo here indexed 4,484 files of vendored WordPress against 121
+    // hand-written ones, and queries slowed enough that the prompt hook's budget
+    // could no longer fit them. `--include-dir _build` remains the way back in.
+    "_build",
+    "out",
+    "target",
+    "vendor",
+    "coverage",
+    "__pycache__",
+    "venv",
+]);
+/** Files above this size are generated/vendored in practice, not hand-written code. */
+export const MAX_FILE_BYTES = 1_000_000;
+/**
+ * Whether a directory named `name` should be skipped when walking a repo tree:
+ * any dot-prefixed directory (`.git`, `.github`, `.vscode`, ...) or one of
+ * {@link SKIP_DIRS} not named in `includes`. The single source of truth for
+ * "is this dir source" — `skippedPath` and `walkFilesystem` below and the
+ * git-child discovery in `graph/scopes.ts` share it, so they can never
+ * independently drift on what counts as skippable.
+ *
+ * `includes` is the explicit, per-repo `graft build --include-dir` override
+ * (persisted via `util/state.ts`'s `readIncludeDirs`, threaded in by each
+ * caller) — a name in it is removed from the effective skip set for THIS
+ * repo's walks. Absent/empty ≡ today's default behavior. It lifts only
+ * graft's own skip list: in a Git repo, Git's ignore rules stay authoritative
+ * (see {@link walkDir}).
+ *
+ * KNOWN LIMITATION: a dot-directory is skipped WHOLESALE and is NEVER
+ * overridable, even via `includes` — unlike `SKIP_DIRS`, there is no path to
+ * un-skip one. A repo that keeps real, hand-written source under a
+ * dot-prefixed directory is out of scope.
+ */
+export function shouldSkipDir(name, includes) {
+    if (name.startsWith("."))
+        return true;
+    if (includes?.has(name))
+        return false;
+    return SKIP_DIRS.has(name);
+}
+/**
+ * Directory `walkDir` actually enumerates.
+ *
+ * `path.resolve` does not follow a symlink, and git discovers the repo from the
+ * child cwd. Unwrap a symlink-to-directory once so the walk runs inside the
+ * target. Ordinary directories stay as `resolve(dir)` — not `realpath` — so a
+ * macOS `/var/folders/…` scratch path is the path the caller handed us.
+ *
+ * A broken symlink throws instead of the `scandir ENOENT` `readdirSync` would
+ * raise after git fails. Internal symlink policy is not decided here.
+ */
+export function canonicalWalkRoot(dir) {
+    const abs = resolve(dir);
+    let st;
+    try {
+        st = lstatSync(abs);
+    }
+    catch {
+        return abs;
+    }
+    if (!st.isSymbolicLink())
+        return abs;
+    let real;
+    try {
+        real = realpathSync(abs);
+    }
+    catch (err) {
+        const code = err && typeof err === "object" && "code" in err ? String(err.code) : "";
+        if (code === "ELOOP")
+            throw new Error(`symbolic link loop: ${abs}`);
+        throw new Error(`broken symbolic link: ${abs}`);
+    }
+    let realSt;
+    try {
+        realSt = statSync(real);
+    }
+    catch {
+        throw new Error(`broken symbolic link: ${abs}`);
+    }
+    if (!realSt.isDirectory())
+        return abs;
+    return real;
+}
+function escapedCanonical(canonical, abs) {
+    const rel = relative(canonical, abs);
+    return rel === ".." || rel.startsWith(`..${sep}`) || isAbsolute(rel);
+}
+/** Keep emitted paths on the requested root so relative paths stay stable. */
+function remapWalkPaths(requested, canonical, files) {
+    if (requested === canonical)
+        return files;
+    const out = [];
+    for (const abs of files) {
+        if (escapedCanonical(canonical, abs))
+            continue;
+        const rel = relative(canonical, abs);
+        if (rel === "")
+            continue;
+        out.push(join(requested, rel));
+    }
+    return out;
+}
+/**
+ * Recursively list source files under `dir`. A directory symlink as the *input
+ * root* is unwrapped once ({@link canonicalWalkRoot}); emitted paths are remapped
+ * onto the caller-facing root so `relPosix` stays `src/foo.ts` rather than a
+ * `../` escape through the physical path (macOS `/tmp` → `/private/tmp`).
+ * Symlinks *inside* the tree are not followed: git still `lstat`s each listed
+ * path, and the filesystem walk still requires `Dirent.isFile` / `isDirectory`.
+ */
+export function walkDir(dir, includes, opts = {}) {
+    const requested = resolve(dir);
+    const root = canonicalWalkRoot(requested);
+    const files = gitVisibleFiles(root, includes, opts) ?? walkFilesystem(root, includes);
+    return remapWalkPaths(requested, root, files);
+}
+/** Git's canonical working-tree file set, relative to `dir`. Tracked files are
+ * deliberately included even when a later ignore rule matches them; `.gitignore`
+ * only controls untracked files in Git, and graft follows the same contract. */
+function gitVisibleFiles(dir, includes, opts = {}, traversal) {
+    const root = resolve(dir);
+    // The recursive path costs an extra `-t --stage` classification, so take it
+    // only when at least one boundary-crossing opt-in is on. With both off the
+    // walk is byte-for-byte the historical one.
+    if (opts.followSubmodules !== true && opts.followNestedRepos !== true) {
+        return gitVisibleFilesShallow(root, includes);
+    }
+    const state = traversal ?? { topRoot: root, activeRoots: new Set() };
+    const rootKey = process.platform === "win32" ? root.toLowerCase() : root;
+    if (state.activeRoots.has(rootKey))
+        return [];
+    state.activeRoots.add(rootKey);
+    // Following uses `-t --stage` so one process can distinguish gitlinks from
+    // tracked and untracked files. `-z` keeps either form safe for unusual paths.
+    const result = spawnSync("git", ["ls-files", "-t", "--stage", "--cached", "--others", "--exclude-standard", "-z", "--"], { ...WINHIDE, cwd: root,
+        encoding: "utf8",
+        stdio: ["ignore", "pipe", "ignore"],
+        maxBuffer: 64 * 1024 * 1024,
+    });
+    if (result.status !== 0 || result.error || typeof result.stdout !== "string") {
+        state.activeRoots.delete(rootKey);
+        return null;
+    }
+    // A path can have multiple stage records during a merge. Collapse those
+    // records and remember if any of them identifies the path as a gitlink or as
+    // a nested-clone boundary.
+    const entries = new Map();
+    for (const record of result.stdout.split("\0")) {
+        if (!record)
+            continue;
+        if (record.length < 2 || record[1] !== " ")
+            continue;
+        const tag = record[0];
+        const body = record.slice(2);
+        let rel;
+        let gitlink = false;
+        let nested = false;
+        if (tag === "?") {
+            rel = body;
+            // Git refuses to descend into a repository it does not own, so `--others`
+            // collapses a nested clone to ONE trailing-slash directory entry while
+            // every other untracked directory is expanded file by file. That slash is
+            // the boundary marker — free, since this is the enumeration we already ran.
+            if (rel.endsWith("/")) {
+                nested = true;
+                rel = rel.slice(0, -1);
+            }
+        }
+        else {
+            const tab = body.indexOf("\t");
+            if (tab === -1)
+                continue;
+            gitlink = body.startsWith("160000 ");
+            rel = body.slice(tab + 1);
+        }
+        if (!rel)
+            continue;
+        const prior = entries.get(rel);
+        entries.set(rel, {
+            gitlink: gitlink || prior?.gitlink === true,
+            nested: nested || prior?.nested === true,
+        });
+    }
+    const out = new Set();
+    for (const [rel, entry] of entries) {
+        const abs = resolve(root, rel);
+        // Filter against the original superproject path. Otherwise a submodule
+        // mounted at vendor/ or build/ would bypass the parent's skip policy when
+        // recursion resets its relative root.
+        if (skippedPath(relative(state.topRoot, abs), includes))
+            continue;
+        const followChild = (entry.gitlink && opts.followSubmodules === true) ||
+            (entry.nested && opts.followNestedRepos === true);
+        if (followChild) {
+            // A deinitialized gitlink can resolve upward to the superproject when Git
+            // runs inside it, and a nested-looking directory may have no repo at all.
+            // Requiring the child's own .git prevents duplicate, mis-prefixed parent
+            // files and recursive loops.
+            if (!existsSync(join(abs, ".git")))
+                continue;
+            let childFiles = gitVisibleFiles(abs, includes, opts, state);
+            if (childFiles === null) {
+                // Do not let one broken child recreate a "healthy but incomplete"
+                // graph. Match the top-level fail-soft contract locally: fall back to
+                // the filesystem for this child only, preserving the parent repo's Git
+                // visibility and every built-in skip/size guard. Child Git ignore rules
+                // are unavailable in this exceptional path, just as they are when the
+                // top-level Git command fails and walkDir uses its filesystem fallback.
+                // Let an unreadable filesystem fallback surface rather than claiming a
+                // healthy graph that silently omitted the child again.
+                childFiles = walkFilesystem(abs, includes);
+            }
+            for (const file of childFiles)
+                out.add(file);
+            continue;
+        }
+        try {
+            const stat = lstatSync(abs);
+            if (!stat.isFile() || stat.size > MAX_FILE_BYTES)
+                continue;
+        }
+        catch {
+            // A tracked file deleted from the working tree is still printed by
+            // `--cached`; absence means it is not part of the current source set.
+            continue;
+        }
+        out.add(abs);
+    }
+    state.activeRoots.delete(rootKey);
+    return [...out].sort();
+}
+/** The historical, non-recursive Git path. Kept separate so the default does
+ * exactly the same command, filtering, ordering, and duplicate handling as it
+ * did before submodule support existed. */
+function gitVisibleFilesShallow(root, includes) {
+    const result = spawnSync("git", ["ls-files", "--cached", "--others", "--exclude-standard", "-z", "--"], { ...WINHIDE, cwd: root,
+        encoding: "utf8",
+        stdio: ["ignore", "pipe", "ignore"],
+        maxBuffer: 64 * 1024 * 1024,
+    });
+    if (result.status !== 0 || result.error || typeof result.stdout !== "string")
+        return null;
+    const out = [];
+    for (const rel of result.stdout.split("\0")) {
+        if (!rel || skippedPath(rel, includes))
+            continue;
+        const abs = resolve(root, rel);
+        try {
+            const stat = lstatSync(abs);
+            if (!stat.isFile() || stat.size > MAX_FILE_BYTES)
+                continue;
+        }
+        catch {
+            // A tracked file deleted from the working tree is still printed by
+            // `--cached`; absence means it is not part of the current source set.
+            continue;
+        }
+        out.push(abs);
+    }
+    return out;
+}
+/** A path (git-relative, either separator) is skipped when any of its
+ * segments is a skippable directory name — the final segment doubles as the
+ * dot-FILE check (`.eslintrc.js` and friends are not source either). */
+function skippedPath(path, includes) {
+    return path.replace(/\\/g, "/").split("/").some((segment) => shouldSkipDir(segment, includes));
+}
+function walkFilesystem(dir, includes) {
+    const out = [];
+    for (const entry of readdirSync(dir, { withFileTypes: true })) {
+        const full = join(dir, entry.name);
+        if (entry.isDirectory()) {
+            if (shouldSkipDir(entry.name, includes))
+                continue;
+            out.push(...walkFilesystem(full, includes));
+        }
+        else if (entry.isFile()) {
+            if (entry.name.startsWith("."))
+                continue; // dot-files are not source either
+            try {
+                if (statSync(full).size > MAX_FILE_BYTES)
+                    continue;
+            }
+            catch {
+                continue;
+            }
+            out.push(full);
+        }
+    }
+    return out;
+}
+//# sourceMappingURL=fs.js.map

package/dist/ingest/fs.js.map

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

package/dist/init-guard.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Why `trail init` won't set up `dir`, or null when it will. Only the home
+ * folder is refused: run there, init wired it, mapped every code file under it
+ * and said to commit, though nobody shares learnings for a whole home folder.
+ */
+export declare function homeFolderRefusal(dir: string, home?: string): string | null;
+/** Whether `dir` is inside a git work tree, so there is something to commit learnings to. */
+export declare function isGitWorkTree(dir: string): boolean;
+/**
+ * `init --pair` outside git: Trail's page shares a repo with the team, and a
+ * folder with none would be set up with nothing to share, so it is refused.
+ */
+export declare const NOT_GIT_PAIR_REFUSAL = "\u2717 this folder isn't a git repo.\n  Open your agent inside the repo you want Trail to learn, then run the setup prompt again.";
+/** Said instead of the commit line when init ran outside git: there is nothing to commit to. */
+export declare const NOT_GIT_LINE = "\u00B7 this folder isn't a git repo, so its learnings stay on this machine. Run trail init inside a repo to share them with your team";
+//# sourceMappingURL=init-guard.d.ts.map

package/dist/init-guard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"init-guard.d.ts","sourceRoot":"","sources":["../src/init-guard.ts"],"names":[],"mappings":"AAKA;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,GAAE,MAAkB,GAAG,MAAM,GAAG,IAAI,CAGtF;AAED,6FAA6F;AAC7F,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAGlD;AAED;;;GAGG;AACH,eAAO,MAAM,oBAAoB,sIAC+F,CAAC;AAEjI,gGAAgG;AAChG,eAAO,MAAM,YAAY,0IAC2G,CAAC"}