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

package/dist/hosts/claude-global.js

@@ -0,0 +1,230 @@
+/**
+ * User-level install for Claude Code: the copy of graft's wiring that lives
+ * outside every repo.
+ *
+ * Why this exists. Everything `graft init` writes for Claude Code lands *in* the
+ * repo — `.mcp.json` and `.claude/settings.json`. A `.gitignore` is free to ignore
+ * both, and `git worktree add` checks out tracked files only, so a worktree of such
+ * a repo starts with graft's shims present and neither of the two files that *point
+ * at* them. No settings.json means no SessionStart hook; no `.mcp.json` means no
+ * tool server. graft is absent, silently, in a tree that looks correctly wired.
+ *
+ * graft already carries the repair for exactly that — `reconcileWiring` rewrites
+ * both files — and it is unreachable here: `runUpkeep` is called only from the hook
+ * and from the MCP server, which are the two things that are missing. Seeding can't
+ * help either, since it runs on the query path, which needs the server.
+ *
+ * So the fix cannot live in the repo. `~/.claude/` is not in anyone's working tree,
+ * no `.gitignore` reaches it, and Claude Code reads it for every project — worktrees
+ * included. Codex has been installed this way from the start (see ./codex-hooks.ts,
+ * whose own note says the entries "fire in every repo opened with Codex, not just
+ * this one"); Claude Code was the one host graft wired repo-only. This module closes
+ * that gap, and is a deliberate mirror of that file.
+ *
+ * The repo-level writes stay exactly as they were. A project that has its own
+ * `.mcp.json` and settings keeps using them; this is the floor underneath, not a
+ * replacement.
+ */
+import { writeFileSync } from 'node:fs';
+import { join } from 'node:path';
+import { readJsonObject } from './config-write.js';
+import { mergeJsonKey, serverEntry } from './mcp-config.js';
+/** The directory the user-level shim lives in — the base every hook command names. */
+export function globalHelpersDir(home) {
+    return join(home, '.claude', 'helpers');
+}
+/**
+ * The files a user-level install would touch — pure, no writes, so `--dry-run` and
+ * the picker can report them up front. All three are scoped 'global': they apply to
+ * every project opened with Claude Code, not just this one.
+ *
+ * `~/.claude.json` holds the *user* MCP scope — the top-level `mcpServers` map, the
+ * one `claude mcp add --scope user` writes. Not to be confused with the same file's
+ * `projects["<abs path>"].mcpServers`, which is `--scope local` and per-directory:
+ * a worktree is its own project entry there, so a local registration would miss it
+ * for precisely the same reason the repo file does.
+ */
+export function claudeGlobalTargets(home, brand = 'graft') {
+    const g = (id, path, kind, what) => ({ hostId: 'claude', id, path, scope: 'global', kind, what });
+    const writes = [
+        g('claude-global-shim', join(globalHelpersDir(home), 'graft-hooks.cjs'), 'hook', 'hooks shim (user level)'),
+        g('claude-global-hooks', join(home, '.claude', 'settings.json'), 'hook', 'SessionStart / UserPromptSubmit / PreToolUse / PostToolUse / PostToolUseFailure / Stop / SessionEnd'),
+        g('claude-global-mcp', join(home, '.claude.json'), 'mcp', `mcpServers.${brand}`),
+    ];
+    // trail registers no server for Claude Code: the hooks and the `trail` command do its work.
+    return brand === 'trail' ? writes.slice(0, 2) : writes;
+}
+/** Hooks writing removed in trail-solo-grafo change. Kept as stub for retract compatibility. */
+function upsertGlobalHooks(_id, _path, _helpers) {
+    return { id: _id, path: _path, action: 'unchanged' };
+}
+/**
+ * Install the user-level copy: only the user-scope MCP registration.
+ * Hook shim and settings removed in trail-solo-grafo change.
+ *
+ * Best-effort by contract: a failure is reported as an action, never raised.
+ */
+export function installClaudeGlobal(home, brand = 'graft') {
+    const mcp = { id: 'claude-global-mcp', path: join(home, '.claude.json') };
+    const out = [];
+    // trail: drop the user server (we don't register trail globally via MCP).
+    if (brand === 'trail') {
+        out.push(dropUserServer(mcp.id, mcp.path, 'trail', isBrainsServer));
+        return out;
+    }
+    try {
+        out.push(mergeJsonKey(mcp.id, mcp.path, 'mcpServers', serverEntry({ brand }), brand));
+    }
+    catch {
+        out.push({ id: mcp.id, path: mcp.path, action: 'skipped-unparseable' });
+    }
+    return out;
+}
+/** Remove one user-scope server from `~/.claude.json`, leaving everything else; `keep` spares an entry it accepts. */
+function dropUserServer(id, path, name, keep) {
+    try {
+        const loaded = readJsonObject(path);
+        if (loaded === 'unparseable')
+            return { id, path, action: 'skipped-unparseable' };
+        const servers = loaded.root.mcpServers;
+        if (!servers || typeof servers !== 'object' || !(name in servers))
+            return { id, path, action: 'unchanged' };
+        if (keep?.(servers[name]))
+            return { id, path, action: 'unchanged' };
+        delete servers[name];
+        writeFileSync(path, `${JSON.stringify(loaded.root, null, 2)}\n`);
+        return { id, path, action: 'updated' };
+    }
+    catch {
+        return { id, path, action: 'skipped-unparseable' };
+    }
+}
+/**
+ * In a repo wired for trail, Claude Code would list graft's user-level server
+ * beside the repo's own `trail` one: the same tools twice. Claude Code keeps a
+ * per-folder switch for that, `projects["<folder>"].disabledMcpServers` in
+ * `~/.claude.json` (what /mcp sets), so graft goes off for this folder only
+ * and keeps serving every repo still wired as graft. Nothing to do when graft
+ * has no user-level server. Best-effort, like every writer here.
+ */
+export function disableGraftServerIn(home, folder) {
+    const id = 'claude-folder-graft-off';
+    const path = join(home, '.claude.json');
+    try {
+        const loaded = readJsonObject(path);
+        if (loaded === 'unparseable')
+            return { id, path, action: 'skipped-unparseable' };
+        const root = loaded.root;
+        if (!root.mcpServers?.graft)
+            return { id, path, action: 'unchanged' };
+        const projects = (root.projects ??= {});
+        const here = (projects[folder] ??= {});
+        const off = Array.isArray(here.disabledMcpServers) ? here.disabledMcpServers : [];
+        if (off.includes('graft'))
+            return { id, path, action: 'unchanged' };
+        here.disabledMcpServers = [...off, 'graft'];
+        writeFileSync(path, `${JSON.stringify(root, null, 2)}\n`);
+        return { id, path, action: 'updated' };
+    }
+    catch {
+        return { id, path, action: 'skipped-unparseable' };
+    }
+}
+/**
+ * A repo wired for trail commits `.mcp.json` with a `trail mcp` server. On a
+ * teammate's machine that has graft but not the trail command, that server
+ * can't start. So this folder gets a server of the same name, in Claude Code's
+ * per-folder scope (which wins over the project's), that runs `graft mcp`: the
+ * same program. graft's own user-level server goes off here, so the tools
+ * aren't listed twice. Once `trail` is installed, the per-folder one goes and
+ * the committed one runs. Takes effect from the next session in the folder.
+ */
+export function fitTrailServerToMachine(home, folder, has) {
+    const id = 'claude-folder-trail-server';
+    const path = join(home, '.claude.json');
+    try {
+        const loaded = readJsonObject(path);
+        if (loaded === 'unparseable')
+            return { id, path, action: 'skipped-unparseable' };
+        const root = loaded.root;
+        const here = root.projects?.[folder];
+        const ours = here?.mcpServers?.trail?.command === 'graft';
+        if (has.trail) {
+            if (!ours)
+                return { id, path, action: 'unchanged' };
+            delete here.mcpServers.trail;
+        }
+        else if (has.graft && !ours) {
+            const projects = (root.projects ??= {});
+            const p = (projects[folder] ??= {});
+            p.mcpServers = { ...(p.mcpServers ?? {}), trail: { command: 'graft', args: ['mcp'] } };
+            if (root.mcpServers?.graft) {
+                const off = Array.isArray(p.disabledMcpServers) ? p.disabledMcpServers : [];
+                if (!off.includes('graft'))
+                    p.disabledMcpServers = [...off, 'graft'];
+            }
+        }
+        else {
+            return { id, path, action: 'unchanged' };
+        }
+        writeFileSync(path, `${JSON.stringify(root, null, 2)}\n`);
+        return { id, path, action: 'updated' };
+    }
+    catch {
+        return { id, path, action: 'skipped-unparseable' };
+    }
+}
+/* -------------------------------------------------------------------------- */
+/* the workspace's tools and skills, for Claude Code                          */
+/* -------------------------------------------------------------------------- */
+/** The flag that makes `trail mcp` serve only the workspace's tools (named before they were more than brains). */
+export const BRAINS_FLAG = '--brains';
+/** Whether a user-scope `trail` entry is the workspace-only server (`trail mcp --brains`). */
+export function isBrainsServer(entry) {
+    const args = entry?.args;
+    return Array.isArray(args) && args.includes(BRAINS_FLAG);
+}
+/**
+ * Once this machine is connected to a Trail workspace, Claude Code gets one
+ * `trail` entry at the user MCP scope (`~/.claude.json`, every project): a
+ * server that passes the workspace's own MCP server through (its tools,
+ * prompts and instructions; see mcp/connector.ts). trail gives Claude
+ * Code no repo-tools server (its hooks and the `trail` command do that work),
+ * so this one lists the workspace's tools and nothing else. Best-effort.
+ */
+export function installBrainsServer(home) {
+    const id = 'claude-global-brains';
+    const path = join(home, '.claude.json');
+    try {
+        const { command, args } = serverEntry({ brand: 'trail' });
+        return mergeJsonKey(id, path, 'mcpServers', { command, args: [...args, BRAINS_FLAG] }, 'trail');
+    }
+    catch {
+        return { id, path, action: 'skipped-unparseable' };
+    }
+}
+/** Take the workspace server out again (`trail logout`). Leaves any other `trail` entry alone. */
+export function removeBrainsServer(home) {
+    return dropUserServer('claude-global-brains', join(home, '.claude.json'), 'trail', (e) => !isBrainsServer(e));
+}
+/**
+ * The same workspace-only server for Cursor, in its user-level
+ * `~/.cursor/mcp.json`, so every project opened in Cursor has the workspace's
+ * tools. A repo's own `.cursor/mcp.json` entry (from `trail init`) wins there.
+ */
+export function installCursorBrainsServer(home) {
+    const id = 'cursor-global-brains';
+    const path = join(home, '.cursor', 'mcp.json');
+    try {
+        const { command, args } = serverEntry({ brand: 'trail' });
+        return mergeJsonKey(id, path, 'mcpServers', { command, args: [...args, BRAINS_FLAG] }, 'trail');
+    }
+    catch {
+        return { id, path, action: 'skipped-unparseable' };
+    }
+}
+/** Take Cursor's workspace server out again (`trail logout`). */
+export function removeCursorBrainsServer(home) {
+    return dropUserServer('cursor-global-brains', join(home, '.cursor', 'mcp.json'), 'trail', (e) => !isBrainsServer(e));
+}
+//# sourceMappingURL=claude-global.js.map

package/dist/hosts/claude-global.js.map

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

package/dist/hosts/config-write.d.ts

@@ -0,0 +1,36 @@
+/** The result of one config/shim write, reported by every installer and by MCP
+ *  registration so they speak the same vocabulary. `McpWrite` aliases this. */
+export interface ConfigWrite {
+    id: string;
+    path: string;
+    action: 'created' | 'updated' | 'unchanged' | 'skipped-unparseable';
+}
+/**
+ * Write a graft-owned file, idempotently: unchanged when the content already
+ * matches (only re-applying `mode` if it drifted), else created/updated. `mode`
+ * is applied on POSIX; on Windows the exec bit does not exist and is skipped by
+ * the caller's expectations.
+ */
+export declare function writeOwned(id: string, path: string, content: string, mode?: number): ConfigWrite;
+/** Whether a hooks-config entry is one graft installed (so an upgrade replaces
+ *  it in place instead of stacking a second copy next to the stale one). The
+ *  `?? ''` guards a stray `undefined` entry: `JSON.stringify(undefined)` is
+ *  `undefined`, whose `.includes` would throw. */
+export declare function isGraftEntry(entry: unknown): boolean;
+/**
+ * Load a JSON config that graft is about to merge into, distinguishing the three
+ * outcomes an installer must treat differently:
+ *   - missing → `{ root: {}, existed: false }`: start fresh, this is a create.
+ *   - a plain object → `{ root, existed: true }`: merge into it.
+ *   - anything else (parse error, or a top-level array/null/primitive) →
+ *     `'unparseable'`: leave the file exactly as the user left it.
+ *
+ * Deliberately NOT `readJson` from `util/state.ts`, which returns `null` for both
+ * missing and unparseable — collapsing those two would let a create silently
+ * clobber a hand-edited broken `hooks.json`.
+ */
+export declare function readJsonObject(path: string): {
+    root: Record<string, any>;
+    existed: boolean;
+} | 'unparseable';
+//# sourceMappingURL=config-write.d.ts.map

package/dist/hosts/config-write.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-write.d.ts","sourceRoot":"","sources":["../../src/hosts/config-write.ts"],"names":[],"mappings":"AAWA;+EAC+E;AAC/E,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,SAAS,GAAG,SAAS,GAAG,WAAW,GAAG,qBAAqB,CAAC;CACrE;AAED;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,WAAW,CAUhG;AAED;;;kDAGkD;AAClD,wBAAgB,YAAY,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAGpD;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,cAAc,CAC5B,IAAI,EAAE,MAAM,GACX;IAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAAC,OAAO,EAAE,OAAO,CAAA;CAAE,GAAG,aAAa,CAUjE"}

package/dist/hosts/config-write.js

@@ -0,0 +1,64 @@
+/**
+ * Shared helpers for the host config writers. Both the hook installers (Codex,
+ * user-level under `~/.codex`; Cursor, repo-local under `.cursor`) and the MCP
+ * registration merge graft entries into a JSON config, own a generated shim, and
+ * describe the outcome with the same little result record. The file-owning write,
+ * the graft-entry test, and the load-or-skip JSON open are identical across them;
+ * the merge itself differs per host, so only the genuinely-shared pieces live here.
+ */
+import { readFileSync, writeFileSync, mkdirSync, existsSync, chmodSync, statSync } from 'node:fs';
+import { dirname } from 'node:path';
+/**
+ * Write a graft-owned file, idempotently: unchanged when the content already
+ * matches (only re-applying `mode` if it drifted), else created/updated. `mode`
+ * is applied on POSIX; on Windows the exec bit does not exist and is skipped by
+ * the caller's expectations.
+ */
+export function writeOwned(id, path, content, mode) {
+    const existed = existsSync(path);
+    if (existed && readFileSync(path, 'utf8') === content) {
+        if (mode !== undefined && (statSync(path).mode & 0o777) !== mode)
+            chmodSync(path, mode);
+        return { id, path, action: 'unchanged' };
+    }
+    mkdirSync(dirname(path), { recursive: true });
+    writeFileSync(path, content);
+    if (mode !== undefined)
+        chmodSync(path, mode);
+    return { id, path, action: existed ? 'updated' : 'created' };
+}
+/** Whether a hooks-config entry is one graft installed (so an upgrade replaces
+ *  it in place instead of stacking a second copy next to the stale one). The
+ *  `?? ''` guards a stray `undefined` entry: `JSON.stringify(undefined)` is
+ *  `undefined`, whose `.includes` would throw. */
+export function isGraftEntry(entry) {
+    const s = JSON.stringify(entry ?? '');
+    return s.includes('graft-hooks.cjs') || s.includes('trail-hooks.cjs') || s.includes('/.trail/hook.cjs');
+}
+/**
+ * Load a JSON config that graft is about to merge into, distinguishing the three
+ * outcomes an installer must treat differently:
+ *   - missing → `{ root: {}, existed: false }`: start fresh, this is a create.
+ *   - a plain object → `{ root, existed: true }`: merge into it.
+ *   - anything else (parse error, or a top-level array/null/primitive) →
+ *     `'unparseable'`: leave the file exactly as the user left it.
+ *
+ * Deliberately NOT `readJson` from `util/state.ts`, which returns `null` for both
+ * missing and unparseable — collapsing those two would let a create silently
+ * clobber a hand-edited broken `hooks.json`.
+ */
+export function readJsonObject(path) {
+    if (!existsSync(path))
+        return { root: {}, existed: false };
+    let root;
+    try {
+        root = JSON.parse(readFileSync(path, 'utf8'));
+    }
+    catch {
+        return 'unparseable';
+    }
+    if (typeof root !== 'object' || root === null || Array.isArray(root))
+        return 'unparseable';
+    return { root: root, existed: true };
+}
+//# sourceMappingURL=config-write.js.map

package/dist/hosts/config-write.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-write.js","sourceRoot":"","sources":["../../src/hosts/config-write.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,SAAS,EAAE,UAAU,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAClG,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAUpC;;;;;GAKG;AACH,MAAM,UAAU,UAAU,CAAC,EAAU,EAAE,IAAY,EAAE,OAAe,EAAE,IAAa;IACjF,MAAM,OAAO,GAAG,UAAU,CAAC,IAAI,CAAC,CAAC;IACjC,IAAI,OAAO,IAAI,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,KAAK,OAAO,EAAE,CAAC;QACtD,IAAI,IAAI,KAAK,SAAS,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,IAAI,GAAG,KAAK,CAAC,KAAK,IAAI;YAAE,SAAS,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;QACxF,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,CAAC;IAC3C,CAAC;IACD,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC9C,aAAa,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IAC7B,IAAI,IAAI,KAAK,SAAS;QAAE,SAAS,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;IAC9C,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS,EAAE,CAAC;AAC/D,CAAC;AAED;;;kDAGkD;AAClD,MAAM,UAAU,YAAY,CAAC,KAAc;IACzC,MAAM,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC;IACtC,OAAO,CAAC,CAAC,QAAQ,CAAC,iBAAiB,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,iBAAiB,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,kBAAkB,CAAC,CAAC;AAC1G,CAAC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,cAAc,CAC5B,IAAY;IAEZ,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC;QAAE,OAAO,EAAE,IAAI,EAAE,EAAE,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;IAC3D,IAAI,IAAa,CAAC;IAClB,IAAI,CAAC;QACH,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC;IAChD,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,aAAa,CAAC;IACvB,CAAC;IACD,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,KAAK,IAAI,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC;QAAE,OAAO,aAAa,CAAC;IAC3F,OAAO,EAAE,IAAI,EAAE,IAA2B,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;AAC9D,CAAC"}

package/dist/hosts/init.d.ts

@@ -0,0 +1,28 @@
+import type { Brand } from '../brand.js';
+import { type McpWrite } from './mcp-config.js';
+import type { ConfigWrite } from './config-write.js';
+export interface HostsInitResult {
+    written: {
+        id: string;
+        path: string;
+        action: string;
+    }[];
+    skipped: string[];
+    unknown: string[];
+    mcp: McpWrite[];
+    hooks: ConfigWrite[];
+}
+export declare function runHostsInit(repo: string, opts?: {
+    agents?: string[];
+    all?: boolean;
+    home?: string;
+    mcp?: boolean;
+    hooks?: boolean;
+    /** false → skip every write outside the repo (the ~/.codex/ targets). */
+    global?: boolean;
+    /** When given, only these hosts write outside the repo (`init --agents auto`: the agents installed here). */
+    laptop?: string[];
+    /** The name `init` runs under; trail's moves the repo to trail's names (see `hostWiringName`). */
+    brand?: Brand;
+}): HostsInitResult;
+//# sourceMappingURL=init.d.ts.map

package/dist/hosts/init.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../src/hosts/init.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAsB,KAAK,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AACpE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAGrD,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IACxD,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,GAAG,EAAE,QAAQ,EAAE,CAAC;IAChB,KAAK,EAAE,WAAW,EAAE,CAAC;CACtB;AA4BD,wBAAgB,YAAY,CAC1B,IAAI,EAAE,MAAM,EACZ,IAAI,GAAE;IACJ,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,yEAAyE;IACzE,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,6GAA6G;IAC7G,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,kGAAkG;IAClG,KAAK,CAAC,EAAE,KAAK,CAAC;CACV,GACL,eAAe,CA6CjB"}

package/dist/hosts/init.js

@@ -0,0 +1,89 @@
+/**
+ * Multi-host init: write each selected host's instruction file.
+ * Selection = explicit ids > all > detected. Claude Code is handled
+ * separately by src/claude/init.ts (hooks + statusline + skill).
+ */
+import { statSync, writeFileSync, readFileSync, mkdirSync, existsSync, rmSync, rmdirSync } from 'node:fs';
+import { basename, dirname, join } from 'node:path';
+import { homedir } from 'node:os';
+import { HOSTS, detectHosts, hostRelPath, hostWiringName } from './registry.js';
+import { GRAFT_MARKERS, markersFor, upsertSection } from './sections.js';
+import { registerMcpConfigs } from './mcp-config.js';
+import { installAntigravitySkill } from './antigravity.js';
+function probeFor(home, repo) {
+    return {
+        home, repo,
+        dirExists: (p) => { try {
+            return statSync(p).isDirectory();
+        }
+        catch {
+            return false;
+        } },
+    };
+}
+function writeOwned(path, content) {
+    if (existsSync(path) && readFileSync(path, 'utf8') === content)
+        return 'unchanged';
+    mkdirSync(dirname(path), { recursive: true });
+    const existed = existsSync(path);
+    writeFileSync(path, content);
+    return existed ? 'replaced' : 'created';
+}
+/**
+ * A graft-named file a host owned, gone now that the repo uses trail's names,
+ * with its `graft/` folder when that was all the folder held.
+ */
+function removeGraftCopy(path) {
+    rmSync(path, { force: true });
+    if (basename(dirname(path)) === 'graft') {
+        try {
+            rmdirSync(dirname(path));
+        }
+        catch { /* not empty, or not there */ }
+    }
+}
+export function runHostsInit(repo, opts = {}) {
+    const home = opts.home ?? homedir();
+    const probe = probeFor(home, repo);
+    const name = hostWiringName(repo, opts.brand);
+    let selected;
+    let unknown = [];
+    if (opts.agents !== undefined) {
+        const byId = new Map(HOSTS.map((h) => [h.id, h]));
+        selected = opts.agents.flatMap((id) => byId.get(id) ?? []);
+        unknown = opts.agents.filter((id) => !byId.has(id));
+    }
+    else if (opts.all) {
+        selected = HOSTS;
+    }
+    else {
+        selected = detectHosts(probe);
+    }
+    const written = [];
+    for (const host of selected) {
+        const path = join(repo, hostRelPath(host, name));
+        // Under trail, graft's copy of an owned file goes and graft's fenced
+        // block becomes trail's, so the agent reads the instructions once.
+        const action = host.kind === 'owned'
+            ? writeOwned(path, host.content(name))
+            : upsertSection(path, host.content(name), markersFor(name), name === 'trail' ? [GRAFT_MARKERS] : []).action;
+        if (name === 'trail' && host.kind === 'owned')
+            removeGraftCopy(join(repo, host.relPath));
+        written.push({ id: host.id, path, action });
+    }
+    const skipped = HOSTS.filter((h) => !selected.includes(h)).map((h) => h.id);
+    // Whether `id` may write outside the repo on this run.
+    const outside = (id) => opts.global !== false && (opts.laptop === undefined || opts.laptop.includes(id));
+    const mcp = opts.mcp === false
+        ? []
+        : registerMcpConfigs(repo, selected.map((h) => h.id), { home, global: opts.global, name, laptop: opts.laptop });
+    // Hooks (Codex/Cursor) removed in trail-solo-grafo change.
+    const hooks = [];
+    const cursorHooks = [];
+    // Antigravity's skill is a global write too, so --no-global suppresses it as well.
+    const antigravitySkill = !outside('antigravity') || !selected.some((h) => h.id === 'antigravity')
+        ? []
+        : installAntigravitySkill(home, name);
+    return { written, skipped, unknown, mcp, hooks: [...hooks, ...cursorHooks, ...antigravitySkill] };
+}
+//# sourceMappingURL=init.js.map

package/dist/hosts/init.js.map

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

package/dist/hosts/instructions.d.ts

@@ -0,0 +1,14 @@
+/**
+ * The one canonical Graft instruction block, rendered into each host's
+ * native format. Content changes happen HERE only; renderers just wrap it.
+ *
+ * `name` is the repo's name for the tool (see `hostWiringName`): a repo wired
+ * by trail gets the same text in trail's spelling, so an agent on a machine
+ * with only `trail` installed is never told to run `graft`.
+ */
+import type { Brand } from '../brand.js';
+export declare function instructionBody(name?: Brand): string;
+export declare function cursorRule(name?: Brand): string;
+export declare function kiroSteering(name?: Brand): string;
+export declare function windsurfRule(name?: Brand): string;
+//# sourceMappingURL=instructions.d.ts.map

package/dist/hosts/instructions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"instructions.d.ts","sourceRoot":"","sources":["../../src/hosts/instructions.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AAOzC,wBAAgB,eAAe,CAAC,IAAI,GAAE,KAAe,GAAG,MAAM,CAE7D;AAuED,wBAAgB,UAAU,CAAC,IAAI,GAAE,KAAe,GAAG,MAAM,CAOxD;AAED,wBAAgB,YAAY,CAAC,IAAI,GAAE,KAAe,GAAG,MAAM,CAM1D;AAED,wBAAgB,YAAY,CAAC,IAAI,GAAE,KAAe,GAAG,MAAM,CAG1D"}

package/dist/hosts/instructions.js

@@ -0,0 +1,95 @@
+import { trailSpelling } from '../claude/skill-template.js';
+function inName(text, name) {
+    return name === 'trail' ? trailSpelling(text) : text;
+}
+export function instructionBody(name = 'graft') {
+    return inName(graftBody(), name);
+}
+function graftBody() {
+    return `## Graft — repo context graph
+
+This repo is indexed in \`graft/\`: small linked markdown nodes that explain each
+system and carry exact file:line spans, kept in sync with the code through git.
+
+For ANY task here — understanding how something works, finding where code lives,
+or scoping a change — get context from the graph before grepping or opening
+source files. Re-ask freely (it's cheap) and reuse literal identifiers you
+already have (symbol, error string, file name) as the query. New to this repo?
+Run \`graft map\` first — a token-budgeted orientation (dir clusters, hubs,
+hotspots), no LLM, no key.
+
+- Run \`graft ask "<your question>" --source\` → ranked nodes with the relevant
+  code spans inlined (each hit's ≤8-line crux by default; \`--full\` for whole
+  definitions when the crux isn't enough). Match the tool to the task shape:
+  for understanding or editing, the top node IS the answer — cite its
+  \`covers:\` file:line spans and edit straight from \`--source\`. For
+  exhaustive tasks ("every occurrence / every caller of this pattern"), ranked
+  results are top-N, not complete — run \`graft grep "<literal>"\` instead
+  (exhaustive over indexed files, grouped by enclosing symbol), falling back
+  to raw \`grep -rn\` only for unindexed files.
+- \`graft skeleton <file>\` → every definition's signature + span, ~10× cheaper
+  than reading the file; use it to skim an API surface.
+- \`graft callers <symbol>\` gives precomputed, exact edges — who calls this.
+  Add \`--direction out\` for what it calls, or \`--depth N\` to walk
+  transitively for the full blast radius. For structural questions, skip
+  ranking and use this directly.
+- Or browse: \`graft/INDEX.md\` lists every node; follow the links.
+- Monorepos and folders of multiple repos rank fairly across sub-projects —
+  hits carry \`[scope/]\` labels naming which one they're from. Narrow with
+  \`graft ask "<task>" --in <scope>/\` once you know where you're working.
+  For compound-path repos (e.g. \`default-core/frontend\`) use the full path —
+  a partial first segment (\`--in default-core\`) is not a valid scope.
+
+If a returned span is truncated ("+N more lines"), open the file at that exact
+range before finalizing. Only open source files when a node genuinely lacks a
+needed detail, and then at the exact file:line the node points to — never
+re-read whole files.
+
+**The map keeps itself current.** Every query checks the working tree first and
+re-extracts up to 50 changed files before answering, so an edit you just made is
+already in the graph. More than that (a branch switch, a merge of someone else's
+work) is rebuilt in the background: the answer then starts with
+\`[stale: N files changed, rebuilding in background]\`, which means "this answer
+may predate the change — ask again in a moment". You do not have to run
+\`graft build\` after a merge; run it after a large change when you want the
+markdown cards and \`INDEX.md\` regenerate as well (deterministic, no API key, $0).
+
+**Worktrees need no setup.** A linked git worktree (\`.git\` is a file) has no map
+of its own, because the map lives in the git-ignored cache. The first query
+copies the main checkout's graph in and patches the difference between the two
+branches, so \`graft ask\` in a fresh worktree answers about that worktree's code
+— not the branch the main checkout happens to have. Nothing to run first.
+
+## Checklist before committing / pushing / opening a PR
+
+Run **in this order** before the first push on any branch:
+
+\`\`\`bash
+<typecheck>                              # e.g. tsc -b (TS), go vet, cargo check, mypy
+<lint>                                   # e.g. bun run lint / npm run lint
+<tests>                                  # e.g. npx vitest run <module>
+\`\`\`
+
+The code map is not a gate: it refreshes itself on the query path, so there is no
+\`build\`/\`check\` step to forget before a push.`;
+}
+export function cursorRule(name = 'graft') {
+    return inName(`---
+description: Use the Graft context graph in graft/ before exploring source
+alwaysApply: true
+---
+${graftBody()}
+`, name);
+}
+export function kiroSteering(name = 'graft') {
+    return inName(`---
+inclusion: always
+---
+${graftBody()}
+`, name);
+}
+export function windsurfRule(name = 'graft') {
+    return inName(`${graftBody()}
+`, name);
+}
+//# sourceMappingURL=instructions.js.map

package/dist/hosts/instructions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"instructions.js","sourceRoot":"","sources":["../../src/hosts/instructions.ts"],"names":[],"mappings":"AASA,OAAO,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAE5D,SAAS,MAAM,CAAC,IAAY,EAAE,IAAW;IACvC,OAAO,IAAI,KAAK,OAAO,CAAC,CAAC,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;AACvD,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,OAAc,OAAO;IACnD,OAAO,MAAM,CAAC,SAAS,EAAE,EAAE,IAAI,CAAC,CAAC;AACnC,CAAC;AAED,SAAS,SAAS;IAChB,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kDAiEyC,CAAC;AACnD,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,OAAc,OAAO;IAC9C,OAAO,MAAM,CAAC;;;;EAId,SAAS,EAAE;CACZ,EAAE,IAAI,CAAC,CAAC;AACT,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,OAAc,OAAO;IAChD,OAAO,MAAM,CAAC;;;EAGd,SAAS,EAAE;CACZ,EAAE,IAAI,CAAC,CAAC;AACT,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,OAAc,OAAO;IAChD,OAAO,MAAM,CAAC,GAAG,SAAS,EAAE;CAC7B,EAAE,IAAI,CAAC,CAAC;AACT,CAAC"}