@hecer/yoke 1.20.0 → 1.21.1

package/.claude-plugin/plugin.json

@@ -2,7 +2,7 @@
   "$schema": "https://json.schemastore.org/claude-code-plugin-manifest.json",
   "name": "yoke",
   "displayName": "Yoke",
-  "version": "1.20.0",
+  "version": "1.21.1",
   "description": "Cross-agent coding harness for Claude, Codex, Gemini, Qwen, OpenCode, Kilo, Pi and Hermes: one curated skill canon plus mechanical safety gates and an autonomous loop via the yoke CLI.",
   "author": { "name": "HECer", "url": "https://github.com/HECer" },
   "homepage": "https://github.com/HECer/yoke#readme",

package/.codex-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "yoke",
-  "version": "1.20.0",
+  "version": "1.21.1",
   "description": "Cross-agent coding discipline, mechanical gates, and release workflows for eight supported harnesses",
   "skills": "./canon/skills/",
   "hooks": "./hooks/hooks.json"

package/CHANGELOG.md

@@ -1,5 +1,24 @@
 # Changelog
 
+## 1.21.1 — 2026-10-03
+
+### Fixed
+- Fix runner model and reasoning effort inheritance in `yoke setup` when switching runners: changing from Codex to another agent no longer leaks stale model or reasoning effort.
+- Fix RTK hook planning condition in Claude retrofit planner on non-Windows/WSL environments.
+
+## 1.21.0 — 2026-10-03
+
+### Added
+- Add first-class git worktree management commands: `yoke worktrees list [dir] [--all]` and `yoke worktrees prune [dir] [--all] [--force]` to discover, unregister, and safely prune orphaned, dead, or retained worktrees across a single repository or the entire registered fleet.
+- Add `--clean-worktrees` flag to `yoke retrofit` and `yoke setup` to automatically prune dead story worktrees during project updates.
+- Add user-configurable, per-agent model and reasoning effort selection in `yoke retrofit` and `yoke setup` (`--runner-model=<model>`, `--runner-reasoning=<effort>`, `--model=<agent>:<model>`, `--reasoning=<agent>:<effort>`, and interactive `--configure-models`). Reasoning effort is never forced or hardcoded during a retrofit unless explicitly chosen.
+- Add compact zero-token loop status mode (`yoke loop status [dir] --compact`) returning a single-line summary (`state=... story=... progress=... phase=... updated=...`) to avoid burning thousands of replay tokens when agents check loop progress.
+- Add native Windows RTK hook detection (`rtk.exe` on PATH or `%USERPROFILE%\.local\bin\rtk.exe`) in Claude retrofit planner without requiring WSL.
+
+### Fixed
+- Prevent exponential worktree accumulation in `.yoke/worktrees` and git metadata from consuming system disk space and causing IDE/runner OOM crashes.
+- Make interactive question parser null-safe against empty inputs or aborted prompts.
+
 ## 1.20.0 — 2026-09-30
 
 ### Added

package/README.md

@@ -11,7 +11,7 @@
 [![License: MIT](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)
 ![Node.js 20+](https://img.shields.io/badge/node-%E2%89%A520-339933?logo=node.js&logoColor=white)
 
-<!-- yoke:version:start -->1.20.0<!-- yoke:version:end --> · <!-- yoke:tests:start -->1420<!-- yoke:tests:end --> test cases · <!-- yoke:skills:start -->34<!-- yoke:skills:end --> skills
+<!-- yoke:version:start -->1.21.1<!-- yoke:version:end --> · <!-- yoke:tests:start -->1426<!-- yoke:tests:end --> test cases · <!-- yoke:skills:start -->34<!-- yoke:skills:end --> skills
 
 <!-- yoke:agents:start -->Claude | Codex | Gemini | Qwen | OpenCode | Kilo | Pi | Hermes<!-- yoke:agents:end -->
 

package/dist/cli.js

@@ -17,7 +17,7 @@ import { runNew } from './new/command.js';
 import { runPrdDraft, runPrdCheck } from './prd/command.js';
 import { runPrdAssess } from './prd/assess.js';
 import { runPrdDecompose } from './prd/decompose.js';
-import { runLoopCleanup } from './loop/cleanup.js';
+import { runLoopCleanup, pruneWorktrees, pruneFleetWorktrees, listWorktrees, listFleetWorktrees } from './loop/cleanup.js';
 import { runFlowSmoke } from './smoke/command.js';
 import { maybeNotifyUpdate, currentYokeVersion } from './update/check.js';
 import { runUpgrade } from './update/upgrade.js';
@@ -62,6 +62,22 @@ export function runDesignScan(targetDir, opts) {
     console.log(`${label} — ✓`);
     return 0;
 }
+export function parseKeyValueFlags(args, flagName) {
+    const result = {};
+    for (const arg of args) {
+        if (arg.startsWith(`--${flagName}=`)) {
+            const raw = arg.slice(flagName.length + 3);
+            const eqIdx = raw.indexOf(':');
+            if (eqIdx > 0) {
+                const key = raw.slice(0, eqIdx).trim();
+                const val = raw.slice(eqIdx + 1).trim();
+                if (key && val)
+                    result[key] = val;
+            }
+        }
+    }
+    return result;
+}
 export function parseQualityFlags(args) {
     const quality = args.includes('--quality') ? true : args.includes('--no-quality') ? false : undefined;
     const qualityUnbounded = args.includes('--quality-unbounded') || undefined;
@@ -185,9 +201,16 @@ export function main(argv) {
                 console.error('Invalid --model-provider (expected deepseek,kimi)');
                 return 1;
             }
+            const runnerModel = rest.find(a => a.startsWith('--runner-model='))?.slice('--runner-model='.length);
+            const runnerReasoning = rest.find(a => a.startsWith('--runner-reasoning='))?.slice('--runner-reasoning='.length);
+            const agentModels = parseKeyValueFlags(rest, 'model');
+            const agentReasoning = parseKeyValueFlags(rest, 'reasoning');
+            const cleanWorktrees = rest.includes('--clean-worktrees');
             return runSetup(targetDir, {
                 modelProviders: modelProviders,
                 host: hostArg, agents, runner: runnerArg,
+                runnerModel, runnerReasoning, agentModels, agentReasoning, cleanWorktrees,
+                configureModels: rest.includes('--configure-models'),
                 codeGraph: graphArg,
                 codeIntelligence: intelligenceArg,
                 loop, routing, decisionPolicy: policyArg,
@@ -218,6 +241,47 @@ export function main(argv) {
                 return 2;
             }
         }
+        case 'worktrees': {
+            const sub = rest[0] ?? 'list';
+            const targetDir = rest.slice(1).find(a => !a.startsWith('-')) ?? '.';
+            const all = rest.includes('--all');
+            const force = rest.includes('--force');
+            if (sub === 'list') {
+                if (all) {
+                    const fleet = listFleetWorktrees();
+                    for (const [name, list] of Object.entries(fleet)) {
+                        console.log(`[${name}] ${list.length} worktree(s):`);
+                        for (const wt of list)
+                            console.log(`  ${wt}`);
+                    }
+                    return 0;
+                }
+                const list = listWorktrees(targetDir);
+                console.log(`Worktrees in ${targetDir} (${list.length}):`);
+                for (const wt of list)
+                    console.log(`  ${wt}`);
+                return 0;
+            }
+            if (sub === 'prune') {
+                if (all) {
+                    const fleet = pruneFleetWorktrees({ force });
+                    let totalRemoved = 0;
+                    for (const [name, res] of Object.entries(fleet)) {
+                        if (res.removed.length > 0 || res.failed.length > 0) {
+                            console.log(`[${name}] Removed: ${res.removed.length}, Failed: ${res.failed.length}`);
+                            totalRemoved += res.removed.length;
+                        }
+                    }
+                    console.log(`Fleet prune complete: ${totalRemoved} worktree(s) removed.`);
+                    return 0;
+                }
+                const res = pruneWorktrees(targetDir, { force });
+                console.log(`Pruned ${res.removed.length} worktree(s) in ${targetDir}${res.failed.length > 0 ? ` (${res.failed.length} failed)` : ''}.`);
+                return res.failed.length === 0 ? 0 : 1;
+            }
+            console.log('usage: yoke worktrees <list|prune> [dir] [--all] [--force]');
+            return 1;
+        }
         case 'dashboard': {
             const port = rest.find(a => a.startsWith('--port='))?.slice('--port='.length);
             if (port !== undefined && (!Number.isInteger(Number(port)) || Number(port) < 0 || Number(port) > 65535)) {
@@ -319,6 +383,11 @@ export function main(argv) {
         case 'retrofit': {
             const targetDir = rest.find(a => !a.startsWith('-')) ?? '.';
             const loop = rest.includes('--loop');
+            const cleanWorktrees = rest.includes('--clean-worktrees');
+            const runnerModel = rest.find(a => a.startsWith('--runner-model='))?.slice('--runner-model='.length);
+            const runnerReasoning = rest.find(a => a.startsWith('--runner-reasoning='))?.slice('--runner-reasoning='.length);
+            const agentModels = parseKeyValueFlags(rest, 'model');
+            const agentReasoning = parseKeyValueFlags(rest, 'reasoning');
             const agentArg = rest.find(a => a.startsWith('--agent='))?.slice('--agent='.length);
             const all = [...SUPPORTED_AGENTS];
             const agents = !agentArg || agentArg === 'all'
@@ -338,7 +407,7 @@ export function main(argv) {
                 console.error(`Invalid --code-intelligence value: ${ciArg} (expected off|shadow|active)`);
                 return 1;
             }
-            return runRetrofit(targetDir, { loop, agents, codeGraph, codeIntelligence: ciArg });
+            return runRetrofit(targetDir, { loop, agents, codeGraph, codeIntelligence: ciArg, cleanWorktrees, runnerModel, runnerReasoning, agentModels, agentReasoning });
         }
         case 'change': {
             const sub = rest[0];
@@ -387,7 +456,7 @@ export function main(argv) {
                 return 0;
             }
             if (sub === 'status') {
-                console.log(loopStatus(targetDir));
+                console.log(loopStatus(targetDir, undefined, { compact: rest.includes('--compact') }));
                 return 0;
             }
             if (sub === 'pause') {
@@ -618,7 +687,7 @@ export function main(argv) {
                 }
                 return runLoopCommand(targetDir, { maxIterations: rawMax, agent, isolate, resumeWorktree: rest.includes('--resume-worktree'), parallel, parallelAuto: parallelArg === '--parallel=auto', reviewer, review, allowSelfReview, timeoutMinutes, json, routing, onAmbiguity: oaArg, decisionPolicy: dpArg, permissions, ...(explore ? { explore: true } : {}), ...(exploreIntervalMinutes !== undefined ? { exploreIntervalMinutes } : {}), ...(exploreLimit.milliseconds !== undefined ? { exploreLimitMs: exploreLimit.milliseconds } : {}), ...qualityFlags.options });
             }
-            console.log(`usage: yoke loop <on|off|status|pause|decision|answer|resume [--discard] [--explore] [--explore-interval=<minutes>] [--explore-limit=<Nh|Nd|Nw>] [--quality|--no-quality] [--quality-rounds=N] [--quality-minutes=N] [--quality-policy=<blocking|advisory>] [--quality-unbounded] [--candidates=N]|cleanup [--remove-worktrees] [--discard-stale-recovery]|run [--max=N] [--explore] [--explore-interval=<minutes>] [--explore-limit=<Nh|Nd|Nw>] [--parallel=<auto|N>] [--runner=<${AGENT_LIST}>] [--reviewer=<${AGENT_LIST}>] [--review] [--allow-self-review] [--routing|--no-routing] [--isolate|--no-isolate] [--unsafe] [--timeout=<minutes>] [--decision-policy=<auto|critical>] [--quality|--no-quality] [--quality-rounds=N] [--quality-minutes=N] [--quality-policy=<blocking|advisory>] [--quality-unbounded] [--candidates=N] [--json]> [targetDir]`);
+            console.log(`usage: yoke loop <on|off|status [--compact]|pause|decision|answer|resume [--discard] [--explore] [--explore-interval=<minutes>] [--explore-limit=<Nh|Nd|Nw>] [--quality|--no-quality] [--quality-rounds=N] [--quality-minutes=N] [--quality-policy=<blocking|advisory>] [--quality-unbounded] [--candidates=N]|cleanup [--remove-worktrees] [--discard-stale-recovery]|run [--max=N] [--explore] [--explore-interval=<minutes>] [--explore-limit=<Nh|Nd|Nw>] [--parallel=<auto|N>] [--runner=<${AGENT_LIST}>] [--reviewer=<${AGENT_LIST}>] [--review] [--allow-self-review] [--routing|--no-routing] [--isolate|--no-isolate] [--unsafe] [--timeout=<minutes>] [--decision-policy=<auto|critical>] [--quality|--no-quality] [--quality-rounds=N] [--quality-minutes=N] [--quality-policy=<blocking|advisory>] [--quality-unbounded] [--candidates=N] [--json]> [targetDir]`);
             return 1;
         }
         case 'new': {
@@ -764,7 +833,7 @@ export function main(argv) {
             return runUpgrade();
         default:
             console.log('Project workflows: yoke check [dir] [--json|--protect] | goal set|run|resume|pause|status|handoff|budget [dir] | projects add|list|remove | dashboard [dir] [--port=N]');
-            console.log(`usage: yoke <setup [dir] | new <dir> [--idea="..."] | validate [canonDir] | retrofit [targetDir] [--agent=${AGENT_LIST}|all] [--code-graph=graphify|serena] [--code-intelligence=off|shadow|active] [--loop] | change <add|status> [dir] | code-intelligence-server --workspace=<dir> --mode=<mode> | prd <draft|check|assess|decompose> [dir] | loop <on|off|status|decision|answer|resume|run|cleanup> | context <init|status> | review [dir] | design-scan [dir] | flow-smoke [dir] | upgrade>`);
+            console.log(`usage: yoke <setup [dir] | new <dir> [--idea="..."] | validate [canonDir] | retrofit [targetDir] [--agent=${AGENT_LIST}|all] [--code-graph=graphify|serena] [--code-intelligence=off|shadow|active] [--clean-worktrees] [--runner-model=<model>] [--runner-reasoning=<effort>] [--model=<agent>:<model>] [--reasoning=<agent>:<effort>] [--loop] | worktrees <list|prune> [dir] [--all] [--force] | change <add|status> [dir] | code-intelligence-server --workspace=<dir> --mode=<mode> | prd <draft|check|assess|decompose> [dir] | loop <on|off|status|decision|answer|resume|run|cleanup> | context <init|status> | review [dir] | design-scan [dir] | flow-smoke [dir] | upgrade>`);
             return cmd ? 1 : 0;
     }
 }

package/dist/loop/cleanup.js

@@ -8,6 +8,7 @@ import { killProcessForCleanup, killProcessTreeForCleanup } from './watchdog.js'
 import { cleanupClaims } from './claims.js';
 import { clearStatus } from './reporter.js';
 import { discardParallelRecoveryRecords } from './recovery.js';
+import { listProjects } from '../dashboard/registry.js';
 // Reap orphaned runners PROJECT-SCOPED: kill only pids recorded in this project's
 // .yoke/runner.pid files (main dir + each worktree). Never by process-name or
 // command-line pattern — that takes down runners belonging to OTHER projects,
@@ -266,3 +267,102 @@ function markCandidateWorktreeRemoved(targetDir, worktree) {
         }
     }
 }
+export function pruneWorktrees(targetDir, opts = {}) {
+    const result = { targetDir, removed: [], failed: [] };
+    const wtDir = join(targetDir, '.yoke', 'worktrees');
+    const candidates = new Set();
+    if (existsSync(wtDir)) {
+        try {
+            for (const entry of readdirSync(wtDir, { withFileTypes: true })) {
+                if (entry.isDirectory())
+                    candidates.add(join(wtDir, entry.name));
+            }
+        }
+        catch { /* ignore read errors */ }
+    }
+    try {
+        const raw = execFileSync('git', ['worktree', 'list', '--porcelain'], { cwd: targetDir, stdio: ['ignore', 'pipe', 'pipe'], encoding: 'utf8' });
+        const lines = raw.split(/\r?\n/);
+        for (const line of lines) {
+            if (line.startsWith('worktree ')) {
+                const wtPath = line.slice(9).trim();
+                if (wtPath.includes('.yoke/worktrees') || wtPath.includes('.yoke\\worktrees') || wtPath.includes('/.worktrees/') || wtPath.includes('\\.worktrees\\') || wtPath.includes('-story')) {
+                    candidates.add(wtPath);
+                }
+            }
+        }
+    }
+    catch { /* not a git repo or git error */ }
+    for (const wtPath of candidates) {
+        try {
+            try {
+                execFileSync('git', ['worktree', 'remove', '--force', wtPath], { cwd: targetDir, stdio: ['ignore', 'pipe', 'pipe'] });
+            }
+            catch {
+                if (existsSync(wtPath)) {
+                    rmSync(wtPath, { recursive: true, force: true });
+                }
+            }
+            markCandidateWorktreeRemoved(targetDir, wtPath);
+            result.removed.push(wtPath);
+        }
+        catch (e) {
+            result.failed.push(`${wtPath}: ${e.message}`);
+        }
+    }
+    try {
+        execFileSync('git', ['worktree', 'prune'], { cwd: targetDir, stdio: ['ignore', 'pipe', 'pipe'] });
+    }
+    catch { /* best-effort */ }
+    return result;
+}
+export function listWorktrees(targetDir) {
+    const wtDir = join(targetDir, '.yoke', 'worktrees');
+    const candidates = new Set();
+    if (existsSync(wtDir)) {
+        try {
+            for (const entry of readdirSync(wtDir, { withFileTypes: true })) {
+                if (entry.isDirectory())
+                    candidates.add(join(wtDir, entry.name));
+            }
+        }
+        catch { /* ignore read errors */ }
+    }
+    try {
+        const raw = execFileSync('git', ['worktree', 'list', '--porcelain'], { cwd: targetDir, stdio: ['ignore', 'pipe', 'pipe'], encoding: 'utf8' });
+        const lines = raw.split(/\r?\n/);
+        for (const line of lines) {
+            if (line.startsWith('worktree ')) {
+                const wtPath = line.slice(9).trim();
+                if (wtPath.includes('.yoke/worktrees') || wtPath.includes('.yoke\\worktrees') || wtPath.includes('/.worktrees/') || wtPath.includes('\\.worktrees\\') || wtPath.includes('-story')) {
+                    candidates.add(wtPath);
+                }
+            }
+        }
+    }
+    catch { /* not a git repo or git error */ }
+    return [...candidates];
+}
+export function listFleetWorktrees() {
+    const projects = listProjects();
+    const results = {};
+    for (const proj of projects) {
+        if (proj.root && !proj.error && existsSync(proj.root)) {
+            const list = listWorktrees(proj.root);
+            if (list.length > 0) {
+                results[proj.name || proj.root] = list;
+            }
+        }
+    }
+    return results;
+}
+export function pruneFleetWorktrees(opts = {}) {
+    const projects = listProjects();
+    const fleetResults = {};
+    for (const proj of projects) {
+        if (proj.root && !proj.error && existsSync(proj.root)) {
+            fleetResults[proj.name || proj.root] = pruneWorktrees(proj.root, opts);
+        }
+    }
+    return fleetResults;
+}

package/dist/loop/run-command.js

@@ -53,7 +53,7 @@ export function setLoopEnabled(targetDir, enabled) {
     config.loop = { ...config.loop, enabled };
     saveConfig(targetDir, config);
 }
-export function loopStatus(targetDir, now = () => new Date()) {
+export function loopStatus(targetDir, now = () => new Date(), opts) {
     const config = loadConfig(targetDir);
     const enabled = config?.loop.enabled ?? false;
     const path = prdPath(targetDir);
@@ -62,6 +62,12 @@ export function loopStatus(targetDir, now = () => new Date()) {
         const p = progress(loadPrd(path));
         prog = `${p.passed}/${p.total} stories pass`;
     }
+    const st = readStatus(targetDir);
+    if (opts?.compact) {
+        if (!st)
+            return `state=${enabled ? 'enabled' : 'disabled'} prd="${prog}"`;
+        return `state=${st.state} story=${st.story ?? 'none'} progress=${st.progress.passed}/${st.progress.total} phase=${st.phase} updated=${relativeTime(st.updatedAt, now())}`;
+    }
     const sharedPoolLine = () => {
         try {
             const pool = sharedPoolStatus();
@@ -71,7 +77,6 @@ export function loopStatus(targetDir, now = () => new Date()) {
             return `Shared pool unavailable: ${error.message}`;
         }
     };
-    const st = readStatus(targetDir);
     if (!st)
         return `Loop: ${enabled ? 'enabled' : 'disabled'}\nPRD: ${prog}\n${sharedPoolLine()}`;
     const head = `Loop: ${st.state.toUpperCase()}${st.story ? ` on ${st.story}${st.storyTitle ? ` "${st.storyTitle}"` : ''}` : ''}`;

package/dist/retrofit/command.js

@@ -8,9 +8,16 @@ import { ensureGitignore } from './gitignore.js';
 import { loadConfig, saveConfig, defaultConfig } from './config.js';
 import { loadManifest } from '../canon/manifest.js';
 import { detectHostAgent } from '../agents/host.js';
+import { pruneWorktrees } from '../loop/cleanup.js';
 export function runRetrofit(targetDir, opts) {
     const canonDir = resolveCanonDir();
     const canonVersion = loadManifest(join(canonDir, 'manifest.yaml')).version;
+    if (opts.cleanWorktrees) {
+        const pruneRes = pruneWorktrees(targetDir);
+        if (pruneRes.removed.length > 0) {
+            console.log(`Pruned ${pruneRes.removed.length} orphaned worktree(s).`);
+        }
+    }
     const detection = detectProject(targetDir);
     const agents = opts.agents && opts.agents.length > 0
         ? opts.agents
@@ -26,6 +33,19 @@ export function runRetrofit(targetDir, opts) {
     ensureGitignore(targetDir);
     const priorAgents = existing?.agents ?? [];
     const mergedAgents = [...new Set([...priorAgents, ...agents])];
+    const runnerConfig = { ...(existing?.runner ?? {}) };
+    if (opts.runnerModel !== undefined)
+        runnerConfig.model = opts.runnerModel;
+    if (opts.runnerReasoning !== undefined)
+        runnerConfig.reasoningEffort = opts.runnerReasoning;
+    let updatedWorkers = existing?.routing?.workers;
+    if (updatedWorkers && (opts.agentModels || opts.agentReasoning)) {
+        updatedWorkers = updatedWorkers.map(w => {
+            const model = opts.agentModels?.[w.agent] ?? w.model;
+            const reasoningEffort = opts.agentReasoning?.[w.agent] ?? w.reasoningEffort;
+            return { ...w, ...(model ? { model } : {}), ...(reasoningEffort ? { reasoningEffort } : {}) };
+        });
+    }
     const config = {
         ...(existing ?? defaultConfig(canonVersion)),
         canonVersion,
@@ -33,6 +53,8 @@ export function runRetrofit(targetDir, opts) {
         loop: { ...existing?.loop, enabled: opts.loop },
         codeGraph,
         codeIntelligence: { ...(existing?.codeIntelligence ?? {}), mode: codeIntelligence },
+        ...(Object.keys(runnerConfig).length > 0 ? { runner: runnerConfig } : {}),
+        ...(existing?.routing && updatedWorkers ? { routing: { ...existing.routing, workers: updatedWorkers } } : {}),
         ...(existing?.design
             ? { design: existing.design }
             : detection.ui.detected ? { design: { mode: 'auto', max: 4 } } : {}),

package/dist/retrofit/planners/claude.js

@@ -2,7 +2,7 @@ import { readFileSync } from 'node:fs';
 import { join } from 'node:path';
 import { loadManifest } from '../../canon/manifest.js';
 import { mcpServers, rtkInstruction } from '../tools.js';
-import { hasWsl } from '../wsl.js';
+import { hasWsl, hasRtk } from '../wsl.js';
 import { detectGstack } from '../gstack.js';
 import { PRESERVE_SCAFFOLD } from '../preserve.js';
 import { skillPackageActions } from '../skill-actions.js';
@@ -22,7 +22,7 @@ This project uses the Yoke harness. Baseline instructions:
 ${rtkNote ? `\n${rtkNote}\n` : ''}${composeNote ? `\n${composeNote}\n` : ''}
 ${PRESERVE_SCAFFOLD}
 `;
-export function planClaude(canonDir, targetDir, wslAvailable = hasWsl(), codeGraph = 'graphify', gstackDetected = detectGstack(targetDir), codeIntelligence = 'off') {
+export function planClaude(canonDir, targetDir, wslAvailable = (hasWsl() || hasRtk()), codeGraph = 'graphify', gstackDetected = detectGstack(targetDir), codeIntelligence = 'off', rtkAvailable) {
     const manifest = loadManifest(join(canonDir, 'manifest.yaml'));
     const actions = [];
     for (const skill of manifest.skills) {
@@ -34,8 +34,8 @@ export function planClaude(canonDir, targetDir, wslAvailable = hasWsl(), codeGra
         content: readFileSync(join(canonDir, 'AGENTS.md'), 'utf8'),
         reason: 'baseline instructions',
     });
-    // rtk: PreToolUse hook needs WSL on Windows; otherwise fall back to instruction mode.
-    const rtkHookable = wslAvailable;
+    // rtk: PreToolUse hook works natively if rtk is available, or via WSL on Windows.
+    const rtkHookable = rtkAvailable !== undefined ? (wslAvailable || rtkAvailable) : wslAvailable;
     actions.push({
         kind: 'write',
         target: 'CLAUDE.md',

package/dist/retrofit/wsl.js

@@ -1,7 +1,6 @@
 import { execFileSync } from 'node:child_process';
-// True only on Windows where a WSL distribution responds. Used to decide whether
-// rtk can use its transparent PreToolUse hook (needs WSL) or must fall back to
-// instruction mode. Never throws.
+import { join } from 'node:path';
+// True only on Windows where a WSL distribution responds.
 export function hasWsl() {
     if (process.platform !== 'win32')
         return false;
@@ -13,3 +12,24 @@ export function hasWsl() {
         return false;
     }
 }
+// True if the rtk binary is available natively or on PATH. Never throws.
+export function hasRtk() {
+    try {
+        const cmd = process.platform === 'win32' ? 'rtk.exe' : 'rtk';
+        execFileSync(cmd, ['--version'], { stdio: 'pipe', timeout: 3000 });
+        return true;
+    }
+    catch {
+        if (process.platform === 'win32') {
+            const home = process.env.USERPROFILE ?? process.env.HOME;
+            if (home) {
+                try {
+                    execFileSync(join(home, '.local', 'bin', 'rtk.exe'), ['--version'], { stdio: 'pipe', timeout: 3000 });
+                    return true;
+                }
+                catch { /* ignore */ }
+            }
+        }
+        return false;
+    }
+}

package/dist/setup/command.js

@@ -55,6 +55,8 @@ function parseAgents(value, fallback) {
     return parsed.length > 0 ? [...new Set(parsed)] : fallback;
 }
 function yes(value, fallback) {
+    if (!value)
+        return fallback;
     const normalized = value.trim().toLowerCase();
     if (['y', 'yes', 'j', 'ja', 'true', '1'].includes(normalized))
         return true;
@@ -99,6 +101,10 @@ export async function runSetup(targetDir, opts = {}) {
         let runner = defaultRunner;
         let decisionPolicy = defaultPolicy;
         let routing = defaultRouting;
+        let runnerModel = opts.runnerModel ?? existing?.runner?.model;
+        let runnerReasoning = opts.runnerReasoning ?? existing?.runner?.reasoningEffort;
+        const agentModels = { ...(opts.agentModels ?? {}) };
+        const agentReasoning = { ...(opts.agentReasoning ?? {}) };
         if (interactive && ask) {
             agents = parseAgents(await ask(`Agents [${defaultAgents.join(',')}] (${SUPPORTED_AGENTS.join(',')}|all): `), defaultAgents);
             const graphAnswer = (await ask(`Code graph [${defaultGraph}] (graphify|serena): `)).trim().toLowerCase();
@@ -112,12 +118,39 @@ export async function runSetup(targetDir, opts = {}) {
             if (policyAnswer === 'auto' || policyAnswer === 'critical')
                 decisionPolicy = policyAnswer;
             routing = yes(await ask(`Enable adaptive multi-model routing? [${defaultRouting ? 'yes' : 'no'}]: `), defaultRouting);
+            if (opts.configureModels) {
+                const configureModels = yes(await ask(`Configure model & reasoning effort per agent? [no]: `), false);
+                if (configureModels) {
+                    const rm = (await ask(`Runner model [${runnerModel ?? 'default'}]: `)).trim();
+                    if (rm)
+                        runnerModel = rm;
+                    const rr = (await ask(`Runner reasoning effort (none|low|medium|high|xhigh) [${runnerReasoning ?? 'default'}]: `)).trim();
+                    if (rr)
+                        runnerReasoning = rr;
+                    for (const a of agents) {
+                        const am = (await ask(`Model for agent "${a}" [${agentModels[a] ?? 'default'}]: `)).trim();
+                        if (am)
+                            agentModels[a] = am;
+                        const ar = (await ask(`Reasoning effort for agent "${a}" (none|low|medium|high|xhigh) [${agentReasoning[a] ?? 'default'}]: `)).trim();
+                        if (ar)
+                            agentReasoning[a] = ar;
+                    }
+                }
+            }
         }
         if (modelProviders.length && !agents.includes('qwen'))
             agents = [...agents, 'qwen'];
         if (!agents.includes(runner))
             agents = [...agents, runner];
-        const code = runRetrofit(targetDir, { loop, agents, codeGraph, codeIntelligence, host });
+        const priorRunner = existing?.runner?.agent ?? existing?.agents[0];
+        const runnerChanged = priorRunner !== undefined && priorRunner !== runner;
+        if (runnerChanged) {
+            if (opts.runnerModel === undefined)
+                runnerModel = undefined;
+            if (opts.runnerReasoning === undefined)
+                runnerReasoning = undefined;
+        }
+        const code = runRetrofit(targetDir, { loop, agents, codeGraph, codeIntelligence, host, cleanWorktrees: opts.cleanWorktrees, runnerModel, runnerReasoning, agentModels, agentReasoning });
         if (code !== 0)
             return code;
         applyActions(presetActions, targetDir, { backupDir: join(targetDir, '.yoke', 'backups', `model-presets-${Date.now()}`) });
@@ -125,14 +158,23 @@ export async function runSetup(targetDir, opts = {}) {
         if (!config)
             return 1;
         config.loop = { parallel: 'auto', isolate: true, ...config.loop, enabled: loop, decisionPolicy };
-        const priorRunner = existing?.runner?.agent ?? existing?.agents[0];
         const selectPresetModel = presetWorkers.length > 0 && runner === 'qwen' && (!existing || (priorRunner !== undefined && priorRunner !== runner));
         if (selectPresetModel && priorRunner !== 'qwen')
             config.runner = { permissions: config.runner?.permissions };
-        config.runner = { ...config.runner, agent: runner, ...(selectPresetModel && !config.runner?.model ? { model: presetWorkers[0].model } : {}) };
+        config.runner = {
+            ...config.runner,
+            agent: runner,
+            ...(runnerModel ? { model: runnerModel } : selectPresetModel && !config.runner?.model ? { model: presetWorkers[0].model } : {}),
+            ...(runnerReasoning ? { reasoningEffort: runnerReasoning } : {}),
+        };
         const existingWorkers = config.routing?.workers ?? [];
         const baseWorkers = existingWorkers.length > 0 && !opts.routingPreset ? existingWorkers : defaultRoutingWorkers(agents).filter(worker => !modelProviders.length || worker.agent !== 'qwen');
-        const workers = [...baseWorkers, ...presetWorkers.filter(worker => !baseWorkers.some(existing => existing.id === worker.id))];
+        const rawWorkers = [...baseWorkers, ...presetWorkers.filter(worker => !baseWorkers.some(existing => existing.id === worker.id))];
+        const workers = rawWorkers.map(w => {
+            const model = agentModels[w.agent] ?? w.model;
+            const reasoningEffort = agentReasoning[w.agent] ?? w.reasoningEffort;
+            return { ...w, ...(model ? { model } : {}), ...(reasoningEffort ? { reasoningEffort } : {}) };
+        });
         config.routing = {
             ...config.routing,
             enabled: routing,
@@ -145,7 +187,7 @@ export async function runSetup(targetDir, opts = {}) {
         };
         YokeConfigSchema.parse(config);
         saveConfig(targetDir, config);
-        console.log(`Yoke setup complete: agents=${agents.join(',')} · runner=${runner} · loop=${loop ? 'on' : 'off'} · routing=${routing ? 'on' : 'off'} · decisions=${decisionPolicy}`);
+        console.log(`Yoke setup complete: agents=${agents.join(',')} · runner=${runner}${runnerModel ? ` (${runnerModel})` : ''}${runnerReasoning ? ` [${runnerReasoning}]` : ''} · loop=${loop ? 'on' : 'off'} · routing=${routing ? 'on' : 'off'} · decisions=${decisionPolicy}`);
         return 0;
     }
     finally {

package/gemini-extension.json

@@ -1,6 +1,6 @@
 {
   "name": "yoke",
-  "version": "1.20.0",
+  "version": "1.21.1",
   "description": "Cross-agent coding harness for eight supported CLIs: curated skill canon, mechanical safety gates, autonomous loop with proof artifacts. CLI: npm i -g @hecer/yoke",
   "contextFileName": "GEMINI-EXTENSION.md"
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hecer/yoke",
-  "version": "1.20.0",
+  "version": "1.21.1",
   "description": "One harness, eight agents, zero trust in \"done\" — cross-agent coding harness for Claude Code, Codex CLI, Gemini CLI, Qwen Code, OpenCode, Kilo, Pi and Hermes: one skill canon, mechanical safety gates, an autonomous loop with screenshot/video proofs.",
   "type": "module",
   "bin": {