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

package/dist/hosts/registry.js

@@ -0,0 +1,164 @@
+/**
+ * Registry of AI coding hosts Graft can write instructions for.
+ * Adding a host = adding one entry here (plus a renderer if it needs
+ * a new file format).
+ *
+ * kind: 'section' → upsert the fenced block into a shared file the user owns.
+ * kind: 'owned'   → graft owns the whole file; overwrite it each run.
+ */
+import { existsSync, readFileSync } from 'node:fs';
+import { join } from 'node:path';
+import { instructionBody, cursorRule, kiroSteering, windsurfRule } from './instructions.js';
+import { skillTemplate } from '../claude/skill-template.js';
+import { markersFor } from './sections.js';
+import { repoWiredForTrail } from '../brand.js';
+export const HOSTS = [
+    {
+        id: 'agents',
+        name: 'AGENTS.md hosts (Codex-style CLIs, editors that read AGENTS.md)',
+        kind: 'section',
+        relPath: 'AGENTS.md',
+        content: instructionBody,
+        detect: (p) => p.dirExists(join(p.home, '.codex')) ||
+            p.dirExists(join(p.home, '.config', 'opencode')) ||
+            p.dirExists(join(p.home, '.config', 'agents')),
+    },
+    {
+        id: 'adal',
+        name: 'AdaL',
+        kind: 'owned',
+        relPath: join('.adal', 'skills', 'graft', 'SKILL.md'),
+        content: skillTemplate,
+        detect: (p) => p.dirExists(join(p.home, '.adal')) || p.dirExists(join(p.repo, '.adal')),
+    },
+    {
+        id: 'cursor',
+        name: 'Cursor',
+        kind: 'owned',
+        relPath: join('.cursor', 'rules', 'graft.mdc'),
+        content: cursorRule,
+        detect: (p) => p.dirExists(join(p.home, '.cursor')) || p.dirExists(join(p.repo, '.cursor')),
+    },
+    {
+        id: 'gemini',
+        name: 'Gemini CLI',
+        kind: 'section',
+        relPath: 'GEMINI.md',
+        content: instructionBody,
+        detect: (p) => p.dirExists(join(p.home, '.gemini', 'config')),
+    },
+    {
+        id: 'grok',
+        name: 'Grok (xAI)',
+        kind: 'owned',
+        relPath: join('.grok', 'skills', 'graft', 'SKILL.md'),
+        content: skillTemplate,
+        detect: (p) => p.dirExists(join(p.home, '.grok')) || p.dirExists(join(p.repo, '.grok')),
+    },
+    {
+        id: 'hermes',
+        name: 'Hermes Agent (Nous Research)',
+        kind: 'section',
+        relPath: 'AGENTS.md',
+        content: instructionBody,
+        // Hermes is repo-aware: it reads AGENTS.md at the repo root (and the
+        // Graft-for-Hermes plugin keeps the graph fresh on every session start).
+        detect: (p) => p.dirExists(join(p.home, '.hermes')) ||
+            p.dirExists(join(p.home, 'AppData', 'Local', 'hermes')) ||
+            p.dirExists(join(p.repo, '.hermes')),
+    },
+    {
+        id: 'antigravity',
+        name: 'Google Antigravity',
+        kind: 'section',
+        relPath: 'AGENTS.md',
+        content: instructionBody,
+        // Antigravity-specific markers, NOT the bare `~/.gemini` (which is also Gemini CLI's):
+        // its global config dir (`~/.gemini/config/`, where mcp_config.json + hooks.json live)
+        // or a workspace `.agents/` dir. Keeps a plain Gemini-CLI user from auto-selecting it.
+        detect: (p) => p.dirExists(join(p.home, '.gemini', 'config')) ||
+            p.dirExists(join(p.home, '.gemini', 'antigravity-cli')) ||
+            p.dirExists(join(p.repo, '.agents')),
+    },
+    {
+        id: 'copilot',
+        name: 'GitHub Copilot',
+        kind: 'section',
+        relPath: join('.github', 'copilot-instructions.md'),
+        content: instructionBody,
+        detect: (p) => p.dirExists(join(p.repo, '.github')),
+    },
+    {
+        id: 'kiro',
+        name: 'Kiro',
+        kind: 'owned',
+        relPath: join('.kiro', 'steering', 'graft.md'),
+        content: kiroSteering,
+        detect: (p) => p.dirExists(join(p.home, '.kiro')) || p.dirExists(join(p.repo, '.kiro')),
+    },
+    {
+        id: 'windsurf',
+        name: 'Windsurf',
+        kind: 'owned',
+        relPath: join('.windsurf', 'rules', 'graft.md'),
+        content: windsurfRule,
+        detect: (p) => p.dirExists(join(p.home, '.codeium', 'windsurf')) || p.dirExists(join(p.repo, '.windsurf')),
+    },
+];
+export function hostIds() {
+    return HOSTS.map((h) => h.id);
+}
+export function detectHosts(probe) {
+    return HOSTS.filter((h) => h.detect(probe));
+}
+/**
+ * A host's file under `name`. A file the tool owns carries its name, like
+ * Claude Code's skill and shims do (`.cursor/rules/trail.mdc`,
+ * `.adal/skills/trail/SKILL.md`); a shared file is the same file either way.
+ */
+export function hostRelPath(host, name) {
+    return name === 'trail' && host.kind === 'owned' ? host.relPath.replace(/\bgraft\b/g, 'trail') : host.relPath;
+}
+/** Cursor's hooks shim is repo-local, so it carries the repo's name too. */
+export function cursorHookShimRelPath(name) {
+    return join('.cursor', 'hooks', `${name}-hooks.cjs`);
+}
+/**
+ * Whether another agent's files in `repo` are already under trail's names: a
+ * trail-named file, or a shared file holding trail's block.
+ */
+export function hostsWiredForTrail(repo) {
+    if (existsSync(join(repo, cursorHookShimRelPath('trail'))))
+        return true;
+    const seen = new Set();
+    for (const host of HOSTS) {
+        const path = join(repo, hostRelPath(host, 'trail'));
+        if (seen.has(path))
+            continue;
+        seen.add(path);
+        if (host.kind === 'owned') {
+            if (existsSync(path))
+                return true;
+            continue;
+        }
+        try {
+            if (readFileSync(path, 'utf8').includes(markersFor('trail').start))
+                return true;
+        }
+        catch {
+            /* not there */
+        }
+    }
+    return false;
+}
+/**
+ * The name the other agents' wiring goes by in `repo`, decided the way Claude
+ * Code's is (`wiringName` in claude/init.ts): trail's where `trail init` is
+ * wiring it now (`initBrand`) or the repo is already on trail, graft's
+ * everywhere else. Read from the repo, not the machine, so a teammate on
+ * graft refreshing the files writes the same ones and never flips them back.
+ */
+export function hostWiringName(repo, initBrand) {
+    return initBrand === 'trail' || repoWiredForTrail(repo) || hostsWiredForTrail(repo) ? 'trail' : 'graft';
+}
+//# sourceMappingURL=registry.js.map

package/dist/hosts/registry.js.map

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

package/dist/hosts/retract.d.ts

@@ -0,0 +1,47 @@
+import type { WriteScope } from './plan.js';
+/** What a retraction did to one target. */
+export type RetractAction = 
+/** graft's contribution was there and is now gone. */
+'removed'
+/** the whole file was graft's, so the file itself is gone. */
+ | 'deleted'
+/** nothing of graft's here. */
+ | 'absent'
+/** file exists but can't be parsed — left untouched rather than risk it. */
+ | 'skipped-unparseable';
+export interface Retraction {
+    /** The host this target belongs to, for grouping the report. */
+    hostId: string;
+    path: string;
+    /** Short human label for what was removed from that file. */
+    what: string;
+    scope: WriteScope;
+    action: RetractAction;
+}
+export interface RetractOpts {
+    home?: string;
+    /** false → report only, touch nothing. Defaults to false: a destructive
+     *  operation must be asked for, never assumed. */
+    apply?: boolean;
+    /** false → skip targets outside the repo (the ~/.codex and ~/.gemini writes). */
+    global?: boolean;
+    /** false → keep `graft/` and the ignore entries. `init` sets this: the cache is
+     *  regenerable but re-parsing a large repo costs minutes, and init is about to
+     *  use it. */
+    cache?: boolean;
+    /** Host ids about to be re-written, so their targets are left alone. `init`
+     *  passes its selection: retracting a file it is one step from rewriting is
+     *  pure churn (and would report every write as `created`). */
+    exclude?: string[];
+}
+/** What a retraction *would* remove. Pure — touches nothing. */
+export declare function planRetract(repo: string, opts?: RetractOpts): Retraction[];
+/**
+ * Remove graft's contribution from every target. Reports every target it
+ * considered, including the ones that were already clean, so a caller can show
+ * either the full sweep or just what changed.
+ */
+export declare function runRetract(repo: string, opts?: RetractOpts): Retraction[];
+/** The subset worth showing a user: targets that had something to remove. */
+export declare function changed(retractions: Retraction[]): Retraction[];
+//# sourceMappingURL=retract.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"retract.d.ts","sourceRoot":"","sources":["../../src/hosts/retract.ts"],"names":[],"mappings":"AAmCA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAM5C,2CAA2C;AAC3C,MAAM,MAAM,aAAa;AACvB,sDAAsD;AACpD,SAAS;AACX,8DAA8D;GAC5D,SAAS;AACX,+BAA+B;GAC7B,QAAQ;AACV,4EAA4E;GAC1E,qBAAqB,CAAC;AAE1B,MAAM,WAAW,UAAU;IACzB,gEAAgE;IAChE,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,6DAA6D;IAC7D,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,UAAU,CAAC;IAClB,MAAM,EAAE,aAAa,CAAC;CACvB;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd;sDACkD;IAClD,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,iFAAiF;IACjF,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB;;kBAEc;IACd,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB;;kEAE8D;IAC9D,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;CACpB;AA+aD,gEAAgE;AAChE,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,GAAE,WAAgB,GAAG,UAAU,EAAE,CAE9E;AAED;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,GAAE,WAAgB,GAAG,UAAU,EAAE,CAG7E;AAED,6EAA6E;AAC7E,wBAAgB,OAAO,CAAC,WAAW,EAAE,UAAU,EAAE,GAAG,UAAU,EAAE,CAE/D"}