@nanonets/graft 0.19.0 → 0.21.0

package/dist/brain/claude-md.js

@@ -0,0 +1,171 @@
+/**
+ * The CLAUDE.md half of `graft trail pull` (and of `graft claude-md pull`, its
+ * old name): write the CLAUDE.md changes accepted in Trail into this checkout's
+ * instruction file.
+ *
+ * Trail compares the repository's CLAUDE.md with what its history says and
+ * suggests edits and new sections; a person accepts some of them on the brain's
+ * CLAUDE.md page. This fetches the accepted ones, applies them to the local
+ * file, and tells Trail which it wrote so the page stops listing them.
+ *
+ * The file is edited line by line, never regenerated, so everything a change
+ * does not touch comes back byte for byte. An edit whose text is no longer in
+ * its section means the local file has moved on since Trail read it; that
+ * change is reported and left, never guessed at. Same rules as Trail's own
+ * ComposeClaudeMd, which is what the page's preview shows.
+ */
+import { baseUrlFor } from "./link.js";
+/** GET /api/public/brains/:id/claude-md — the accepted changes. */
+export async function fetchAcceptedChanges(link, fetchImpl = fetch) {
+    const url = `${baseUrlFor(link)}/api/public/brains/${encodeURIComponent(link.brainId)}/claude-md`;
+    try {
+        const res = await fetchImpl(url, {
+            headers: { authorization: `Bearer ${link.token}`, accept: "application/json" },
+            signal: AbortSignal.timeout(15_000),
+        });
+        const body = await res.text();
+        if (res.status === 404 || res.status === 503) {
+            return { error: "this trail has no CLAUDE.md suggestions yet — its Trail may be older than the feature", unsupported: true };
+        }
+        if (!res.ok)
+            return { error: `Trail refused the pull: ${res.status} ${body.slice(0, 200)}` };
+        const parsed = JSON.parse(body);
+        return { path: parsed.path ?? "", head_sha: parsed.head_sha ?? "", changes: parsed.changes ?? [] };
+    }
+    catch (e) {
+        return { error: `could not reach Trail: ${e instanceof Error ? e.message : e}` };
+    }
+}
+/** POST /api/public/brains/:id/claude-md/applied — what this pull wrote. */
+export async function markApplied(link, ids, fetchImpl = fetch) {
+    if (ids.length === 0)
+        return true;
+    const url = `${baseUrlFor(link)}/api/public/brains/${encodeURIComponent(link.brainId)}/claude-md/applied`;
+    try {
+        // Trail takes at most 100 per request.
+        for (let i = 0; i < ids.length; i += 100) {
+            const res = await fetchImpl(url, {
+                method: "POST",
+                headers: {
+                    authorization: `Bearer ${link.token}`,
+                    "content-type": "application/json",
+                    accept: "application/json",
+                },
+                body: JSON.stringify({ ids: ids.slice(i, i + 100) }),
+                signal: AbortSignal.timeout(15_000),
+            });
+            if (!res.ok)
+                return false;
+        }
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+const HEADING = /^(#{1,6})\s+(.+?)\s*#*\s*$/;
+/** Every ATX heading outside code fences, with the lines it owns. */
+function sectionsOf(lines) {
+    const heads = [];
+    let fence = false;
+    lines.forEach((ln, i) => {
+        const t = ln.trim();
+        if (t.startsWith("```") || t.startsWith("~~~")) {
+            fence = !fence;
+            return;
+        }
+        if (fence)
+            return;
+        const m = HEADING.exec(ln);
+        if (m)
+            heads.push({ line: i, level: m[1].length, title: m[2].trim() });
+    });
+    return heads.map((h, i) => {
+        let end = lines.length;
+        for (let j = i + 1; j < heads.length; j++) {
+            if (heads[j].level <= h.level) {
+                end = heads[j].line;
+                break;
+            }
+        }
+        return { title: h.title, level: h.level, head: h.line, end };
+    });
+}
+const norm = (s) => s.trim().toLowerCase();
+/** Trim the blank lines a section ends with, so appended text sits under its content. */
+function lastContentLine(lines, s) {
+    let i = s.end;
+    while (i > s.head + 1 && lines[i - 1].trim() === "")
+        i--;
+    return i;
+}
+/**
+ * Apply accepted changes to the file's text. Pure: reads nothing, writes
+ * nothing, so the command and the tests share it.
+ */
+export function applyChanges(original, changes) {
+    const crlf = original.includes("\r\n");
+    let lines = original.replace(/\r\n/g, "\n").split("\n");
+    const out = { text: original, written: [], present: [], skipped: [] };
+    // Edits first, against headings that exist; then additions, which may go
+    // after a section an edit just touched.
+    const ordered = [...changes.filter((c) => c.kind === "edit"), ...changes.filter((c) => c.kind === "add")];
+    for (const c of ordered) {
+        const sections = sectionsOf(lines);
+        if (c.kind === "edit") {
+            const s = sections.find((x) => norm(x.title) === norm(c.heading));
+            if (!s) {
+                out.skipped.push({ change: c, why: `no “${c.heading}” section in the file` });
+                continue;
+            }
+            const body = lines.slice(s.head + 1, s.end).join("\n");
+            const text = c.text.replace(/\r\n/g, "\n");
+            const find = (c.find ?? "").replace(/\r\n/g, "\n");
+            if (text.trim() && body.includes(text.trim())) {
+                out.present.push(c);
+                continue;
+            }
+            if (!find) {
+                const at = lastContentLine(lines, s);
+                lines = [...lines.slice(0, at), ...text.trimEnd().split("\n"), ...lines.slice(at)];
+                out.written.push(c);
+                continue;
+            }
+            const idx = body.indexOf(find);
+            if (idx < 0) {
+                out.skipped.push({ change: c, why: `the text it rewrites is no longer in “${c.heading}”` });
+                continue;
+            }
+            const next = body.slice(0, idx) + text + body.slice(idx + find.length);
+            lines = [...lines.slice(0, s.head + 1), ...next.split("\n"), ...lines.slice(s.end)];
+            out.written.push(c);
+            continue;
+        }
+        // add
+        if (sections.some((x) => norm(x.title) === norm(c.heading))) {
+            out.present.push(c);
+            continue;
+        }
+        const block = [`## ${c.heading.trim()}`, "", ...c.text.replace(/\r\n/g, "\n").trim().split("\n")];
+        const after = c.after_heading ? sections.find((x) => norm(x.title) === norm(c.after_heading)) : undefined;
+        if (after) {
+            const at = lastContentLine(lines, after);
+            // A blank line either side, whatever the file had there.
+            const tail = lines.slice(at);
+            lines = [...lines.slice(0, at), "", ...block, ...(tail.length > 0 && tail[0].trim() !== "" ? [""] : []), ...tail];
+        }
+        else {
+            while (lines.length > 0 && lines[lines.length - 1].trim() === "")
+                lines.pop();
+            lines = lines.length > 0 ? [...lines, "", ...block] : block;
+            lines.push("");
+        }
+        out.written.push(c);
+    }
+    let text = lines.join("\n");
+    if (out.written.length > 0 && !text.endsWith("\n"))
+        text += "\n";
+    out.text = out.written.length > 0 ? (crlf ? text.replace(/\n/g, "\r\n") : text) : original;
+    return out;
+}
+//# sourceMappingURL=claude-md.js.map

package/dist/brain/claude-md.js.map

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

package/dist/brain/connect.d.ts

@@ -5,7 +5,7 @@
 import { type BrainLink, type BrainRule } from './link.js';
 import { type BrainWrite } from './wire.js';
 /**
- * Parse the `--brain` value.
+ * Parse the `--trail` value.
  *
  * The onboarding page hands over one string so there is one thing to copy. Two
  * accepted shapes:
@@ -33,7 +33,7 @@ export interface ConnectResult {
  *
  * The link is stored even when the pull fails. That is deliberate: a token
  * typed correctly against a brain that is momentarily unreachable should not
- * have to be pasted again — `graft brain pull` retries, and `ask` degrades to
+ * have to be pasted again — `graft trail pull` retries, and `ask` degrades to
  * the code-only answer meanwhile.
  */
 export declare function connectBrain(repo: string, link: BrainLink, opts?: {
@@ -50,7 +50,7 @@ export declare function pullBrain(repo: string, opts: {
     ids?: string[];
     fetchImpl?: typeof fetch;
 }): Promise<ConnectResult | null>;
-/** The linked brain and its cached rule set, for `graft brain status`. */
+/** The linked brain and its cached rule set, for `graft trail status`. */
 export declare function brainStatus(repo: string): {
     link: BrainLink | null;
     rules: BrainRule[];

package/dist/brain/connect.js

@@ -6,7 +6,7 @@ import { readLink, writeLink, fetchRules, writeRulesCache, readRulesCache, } fro
 import { writeBrainSections } from './wire.js';
 import { basename } from 'node:path';
 /**
- * Parse the `--brain` value.
+ * Parse the `--trail` value.
  *
  * The onboarding page hands over one string so there is one thing to copy. Two
  * accepted shapes:
@@ -21,19 +21,19 @@ import { basename } from 'node:path';
 export function parseBrainArg(value) {
     const raw = value.trim();
     if (!raw)
-        return { error: 'empty --brain value' };
+        return { error: 'empty --trail value' };
     const cut = raw.indexOf(':');
     if (cut > 0) {
         const brainId = raw.slice(0, cut).trim();
         const token = raw.slice(cut + 1).trim();
         if (!brainId || !token)
-            return { error: 'expected --brain <brainId>:<token>' };
+            return { error: 'expected --trail <brainId>:<token>' };
         return { brainId, token };
     }
     const envToken = process.env.GRAFT_BRAIN_TOKEN;
     if (!envToken) {
         return {
-            error: 'expected --brain <brainId>:<token>, or a bare brain id with the token in GRAFT_BRAIN_TOKEN',
+            error: 'expected --trail <brainId>:<token>, or a bare brain id with the token in GRAFT_BRAIN_TOKEN',
         };
     }
     return { brainId: raw, token: envToken };
@@ -43,7 +43,7 @@ export function parseBrainArg(value) {
  *
  * The link is stored even when the pull fails. That is deliberate: a token
  * typed correctly against a brain that is momentarily unreachable should not
- * have to be pasted again — `graft brain pull` retries, and `ask` degrades to
+ * have to be pasted again — `graft trail pull` retries, and `ask` degrades to
  * the code-only answer meanwhile.
  */
 export async function connectBrain(repo, link, opts = { home: '' }) {
@@ -54,7 +54,7 @@ export async function connectBrain(repo, link, opts = { home: '' }) {
             linked: true,
             ruleCount: 0,
             writes: [],
-            warning: 'could not reach the brain to pull its rules — the link is saved; run `graft brain pull` to retry',
+            warning: 'could not reach the brain to pull its rules — the link is saved; run `graft trail pull` to retry',
         };
     }
     writeRulesCache(repo, { brainId: link.brainId, fetchedAt: Date.now(), rules });
@@ -71,7 +71,7 @@ export async function pullBrain(repo, opts) {
         return null;
     return connectBrain(repo, link, opts);
 }
-/** The linked brain and its cached rule set, for `graft brain status`. */
+/** The linked brain and its cached rule set, for `graft trail status`. */
 export function brainStatus(repo) {
     const link = readLink(repo);
     const cache = readRulesCache(repo);

package/dist/brain/context-files.d.ts

@@ -0,0 +1,79 @@
+import { type BrainLink } from "./link.js";
+export type ContextFileKind = "agents_md" | "folder_claude_md" | "cursor_rule" | "skill";
+/** One accepted change to one context file. */
+export interface ContextFileChange {
+    id: string;
+    kind: "edit" | "add" | "create" | "replace";
+    heading?: string;
+    after_heading?: string;
+    find?: string;
+    /** edit/add: as in claude-md.ts. create/replace: the whole file. For
+     *  replace, `find` is the whole file the suggestion was computed against. */
+    text: string;
+    reason?: string;
+}
+export interface ContextFile {
+    kind: ContextFileKind | string;
+    path: string;
+    exists?: boolean;
+    managed_by_graft?: boolean;
+    changes: ContextFileChange[];
+}
+export interface ContextFilesPull {
+    head_sha: string;
+    files: ContextFile[];
+}
+/** The kind of a context file, from its path — for the root CLAUDE.md pull,
+ * which names a path but no kind. */
+export declare function kindForPath(path: string): string;
+/**
+ * Whether a file of `kind` is for one of the `wired` agents. Everything passes
+ * when nothing is wired — there is no choice to respect — and so does a kind
+ * graft does not know, rather than dropping what Trail sent.
+ */
+export declare function readByWired(kind: string, wired: readonly string[]): boolean;
+/** The agents among `wired` that read a file of `kind`. */
+export declare function readersOf(kind: string, wired: readonly string[]): string[];
+/** GET /api/public/brains/:id/context-files. `unsupported` on a 404: an older Trail. */
+export declare function fetchContextFiles(link: BrainLink, fetchImpl?: typeof fetch): Promise<ContextFilesPull | {
+    unsupported: true;
+} | {
+    error: string;
+}>;
+/** POST /api/public/brains/:id/context-files/applied, 100 ids per request. */
+export declare function markContextFilesApplied(link: BrainLink, ids: string[], fetchImpl?: typeof fetch): Promise<boolean>;
+/** What a pull will do (or did) to one file. */
+export interface FilePlan {
+    /** Repo-relative, forward slashes. */
+    path: string;
+    /** M: an existing file changes. A: a new file. "": nothing to write. */
+    status: "M" | "A" | "";
+    /** The file's new text, when status is set. */
+    text?: string;
+    written: ContextFileChange[];
+    /** Already there: counts as applied, nothing to write. */
+    present: ContextFileChange[];
+    skipped: Array<{
+        change: ContextFileChange;
+        why: string;
+    }>;
+}
+/**
+ * The repo-relative form of a path Trail sent, or null when it points
+ * anywhere but a file inside this checkout. Trail is trusted to suggest text,
+ * not to choose where on this machine it lands.
+ */
+export declare function safeRelPath(root: string, path: string): string | null;
+/**
+ * Work out one file's changes against what is on disk. Pure but for reading
+ * the file, so the command, the dry run and the tests share it.
+ */
+export declare function planContextFile(root: string, file: ContextFile): FilePlan;
+/** Write a planned file, making its folder when it is new. */
+export declare function writePlannedFile(root: string, plan: FilePlan): void;
+/** `+ Money · ~ Commands` — a new section is +, an edited one ~, a whole file nothing. */
+export declare function changeSummary(changes: Array<{
+    kind: string;
+    heading?: string;
+}>): string;
+//# sourceMappingURL=context-files.d.ts.map

package/dist/brain/context-files.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-files.d.ts","sourceRoot":"","sources":["../../src/brain/context-files.ts"],"names":[],"mappings":"AAkBA,OAAO,EAAc,KAAK,SAAS,EAAE,MAAM,WAAW,CAAC;AAEvD,MAAM,MAAM,eAAe,GAAG,WAAW,GAAG,kBAAkB,GAAG,aAAa,GAAG,OAAO,CAAC;AAEzF,+CAA+C;AAC/C,MAAM,WAAW,iBAAiB;IAChC,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,GAAG,KAAK,GAAG,QAAQ,GAAG,SAAS,CAAC;IAC5C,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd;iFAC6E;IAC7E,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,eAAe,GAAG,MAAM,CAAC;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,OAAO,EAAE,iBAAiB,EAAE,CAAC;CAC9B;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,WAAW,EAAE,CAAC;CACtB;AAeD;qCACqC;AACrC,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAQhD;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,MAAM,EAAE,GAAG,OAAO,CAK3E;AAED,2DAA2D;AAC3D,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,MAAM,EAAE,GAAG,MAAM,EAAE,CAG1E;AAED,wFAAwF;AACxF,wBAAsB,iBAAiB,CACrC,IAAI,EAAE,SAAS,EACf,SAAS,GAAE,OAAO,KAAa,GAC9B,OAAO,CAAC,gBAAgB,GAAG;IAAE,WAAW,EAAE,IAAI,CAAA;CAAE,GAAG;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC,CAqBvE;AAED,8EAA8E;AAC9E,wBAAsB,uBAAuB,CAAC,IAAI,EAAE,SAAS,EAAE,GAAG,EAAE,MAAM,EAAE,EAAE,SAAS,GAAE,OAAO,KAAa,GAAG,OAAO,CAAC,OAAO,CAAC,CAqB/H;AAED,gDAAgD;AAChD,MAAM,WAAW,QAAQ;IACvB,sCAAsC;IACtC,IAAI,EAAE,MAAM,CAAC;IACb,wEAAwE;IACxE,MAAM,EAAE,GAAG,GAAG,GAAG,GAAG,EAAE,CAAC;IACvB,+CAA+C;IAC/C,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,iBAAiB,EAAE,CAAC;IAC7B,0DAA0D;IAC1D,OAAO,EAAE,iBAAiB,EAAE,CAAC;IAC7B,OAAO,EAAE,KAAK,CAAC;QAAE,MAAM,EAAE,iBAAiB,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAC5D;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAUrE;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,WAAW,GAAG,QAAQ,CAuFzE;AAED,8DAA8D;AAC9D,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,GAAG,IAAI,CAKnE;AAED,0FAA0F;AAC1F,wBAAgB,aAAa,CAAC,OAAO,EAAE,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,GAAG,MAAM,CAKxF"}

package/dist/brain/context-files.js

@@ -0,0 +1,245 @@
+/**
+ * `graft trail pull`, for every context file rather than only the root CLAUDE.md.
+ *
+ * Trail suggests changes to the files a repository hands its coding agents —
+ * AGENTS.md, a folder's own CLAUDE.md, Cursor rules, Claude skills — and a
+ * person accepts some of them. This fetches the accepted ones and writes them.
+ *
+ * Edits and new sections go through the same line-by-line patcher as the root
+ * CLAUDE.md (see claude-md.ts), so everything a change does not name comes back
+ * byte for byte. A `create` carries a whole file, and it is never allowed to
+ * overwrite a file someone wrote here: an existing file with other content is a
+ * conflict to report, unless graft itself owns that file. A `replace` (how a
+ * Cursor rule is edited) carries the whole new file and the whole file it was
+ * computed against, and is written only while the file here is still that one.
+ */
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
+import { dirname, isAbsolute, join, normalize, relative, resolve, sep } from "node:path";
+import { applyChanges } from "./claude-md.js";
+import { baseUrlFor } from "./link.js";
+/**
+ * Which picked agents read a file of this kind. A file whose readers were not
+ * picked is neither listed nor written: `graft init` is where someone said which
+ * agents this repo is for, and a pull must not quietly add files for others.
+ */
+const READERS = {
+    claude_md: ["claude"],
+    folder_claude_md: ["claude"],
+    skill: ["claude"],
+    agents_md: ["agents", "hermes", "antigravity"],
+    cursor_rule: ["cursor"],
+};
+/** The kind of a context file, from its path — for the root CLAUDE.md pull,
+ * which names a path but no kind. */
+export function kindForPath(path) {
+    const p = path.replace(/\\/g, "/");
+    const name = p.split("/").pop() ?? "";
+    if (name === "CLAUDE.md")
+        return p.includes("/") ? "folder_claude_md" : "claude_md";
+    if (name === "AGENTS.md")
+        return "agents_md";
+    if (p.startsWith(".cursor/rules/"))
+        return "cursor_rule";
+    if (p.startsWith(".claude/skills/"))
+        return "skill";
+    return "";
+}
+/**
+ * Whether a file of `kind` is for one of the `wired` agents. Everything passes
+ * when nothing is wired — there is no choice to respect — and so does a kind
+ * graft does not know, rather than dropping what Trail sent.
+ */
+export function readByWired(kind, wired) {
+    if (wired.length === 0)
+        return true;
+    const readers = READERS[kind];
+    if (!readers)
+        return true;
+    return readers.some((r) => wired.includes(r));
+}
+/** The agents among `wired` that read a file of `kind`. */
+export function readersOf(kind, wired) {
+    const readers = READERS[kind] ?? [];
+    return wired.filter((w) => readers.includes(w));
+}
+/** GET /api/public/brains/:id/context-files. `unsupported` on a 404: an older Trail. */
+export async function fetchContextFiles(link, fetchImpl = fetch) {
+    const url = `${baseUrlFor(link)}/api/public/brains/${encodeURIComponent(link.brainId)}/context-files`;
+    try {
+        const res = await fetchImpl(url, {
+            headers: { authorization: `Bearer ${link.token}`, accept: "application/json" },
+            signal: AbortSignal.timeout(15_000),
+        });
+        const body = await res.text();
+        if (res.status === 404)
+            return { unsupported: true };
+        if (!res.ok)
+            return { error: `Trail refused the pull: ${res.status} ${body.slice(0, 200)}` };
+        const parsed = JSON.parse(body);
+        const files = Array.isArray(parsed.files) ? parsed.files : [];
+        return {
+            head_sha: String(parsed.head_sha ?? ""),
+            files: files
+                .filter((f) => f && typeof f.path === "string")
+                .map((f) => ({ ...f, changes: Array.isArray(f.changes) ? f.changes : [] })),
+        };
+    }
+    catch (e) {
+        return { error: `could not reach Trail: ${e instanceof Error ? e.message : e}` };
+    }
+}
+/** POST /api/public/brains/:id/context-files/applied, 100 ids per request. */
+export async function markContextFilesApplied(link, ids, fetchImpl = fetch) {
+    if (ids.length === 0)
+        return true;
+    const url = `${baseUrlFor(link)}/api/public/brains/${encodeURIComponent(link.brainId)}/context-files/applied`;
+    try {
+        for (let i = 0; i < ids.length; i += 100) {
+            const res = await fetchImpl(url, {
+                method: "POST",
+                headers: {
+                    authorization: `Bearer ${link.token}`,
+                    "content-type": "application/json",
+                    accept: "application/json",
+                },
+                body: JSON.stringify({ ids: ids.slice(i, i + 100) }),
+                signal: AbortSignal.timeout(15_000),
+            });
+            if (!res.ok)
+                return false;
+        }
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * The repo-relative form of a path Trail sent, or null when it points
+ * anywhere but a file inside this checkout. Trail is trusted to suggest text,
+ * not to choose where on this machine it lands.
+ */
+export function safeRelPath(root, path) {
+    const raw = path.replace(/\\/g, "/").trim();
+    if (!raw || isAbsolute(raw) || /^[a-zA-Z]:/.test(raw))
+        return null;
+    const parts = raw.split("/");
+    if (parts.some((p) => p === ".." || p === ""))
+        return null;
+    if (parts[0] === ".git")
+        return null;
+    const abs = resolve(root, normalize(raw));
+    const rel = relative(resolve(root), abs);
+    if (!rel || rel.startsWith("..") || isAbsolute(rel))
+        return null;
+    return rel.split(sep).join("/");
+}
+/**
+ * Work out one file's changes against what is on disk. Pure but for reading
+ * the file, so the command, the dry run and the tests share it.
+ */
+export function planContextFile(root, file) {
+    const rel = safeRelPath(root, file.path);
+    const plan = { path: rel ?? file.path, status: "", written: [], present: [], skipped: [] };
+    if (!rel) {
+        for (const c of file.changes)
+            plan.skipped.push({ change: c, why: "the path points outside this repo" });
+        return plan;
+    }
+    const abs = join(root, rel);
+    const existed = existsSync(abs);
+    let original = "";
+    if (existed) {
+        try {
+            original = readFileSync(abs, "utf8");
+        }
+        catch {
+            for (const c of file.changes)
+                plan.skipped.push({ change: c, why: "the file here could not be read" });
+            return plan;
+        }
+    }
+    let text = original;
+    let changed = false;
+    // Whole files first; the edits and sections after them may be relative to one.
+    for (const c of file.changes.filter((x) => x.kind === "create")) {
+        const want = c.text.replace(/\r\n/g, "\n");
+        const have = text.replace(/\r\n/g, "\n");
+        if (!existed && !changed) {
+            text = c.text.endsWith("\n") ? c.text : `${c.text}\n`;
+            changed = true;
+            plan.written.push(c);
+        }
+        else if (have.trimEnd() === want.trimEnd()) {
+            plan.present.push(c);
+        }
+        else if (file.managed_by_graft) {
+            text = c.text.endsWith("\n") ? c.text : `${c.text}\n`;
+            changed = true;
+            plan.written.push(c);
+        }
+        else {
+            plan.skipped.push({ change: c, why: "a file with other content is already there" });
+        }
+    }
+    // Whole-file replacements, guarded by the text they were computed against.
+    const same = (a, b) => a.replace(/\r\n/g, "\n").trimEnd() === b.replace(/\r\n/g, "\n").trimEnd();
+    for (const c of file.changes.filter((x) => x.kind === "replace")) {
+        if (same(text, c.text)) {
+            plan.present.push(c);
+        }
+        else if (same(text, c.find ?? "") && (existed || changed || (c.find ?? "").trim() === "")) {
+            text = c.text.endsWith("\n") ? c.text : `${c.text}\n`;
+            changed = true;
+            plan.written.push(c);
+        }
+        else {
+            plan.skipped.push({ change: c, why: "the file changed here since Trail read it" });
+        }
+    }
+    const patches = file.changes.filter((x) => x.kind === "edit" || x.kind === "add");
+    if (patches.length > 0) {
+        // A file that is not here yet is an empty one: an edit to a section of it
+        // becomes that section, so the change lands rather than being skipped for
+        // a heading nobody could have written.
+        const fresh = !existed && !changed;
+        const r = applyChanges(text, patches.map((c) => ({
+            ...c,
+            heading: c.heading ?? "",
+            kind: fresh && c.kind === "edit" ? "add" : c.kind,
+            ...(fresh && c.kind === "edit" ? { after_heading: "" } : {}),
+        })));
+        const byId = new Map(patches.map((c) => [c.id, c]));
+        for (const w of r.written)
+            plan.written.push(byId.get(w.id));
+        for (const p of r.present)
+            plan.present.push(byId.get(p.id));
+        for (const s of r.skipped)
+            plan.skipped.push({ change: byId.get(s.change.id), why: s.why });
+        if (r.written.length > 0) {
+            text = r.text;
+            changed = true;
+        }
+    }
+    if (changed && text !== original) {
+        plan.status = existed ? "M" : "A";
+        plan.text = text;
+    }
+    return plan;
+}
+/** Write a planned file, making its folder when it is new. */
+export function writePlannedFile(root, plan) {
+    if (!plan.status || plan.text === undefined)
+        return;
+    const abs = join(root, plan.path);
+    mkdirSync(dirname(abs), { recursive: true });
+    writeFileSync(abs, plan.text);
+}
+/** `+ Money · ~ Commands` — a new section is +, an edited one ~, a whole file nothing. */
+export function changeSummary(changes) {
+    return changes
+        .filter((c) => c.kind === "add" || c.kind === "edit")
+        .map((c) => `${c.kind === "add" ? "+" : "~"} ${c.heading ?? ""}`.trim())
+        .join(" · ");
+}
+//# sourceMappingURL=context-files.js.map

package/dist/brain/context-files.js.map

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

package/dist/brain/link.d.ts

@@ -54,7 +54,7 @@ export declare function readLink(dir: string): BrainLink | null;
  * token — which is exactly why this is also where it gets ignored. The comment
  * on {@link BrainLink} has claimed `.graft/` was "git-ignored" since the day it
  * was written, and nothing ever made it true: `ensureGitignored` only ever ran
- * for the graph cache. Every repository anyone ran `graft brain connect` in was
+ * for the graph cache. Every repository anyone ran `graft trail connect` in was
  * therefore one `git add -A` away from publishing a credential. */
 export declare function writeLink(dir: string, link: BrainLink): void;
 /** Forget the link for repo `dir`. Leaves the cached rules for `uninstall` to remove. */
@@ -78,6 +78,23 @@ export declare function markRulesChecked(dir: string, now?: number): void;
  * stored value can always be corrected without editing a file.
  */
 export declare function baseUrlFor(link: BrainLink): string;
+/** The API host before there is a link to read one from: signing up. */
+export declare function apiBaseUrl(): string;
+/** A sign-up an agent-run push started and has not collected yet. */
+export interface PendingSignup {
+    /** The state in the link, which is what claims the trail. */
+    state: string;
+    /** The repository the link was for, so a changed remote starts over. */
+    repo: string;
+    createdAt: number;
+}
+/** The sign-up waiting on repo `dir`, or null when there is none or it is too
+ * old to claim, or it was for a different repository. */
+export declare function readPendingSignup(dir: string, repo: string, maxAgeMs: number, now?: number): PendingSignup | null;
+/** Save the sign-up an agent-run push just started. Git-ignored like the link,
+ * because the state claims a read token. */
+export declare function writePendingSignup(dir: string, pending: PendingSignup): void;
+export declare function clearPendingSignup(dir: string): void;
 /**
  * Fetch the brain's symbol-anchored rules.
  *