@hecer/yoke 1.10.0 → 1.12.0

package/dist/cli.js

@@ -1,4 +1,5 @@
 #!/usr/bin/env node
+import { MODEL_PROVIDERS } from './setup/model-presets.js';
 import { pathToFileURL } from 'node:url';
 import { realpathSync } from 'node:fs';
 import { checkProject, checkExitCode, protectAcceptance } from './check/command.js';
@@ -104,7 +105,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}`);
@@ -114,7 +115,7 @@ export function main(argv) {
             const agentTokens = agentArg === 'all' ? valid : agentArg?.split(',').map(a => a.trim());
             const invalidAgents = agentTokens?.filter(a => !valid.includes(a)) ?? [];
             if (agentArg && (invalidAgents.length > 0 || agentTokens?.length === 0)) {
-                console.error(`Invalid --agent value: ${agentArg} (expected claude,codex,gemini|all)`);
+                console.error(`Invalid --agent value: ${agentArg} (expected claude,codex,gemini,qwen|all)`);
                 return 1;
             }
             const agents = agentTokens ? [...new Set(agentTokens)] : undefined;
@@ -140,7 +141,14 @@ export function main(argv) {
                 console.error('Invalid routing strategy');
                 return 1;
             }
+            const modelProviderArg = rest.find(a => a.startsWith('--model-provider='))?.slice('--model-provider='.length);
+            const modelProviders = modelProviderArg?.split(',').map(value => value.trim());
+            if (modelProviders?.some(value => !MODEL_PROVIDERS.includes(value))) {
+                console.error('Invalid --model-provider (expected deepseek,kimi)');
+                return 1;
+            }
             return runSetup(targetDir, {
+                modelProviders: modelProviders,
                 host: hostArg, agents, runner: runnerArg,
                 codeGraph: graphArg,
                 loop, routing, decisionPolicy: policyArg,
@@ -226,7 +234,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 +277,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 +476,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;
@@ -479,7 +487,7 @@ export function main(argv) {
                 let reviewer;
                 if (reviewerArg) {
                     if (!valid.includes(reviewerArg)) {
-                        console.error(`Invalid --reviewer value: ${reviewerArg} (expected claude|codex|gemini)`);
+                        console.error(`Invalid --reviewer value: ${reviewerArg} (expected claude|codex|gemini|qwen)`);
                         return 1;
                     }
                     reviewer = reviewerArg;
@@ -522,19 +530,19 @@ 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, ...qualityFlags.options });
             }
-            console.log('usage: yoke loop <on|off|status|decision|answer|resume [--discard] [--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] [--parallel=<auto|N>] [--runner=<claude|codex|gemini>] [--reviewer=<claude|codex|gemini>] [--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|decision|answer|resume [--discard] [--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] [--parallel=<auto|N>] [--runner=<claude|codex|gemini|qwen>] [--reviewer=<claude|codex|gemini|qwen>] [--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': {
             const dir = rest.find(a => !a.startsWith('-'));
             if (!dir) {
-                console.error('usage: yoke new <dir> [--idea="..."] [--agent=claude,codex,gemini|all] [--runner=<claude|codex|gemini>] [--loop]');
+                console.error('usage: yoke new <dir> [--idea="..."] [--agent=claude,codex,gemini,qwen|all] [--runner=<claude|codex|gemini|qwen>] [--loop]');
                 return 1;
             }
             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));
@@ -543,7 +551,7 @@ export function main(argv) {
             }
             const runnerArg = rest.find(a => a.startsWith('--runner='))?.slice('--runner='.length);
             if (runnerArg && !all.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;
             }
             return runNew(dir, { idea, agents, runner: runnerArg, loop });
@@ -553,7 +561,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;
                 }
@@ -562,13 +570,13 @@ export function main(argv) {
             if (sub === 'draft') {
                 const idea = rest.find(a => a.startsWith('--idea='))?.slice('--idea='.length);
                 if (!idea) {
-                    console.error('usage: yoke prd draft [dir] --idea="..." [--runner=<claude|codex|gemini>] [--force] [--timeout=<minutes>]');
+                    console.error('usage: yoke prd draft [dir] --idea="..." [--runner=<claude|codex|gemini|qwen>] [--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');
@@ -586,7 +594,7 @@ export function main(argv) {
             }
             if (sub === 'check')
                 return runPrdCheck(targetDir);
-            console.log('usage: yoke prd <draft|check|assess> [dir] [--idea="..."] [--runner=<claude|codex|gemini>] [--story=<id>] [--reassess] [--force] [--timeout=<minutes>]');
+            console.log('usage: yoke prd <draft|check|assess> [dir] [--idea="..."] [--runner=<claude|codex|gemini|qwen>] [--story=<id>] [--reassess] [--force] [--timeout=<minutes>]');
             return 1;
         }
         case 'context': {
@@ -601,10 +609,10 @@ export function main(argv) {
         }
         case 'review': {
             const targetDir = rest.find(a => !a.startsWith('-')) ?? '.';
-            const valid = ['claude', 'codex', 'gemini'];
+            const valid = ['claude', 'codex', 'gemini', 'qwen'];
             const reviewerArg = rest.find(a => a.startsWith('--reviewer='))?.slice('--reviewer='.length);
             if (reviewerArg && !valid.includes(reviewerArg)) {
-                console.error(`Invalid --reviewer value: ${reviewerArg} (expected claude|codex|gemini)`);
+                console.error(`Invalid --reviewer value: ${reviewerArg} (expected claude|codex|gemini|qwen)`);
                 return 1;
             }
             const base = rest.find(a => a.startsWith('--base='))?.slice('--base='.length);
@@ -651,7 +659,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=claude,codex,gemini|all] [--code-graph=graphify|serena] [--loop] | change <add|status> [dir] | prd <draft|check|assess> [dir] | loop <on|off|status|decision|answer|resume|run|cleanup> | context <init|status> | review [dir] [--reviewer=<claude|codex|gemini>] [--base=<ref>] [--focus="..."] | design-scan [dir] [--max=N] [--report] | flow-smoke [dir] [--url=<baseUrl>] [--label=<name>] | upgrade>');
+            console.log('usage: yoke <setup [dir] | new <dir> [--idea="..."] | validate [canonDir] | retrofit [targetDir] [--agent=claude,codex,gemini,qwen|all] [--code-graph=graphify|serena] [--loop] | change <add|status> [dir] | prd <draft|check|assess> [dir] | loop <on|off|status|decision|answer|resume|run|cleanup> | context <init|status> | review [dir] [--reviewer=<claude|codex|gemini|qwen>] [--base=<ref>] [--focus="..."] | design-scan [dir] [--max=N] [--report] | flow-smoke [dir] [--url=<baseUrl>] [--label=<name>] | upgrade>');
             return cmd ? 1 : 0;
     }
 }

package/dist/goals/command.js

@@ -12,8 +12,8 @@ import { killProcessTreeForCleanup } from '../loop/watchdog.js';
 import { buildProviderInvocation, startProviderProcess } from '../agents/providers.js';
 import { appendEvent } from '../observability/events.js';
 import { statePath } from '../workspace/state.js';
-const Attempt = z.object({ provider: z.enum(['codex', 'claude', 'gemini']), model: z.string().optional(), startedAt: z.string(), durationMs: z.number().nonnegative(), success: z.boolean(), summary: z.string(), checkId: z.string(), inputTokens: z.number().nonnegative().optional(), outputTokens: z.number().nonnegative().optional() });
-const Goal = z.object({ version: z.literal(1), id: z.string().uuid(), objective: z.string().trim().min(1).max(16000), status: z.enum(['active', 'running', 'paused', 'blocked', 'complete']), createdAt: z.string(), updatedAt: z.string(), maxAttempts: z.number().int().min(1).max(20), maxMinutes: z.number().positive().max(1440), tokenBudget: z.number().int().positive().optional(), attempts: z.array(Attempt), reason: z.string().optional(), lastCheck: z.string().optional(), pendingAttempt: z.object({ provider: z.enum(['codex', 'claude', 'gemini']), model: z.string().optional(), startedAt: z.string().datetime() }).optional() }).strict();
+const Attempt = z.object({ provider: z.enum(['codex', 'claude', 'gemini', 'qwen']), model: z.string().optional(), startedAt: z.string(), durationMs: z.number().nonnegative(), success: z.boolean(), summary: z.string(), checkId: z.string(), inputTokens: z.number().nonnegative().optional(), outputTokens: z.number().nonnegative().optional() });
+const Goal = z.object({ version: z.literal(1), id: z.string().uuid(), objective: z.string().trim().min(1).max(16000), status: z.enum(['active', 'running', 'paused', 'blocked', 'complete']), createdAt: z.string(), updatedAt: z.string(), maxAttempts: z.number().int().min(1).max(20), maxMinutes: z.number().positive().max(1440), tokenBudget: z.number().int().positive().optional(), attempts: z.array(Attempt), reason: z.string().optional(), lastCheck: z.string().optional(), pendingAttempt: z.object({ provider: z.enum(['codex', 'claude', 'gemini', 'qwen']), model: z.string().optional(), startedAt: z.string().datetime() }).optional() }).strict();
 const goalPath = (root) => statePath(root, 'goal.json');
 function save(root, goal) {
     const parsed = Goal.parse({ ...goal, updatedAt: new Date().toISOString() });

package/dist/loop/claims.js

@@ -18,7 +18,7 @@ const RichClaimSchema = LegacyClaimSchema.extend({
     heartbeatAt: z.string().min(1),
     baseCommit: z.string().min(1).optional(),
     worktree: z.string().min(1).optional(),
-    provider: z.enum(['claude', 'codex', 'gemini']).optional(),
+    provider: z.enum(['claude', 'codex', 'gemini', 'qwen']).optional(),
     model: z.string().min(1).optional(),
     role: z.enum(['implementation', 'quality', 'repair', 'review']).optional(),
     cancellation: z.object({

package/dist/loop/decision.js

@@ -60,9 +60,9 @@ export const DecisionResumeSchema = z.object({
     answered: z.boolean().optional(),
     /** Absent preserves the default unlimited run across a critical-decision resume. */
     maxIterations: z.number().int().positive().optional(),
-    agent: z.enum(['claude', 'codex', 'gemini']).optional(),
+    agent: z.enum(['claude', 'codex', 'gemini', 'qwen']).optional(),
     isolate: z.boolean().optional(),
-    reviewer: z.enum(['claude', 'codex', 'gemini']).optional(),
+    reviewer: z.enum(['claude', 'codex', 'gemini', 'qwen']).optional(),
     review: z.boolean().optional(),
     allowSelfReview: z.boolean().optional(),
     timeoutMinutes: z.number().nonnegative().optional(),

package/dist/loop/prd.js

@@ -42,7 +42,7 @@ export const StorySchema = z.object({
     area: z.string().min(1).optional(),
     /** Advisory relative file/directory scopes; not a filesystem permission boundary. */
     writes: z.array(z.string().min(1).max(500).refine(validWriteScope, 'Write scopes must be relative non-glob paths without traversal')).max(100).optional(),
-    agent: z.enum(['claude', 'codex', 'gemini']).optional(),
+    agent: z.enum(['claude', 'codex', 'gemini', 'qwen']).optional(),
     /** Inbox request that created this story. Used for idempotent append-only intake. */
     sourceChange: z.string().min(1).optional(),
     quality: StoryQualityDeclarationSchema.optional(),

package/dist/loop/run-command.js

@@ -379,7 +379,7 @@ export function runLoopCommand(targetDir, opts) {
     let review = opts.reviewRunner;
     let reviewProvider = 'unknown';
     if (!review && (opts.review || opts.reviewer)) {
-        const reviewerAgent = opts.reviewer ?? ['codex', 'gemini', 'claude'].find(agent => agent !== runnerAgent && available(agent));
+        const reviewerAgent = opts.reviewer ?? ['codex', 'gemini', 'qwen', 'claude'].find(agent => agent !== runnerAgent && available(agent));
         if (!reviewerAgent) {
             if (!opts.allowSelfReview) {
                 console.error('No independent reviewer CLI is available. Install or select a second agent, or pass --allow-self-review explicitly.');
@@ -393,13 +393,13 @@ export function runLoopCommand(targetDir, opts) {
             return 2;
         }
         if (!available(resolvedReviewer)) {
-            console.error(`Reviewer agent CLI "${resolvedReviewer}" was not found on PATH. Install it, or pick another with --reviewer=<claude|codex|gemini>.`);
+            console.error(`Reviewer agent CLI "${resolvedReviewer}" was not found on PATH. Install it, or pick another with --reviewer=<claude|codex|gemini|qwen>.`);
             return 2;
         }
         review = context => {
             const implementer = readStatus(targetDir)?.routingDecisions?.[context.story.id]?.provider ?? runnerAgent;
             const selectedReviewer = !opts.reviewer && resolvedReviewer === implementer
-                ? ["codex", "claude", "gemini"].find(agent => agent !== implementer && available(agent)) ?? resolvedReviewer : resolvedReviewer;
+                ? ["codex", "claude", "gemini", "qwen"].find(agent => agent !== implementer && available(agent)) ?? resolvedReviewer : resolvedReviewer;
             if (selectedReviewer === implementer && !opts.allowSelfReview)
                 return { success: false, summary: "Independent review requires a provider distinct from the routed implementer", reviewOutcome: { kind: "infrastructure", summary: "Routed implementation and reviewer share a provider" } };
             reviewProvider = selectedReviewer;

package/dist/quality/types.js

@@ -1,6 +1,6 @@
 import { z } from 'zod';
 const QualityPolicySchema = z.enum(['blocking', 'advisory']);
-const QualityAgentSchema = z.enum(['claude', 'codex', 'gemini']);
+const QualityAgentSchema = z.enum(['claude', 'codex', 'gemini', 'qwen']);
 const RelativePathSchema = z.string().min(1).refine(value => !/^(?:[A-Za-z]:[\\/]|[\\/])/.test(value) && !value.split(/[\\/]+/).includes('..'), 'path must stay within the project');
 const QualityReferenceSchema = z.object({
     name: z.string().min(1),

package/dist/retrofit/apply.js

@@ -1,5 +1,6 @@
 import { chmodSync, copyFileSync, existsSync, mkdirSync, readFileSync, statSync, writeFileSync } from 'node:fs';
 import { join, dirname } from 'node:path';
+import { mergeQwenSettings } from './qwen-settings.js';
 import { mergeJson } from './merge-json.js';
 import { carryPreserved } from './preserve.js';
 export function applyActions(actions, targetDir, opts) {
@@ -28,7 +29,7 @@ export function applyActions(actions, targetDir, opts) {
                 catch {
                     throw new Error(`yoke: cannot merge ${action.target} — existing file is not valid JSON. Fix or delete it and re-run.`);
                 }
-                const merged = JSON.stringify(mergeJson(parsedCurrent, JSON.parse(action.content)), null, 2) + '\n';
+                const merged = JSON.stringify((action.target === '.qwen/settings.json' ? mergeQwenSettings : mergeJson)(parsedCurrent, JSON.parse(action.content)), null, 2) + '\n';
                 if (merged === current) {
                     results.push({ target: action.target, status: 'unchanged', reason: action.reason });
                     continue;
@@ -43,6 +44,12 @@ export function applyActions(actions, targetDir, opts) {
             }
             if (typeof action.content === 'string') {
                 const current = currentBytes.toString('utf8');
+                // Exact matches need no preservation pass. In particular, skill examples
+                // may contain literal preserve markers which must not be reinterpreted.
+                if (current === action.content) {
+                    results.push({ target: action.target, status: 'unchanged', reason: action.reason });
+                    continue;
+                }
                 // Carry user content marked with yoke preserve markers into the new file.
                 content = carryPreserved(current, action.content);
                 if (content !== action.content)

package/dist/retrofit/config.js

@@ -80,7 +80,7 @@ export const YokeConfigSchema = z.object({
             model: z.string().min(1).optional(),
             reasoningEffort: z.string().min(1).optional(),
         }).optional(),
-        workers: z.array(RoutingWorkerSchema).max(12).default([]),
+        workers: z.array(RoutingWorkerSchema).max(32).default([]),
         rules: z.array(RoutingRuleSchema).max(100).optional(),
     }).optional(),
     commit: z.object({

package/dist/retrofit/detect.js

@@ -10,6 +10,8 @@ export function detectProject(targetDir) {
         agents.push('codex');
     if (has('.gemini') || has('GEMINI.md'))
         agents.push('gemini');
+    if (has('.qwen') || has('QWEN.md'))
+        agents.push('qwen');
     return {
         agents,
         hasAgentsMd: has('AGENTS.md'),

package/dist/retrofit/plan.js

@@ -1,6 +1,7 @@
 import { planClaude } from './planners/claude.js';
 import { planCodex } from './planners/codex.js';
 import { planGemini } from './planners/gemini.js';
+import { planQwen } from './planners/qwen.js';
 import { baseContextActions } from './context-actions.js';
 export function planClaudeRetrofit(canonDir, targetDir) {
     return planClaude(canonDir, targetDir);
@@ -9,6 +10,7 @@ export const PLANNERS = {
     claude: (c, t, cg) => planClaude(c, t, undefined, cg),
     codex: planCodex,
     gemini: planGemini,
+    qwen: planQwen,
 };
 export function planRetrofit(canonDir, targetDir, agents, codeGraph = 'graphify') {
     const seen = new Set();

package/dist/retrofit/planners/qwen.js

@@ -0,0 +1,73 @@
+import { readFileSync } from 'node:fs';
+import { join } from 'node:path';
+import { loadManifest } from '../../canon/manifest.js';
+import { parseFrontmatter } from '../../canon/frontmatter.js';
+import { mcpServers, rtkInstruction } from '../tools.js';
+import { PRESERVE_SCAFFOLD } from '../preserve.js';
+import { skillPackageActions } from '../skill-actions.js';
+function tomlString(s) {
+    return '"""\n' + s.replace(/\\/g, '\\\\').replace(/"""/g, '\\"\\"\\"') + '\n"""';
+}
+export function planQwen(canonDir, _targetDir, codeGraph = 'graphify') {
+    const manifest = loadManifest(join(canonDir, 'manifest.yaml'));
+    const actions = [];
+    // QWEN.md: baseline + instruction for commands outside the rewrite hook.
+    const baseline = readFileSync(join(canonDir, 'AGENTS.md'), 'utf8');
+    const autoSkillIndex = manifest.skills
+        .filter(skill => skill.invocation === 'auto')
+        .map(skill => {
+        const source = readFileSync(join(canonDir, skill.path, 'SKILL.md'), 'utf8');
+        const description = String(parseFrontmatter(source)?.description ?? skill.id).replace(/\s+/gu, ' ').trim();
+        return `- \`/${skill.id}\` — ${description}`;
+    })
+        .join('\n');
+    actions.push({
+        kind: 'write',
+        target: 'QWEN.md',
+        content: `${baseline}\n${rtkInstruction()}\n\n## Yoke automatic skills\n\nUse the matching command when its capability is relevant:\n\n${autoSkillIndex}\n\n${PRESERVE_SCAFFOLD}\n`,
+        reason: 'baseline + rtk instruction',
+    });
+    // One TOML slash command per skill.
+    for (const skill of manifest.skills) {
+        const body = readFileSync(join(canonDir, skill.path, 'SKILL.md'), 'utf8');
+        const fm = parseFrontmatter(body) ?? {};
+        // Collapse any newlines so the single-line TOML `description = "..."` stays valid
+        // even for ported skills whose frontmatter description spans multiple lines.
+        const description = String(fm.description ?? skill.id).replace(/\s*\r?\n\s*/g, ' ').trim();
+        const skillBody = body.replace(/^---\r?\n[\s\S]*?\r?\n---\r?\n?/, '').trim();
+        const prompt = `You are using the "${skill.id}" skill.\n\n${skillBody}\n\nFollow it for the current task.`;
+        actions.push({
+            kind: 'write',
+            target: `.qwen/commands/${skill.id}.toml`,
+            content: `description = "${description.replace(/\\/g, '\\\\').replace(/"/g, '\\"')}"\nprompt = ${tomlString(prompt)}\n`,
+            reason: `qwen command: ${skill.id}`,
+        });
+        actions.push(...skillPackageActions(canonDir, skill, 'qwen'));
+    }
+    actions.push({
+        kind: 'write',
+        target: '.qwen/hooks/qwen-rtk-hook.mjs',
+        content: readFileSync(join(canonDir, 'tools/qwen-rtk-hook.mjs'), 'utf8'),
+        reason: 'portable RTK PreToolUse retry guard',
+    });
+    // Merge to preserve user MCP servers, context and unrelated hooks.
+    actions.push({
+        kind: 'write',
+        target: '.qwen/settings.json',
+        merge: true,
+        content: JSON.stringify({
+            mcpServers: mcpServers(codeGraph),
+            context: { fileName: ['AGENTS.md', 'QWEN.md'] },
+            hooks: { PreToolUse: [{ matcher: '^run_shell_command$', hooks: [{ name: 'yoke-rtk', type: 'command', command: 'node .qwen/hooks/qwen-rtk-hook.mjs' }] }] },
+        }, null, 2) + '\n',
+        reason: 'MCP servers + AGENTS.md context',
+    });
+    // Also ship AGENTS.md so the context.fileName entry resolves.
+    actions.push({
+        kind: 'write',
+        target: 'AGENTS.md',
+        content: baseline,
+        reason: 'baseline instructions (shared)',
+    });
+    return actions;
+}

package/dist/retrofit/qwen-settings.js

@@ -0,0 +1,17 @@
+import { mergeJson } from './merge-json.js';
+const record = (value) => value !== null && typeof value === 'object' && !Array.isArray(value);
+/** Remove only Yoke 1.11's inert Gemini-shaped hook, preserving unrelated hooks. */
+export function mergeQwenSettings(current, incoming) {
+    if (!record(current) || !record(current.hooks) || !Array.isArray(current.hooks.BeforeTool))
+        return mergeJson(current, incoming);
+    const beforeTool = current.hooks.BeforeTool.flatMap(group => {
+        if (!record(group) || group.matcher !== '^run_shell_command$' || !Array.isArray(group.hooks))
+            return [group];
+        const hooks = group.hooks.filter(hook => !(record(hook) && hook.name === 'yoke-rtk' && hook.type === 'command' && hook.command === 'node .qwen/hooks/qwen-rtk-hook.mjs'));
+        return hooks.length ? [{ ...group, hooks }] : [];
+    });
+    const hooks = { ...current.hooks, BeforeTool: beforeTool };
+    if (!beforeTool.length)
+        delete hooks.BeforeTool;
+    return mergeJson({ ...current, hooks }, incoming);
+}

package/dist/retrofit/skill-actions.js

@@ -4,6 +4,7 @@ const roots = {
     claude: '.claude/skills',
     codex: '.agents/skills',
     gemini: '.gemini/skills',
+    qwen: '.qwen/skills',
 };
 function manualClaudeSkill(content, skill) {
     const source = content.toString('utf8');
@@ -48,7 +49,7 @@ export function skillPackageActions(canonDir, skill, provider) {
         .map(file => ({
         kind: 'write',
         target: `${roots[provider]}/${skill.id}/${file.relativePath}`,
-        content: provider === 'claude' && skill.invocation === 'manual' && file.relativePath === 'SKILL.md'
+        content: (provider === 'claude' || provider === 'qwen') && skill.invocation === 'manual' && file.relativePath === 'SKILL.md'
             ? manualClaudeSkill(file.content, skill)
             : portableContent(file),
         executable: file.executable,

package/dist/review/command.js

@@ -5,7 +5,7 @@ import { loadConfig } from '../retrofit/config.js';
 import { parseReviewVerdict } from './verdict.js';
 // Resolve to the first available agent, preferring a *second* model so the review
 // is genuinely cross-model. claude last => a Claude-only box degrades to self-review.
-const RESOLUTION_ORDER = ['codex', 'gemini', 'claude'];
+const RESOLUTION_ORDER = ['codex', 'gemini', 'qwen', 'claude'];
 export function runReview(targetDir, opts = {}) {
     const available = opts.isAvailable ?? isAgentAvailable;
     const implementer = opts.implementer ?? loadConfig(targetDir)?.agents[0] ?? 'claude';

package/dist/routing/capability.js

@@ -68,7 +68,7 @@ export function chooseCapability(input) {
     const worker = reliable[0];
     const blocked = !worker && (input.fallback === 'block' || input.maxTier !== undefined);
     const provider = worker?.agent ?? input.story.agent ?? input.parent;
-    const selection = worker ? { model: worker.model, reasoningEffort: worker.reasoningEffort, nativeMultiAgent: false, ...(provider !== 'gemini' && input.parentSelection?.bare !== undefined ? { bare: input.parentSelection.bare } : {}) }
+    const selection = worker ? { model: worker.model, reasoningEffort: worker.reasoningEffort, nativeMultiAgent: false, ...(provider !== 'gemini' && provider !== 'qwen' && input.parentSelection?.bare !== undefined ? { bare: input.parentSelection.bare } : {}) }
         : { ...(provider === input.parent ? input.parentSelection : {}), nativeMultiAgent: false };
     const reason = `${role}: ${tiers[level]}; ${input.assessment.reason}${failures.length ? `; ${failures.length} verified failure(s), ${failures.length === 1 ? 'one targeted repair' : 'escalated'}` : ''}${worker ? '' : '; no eligible profile, parent/provider fallback'}`;
     return { worker, provider, selection, reason: blocked ? `${role}: no eligible profile within routing limits; execution blocked` : reason, blocked, requiredTier: baseTier, selectedTier: tiers[level], failures: failures.length, exhausted, next: input.maxTier && level >= tiers.indexOf(input.maxTier) ? 'stop at configured tier limit' : level < 3 ? tiers[level + 1] : 'stop after bounded attempts' };

package/dist/routing/router.js

@@ -247,7 +247,7 @@ function routingSteps(options) {
             return blocked('Selected routing profile exceeds configured limits; execution blocked');
         const provider = worker?.agent ?? options.parent;
         const selection = worker
-            ? { model: worker.model, reasoningEffort: worker.reasoningEffort, nativeMultiAgent: false, ...(provider !== 'gemini' ? { bare: options.parentSelection?.bare } : {}) }
+            ? { model: worker.model, reasoningEffort: worker.reasoningEffort, nativeMultiAgent: false, ...(provider !== 'gemini' && provider !== 'qwen' ? { bare: options.parentSelection?.bare } : {}) }
             : { ...(options.parentSelection ?? {}), nativeMultiAgent: false };
         const workerStarted = now();
         const result = yield () => makeWorker(provider, selection)(ctx);

package/dist/setup/command.js

@@ -1,10 +1,13 @@
 import { createInterface } from 'node:readline/promises';
 import { stdin as input, stdout as output } from 'node:process';
 import { detectHostAgent } from '../agents/host.js';
-import { loadConfig, saveConfig } from '../retrofit/config.js';
+import { loadConfig, saveConfig, YokeConfigSchema } from '../retrofit/config.js';
 import { detectProject } from '../retrofit/detect.js';
+import { applyActions } from '../retrofit/apply.js';
+import { join } from 'node:path';
+import { modelPresetWorkers, planModelPresets } from './model-presets.js';
 import { runRetrofit } from '../retrofit/command.js';
-const ALL_AGENTS = ['claude', 'codex', 'gemini'];
+const ALL_AGENTS = ['claude', 'codex', 'gemini', 'qwen'];
 export function defaultRoutingWorkers(agents) {
     const workers = {
         claude: [
@@ -25,6 +28,10 @@ export function defaultRoutingWorkers(agents) {
             { id: 'gemini-strong', agent: 'gemini', model: 'gemini-2.5-pro', tier: 'strong', costTier: 'medium', capabilities: ['debugging'] },
             { id: 'gemini-frontier', agent: 'gemini', model: 'gemini-2.5-pro', tier: 'frontier', costTier: 'high', capabilities: ['architecture'] },
         ],
+        qwen: [
+            // Respect the user's Qwen Code account/model. API presets are opt-in.
+            { id: 'qwen-standard', agent: 'qwen', tier: 'standard', costTier: 'medium', capabilities: ['implementation'] },
+        ],
     };
     return agents.flatMap(agent => workers[agent]);
 }
@@ -44,6 +51,9 @@ function yes(value, fallback) {
 }
 export async function runSetup(targetDir, opts = {}) {
     const existing = loadConfig(targetDir);
+    const modelProviders = opts.modelProviders ?? [];
+    const presetActions = planModelPresets(targetDir, modelProviders);
+    const presetWorkers = modelPresetWorkers(modelProviders);
     const detected = detectProject(targetDir);
     const host = opts.host ?? detectHostAgent();
     const configuredAgents = existing?.agents.filter(a => ALL_AGENTS.includes(a)) ?? [];
@@ -53,7 +63,7 @@ export async function runSetup(targetDir, opts = {}) {
             ? configuredAgents
             : detected.agents.length > 0
                 ? detected.agents
-                : [host ?? 'claude'];
+                : modelProviders.length ? ['qwen'] : [host ?? 'claude'];
     const defaultGraph = opts.codeGraph ?? existing?.codeGraph ?? 'graphify';
     const defaultLoop = opts.loop ?? existing?.loop.enabled ?? true;
     const defaultRunner = opts.runner ?? existing?.runner?.agent ?? (host && defaultAgents.includes(host) ? host : defaultAgents[0] ?? host ?? 'claude');
@@ -75,12 +85,12 @@ export async function runSetup(targetDir, opts = {}) {
         let decisionPolicy = defaultPolicy;
         let routing = defaultRouting;
         if (interactive && ask) {
-            agents = parseAgents(await ask(`Agents [${defaultAgents.join(',')}] (claude,codex,gemini|all): `), defaultAgents);
+            agents = parseAgents(await ask(`Agents [${defaultAgents.join(',')}] (claude,codex,gemini,qwen|all): `), defaultAgents);
             const graphAnswer = (await ask(`Code graph [${defaultGraph}] (graphify|serena): `)).trim().toLowerCase();
             if (graphAnswer === 'graphify' || graphAnswer === 'serena')
                 codeGraph = graphAnswer;
             loop = yes(await ask(`Enable autonomous loop? [${defaultLoop ? 'yes' : 'no'}]: `), defaultLoop);
-            const runnerAnswer = (await ask(`Default runner [${runner}] (claude|codex|gemini): `)).trim().toLowerCase();
+            const runnerAnswer = (await ask(`Default runner [${runner}] (claude|codex|gemini|qwen): `)).trim().toLowerCase();
             if (ALL_AGENTS.includes(runnerAnswer))
                 runner = runnerAnswer;
             const policyAnswer = (await ask(`Decision mode [${decisionPolicy}] (auto|critical): `)).trim().toLowerCase();
@@ -88,17 +98,26 @@ export async function runSetup(targetDir, opts = {}) {
                 decisionPolicy = policyAnswer;
             routing = yes(await ask(`Enable adaptive multi-model routing? [${defaultRouting ? 'yes' : 'no'}]: `), defaultRouting);
         }
+        if (modelProviders.length && !agents.includes('qwen'))
+            agents = [...agents, 'qwen'];
         if (!agents.includes(runner))
             agents = [...agents, runner];
         const code = runRetrofit(targetDir, { loop, agents, codeGraph, host });
         if (code !== 0)
             return code;
+        applyActions(presetActions, targetDir, { backupDir: join(targetDir, '.yoke', 'backups', `model-presets-${Date.now()}`) });
         const config = loadConfig(targetDir);
         if (!config)
             return 1;
         config.loop = { parallel: 'auto', isolate: true, ...config.loop, enabled: loop, decisionPolicy };
-        config.runner = { ...config.runner, agent: runner };
+        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 } : {}) };
         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))];
         config.routing = {
             ...config.routing,
             enabled: routing,
@@ -107,8 +126,9 @@ export async function runSetup(targetDir, opts = {}) {
             assessmentPolicy: existing?.routing?.assessmentPolicy ?? (existing ? 'on-demand' : 'prepared'),
             fallback: existing?.routing?.fallback ?? (existing ? 'parent' : 'block'),
             ...(config.routing?.orchestrator ? { orchestrator: config.routing.orchestrator } : {}),
-            workers: existingWorkers.length > 0 && !opts.routingPreset ? existingWorkers : defaultRoutingWorkers(agents),
+            workers,
         };
+        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}`);
         return 0;

package/dist/setup/model-presets.js

@@ -0,0 +1,48 @@
+import { existsSync, readFileSync } from 'node:fs';
+import { join } from 'node:path';
+export const MODEL_PROVIDERS = ['deepseek', 'kimi'];
+const PRESETS = {
+    deepseek: {
+        baseUrl: 'https://api.deepseek.com/v1', envKey: 'DEEPSEEK_API_KEY',
+        models: [
+            { id: 'deepseek-v4-flash', workerId: 'deepseek-standard', tier: 'standard', costTier: 'low', contextWindowSize: 1_000_000 },
+            { id: 'deepseek-v4-pro', workerId: 'deepseek-strong', tier: 'strong', costTier: 'medium', contextWindowSize: 1_000_000 },
+        ],
+    },
+    kimi: {
+        baseUrl: 'https://api.moonshot.ai/v1', envKey: 'MOONSHOT_API_KEY',
+        models: [
+            { id: 'kimi-k2.6', workerId: 'kimi-standard', tier: 'standard', costTier: 'medium', contextWindowSize: 262_144 },
+            { id: 'kimi-k2.7-code', workerId: 'kimi-strong', tier: 'strong', costTier: 'medium', contextWindowSize: 262_144 },
+            { id: 'kimi-k3', workerId: 'kimi-frontier', tier: 'frontier', costTier: 'high', contextWindowSize: 1_000_000 },
+        ],
+    },
+};
+export function modelPresetWorkers(providers) {
+    return [...new Set(providers)].flatMap(provider => PRESETS[provider].models.map(model => ({
+        id: model.workerId, agent: 'qwen', model: `openai::${model.id}`, tier: model.tier,
+        costTier: model.costTier, capabilities: ['implementation'],
+    })));
+}
+/** Explicit opt-in only. Keep user routes intact; new entries contain only environment key references. */
+export function planModelPresets(targetDir, providers) {
+    if (!providers.length)
+        return [];
+    const file = join(targetDir, '.qwen/settings.json');
+    const settings = existsSync(file) ? JSON.parse(readFileSync(file, 'utf8')) : {};
+    if (!settings || typeof settings !== 'object' || Array.isArray(settings))
+        throw Error('Qwen settings must be an object');
+    if (settings.modelProviders !== undefined && (!settings.modelProviders || typeof settings.modelProviders !== 'object' || Array.isArray(settings.modelProviders)))
+        throw Error('Qwen modelProviders must be an object');
+    const existing = settings.modelProviders?.openai ?? [];
+    if (!Array.isArray(existing) || existing.some(model => !model || typeof model.id !== 'string'))
+        throw Error('Qwen modelProviders.openai must be an array of models with ids');
+    const entries = [...new Set(providers)].flatMap(provider => {
+        const preset = PRESETS[provider];
+        return preset.models.filter(model => !existing.some(entry => entry.id === model.id)).map(model => ({
+            id: model.id, baseUrl: preset.baseUrl, envKey: preset.envKey,
+            generationConfig: { contextWindowSize: model.contextWindowSize },
+        }));
+    });
+    return [{ kind: 'write', target: '.qwen/settings.json', merge: true, content: JSON.stringify({ modelProviders: { openai: entries } }, null, 2) + '\n', reason: 'explicit DeepSeek/Kimi API model presets (environment key references only)' }];
+}