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

package/dist/blast/viz.js

@@ -0,0 +1,180 @@
+import { isoDay } from "./owners.js";
+import { MAX_EVIDENCE, fileReader, impactedEvidence, reachTerms, seedEvidence, } from "./evidence.js";
+const plural = (n, one, many = `${one}s`) => `${n} ${n === 1 ? one : many}`;
+/** Owners as the page carries them: no scores, since a weight nobody can check is
+ * not evidence — the commit count and the date are what a reader can verify. */
+function nodeOwners(owners) {
+    if (owners === undefined || owners.length === 0)
+        return undefined;
+    return owners.map((o) => ({ name: o.name, handle: o.handle, commits: o.commits, last: isoDay(o.last) }));
+}
+/** Kinds that carry behaviour — what "did a test reach it" is asked of. */
+const BEHAVIOURAL = new Set(["function", "method", "class", "constructor"]);
+/** Node-type names, which double as the viewer's legend labels. */
+const CHANGED = "changed";
+const AFFECTED = "affected";
+/** One sentence about the tests, rather than the two that used to say it twice. */
+function testNote(a) {
+    const signals = {
+        changed: `A test that reaches it changed too — ${a.reached} of ${plural(a.behavioural, "function")} covered.`,
+        stale: `Tests reach it, and this diff left all ${plural(a.testFiles.length, "of them", "of them")} alone.`,
+        none: "No test reaches this code.",
+        na: "No function or class changed here — types, config or comments only.",
+    };
+    return signals[a.tests];
+}
+/** `a`, `a and b`, `a, b and c`, `a, b and 3 more` — never a bare `+N`, which
+ * reads as a version number when it sits next to a symbol name. */
+function list(names) {
+    const shown = names.slice(0, 3);
+    const rest = names.length - shown.length;
+    const tail = rest > 0 ? `${rest} more` : shown.pop();
+    return shown.length === 0 ? String(tail) : `${shown.join(", ")} and ${tail}`;
+}
+/**
+ * What this PR did to an area, in the reviewer's words.
+ *
+ * The old copy counted ("2 files, 3 symbols") and then said the same thing about
+ * tests twice ("no test reaches it. 0 of 2 changed functions have a test that
+ * reaches them"), where `0 of 2` reads like a coverage score. Naming the symbols
+ * is shorter AND the thing a reviewer wanted to know.
+ */
+function changedSummary(a, seeds) {
+    const named = seeds.filter((s) => !s.wholeFile);
+    const behaviour = named.filter((s) => BEHAVIOURAL.has(s.kind)).map((s) => s.name);
+    const rest = named.filter((s) => !BEHAVIOURAL.has(s.kind)).map((s) => s.name);
+    const where = ` in ${plural(a.files.length, "file")}.`;
+    let what;
+    if (behaviour.length > 0) {
+        what = `Edits ${list(behaviour)}`;
+        if (rest.length > 0)
+            what += `, plus ${list(rest)}`;
+    }
+    else if (rest.length > 0) {
+        what = `Edits ${list(rest)}`;
+    }
+    else {
+        // Whole-file seeds only: an added file, or edits outside every symbol.
+        what = `Changes ${plural(a.seeds, "region")} outside any symbol`;
+    }
+    return `${what}${where} ${testNote(a)}`;
+}
+function changedNode(a, seeds, byPath) {
+    const files = new Set(a.files);
+    const mine = seeds.filter((s) => files.has(s.path));
+    const evidence = mine
+        .slice(0, MAX_EVIDENCE)
+        .map((s) => seedEvidence(s, byPath.get(s.path)))
+        .filter((e) => e !== null);
+    return {
+        id: `changed:${a.key}`,
+        name: a.label,
+        type: CHANGED,
+        summary: changedSummary(a, mine),
+        sources: a.files,
+        evidence: evidence.length > 0 ? evidence : undefined,
+        owners: nodeOwners(a.owners),
+    };
+}
+function affectedNode(m, reach, read) {
+    const nearest = m.symbols[0];
+    const how = nearest ? ` — nearest is ${nearest.name}, ${plural(nearest.depth, "hop")} away.` : ".";
+    const evidence = m.symbols
+        .slice(0, MAX_EVIDENCE)
+        .map((s) => impactedEvidence(s, reach, read))
+        .filter((e) => e !== null);
+    return {
+        id: `affected:${m.key}`,
+        name: m.label,
+        type: AFFECTED,
+        // Leading with "not edited" is the fact a reviewer needs first: this area is
+        // collateral, not part of their diff.
+        summary: `Not edited by this PR. ${plural(m.symbols.length, "symbol")} here ${m.symbols.length === 1 ? "reaches" : "reach"} code it changed${how}`,
+        sources: m.symbols.map((s) => `${s.path} · ${s.span}`),
+        evidence: evidence.length > 0 ? evidence : undefined,
+        owners: nodeOwners(m.owners),
+    };
+}
+/**
+ * What an empty canvas means.
+ *
+ * A PR that only touches lockfiles, workflows or docs has no radius, and the page
+ * published for it used to be a blank canvas behind a link promising a graph — a
+ * reader cannot tell that from a broken export. Naming the reason (usually: no
+ * parser claims these files) turns it into an answer.
+ */
+function emptyNote(r) {
+    if (r.changed.length === 0)
+        return "This pull request changes no files.";
+    if (r.unindexed.length === r.changed.length) {
+        const shown = r.unindexed.slice(0, 3).join(", ");
+        const rest = r.unindexed.length > 3 ? `, +${r.unindexed.length - 3} more` : "";
+        return `Nothing to draw: no parser claims ${plural(r.unindexed.length, "changed file")} (${shown}${rest}), so this change has no symbols to trace.`;
+    }
+    return "Nothing to draw: the changed symbols have no resolved dependents at this depth.";
+}
+/**
+ * Build the viewer graph for a report.
+ *
+ * `root` is the repository the report was taken in; without it the affected side
+ * loses its snippets — there is nothing to read — but keeps everything else, which
+ * is what a unit test wants.
+ *
+ * Nothing is capped at the graph level. The caps in the markdown renderer exist
+ * because a Mermaid diagram inside a comment cannot lay out more than a handful of
+ * circles; this page is force-directed and pannable, which is why it exists.
+ */
+export function blastVizGraph(r, opts = {}) {
+    const byPath = new Map(r.changed.map((f) => [f.path, f]));
+    // Longest name first, so `export` cannot match ahead of `exportViz` on a line
+    // that contains both.
+    const reach = reachTerms(r.seeds, r.changed);
+    const read = fileReader(opts.root);
+    const nodes = [
+        ...r.areas.map((a) => changedNode(a, r.seeds, byPath)),
+        ...r.modules.map((m) => affectedNode(m, reach, read)),
+    ];
+    /** Changed path → the id of the area node standing for it. */
+    const areaOf = new Map();
+    for (const a of r.areas)
+        for (const f of a.files)
+            areaOf.set(f, `changed:${a.key}`);
+    const edges = [];
+    const seen = new Set();
+    for (const m of r.modules) {
+        for (const from of m.from) {
+            const source = areaOf.get(from);
+            if (!source)
+                continue; // a changed test file: the signal, not an area
+            const affected = `affected:${m.key}`;
+            const key = `${affected}→${source}`;
+            if (seen.has(key))
+                continue;
+            seen.add(key);
+            // Edge direction is the DEPENDENCY, affected → changed, not the impact. The
+            // viewer words its panels "depends on" / "depended on by" from the edge, so
+            // pointing it the other way made an affected area read as the thing being
+            // depended upon — backwards, on the one screen a reviewer is reading closely.
+            edges.push({
+                source: affected,
+                target: source,
+                relation: "depends_on",
+                description: "this area calls or imports code the PR changed",
+            });
+        }
+    }
+    return {
+        meta: {
+            nodeCount: nodes.length,
+            edgeCount: edges.length,
+            emptyNote: nodes.length === 0 ? emptyNote(r) : undefined,
+            // Changed files no parser claims: named here so a thin graph is explained
+            // rather than read as "this PR is safe".
+            skippedFiles: r.unindexed.length,
+            droppedEdges: 0,
+        },
+        nodes,
+        edges,
+    };
+}
+//# sourceMappingURL=viz.js.map

package/dist/blast/viz.js.map

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

package/dist/brand.d.ts

@@ -0,0 +1,111 @@
+export type Brand = "trail" | "graft";
+/** Set by `dist/bin/trail.js` and `dist/bin/graft.js` before the CLI loads. */
+export declare const BRAND_ENV = "TRAIL_INVOKED_AS";
+/** The npm package each name is published as. Same code, two names. */
+export declare const PACKAGE_FOR: Record<Brand, string>;
+export declare function brand(env?: NodeJS.ProcessEnv): Brand;
+export declare function setBrand(b: Brand, env?: NodeJS.ProcessEnv): void;
+/**
+ * `init --pair CODE` is Trail's setup prompt: only Trail's page hands out a pair
+ * code, so the person asked for Trail, whatever name ran it. An agent whose
+ * install of `trail-code` failed swaps in the `graft` already on the
+ * machine, and an old shim loads dist/cli.js with no name; under graft either
+ * would skip the look-back and `.trail/` while the page waits for them.
+ */
+export declare function asksForTrail(argv: readonly string[]): boolean;
+/** `[trail]` or `[graft]`: the prefix agents and the statusline look for. */
+export declare function tag(env?: NodeJS.ProcessEnv): string;
+/**
+ * A command as the running name spells it. Takes the graft spelling, so call
+ * sites read the way they always have and graft's output does not change:
+ * `cmd("graft ask")` is `graft ask` under graft and `trail ask` under trail.
+ */
+export declare function cmd(graftSpelling: string, b?: Brand): string;
+/**
+ * Agent-facing prose and tool names in trail's spelling: `graft_find_code` →
+ * `trail_find_code`, and the word graft → trail. A `graft` followed by `/` is
+ * the code map's folder and stays, as do `graft-…` names. Under graft, the
+ * text comes back unchanged.
+ */
+export declare function inBrand(text: string, b?: Brand): string;
+/**
+ * `trail init` wired this repo: its `.trail/` gitignore is the marker it writes
+ * before anything else, and older wirings left a shim, a skill or a settings
+ * block that names trail. Read from the repo, not the machine, so every
+ * teammate's agent speaks the same name whichever command they installed.
+ *
+ * `.trail/.gitignore` is what current `trail init` actually leaves behind (the
+ * hook shim and the Claude settings it used to write are gone), and the map's
+ * location depends on this answer: a repo it does not recognise builds into
+ * `graft/` while its own AGENTS.md says `.trail/cache/`.
+ */
+export declare function repoWiredForTrail(dir: string): boolean;
+/**
+ * The name hooks and the statusline speak in `repo`. They run under whatever
+ * shim set the repo up, often one an older graft committed, so no `dist/bin`
+ * entry has set a name. They say trail in a repo wired for it, but only when
+ * the `trail` command is installed on this machine: a hook that tells the
+ * agent to run a command the machine doesn't have costs a failed tool call.
+ * A name already set (by the CLI that spawned this) is kept. `wiredElsewhere`
+ * also counts a repo whose other agents' files are on trail (hosts/registry.ts's
+ * `hostsWiredForTrail`, passed in so this file stays light): Cursor's and
+ * Codex's hooks run this same entry in repos with no `.claude` at all.
+ */
+export declare function adoptRepoBrand(repo: string, env?: NodeJS.ProcessEnv, wiredElsewhere?: (repo: string) => boolean): Brand;
+export declare function noticeStampPath(home?: string): string;
+/** Whether a `trail` executable is on PATH. Only checked when the notice is due. */
+export declare function trailOnPath(env?: NodeJS.ProcessEnv): boolean;
+/** Whether an executable called `name` is on PATH: a few stats, no process spawned. */
+export declare function commandOnPath(name: string, env?: NodeJS.ProcessEnv): boolean;
+export interface NoticeInput {
+    /** The graft spelling of what just ran, e.g. `graft ask` or `graft build`. */
+    ran: string;
+    /** stderr is a terminal: a person is watching. */
+    tty: boolean;
+    env?: NodeJS.ProcessEnv;
+    home?: string;
+    now?: number;
+}
+/**
+ * The line a person typing `graft` sees, at most once a day, or null.
+ *
+ * Never shown to an agent (no terminal, or Claude Code's `CLAUDECODE` is set),
+ * in CI, or under trail itself: agents and scripts get graft's output exactly
+ * as it was. Writing the stamp is best-effort; a home we cannot write to just
+ * means the line may show again tomorrow.
+ */
+export declare function graftNotice(input: NoticeInput): string | null;
+/**
+ * The line a person typing `trail` sees in a repo an older graft wired, while
+ * nothing on this machine can reach that wiring; or null.
+ *
+ * A graft 0.21 or older committed hook shims that look for `@nanonets/graft`
+ * alone, and registered a bare `graft mcp` server. On a machine with trail and
+ * no graft, the hooks run and do nothing and the server never starts, so the
+ * session start that would move the repo to trail never happens. `trail init`
+ * in the repo moves it, and so does a session opened under the hooks
+ * `trail init` writes to `~/.claude`; this says so to someone who has done
+ * neither. Silent once graft is on PATH, since its hooks then move the repo.
+ * Never shown to an agent, a pipe or CI, like {@link graftNotice}.
+ */
+export declare function strandedRepoNotice(input: {
+    cwd: string;
+    tty: boolean;
+    env?: NodeJS.ProcessEnv;
+}): string | null;
+export declare function handoverStampPath(home?: string): string;
+/**
+ * The line a Claude Code session start hands the agent on a machine that has
+ * graft but not the trail command, at most once a week; or null.
+ *
+ * {@link graftNotice} reaches a person typing graft. Most people only meet
+ * graft through their agent, so the agent is the one who can tell them that
+ * `graft upgrade` adds trail. Once trail is installed, the next session moves
+ * the repo over by itself (see upkeep-run.ts), so this stops.
+ */
+export declare function trailHandoverLine(input?: {
+    env?: NodeJS.ProcessEnv;
+    home?: string;
+    now?: number;
+}): string | null;
+//# sourceMappingURL=brand.d.ts.map

package/dist/brand.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"brand.d.ts","sourceRoot":"","sources":["../src/brand.ts"],"names":[],"mappings":"AAsBA,MAAM,MAAM,KAAK,GAAG,OAAO,GAAG,OAAO,CAAC;AAEtC,+EAA+E;AAC/E,eAAO,MAAM,SAAS,qBAAqB,CAAC;AAE5C,uEAAuE;AACvE,eAAO,MAAM,WAAW,EAAE,MAAM,CAAC,KAAK,EAAE,MAAM,CAG7C,CAAC;AAEF,wBAAgB,KAAK,CAAC,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG,KAAK,CAEjE;AAED,wBAAgB,QAAQ,CAAC,CAAC,EAAE,KAAK,EAAE,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG,IAAI,CAE7E;AAED;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,GAAG,OAAO,CAE7D;AAED,6EAA6E;AAC7E,wBAAgB,GAAG,CAAC,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG,MAAM,CAEhE;AAaD;;;;GAIG;AACH,wBAAgB,GAAG,CAAC,aAAa,EAAE,MAAM,EAAE,CAAC,GAAE,KAAe,GAAG,MAAM,CAOrE;AAED;;;;;GAKG;AACH,wBAAgB,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,CAAC,GAAE,KAAe,GAAG,MAAM,CAGhE;AAMD;;;;;;;;;;GAUG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAUtD;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,cAAc,CAC5B,IAAI,EAAE,MAAM,EACZ,GAAG,GAAE,MAAM,CAAC,UAAwB,EACpC,cAAc,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,GACzC,KAAK,CAMP;AAQD,wBAAgB,eAAe,CAAC,IAAI,GAAE,MAAkB,GAAG,MAAM,CAEhE;AAED,oFAAoF;AACpF,wBAAgB,WAAW,CAAC,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG,OAAO,CAEzE;AAUD,uFAAuF;AACvF,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG,OAAO,CAazF;AAED,MAAM,WAAW,WAAW;IAC1B,8EAA8E;IAC9E,GAAG,EAAE,MAAM,CAAC;IACZ,kDAAkD;IAClD,GAAG,EAAE,OAAO,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;IACxB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED;;;;;;;GAOG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,WAAW,GAAG,MAAM,GAAG,IAAI,CAqB7D;AAUD;;;;;;;;;;;;GAYG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,OAAO,CAAC;IAAC,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAA;CAAE,GAAG,MAAM,GAAG,IAAI,CAY/G;AAID,wBAAgB,iBAAiB,CAAC,IAAI,GAAE,MAAkB,GAAG,MAAM,CAElE;AAED;;;;;;;;GAQG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,GAAE;IAAE,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,GAAG,CAAC,EAAE,MAAM,CAAA;CAAO,GAAG,MAAM,GAAG,IAAI,CAqBrH"}

package/dist/brand.js

@@ -0,0 +1,282 @@
+/**
+ * Which name this process was started under: `trail`, or `graft`, the name it
+ * had before.
+ *
+ * Both names run the same code. `trail` gets the new command layout and says
+ * `[trail]`; `graft` keeps every old command, meaning and output byte for byte,
+ * because agents, hooks, CI scripts and statusline parsers already read it.
+ * Nothing about graft is ever removed — see `graftNotice` for the one line a
+ * person typing it sees.
+ *
+ * The name travels in an environment variable rather than a module variable so
+ * that every child this process spawns (the detached update check, a hook's
+ * background build) speaks the same name as its parent. Unset means graft: the
+ * only things that load `dist/cli.js` without going through `dist/bin/*` are
+ * shims and configs an older graft wrote.
+ *
+ * This file imports nothing heavier than node:fs, because the hooks load it.
+ */
+import { existsSync, mkdirSync, readFileSync, statSync, writeFileSync } from "node:fs";
+import { homedir } from "node:os";
+import { delimiter, dirname, join } from "node:path";
+/** Set by `dist/bin/trail.js` and `dist/bin/graft.js` before the CLI loads. */
+export const BRAND_ENV = "TRAIL_INVOKED_AS";
+/** The npm package each name is published as. Same code, two names. */
+export const PACKAGE_FOR = {
+    trail: "trail-code",
+    graft: "@nanonets/graft",
+};
+export function brand(env = process.env) {
+    return env[BRAND_ENV] === "trail" ? "trail" : "graft";
+}
+export function setBrand(b, env = process.env) {
+    env[BRAND_ENV] = b;
+}
+/**
+ * `init --pair CODE` is Trail's setup prompt: only Trail's page hands out a pair
+ * code, so the person asked for Trail, whatever name ran it. An agent whose
+ * install of `trail-code` failed swaps in the `graft` already on the
+ * machine, and an old shim loads dist/cli.js with no name; under graft either
+ * would skip the look-back and `.trail/` while the page waits for them.
+ */
+export function asksForTrail(argv) {
+    return argv.includes("init") && argv.some((a) => a === "--pair" || a.startsWith("--pair="));
+}
+/** `[trail]` or `[graft]`: the prefix agents and the statusline look for. */
+export function tag(env = process.env) {
+    return `[${brand(env)}]`;
+}
+/**
+ * The commands whose trail spelling is not just `graft` → `trail`, longest
+ * prefix first. `graft check` gave its name to the team check, and `graft
+ * stats` became `trail status`.
+ */
+const RENAMED = [
+    ["graft check", "trail build --check"],
+    ["graft stats", "trail status"],
+    ["graft", "trail"],
+];
+/**
+ * A command as the running name spells it. Takes the graft spelling, so call
+ * sites read the way they always have and graft's output does not change:
+ * `cmd("graft ask")` is `graft ask` under graft and `trail ask` under trail.
+ */
+export function cmd(graftSpelling, b = brand()) {
+    if (b === "graft")
+        return graftSpelling;
+    for (const [from, to] of RENAMED) {
+        if (graftSpelling === from)
+            return to;
+        if (graftSpelling.startsWith(`${from} `))
+            return `${to}${graftSpelling.slice(from.length)}`;
+    }
+    return graftSpelling;
+}
+/**
+ * Agent-facing prose and tool names in trail's spelling: `graft_find_code` →
+ * `trail_find_code`, and the word graft → trail. A `graft` followed by `/` is
+ * the code map's folder and stays, as do `graft-…` names. Under graft, the
+ * text comes back unchanged.
+ */
+export function inBrand(text, b = brand()) {
+    if (b === "graft")
+        return text;
+    return text.replace(/\bgraft_(?=[a-z])/g, "trail_").replace(/\bgraft\b(?![/\w-])/g, "trail");
+}
+/* -------------------------------------------------------------------------- */
+/* hooks and the statusline                                                   */
+/* -------------------------------------------------------------------------- */
+/**
+ * `trail init` wired this repo: its `.trail/` gitignore is the marker it writes
+ * before anything else, and older wirings left a shim, a skill or a settings
+ * block that names trail. Read from the repo, not the machine, so every
+ * teammate's agent speaks the same name whichever command they installed.
+ *
+ * `.trail/.gitignore` is what current `trail init` actually leaves behind (the
+ * hook shim and the Claude settings it used to write are gone), and the map's
+ * location depends on this answer: a repo it does not recognise builds into
+ * `graft/` while its own AGENTS.md says `.trail/cache/`.
+ */
+export function repoWiredForTrail(dir) {
+    if (existsSync(join(dir, ".trail", ".gitignore")))
+        return true;
+    if (existsSync(join(dir, ".trail", "hook.cjs")))
+        return true;
+    if (existsSync(join(dir, ".claude", "helpers", "trail-hooks.cjs")) || existsSync(join(dir, ".claude", "skills", "trail", "SKILL.md")))
+        return true;
+    try {
+        const settings = readFileSync(join(dir, ".claude", "settings.json"), "utf8");
+        return settings.includes("trail-hooks.cjs") || settings.includes("/.trail/hook.cjs");
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * The name hooks and the statusline speak in `repo`. They run under whatever
+ * shim set the repo up, often one an older graft committed, so no `dist/bin`
+ * entry has set a name. They say trail in a repo wired for it, but only when
+ * the `trail` command is installed on this machine: a hook that tells the
+ * agent to run a command the machine doesn't have costs a failed tool call.
+ * A name already set (by the CLI that spawned this) is kept. `wiredElsewhere`
+ * also counts a repo whose other agents' files are on trail (hosts/registry.ts's
+ * `hostsWiredForTrail`, passed in so this file stays light): Cursor's and
+ * Codex's hooks run this same entry in repos with no `.claude` at all.
+ */
+export function adoptRepoBrand(repo, env = process.env, wiredElsewhere) {
+    if (env[BRAND_ENV] !== "trail" && env[BRAND_ENV] !== "graft") {
+        const wired = repoWiredForTrail(repo) || Boolean(wiredElsewhere?.(repo));
+        setBrand(wired && trailOnPath(env) ? "trail" : "graft", env);
+    }
+    return brand(env);
+}
+/* -------------------------------------------------------------------------- */
+/* the once-a-day line for people still typing graft                          */
+/* -------------------------------------------------------------------------- */
+const DAY_MS = 24 * 60 * 60 * 1000;
+export function noticeStampPath(home = homedir()) {
+    return join(home, ".graft", "rename-notice.json");
+}
+/** Whether a `trail` executable is on PATH. Only checked when the notice is due. */
+export function trailOnPath(env = process.env) {
+    return commandOnPath("trail", env);
+}
+/**
+ * A package's own bin folder, which npm puts on PATH only for the command it
+ * runs: npx's temporary copy (`~/.npm/_npx/<hash>/node_modules/.bin`) or a
+ * project's dependencies. Agents start with the person's own PATH, so a
+ * command found only there isn't installed for them.
+ */
+const PACKAGE_BIN = /[\\/]node_modules[\\/]\.bin[\\/]?$/;
+/** Whether an executable called `name` is on PATH: a few stats, no process spawned. */
+export function commandOnPath(name, env = process.env) {
+    const names = process.platform === "win32" ? [`${name}.cmd`, `${name}.exe`, name] : [name];
+    for (const dir of (env.PATH ?? "").split(delimiter)) {
+        if (!dir || PACKAGE_BIN.test(dir))
+            continue;
+        for (const n of names) {
+            try {
+                if (statSync(join(dir, n)).isFile())
+                    return true;
+            }
+            catch {
+                /* not here */
+            }
+        }
+    }
+    return false;
+}
+/**
+ * The line a person typing `graft` sees, at most once a day, or null.
+ *
+ * Never shown to an agent (no terminal, or Claude Code's `CLAUDECODE` is set),
+ * in CI, or under trail itself: agents and scripts get graft's output exactly
+ * as it was. Writing the stamp is best-effort; a home we cannot write to just
+ * means the line may show again tomorrow.
+ */
+export function graftNotice(input) {
+    const env = input.env ?? process.env;
+    if (brand(env) !== "graft" || !input.tty)
+        return null;
+    if (env.CLAUDECODE !== undefined || env.CI || env.GRAFT_NO_RENAME_NOTICE)
+        return null;
+    const now = input.now ?? Date.now();
+    const path = noticeStampPath(input.home);
+    try {
+        const last = JSON.parse(readFileSync(path, "utf8")).shownAt ?? 0;
+        if (now - last < DAY_MS)
+            return null;
+    }
+    catch {
+        /* never shown */
+    }
+    try {
+        mkdirSync(dirname(path), { recursive: true });
+        writeFileSync(path, JSON.stringify({ shownAt: now }) + "\n");
+    }
+    catch {
+        /* shown again next time */
+    }
+    const lines = [`· graft is now trail. this ran ${cmd(input.ran, "trail")}, and graft keeps working (shown once a day)`];
+    if (!trailOnPath(env))
+        lines.push("· run graft upgrade to get the trail command too");
+    return lines.join("\n");
+}
+/** The nearest directory at or above `dir` holding a `.git`, or null. */
+function gitRootOf(dir) {
+    for (let at = dir;; at = dirname(at)) {
+        if (existsSync(join(at, ".git")))
+            return at;
+        if (dirname(at) === at)
+            return null;
+    }
+}
+/**
+ * The line a person typing `trail` sees in a repo an older graft wired, while
+ * nothing on this machine can reach that wiring; or null.
+ *
+ * A graft 0.21 or older committed hook shims that look for `@nanonets/graft`
+ * alone, and registered a bare `graft mcp` server. On a machine with trail and
+ * no graft, the hooks run and do nothing and the server never starts, so the
+ * session start that would move the repo to trail never happens. `trail init`
+ * in the repo moves it, and so does a session opened under the hooks
+ * `trail init` writes to `~/.claude`; this says so to someone who has done
+ * neither. Silent once graft is on PATH, since its hooks then move the repo.
+ * Never shown to an agent, a pipe or CI, like {@link graftNotice}.
+ */
+export function strandedRepoNotice(input) {
+    const env = input.env ?? process.env;
+    if (brand(env) !== "trail" || !input.tty)
+        return null;
+    if (env.CLAUDECODE !== undefined || env.CI)
+        return null;
+    const repo = gitRootOf(input.cwd);
+    if (!repo || repoWiredForTrail(repo) || commandOnPath("graft", env))
+        return null;
+    try {
+        if (readFileSync(join(repo, ".claude", "helpers", "graft-hooks.cjs"), "utf8").includes(PACKAGE_FOR.trail))
+            return null;
+    }
+    catch {
+        return null; // no graft wiring here
+    }
+    return "· this repo's agent hooks were set up by an older graft and can't find trail. run trail init here once to move the repo over";
+}
+const WEEK_MS = 7 * DAY_MS;
+export function handoverStampPath(home = homedir()) {
+    return join(home, ".graft", "trail-handover.json");
+}
+/**
+ * The line a Claude Code session start hands the agent on a machine that has
+ * graft but not the trail command, at most once a week; or null.
+ *
+ * {@link graftNotice} reaches a person typing graft. Most people only meet
+ * graft through their agent, so the agent is the one who can tell them that
+ * `graft upgrade` adds trail. Once trail is installed, the next session moves
+ * the repo over by itself (see upkeep-run.ts), so this stops.
+ */
+export function trailHandoverLine(input = {}) {
+    const env = input.env ?? process.env;
+    if (brand(env) !== "graft" || env.CI || env.GRAFT_NO_RENAME_NOTICE || trailOnPath(env))
+        return null;
+    const now = input.now ?? Date.now();
+    const path = handoverStampPath(input.home);
+    try {
+        const last = JSON.parse(readFileSync(path, "utf8")).shownAt ?? 0;
+        if (now - last < WEEK_MS)
+            return null;
+    }
+    catch {
+        /* never shown */
+    }
+    try {
+        mkdirSync(dirname(path), { recursive: true });
+        writeFileSync(path, JSON.stringify({ shownAt: now }) + "\n");
+    }
+    catch {
+        /* shown again next time */
+    }
+    return ("· graft is now Trail-code: the same code map under the `trail` command. " +
+        "Tell the user once, in a line at the end of your first reply, that `graft upgrade` switches the name and graft keeps working.");
+}
+//# sourceMappingURL=brand.js.map

package/dist/brand.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"brand.js","sourceRoot":"","sources":["../src/brand.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AACH,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,YAAY,EAAE,QAAQ,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AACvF,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,EAAE,SAAS,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAIrD,+EAA+E;AAC/E,MAAM,CAAC,MAAM,SAAS,GAAG,kBAAkB,CAAC;AAE5C,uEAAuE;AACvE,MAAM,CAAC,MAAM,WAAW,GAA0B;IAChD,KAAK,EAAE,YAAY;IACnB,KAAK,EAAE,iBAAiB;CACzB,CAAC;AAEF,MAAM,UAAU,KAAK,CAAC,MAAyB,OAAO,CAAC,GAAG;IACxD,OAAO,GAAG,CAAC,SAAS,CAAC,KAAK,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC;AACxD,CAAC;AAED,MAAM,UAAU,QAAQ,CAAC,CAAQ,EAAE,MAAyB,OAAO,CAAC,GAAG;IACrE,GAAG,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC;AACrB,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,YAAY,CAAC,IAAuB;IAClD,OAAO,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,QAAQ,IAAI,CAAC,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC,CAAC;AAC9F,CAAC;AAED,6EAA6E;AAC7E,MAAM,UAAU,GAAG,CAAC,MAAyB,OAAO,CAAC,GAAG;IACtD,OAAO,IAAI,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC;AAC3B,CAAC;AAED;;;;GAIG;AACH,MAAM,OAAO,GAA6C;IACxD,CAAC,aAAa,EAAE,qBAAqB,CAAC;IACtC,CAAC,aAAa,EAAE,cAAc,CAAC;IAC/B,CAAC,OAAO,EAAE,OAAO,CAAC;CACnB,CAAC;AAEF;;;;GAIG;AACH,MAAM,UAAU,GAAG,CAAC,aAAqB,EAAE,IAAW,KAAK,EAAE;IAC3D,IAAI,CAAC,KAAK,OAAO;QAAE,OAAO,aAAa,CAAC;IACxC,KAAK,MAAM,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,OAAO,EAAE,CAAC;QACjC,IAAI,aAAa,KAAK,IAAI;YAAE,OAAO,EAAE,CAAC;QACtC,IAAI,aAAa,CAAC,UAAU,CAAC,GAAG,IAAI,GAAG,CAAC;YAAE,OAAO,GAAG,EAAE,GAAG,aAAa,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC;IAC9F,CAAC;IACD,OAAO,aAAa,CAAC;AACvB,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,OAAO,CAAC,IAAY,EAAE,IAAW,KAAK,EAAE;IACtD,IAAI,CAAC,KAAK,OAAO;QAAE,OAAO,IAAI,CAAC;IAC/B,OAAO,IAAI,CAAC,OAAO,CAAC,oBAAoB,EAAE,QAAQ,CAAC,CAAC,OAAO,CAAC,sBAAsB,EAAE,OAAO,CAAC,CAAC;AAC/F,CAAC;AAED,gFAAgF;AAChF,gFAAgF;AAChF,gFAAgF;AAEhF;;;;;;;;;;GAUG;AACH,MAAM,UAAU,iBAAiB,CAAC,GAAW;IAC3C,IAAI,UAAU,CAAC,IAAI,CAAC,GAAG,EAAE,QAAQ,EAAE,YAAY,CAAC,CAAC;QAAE,OAAO,IAAI,CAAC;IAC/D,IAAI,UAAU,CAAC,IAAI,CAAC,GAAG,EAAE,QAAQ,EAAE,UAAU,CAAC,CAAC;QAAE,OAAO,IAAI,CAAC;IAC7D,IAAI,UAAU,CAAC,IAAI,CAAC,GAAG,EAAE,SAAS,EAAE,SAAS,EAAE,iBAAiB,CAAC,CAAC,IAAI,UAAU,CAAC,IAAI,CAAC,GAAG,EAAE,SAAS,EAAE,QAAQ,EAAE,OAAO,EAAE,UAAU,CAAC,CAAC;QAAE,OAAO,IAAI,CAAC;IACnJ,IAAI,CAAC;QACH,MAAM,QAAQ,GAAG,YAAY,CAAC,IAAI,CAAC,GAAG,EAAE,SAAS,EAAE,eAAe,CAAC,EAAE,MAAM,CAAC,CAAC;QAC7E,OAAO,QAAQ,CAAC,QAAQ,CAAC,iBAAiB,CAAC,IAAI,QAAQ,CAAC,QAAQ,CAAC,kBAAkB,CAAC,CAAC;IACvF,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,UAAU,cAAc,CAC5B,IAAY,EACZ,MAAyB,OAAO,CAAC,GAAG,EACpC,cAA0C;IAE1C,IAAI,GAAG,CAAC,SAAS,CAAC,KAAK,OAAO,IAAI,GAAG,CAAC,SAAS,CAAC,KAAK,OAAO,EAAE,CAAC;QAC7D,MAAM,KAAK,GAAG,iBAAiB,CAAC,IAAI,CAAC,IAAI,OAAO,CAAC,cAAc,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC;QACzE,QAAQ,CAAC,KAAK,IAAI,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;IAC/D,CAAC;IACD,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC;AACpB,CAAC;AAED,gFAAgF;AAChF,gFAAgF;AAChF,gFAAgF;AAEhF,MAAM,MAAM,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC;AAEnC,MAAM,UAAU,eAAe,CAAC,OAAe,OAAO,EAAE;IACtD,OAAO,IAAI,CAAC,IAAI,EAAE,QAAQ,EAAE,oBAAoB,CAAC,CAAC;AACpD,CAAC;AAED,oFAAoF;AACpF,MAAM,UAAU,WAAW,CAAC,MAAyB,OAAO,CAAC,GAAG;IAC9D,OAAO,aAAa,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;AACrC,CAAC;AAED;;;;;GAKG;AACH,MAAM,WAAW,GAAG,oCAAoC,CAAC;AAEzD,uFAAuF;AACvF,MAAM,UAAU,aAAa,CAAC,IAAY,EAAE,MAAyB,OAAO,CAAC,GAAG;IAC9E,MAAM,KAAK,GAAG,OAAO,CAAC,QAAQ,KAAK,OAAO,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI,MAAM,EAAE,GAAG,IAAI,MAAM,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;IAC3F,KAAK,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,SAAS,CAAC,EAAE,CAAC;QACpD,IAAI,CAAC,GAAG,IAAI,WAAW,CAAC,IAAI,CAAC,GAAG,CAAC;YAAE,SAAS;QAC5C,KAAK,MAAM,CAAC,IAAI,KAAK,EAAE,CAAC;YACtB,IAAI,CAAC;gBACH,IAAI,QAAQ,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,CAAC,MAAM,EAAE;oBAAE,OAAO,IAAI,CAAC;YACnD,CAAC;YAAC,MAAM,CAAC;gBACP,cAAc;YAChB,CAAC;QACH,CAAC;IACH,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAYD;;;;;;;GAOG;AACH,MAAM,UAAU,WAAW,CAAC,KAAkB;IAC5C,MAAM,GAAG,GAAG,KAAK,CAAC,GAAG,IAAI,OAAO,CAAC,GAAG,CAAC;IACrC,IAAI,KAAK,CAAC,GAAG,CAAC,KAAK,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG;QAAE,OAAO,IAAI,CAAC;IACtD,IAAI,GAAG,CAAC,UAAU,KAAK,SAAS,IAAI,GAAG,CAAC,EAAE,IAAI,GAAG,CAAC,sBAAsB;QAAE,OAAO,IAAI,CAAC;IACtF,MAAM,GAAG,GAAG,KAAK,CAAC,GAAG,IAAI,IAAI,CAAC,GAAG,EAAE,CAAC;IACpC,MAAM,IAAI,GAAG,eAAe,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IACzC,IAAI,CAAC;QACH,MAAM,IAAI,GAAI,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,CAA0B,CAAC,OAAO,IAAI,CAAC,CAAC;QAC3F,IAAI,GAAG,GAAG,IAAI,GAAG,MAAM;YAAE,OAAO,IAAI,CAAC;IACvC,CAAC;IAAC,MAAM,CAAC;QACP,iBAAiB;IACnB,CAAC;IACD,IAAI,CAAC;QACH,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAC9C,aAAa,CAAC,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,OAAO,EAAE,GAAG,EAAE,CAAC,GAAG,IAAI,CAAC,CAAC;IAC/D,CAAC;IAAC,MAAM,CAAC;QACP,2BAA2B;IAC7B,CAAC;IACD,MAAM,KAAK,GAAG,CAAC,kCAAkC,GAAG,CAAC,KAAK,CAAC,GAAG,EAAE,OAAO,CAAC,8CAA8C,CAAC,CAAC;IACxH,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC;QAAE,KAAK,CAAC,IAAI,CAAC,kDAAkD,CAAC,CAAC;IACtF,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AAED,yEAAyE;AACzE,SAAS,SAAS,CAAC,GAAW;IAC5B,KAAK,IAAI,EAAE,GAAG,GAAG,GAAI,EAAE,GAAG,OAAO,CAAC,EAAE,CAAC,EAAE,CAAC;QACtC,IAAI,UAAU,CAAC,IAAI,CAAC,EAAE,EAAE,MAAM,CAAC,CAAC;YAAE,OAAO,EAAE,CAAC;QAC5C,IAAI,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE;YAAE,OAAO,IAAI,CAAC;IACtC,CAAC;AACH,CAAC;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,kBAAkB,CAAC,KAA6D;IAC9F,MAAM,GAAG,GAAG,KAAK,CAAC,GAAG,IAAI,OAAO,CAAC,GAAG,CAAC;IACrC,IAAI,KAAK,CAAC,GAAG,CAAC,KAAK,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG;QAAE,OAAO,IAAI,CAAC;IACtD,IAAI,GAAG,CAAC,UAAU,KAAK,SAAS,IAAI,GAAG,CAAC,EAAE;QAAE,OAAO,IAAI,CAAC;IACxD,MAAM,IAAI,GAAG,SAAS,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAClC,IAAI,CAAC,IAAI,IAAI,iBAAiB,CAAC,IAAI,CAAC,IAAI,aAAa,CAAC,OAAO,EAAE,GAAG,CAAC;QAAE,OAAO,IAAI,CAAC;IACjF,IAAI,CAAC;QACH,IAAI,YAAY,CAAC,IAAI,CAAC,IAAI,EAAE,SAAS,EAAE,SAAS,EAAE,iBAAiB,CAAC,EAAE,MAAM,CAAC,CAAC,QAAQ,CAAC,WAAW,CAAC,KAAK,CAAC;YAAE,OAAO,IAAI,CAAC;IACzH,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC,CAAC,uBAAuB;IACtC,CAAC;IACD,OAAO,8HAA8H,CAAC;AACxI,CAAC;AAED,MAAM,OAAO,GAAG,CAAC,GAAG,MAAM,CAAC;AAE3B,MAAM,UAAU,iBAAiB,CAAC,OAAe,OAAO,EAAE;IACxD,OAAO,IAAI,CAAC,IAAI,EAAE,QAAQ,EAAE,qBAAqB,CAAC,CAAC;AACrD,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,iBAAiB,CAAC,QAAkE,EAAE;IACpG,MAAM,GAAG,GAAG,KAAK,CAAC,GAAG,IAAI,OAAO,CAAC,GAAG,CAAC;IACrC,IAAI,KAAK,CAAC,GAAG,CAAC,KAAK,OAAO,IAAI,GAAG,CAAC,EAAE,IAAI,GAAG,CAAC,sBAAsB,IAAI,WAAW,CAAC,GAAG,CAAC;QAAE,OAAO,IAAI,CAAC;IACpG,MAAM,GAAG,GAAG,KAAK,CAAC,GAAG,IAAI,IAAI,CAAC,GAAG,EAAE,CAAC;IACpC,MAAM,IAAI,GAAG,iBAAiB,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAC3C,IAAI,CAAC;QACH,MAAM,IAAI,GAAI,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,CAA0B,CAAC,OAAO,IAAI,CAAC,CAAC;QAC3F,IAAI,GAAG,GAAG,IAAI,GAAG,OAAO;YAAE,OAAO,IAAI,CAAC;IACxC,CAAC;IAAC,MAAM,CAAC;QACP,iBAAiB;IACnB,CAAC;IACD,IAAI,CAAC;QACH,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAC9C,aAAa,CAAC,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,OAAO,EAAE,GAAG,EAAE,CAAC,GAAG,IAAI,CAAC,CAAC;IAC/D,CAAC;IAAC,MAAM,CAAC;QACP,2BAA2B;IAC7B,CAAC;IACD,OAAO,CACL,0EAA0E;QAC1E,+HAA+H,CAChI,CAAC;AACJ,CAAC"}

package/dist/claude/build-progress.d.ts

@@ -0,0 +1,30 @@
+export interface BuiltGraph {
+    nodes: number;
+    edges: number;
+    files: number;
+}
+/** The totals out of `graft build`'s stdout, or null when it printed none. */
+export declare function parseBuildSummary(stdout: string): BuiltGraph | null;
+/** The last `parsing N/M` in a chunk of the child's stderr. */
+export declare function parseProgress(chunk: string): {
+    index: number;
+    total: number;
+} | null;
+/**
+ * Build the graph for `dir` unless it has one, showing progress on a spinner.
+ *
+ * `built: false` with no `failed` means there was nothing to do (`--no-build`,
+ * or a graph already there). Warning and error lines the build printed come
+ * back in `messages`, for the caller to print in full.
+ */
+export declare function buildGraphWithProgress(dir: string, opts: {
+    build?: boolean;
+    cliPath?: string;
+    childCount?: number;
+}): Promise<{
+    built: boolean;
+    graph?: BuiltGraph;
+    failed?: boolean;
+    messages: string[];
+}>;
+//# sourceMappingURL=build-progress.d.ts.map

package/dist/claude/build-progress.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"build-progress.d.ts","sourceRoot":"","sources":["../../src/claude/build-progress.ts"],"names":[],"mappings":"AAcA,MAAM,WAAW,UAAU;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;CACf;AAID,8EAA8E;AAC9E,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,GAAG,UAAU,GAAG,IAAI,CAKnE;AAED,+DAA+D;AAC/D,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAIpF;AAED;;;;;;GAMG;AACH,wBAAsB,sBAAsB,CAC1C,GAAG,EAAE,MAAM,EACX,IAAI,EAAE;IAAE,KAAK,CAAC,EAAE,OAAO,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAAC,UAAU,CAAC,EAAE,MAAM,CAAA;CAAE,GAC/D,OAAO,CAAC;IAAE,KAAK,EAAE,OAAO,CAAC;IAAC,KAAK,CAAC,EAAE,UAAU,CAAC;IAAC,MAAM,CAAC,EAAE,OAAO,CAAC;IAAC,QAAQ,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC,CAwCvF"}