maskweaver 0.10.1 → 0.11.0

package/dist/plugin/tools/command-registry.js

@@ -91,7 +91,7 @@ const INLINE_DEFAULT = {
             name: 'craft',
             aliases: [],
             deprecatedAliases: [],
-            description: 'Prepare execution context for a phase (phase auto-select if omitted)',
+            description: '[DEPRECATED] Use build instead — it now auto-approves and runs craft+build+verify',
             category: 'execution',
             args: [
                 { name: 'phaseId', type: 'string', required: false, description: 'Phase ID (auto-select if omitted)' },
@@ -99,7 +99,7 @@ const INLINE_DEFAULT = {
             ],
             mdFile: 'weave-craft.md',
             handler: 'handleCraft',
-            examples: ['weave command=craft', 'weave command=craft phaseId="P1"'],
+            examples: ['weave command=build (use this instead)'],
         },
         {
             name: 'build',
@@ -112,6 +112,7 @@ const INLINE_DEFAULT = {
                 { name: 'phaseIds', type: 'string', required: false, description: 'Comma-separated phase IDs for run action' },
                 { name: 'buildId', type: 'string', required: false, description: 'Build ID for status/stop/resume/sync actions' },
                 { name: 'maxRetries', type: 'number', default: 3, min: 1, max: 10, description: 'Maximum retries per task (for run action)' },
+                { name: 'taskResults', type: 'string', required: false, description: 'JSON array of TaskResult from previous wave (for resume)' },
                 { name: 'maxIterations', type: 'number', default: 1, min: 1, max: 20, description: 'Maximum loop iterations before blocking' },
                 { name: 'maxNoProgress', type: 'number', default: 1, min: 0, max: 10, description: 'Maximum repeated no-progress failures before blocking' },
             ],
@@ -216,12 +217,14 @@ const INLINE_DEFAULT = {
             args: [
                 { name: 'sync', type: 'boolean', default: false, description: 'Force regenerate agent .md files from config pool' },
                 { name: 'init', type: 'boolean', default: false, description: 'Create default maskweaver.config.json with pool template' },
+                { name: 'force', type: 'boolean', default: false, description: 'Force re-detect subscription and overwrite maskweaver.config.json' },
             ],
             mdFile: 'weave-agents.md',
             handler: 'handleAgents',
             examples: [
                 'weave command=agents sync=true',
                 'weave command=agents init=true',
+                'weave command=agents force=true',
             ],
         },
         {

package/dist/plugin/tools/weave.d.ts

@@ -13,6 +13,7 @@ export declare function createWeaveTool(): {
         }>>;
         sync: z.ZodOptional<z.ZodBoolean>;
         init: z.ZodOptional<z.ZodBoolean>;
+        force: z.ZodOptional<z.ZodBoolean>;
         docsPath: z.ZodOptional<z.ZodString>;
         phaseId: z.ZodOptional<z.ZodString>;
         projectName: z.ZodOptional<z.ZodString>;
@@ -56,6 +57,7 @@ export declare function createWeaveTool(): {
         deep: z.ZodOptional<z.ZodBoolean>;
         maxRetries: z.ZodOptional<z.ZodNumber>;
         buildId: z.ZodOptional<z.ZodString>;
+        taskResults: z.ZodOptional<z.ZodString>;
         phaseIds: z.ZodOptional<z.ZodString>;
     };
     execute: (args: {
@@ -97,6 +99,7 @@ export declare function createWeaveTool(): {
         deep?: boolean;
         maxRetries?: number;
         buildId?: string;
+        taskResults?: string;
         phaseIds?: string;
     }, context: {
         worktree: string;

package/dist/plugin/tools/weave.js

@@ -18,8 +18,7 @@ import { archiveChange } from '../../weave/stages/archive.js';
 import { generateStatusReport, handleUserResponse } from '../../weave/stages/handoff.js';
 import { analyzeCodebase, runGraphifyAnalysis, readMapResult } from '../../weave/stages/map.js';
 import { interview as interviewStage, listInterviewStates } from '../../weave/stages/intake.js';
-import { executeBuildLoop, generateBuildState, generateBuildId, loadBuildState } from '../../weave/stages/build.js';
-import { WeaveOrchestrator } from '../../weave/orchestrator.js';
+import { generateBuildId } from '../../weave/stages/build.js';
 import { getPhaseManager } from '../../weave/phase-manager.js';
 import { recommendVerificationCommands, formatRecommendedCommandsAsBash } from '../../weave/verification/index.js';
 import { createWeaveWorktree, listWeaveWorktrees, resolveWeaveWorktree, removeWeaveWorktree, ensureIgnoreOverride, ensureWeaveState, } from '../../weave/worktree.js';
@@ -27,10 +26,11 @@ import { ensureGitRepo, stageAllChanges, listStagedFiles, hasStagedChanges, comm
 import { scanFilesForSecrets, loadSecretScanConfig, shouldBlockOnFindings, formatSecretScanReport } from '../../weave/security/secret-scan.js';
 import { searchTroubleshooting, recordTroubleshooting, GlobalKnowledge } from '../../weave/knowledge/global.js';
 import { ensureChangeArtifact, readChangeMetadata, writeChangeVerificationReport } from '../../weave/change-artifacts.js';
+import { advanceBuildStep } from '../../weave/wave-executor.js';
 import { analyzeParallelOpportunities, executionPlanToSquadTasks } from '../../weave/bridge.js';
 import { acquireLoopOperatorLock, appendLoopEvent, createLoopRun, ensureLoopContract, listLoopRuns, readLoopRun, releaseLoopOperatorLock, refreshLoopOperatorLock, requestLoopStop, toLoopOperatorStatePath, resolveLoopId, toLoopRunPath, updateLoopRun, writeLoopOperatorState, writeLoopAttemptControllerNotes, writeLoopAttemptTaskBundle, writeLoopAttemptWorkerBrief, writeLoopAttemptVerificationReport, } from '../../weave/loop.js';
 import { getEffectiveGdcConfig, runGdcMachineCommand, countGdcCheckIssues, getStatsNodeSummary, } from '../../weave/gdc.js';
-import { generatePoolAgentFilesFromConfig, writeDefaultRuntimeConfig, writeDefaultPluginConfig, } from '../../shared/generate-agents.js';
+import { generatePoolAgentFilesFromConfig, writeDefaultRuntimeConfig, writeDefaultPluginConfig, writeAutoDetectedConfig, formatProviderChecklist, } from '../../shared/generate-agents.js';
 import { resolveCommand, loadCommandsJson } from './command-registry.js';
 export function createWeaveTool() {
     return {
@@ -61,6 +61,8 @@ export function createWeaveTool() {
                 .describe('Force regenerate agent .md files from config pool (for agents command)'),
             init: z.boolean().optional()
                 .describe('Create default maskweaver.config.json with pool template (for agents command)'),
+            force: z.boolean().optional()
+                .describe('Force re-detect subscription and overwrite maskweaver.config.json (for agents command)'),
             docsPath: z.string().optional()
                 .describe('Path to requirements documents (for design command)'),
             phaseId: z.string().optional()
@@ -129,6 +131,8 @@ export function createWeaveTool() {
                 .describe('Maximum retries per task (for build command)'),
             buildId: z.string().optional()
                 .describe('Build ID to resume (for build-resume command)'),
+            taskResults: z.string().optional()
+                .describe('JSON array of TaskResult from previous wave (for resume)'),
             phaseIds: z.string().optional()
                 .describe('Comma-separated phase IDs (for build command)'),
         },
@@ -163,7 +167,7 @@ export function createWeaveTool() {
                         result = await handleApprovePlan(args, basePath);
                         break;
                     case 'craft':
-                        result = await handleCraft(args, basePath);
+                        result = '> ⚠️ `craft` is deprecated. Use `weave command=build` instead — it now auto-approves and runs the full build loop (craft + build + verify).\n\n' + await handleBuildUnified(args, basePath);
                         break;
                     case 'build':
                         result = await handleBuildUnified(args, basePath);
@@ -1945,48 +1949,90 @@ async function handleInterview(args, basePath) {
 }
 async function handleBuild(args, basePath) {
     const lines = [];
-    lines.push('## 🏗️ Build');
+    lines.push('## 🏗️ Build (Wave)');
     lines.push('');
     const manager = getPhaseManager(basePath);
     const plan = await manager.loadPlan();
     if (!plan) {
-        return 'Error: No active plan found. Run `weave command=design docsPath="docs/"` first.';
+        return 'Error: No active plan found. Run `weave command=prepare docsPath="docs/"` first.';
     }
     if (!plan.planApproved) {
-        return 'Error: Plan not approved. Run `weave command=approve` first.';
+        plan.planApproved = true;
+        plan.planApprovedAt = new Date().toISOString();
+        plan.planApprovalNotes = 'Auto-approved by build command.';
+        await manager.savePlan(plan);
+        lines.push(`> ⚡ Plan auto-approved: **${plan.projectName}**`);
+        lines.push('');
     }
-    lines.push(`Plan: **${plan.projectName}** (approved at ${plan.planApprovedAt || 'N/A'})`);
-    lines.push('');
-    const orchestrator = new WeaveOrchestrator();
+    const changeId = plan.activeChangeId || plan.planName || 'main';
     const buildId = generateBuildId();
-    const state = generateBuildState(buildId, plan.planName || plan.projectName, args.maxRetries || 3);
-    const onMessages = [];
-    lines.push('Starting autonomous build loop...');
-    lines.push('');
-    const result = await executeBuildLoop({
-        plan,
-        state,
-        orchestrator,
-        basePath,
-        maxRetries: args.maxRetries,
-        phaseIds: args.phaseIds ? args.phaseIds.split(',').map((id) => id.trim()).filter(Boolean) : undefined,
-        onMessage: (msg) => { onMessages.push(msg); },
-    });
-    for (const msg of onMessages) {
-        lines.push(msg);
-    }
+    lines.push(`Plan: **${plan.projectName}** (approved at ${plan.planApprovedAt || 'N/A'})`);
+    lines.push(`Build: \`${buildId}\``);
     lines.push('');
-    if (result.success) {
-        lines.push('## ✅ Build Complete');
-    }
-    else {
-        lines.push('## ⚠️ Build Blocked');
+    try {
+        const decision = await advanceBuildStep({
+            plan,
+            basePath,
+            buildId,
+            changeId,
+            maxRetries: args.maxRetries || 3,
+            phaseIds: args.phaseIds ? args.phaseIds.split(',').map(s => s.trim()).filter(Boolean) : undefined,
+        });
+        switch (decision.kind) {
+            case 'dispatch_wave': {
+                lines.push(`### Wave ${decision.wave.waveIndex} — ${decision.contracts.length} task(s)`);
+                lines.push(`Parallel-safe: ${decision.wave.parallelSafe ? '✅ Yes' : '⚠️ No (sequential)'}`);
+                lines.push('');
+                for (const contract of decision.contracts) {
+                    lines.push(`#### ${contract.taskId} — \`${contract.subagentType}\`${contract.mask ? ` (${contract.mask})` : ''}`);
+                    lines.push(`- Allowed: ${contract.allowedPaths.length > 0 ? contract.allowedPaths.join(', ') : '*'}`);
+                    lines.push(`- Verify: ${contract.verifyCommands.join('; ') || 'none'}`);
+                    lines.push(`- Brief: \`${contract.briefPath}\``);
+                    lines.push(`- Context: \`${contract.contextPath}\``);
+                    lines.push('');
+                    lines.push('```');
+                    lines.push(`Task(${contract.subagentType}, prompt=Read ${contract.briefPath} and execute the task.)`);
+                    lines.push('```');
+                    lines.push('');
+                }
+                lines.push('---');
+                lines.push(`After Task() calls complete, pass results:`);
+                lines.push('```');
+                lines.push(`weave command=build action=resume buildId="${buildId}" taskResults='[{"taskId":"<id>","phaseId":"<pid>","status":"succeeded","changedFiles":["file.ts"],"createdSymbols":[],"downstreamExports":[]}]'`);
+                lines.push('```');
+                break;
+            }
+            case 'verify': {
+                lines.push(`### Verifying Wave ${decision.waveIndex}`);
+                lines.push('Running verification commands...');
+                break;
+            }
+            case 'repair': {
+                lines.push(`### 🔧 Repair: ${decision.contract.taskId}`);
+                lines.push(`Failure: ${decision.failureKind}`);
+                lines.push('');
+                lines.push('```');
+                lines.push(`Task(${decision.contract.subagentType}, prompt=Read ${decision.contract.briefPath} and fix the issues.)`);
+                lines.push('```');
+                break;
+            }
+            case 'blocked': {
+                lines.push(`### ⛔ Blocked`);
+                lines.push(decision.reason);
+                if (decision.failedTasks.length > 0) {
+                    lines.push(`Failed tasks: ${decision.failedTasks.join(', ')}`);
+                }
+                break;
+            }
+            case 'complete': {
+                lines.push('### ✅ Build Complete');
+                lines.push(decision.summary);
+                break;
+            }
+        }
     }
-    lines.push('');
-    lines.push(result.summary);
-    if (result.tasksEscalated > 0 || result.tasksFailed > 0) {
-        lines.push('');
-        lines.push('To resume after fixing issues: `weave command=build-resume buildId="<buildId>"`');
+    catch (e) {
+        lines.push(`❌ Error: ${e instanceof Error ? e.message : String(e)}`);
     }
     return lines.join('\n');
 }
@@ -1995,31 +2041,87 @@ async function handleBuildResume(args, basePath) {
     lines.push('## 🔄 Build Resume');
     lines.push('');
     if (!args.buildId) {
-        return 'Error: buildId is required. Use `weave command=build-resume buildId="<id>"`.';
-    }
-    const state = await loadBuildState(basePath, args.buildId);
-    if (!state) {
-        return `Error: Build state not found: ${args.buildId}`;
-    }
-    if (state.status !== 'blocked') {
-        return `Build ${args.buildId} is not blocked (status: ${state.status}). No need to resume.`;
+        return 'Error: buildId is required. Use `weave command=build action=resume buildId="<id>"`.';
     }
     const manager = getPhaseManager(basePath);
     const plan = await manager.loadPlan();
     if (!plan) {
         return 'Error: No active plan found.';
     }
-    state.status = 'running';
-    state.escalationReason = undefined;
-    const orchestrator = new WeaveOrchestrator();
-    const result = await executeBuildLoop({
-        plan,
-        state,
-        orchestrator,
-        basePath,
-        maxRetries: args.maxRetries || 3,
-    });
-    lines.push(result.summary);
+    const changeId = plan.activeChangeId || plan.planName || 'main';
+    let lastResults = [];
+    if (args.taskResults) {
+        try {
+            lastResults = JSON.parse(args.taskResults);
+        }
+        catch {
+            lines.push('> ⚠️ Could not parse taskResults, proceeding without previous results.');
+        }
+    }
+    else {
+        lines.push('> ⚠️ No taskResults provided. Pass results from Task() calls as JSON:');
+        lines.push('> `weave command=build action=resume buildId="..." taskResults=\'[{"taskId":"...","phaseId":"...","status":"succeeded","changedFiles":[],"createdSymbols":[],"downstreamExports":[]}]\'`');
+        lines.push('');
+    }
+    try {
+        const decision = await advanceBuildStep({
+            plan,
+            basePath,
+            buildId: args.buildId,
+            changeId,
+            lastResults: lastResults.length > 0 ? lastResults : undefined,
+            maxRetries: args.maxRetries || 3,
+        });
+        switch (decision.kind) {
+            case 'dispatch_wave': {
+                lines.push(`### Next Wave ${decision.wave.waveIndex} — ${decision.contracts.length} task(s)`);
+                lines.push(`Parallel-safe: ${decision.wave.parallelSafe ? '✅ Yes' : '⚠️ No'}`);
+                lines.push('');
+                for (const contract of decision.contracts) {
+                    lines.push(`#### ${contract.taskId} — \`${contract.subagentType}\``);
+                    lines.push('```');
+                    lines.push(`Task(${contract.subagentType}, prompt=Read ${contract.briefPath} and execute the task.)`);
+                    lines.push('```');
+                    lines.push('');
+                }
+                lines.push(`After Task() calls complete, pass results:`);
+                lines.push('```');
+                lines.push(`weave command=build action=resume buildId="${args.buildId}" taskResults='[{"taskId":"<id>","phaseId":"<pid>","status":"succeeded","changedFiles":["file.ts"],"createdSymbols":[],"downstreamExports":[]}]'`);
+                lines.push('```');
+                break;
+            }
+            case 'repair': {
+                lines.push(`### 🔧 Repair: ${decision.contract.taskId}`);
+                lines.push(`Failure: ${decision.failureKind}`);
+                lines.push('```');
+                lines.push(`Task(${decision.contract.subagentType}, prompt=Read ${decision.contract.briefPath} and fix.)`);
+                lines.push('```');
+                lines.push('');
+                lines.push(`After fix, pass results:`);
+                lines.push('```');
+                lines.push(`weave command=build action=resume buildId="${args.buildId}" taskResults='[{"taskId":"${decision.contract.taskId}","phaseId":"${decision.contract.phaseId}","status":"succeeded","changedFiles":[],"createdSymbols":[],"downstreamExports":[]}]'`);
+                lines.push('```');
+                break;
+            }
+            case 'blocked': {
+                lines.push('### ⛔ Build Blocked');
+                lines.push(decision.reason);
+                break;
+            }
+            case 'complete': {
+                lines.push('### ✅ Build Complete');
+                lines.push(decision.summary);
+                break;
+            }
+            case 'verify': {
+                lines.push(`### Verifying Wave ${decision.waveIndex}...`);
+                break;
+            }
+        }
+    }
+    catch (e) {
+        lines.push(`❌ Error: ${e instanceof Error ? e.message : String(e)}`);
+    }
     return lines.join('\n');
 }
 async function handleCraft(args, basePath) {
@@ -2429,6 +2531,59 @@ async function handleInitConfig(basePath) {
     lines.push('>   with your model pool, then run `weave sync-agents` in any project to apply it.');
     return lines.join('\n');
 }
+async function handleWaveBuildStatus(buildId, basePath) {
+    const manager = getPhaseManager(basePath);
+    const plan = await manager.loadPlan();
+    if (!plan)
+        return null;
+    const changeId = plan.activeChangeId || plan.planName || 'main';
+    const buildDir = path.join(basePath, 'changes', changeId, 'builds', buildId);
+    if (!fs.existsSync(buildDir))
+        return null;
+    const lines = [];
+    lines.push(`## Wave Build Status: \`${buildId}\``);
+    lines.push('');
+    const wavesDir = path.join(buildDir, 'waves');
+    if (fs.existsSync(wavesDir)) {
+        const waveFiles = fs.readdirSync(wavesDir).filter(f => f.startsWith('wave-')).sort();
+        for (const wf of waveFiles) {
+            const content = fs.readFileSync(path.join(wavesDir, wf), 'utf-8');
+            lines.push(`### ${wf.replace('.md', '')}`);
+            lines.push('```');
+            lines.push(content.slice(0, 2000));
+            lines.push('```');
+            lines.push('');
+        }
+    }
+    const tasksDir = path.join(buildDir, 'tasks');
+    if (fs.existsSync(tasksDir)) {
+        const taskDirs = fs.readdirSync(tasksDir, { withFileTypes: true }).filter(d => d.isDirectory());
+        lines.push(`### Tasks (${taskDirs.length})`);
+        lines.push('');
+        for (const td of taskDirs) {
+            const resultPath = path.join(tasksDir, td.name, 'result.md');
+            const briefPath = path.join(tasksDir, td.name, 'brief.md');
+            if (fs.existsSync(resultPath)) {
+                const resultContent = fs.readFileSync(resultPath, 'utf-8');
+                const statusMatch = resultContent.match(/\*\*Status:\*\*\s*(\w+)/);
+                lines.push(`- ${td.name}: ${statusMatch?.[1] || 'unknown'}`);
+            }
+            else if (fs.existsSync(briefPath)) {
+                lines.push(`- ${td.name}: dispatched (no result yet)`);
+            }
+        }
+        lines.push('');
+    }
+    const contextIndexPath = path.join(buildDir, 'context-index.yaml');
+    if (fs.existsSync(contextIndexPath)) {
+        lines.push('### Context Index');
+        lines.push('```yaml');
+        lines.push(fs.readFileSync(contextIndexPath, 'utf-8').slice(0, 1500));
+        lines.push('```');
+        lines.push('');
+    }
+    return lines.join('\n');
+}
 async function handleBuildUnified(args, basePath) {
     const action = args.action || 'run';
     switch (action) {
@@ -2439,13 +2594,16 @@ async function handleBuildUnified(args, basePath) {
         case 'status': {
             const loopId = args.buildId || args.loopId;
             if (!loopId)
-                return 'Error: buildId or loopId is required for status action. Example: weave command=build action=status buildId="build-20250428-a1b2"';
+                return 'Error: buildId is required. Example: weave command=build action=status buildId="build-20250428-a1b2"';
+            const waveStatus = await handleWaveBuildStatus(loopId, basePath);
+            if (waveStatus)
+                return waveStatus;
             return handleLoopStatus({ loopId }, basePath);
         }
         case 'stop': {
             const loopId = args.buildId || args.loopId;
             if (!loopId)
-                return 'Error: buildId or loopId is required for stop action. Example: weave command=build action=stop buildId="build-20250428-a1b2"';
+                return 'Error: buildId is required. Example: weave command=build action=stop buildId="build-20250428-a1b2"';
             return handleLoopStop({ loopId, context: undefined }, basePath);
         }
         case 'list':
@@ -2461,10 +2619,20 @@ async function handleBuildUnified(args, basePath) {
     }
 }
 async function handleAgents(args, basePath) {
-    if (!args.sync && !args.init) {
-        return 'Error: agents requires an action. Use `sync=true` to regenerate agent files, or `init=true` to create default config.';
+    if (!args.sync && !args.init && !args.force) {
+        return 'Error: agents requires an action. Use `sync=true` to regenerate agent files, `init=true` to create default config, or `force=true` to re-detect subscription and overwrite config.';
     }
     const sections = [];
+    if (args.force) {
+        const result = writeAutoDetectedConfig(basePath, true);
+        if (result) {
+            sections.push(`## ✅ Config Force-Updated\n\nAuto-detected subscription: \`${result.detection.primary}\` (${result.detection.subscriptions.join(', ')})\n\n\`\`\`\n${formatProviderChecklist(result.detection)}\n\`\`\`\n\nWrote to: \`${toWorkspaceRelative(basePath, result.path)}\``);
+        }
+        else {
+            sections.push('## ❌ Force update failed\n\nCould not auto-detect subscription. Make sure opencode CLI is available.');
+        }
+        sections.push(await handleSyncAgents(basePath));
+    }
     if (args.sync) {
         sections.push(await handleSyncAgents(basePath));
     }

package/dist/shared/config.d.ts

@@ -117,6 +117,7 @@ export interface ModelPoolEntry {
     maxConcurrent: number;
     capabilities: ModelCapability[];
     costTier: ModelCostTier;
+    priority?: number;
     description?: string;
 }
 export type DummyHumansConfig = Record<string, string> | {

package/dist/shared/generate-agents.d.ts

@@ -35,7 +35,7 @@ export declare function detectSubscriptionsFromConfig(opencodeConfig: Record<str
 export declare function buildPoolFromDetection(detection: SubscriptionDetectionResult): any[];
 export declare function buildConfigFromDetection(detection: SubscriptionDetectionResult): Record<string, any>;
 export declare function formatProviderChecklist(detection: SubscriptionDetectionResult): string;
-export declare function writeAutoDetectedConfig(projectDir: string): {
+export declare function writeAutoDetectedConfig(projectDir: string, force?: boolean): {
     path: string;
     detection: SubscriptionDetectionResult;
 } | null;
@@ -48,6 +48,7 @@ export declare const DEFAULT_RUNTIME_CONFIG_TEMPLATE: {
             readonly maxConcurrent: 5;
             readonly capabilities: readonly ["search", "formatting", "simple-coding", "file-ops"];
             readonly costTier: "low";
+            readonly priority: 1;
             readonly description: "DeepSeek V4 Flash - 빠름. 단순 검색/포매팅/파일작업";
         }, {
             readonly id: "deepseek-general";
@@ -56,6 +57,7 @@ export declare const DEFAULT_RUNTIME_CONFIG_TEMPLATE: {
             readonly maxConcurrent: 3;
             readonly capabilities: readonly ["coding", "testing", "refactoring", "backend"];
             readonly costTier: "medium";
+            readonly priority: 2;
             readonly description: "DeepSeek V4 Flash - 일반. 코딩/리팩토링/백엔드";
         }, {
             readonly id: "qwen-vision";
@@ -64,6 +66,7 @@ export declare const DEFAULT_RUNTIME_CONFIG_TEMPLATE: {
             readonly maxConcurrent: 3;
             readonly capabilities: readonly ["vision", "frontend", "testing"];
             readonly costTier: "medium";
+            readonly priority: 1;
             readonly description: "Qwen 3.6 Plus - 비전. 이미지 분석/프론트엔드/테스트";
         }, {
             readonly id: "deepseek-pro";
@@ -72,6 +75,7 @@ export declare const DEFAULT_RUNTIME_CONFIG_TEMPLATE: {
             readonly maxConcurrent: 2;
             readonly capabilities: readonly ["architecture", "debugging", "reasoning", "complex-coding", "refactoring"];
             readonly costTier: "high";
+            readonly priority: 2;
             readonly description: "DeepSeek V4 Pro - 고급 추론. 아키텍처/복잡 디버깅";
         }, {
             readonly id: "kimi-vision";
@@ -80,6 +84,7 @@ export declare const DEFAULT_RUNTIME_CONFIG_TEMPLATE: {
             readonly maxConcurrent: 2;
             readonly capabilities: readonly ["vision", "reasoning", "complex-coding", "architecture", "debugging"];
             readonly costTier: "high";
+            readonly priority: 1;
             readonly description: "Kimi K2.6 - 비전 고급. 이미지 분석/복잡 추론";
         }];
     };

package/dist/shared/generate-agents.js

@@ -271,6 +271,7 @@ function buildZaiPool() {
             maxConcurrent: 1,
             capabilities: ['search', 'formatting', 'simple-coding', 'file-ops'],
             costTier: 'low',
+            priority: 1,
             description: 'GLM-5 Turbo - 빠름. 단순 검색/포매팅/파일작업',
         },
         {
@@ -280,6 +281,7 @@ function buildZaiPool() {
             maxConcurrent: 10,
             capabilities: ['coding', 'testing', 'refactoring', 'backend'],
             costTier: 'medium',
+            priority: 1,
             description: 'GLM-5.1 - 일반. 코딩/리팩토링/백엔드',
         },
         {
@@ -289,6 +291,7 @@ function buildZaiPool() {
             maxConcurrent: 10,
             capabilities: ['architecture', 'debugging', 'reasoning', 'complex-coding', 'refactoring'],
             costTier: 'high',
+            priority: 1,
             description: 'GLM-5.1 - 고급 추론. 아키텍처/복잡 디버깅',
         },
     ];
@@ -302,6 +305,7 @@ function buildOpencodeGoPool() {
             maxConcurrent: 5,
             capabilities: ['search', 'formatting', 'simple-coding', 'file-ops'],
             costTier: 'low',
+            priority: 1,
             description: 'DeepSeek V4 Flash - 빠름. 단순 검색/포매팅/파일작업',
         },
         {
@@ -311,6 +315,7 @@ function buildOpencodeGoPool() {
             maxConcurrent: 3,
             capabilities: ['coding', 'testing', 'refactoring', 'backend'],
             costTier: 'medium',
+            priority: 2,
             description: 'DeepSeek V4 Flash - 일반. 코딩/리팩토링/백엔드',
         },
         {
@@ -320,6 +325,7 @@ function buildOpencodeGoPool() {
             maxConcurrent: 3,
             capabilities: ['vision', 'frontend', 'testing'],
             costTier: 'medium',
+            priority: 1,
             description: 'Qwen 3.6 Plus - 비전. 이미지 분석/프론트엔드/테스트',
         },
         {
@@ -329,6 +335,7 @@ function buildOpencodeGoPool() {
             maxConcurrent: 2,
             capabilities: ['architecture', 'debugging', 'reasoning', 'complex-coding', 'refactoring'],
             costTier: 'high',
+            priority: 2,
             description: 'DeepSeek V4 Pro - 고급 추론. 아키텍처/복잡 디버깅',
         },
         {
@@ -338,6 +345,7 @@ function buildOpencodeGoPool() {
             maxConcurrent: 2,
             capabilities: ['vision', 'reasoning', 'complex-coding', 'architecture', 'debugging'],
             costTier: 'high',
+            priority: 1,
             description: 'Kimi K2.6 - 비전 고급. 이미지 분석/복잡 추론',
         },
     ];
@@ -405,7 +413,7 @@ export function formatProviderChecklist(detection) {
     lines.push('구독을 변경하려면 maskweaver.config.json의 dummyHumans.pool을 편집하세요.');
     return lines.join('\n');
 }
-export function writeAutoDetectedConfig(projectDir) {
+export function writeAutoDetectedConfig(projectDir, force) {
     let detection;
     try {
         detection = detectSubscriptionsFromCli();
@@ -425,7 +433,7 @@ export function writeAutoDetectedConfig(projectDir) {
             return null;
         } })()
         : null;
-    if (existingConfig?.dummyHumans?.pool?.length > 0) {
+    if (!force && existingConfig?.dummyHumans?.pool?.length > 0) {
         return null;
     }
     const newConfig = buildConfigFromDetection(detection);
@@ -447,6 +455,7 @@ export const DEFAULT_RUNTIME_CONFIG_TEMPLATE = {
                 maxConcurrent: 5,
                 capabilities: ['search', 'formatting', 'simple-coding', 'file-ops'],
                 costTier: 'low',
+                priority: 1,
                 description: 'DeepSeek V4 Flash - 빠름. 단순 검색/포매팅/파일작업',
             },
             {
@@ -456,6 +465,7 @@ export const DEFAULT_RUNTIME_CONFIG_TEMPLATE = {
                 maxConcurrent: 3,
                 capabilities: ['coding', 'testing', 'refactoring', 'backend'],
                 costTier: 'medium',
+                priority: 2,
                 description: 'DeepSeek V4 Flash - 일반. 코딩/리팩토링/백엔드',
             },
             {
@@ -465,6 +475,7 @@ export const DEFAULT_RUNTIME_CONFIG_TEMPLATE = {
                 maxConcurrent: 3,
                 capabilities: ['vision', 'frontend', 'testing'],
                 costTier: 'medium',
+                priority: 1,
                 description: 'Qwen 3.6 Plus - 비전. 이미지 분석/프론트엔드/테스트',
             },
             {
@@ -474,6 +485,7 @@ export const DEFAULT_RUNTIME_CONFIG_TEMPLATE = {
                 maxConcurrent: 2,
                 capabilities: ['architecture', 'debugging', 'reasoning', 'complex-coding', 'refactoring'],
                 costTier: 'high',
+                priority: 2,
                 description: 'DeepSeek V4 Pro - 고급 추론. 아키텍처/복잡 디버깅',
             },
             {
@@ -483,6 +495,7 @@ export const DEFAULT_RUNTIME_CONFIG_TEMPLATE = {
                 maxConcurrent: 2,
                 capabilities: ['vision', 'reasoning', 'complex-coding', 'architecture', 'debugging'],
                 costTier: 'high',
+                priority: 1,
                 description: 'Kimi K2.6 - 비전 고급. 이미지 분석/복잡 추론',
             },
         ],

package/dist/shared/model-registry.js

@@ -187,6 +187,10 @@ export class ModelRegistry {
                 return -1;
             if (!slotA.available && slotB.available)
                 return 1;
+            const priA = a.priority ?? 0;
+            const priB = b.priority ?? 0;
+            if (priB !== priA)
+                return priB - priA;
             if (preferCheap) {
                 const costDiff = COST_ORDER[a.costTier] - COST_ORDER[b.costTier];
                 if (costDiff !== 0)