@renseiai/agentfactory-cli 0.8.10 → 0.8.12

package/dist/src/agent.js

@@ -19,7 +19,7 @@
 import path from 'path';
 import { config } from 'dotenv';
 // Load environment variables from .env.local in CWD
-config({ path: path.resolve(process.cwd(), '.env.local') });
+config({ path: path.resolve(process.cwd(), '.env.local'), quiet: true });
 import { runAgent, C } from './lib/agent-runner.js';
 // ---------------------------------------------------------------------------
 // Usage

package/dist/src/analyze-logs.js

@@ -25,7 +25,7 @@
 import path from 'path';
 import { config } from 'dotenv';
 // Load environment variables from .env.local in CWD
-config({ path: path.resolve(process.cwd(), '.env.local') });
+config({ path: path.resolve(process.cwd(), '.env.local'), quiet: true });
 import { runLogAnalyzer, printSummary } from './lib/analyze-logs-runner.js';
 import { getVersion, checkForUpdate, printUpdateNotification } from './lib/version.js';
 const DEFAULT_POLL_INTERVAL = 5000;

package/dist/src/governor.js

@@ -25,7 +25,7 @@
 import path from 'path';
 import { config } from 'dotenv';
 // Load environment variables from .env.local
-config({ path: path.resolve(process.cwd(), '.env.local') });
+config({ path: path.resolve(process.cwd(), '.env.local'), quiet: true });
 import { parseGovernorArgs, runGovernor, } from './lib/governor-runner.js';
 import { createRealDependencies } from './lib/governor-dependencies.js';
 import { printStartupBanner, printScanSummary, printCircuitBreakerWarning, } from './lib/governor-logger.js';

package/dist/src/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":";AACA;;;;;GAKG;AAEH,QAAA,MAAM,OAAO,QAAkB,CAAA;AAE/B,iBAAS,SAAS,IAAI,IAAI,CAyBzB"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":";AACA;;;;;GAKG;AAEH,QAAA,MAAM,OAAO,QAAkB,CAAA;AAE/B,iBAAS,SAAS,IAAI,IAAI,CA0BzB"}

package/dist/src/index.js

@@ -25,6 +25,7 @@ Commands:
   analyze-logs    Analyze agent session logs for errors
   linear          Linear issue tracker operations
   sync-routes     Generate missing route and page files from manifest
+  setup           Configure development tools (mergiraf, etc.)
   status          Show fleet status (inline one-line summary)
   help            Show this help message
 
@@ -64,6 +65,9 @@ switch (command) {
     case 'sync-routes':
         import('./sync-routes');
         break;
+    case 'setup':
+        import('./setup');
+        break;
     case 'status':
         import('./status');
         break;

package/dist/src/lib/orchestrator-runner.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"orchestrator-runner.d.ts","sourceRoot":"","sources":["../../../src/lib/orchestrator-runner.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,OAAO,EAEL,KAAK,YAAY,EAEjB,KAAK,iBAAiB,EACvB,MAAM,wBAAwB,CAAA;AAY/B,MAAM,WAAW,wBAAwB;IACvC,wCAAwC;IACxC,YAAY,EAAE,MAAM,CAAA;IACpB,oCAAoC;IACpC,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,6CAA6C;IAC7C,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,mCAAmC;IACnC,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,kDAAkD;IAClD,IAAI,CAAC,EAAE,OAAO,CAAA;IACd,iEAAiE;IACjE,MAAM,CAAC,EAAE,OAAO,CAAA;IAChB,iDAAiD;IACjD,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,2CAA2C;IAC3C,SAAS,CAAC,EAAE,qBAAqB,CAAA;IACjC,8CAA8C;IAC9C,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,8CAA8C;IAC9C,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,sDAAsD;IACtD,QAAQ,CAAC,EAAE,MAAM,CAAA;CAClB;AAED,MAAM,WAAW,qBAAqB;IACpC,eAAe,CAAC,EAAE,CAAC,KAAK,EAAE,iBAAiB,KAAK,IAAI,CAAA;IACpD,YAAY,CAAC,EAAE,CAAC,KAAK,EAAE,YAAY,KAAK,IAAI,CAAA;IAC5C,eAAe,CAAC,EAAE,CAAC,KAAK,EAAE,YAAY,KAAK,IAAI,CAAA;IAC/C,YAAY,CAAC,EAAE,CAAC,KAAK,EAAE,YAAY,EAAE,KAAK,EAAE,KAAK,KAAK,IAAI,CAAA;IAC1D,iBAAiB,CAAC,EAAE,CAAC,KAAK,EAAE,YAAY,KAAK,IAAI,CAAA;CAClD;AAED,MAAM,WAAW,wBAAwB;IACvC,aAAa,EAAE,MAAM,CAAA;IACrB,MAAM,EAAE,KAAK,CAAC;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,KAAK,CAAA;KAAE,CAAC,CAAA;IAChD,SAAS,EAAE,YAAY,EAAE,CAAA;CAC1B;AAMD,wBAAgB,UAAU,IAAI,MAAM,CASnC;AAED,wBAAgB,cAAc,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAYjD;AA0CD,wBAAsB,eAAe,CACnC,MAAM,EAAE,wBAAwB,GAC/B,OAAO,CAAC,wBAAwB,CAAC,CAmGnC"}
+{"version":3,"file":"orchestrator-runner.d.ts","sourceRoot":"","sources":["../../../src/lib/orchestrator-runner.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,OAAO,EAEL,KAAK,YAAY,EAEjB,KAAK,iBAAiB,EAEvB,MAAM,wBAAwB,CAAA;AAkB/B,MAAM,WAAW,wBAAwB;IACvC,wCAAwC;IACxC,YAAY,EAAE,MAAM,CAAA;IACpB,oCAAoC;IACpC,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,6CAA6C;IAC7C,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,mCAAmC;IACnC,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,kDAAkD;IAClD,IAAI,CAAC,EAAE,OAAO,CAAA;IACd,iEAAiE;IACjE,MAAM,CAAC,EAAE,OAAO,CAAA;IAChB,iDAAiD;IACjD,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,2CAA2C;IAC3C,SAAS,CAAC,EAAE,qBAAqB,CAAA;IACjC,8CAA8C;IAC9C,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,8CAA8C;IAC9C,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,sDAAsD;IACtD,QAAQ,CAAC,EAAE,MAAM,CAAA;CAClB;AAED,MAAM,WAAW,qBAAqB;IACpC,eAAe,CAAC,EAAE,CAAC,KAAK,EAAE,iBAAiB,KAAK,IAAI,CAAA;IACpD,YAAY,CAAC,EAAE,CAAC,KAAK,EAAE,YAAY,KAAK,IAAI,CAAA;IAC5C,eAAe,CAAC,EAAE,CAAC,KAAK,EAAE,YAAY,KAAK,IAAI,CAAA;IAC/C,YAAY,CAAC,EAAE,CAAC,KAAK,EAAE,YAAY,EAAE,KAAK,EAAE,KAAK,KAAK,IAAI,CAAA;IAC1D,iBAAiB,CAAC,EAAE,CAAC,KAAK,EAAE,YAAY,KAAK,IAAI,CAAA;CAClD;AAED,MAAM,WAAW,wBAAwB;IACvC,aAAa,EAAE,MAAM,CAAA;IACrB,MAAM,EAAE,KAAK,CAAC;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,KAAK,CAAA;KAAE,CAAC,CAAA;IAChD,SAAS,EAAE,YAAY,EAAE,CAAA;CAC1B;AAMD,wBAAgB,UAAU,IAAI,MAAM,CASnC;AAED,wBAAgB,cAAc,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAYjD;AA0CD,wBAAsB,eAAe,CACnC,MAAM,EAAE,wBAAwB,GAC/B,OAAO,CAAC,wBAAwB,CAAC,CAmGnC"}

package/dist/src/lib/orchestrator-runner.js

@@ -9,7 +9,14 @@ import path from 'path';
 import { execSync } from 'child_process';
 import { createOrchestrator, } from '@renseiai/agentfactory';
 import { LinearIssueTrackerClient, createLinearStatusMappings, linearPlugin, } from '@renseiai/plugin-linear';
-import { codeIntelligencePlugin } from '@renseiai/agentfactory-code-intelligence';
+let codeIntelligencePlugin;
+try {
+    ;
+    ({ codeIntelligencePlugin } = await import('@renseiai/agentfactory-code-intelligence'));
+}
+catch {
+    // code-intelligence is optional — agents run without af_code_* tools
+}
 // ---------------------------------------------------------------------------
 // Helpers
 // ---------------------------------------------------------------------------
@@ -88,7 +95,7 @@ export async function runOrchestrator(config) {
         linearApiKey: config.linearApiKey,
         issueTrackerClient,
         statusMappings,
-        toolPlugins: [linearPlugin, codeIntelligencePlugin],
+        toolPlugins: [linearPlugin, codeIntelligencePlugin].filter(Boolean),
     };
     if (config.templateDir) {
         orchestratorConfig.templateDir = config.templateDir;

package/dist/src/lib/setup-mergiraf-runner.d.ts

@@ -0,0 +1,58 @@
+/**
+ * Setup Mergiraf Runner — Programmatic API for configuring mergiraf as git merge driver.
+ *
+ * Exports `setupMergiraf()` so mergiraf configuration can be invoked from code
+ * without going through process.argv / process.env / process.exit.
+ */
+export interface SetupMergirafConfig {
+    /** Show what would be done without making changes (default: false) */
+    dryRun?: boolean;
+    /** Only configure for agent worktrees, not the whole repo (default: false) */
+    worktreeOnly?: boolean;
+    /** Skip mergiraf binary check (default: false) */
+    skipCheck?: boolean;
+    /** Git root directory (default: auto-detect) */
+    gitRoot?: string;
+    /** Worktree path for per-worktree configuration (used with worktreeOnly) */
+    worktreePath?: string;
+}
+export interface SetupMergirafResult {
+    mergirafFound: boolean;
+    mergirafVersion: string;
+    configuredFileTypes: string[];
+    gitattributesWritten: boolean;
+    mergeDriverConfigured: boolean;
+    worktreeMode: boolean;
+    repoConfigUpdated: boolean;
+    errors: string[];
+    /** Process exit code: 0 = success, 1 = error, 2 = mergiraf not found */
+    exitCode: number;
+}
+export declare function getGitRoot(): string;
+/**
+ * Detect mergiraf binary and return version info.
+ * Uses `which` to find the binary and `mergiraf --version` for the version string.
+ */
+export declare function detectMergiraf(): {
+    found: boolean;
+    version: string;
+};
+/**
+ * Configure .gitattributes with mergiraf merge driver entries.
+ * Idempotent — skips entries that already exist.
+ */
+export declare function configureGitattributes(gitRoot: string, config: SetupMergirafConfig): {
+    written: boolean;
+    fileTypes: string[];
+};
+/**
+ * Configure git merge driver for mergiraf via `git config`.
+ * In worktree-only mode, uses `--worktree` flag for worktree-local config.
+ */
+export declare function configureMergeDriver(targetPath: string, config: SetupMergirafConfig): boolean;
+/**
+ * Update .agentfactory/config.yaml with mergeDriver: mergiraf.
+ */
+export declare function updateRepoConfig(gitRoot: string, config: SetupMergirafConfig): boolean;
+export declare function setupMergiraf(config?: SetupMergirafConfig): SetupMergirafResult;
+//# sourceMappingURL=setup-mergiraf-runner.d.ts.map

package/dist/src/lib/setup-mergiraf-runner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"setup-mergiraf-runner.d.ts","sourceRoot":"","sources":["../../../src/lib/setup-mergiraf-runner.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAUH,MAAM,WAAW,mBAAmB;IAClC,sEAAsE;IACtE,MAAM,CAAC,EAAE,OAAO,CAAA;IAChB,8EAA8E;IAC9E,YAAY,CAAC,EAAE,OAAO,CAAA;IACtB,kDAAkD;IAClD,SAAS,CAAC,EAAE,OAAO,CAAA;IACnB,gDAAgD;IAChD,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,4EAA4E;IAC5E,YAAY,CAAC,EAAE,MAAM,CAAA;CACtB;AAED,MAAM,WAAW,mBAAmB;IAClC,aAAa,EAAE,OAAO,CAAA;IACtB,eAAe,EAAE,MAAM,CAAA;IACvB,mBAAmB,EAAE,MAAM,EAAE,CAAA;IAC7B,oBAAoB,EAAE,OAAO,CAAA;IAC7B,qBAAqB,EAAE,OAAO,CAAA;IAC9B,YAAY,EAAE,OAAO,CAAA;IACrB,iBAAiB,EAAE,OAAO,CAAA;IAC1B,MAAM,EAAE,MAAM,EAAE,CAAA;IAChB,wEAAwE;IACxE,QAAQ,EAAE,MAAM,CAAA;CACjB;AAMD,wBAAgB,UAAU,IAAI,MAAM,CASnC;AAMD;;;GAGG;AACH,wBAAgB,cAAc,IAAI;IAAE,KAAK,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAuBpE;AAgBD;;;GAGG;AACH,wBAAgB,sBAAsB,CACpC,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,mBAAmB,GAC1B;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,SAAS,EAAE,MAAM,EAAE,CAAA;CAAE,CAkD3C;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAClC,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,mBAAmB,GAC1B,OAAO,CAoCT;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAC9B,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,mBAAmB,GAC1B,OAAO,CAsCT;AAMD,wBAAgB,aAAa,CAAC,MAAM,CAAC,EAAE,mBAAmB,GAAG,mBAAmB,CA0D/E"}

package/dist/src/lib/setup-mergiraf-runner.js

@@ -0,0 +1,239 @@
+/**
+ * Setup Mergiraf Runner — Programmatic API for configuring mergiraf as git merge driver.
+ *
+ * Exports `setupMergiraf()` so mergiraf configuration can be invoked from code
+ * without going through process.argv / process.env / process.exit.
+ */
+import { execSync } from 'child_process';
+import { existsSync, readFileSync, writeFileSync } from 'fs';
+import { resolve } from 'path';
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+export function getGitRoot() {
+    try {
+        return execSync('git rev-parse --show-toplevel', {
+            encoding: 'utf-8',
+            stdio: ['pipe', 'pipe', 'pipe'],
+        }).trim();
+    }
+    catch {
+        return process.cwd();
+    }
+}
+// ---------------------------------------------------------------------------
+// Step functions
+// ---------------------------------------------------------------------------
+/**
+ * Detect mergiraf binary and return version info.
+ * Uses `which` to find the binary and `mergiraf --version` for the version string.
+ */
+export function detectMergiraf() {
+    try {
+        execSync('which mergiraf', { stdio: 'pipe', encoding: 'utf-8' });
+    }
+    catch {
+        console.log('mergiraf binary not found on PATH.\n');
+        console.log('Install mergiraf:');
+        console.log('  macOS:  brew install mergiraf');
+        console.log('  Linux:  cargo install mergiraf  (or download from Codeberg releases)');
+        console.log('  Any:    cargo install mergiraf  (requires Rust toolchain)\n');
+        return { found: false, version: '' };
+    }
+    let version = '';
+    try {
+        version = execSync('mergiraf --version', {
+            encoding: 'utf-8',
+            stdio: ['pipe', 'pipe', 'pipe'],
+        }).trim();
+    }
+    catch {
+        version = '(unknown)';
+    }
+    return { found: true, version };
+}
+/** File types that mergiraf supports for AST-aware merging. */
+const MERGIRAF_FILE_TYPES = [
+    '*.ts', '*.tsx', '*.js', '*.jsx', '*.mjs', '*.json',
+    '*.yaml', '*.yml', '*.py', '*.go', '*.rs',
+    '*.java', '*.css', '*.html',
+];
+/** Lock files that should use merge=ours strategy. */
+const LOCK_FILE_ENTRIES = [
+    'pnpm-lock.yaml merge=ours',
+    'package-lock.json merge=ours',
+    'yarn.lock merge=ours',
+];
+/**
+ * Configure .gitattributes with mergiraf merge driver entries.
+ * Idempotent — skips entries that already exist.
+ */
+export function configureGitattributes(gitRoot, config) {
+    const gitattributesPath = resolve(gitRoot, '.gitattributes');
+    let existing = '';
+    if (existsSync(gitattributesPath)) {
+        existing = readFileSync(gitattributesPath, 'utf-8');
+    }
+    const lines = [];
+    const addedTypes = [];
+    // Add mergiraf merge driver entries
+    for (const ft of MERGIRAF_FILE_TYPES) {
+        const entry = `${ft} merge=mergiraf`;
+        if (!existing.includes(entry)) {
+            lines.push(entry);
+            addedTypes.push(ft);
+        }
+    }
+    // Add lock file entries
+    for (const entry of LOCK_FILE_ENTRIES) {
+        if (!existing.includes(entry)) {
+            lines.push(entry);
+        }
+    }
+    if (lines.length === 0) {
+        console.log('  .gitattributes already configured — no changes needed');
+        return { written: true, fileTypes: MERGIRAF_FILE_TYPES };
+    }
+    if (config.dryRun) {
+        console.log('[DRY RUN] Would add to .gitattributes:');
+        for (const line of lines) {
+            console.log(`  ${line}`);
+        }
+        return { written: false, fileTypes: MERGIRAF_FILE_TYPES };
+    }
+    // Append new entries with a header comment
+    const newContent = existing.trimEnd() +
+        (existing.length > 0 ? '\n\n' : '') +
+        '# AST-aware merge driver (mergiraf)\n' +
+        lines.join('\n') + '\n';
+    writeFileSync(gitattributesPath, newContent, 'utf-8');
+    console.log(`  .gitattributes updated: ${addedTypes.length} file type(s) added`);
+    return { written: true, fileTypes: MERGIRAF_FILE_TYPES };
+}
+/**
+ * Configure git merge driver for mergiraf via `git config`.
+ * In worktree-only mode, uses `--worktree` flag for worktree-local config.
+ */
+export function configureMergeDriver(targetPath, config) {
+    const scope = config.worktreeOnly ? ' --worktree' : '';
+    const label = config.worktreeOnly ? 'worktree-local config' : '.git/config';
+    if (config.dryRun) {
+        console.log('[DRY RUN] Would configure git merge driver:');
+        console.log(`  git config${scope} merge.mergiraf.name "mergiraf"`);
+        console.log(`  git config${scope} merge.mergiraf.driver "mergiraf merge --git %O %A %B -s %S -x %X -y %Y -p %P"`);
+        return false;
+    }
+    try {
+        // Enable worktree config extension if using worktree-only mode
+        if (config.worktreeOnly) {
+            execSync('git config extensions.worktreeConfig true', {
+                stdio: 'pipe',
+                encoding: 'utf-8',
+                cwd: targetPath,
+            });
+        }
+        execSync(`git config${scope} merge.mergiraf.name "mergiraf"`, {
+            stdio: 'pipe',
+            encoding: 'utf-8',
+            cwd: targetPath,
+        });
+        execSync(`git config${scope} merge.mergiraf.driver "mergiraf merge --git %O %A %B -s %S -x %X -y %Y -p %P"`, { stdio: 'pipe', encoding: 'utf-8', cwd: targetPath });
+        console.log(`  Merge driver configured in ${label}`);
+        return true;
+    }
+    catch (error) {
+        console.error(`  Failed to configure merge driver: ${error instanceof Error ? error.message : String(error)}`);
+        return false;
+    }
+}
+/**
+ * Update .agentfactory/config.yaml with mergeDriver: mergiraf.
+ */
+export function updateRepoConfig(gitRoot, config) {
+    const configDir = resolve(gitRoot, '.agentfactory');
+    const configPath = resolve(configDir, 'config.yaml');
+    if (config.dryRun) {
+        console.log('[DRY RUN] Would set mergeDriver: mergiraf in .agentfactory/config.yaml');
+        return false;
+    }
+    if (!existsSync(configPath)) {
+        // Config file doesn't exist — skip (don't create one from scratch)
+        console.log('  .agentfactory/config.yaml not found — skipping repo config update');
+        return false;
+    }
+    try {
+        let content = readFileSync(configPath, 'utf-8');
+        if (content.includes('mergeDriver: mergiraf')) {
+            console.log('  .agentfactory/config.yaml already has mergeDriver: mergiraf');
+            return true;
+        }
+        if (content.includes('mergeDriver:')) {
+            // Replace existing mergeDriver value
+            content = content.replace(/mergeDriver:\s*\S+/, 'mergeDriver: mergiraf');
+        }
+        else {
+            // Append mergeDriver setting
+            content = content.trimEnd() + '\nmergeDriver: mergiraf\n';
+        }
+        writeFileSync(configPath, content, 'utf-8');
+        console.log('  .agentfactory/config.yaml updated: mergeDriver: mergiraf');
+        return true;
+    }
+    catch (error) {
+        console.error(`  Failed to update repo config: ${error instanceof Error ? error.message : String(error)}`);
+        return false;
+    }
+}
+// ---------------------------------------------------------------------------
+// Runner
+// ---------------------------------------------------------------------------
+export function setupMergiraf(config) {
+    const gitRoot = config?.gitRoot ?? getGitRoot();
+    const isWorktreeMode = config?.worktreeOnly ?? false;
+    // In worktree-only mode, use the worktree path for .gitattributes and git config
+    const targetPath = isWorktreeMode && config?.worktreePath
+        ? config.worktreePath
+        : gitRoot;
+    const result = {
+        mergirafFound: false,
+        mergirafVersion: '',
+        configuredFileTypes: [],
+        gitattributesWritten: false,
+        mergeDriverConfigured: false,
+        worktreeMode: isWorktreeMode,
+        repoConfigUpdated: false,
+        errors: [],
+        exitCode: 0,
+    };
+    // Step 1: Detect mergiraf binary
+    if (!config?.skipCheck) {
+        const detection = detectMergiraf();
+        result.mergirafFound = detection.found;
+        result.mergirafVersion = detection.version;
+        if (!detection.found) {
+            result.errors.push('mergiraf binary not found on PATH. Install with: brew install mergiraf (macOS) or cargo install mergiraf');
+            result.exitCode = 2;
+            return result;
+        }
+    }
+    else {
+        result.mergirafFound = true;
+        result.mergirafVersion = '(check skipped)';
+    }
+    if (config?.dryRun) {
+        console.log('[DRY RUN] Would configure mergiraf in:', targetPath);
+        console.log('[DRY RUN] Worktree-only mode:', isWorktreeMode);
+        return result;
+    }
+    // Step 2: Configure .gitattributes (in worktree root or repo root)
+    const gitattributes = configureGitattributes(targetPath, config ?? {});
+    result.gitattributesWritten = gitattributes.written;
+    result.configuredFileTypes = gitattributes.fileTypes;
+    // Step 3: Configure git merge driver (worktree-local or repo-wide)
+    result.mergeDriverConfigured = configureMergeDriver(targetPath, config ?? {});
+    // Step 4: Update repo config (always in git root, not worktree)
+    if (!isWorktreeMode) {
+        result.repoConfigUpdated = updateRepoConfig(gitRoot, config ?? {});
+    }
+    return result;
+}

package/dist/src/lib/worker-runner.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"worker-runner.d.ts","sourceRoot":"","sources":["../../../src/lib/worker-runner.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAyBH,MAAM,WAAW,kBAAkB;IACjC,0BAA0B;IAC1B,MAAM,EAAE,MAAM,CAAA;IACd,iCAAiC;IACjC,MAAM,EAAE,MAAM,CAAA;IACd,+CAA+C;IAC/C,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,6CAA6C;IAC7C,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,mDAAmD;IACnD,MAAM,CAAC,EAAE,OAAO,CAAA;IAChB,gFAAgF;IAChF,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,iDAAiD;IACjD,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,uDAAuD;IACvD,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAA;CACpB;AA4ED;;;;;GAKG;AACH,wBAAsB,SAAS,CAC7B,MAAM,EAAE,kBAAkB,EAC1B,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,IAAI,CAAC,CAi/Bf"}
+{"version":3,"file":"worker-runner.d.ts","sourceRoot":"","sources":["../../../src/lib/worker-runner.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAgCH,MAAM,WAAW,kBAAkB;IACjC,0BAA0B;IAC1B,MAAM,EAAE,MAAM,CAAA;IACd,iCAAiC;IACjC,MAAM,EAAE,MAAM,CAAA;IACd,+CAA+C;IAC/C,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,6CAA6C;IAC7C,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,mDAAmD;IACnD,MAAM,CAAC,EAAE,OAAO,CAAA;IAChB,gFAAgF;IAChF,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,iDAAiD;IACjD,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,uDAAuD;IACvD,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAA;CACpB;AA4ED;;;;;GAKG;AACH,wBAAsB,SAAS,CAC7B,MAAM,EAAE,kBAAkB,EAC1B,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,IAAI,CAAC,CAi/Bf"}

package/dist/src/lib/worker-runner.js

@@ -10,7 +10,14 @@ import { execSync } from 'child_process';
 import os from 'os';
 import { createOrchestrator, createLogger, } from '@renseiai/agentfactory';
 import { LinearIssueTrackerClient, createLinearStatusMappings, linearPlugin, } from '@renseiai/plugin-linear';
-import { codeIntelligencePlugin } from '@renseiai/agentfactory-code-intelligence';
+let codeIntelligencePlugin;
+try {
+    ;
+    ({ codeIntelligencePlugin } = await import('@renseiai/agentfactory-code-intelligence'));
+}
+catch {
+    // code-intelligence is optional — agents run without af_code_* tools
+}
 // ---------------------------------------------------------------------------
 // Helpers (stateless)
 // ---------------------------------------------------------------------------
@@ -424,7 +431,7 @@ export async function runWorker(config, signal) {
                 worktreePath: path.resolve(gitRoot, '..', path.basename(gitRoot) + '.wt'),
                 issueTrackerClient,
                 statusMappings,
-                toolPlugins: [linearPlugin, codeIntelligencePlugin],
+                toolPlugins: [linearPlugin, codeIntelligencePlugin].filter(Boolean),
                 apiActivityConfig: {
                     baseUrl: workerConfig.apiUrl,
                     apiKey: workerConfig.apiKey,

package/dist/src/linear.js

@@ -37,7 +37,7 @@
 import path from 'path';
 import { config } from 'dotenv';
 // Load environment variables from .env.local
-config({ path: path.resolve(process.cwd(), '.env.local') });
+config({ path: path.resolve(process.cwd(), '.env.local'), quiet: true });
 import { runLinear, parseLinearArgs } from './lib/linear-runner.js';
 function printHelp() {
     console.log(`

package/dist/src/orchestrator.js

@@ -20,7 +20,7 @@
 import path from 'path';
 import { config } from 'dotenv';
 // Load environment variables from .env.local
-config({ path: path.resolve(process.cwd(), '.env.local') });
+config({ path: path.resolve(process.cwd(), '.env.local'), quiet: true });
 import { runOrchestrator } from './lib/orchestrator-runner.js';
 import { getVersion, checkForUpdate, printUpdateNotification } from './lib/version.js';
 function parseArgs() {

package/dist/src/queue-admin.js

@@ -24,7 +24,7 @@
 import path from 'path';
 import { config } from 'dotenv';
 // Load environment variables from .env.local in CWD
-config({ path: path.resolve(process.cwd(), '.env.local') });
+config({ path: path.resolve(process.cwd(), '.env.local'), quiet: true });
 import { runQueueAdmin, C } from './lib/queue-admin-runner.js';
 // ---------------------------------------------------------------------------
 // Usage

package/dist/src/setup.d.ts

@@ -0,0 +1,21 @@
+#!/usr/bin/env node
+/**
+ * AgentFactory Setup CLI
+ *
+ * Configure development tools for agent workflows.
+ *
+ * Usage:
+ *   af-setup <tool> [options]
+ *   agentfactory setup <tool> [options]
+ *
+ * Tools:
+ *   mergiraf    Configure mergiraf AST-aware merge driver
+ *
+ * Options:
+ *   --dry-run          Show what would be done without making changes
+ *   --worktree-only    Only configure for agent worktrees
+ *   --skip-check       Skip mergiraf binary availability check
+ *   --help, -h         Show this help message
+ */
+export {};
+//# sourceMappingURL=setup.d.ts.map

package/dist/src/setup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"setup.d.ts","sourceRoot":"","sources":["../../src/setup.ts"],"names":[],"mappings":";AACA;;;;;;;;;;;;;;;;;GAiBG"}

package/dist/src/setup.js

@@ -0,0 +1,142 @@
+#!/usr/bin/env node
+/**
+ * AgentFactory Setup CLI
+ *
+ * Configure development tools for agent workflows.
+ *
+ * Usage:
+ *   af-setup <tool> [options]
+ *   agentfactory setup <tool> [options]
+ *
+ * Tools:
+ *   mergiraf    Configure mergiraf AST-aware merge driver
+ *
+ * Options:
+ *   --dry-run          Show what would be done without making changes
+ *   --worktree-only    Only configure for agent worktrees
+ *   --skip-check       Skip mergiraf binary availability check
+ *   --help, -h         Show this help message
+ */
+import { setupMergiraf, getGitRoot } from './lib/setup-mergiraf-runner.js';
+function parseArgs() {
+    const args = process.argv.slice(2);
+    const result = {
+        subcommand: undefined,
+        dryRun: false,
+        worktreeOnly: false,
+        skipCheck: false,
+    };
+    for (let i = 0; i < args.length; i++) {
+        const arg = args[i];
+        switch (arg) {
+            case '--dry-run':
+                result.dryRun = true;
+                break;
+            case '--worktree-only':
+                result.worktreeOnly = true;
+                break;
+            case '--skip-check':
+                result.skipCheck = true;
+                break;
+            case '--help':
+            case '-h':
+                printHelp();
+                process.exit(0);
+                break;
+            default:
+                // First non-flag argument is the subcommand (skip 'setup' if present)
+                if (!arg.startsWith('-') && arg !== 'setup') {
+                    result.subcommand = arg;
+                }
+                break;
+        }
+    }
+    return result;
+}
+function printHelp() {
+    console.log(`
+AgentFactory Setup - Configure development tools for agent workflows
+
+Usage:
+  af-setup <tool> [options]
+  agentfactory setup <tool> [options]
+
+Tools:
+  mergiraf    Configure mergiraf AST-aware merge driver
+
+Options:
+  --dry-run          Show what would be done without making changes
+  --worktree-only    Only configure for agent worktrees (not whole repo)
+  --skip-check       Skip mergiraf binary availability check
+  --help, -h         Show this help message
+
+Examples:
+  # Configure mergiraf for the entire repository
+  af-setup mergiraf
+
+  # Configure only for agent worktrees (recommended)
+  af-setup mergiraf --worktree-only
+
+  # Preview changes without modifying anything
+  af-setup mergiraf --dry-run
+`);
+}
+function printSummary(result) {
+    console.log('=== Summary ===\n');
+    if (result.mergirafFound) {
+        console.log(`  Mergiraf:       found (${result.mergirafVersion})`);
+    }
+    else {
+        console.log('  Mergiraf:       NOT FOUND');
+    }
+    if (result.configuredFileTypes.length > 0) {
+        console.log(`  File types:     ${result.configuredFileTypes.join(', ')}`);
+    }
+    console.log(`  .gitattributes: ${result.gitattributesWritten ? 'configured' : 'not configured'}`);
+    console.log(`  Merge driver:   ${result.mergeDriverConfigured ? 'configured' : 'not configured'}`);
+    console.log(`  Worktree mode:  ${result.worktreeMode ? 'yes' : 'no (repo-wide)'}`);
+    console.log(`  Repo config:    ${result.repoConfigUpdated ? 'updated' : 'not updated'}`);
+    if (result.errors.length > 0) {
+        console.log('\n  Errors:');
+        for (const err of result.errors) {
+            console.log(`    - ${err}`);
+        }
+    }
+    if (result.gitattributesWritten && result.mergeDriverConfigured) {
+        console.log('\n  See: https://github.com/RenseiAI/agentfactory/blob/main/docs/guides/mergiraf-setup.md');
+    }
+    console.log('');
+}
+// Main execution
+function main() {
+    const args = parseArgs();
+    if (!args.subcommand) {
+        console.error('Error: No tool specified.\n');
+        printHelp();
+        process.exit(1);
+    }
+    switch (args.subcommand) {
+        case 'mergiraf': {
+            console.log('\n=== AgentFactory Setup: Mergiraf ===\n');
+            if (args.dryRun) {
+                console.log('[DRY RUN MODE - No changes will be made]\n');
+            }
+            const result = setupMergiraf({
+                dryRun: args.dryRun,
+                worktreeOnly: args.worktreeOnly,
+                skipCheck: args.skipCheck,
+                gitRoot: getGitRoot(),
+            });
+            printSummary(result);
+            if (result.errors.length > 0) {
+                process.exit(result.exitCode || 1);
+            }
+            break;
+        }
+        default:
+            console.error(`Unknown tool: ${args.subcommand}\n`);
+            printHelp();
+            process.exit(1);
+    }
+}
+main();

package/dist/src/status.js

@@ -17,7 +17,7 @@
 import path from 'path';
 import { config } from 'dotenv';
 // Load environment variables from .env.local in CWD
-config({ path: path.resolve(process.cwd(), '.env.local') });
+config({ path: path.resolve(process.cwd(), '.env.local'), quiet: true });
 import { runStatus, C } from './lib/status-runner.js';
 // ---------------------------------------------------------------------------
 // Usage

package/dist/src/worker-fleet.js

@@ -25,7 +25,7 @@ import path from 'path';
 import os from 'os';
 import { config as loadEnv } from 'dotenv';
 // Load environment variables from .env.local in CWD
-loadEnv({ path: path.resolve(process.cwd(), '.env.local') });
+loadEnv({ path: path.resolve(process.cwd(), '.env.local'), quiet: true });
 import { runWorkerFleet } from './lib/worker-fleet-runner.js';
 // ANSI colors (kept for help output)
 const colors = {

package/dist/src/worker.js

@@ -25,7 +25,7 @@
 import path from 'path';
 import { config } from 'dotenv';
 // Load environment variables from .env.local in CWD
-config({ path: path.resolve(process.cwd(), '.env.local') });
+config({ path: path.resolve(process.cwd(), '.env.local'), quiet: true });
 import os from 'os';
 import { runWorker } from './lib/worker-runner.js';
 function parseArgs() {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@renseiai/agentfactory-cli",
-  "version": "0.8.10",
+  "version": "0.8.12",
   "type": "module",
   "description": "CLI tools for AgentFactory — local orchestrator, remote worker, queue admin",
   "author": "Rensei AI (https://rensei.ai)",
@@ -38,6 +38,7 @@
     "af-linear": "dist/src/linear.js",
     "af-governor": "dist/src/governor.js",
     "af-sync-routes": "dist/src/sync-routes.js",
+    "af-setup": "dist/src/setup.js",
     "af-status": "dist/src/status.js",
     "af-migrate-worktrees": "dist/src/migrate-worktrees.js"
   },
@@ -95,6 +96,11 @@
       "import": "./dist/src/lib/sync-routes-runner.js",
       "default": "./dist/src/lib/sync-routes-runner.js"
     },
+    "./setup": {
+      "types": "./dist/src/lib/setup-mergiraf-runner.d.ts",
+      "import": "./dist/src/lib/setup-mergiraf-runner.js",
+      "default": "./dist/src/lib/setup-mergiraf-runner.js"
+    },
     "./status": {
       "types": "./dist/src/lib/status-runner.d.ts",
       "import": "./dist/src/lib/status-runner.js",
@@ -108,10 +114,12 @@
   ],
   "dependencies": {
     "dotenv": "^17.2.3",
-    "@renseiai/agentfactory": "0.8.10",
-    "@renseiai/agentfactory-code-intelligence": "0.8.10",
-    "@renseiai/plugin-linear": "0.8.10",
-    "@renseiai/agentfactory-server": "0.8.10"
+    "@renseiai/plugin-linear": "0.8.12",
+    "@renseiai/agentfactory": "0.8.12",
+    "@renseiai/agentfactory-server": "0.8.12"
+  },
+  "optionalDependencies": {
+    "@renseiai/agentfactory-code-intelligence": "0.8.12"
   },
   "devDependencies": {
     "@types/node": "^22.5.4",