maskweaver 0.8.10 → 0.8.12

package/assets/agents/squad-operator.md

@@ -177,8 +177,12 @@ squad({ action: "models" })
    - 단순 작업 (파일 정리, 포매팅) → flash 티어 모델
    - 일반 코딩 → human 티어 모델
    - 복잡한 설계/디버깅 → premium 티어 모델
+   - **비전 필요 (이미지 분석, 스크린샷) → `vision` capability 보유 모델 선택**
+     - `qwen-vision` (human 티어) 또는 `kimi-vision` (premium 티어)
+     - `squad({ action: "models" })` 결과에서 `capabilities`에 `"vision"`이 포함된 모델 확인
 3. **동시실행 고려**: 해당 모델의 `remainingSlots`이 0이면 다른 모델 사용
 4. **fallback**: 원하는 티어가 꽉 찼으면 비슷한 능력의 다른 모델 사용
+5. **비전 fallback**: vision 모델이 모두 사용 중이면 일반 모델로 작업을 분리하여 처리 (이미지 설명 생성 → 일반 코딩 모델에 전달)
 
 ### assignee 지정 방식
 `assignee` 필드에 **에이전트 이름**을 사용합니다:

package/dist/core/schema/validator.d.ts

@@ -10,8 +10,8 @@ export declare const MaskSchemaValidator: z.ZodObject<{
         id: z.ZodString;
         version: z.ZodLiteral<"1.0">;
         language: z.ZodEnum<{
-            en: "en";
             ko: "ko";
+            en: "en";
             zh: "zh";
             ja: "ja";
         }>;

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

@@ -9,12 +9,15 @@ export declare function createWeaveTool(): {
     description: string;
     args: {
         command: z.ZodEnum<{
+            map: "map";
             record: "record";
             status: "status";
             spec: "spec";
             worktree: "worktree";
+            build: "build";
             verify: "verify";
             init: "init";
+            interview: "interview";
             research: "research";
             design: "design";
             prepare: "prepare";
@@ -22,6 +25,7 @@ export declare function createWeaveTool(): {
             "approve-plan": "approve-plan";
             flow: "flow";
             craft: "craft";
+            "build-resume": "build-resume";
             archive: "archive";
             "loop-run": "loop-run";
             "loop-start": "loop-start";
@@ -79,9 +83,13 @@ export declare function createWeaveTool(): {
         maxNoProgress: z.ZodOptional<z.ZodNumber>;
         pollIntervalMs: z.ZodOptional<z.ZodNumber>;
         pollCycles: z.ZodOptional<z.ZodNumber>;
+        deep: z.ZodOptional<z.ZodBoolean>;
+        maxRetries: z.ZodOptional<z.ZodNumber>;
+        buildId: z.ZodOptional<z.ZodString>;
+        phaseIds: z.ZodOptional<z.ZodString>;
     };
     execute: (args: {
-        command: "init" | "research" | "spec" | "design" | "prepare" | "refine-plan" | "approve-plan" | "flow" | "craft" | "status" | "worktree" | "verify" | "archive" | "loop-run" | "loop-start" | "loop-step" | "loop-status" | "loop-stop" | "loop-list" | "loop-sync" | "loop-watchdog" | "loop-poll" | "loop-operator" | "troubleshoot" | "record" | "help" | "repair" | "sync-agents" | "init-config";
+        command: "init" | "map" | "interview" | "research" | "spec" | "design" | "prepare" | "refine-plan" | "approve-plan" | "flow" | "craft" | "build" | "build-resume" | "status" | "worktree" | "verify" | "archive" | "loop-run" | "loop-start" | "loop-step" | "loop-status" | "loop-stop" | "loop-list" | "loop-sync" | "loop-watchdog" | "loop-poll" | "loop-operator" | "troubleshoot" | "record" | "help" | "repair" | "sync-agents" | "init-config";
         docsPath?: string;
         phaseId?: string;
         projectName?: string;
@@ -113,6 +121,10 @@ export declare function createWeaveTool(): {
         maxNoProgress?: number;
         pollIntervalMs?: number;
         pollCycles?: number;
+        deep?: boolean;
+        maxRetries?: number;
+        buildId?: string;
+        phaseIds?: string;
     }, context: {
         worktree: string;
     }) => Promise<string>;

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

@@ -1 +1 @@
-{"version":3,"file":"weave.d.ts","sourceRoot":"","sources":["../../../src/plugin/tools/weave.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAyExB,wBAAgB,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;oBAoHb;QACF,OAAO,EAAE,MAAM,GAAG,UAAU,GAAG,MAAM,GAAG,QAAQ,GAAG,SAAS,GAAG,aAAa,GAAG,cAAc,GAAG,MAAM,GAAG,OAAO,GAAG,QAAQ,GAAG,UAAU,GAAG,QAAQ,GAAG,SAAS,GAAG,UAAU,GAAG,YAAY,GAAG,WAAW,GAAG,aAAa,GAAG,WAAW,GAAG,WAAW,GAAG,WAAW,GAAG,eAAe,GAAG,WAAW,GAAG,eAAe,GAAG,cAAc,GAAG,QAAQ,GAAG,MAAM,GAAG,QAAQ,GAAG,aAAa,GAAG,aAAa,CAAC;QACtY,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,UAAU,CAAC,EAAE,OAAO,CAAC;QACrB,cAAc,CAAC,EAAE,MAAM,CAAC;QACxB,aAAa,CAAC,EAAE,MAAM,CAAC;QACvB,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,UAAU,CAAC,EAAE,OAAO,CAAC;QACrB,cAAc,CAAC,EAAE,QAAQ,GAAG,MAAM,GAAG,MAAM,GAAG,QAAQ,GAAG,OAAO,CAAC;QACjE,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,YAAY,CAAC,EAAE,OAAO,CAAC;QACvB,cAAc,CAAC,EAAE,OAAO,CAAC;QACzB,YAAY,CAAC,EAAE,OAAO,CAAC;QACvB,UAAU,CAAC,EAAE,OAAO,CAAC;QACrB,UAAU,CAAC,EAAE,OAAO,GAAG,MAAM,CAAC;QAC9B,MAAM,CAAC,EAAE,OAAO,CAAC;QACjB,QAAQ,CAAC,EAAE,OAAO,CAAC;QACnB,aAAa,CAAC,EAAE,MAAM,CAAC;QACvB,MAAM,CAAC,EAAE,OAAO,CAAC;QACjB,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,aAAa,CAAC,EAAE,MAAM,CAAC;QACvB,aAAa,CAAC,EAAE,MAAM,CAAC;QACvB,cAAc,CAAC,EAAE,MAAM,CAAC;QACxB,UAAU,CAAC,EAAE,MAAM,CAAC;KACvB,WACQ;QAAE,QAAQ,EAAE,MAAM,CAAA;KAAE,KAC9B,OAAO,CAAC,MAAM,CAAC;EAsGzB"}
+{"version":3,"file":"weave.d.ts","sourceRoot":"","sources":["../../../src/plugin/tools/weave.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AA+ExB,wBAAgB,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;oBAgIb;QACF,OAAO,EAAE,MAAM,GAAG,KAAK,GAAG,WAAW,GAAG,UAAU,GAAG,MAAM,GAAG,QAAQ,GAAG,SAAS,GAAG,aAAa,GAAG,cAAc,GAAG,MAAM,GAAG,OAAO,GAAG,OAAO,GAAG,cAAc,GAAG,QAAQ,GAAG,UAAU,GAAG,QAAQ,GAAG,SAAS,GAAG,UAAU,GAAG,YAAY,GAAG,WAAW,GAAG,aAAa,GAAG,WAAW,GAAG,WAAW,GAAG,WAAW,GAAG,eAAe,GAAG,WAAW,GAAG,eAAe,GAAG,cAAc,GAAG,QAAQ,GAAG,MAAM,GAAG,QAAQ,GAAG,aAAa,GAAG,aAAa,CAAC;QACvb,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,UAAU,CAAC,EAAE,OAAO,CAAC;QACrB,cAAc,CAAC,EAAE,MAAM,CAAC;QACxB,aAAa,CAAC,EAAE,MAAM,CAAC;QACvB,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,UAAU,CAAC,EAAE,OAAO,CAAC;QACrB,cAAc,CAAC,EAAE,QAAQ,GAAG,MAAM,GAAG,MAAM,GAAG,QAAQ,GAAG,OAAO,CAAC;QACjE,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,YAAY,CAAC,EAAE,OAAO,CAAC;QACvB,cAAc,CAAC,EAAE,OAAO,CAAC;QACzB,YAAY,CAAC,EAAE,OAAO,CAAC;QACvB,UAAU,CAAC,EAAE,OAAO,CAAC;QACrB,UAAU,CAAC,EAAE,OAAO,GAAG,MAAM,CAAC;QAC9B,MAAM,CAAC,EAAE,OAAO,CAAC;QACjB,QAAQ,CAAC,EAAE,OAAO,CAAC;QACnB,aAAa,CAAC,EAAE,MAAM,CAAC;QACvB,MAAM,CAAC,EAAE,OAAO,CAAC;QACjB,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,aAAa,CAAC,EAAE,MAAM,CAAC;QACvB,aAAa,CAAC,EAAE,MAAM,CAAC;QACvB,cAAc,CAAC,EAAE,MAAM,CAAC;QACxB,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,IAAI,CAAC,EAAE,OAAO,CAAC;QACf,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;KACrB,WACQ;QAAE,QAAQ,EAAE,MAAM,CAAA;KAAE,KAC9B,OAAO,CAAC,MAAM,CAAC;EAkHzB"}

package/dist/plugin/tools/weave.js

@@ -23,6 +23,10 @@ import { plan } from '../../weave/stages/plan.js';
 import { preparePhaseExecution, formatExecutionPlan, runAIVerification, generateVerificationReport } from '../../weave/stages/execute.js';
 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 } from '../../weave/stages/intake.js';
+import { executeBuildLoop, generateBuildState, generateBuildId, loadBuildState } from '../../weave/stages/build.js';
+import { WeaveOrchestrator } from '../../weave/orchestrator.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';
@@ -43,6 +47,8 @@ export function createWeaveTool() {
 
 Commands:
 - init: Initialize weave workspace files and probe GDC integration
+- map [deep]: Analyze codebase structure via GDC + Graphify (knowledge graph)
+- interview [docsPath]: Multi-step question asking until clarity, with structural change detection
 - research [docsPath]: Deep-read docs + workspace context and write persistent research.md
 - spec [docsPath]: Generate baseline spec (requirements + AC)
 - design [docsPath]: Analyze requirements and create phase-based plan (auto-splits oversized plans)
@@ -51,6 +57,8 @@ Commands:
 - approve-plan: Approve the plan, or finalize a crafted phase when phaseId is provided
 - flow [docsPath]: One-command path (prepare -> auto-approve -> craft -> verify -> finalize)
 - craft [phaseId]: Prepare execution context for a phase (phase auto-select if omitted)
+- build [phaseIds]: Ralph-loop autonomous execution — runs approved plan until all tasks complete (no user intervention)
+- build-resume [buildId]: Resume a previously blocked build
 - status: View overall progress
 - worktree: Manage git worktrees for parallel work
 - verify: Run build/test verification for current worktree
@@ -85,7 +93,7 @@ Examples:
 - weave init-config
 - weave troubleshoot "Cannot find module 'xyz'"`,
         args: {
-            command: z.enum(['init', 'research', 'spec', 'design', 'prepare', 'refine-plan', 'approve-plan', 'flow', 'craft', 'status', 'worktree', 'verify', 'archive', 'loop-run', 'loop-start', 'loop-step', 'loop-status', 'loop-stop', 'loop-list', 'loop-sync', 'loop-watchdog', 'loop-poll', 'loop-operator', 'troubleshoot', 'record', 'help', 'repair', 'sync-agents', 'init-config'])
+            command: z.enum(['init', 'map', 'interview', 'research', 'spec', 'design', 'prepare', 'refine-plan', 'approve-plan', 'flow', 'craft', 'build', 'build-resume', 'status', 'worktree', 'verify', 'archive', 'loop-run', 'loop-start', 'loop-step', 'loop-status', 'loop-stop', 'loop-list', 'loop-sync', 'loop-watchdog', 'loop-poll', 'loop-operator', 'troubleshoot', 'record', 'help', 'repair', 'sync-agents', 'init-config'])
                 .describe('Weave command to execute'),
             docsPath: z.string().optional()
                 .describe('Path to requirements documents (for design command)'),
@@ -149,6 +157,14 @@ Examples:
                 .describe('Polling interval for loop-poll/watchdog-style commands (default: 1000ms)'),
             pollCycles: z.number().int().min(1).max(1000).optional()
                 .describe('Maximum polling cycles for loop-poll (default: 30)'),
+            deep: z.boolean().optional()
+                .describe('Run deep analysis with Graphify (for map command)'),
+            maxRetries: z.number().int().min(1).max(10).optional()
+                .describe('Maximum retries per task (for build command)'),
+            buildId: z.string().optional()
+                .describe('Build ID to resume (for build-resume command)'),
+            phaseIds: z.string().optional()
+                .describe('Comma-separated phase IDs (for build command)'),
         },
         execute: async (args, context) => {
             const { command } = args;
@@ -157,6 +173,14 @@ Examples:
                 switch (command) {
                     case 'init':
                         return await handleInit(basePath);
+                    case 'map':
+                        return await handleMap(args, basePath);
+                    case 'interview':
+                        return await handleInterview(args, basePath);
+                    case 'build':
+                        return await handleBuild(args, basePath);
+                    case 'build-resume':
+                        return await handleBuildResume(args, basePath);
                     case 'research':
                         return await handleResearch(args, basePath);
                     case 'spec':
@@ -1748,6 +1772,179 @@ async function handleFlow(args, basePath) {
     });
     return lines.join('\n');
 }
+// ============================================================================
+// Handle Map — Codebase Analysis
+// ============================================================================
+async function handleMap(args, basePath) {
+    const lines = [];
+    lines.push('## 🔍 Codebase Map');
+    lines.push('');
+    lines.push('Analyzing codebase structure...');
+    lines.push('');
+    const mapResult = await analyzeCodebase({
+        basePath,
+        deep: args.deep,
+        onMessage: (msg) => { lines.push(`> ${msg}`); },
+    });
+    if (args.deep) {
+        lines.push('Running Graphify deep analysis...');
+        const graphifyPath = await runGraphifyAnalysis(basePath);
+        if (graphifyPath) {
+            lines.push(`Graphify report: \`${graphifyPath}\``);
+        }
+        else {
+            lines.push('Graphify analysis skipped or failed.');
+        }
+    }
+    lines.push('');
+    lines.push('### Summary');
+    lines.push(mapResult.summary);
+    lines.push('');
+    lines.push(`Full report: \`${mapResult.mapPath}\``);
+    lines.push('');
+    lines.push('Next: `weave command=interview docsPath="doc"` to discuss the plan.');
+    return lines.join('\n');
+}
+// ============================================================================
+// Handle Interview — Multi-step Question Asking
+// ============================================================================
+async function handleInterview(args, basePath) {
+    const docsPath = args.docsPath || 'docs';
+    const lines = [];
+    lines.push('## 💬 Interview');
+    lines.push('');
+    const mapResult = await readMapResult(basePath);
+    if (mapResult) {
+        lines.push(`📍 Map available: \`${mapResult.mapPath}\``);
+        if (mapResult.structuralIssues.length > 0) {
+            lines.push(`⚠️ ${mapResult.structuralIssues.length} structural issues detected.`);
+        }
+        lines.push('');
+    }
+    else {
+        lines.push('ℹ️ No codebase map found. Run `weave command=map` first for deeper analysis.');
+        lines.push('');
+    }
+    try {
+        const interviewResult = await interviewStage({
+            docsPath,
+            basePath,
+            mapResult,
+        });
+        lines.push(`### Documents Analyzed`);
+        lines.push(`- ${interviewResult.intake.documents.length} document(s) analyzed`);
+        lines.push(`- ${interviewResult.intake.features.length} feature(s) identified`);
+        lines.push('');
+        if (interviewResult.intake.structuralChanges && interviewResult.intake.structuralChanges.length > 0) {
+            lines.push('### ⚠️ Structural Changes Detected');
+            lines.push('The following structural changes were identified from codebase analysis:');
+            lines.push('');
+            for (const sc of interviewResult.intake.structuralChanges) {
+                const icon = sc.breaking ? '🔴' : '🟡';
+                lines.push(`- ${icon} **${sc.area}** — ${sc.proposedChange}`);
+                lines.push(`  - Why: ${sc.rationale}`);
+                lines.push(`  - Impact: ${sc.impact}`);
+                lines.push(`  - Status: ${sc.agreed ? '✅ Agreed' : '⏳ Pending approval'}`);
+            }
+            lines.push('');
+            lines.push('To proceed, agree to structural changes via `weave command=approve-plan`.');
+            lines.push('');
+        }
+        lines.push('### Questions');
+        lines.push('Review the features and technical requirements above.');
+        lines.push('');
+        lines.push('Next: `weave command=design docsPath="docs/"` to create the plan.');
+    }
+    catch (e) {
+        return `Error during interview: ${e.message || e}`;
+    }
+    return lines.join('\n');
+}
+// ============================================================================
+// Handle Build — Ralph-loop Autonomous Execution
+// ============================================================================
+async function handleBuild(args, basePath) {
+    const lines = [];
+    lines.push('## 🏗️ Build');
+    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.';
+    }
+    if (!plan.planApproved) {
+        return 'Error: Plan not approved. Run `weave command=approve-plan` first.';
+    }
+    lines.push(`Plan: **${plan.projectName}** (approved at ${plan.planApprovedAt || 'N/A'})`);
+    lines.push('');
+    const orchestrator = new WeaveOrchestrator();
+    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('');
+    if (result.success) {
+        lines.push('## ✅ Build Complete');
+    }
+    else {
+        lines.push('## ⚠️ Build Blocked');
+    }
+    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>"`');
+    }
+    return lines.join('\n');
+}
+// ============================================================================
+// Handle Build Resume
+// ============================================================================
+async function handleBuildResume(args, basePath) {
+    const lines = [];
+    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.`;
+    }
+    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);
+    return lines.join('\n');
+}
 async function handleCraft(args, basePath) {
     const { phaseId, projectType } = args;
     let resolvedPhaseId = phaseId;