@hecer/yoke 1.10.0 → 1.11.0

package/canon/skills/yoke-retrofit/SKILL.md

@@ -1,26 +1,26 @@
----
-name: yoke-retrofit
-description: Use when asked to "retrofit", "yoke this project", or set up the Yoke harness in a project — runs the shared setup wizard and configures the same behavior for Claude, Codex, and Gemini.
----
-
-# Yoke Retrofit
-
-Set up or update Yoke through the shared `yoke setup` contract.
-
-1. Inspect the project and identify the current host (`claude`, `codex`, or `gemini`).
-2. Ask these setup questions one at a time and give a direct recommendation:
-   - target agents (recommend the current host; use `all` for deliberately cross-agent projects),
-   - code-graph tool,
-   - autonomous loop on/off,
-   - default runner (recommend the current host),
-   - decision mode: `auto` or `critical`.
-3. Recommend the code graph based on this project:
-   - **Serena** is LSP-accurate and best for large typed codebases or systematic symbol refactors where a missed reference is costly. It needs a language server per language.
-   - **graphify** is fast and multimodal, and is best for exploration, migration, onboarding, or mixed code and document repositories. Its graph is an index and can become stale.
-4. Apply the answers without a second round of prompts:
-   `yoke setup . --yes --host=<host> --agent=<agents> --code-graph=<choice> --runner=<runner> --decision-policy=<auto|critical> --loop|--no-loop`.
-   A human who runs `yoke setup .` directly receives the same five terminal questions.
-5. Show the generated report and backup paths. Existing files are backed up under `.yoke/backup/`; settings are merged where supported.
-6. If an old generated `CLAUDE.md` or `GEMINI.md` contained project-specific instructions, restore them inside its `<!-- yoke:preserve:start -->` / `<!-- yoke:preserve:end -->` block. Preserve blocks survive every later retrofit.
-
-The generated harness includes the provider-neutral `yoke-workflow` skill. It owns the planning questions, approved-plan handoff, autonomous stories, and critical-decision resume flow.
+---
+name: yoke-retrofit
+description: Use when asked to "retrofit", "yoke this project", or set up the Yoke harness in a project — runs the shared setup wizard and configures the same behavior for Claude, Codex, and Gemini.
+---
+
+# Yoke Retrofit
+
+Set up or update Yoke through the shared `yoke setup` contract.
+
+1. Inspect the project and identify the current host (`claude`, `codex`, or `gemini`).
+2. Ask these setup questions one at a time and give a direct recommendation:
+   - target agents (recommend the current host; use `all` for deliberately cross-agent projects),
+   - code-graph tool,
+   - autonomous loop on/off,
+   - default runner (recommend the current host),
+   - decision mode: `auto` or `critical`.
+3. Recommend the code graph based on this project:
+   - **Serena** is LSP-accurate and best for large typed codebases or systematic symbol refactors where a missed reference is costly. It needs a language server per language.
+   - **graphify** is fast and multimodal, and is best for exploration, migration, onboarding, or mixed code and document repositories. Its graph is an index and can become stale.
+4. Apply the answers without a second round of prompts:
+   `yoke setup . --yes --host=<host> --agent=<agents> --code-graph=<choice> --runner=<runner> --decision-policy=<auto|critical> --loop|--no-loop`.
+   A human who runs `yoke setup .` directly receives the same five terminal questions.
+5. Show the generated report and backup paths. Existing files are backed up under `.yoke/backup/`; settings are merged where supported.
+6. If an old generated `CLAUDE.md` or `GEMINI.md` contained project-specific instructions, restore them inside its `<!-- yoke:preserve:start -->` / `<!-- yoke:preserve:end -->` block. Preserve blocks survive every later retrofit.
+
+The generated harness includes the provider-neutral `yoke-workflow` skill. It owns the planning questions, approved-plan handoff, autonomous stories, and critical-decision resume flow.

package/canon/skills/yoke-workflow/SKILL.md

@@ -1,20 +1,20 @@
----
-name: yoke-workflow
-description: Use when the user asks Yoke to plan and build a feature, run stories autonomously, continue a Yoke loop, or only interrupt for major decisions.
----
-
-# Yoke Workflow
-
-Provide the same interaction contract in Claude, Codex, and Gemini.
-
-1. Read `.yoke/config.yaml`. If it is missing, offer `yoke setup . --host=<current-agent>` and run the setup flow before planning.
-2. Plan before starting the loop. Inspect the project, then ask one focused question at a time only where the answer changes product behavior, scope, architecture, security, data ownership, external cost, or an irreversible choice. Include a recommended answer. Resolve routine implementation details yourself.
-3. Summarize the agreed design in `.yoke/plan.md`, including goals, non-goals, constraints, and decisions. Use the `authoring-prd` skill to turn it into small stories with testable acceptance criteria. Run `yoke prd check .`.
-4. Ask once for approval of the complete plan and story set. Do not begin implementation before that approval.
-5. If `loop.enabled` is true, run the stories without routine follow-up questions using the configured runner. Prefer `yoke loop run . --max=5 --isolate`, report status after each batch, and continue until complete or genuinely blocked.
-6. Respect `loop.decisionPolicy`:
-   - `auto`: choose the most suitable option from the plan, current code, and established conventions. Record the interpretation and continue.
-   - `critical`: routine ambiguity is still resolved automatically. If the loop reports a pending critical decision, run `yoke loop decision .`, present its options and recommendation to the user, ask exactly that question, then run `yoke loop answer . --choice=<id> --rationale="<answer>"`. The answer command records the decision and resumes the same story.
-7. Never ask whether to run tests, review, commit, or continue to the next approved story. Those are part of the approved workflow.
-
-The user's configured commit identity is authoritative. Do not add an AI co-author unless `commit.allowCoAuthors` explicitly permits it.
+---
+name: yoke-workflow
+description: Use when the user asks Yoke to plan and build a feature, run stories autonomously, continue a Yoke loop, or only interrupt for major decisions.
+---
+
+# Yoke Workflow
+
+Provide the same interaction contract in Claude, Codex, and Gemini.
+
+1. Read `.yoke/config.yaml`. If it is missing, offer `yoke setup . --host=<current-agent>` and run the setup flow before planning.
+2. Plan before starting the loop. Inspect the project, then ask one focused question at a time only where the answer changes product behavior, scope, architecture, security, data ownership, external cost, or an irreversible choice. Include a recommended answer. Resolve routine implementation details yourself.
+3. Summarize the agreed design in `.yoke/plan.md`, including goals, non-goals, constraints, and decisions. Use the `authoring-prd` skill to turn it into small stories with testable acceptance criteria. Run `yoke prd check .`.
+4. Ask once for approval of the complete plan and story set. Do not begin implementation before that approval.
+5. If `loop.enabled` is true, run the stories without routine follow-up questions using the configured runner. Prefer `yoke loop run . --max=5 --isolate`, report status after each batch, and continue until complete or genuinely blocked.
+6. Respect `loop.decisionPolicy`:
+   - `auto`: choose the most suitable option from the plan, current code, and established conventions. Record the interpretation and continue.
+   - `critical`: routine ambiguity is still resolved automatically. If the loop reports a pending critical decision, run `yoke loop decision .`, present its options and recommendation to the user, ask exactly that question, then run `yoke loop answer . --choice=<id> --rationale="<answer>"`. The answer command records the decision and resumes the same story.
+7. Never ask whether to run tests, review, commit, or continue to the next approved story. Those are part of the approved workflow.
+
+The user's configured commit identity is authoritative. Do not add an AI co-author unless `commit.allowCoAuthors` explicitly permits it.

package/canon/tools/codex-rtk-hook.mjs

@@ -1,36 +1,36 @@
 import { spawnSync } from 'node:child_process'
-import { resolve } from 'node:path'
-import { pathToFileURL } from 'node:url'
-
-function rtkCheck(command) {
-  const result = spawnSync('rtk', ['hook', 'check', command], { encoding: 'utf8', timeout: 3000 })
-  return result.status === 0 ? result.stdout.trim() : ''
-}
-
-export function rewriteHookInput(input, check = rtkCheck) {
-  if (input?.tool_name !== 'Bash' && input?.toolName !== 'Bash') return null
-  const toolInput = input.tool_input ?? input.toolInput
-  const command = toolInput?.command
-  if (typeof command !== 'string' || command.trim() === '') return null
-  const rewritten = check(command)
-  if (!rewritten || rewritten === command) return null
-  return {
-    hookSpecificOutput: {
-      hookEventName: 'PreToolUse',
-      updatedInput: { ...toolInput, command: rewritten },
-    },
-  }
-}
-
-async function main() {
-  let raw = ''
-  for await (const chunk of process.stdin) raw += chunk
-  try {
-    const output = rewriteHookInput(JSON.parse(raw))
-    if (output) process.stdout.write(JSON.stringify(output))
-  } catch {
-    // Compression is an optimization. Malformed input must never block Codex.
-  }
-}
-
-if (process.argv[1] && pathToFileURL(resolve(process.argv[1])).href === import.meta.url) await main()
+import { resolve } from 'node:path'
+import { pathToFileURL } from 'node:url'
+
+function rtkCheck(command) {
+  const result = spawnSync('rtk', ['hook', 'check', command], { encoding: 'utf8', timeout: 3000 })
+  return result.status === 0 ? result.stdout.trim() : ''
+}
+
+export function rewriteHookInput(input, check = rtkCheck) {
+  if (input?.tool_name !== 'Bash' && input?.toolName !== 'Bash') return null
+  const toolInput = input.tool_input ?? input.toolInput
+  const command = toolInput?.command
+  if (typeof command !== 'string' || command.trim() === '') return null
+  const rewritten = check(command)
+  if (!rewritten || rewritten === command) return null
+  return {
+    hookSpecificOutput: {
+      hookEventName: 'PreToolUse',
+      updatedInput: { ...toolInput, command: rewritten },
+    },
+  }
+}
+
+async function main() {
+  let raw = ''
+  for await (const chunk of process.stdin) raw += chunk
+  try {
+    const output = rewriteHookInput(JSON.parse(raw))
+    if (output) process.stdout.write(JSON.stringify(output))
+  } catch {
+    // Compression is an optimization. Malformed input must never block Codex.
+  }
+}
+
+if (process.argv[1] && pathToFileURL(resolve(process.argv[1])).href === import.meta.url) await main()

package/canon/tools/gemini-rtk-hook.mjs

@@ -1,25 +1,25 @@
-#!/usr/bin/env node
-// Pure BeforeTool argument adapter. Never evaluates or executes tool commands.
-import { readFileSync } from 'node:fs'
-
-const record = value => value !== null && typeof value === 'object' && !Array.isArray(value)
-try {
-  const event = JSON.parse(readFileSync(0, 'utf8'))
-  if (!record(event) || typeof event.tool_name !== 'string' ||
-      (event.hook_event_name !== undefined && event.hook_event_name !== 'BeforeTool')) throw new Error('event')
-  let response = {}
-  if (event.tool_name === 'run_shell_command') {
-    if (!record(event.tool_input) || typeof event.tool_input.command !== 'string' || !event.tool_input.command.trim() || event.tool_input.command.includes('\0')) throw new Error('command')
-    const command = event.tool_input.command
-    // Restrict rewriting to simple supported invocations. Leave shell syntax,
-    // quoted executables, assignments and existing RTK wrappers untouched.
-    if (!/[;&|<>`$\r\n()]/u.test(command) && /^\s*(?:git|rg|npm|npx|cargo|pytest|go|docker|kubectl)\s/u.test(command)) {
-      const rewritten = command.trimStart().replace(/^rg\s/u, 'grep ')
-      response = { hookSpecificOutput: { tool_input: { ...event.tool_input, command: `rtk ${rewritten}` } } }
-    }
-  }
-  process.stdout.write(JSON.stringify(response) + '\n')
-} catch {
-  process.stderr.write('Invalid Gemini BeforeTool hook input\n')
-  process.exitCode = 2
-}
+#!/usr/bin/env node
+// Pure BeforeTool argument adapter. Never evaluates or executes tool commands.
+import { readFileSync } from 'node:fs'
+
+const record = value => value !== null && typeof value === 'object' && !Array.isArray(value)
+try {
+  const event = JSON.parse(readFileSync(0, 'utf8'))
+  if (!record(event) || typeof event.tool_name !== 'string' ||
+      (event.hook_event_name !== undefined && event.hook_event_name !== 'BeforeTool')) throw new Error('event')
+  let response = {}
+  if (event.tool_name === 'run_shell_command') {
+    if (!record(event.tool_input) || typeof event.tool_input.command !== 'string' || !event.tool_input.command.trim() || event.tool_input.command.includes('\0')) throw new Error('command')
+    const command = event.tool_input.command
+    // Restrict rewriting to simple supported invocations. Leave shell syntax,
+    // quoted executables, assignments and existing RTK wrappers untouched.
+    if (!/[;&|<>`$\r\n()]/u.test(command) && /^\s*(?:git|rg|npm|npx|cargo|pytest|go|docker|kubectl)\s/u.test(command)) {
+      const rewritten = command.trimStart().replace(/^rg\s/u, 'grep ')
+      response = { hookSpecificOutput: { tool_input: { ...event.tool_input, command: `rtk ${rewritten}` } } }
+    }
+  }
+  process.stdout.write(JSON.stringify(response) + '\n')
+} catch {
+  process.stderr.write('Invalid Gemini BeforeTool hook input\n')
+  process.exitCode = 2
+}

package/canon/tools/graphify.md

@@ -1,3 +1,3 @@
-# Tool: graphify (code-graph)
-
-MIT, multimodal code/doc graph. Wired as an MCP server for all three agents (stdio). Prefer symbol/graph lookups over reading whole files. Caveat: heuristic edges (INFERRED/AMBIGUOUS) and a static index that can go stale — rebuild on significant changes.
+# Tool: graphify (code-graph)
+
+MIT, multimodal code/doc graph. Wired as an MCP server for all three agents (stdio). Prefer symbol/graph lookups over reading whole files. Caveat: heuristic edges (INFERRED/AMBIGUOUS) and a static index that can go stale — rebuild on significant changes.

package/canon/tools/playwright-mcp.md

@@ -1,3 +1,3 @@
-# Tool: Playwright MCP (browser / dogfooding)
-
-Microsoft Playwright MCP, Apache-2.0. Wired as an MCP server for all three agents — the only browser tool with native MCP parity across Claude/Codex/Gemini. Used for QA, dogfooding user flows, screenshots, and deploy verification.
+# Tool: Playwright MCP (browser / dogfooding)
+
+Microsoft Playwright MCP, Apache-2.0. Wired as an MCP server for all three agents — the only browser tool with native MCP parity across Claude/Codex/Gemini. Used for QA, dogfooding user flows, screenshots, and deploy verification.

package/canon/tools/rtk.md

@@ -1,7 +1,7 @@
-# Tool: rtk (token compression)
-
-Per-agent wiring (generated by Baustein B):
-
-- **Claude Code:** PreToolUse hook auto-rewrites commands (`git status` → `rtk git status`). On Windows this needs WSL; otherwise fall back to instruction mode (this file injected into CLAUDE.md telling the agent to prefix commands with `rtk`).
-- **Codex CLI:** inject `RTK.md` / AGENTS.md instruction.
-- **Gemini CLI:** no hook system — register rtk as an MCP tool or inject the GEMINI.md instruction.
+# Tool: rtk (token compression)
+
+Per-agent wiring (generated by Baustein B):
+
+- **Claude Code:** PreToolUse hook auto-rewrites commands (`git status` → `rtk git status`). On Windows this needs WSL; otherwise fall back to instruction mode (this file injected into CLAUDE.md telling the agent to prefix commands with `rtk`).
+- **Codex CLI:** inject `RTK.md` / AGENTS.md instruction.
+- **Gemini CLI:** no hook system — register rtk as an MCP tool or inject the GEMINI.md instruction.

package/canon/tools/serena.md

@@ -1,9 +1,9 @@
-# Tool: Serena (code-graph, LSP-accurate)
-
-MIT, MCP-first. The alternative to graphify, selected via `yoke retrofit --code-graph=serena`. Serena uses real language servers (LSP) for symbol-accurate, cross-file retrieval and refactoring (`find_symbol`, `find_referencing_symbols`, rename/move) — no static index that goes stale, so it will not miss a reference.
-
-Wired as an MCP server for all three agents. Best for large, strongly-typed codebases (TypeScript, Python, Go) doing systematic refactoring, where missing a caller is costly.
-
+# Tool: Serena (code-graph, LSP-accurate)
+
+MIT, MCP-first. The alternative to graphify, selected via `yoke retrofit --code-graph=serena`. Serena uses real language servers (LSP) for symbol-accurate, cross-file retrieval and refactoring (`find_symbol`, `find_referencing_symbols`, rename/move) — no static index that goes stale, so it will not miss a reference.
+
+Wired as an MCP server for all three agents. Best for large, strongly-typed codebases (TypeScript, Python, Go) doing systematic refactoring, where missing a caller is costly.
+
 Caveat: needs one language server per language (can be fiddly on Windows for exotic languages) and requires `uv`. The launch command is a best-effort template — adjust to your install, e.g. `uvx --from git+https://github.com/oraios/serena serena-mcp-server`.
 
 Yoke disables Serena's automatic web-dashboard launch in generated MCP configurations. The

package/dist/agents/contracts.js

@@ -1,5 +1,5 @@
 import { z } from 'zod';
-export const AgentSchema = z.enum(['claude', 'codex', 'gemini']);
+export const AgentSchema = z.enum(['claude', 'codex', 'gemini', 'qwen']);
 export const PermissionProfileSchema = z.enum(['safe', 'unsafe', 'read-only']);
 export const ModelSelectionSchema = z.object({
     model: z.string().regex(/^[A-Za-z0-9][A-Za-z0-9._:/-]{0,127}$/).optional(),

package/dist/agents/host.js

@@ -7,12 +7,16 @@ export function detectHostAgent(env = process.env) {
         return 'claude';
     if (env.GEMINI_CLI)
         return 'gemini';
+    if (env.QWEN_CLI)
+        return 'qwen';
     if (env.CODEX_HOME)
         return 'codex';
     if (env.CLAUDE_CONFIG_DIR)
         return 'claude';
     if (env.GEMINI_CLI_HOME)
         return 'gemini';
+    if (env.QWEN_CLI_HOME)
+        return 'qwen';
     return undefined;
 }
 export function resolveRunnerAgent(config, explicit, host) {

package/dist/agents/providers.js

@@ -17,6 +17,13 @@ const argsFor = (agent, permissions) => {
         // Automatic review already selects workspace-write and conflicts with --sandbox.
         return ['exec', '--approve-for-me', '--json'];
     }
+    // Qwen CLI is a Gemini fork with similar arguments
+    if (agent === 'qwen') {
+        if (permissions === 'unsafe')
+            return ['--yolo', '--output-format', 'stream-json'];
+        const approval = permissions === 'read-only' ? 'plan' : 'auto_edit';
+        return ['--approval-mode', approval, '--sandbox', '--output-format', 'stream-json'];
+    }
     if (permissions === 'unsafe')
         return ['--yolo', '--output-format', 'stream-json'];
     const approval = permissions === 'read-only' ? 'plan' : 'auto_edit';
@@ -30,6 +37,12 @@ export function buildProviderInvocation(agent, prompt, cwd, permissions = 'safe'
         throw new Error('Gemini does not support the reasoningEffort selection');
     if (agent === 'gemini' && parsedSelection.nativeMultiAgent === true)
         throw new Error('Gemini does not support enabling the nativeMultiAgent selection');
+    if (agent === 'qwen' && parsedSelection.bare)
+        throw new Error('Qwen does not support the bare startup selection');
+    if (agent === 'qwen' && parsedSelection.reasoningEffort)
+        throw new Error('Qwen does not support the reasoningEffort selection');
+    if (agent === 'qwen' && parsedSelection.nativeMultiAgent === true)
+        throw new Error('Qwen does not support enabling the nativeMultiAgent selection');
     const args = argsFor(agent, permissions);
     if (output.schemaFile !== undefined || output.jsonSchema !== undefined) {
         if (agent === 'codex' && output.schemaFile && output.jsonSchema === undefined) {

package/dist/agents/telemetry.js

@@ -45,6 +45,10 @@ export function parseProviderResult(agent, output) {
                 if (event.type === 'message' && event.role === 'assistant' && typeof event.content === 'string')
                     fragments.push(event.content);
                 break;
+            case 'qwen':
+                if (event.type === 'message' && event.role === 'assistant' && typeof event.content === 'string')
+                    fragments.push(event.content);
+                break;
         }
     }
     const joined = parseJson(fragments.join(''));
@@ -130,6 +134,35 @@ export function parseProviderTelemetry(agent, lines) {
             if (aggregateCached !== undefined)
                 source.cached_input_tokens = aggregateCached;
         }
+        if (agent === 'qwen' && modelEntries.length > 0) {
+            reportedModels = modelEntries.map(([name]) => name);
+            model = firstModel?.[0];
+            const fields = {
+                input_tokens: ['input_tokens', 'inputTokens', 'promptTokenCount', 'input'],
+                output_tokens: ['output_tokens', 'outputTokens', 'candidatesTokenCount', 'output'],
+                cached_input_tokens: ['cached_input_tokens', 'cachedInputTokens', 'cachedContentTokenCount', 'cached'],
+                reasoning_output_tokens: ['reasoning_output_tokens', 'reasoningOutputTokens', 'thoughtsTokenCount', 'thoughts'],
+            };
+            const totals = {};
+            for (const [field, aliases] of Object.entries(fields)) {
+                const aggregate = aliases.map(key => finite(usage?.[key])).find(value => value !== undefined);
+                if (aggregate !== undefined) {
+                    totals[field] = aggregate;
+                    continue;
+                }
+                const values = modelEntries.map(([, value]) => {
+                    const entry = isRecord(value) ? value : {};
+                    const tokens = isRecord(entry.tokens) ? entry.tokens : entry;
+                    return aliases.map(key => finite(tokens[key])).find(value => value !== undefined);
+                });
+                if (values.every(value => value !== undefined))
+                    totals[field] = values.reduce((sum, value) => sum + value, 0);
+            }
+            source = { ...totals, ...usage };
+            const aggregateCached = finite(usage?.cached_input_tokens ?? usage?.cached);
+            if (aggregateCached !== undefined)
+                source.cached_input_tokens = aggregateCached;
+        }
         const inValue = finite(source?.input_tokens ?? source?.inputTokens ?? source?.prompt_tokens ?? source?.promptTokenCount ?? source?.input);
         const cachedValue = finite(source?.cached_input_tokens ?? source?.cache_read_input_tokens ?? source?.cachedInputTokens ?? source?.cachedContentTokenCount ?? source?.cached);
         const cacheWriteValue = finite(source?.cache_write_input_tokens ?? source?.cache_creation_input_tokens ?? source?.cacheWriteInputTokens ?? source?.cacheWrite);

package/dist/canon/manifest.js

@@ -1,7 +1,7 @@
 import { z } from 'zod';
 import { parse } from 'yaml';
 import { readFileSync } from 'node:fs';
-export const AgentSchema = z.enum(['claude', 'codex', 'gemini']);
+export const AgentSchema = z.enum(['claude', 'codex', 'gemini', 'qwen']);
 export const InvocationSchema = z.enum(['auto', 'manual']);
 export const SkillEntrySchema = z.object({
     id: z.string().min(1),

package/dist/cli.js

@@ -104,7 +104,7 @@ export function main(argv) {
     switch (cmd) {
         case 'setup': {
             const targetDir = rest.find(a => !a.startsWith('-')) ?? '.';
-            const valid = ['claude', 'codex', 'gemini'];
+            const valid = ['claude', 'codex', 'gemini', 'qwen'];
             const hostArg = rest.find(a => a.startsWith('--host='))?.slice('--host='.length);
             if (hostArg && !valid.includes(hostArg)) {
                 console.error(`Invalid --host value: ${hostArg}`);
@@ -226,7 +226,7 @@ export function main(argv) {
                 }
                 if (sub === 'run' || sub === 'resume') {
                     const provider = value('runner') ?? 'codex';
-                    if (!['codex', 'claude', 'gemini'].includes(provider))
+                    if (!['codex', 'claude', 'gemini', 'qwen'].includes(provider))
                         throw new Error('Unknown runner');
                     return runProjectGoal(targetDir, { provider: provider, selection: { model: value('model') } }).then(goal => {
                         console.log(JSON.stringify(goal));
@@ -269,7 +269,7 @@ export function main(argv) {
             const targetDir = rest.find(a => !a.startsWith('-')) ?? '.';
             const loop = rest.includes('--loop');
             const agentArg = rest.find(a => a.startsWith('--agent='))?.slice('--agent='.length);
-            const all = ['claude', 'codex', 'gemini'];
+            const all = ['claude', 'codex', 'gemini', 'qwen'];
             const agents = !agentArg || agentArg === 'all'
                 ? (agentArg === 'all' ? all : undefined)
                 : agentArg.split(',').filter((a) => all.includes(a));
@@ -468,10 +468,10 @@ export function main(argv) {
                     return 1;
                 }
                 const runnerArg = rest.find(a => a.startsWith('--runner='))?.slice('--runner='.length);
-                const valid = ['claude', 'codex', 'gemini'];
+                const valid = ['claude', 'codex', 'gemini', 'qwen'];
                 const agent = runnerArg && valid.includes(runnerArg) ? runnerArg : undefined;
                 if (runnerArg && !agent) {
-                    console.error(`Invalid --runner value: ${runnerArg} (expected claude|codex|gemini)`);
+                    console.error(`Invalid --runner value: ${runnerArg} (expected claude|codex|gemini|qwen)`);
                     return 1;
                 }
                 const isolate = rest.includes('--isolate') ? true : rest.includes('--no-isolate') ? false : undefined;
@@ -534,7 +534,7 @@ export function main(argv) {
             const idea = rest.find(a => a.startsWith('--idea='))?.slice('--idea='.length);
             const loop = rest.includes('--loop');
             const agentArg = rest.find(a => a.startsWith('--agent='))?.slice('--agent='.length);
-            const all = ['claude', 'codex', 'gemini'];
+            const all = ['claude', 'codex', 'gemini', 'qwen'];
             const agents = !agentArg || agentArg === 'all'
                 ? (agentArg === 'all' ? all : undefined)
                 : agentArg.split(',').filter((a) => all.includes(a));
@@ -553,7 +553,7 @@ export function main(argv) {
             const targetDir = rest.slice(1).find(a => !a.startsWith('-')) ?? '.';
             if (sub === 'assess') {
                 const runner = rest.find(a => a.startsWith('--runner='))?.slice('--runner='.length);
-                if (runner && !['codex', 'claude', 'gemini'].includes(runner)) {
+                if (runner && !['codex', 'claude', 'gemini', 'qwen'].includes(runner)) {
                     console.error('Invalid planning runner');
                     return 1;
                 }
@@ -565,10 +565,10 @@ export function main(argv) {
                     console.error('usage: yoke prd draft [dir] --idea="..." [--runner=<claude|codex|gemini>] [--force] [--timeout=<minutes>]');
                     return 1;
                 }
-                const valid = ['claude', 'codex', 'gemini'];
+                const valid = ['claude', 'codex', 'gemini', 'qwen'];
                 const runnerArg = rest.find(a => a.startsWith('--runner='))?.slice('--runner='.length);
                 if (runnerArg && !valid.includes(runnerArg)) {
-                    console.error(`Invalid --runner value: ${runnerArg} (expected claude|codex|gemini)`);
+                    console.error(`Invalid --runner value: ${runnerArg} (expected claude|codex|gemini|qwen)`);
                     return 1;
                 }
                 const force = rest.includes('--force');

package/dist/dashboard/discovery.js

@@ -0,0 +1,73 @@
+import { opendir, lstat, realpath } from 'node:fs/promises';
+import { delimiter, dirname, join, parse, resolve } from 'node:path';
+import { autoRegisterProject, listProjects } from './registry.js';
+const skip = new Set(['node_modules', 'vendor', 'dist', 'build', 'coverage', 'bench', 'fixtures']);
+export function discoveryRoots() {
+    const configured = process.env.YOKE_PROJECT_ROOTS?.split(delimiter).filter(Boolean);
+    const candidates = configured ?? [dirname(process.cwd()), ...listProjects().filter(p => !p.error).map(p => dirname(p.root))];
+    const roots = [...new Set(candidates.map(p => resolve(p)))].filter(p => p !== parse(p).root);
+    return roots.filter(p => !roots.some(other => other !== p && p.startsWith(other + (process.platform === 'win32' ? '\\' : '/'))));
+}
+/** Incremental traversal keeps directory IO out of the HTTP request path. */
+export function startProjectDiscovery(roots = discoveryRoots) {
+    let stopped = false;
+    let active;
+    let queue = [];
+    let visited = new Set();
+    let current;
+    const scan = async () => {
+        if (!queue.length && !current) {
+            queue = roots();
+            visited = new Set();
+        }
+        let budget = 500;
+        while (!stopped && budget-- > 0 && (current || queue.length)) {
+            if (!current) {
+                const path = queue.shift();
+                try {
+                    if ((await lstat(path)).isSymbolicLink())
+                        continue;
+                    const canonical = await realpath(path);
+                    const key = process.platform === 'win32' ? canonical.toLowerCase() : canonical;
+                    if (visited.has(key))
+                        continue;
+                    visited.add(key);
+                    autoRegisterProject(canonical);
+                    current = await opendir(canonical);
+                }
+                catch {
+                    continue;
+                }
+            }
+            try {
+                const entry = await current.read();
+                if (!entry) {
+                    await current.close();
+                    current = undefined;
+                    continue;
+                }
+                if (entry.isDirectory() && !entry.isSymbolicLink() && !entry.name.startsWith('.') && !skip.has(entry.name.toLowerCase()))
+                    queue.push(join(current.path, entry.name));
+            }
+            catch {
+                try {
+                    await current?.close();
+                }
+                catch { /* Already closed. */ }
+                current = undefined;
+            }
+        }
+    };
+    const tick = () => {
+        if (!active && !stopped)
+            active = scan().catch(() => { }).finally(() => { active = undefined; });
+        return active ?? Promise.resolve();
+    };
+    const timer = setInterval(() => { void tick(); }, 5000);
+    timer.unref();
+    void tick();
+    return { tick, get pending() { return queue.length + (current ? 1 : 0); }, async close() { stopped = true; clearInterval(timer); await active; try {
+            await current?.close();
+        }
+        catch { /* Already closed. */ } } };
+}