@antomanc/aginit 0.5.0 → 0.6.0

package/src/adapters/trail.ts

@@ -0,0 +1,94 @@
+import fs from 'node:fs';
+import path from 'node:path';
+import { fileExists, readTextFile, safeWriteFile } from '../utils/fs.js';
+import { commandExists, runExecutable } from '../utils/shell.js';
+import { logger } from '../utils/logger.js';
+
+// The ripgrep hint graft wrote at the repo root; trail keeps its graph in .trail/cache.
+const GRAFT_RIPGREP_HINT =
+  "# graft's cards are gitignored but should stay greppable: ripgrep reads\n" +
+  '# .ignore before .gitignore, so this re-admits the tree to search only.\n' +
+  '!graft/\ngraft/.cache/\ngraft/.graph/\n';
+
+export async function isTrailInstalled(): Promise<boolean> {
+  return await commandExists('trail');
+}
+
+export async function initTrail(
+  targetDir: string,
+  options: { dryRun?: boolean; silent?: boolean; claude?: boolean } = {}
+): Promise<boolean> {
+  const { dryRun = false, silent = false, claude = true } = options;
+
+  const installed = dryRun || (await isTrailInstalled());
+  if (!installed) {
+    if (!silent) {
+      logger.warn(
+        'Trail CLI is not installed. Install it with `npm install -g @trailhq/trail-code`, then rerun aginit init.'
+      );
+    }
+    return false;
+  }
+
+  if (!silent) logger.dim('Initializing Trail context graph...');
+
+  // Wire Antigravity, AGENTS.md readers and (optionally) Claude Code's in-repo
+  // .claude/ + .trail/, without touching global system files (--no-global).
+  // trail init also migrates a repo graft wired before.
+  const agents = ['antigravity', 'agents', ...(claude ? ['claude'] : [])];
+  const res = await runExecutable(
+    'trail',
+    ['init', '--no-global', '--agents', ...agents, '-y'],
+    {
+      cwd: targetDir,
+      dryRun,
+      silent: true
+    }
+  );
+
+  if (!res.ok) {
+    logger.warn(`Trail initialization warning: ${res.stderr || res.stdout}`);
+    return false;
+  }
+
+  // trail init leaves graft's ripgrep hint behind; drop it when unedited.
+  const hint = path.join(targetDir, '.ignore');
+  if (!dryRun && readTextFile(hint) === GRAFT_RIPGREP_HINT) fs.rmSync(hint);
+
+  return true;
+}
+
+export async function buildTrail(
+  targetDir: string,
+  options: { dryRun?: boolean; silent?: boolean } = {}
+): Promise<boolean> {
+  const { dryRun = false } = options;
+  const installed = dryRun || (await isTrailInstalled());
+  if (!installed) return false;
+
+  const res = await runExecutable('trail', ['build'], { cwd: targetDir, dryRun, silent: true });
+  return res.ok;
+}
+
+export async function uninstallTrail(
+  targetDir: string,
+  options: { dryRun?: boolean; silent?: boolean } = {}
+): Promise<boolean> {
+  const { dryRun = false } = options;
+  const installed = dryRun || (await isTrailInstalled());
+  if (installed) {
+    await runExecutable('trail', ['uninstall'], { cwd: targetDir, dryRun, silent: true });
+  }
+
+  // Also clean up AGENTS.md fenced section if any remain (graft's included)
+  const agentsPath = path.join(targetDir, 'AGENTS.md');
+  if (fileExists(agentsPath)) {
+    const content = readTextFile(agentsPath) || '';
+    const cleaned = content
+      .replace(/<!-- (trail|graft):start -->[\s\S]*?<!-- \1:end -->\n?/g, '')
+      .trim();
+    safeWriteFile(agentsPath, cleaned + '\n', { overwrite: true, dryRun });
+  }
+
+  return true;
+}

package/src/cli/capabilities.ts

@@ -4,7 +4,7 @@ import { AGINIT_CONFIG_FILENAME, AginitConfig } from '../config/schema.js';
 import { readProjectConfig, validateConfig } from '../config/validation.js';
 import { resolvePlatformStack } from '../adapters/agent-docs.js';
 import { installAllSkills, removeSkills, skillAgents } from '../adapters/skills.js';
-import { uninstallGraft } from '../adapters/graft.js';
+import { uninstallTrail } from '../adapters/trail.js';
 import { ignoreVendoredSkills } from '../adapters/tool-ignores.js';
 import {
   activeIds,
@@ -121,8 +121,8 @@ export async function changeCapabilities(
   const next = validateConfig(
     applyResolvedProfile({ ...config, platform, stack }, resolved, { skills: true, previous })
   );
-  // Adding graft or playwright turns their legacy switch back on.
-  if (next.capabilities?.includes('graft')) next.codebase.graft = true;
+  // Adding trail or playwright turns their legacy switch back on.
+  if (next.capabilities?.includes('trail')) next.codebase.trail = true;
 
   const after = activeIds(next);
   const nextCatalog = catalogFor(next);
@@ -141,9 +141,9 @@ export async function changeCapabilities(
   let ok = true;
 
   ok = (await removeSkills(targetDir, skillsOf(removed), { dryRun, silent })) && ok;
-  if (removed.some((c) => c.id === 'graft')) await uninstallGraft(targetDir, { dryRun, silent });
+  if (removed.some((c) => c.id === 'trail')) await uninstallTrail(targetDir, { dryRun, silent });
   const leftovers = removed.filter((c) =>
-    c.install.some((s) => s.kind === 'setup' && s.setup !== 'graft')
+    c.install.some((s) => s.kind === 'setup' && s.setup !== 'trail')
   );
   if (!silent)
     for (const c of leftovers)
@@ -166,7 +166,7 @@ export async function changeCapabilities(
 
   syncAgentDocs(targetDir, next, { dryRun, silent });
   if (!silent)
-    for (const { name, bin, install } of await missingBinaries(added, ['graft', 'agent-browser', 'e2e']))
+    for (const { name, bin, install } of await missingBinaries(added, ['trail', 'agent-browser', 'e2e']))
       logger.warn(`${name} needs the \`${bin}\` CLI: ${install}`);
   if (!silent) {
     if (ok) logger.success('Capabilities updated. AGENTS.md and docs/agents/ are in sync.');

package/src/cli/doctor.ts

@@ -15,7 +15,7 @@ import {
   getInstalledSkills,
   getSkillsMissingForClaude
 } from '../adapters/skills.js';
-import { claudeMarkdownImportsAgents } from '../adapters/agents-md.js';
+import { AGINIT_START_PATTERN, claudeMarkdownImportsAgents } from '../adapters/agents-md.js';
 import {
   agentBrowserStubInstalled,
   findUsernsRestriction,
@@ -229,21 +229,21 @@ export async function runDoctor(targetDir: string = process.cwd()): Promise<void
   const agentsPath = path.join(targetDir, 'AGENTS.md');
   const agentsExists = fileExists(agentsPath);
   const agentsContent = agentsExists ? readTextFile(agentsPath) || '' : '';
-  const hasIntakeSection = agentsContent.includes('Bootstrap & First Session');
+  const hasBlock = AGINIT_START_PATTERN.test(agentsContent);
 
   checks.push({
     name: 'AGENTS.md Context',
     category: 'Project Config',
-    ok: agentsExists && hasIntakeSection,
+    ok: agentsExists && hasBlock,
     detail: agentsExists
-      ? hasIntakeSection
-        ? 'AGENTS.md present with intake/bootstrap guidance'
-        : 'AGENTS.md present but missing intake guidance'
+      ? hasBlock
+        ? 'AGENTS.md present with the aginit block'
+        : 'AGENTS.md present but missing the aginit block'
       : 'AGENTS.md not found in directory',
     suggestion: !agentsExists
       ? 'Run `aginit init` to generate standard AGENTS.md'
-      : !hasIntakeSection
-        ? 'Run `aginit init` to add intake section to AGENTS.md'
+      : !hasBlock
+        ? 'Run `aginit init` to add the aginit block to AGENTS.md'
         : undefined
   });
 

package/src/cli/main.ts

@@ -5,7 +5,7 @@ import { initCurrentDirectory } from './init.js';
 import { runDoctor } from './doctor.js';
 import { ensureClaudeSkillLinks, updateSkills } from '../adapters/skills.js';
 import { ignoreVendoredSkills } from '../adapters/tool-ignores.js';
-import { buildGraft } from '../adapters/graft.js';
+import { buildTrail } from '../adapters/trail.js';
 import { readProjectConfig } from '../config/validation.js';
 import { logger } from '../utils/logger.js';
 import { PresetType, WebFramework, PackageManager } from '../config/schema.js';
@@ -50,7 +50,7 @@ function withProfileOptions(command: Command): Command {
     .option('--ui-driver <driver>', 'UI driver: auto | agent-browser | agent-device | none')
     .option('--addons <ids>', 'Add-ons: context-mode, worktrunk, chrome-devtools-mcp, browserskill', list)
     .option('--add-skill <owner/repo>', 'Add a skill repository as a custom capability (repeatable)', list)
-    .option('--without <id>', 'Disable a capability, e.g. graft or humanizer (repeatable)', list);
+    .option('--without <id>', 'Disable a capability, e.g. trail or humanizer (repeatable)', list);
 }
 
 function profileFlags(options: any): ProfileFlags {
@@ -78,7 +78,7 @@ export function createCliProgram(): Command {
     .option('-f, --framework <framework>', 'Web framework: none | vite | next | existing')
     .option('-m, --package-manager <pm>', 'Package manager: pnpm | npm | yarn | bun')
     .option('--no-skills', 'Skip installing AI skills')
-    .option('--no-graft', 'Skip codebase graph (Graft) setup')
+    .option('--no-trail', 'Skip codebase graph (Trail) setup')
     .option('--no-git', 'Skip git repository initialization')
     .option('--dry-run', 'Simulate setup without writing changes to disk')
     .option('-y, --yes', 'Initialize the current directory without prompts (saved or detected settings)');
@@ -101,7 +101,7 @@ export function createCliProgram(): Command {
       framework: options.framework as WebFramework | undefined,
       packageManager: options.packageManager as PackageManager | undefined,
       skills: options.skills,
-      graft: options.graft,
+      trail: options.trail,
       git: options.git,
       dryRun: options.dryRun,
       profile: profileFlags(options)
@@ -117,7 +117,7 @@ export function createCliProgram(): Command {
     .option('-f, --framework <framework>', 'Web framework: none | vite | next | existing', 'none')
     .option('-m, --package-manager <pm>', 'Package manager: pnpm | npm | yarn | bun', 'pnpm')
     .option('--no-skills', 'Skip installing AI skills')
-    .option('--no-graft', 'Skip codebase graph (Graft) setup')
+    .option('--no-trail', 'Skip codebase graph (Trail) setup')
     .option('--no-git', 'Skip git repository initialization')
     .option('--dry-run', 'Simulate creation without writing changes to disk');
   withProfileOptions(newCommand)
@@ -159,7 +159,7 @@ export function createCliProgram(): Command {
         framework: finalFramework as WebFramework,
         packageManager: finalPackageManager as PackageManager,
         skills: options.skills,
-        graft: options.graft,
+        trail: options.trail,
         git: options.git,
         dryRun: options.dryRun,
         profile: finalProfile
@@ -175,7 +175,7 @@ export function createCliProgram(): Command {
     .option('-f, --framework <framework>', 'Web framework: none | vite | next | existing')
     .option('-m, --package-manager <pm>', 'Package manager: pnpm | npm | yarn | bun')
     .option('--no-skills', 'Skip installing AI skills')
-    .option('--no-graft', 'Skip codebase graph (Graft) setup')
+    .option('--no-trail', 'Skip codebase graph (Trail) setup')
     .option('--no-git', 'Skip git repository initialization')
     .option('--dry-run', 'Simulate setup without writing changes to disk')
     .option('-y, --yes', 'Skip the prompts and use saved or detected settings');
@@ -209,7 +209,7 @@ export function createCliProgram(): Command {
         framework: finalFramework as WebFramework,
         packageManager: finalPackageManager as PackageManager,
         skills: options.skills,
-        graft: options.graft,
+        trail: options.trail,
         git: options.git,
         dryRun: options.dryRun,
         profile: finalProfile
@@ -278,16 +278,16 @@ export function createCliProgram(): Command {
         const advice = ignoreVendoredSkills(targetDir, { dryRun: options.dryRun, silent: true });
         for (const line of advice) logger.warn(line);
       }
-      const graftOk =
-        config?.codebase.graft === false
+      const trailOk =
+        config?.codebase.trail === false
           ? true
-          : await buildGraft(targetDir, { dryRun: options.dryRun });
-      if (skillsOk && graftOk) logger.success('Update finished.');
+          : await buildTrail(targetDir, { dryRun: options.dryRun });
+      if (skillsOk && trailOk) logger.success('Update finished.');
       else {
         if (!skillsOk) logger.warn('Skills update failed. Check connectivity and the skills CLI.');
-        if (!graftOk)
+        if (!trailOk)
           logger.warn(
-            'Graft refresh failed or Graft is unavailable. Check installation and rerun graft build.'
+            'Trail refresh failed or Trail is unavailable. Check installation and rerun trail build.'
           );
         process.exitCode = 1;
       }

package/src/cli/new.ts

@@ -50,7 +50,7 @@ export interface NewProjectOptions {
   framework?: WebFramework;
   packageManager?: PackageManager;
   skills?: boolean;
-  graft?: boolean;
+  trail?: boolean;
   git?: boolean;
   dryRun?: boolean;
   targetDir?: string;
@@ -179,7 +179,7 @@ export async function createProject(
   const manifest = readPackageManifest(targetDir); // Validate before creating or modifying anything.
   const config = resolveConfig(projectName, targetDir, options, existingConfig, manifest);
   if (config.preset !== 'web') delete config.framework;
-  if (options.graft === false) config.codebase = { ...config.codebase, graft: false };
+  if (options.trail === false) config.codebase = { ...config.codebase, trail: false };
   if (options.skills === false && !existingConfig) config.skills.sources = [];
   const presetName = config.preset;
   const packageManager = config.packageManager ?? 'pnpm';
@@ -197,14 +197,14 @@ export async function createProject(
   let complete = true;
 
   const installSkills = options.skills !== false && config.skills.sources.length > 0;
-  // Upstream setups (agent-browser runtime, e2e, Graft) in registry order, Graft last
+  // Upstream setups (agent-browser runtime, e2e, Trail) in registry order, Trail last
   // so its first index sees every generated file.
   const setups = active
     .flatMap((capability) =>
       capability.install.flatMap((step) => (step.kind === 'setup' ? [step.setup] : []))
     )
-    .filter((setup) => !(setup === 'graft' && options.graft === false))
-    .sort((a, b) => Number(a === 'graft') - Number(b === 'graft'));
+    .filter((setup) => !(setup === 'trail' && options.trail === false))
+    .sort((a, b) => Number(a === 'trail') - Number(b === 'trail'));
   const totalSteps = 6 + setups.length;
   let currentStep = 1;
 

package/src/cli/wizard.ts

@@ -201,16 +201,20 @@ async function promptProfile(
   return { ...flags, platform, methodology, design, testing: testing as ProfileFlags['testing'], uiDriver, addons };
 }
 
-async function confirmSetup(answers: WizardInitAnswers): Promise<boolean> {
+export async function confirmSetup(answers: WizardInitAnswers): Promise<boolean> {
   const profile = answers.profile;
   const name = (id: string | undefined) => CATALOG.find((c) => c.id === id)?.name ?? id;
+  const graph = CATALOG.find(
+    (c) => c.category === 'codebase-graph' && c.default && !profile.without?.includes(c.id)
+  );
   p.note([
     `Platform: ${profile.platform}`,
     `Methodology: ${name(profile.methodology)}`,
     `Design: ${name(profile.design)}`,
     `Testing: ${name(profile.testing)}`,
     `UI driver: ${name(profile.uiDriver)}`,
-    `Add-ons: ${profile.addons?.map(name).join(', ') || 'None'}`
+    `Add-ons: ${profile.addons?.map(name).join(', ') || 'None'}`,
+    `Codebase graph: ${graph ? `${graph.name}. ${graph.description}` : 'None'}`
   ].join('\n'), 'Setup');
   return assertNotCancelled(await p.confirm({ message: 'Apply this setup?', initialValue: true }));
 }
@@ -231,7 +235,7 @@ export async function runInteractiveWizard(): Promise<void> {
         {
           value: 'init',
           label: 'Current directory',
-          hint: 'Add AGENTS.md, skills & Graft safely'
+          hint: 'Add AGENTS.md, skills & Trail safely'
         }
       ]
     })

package/src/config/defaults.ts

@@ -63,7 +63,7 @@ export function getDefaultConfig(
       claudeCode: true
     },
     skills: { sources: [] },
-    codebase: { graft: true },
+    codebase: { trail: true },
     browser: { visualAgent: false, playwright: false },
     docs: { adr: true },
     github: { ci: preset !== 'generic' }

package/src/config/schema.ts

@@ -19,7 +19,7 @@ export interface AginitConfig {
     primary: string;
     secondary: string;
     /**
-     * Also install skills, Graft wiring and a CLAUDE.md import for Claude Code.
+     * Also install skills, Trail wiring and a CLAUDE.md import for Claude Code.
      * Missing in configs written before 0.4.0; treated as enabled.
      */
     claudeCode?: boolean;
@@ -34,7 +34,7 @@ export interface AginitConfig {
     sources: SkillSourceConfig[];
   };
   codebase: {
-    graft: boolean;
+    trail: boolean;
   };
   browser: {
     visualAgent: boolean;

package/src/config/validation.ts

@@ -50,11 +50,25 @@ export function validateUpstreamArgument(value: unknown, label: string): asserts
     );
   }
 }
-export function validateConfig(value: unknown): AginitConfig {
+/** Configs saved before Graft became Trail name it `graft`; read them as `trail`. */
+function migrateGraftConfig(value: Record<string, any>): Record<string, any> {
+  const rename = (ids: unknown) =>
+    Array.isArray(ids) ? ids.map((id) => (id === 'graft' ? 'trail' : id)) : ids;
+  const { graft, ...codebase } = isRecord(value.codebase) ? value.codebase : {};
+  return {
+    ...value,
+    ...(isRecord(value.codebase) ? { codebase: { trail: graft, ...codebase } } : {}),
+    ...(value.capabilities ? { capabilities: rename(value.capabilities) } : {}),
+    ...(value.disabledCapabilities ? { disabledCapabilities: rename(value.disabledCapabilities) } : {})
+  };
+}
+
+export function validateConfig(input: unknown): AginitConfig {
   const fail = (field: string): never => {
     throw new Error(`Invalid project configuration: ${field}`);
   };
-  if (!isRecord(value)) return fail('expected a JSON object');
+  if (!isRecord(input)) return fail('expected a JSON object');
+  const value = migrateGraftConfig(input);
   if (value.schemaVersion !== undefined && value.schemaVersion !== '1.0.0')
     fail('unsupported schemaVersion');
   if (typeof value.name !== 'string' || !value.name) fail('name');
@@ -112,7 +126,7 @@ export function validateConfig(value: unknown): AginitConfig {
     }
   }
   for (const [section, keys] of Object.entries({
-    codebase: ['graft'],
+    codebase: ['trail'],
     browser: ['visualAgent', 'playwright'],
     docs: ['adr'],
     github: ['ci']

package/src/detect/index.ts

@@ -74,6 +74,14 @@ export function detectProject(dir: string): DetectedProject {
   return { platform: null, stack: 'unknown' };
 }
 
+/** The file configuring ruff, in ruff's own lookup order, when the project uses it. */
+export function ruffConfigFile(dir: string): string | undefined {
+  const local = ['.ruff.toml', 'ruff.toml'].find((file) => fs.existsSync(path.join(dir, file)));
+  if (local) return local;
+  const pyproject = readTextFile(path.join(dir, 'pyproject.toml')) ?? '';
+  return /^\[tool\.ruff[.\]]/m.test(pyproject) ? 'pyproject.toml' : undefined;
+}
+
 /**
  * The project's own commands: package scripts for Node projects, the host
  * toolchain otherwise. Commands that would be guesses are left out.
@@ -126,8 +134,13 @@ export function projectCommands(
       return { build: 'cargo build', typecheck: 'cargo check', lint: 'cargo clippy', test: 'cargo test' };
     case 'go':
       return { build: 'go build ./...', lint: 'go vet ./...', test: 'go test ./...' };
-    case 'python':
-      return { test: exists('uv.lock') ? 'uv run pytest' : 'pytest' };
+    case 'python': {
+      const run = exists('uv.lock') ? 'uv run ' : '';
+      return {
+        ...(ruffConfigFile(dir) ? { lint: `${run}ruff check . && ${run}ruff format --check .` } : {}),
+        test: `${run}pytest`
+      };
+    }
     case 'unknown':
       return {};
   }

package/src/index.ts

@@ -6,7 +6,7 @@ export * from './presets/types.js';
 export * from './adapters/package-manager.js';
 export * from './adapters/git.js';
 export * from './adapters/skills.js';
-export * from './adapters/graft.js';
+export * from './adapters/trail.js';
 export * from './adapters/agents-md.js';
 export * from './adapters/browser.js';
 export * from './adapters/agent-browser.js';

package/src/registry/catalog.ts

@@ -68,29 +68,31 @@ const uiDriverName = (ctx: GuideContext) =>
 export const CATALOG: CapabilityDescriptor[] = [
   // ── Codebase graph ────────────────────────────────────────────────────────
   {
-    id: 'graft',
-    name: 'Graft',
-    description: 'Codebase context graph: graft map / ask --source / skeleton / callers',
+    id: 'trail',
+    name: 'Trail',
+    description:
+      'Codebase graph and team learnings (trail ask / skeleton / callers). ' +
+      'Sends anonymous usage stats: opt out with `trail telemetry disable` or DO_NOT_TRACK=1',
     category: 'codebase-graph',
-    author: 'NanoNets / Trail (graft contributors)',
+    author: 'Trail (formerly Graft, by NanoNets)',
     repoUrl: 'https://github.com/trailhq/Trail-Code',
     license: 'MIT',
     supportedPlatforms: ['all'],
     requiresNodeInProjectRoot: false,
     default: true,
     install: [
-      { kind: 'binary', bin: 'graft', install: 'npm install -g @nanonets/graft' },
-      { kind: 'setup', setup: 'graft' }
+      { kind: 'binary', bin: 'trail', install: 'npm install -g @trailhq/trail-code' },
+      { kind: 'setup', setup: 'trail' }
     ],
-    doctor: [{ kind: 'file', path: 'graft/INDEX.md', fix: 'graft build' }],
+    doctor: [{ kind: 'file', path: '.trail/cache/INDEX.md', fix: 'trail build' }],
     routing: {
       task: 'Codebase exploration & impact analysis',
-      read: '`graft ask "<query>" --source` / `graft skeleton <file>` (see the Graft section)'
+      read: '`trail ask "<query>" --source` / `trail skeleton <file>` (see the Trail section)'
     },
     rebuttals: [
       {
         excuse: "I'll grep/read the whole folder to understand the module.",
-        rule: 'Forbidden. Query `graft ask "<query>" --source` or `graft callers <symbol>` first to save context tokens.'
+        rule: 'Forbidden. Query `trail ask "<query>" --source` or `trail callers <symbol>` first to save context tokens.'
       }
     ]
   },
@@ -442,7 +444,10 @@ export const CATALOG: CapabilityDescriptor[] = [
           `## Unit & integration tests: ${ctx.stack} toolchain`,
           `- Run: ${code(ctx.commands.test, 'the project test command')}`,
           ctx.commands.lint ? `- Static checks: \`${ctx.commands.lint}\`` : undefined,
-          '- Write the failing test first, then the code. Keep tests next to the module they cover, following the toolchain convention.'
+          '- Write the failing test first, then the code. ' +
+            (ctx.testDir
+              ? `Put tests in \`${ctx.testDir}/\`, mirroring the module they cover.`
+              : 'Place tests where the toolchain convention puts them.')
         ]
           .filter((line): line is string => line !== undefined)
           .join('\n')

package/src/registry/index.ts

@@ -264,11 +264,11 @@ function mergeSources(
 
 /**
  * Capabilities a config written before v2 (no `capabilities` field) uses:
- * the ones whose skills it installs, plus Graft and its test harness.
+ * the ones whose skills it installs, plus Trail and its test harness.
  */
 export function inferCapabilities(config: AginitConfig): string[] {
   const ids: string[] = [];
-  if (config.codebase.graft) ids.push('graft');
+  if (config.codebase.trail) ids.push('trail');
   for (const capability of CATALOG) {
     const steps = skillSteps(capability);
     if (
@@ -297,7 +297,7 @@ export function activeCapabilities(config: AginitConfig): CapabilityDescriptor[]
     .filter((c): c is CapabilityDescriptor => c !== undefined)
     .filter((capability) => {
       // The legacy switches still turn their capability off.
-      if (capability.id === 'graft' && config.codebase.graft === false) return false;
+      if (capability.id === 'trail' && config.codebase.trail === false) return false;
       if (capability.id === 'playwright' && !config.browser.playwright) return false;
       // Skills only install from configured sources (`--no-skills` empties them).
       const steps = skillSteps(capability).filter((step) => !step.optional);
@@ -314,7 +314,7 @@ export function activeIds(config: AginitConfig): Set<string> {
 
 /** Keep the pre-v2 switches in step with the capability list. */
 function mirrorLegacySwitches(config: AginitConfig, ids: string[]): void {
-  config.codebase = { ...config.codebase, graft: ids.includes('graft') };
+  config.codebase = { ...config.codebase, trail: ids.includes('trail') };
   config.browser = {
     ...config.browser,
     visualAgent: ids.includes('agent-browser'),

package/src/registry/setup.ts

@@ -1,5 +1,5 @@
 import { AginitConfig } from '../config/schema.js';
-import { initGraft } from '../adapters/graft.js';
+import { initTrail } from '../adapters/trail.js';
 import { setupAgentBrowser } from '../adapters/agent-browser.js';
 import { setupE2e } from '../adapters/e2e.js';
 import { claudeCodeEnabled } from '../adapters/skills.js';
@@ -16,8 +16,8 @@ export interface SetupContext {
 
 /** Upstream setup commands, keyed by the `setup` install step that names them. */
 export const SETUPS: Record<SetupId, (ctx: SetupContext) => Promise<boolean>> = {
-  graft: (ctx) =>
-    initGraft(ctx.targetDir, {
+  trail: (ctx) =>
+    initTrail(ctx.targetDir, {
       dryRun: ctx.dryRun,
       silent: ctx.silent,
       claude: claudeCodeEnabled(ctx.config)
@@ -34,7 +34,7 @@ export const SETUPS: Record<SetupId, (ctx: SetupContext) => Promise<boolean>> =
 };
 
 export const SETUP_LABELS: Record<SetupId, string> = {
-  graft: 'Configuring codebase intelligence (Graft)',
+  trail: 'Configuring codebase intelligence (Trail)',
   'agent-browser': 'Provisioning agent-browser runtime',
   e2e: 'Scaffolding e2e tests'
 };

package/src/registry/types.ts

@@ -14,7 +14,7 @@ export type CapabilityCategory =
   | 'methodology' // pocock, superpowers, minimal
   | 'discipline' // ponytail, karpathy-guidelines, humanizer
   | 'design' // impeccable
-  | 'codebase-graph' // graft
+  | 'codebase-graph' // trail
   | 'ui-driver' // agent-browser, agent-device, chrome-devtools-mcp, browserskill
   | 'testing-engine' // e2e, playwright, vitest, native
   | 'context-guard' // context-mode, worktrunk
@@ -39,7 +39,7 @@ export type InstallStep =
  * Setups that run an upstream init command. vitest and playwright have none:
  * the presets add them to package.json when they are active.
  */
-export type SetupId = 'graft' | 'agent-browser' | 'e2e';
+export type SetupId = 'trail' | 'agent-browser' | 'e2e';
 
 export type DoctorCheck =
   | { kind: 'file'; path: string; fix: string }
@@ -55,6 +55,8 @@ export interface GuideContext {
   commands: ProjectCommands;
   /** Directory that holds the e2e workspace ('' for the project root). */
   e2eDir: string;
+  /** The project's top-level test directory (tests/ or test/), when it has one. */
+  testDir?: string;
 }
 
 export interface ProjectCommands {

package/dist/adapters/graft.d.ts

@@ -1,15 +0,0 @@
-export declare function isGraftInstalled(): Promise<boolean>;
-export declare function initGraft(targetDir: string, options?: {
-    dryRun?: boolean;
-    silent?: boolean;
-    claude?: boolean;
-}): Promise<boolean>;
-export declare function buildGraft(targetDir: string, options?: {
-    dryRun?: boolean;
-    silent?: boolean;
-}): Promise<boolean>;
-export declare function uninstallGraft(targetDir: string, options?: {
-    dryRun?: boolean;
-    silent?: boolean;
-}): Promise<boolean>;
-//# sourceMappingURL=graft.d.ts.map