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

package/dist/upkeep-run.d.ts

@@ -0,0 +1,22 @@
+export interface UpkeepResult {
+    /** Lines worth showing the agent/user, already formatted. Usually empty. */
+    lines: string[];
+}
+/**
+ * Whether a repo wired as graft should move to trail now: the person has the
+ * trail command, so they've taken the update that renames graft. Each repo
+ * moves the first time a session opens in it. GRAFT_NO_TRAIL_SWITCH=1 keeps a
+ * machine on graft.
+ */
+export declare function shouldMoveToTrail(repo: string, env?: NodeJS.ProcessEnv): boolean;
+/**
+ * @param repo    the project dir
+ * @param current the running graft's version
+ * @param opts.background  false in hook contexts: read the update cache, never
+ *   spawn a fetch. Hooks run under a hard timeout and must stay off the network.
+ */
+export declare function runUpkeep(repo: string, current: string, opts?: {
+    background?: boolean;
+    home?: string;
+}): UpkeepResult;
+//# sourceMappingURL=upkeep-run.d.ts.map

package/dist/upkeep-run.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"upkeep-run.d.ts","sourceRoot":"","sources":["../src/upkeep-run.ts"],"names":[],"mappings":"AAqBA,MAAM,WAAW,YAAY;IAC3B,4EAA4E;IAC5E,KAAK,EAAE,MAAM,EAAE,CAAC;CACjB;AAqCD;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG,OAAO,CAI7F;AAED;;;;;GAKG;AACH,wBAAgB,SAAS,CACvB,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,EACf,IAAI,GAAE;IAAE,UAAU,CAAC,EAAE,OAAO,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAO,GACjD,YAAY,CAad"}

package/dist/upkeep-run.js

@@ -0,0 +1,85 @@
+/**
+ * The wired-up version of `./upkeep.ts` — one call every entry point makes.
+ *
+ * Split from `upkeep.ts` so that module stays pure and unit-testable (no init
+ * writes, no spawning): this file is the only place that knows how to actually
+ * re-run the wiring, and it is deliberately thin.
+ */
+import { runInit } from './claude/init.js';
+import { runHostsInit } from './hosts/init.js';
+import { graftCliPath } from './claude/paths.js';
+import { repoWiredForTrail, setBrand, trailOnPath } from './brand.js';
+import { formatUpdateNudge, formatWiringRefresh, maybeRefreshInBackground, readUpdateCache, reconcileWiring, wiredHostIds, } from './upkeep.js';
+/**
+ * Re-write the wiring for exactly the hosts a previous `init` chose here, with
+ * exactly the flags it was given.
+ *
+ * `build: false` matters: this runs at session start and at MCP boot, and a graph
+ * build there would stall the agent's first turn.
+ *
+ * The out-of-repo writes (`~/.codex/hooks.json`, `~/.codex/config.toml`) ARE
+ * included, because nothing else would ever refresh them: no skill, rule file, or
+ * MCP instruction tells an agent to run `graft init`, so leaving them out means a
+ * Codex user upgrades the binary and keeps the old hook config forever. They're
+ * safe to replay — `installCodexHooks` no-ops when `~/.codex` is absent, rewrites
+ * only its own entry (matched on `graft-hooks.cjs`), and reports `unchanged` when
+ * the bytes match. A user who declined them at init time is honoured via
+ * `opts.global`/`opts.hooks`, replayed from the stamp.
+ */
+function rewriteWiring(repo, hosts, opts, toTrail = false) {
+    // Moving to trail: everything written from here speaks trail, the repo gets
+    // its .trail/, and the hosts are rewired under trail's names.
+    if (toTrail)
+        setBrand('trail');
+    // Under trail, .trail/ is created by runInit when --build is set;
+    // ensureRepoHome/ensureRepoTrail removed in trail-solo-grafo change.
+    // `opts.global` reaches the claude layer for the same reason `opts.statusline` does:
+    // its `~/.claude` writes (hosts/claude-global.ts) are out-of-repo, and a user who
+    // declined those at init time must keep declining them on every replay.
+    if (hosts.includes('claude'))
+        runInit(repo, { build: false, cliPath: graftCliPath(), statusline: opts.statusline, global: opts.global && (!opts.laptop || opts.laptop.includes('claude')), ...(toTrail ? { brand: 'trail' } : {}) });
+    // The other agents move with Claude Code: their graft-named files and
+    // fenced blocks are replaced by trail's (see hosts/init.ts).
+    const others = hosts.filter((h) => h !== 'claude');
+    if (others.length)
+        runHostsInit(repo, { agents: others, global: opts.global, laptop: opts.laptop, mcp: opts.mcp, hooks: opts.hooks, ...(toTrail ? { brand: 'trail' } : {}) });
+    // Past sessions are never read here: only `trail init`, where the person sees what was found and picks.
+}
+/**
+ * Whether a repo wired as graft should move to trail now: the person has the
+ * trail command, so they've taken the update that renames graft. Each repo
+ * moves the first time a session opens in it. GRAFT_NO_TRAIL_SWITCH=1 keeps a
+ * machine on graft.
+ */
+export function shouldMoveToTrail(repo, env = process.env) {
+    if (env.GRAFT_NO_TRAIL_SWITCH === '1')
+        return false;
+    // Claude Code's wiring is what says a repo is on trail, so only a repo with it moves.
+    return wiredHostIds(repo).includes('claude') && !repoWiredForTrail(repo) && trailOnPath(env);
+}
+/**
+ * @param repo    the project dir
+ * @param current the running graft's version
+ * @param opts.background  false in hook contexts: read the update cache, never
+ *   spawn a fetch. Hooks run under a hard timeout and must stay off the network.
+ */
+export function runUpkeep(repo, current, opts = {}) {
+    const lines = [];
+    try {
+        const refreshed = reconcileWiring(repo, current, { rewrite: rewriteWiring, toTrail: (r) => shouldMoveToTrail(r) });
+        const refreshLine = formatWiringRefresh(refreshed);
+        if (refreshLine)
+            lines.push(refreshLine);
+    }
+    catch { /* fail-soft: wiring refresh is never worth breaking a session for */ }
+    try {
+        if (opts.background !== false)
+            maybeRefreshInBackground(opts.home);
+        const nudge = formatUpdateNudge(current, readUpdateCache(opts.home)?.latest);
+        if (nudge)
+            lines.push(nudge);
+    }
+    catch { /* same */ }
+    return { lines };
+}
+//# sourceMappingURL=upkeep-run.js.map

package/dist/upkeep-run.js.map

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

package/dist/upkeep.d.ts

@@ -0,0 +1,127 @@
+/**
+ * The version of the graft package this code was loaded from.
+ *
+ * Resolved from *this* module rather than the caller's: `readCurrentVersion`
+ * looks one level up from the module URL it's given, which lands on the package
+ * root for `dist/upkeep.js` but misses entirely for `dist/claude/hooks.js` and
+ * `dist/mcp/server.js`. Every caller asking here instead of passing its own
+ * `import.meta.url` is what keeps the hook and the MCP server from reading
+ * `0.0.0` and re-initing on every single session.
+ */
+export declare function runningVersion(): string;
+/** How long a registry answer is considered current. A day: graft ships far less
+ * often than that, and this is a nudge, not a security update. */
+export declare const UPDATE_TTL_MS: number;
+/** Numeric-dotted compare of the release part only (`1.2.3-beta.1` → `1.2.3`).
+ * Prerelease ordering doesn't matter here: the only question either caller asks
+ * is "is the thing on npm ahead of what's on disk", and a prerelease that
+ * compares equal simply produces no nudge. */
+export declare function compareVersions(a: string, b: string): number;
+export declare function isNewer(candidate: string | null | undefined, current: string): boolean;
+export interface UpdateCache {
+    /** Latest version seen on npm, or null when the last fetch failed. */
+    latest: string | null;
+    /** Epoch ms of the last *attempt* — written by the parent before it spawns the
+     * fetch, so a repeatedly-failing fetch can't make every command spawn a child. */
+    checkedAt: number;
+}
+/** Machine-global, not per-repo: "what's the latest graft" is one fact, and a
+ * dev with twelve repos should cost the registry one request a day, not twelve. */
+export declare function updateCachePath(home?: string): string;
+export declare function readUpdateCache(home?: string): UpdateCache | null;
+/**
+ * The `graft _update-check` command body: hit the registry, store the answer.
+ * Runs in a detached child so nothing user-facing ever waits on the network.
+ */
+export declare function refreshUpdateCache(home?: string, now?: number): UpdateCache;
+/** True when the cached answer is missing or older than the TTL. */
+export declare function needsRefresh(cache: UpdateCache | null, now?: number): boolean;
+/**
+ * Kick off a background registry check if the cache has gone stale. Touches
+ * `checkedAt` first so concurrent callers (and a child that dies) don't spawn a
+ * fetch per invocation. Never waits, never throws.
+ *
+ * Only called from long-lived or already-slow contexts (a CLI command, MCP
+ * boot) — never from a hook, which reads the cache and nothing else.
+ */
+export declare function maybeRefreshInBackground(home?: string, now?: number, env?: NodeJS.ProcessEnv): boolean;
+/** One line, or nothing. Nothing is the common case — don't spend context on
+ * "you're up to date". */
+export declare function formatUpdateNudge(current: string, latest: string | null | undefined): string | null;
+/**
+ * The subset of `graft init`'s flags a refresh has to replay.
+ *
+ * Without these, an auto-refresh would install things the user explicitly
+ * declined: someone who ran `graft init --no-global` (or `--no-hooks`, or
+ * `--no-statusline`) said "keep out of `~/.codex`" / "leave my statusline
+ * alone", and a later session silently writing there would be graft overriding a
+ * decision rather than maintaining one. Absent from an older stamp → all true,
+ * which is what plain `graft init` does.
+ */
+export interface WiringOpts {
+    /** false → never write outside the repo (`--no-global`). */
+    global: boolean;
+    /** false → skip MCP server registration (`--no-mcp`). */
+    mcp: boolean;
+    /** false → skip hook installation (`--no-hooks`). */
+    hooks: boolean;
+    /** false → skip Claude Code statusLine (`--no-statusline` / GRAFT_NO_STATUSLINE). */
+    statusline: boolean;
+    /** `--agents auto`: the only hosts that write outside the repo (the agents installed when it ran). Absent → every wired host. */
+    laptop?: string[];
+}
+export declare const DEFAULT_WIRING_OPTS: WiringOpts;
+/** An older stamp has no `opts`; a plain `graft init` wired everything. */
+export declare function wiringOpts(stamp: WiringStamp | null): WiringOpts;
+export interface WiringStamp {
+    /** The graft version whose `init` wrote this repo's agent files. */
+    version: string;
+    /** Host ids that were wired, so a refresh re-writes exactly those and never
+     * silently adopts an agent the user declined in the picker. */
+    hosts: string[];
+    /** The init flags to replay — see {@link WiringOpts}. */
+    opts?: Partial<WiringOpts>;
+    at: string;
+}
+/** Under `graft/.cache/`, beside the other derived state: git-ignored, per-clone,
+ * and cheap to lose — a missing stamp just means one idempotent refresh. */
+export declare function stampPath(repo: string): string;
+export declare function readStamp(repo: string): WiringStamp | null;
+export declare function writeStamp(repo: string, version: string, hosts: string[], opts?: Partial<WiringOpts>, at?: string): void;
+/**
+ * Which agents this repo is *already* wired for, read off disk rather than
+ * re-detected. Detection answers "which editors does this machine have"; for a
+ * refresh we need "which files did a previous init actually write" — otherwise
+ * installing Windsurf once would silently add graft rules to every repo.
+ */
+export declare function wiredHostIds(repo: string): string[];
+export interface WiringRefresh {
+    from: string;
+    to: string;
+    hosts: string[];
+    /** True when the refresh included writes outside the repo (`~/.codex/`), so the
+     * caller can say so — a session changing machine-wide config should be visible. */
+    global: boolean;
+    /** True when it moved a repo wired as graft over to trail. */
+    switched?: boolean;
+}
+/**
+ * Re-run init's writes when the stamp and the running binary disagree.
+ *
+ * Deliberately narrow: it refreshes the hosts already wired, replays the flags
+ * that init was given, never builds the graph (this runs at session start — a
+ * rebuild there would stall the agent's first turn), and no-ops when the repo has
+ * no graft wiring at all.
+ *
+ * `toTrail` says whether this repo should move from graft's wiring to trail's
+ * (see upkeep-run.ts). When it should, the refresh runs whatever the stamp says:
+ * the person installed trail, which is the signal, whether or not graft's own
+ * version moved.
+ */
+export declare function reconcileWiring(repo: string, current: string, deps: {
+    wired?: (repo: string) => string[];
+    rewrite: (repo: string, hosts: string[], opts: WiringOpts, toTrail: boolean) => void;
+    toTrail?: (repo: string) => boolean;
+}): WiringRefresh | null;
+export declare function formatWiringRefresh(r: WiringRefresh | null): string | null;
+//# sourceMappingURL=upkeep.d.ts.map

package/dist/upkeep.d.ts.map

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

package/dist/upkeep.js

@@ -0,0 +1,252 @@
+/**
+ * Self-maintenance: keeping an installed graft, and the wiring it wrote, current.
+ *
+ * Two independent kinds of staleness, both invisible to the user today:
+ *
+ *   1. **Binary staleness** — they installed once and never upgraded. `graft
+ *      version` would tell them, but nobody runs it. So we keep a cached,
+ *      machine-global registry answer and let every entry point surface a
+ *      one-line nudge from it.
+ *
+ *   2. **Wiring staleness** — `graft init` copies hooks, shims, skill text and
+ *      rule files INTO the repo. `npm i -g` replaces the binary but touches none
+ *      of them, so a repo wired by 0.7 keeps 0.7's prompts and 0.7's hook
+ *      timeouts forever (see the comment on `promptAskTimeout`, which exists
+ *      only to work around exactly this). A version stamp written next to the
+ *      graph lets any entry point notice the skew and re-run the writes.
+ *
+ * Everything here is fail-soft by construction: it runs inside hooks and inside
+ * the MCP server's boot path, where a throw is a broken session, and it must
+ * never block on the network — the registry is only ever read from cache, and
+ * the refresh happens in a detached child.
+ *
+ * Called from all three hosts' entry points so no editor is left out:
+ *   • Claude Code   — `session-start` hook (src/claude/hooks.ts)
+ *   • Cursor/Codex  — MCP server boot (src/mcp/server.ts), and any CLI command
+ */
+import { existsSync, readFileSync } from 'node:fs';
+import { spawn } from 'node:child_process';
+import { join } from 'node:path';
+import { homedir } from 'node:os';
+import { readJson, writeJsonAtomic, cacheDir } from './util/state.js';
+import { HOSTS, hostRelPath } from './hosts/registry.js';
+import { markersFor } from './hosts/sections.js';
+import { getNpmViewVersion, readCurrentVersion } from './cli-meta.js';
+import { brand } from './brand.js';
+import { graftCliPath } from './claude/paths.js';
+/**
+ * The version of the graft package this code was loaded from.
+ *
+ * Resolved from *this* module rather than the caller's: `readCurrentVersion`
+ * looks one level up from the module URL it's given, which lands on the package
+ * root for `dist/upkeep.js` but misses entirely for `dist/claude/hooks.js` and
+ * `dist/mcp/server.js`. Every caller asking here instead of passing its own
+ * `import.meta.url` is what keeps the hook and the MCP server from reading
+ * `0.0.0` and re-initing on every single session.
+ */
+export function runningVersion() {
+    try {
+        return readCurrentVersion(import.meta.url);
+    }
+    catch {
+        return '0.0.0';
+    }
+}
+/** How long a registry answer is considered current. A day: graft ships far less
+ * often than that, and this is a nudge, not a security update. */
+export const UPDATE_TTL_MS = 24 * 60 * 60 * 1000;
+/* -------------------------------------------------------------------------- */
+/* version comparison                                                         */
+/* -------------------------------------------------------------------------- */
+/** Numeric-dotted compare of the release part only (`1.2.3-beta.1` → `1.2.3`).
+ * Prerelease ordering doesn't matter here: the only question either caller asks
+ * is "is the thing on npm ahead of what's on disk", and a prerelease that
+ * compares equal simply produces no nudge. */
+export function compareVersions(a, b) {
+    const parts = (v) => String(v).split('-')[0].split('.').map((n) => Number(n) || 0);
+    const pa = parts(a);
+    const pb = parts(b);
+    for (let i = 0; i < Math.max(pa.length, pb.length); i++) {
+        const d = (pa[i] ?? 0) - (pb[i] ?? 0);
+        if (d !== 0)
+            return d < 0 ? -1 : 1;
+    }
+    return 0;
+}
+export function isNewer(candidate, current) {
+    if (!candidate)
+        return false;
+    return compareVersions(candidate, current) > 0;
+}
+/** Machine-global, not per-repo: "what's the latest graft" is one fact, and a
+ * dev with twelve repos should cost the registry one request a day, not twelve. */
+export function updateCachePath(home = homedir()) {
+    return join(home, '.graft', 'update-check.json');
+}
+export function readUpdateCache(home) {
+    return readJson(updateCachePath(home));
+}
+function writeUpdateCache(cache, home) {
+    try {
+        writeJsonAtomic(updateCachePath(home), cache);
+    }
+    catch { /* unwritable home — skip */ }
+}
+/**
+ * The `graft _update-check` command body: hit the registry, store the answer.
+ * Runs in a detached child so nothing user-facing ever waits on the network.
+ */
+export function refreshUpdateCache(home, now = Date.now()) {
+    const res = getNpmViewVersion();
+    const cache = { latest: res.ok ? (res.version ?? null) : null, checkedAt: now };
+    writeUpdateCache(cache, home);
+    return cache;
+}
+/** True when the cached answer is missing or older than the TTL. */
+export function needsRefresh(cache, now = Date.now()) {
+    return !cache || typeof cache.checkedAt !== 'number' || now - cache.checkedAt >= UPDATE_TTL_MS;
+}
+/**
+ * Kick off a background registry check if the cache has gone stale. Touches
+ * `checkedAt` first so concurrent callers (and a child that dies) don't spawn a
+ * fetch per invocation. Never waits, never throws.
+ *
+ * Only called from long-lived or already-slow contexts (a CLI command, MCP
+ * boot) — never from a hook, which reads the cache and nothing else.
+ */
+export function maybeRefreshInBackground(home, now = Date.now(), env = process.env) {
+    const doNotTrack = env.DO_NOT_TRACK;
+    if (doNotTrack !== undefined && doNotTrack !== '' && doNotTrack !== '0')
+        return false;
+    const cache = readUpdateCache(home);
+    if (!needsRefresh(cache, now))
+        return false;
+    writeUpdateCache({ latest: cache?.latest ?? null, checkedAt: now }, home);
+    try {
+        const child = spawn(process.execPath, [graftCliPath(), '_update-check'], {
+            detached: true,
+            stdio: 'ignore',
+            windowsHide: true,
+        });
+        child.unref();
+        return true;
+    }
+    catch {
+        return false; // no spawn (sandbox, ENOMEM) — the nudge just uses the old cache
+    }
+}
+/** One line, or nothing. Nothing is the common case — don't spend context on
+ * "you're up to date". */
+export function formatUpdateNudge(current, latest) {
+    if (!isNewer(latest, current))
+        return null;
+    // `upgrade`, not a bare npm install: under graft it brings the trail command along.
+    return `⬆ ${brand()} ${current} → ${latest} available: run \`${brand()} upgrade\` (restart your agent after).`;
+}
+export const DEFAULT_WIRING_OPTS = { global: true, mcp: true, hooks: true, statusline: true };
+/** An older stamp has no `opts`; a plain `graft init` wired everything. */
+export function wiringOpts(stamp) {
+    return { ...DEFAULT_WIRING_OPTS, ...(stamp?.opts ?? {}) };
+}
+/** Under `graft/.cache/`, beside the other derived state: git-ignored, per-clone,
+ * and cheap to lose — a missing stamp just means one idempotent refresh. */
+export function stampPath(repo) {
+    return join(cacheDir(repo), 'wiring-stamp.json');
+}
+export function readStamp(repo) {
+    return readJson(stampPath(repo));
+}
+export function writeStamp(repo, version, hosts, opts = {}, at = new Date().toISOString()) {
+    try {
+        writeJsonAtomic(stampPath(repo), {
+            version,
+            hosts: [...hosts].sort(),
+            opts: { ...DEFAULT_WIRING_OPTS, ...opts },
+            at,
+        });
+    }
+    catch { /* unwritable graft/ — a refresh will just be retried next session */ }
+}
+/**
+ * Which agents this repo is *already* wired for, read off disk rather than
+ * re-detected. Detection answers "which editors does this machine have"; for a
+ * refresh we need "which files did a previous init actually write" — otherwise
+ * installing Windsurf once would silently add graft rules to every repo.
+ */
+export function wiredHostIds(repo) {
+    const ids = [];
+    if (existsSync(join(repo, '.trail', 'hook.cjs')) || ['graft', 'trail'].some((n) => existsSync(join(repo, '.claude', 'helpers', `${n}-hooks.cjs`))))
+        ids.push('claude');
+    for (const host of HOSTS) {
+        // Under either name: a repo on trail has trail's files and blocks.
+        const wired = ['graft', 'trail'].some((n) => {
+            const path = join(repo, hostRelPath(host, n));
+            if (!existsSync(path))
+                return false;
+            // A shared file (AGENTS.md, GEMINI.md) counts only if graft's fenced section
+            // is in it — the user may own the file for entirely unrelated reasons.
+            if (host.kind === 'section') {
+                try {
+                    return readFileSync(path, 'utf8').includes(markersFor(n).start);
+                }
+                catch {
+                    return false;
+                }
+            }
+            return true;
+        });
+        if (wired)
+            ids.push(host.id);
+    }
+    return ids;
+}
+/**
+ * Re-run init's writes when the stamp and the running binary disagree.
+ *
+ * Deliberately narrow: it refreshes the hosts already wired, replays the flags
+ * that init was given, never builds the graph (this runs at session start — a
+ * rebuild there would stall the agent's first turn), and no-ops when the repo has
+ * no graft wiring at all.
+ *
+ * `toTrail` says whether this repo should move from graft's wiring to trail's
+ * (see upkeep-run.ts). When it should, the refresh runs whatever the stamp says:
+ * the person installed trail, which is the signal, whether or not graft's own
+ * version moved.
+ */
+export function reconcileWiring(repo, current, deps) {
+    try {
+        const stamp = readStamp(repo);
+        const toTrail = deps.toTrail?.(repo) ?? false;
+        if (stamp && stamp.version === current && !toTrail)
+            return null;
+        // The stamp is the record of *intent* (what the picker chose); disk is the
+        // fallback for repos wired before stamps existed. Union, not just disk:
+        // otherwise a host whose rule file went missing — deleted by hand, lost to a
+        // merge, or clobbered by another tool — is silently dropped from every future
+        // refresh, and that file is precisely what a refresh exists to restore.
+        const onDisk = (deps.wired ?? wiredHostIds)(repo);
+        const hosts = [...new Set([...(stamp?.hosts ?? []), ...onDisk])].sort();
+        if (hosts.length === 0)
+            return null; // never wired here — not our business
+        const opts = wiringOpts(stamp);
+        deps.rewrite(repo, hosts, opts, toTrail);
+        writeStamp(repo, current, hosts, opts);
+        return { from: stamp?.version ?? 'unwired', to: current, hosts, global: opts.global, ...(toTrail ? { switched: true } : {}) };
+    }
+    catch {
+        return null; // a refresh is an optimization; never fail the caller over it
+    }
+}
+export function formatWiringRefresh(r) {
+    if (!r)
+        return null;
+    // Said to the agent at session start, which is who can tell the person.
+    if (r.switched)
+        return (`[trail] graft is now trail, and this repo just moved to it: the same commands under the new name, plus learnings in .trail/learnings/ for everyone working in this repo. ` +
+            `Tell the user this once, in a line at the end of your first reply, and that committing .trail/ and .claude/settings.json once moves the repo over for everyone working in it.`);
+    // Name the out-of-repo writes explicitly: those are machine-wide and shared by
+    // every repo, so a user seeing this line should not have to guess what moved.
+    const scope = r.global && r.hosts.includes('agents') ? " (including this machine's ~/.codex config)" : '';
+    return `· graft refreshed this repo's agent wiring${scope} (written by ${r.from}, now ${r.to}): ${r.hosts.join(', ')}.`;
+}
+//# sourceMappingURL=upkeep.js.map

package/dist/upkeep.js.map

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

package/dist/util/actions-folder.d.ts

@@ -0,0 +1,2 @@
+export declare const actionsFolder: (top: string) => string;
+//# sourceMappingURL=actions-folder.d.ts.map

package/dist/util/actions-folder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"actions-folder.d.ts","sourceRoot":"","sources":["../../src/util/actions-folder.ts"],"names":[],"mappings":"AAQA,eAAO,MAAM,aAAa,GAAI,KAAK,MAAM,KAAG,MAA2C,CAAC"}

package/dist/util/actions-folder.js

@@ -0,0 +1,9 @@
+/**
+ * Where a checkout keeps its GitHub Actions files. It lives outside
+ * src/skills because the folder's name holds a word the skills copy never
+ * uses (phase 2 design rule 6, P22): copy calls it "this repo's GitHub
+ * Actions folder", never by its path.
+ */
+import { join } from 'node:path';
+export const actionsFolder = (top) => join(top, '.github', 'workflows');
+//# sourceMappingURL=actions-folder.js.map

package/dist/util/actions-folder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"actions-folder.js","sourceRoot":"","sources":["../../src/util/actions-folder.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,GAAW,EAAU,EAAE,CAAC,IAAI,CAAC,GAAG,EAAE,SAAS,EAAE,WAAW,CAAC,CAAC"}

package/dist/util/browser.d.ts

@@ -0,0 +1,3 @@
+/** Open `url` in the default browser. Best-effort: the printed URL is the fallback. */
+export declare function openBrowser(url: string): void;
+//# sourceMappingURL=browser.d.ts.map

package/dist/util/browser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"browser.d.ts","sourceRoot":"","sources":["../../src/util/browser.ts"],"names":[],"mappings":"AAEA,uFAAuF;AACvF,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAQ7C"}

package/dist/util/browser.js

@@ -0,0 +1,14 @@
+import { spawn } from "node:child_process";
+/** Open `url` in the default browser. Best-effort: the printed URL is the fallback. */
+export function openBrowser(url) {
+    if (process.env.GRAFT_NO_BROWSER)
+        return;
+    const opener = process.platform === "darwin" ? "open" : process.platform === "win32" ? "start" : "xdg-open";
+    try {
+        spawn(opener, [url], { stdio: "ignore", detached: true, shell: process.platform === "win32" }).unref();
+    }
+    catch {
+        /* the printed URL is the fallback */
+    }
+}
+//# sourceMappingURL=browser.js.map

package/dist/util/browser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"browser.js","sourceRoot":"","sources":["../../src/util/browser.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAE3C,uFAAuF;AACvF,MAAM,UAAU,WAAW,CAAC,GAAW;IACrC,IAAI,OAAO,CAAC,GAAG,CAAC,gBAAgB;QAAE,OAAO;IACzC,MAAM,MAAM,GAAG,OAAO,CAAC,QAAQ,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,QAAQ,KAAK,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,UAAU,CAAC;IAC5G,IAAI,CAAC;QACH,KAAK,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,EAAE,EAAE,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE,KAAK,EAAE,OAAO,CAAC,QAAQ,KAAK,OAAO,EAAE,CAAC,CAAC,KAAK,EAAE,CAAC;IACzG,CAAC;IAAC,MAAM,CAAC;QACP,qCAAqC;IACvC,CAAC;AACH,CAAC"}

package/dist/util/child-process.d.ts

@@ -0,0 +1,15 @@
+/**
+ * windowsHide option for child_process calls.
+ * Spread into execFileSync / spawnSync options to suppress CMD windows on Windows.
+ *
+ * Usage: execFileSync("git", args, { encoding: "utf8", ...WINHIDE, ... })
+ *
+ * On Linux/macOS this is an empty object — no effect.
+ * On Windows this adds windowsHide: true to every child_process call,
+ * preventing the 100+ CMD flashes that appear during `trail init` on a
+ * workspace with many repos (each git/gh call was opening a console window).
+ */
+export declare const WINHIDE: {
+    windowsHide?: true;
+};
+//# sourceMappingURL=child-process.d.ts.map

package/dist/util/child-process.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"child-process.d.ts","sourceRoot":"","sources":["../../src/util/child-process.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,eAAO,MAAM,OAAO;kBAEM,IAAI;CAAE,CAAC"}

package/dist/util/child-process.js

@@ -0,0 +1,15 @@
+/**
+ * windowsHide option for child_process calls.
+ * Spread into execFileSync / spawnSync options to suppress CMD windows on Windows.
+ *
+ * Usage: execFileSync("git", args, { encoding: "utf8", ...WINHIDE, ... })
+ *
+ * On Linux/macOS this is an empty object — no effect.
+ * On Windows this adds windowsHide: true to every child_process call,
+ * preventing the 100+ CMD flashes that appear during `trail init` on a
+ * workspace with many repos (each git/gh call was opening a console window).
+ */
+export const WINHIDE = process.platform === "win32"
+    ? { windowsHide: true }
+    : {};
+//# sourceMappingURL=child-process.js.map

package/dist/util/child-process.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"child-process.js","sourceRoot":"","sources":["../../src/util/child-process.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,MAAM,CAAC,MAAM,OAAO,GAAG,OAAO,CAAC,QAAQ,KAAK,OAAO;IACjD,CAAC,CAAC,EAAE,WAAW,EAAE,IAAa,EAAE;IAChC,CAAC,CAAC,EAA4B,CAAC"}