maskweaver 0.9.4 → 0.9.6

package/dist/weave/stages/execute.js

@@ -1,14 +1,3 @@
-/**
- * Weave Execute Stage
- *
- * Generates execution plans with automatic mask and agent tier selection.
- * Actual code generation/testing is performed by AI agents (dummy-flash/human/premium)
- * via the Task tool — this module handles:
- * - Phase validation and dependency checking
- * - Execution plan generation (mask + agent tier per task)
- * - Formatting the plan for the Mask Weaver to act upon
- * - AI-driven verification system integration
- */
 import { getOrchestrator } from '../orchestrator.js';
 import { getPhaseManager } from '../phase-manager.js';
 import { searchTroubleshooting } from '../knowledge/global.js';
@@ -95,33 +84,16 @@ async function collectGdcExtractContexts(basePath, phase, changeId) {
     }
     return contexts;
 }
-// ============================================================================
-// Prepare Phase Execution (primary entry point for craft)
-// ============================================================================
-/**
- * Prepare a phase for execution.
- *
- * This is the primary entry point for craft. It:
- * 1. Validates dependencies
- * 2. Marks the phase as in_progress
- * 3. Generates an execution plan (mask + agent tier per task)
- * 4. Returns the plan for the Mask Weaver to delegate via Task tool
- *
- * The actual code generation/testing is performed by AI agents
- * (dummy-flash, dummy-human, dummy-premium) — not by this function.
- */
 export async function preparePhaseExecution(options) {
     const { phaseId, onEvent = () => { }, projectType, basePath } = options;
     const runtimeBasePath = basePath || process.cwd();
     const manager = getPhaseManager(basePath);
     const orchestrator = getOrchestrator();
-    // Load plan and get phase
     await manager.loadPlan();
     const phase = manager.getPhase(phaseId);
     if (!phase) {
         throw new Error(`Phase not found: ${phaseId}`);
     }
-    // Check dependencies
     const plan = await manager.loadPlan();
     if (phase.dependsOn && phase.dependsOn.length > 0) {
         for (const depId of phase.dependsOn) {
@@ -131,10 +103,8 @@ export async function preparePhaseExecution(options) {
             }
         }
     }
-    // Mark phase as in progress
     await manager.updatePhaseStatus(phaseId, 'in_progress');
     onEvent({ type: 'phase_started', phaseId });
-    // Generate execution plan with mask + agent tier per task
     const executionPlan = await orchestrator.generateExecutionPlan(phase, { projectType });
     executionPlan.gdcContextFiles = await collectGdcExtractContexts(runtimeBasePath, phase, plan?.activeChangeId);
     return {
@@ -142,13 +112,6 @@ export async function preparePhaseExecution(options) {
         phase,
     };
 }
-// ============================================================================
-// Format Execution Plan (markdown output for Mask Weaver)
-// ============================================================================
-/**
- * Format a PhaseExecutionPlan into markdown instructions
- * that the Mask Weaver can read and act upon.
- */
 export function formatExecutionPlan(plan) {
     const lines = [];
     lines.push(`## Phase ${plan.phaseId}: ${plan.phaseName}`);
@@ -164,7 +127,6 @@ export function formatExecutionPlan(plan) {
         lines.push(`| ${i + 1} | ${tp.task.id} | ${tp.task.name} | ${tp.complexity} | ${tierLabel} | ${mask} |`);
     }
     lines.push('');
-    // Summarize tier distribution
     const flash = plan.taskPlans.filter(p => p.agentTier === 'dummy-flash').length;
     const human = plan.taskPlans.filter(p => p.agentTier === 'dummy-human').length;
     const premium = plan.taskPlans.filter(p => p.agentTier === 'dummy-premium').length;
@@ -177,7 +139,6 @@ export function formatExecutionPlan(plan) {
     if (premium > 0)
         lines.push(`- **dummy-premium** (${premium} tasks): Complex reasoning required`);
     lines.push('');
-    // Add troubleshooting hints if any
     const tasksWithHints = plan.taskPlans.filter(p => p.troubleshootingHints.length > 0);
     if (tasksWithHints.length > 0) {
         lines.push('### Troubleshooting Hints (from Global Knowledge)');
@@ -211,13 +172,11 @@ export function formatExecutionPlan(plan) {
         }
         lines.push('');
     }
-    // Parallel execution analysis (if multiple tasks)
     if (plan.taskPlans.length > 1) {
         const parallelAnalysis = analyzeParallelOpportunities(plan);
         lines.push(formatParallelAnalysis(parallelAnalysis));
         lines.push('');
     }
-    // Execution instructions for the Mask Weaver
     lines.push('### Instructions');
     lines.push('');
     lines.push('For each task above, delegate using `Task(<agent_tier>)` with the specified mask.');
@@ -244,26 +203,16 @@ function formatTierLabel(tier) {
         case 'dummy-premium': return 'premium';
     }
 }
-// ============================================================================
-// Legacy Execute (backward compatibility)
-// ============================================================================
-/**
- * @deprecated Use preparePhaseExecution() + formatExecutionPlan() instead.
- * Kept for backward compatibility.
- */
 export async function execute(options) {
     const startTime = Date.now();
     const { phaseId } = options;
-    // Use preparePhaseExecution internally
     const { plan: executionPlan, phase } = await preparePhaseExecution(options);
     const manager = getPhaseManager(options.basePath);
     const masksUsed = new Set();
-    // Collect masks from the execution plan
     for (const tp of executionPlan.taskPlans) {
         if (tp.mask)
             masksUsed.add(tp.mask);
     }
-    // Update plan with masks used
     await manager.updatePhaseStatus(phaseId, 'in_progress', {
         masksUsed: Array.from(masksUsed),
     });
@@ -271,7 +220,7 @@ export async function execute(options) {
     return {
         success: true,
         phase: finalPhase,
-        tasksCompleted: 0, // No tasks auto-executed — AI agent handles this
+        tasksCompleted: 0,
         tasksFailed: 0,
         troubleshootingUsed: 0,
         troubleshootingRecorded: 0,
@@ -280,10 +229,6 @@ export async function execute(options) {
         executionPlan,
     };
 }
-/**
- * Run all verification layers in order.
- * Returns as soon as any layer fails.
- */
 export async function runAIVerification(options) {
     const results = [];
     const layers = getVerificationLayers(options);
@@ -340,19 +285,13 @@ function getVerificationLayers(options) {
     const mode = options.mode || 'full';
     const full = mode === 'full';
     return [
-        // Layer 1: Build/Compile
         { name: 'TypeCheck', order: 1, type: 'build', enabled: rec.buildSteps.some(s => s.name === 'TypeCheck') },
         { name: 'Lint', order: 2, type: 'build', enabled: full && rec.buildSteps.some(s => s.name === 'Lint') },
         { name: 'Build', order: 3, type: 'build', enabled: full && rec.buildSteps.some(s => s.name === 'Build') },
-        // Layer 2: Unit/Integration Tests
         { name: 'UnitTests', order: 4, type: 'test', enabled: hasTests },
-        // Layer 3: E2E Tests (Playwright/Cypress)
         { name: 'E2ETests', order: 5, type: 'test', enabled: options.enablePlaywright ?? false },
-        // Layer 4: Visual Verification (Screenshots)
         { name: 'Screenshot', order: 6, type: 'visual', enabled: options.enableScreenshots ?? false },
-        // Layer 5: API/DB Verification
         { name: 'APICheck', order: 7, type: 'api', enabled: !!options.devServerUrl },
-        // Layer 6: Accessibility (optional)
         { name: 'Accessibility', order: 8, type: 'accessibility', enabled: false },
     ];
 }
@@ -388,7 +327,6 @@ async function runShellCommand(cmd, cwd, options) {
                 proc.kill();
             }
             catch {
-                // ignore
             }
         }, timeoutMs);
         const finalize = (exitCode) => {
@@ -451,7 +389,6 @@ async function runBuildVerification(options, stepName) {
             ? `timed out (>${Math.round(result.timeoutMs / 1000)}s)`
             : `exit code ${result.exitCode}`;
         const combined = `${result.stdout}\n${result.stderr}`.trim();
-        // Try to find similar troubleshooting entries
         if (combined.length > 0) {
             try {
                 const solutions = await searchTroubleshooting(combined, {
@@ -466,7 +403,6 @@ async function runBuildVerification(options, stepName) {
                 }
             }
             catch {
-                // ignore knowledge search failures
             }
         }
         return {
@@ -479,14 +415,10 @@ async function runBuildVerification(options, stepName) {
     }
     return { passed: true, logs, layer: 'Build', duration: result.durationMs };
 }
-// ============================================================================
-// Test Verification (unit, E2E)
-// ============================================================================
 async function runTestVerification(options, stepName) {
     const { projectPath, enablePlaywright, devServerUrl } = options;
     const logs = [];
     let playwrightResult = null;
-    // Unit tests (recommended)
     if (stepName === 'UnitTests') {
         const rec = recommendVerificationCommands({
             projectPath: options.projectPath,
@@ -538,7 +470,6 @@ async function runTestVerification(options, stepName) {
                     }
                 }
                 catch {
-                    // ignore
                 }
             }
             return {
@@ -551,7 +482,6 @@ async function runTestVerification(options, stepName) {
         }
         return { passed: true, logs, layer: 'Test', duration: result.durationMs };
     }
-    // E2E tests with Playwright
     if (stepName === 'E2ETests') {
         if (!enablePlaywright) {
             logs.push('[E2E] Skipped (enablePlaywright=false)');
@@ -622,9 +552,6 @@ async function runTestVerification(options, stepName) {
     logs.push(`[${stepName}] Skipped (unknown test step)`);
     return { passed: true, logs, layer: 'Test', duration: 0 };
 }
-// ============================================================================
-// Visual Verification (Screenshots, Browser Testing)
-// ============================================================================
 async function runVisualVerification(options) {
     const { devServerUrl, enableScreenshots, projectPath } = options;
     const startTime = Date.now();
@@ -659,9 +586,6 @@ async function runVisualVerification(options) {
         duration: Date.now() - startTime,
     };
 }
-// ============================================================================
-// API/DB Verification (endpoints, database queries)
-// ============================================================================
 async function runAPIVerification(options) {
     const { devServerUrl } = options;
     if (!devServerUrl) {
@@ -673,9 +597,6 @@ async function runAPIVerification(options) {
     logs.push('[API] Would verify database connectivity and basic queries');
     return { passed: true, logs, layer: 'API', duration: 0 };
 }
-// ============================================================================
-// Accessibility Verification
-// ============================================================================
 async function runAccessibilityVerification(options) {
     const { devServerUrl } = options;
     if (!devServerUrl) {
@@ -685,9 +606,6 @@ async function runAccessibilityVerification(options) {
     logs.push('[A11y] Would run axe-core accessibility scan');
     return { passed: true, logs, layer: 'Accessibility', duration: 0 };
 }
-// ============================================================================
-// Verification Report Generation
-// ============================================================================
 export function generateVerificationReport(results) {
     const lines = [
         '## AI Verification Results\n',
@@ -725,8 +643,8 @@ export const DEFAULT_VERIFY_CONFIG = {
     runLint: true,
     runBuild: true,
     runUnitTests: true,
-    runE2ETests: false, // Opt-in
-    captureScreenshots: false, // Opt-in
+    runE2ETests: false,
+    captureScreenshots: false,
     checkAPIHealth: true,
-    runAccessibilityCheck: false, // Opt-in
+    runAccessibilityCheck: false,
 };

package/dist/weave/stages/handoff.d.ts

@@ -1,9 +1,3 @@
-/**
- * Weave Handoff Stage
- *
- * User handoff after AI verification is complete.
- * Integrates with retrospect for session analysis.
- */
 import type { WeavePhase, WeaveEvent } from '../types.js';
 export interface HandoffOptions {
     phaseId: string;
@@ -11,7 +5,6 @@ export interface HandoffOptions {
     screenshotPath?: string;
     testResults?: TestResults;
     onEvent?: (event: WeaveEvent) => void;
-    /** Base path for .opencode/weave (defaults to process.cwd()) */
     basePath?: string;
 }
 export interface TestResults {

package/dist/weave/stages/handoff.js

@@ -1,9 +1,3 @@
-/**
- * Weave Handoff Stage
- *
- * User handoff after AI verification is complete.
- * Integrates with retrospect for session analysis.
- */
 import { getPhaseManager } from '../phase-manager.js';
 import { countGdcCheckIssues, getEffectiveGdcConfig, getStatsNodeSummary, runGdcMachineCommand } from '../gdc.js';
 function collectPhaseNodeIds(phase) {
@@ -51,14 +45,10 @@ async function buildGdcCompletionSummary(basePath, phase) {
     lines.push(`- Check issues: errors=${counts.errors}, warnings=${counts.warnings}, info=${counts.infos}, total=${counts.issueCount}`);
     return lines;
 }
-// ============================================================================
-// Handoff Message Generation
-// ============================================================================
 function generateHandoffMessage(phase, devUrl, testResults) {
     const lines = [];
     lines.push(`## ✅ Phase ${phase.id} 검증 완료!`);
     lines.push('');
-    // Test results section
     if (testResults) {
         lines.push('### 🤖 AI 자동 테스트 결과');
         lines.push('');
@@ -90,19 +80,16 @@ function generateHandoffMessage(phase, devUrl, testResults) {
         }
         lines.push('');
     }
-    // Access URL
     if (devUrl) {
         lines.push('### 🔗 접속');
         lines.push(devUrl);
         lines.push('');
     }
-    // Checklist
     lines.push('### 📋 확인 체크리스트');
     for (const item of phase.checklist) {
         lines.push(`- [ ] ${item}`);
     }
     lines.push('');
-    // Human-only checks
     lines.push('### 👤 사람만 판단 가능한 것');
     lines.push('');
     lines.push('AI가 객관적으로 측정할 수 없는 주관적 판단:');
@@ -111,7 +98,6 @@ function generateHandoffMessage(phase, devUrl, testResults) {
     lines.push('- [ ] **사용성**: 실제로 써보니 편한가요?');
     lines.push('- [ ] **비즈니스 의도**: 원래 원하던 게 이게 맞나요?');
     lines.push('');
-    // Response options
     lines.push('### 👆 확인 후 알려주세요');
     lines.push('');
     lines.push('**[Approve]** - 다음 Phase로');
@@ -119,9 +105,6 @@ function generateHandoffMessage(phase, devUrl, testResults) {
     lines.push('**[Later]** - 나중에');
     return lines.join('\n');
 }
-// ============================================================================
-// Main Handoff Function
-// ============================================================================
 export async function handoff(options) {
     const { phaseId, devUrl, testResults, onEvent = () => { }, basePath } = options;
     const manager = getPhaseManager(basePath);
@@ -130,15 +113,12 @@ export async function handoff(options) {
     if (!phase) {
         throw new Error(`Phase not found: ${phaseId}`);
     }
-    // Generate handoff message
     const message = generateHandoffMessage(phase, devUrl, testResults);
-    // Human-only checks (AI cannot verify these)
     const humanOnlyChecks = [
         '전체적인 디자인 느낌이 의도대로인가요?',
         '실제로 써보니 편한가요?',
         '원래 원하던 게 이게 맞나요?',
     ];
-    // Next steps based on phase
     const stats = manager.getStats();
     const nextPhase = manager.getNextPhase();
     const nextSteps = [];
@@ -146,7 +126,6 @@ export async function handoff(options) {
         nextSteps.push(`다음 Phase를 시작하려면: /weave craft ${nextPhase.id}`);
     }
     nextSteps.push('전체 상태를 확인하려면: /weave status');
-    // Emit event
     onEvent({ type: 'user_handoff', phaseId, checklist: phase.checklist });
     return {
         phase,
@@ -156,9 +135,6 @@ export async function handoff(options) {
         nextSteps,
     };
 }
-// ============================================================================
-// Response Handling
-// ============================================================================
 export async function handleUserResponse(phaseId, response, feedback, basePath) {
     const manager = getPhaseManager(basePath);
     await manager.loadPlan();
@@ -168,10 +144,7 @@ export async function handleUserResponse(phaseId, response, feedback, basePath)
     }
     switch (response) {
         case 'approve': {
-            // Mark phase as completed
             await manager.updatePhaseStatus(phaseId, 'completed');
-            // TODO: Trigger retrospect for mask effectiveness analysis
-            // await performRetrospect({ trigger: 'phase_complete', phaseId, ... });
             const nextPhase = manager.getNextPhase();
             const stats = manager.getStats();
             let message = `✅ Phase ${phaseId} 승인 완료!\n\n`;
@@ -196,30 +169,22 @@ export async function handleUserResponse(phaseId, response, feedback, basePath)
             return { message, nextAction: 'await_feedback' };
         }
         case 'later': {
-            // Keep phase in progress
             const message = `⏸ 일시 중지합니다.\n\n나중에 이어하려면:\n\`\`\`\n/weave craft ${phaseId}\n\`\`\``;
             return { message };
         }
     }
 }
-// ============================================================================
-// Status Report
-// ============================================================================
 export async function generateStatusReport(basePath) {
     const manager = basePath ? getPhaseManager(basePath) : getPhaseManager();
-    // Check for multi-plan mode via state.yaml
     const state = await manager.loadState();
     if (state) {
-        // Multi-plan mode
         const allPlans = await manager.loadAllPlans();
         if (allPlans.length === 0) {
             return '📋 아직 계획이 없습니다.\n\n시작하려면: `/weave design [docs-path]`';
         }
         const activePlanName = await manager.getActivePlanName();
-        // Load active plan for detailed view
         const plan = await manager.loadPlan();
         const lines = [];
-        // All plans overview
         lines.push(`## 📊 Weave 진행 상황 (${allPlans.length} plans)`);
         lines.push('');
         lines.push('### 📁 모든 Plans');
@@ -237,18 +202,15 @@ export async function generateStatusReport(basePath) {
             lines.push(`| ${p.projectName}${marker} | ${progress}% | ${completed}/${total} | ${status} |`);
         }
         lines.push('');
-        // Active plan detail
         if (plan) {
             const stats = manager.getStats();
             lines.push(`### 🎯 Active Plan: ${plan.projectName}`);
             lines.push('');
             lines.push(`**진행률**: ${stats.progress}%`);
-            // Progress bar
             const filled = Math.round(stats.progress / 5);
             const empty = 20 - filled;
             lines.push(`[${'\u2588'.repeat(filled)}${'\u2591'.repeat(empty)}] ${stats.completedPhases}/${stats.totalPhases}`);
             lines.push('');
-            // Phase list
             lines.push('### Phases');
             lines.push('');
             for (const phase of plan.phases) {
@@ -275,7 +237,6 @@ export async function generateStatusReport(basePath) {
                 lines.push(line);
             }
             lines.push('');
-            // Next action
             const currentPhase = plan.phases.find(p => p.status === 'in_progress');
             const nextPhase = manager.getNextPhase();
             if (currentPhase) {
@@ -293,7 +254,6 @@ export async function generateStatusReport(basePath) {
         }
         return lines.join('\n');
     }
-    // Legacy single-plan mode
     const plan = await manager.loadPlan();
     if (!plan) {
         return '📋 아직 계획이 없습니다.\n\n시작하려면: `/weave design [docs-path]`';
@@ -305,12 +265,10 @@ export async function generateStatusReport(basePath) {
     lines.push(`**프로젝트**: ${plan.projectName}`);
     lines.push(`**진행률**: ${stats.progress}%`);
     lines.push('');
-    // Progress bar
     const filled = Math.round(stats.progress / 5);
     const empty = 20 - filled;
     lines.push(`[${'█'.repeat(filled)}${'░'.repeat(empty)}] ${stats.completedPhases}/${stats.totalPhases}`);
     lines.push('');
-    // Phase list
     lines.push('### Phases');
     lines.push('');
     for (const phase of plan.phases) {
@@ -337,7 +295,6 @@ export async function generateStatusReport(basePath) {
         lines.push(line);
     }
     lines.push('');
-    // Next action
     const currentPhase = plan.phases.find(p => p.status === 'in_progress');
     const nextPhase = manager.getNextPhase();
     if (currentPhase) {

package/dist/weave/stages/index.d.ts

@@ -1,6 +1,3 @@
-/**
- * Weave Stages Index
- */
 export { intake } from './intake.js';
 export type { IntakeOptions, IntakeResult, DocumentAnalysis, Question } from './intake.js';
 export { buildResearchReport, writeResearchReport } from './research.js';

package/dist/weave/stages/index.js

@@ -1,6 +1,3 @@
-/**
- * Weave Stages Index
- */
 export { intake } from './intake.js';
 export { buildResearchReport, writeResearchReport } from './research.js';
 export { refinePlanFromNotes } from './refine.js';

package/dist/weave/stages/intake.d.ts

@@ -1,9 +1,3 @@
-/**
- * Weave Intake Stage
- *
- * Document analysis and question generation.
- * Uses Maskweaver memory for semantic search of past similar projects.
- */
 import type { WeaveEvent, EnvironmentAnalysis, MapResult, StructuralChange, ConsentPrompt } from '../types.js';
 export interface IntakeOptions {
     docsPath: string;
@@ -60,9 +54,7 @@ export interface InterviewResult {
 }
 export declare function interview(options: InterviewOptions): Promise<InterviewResult>;
 export interface IntakeWithAnalysisOptions extends IntakeOptions {
-    /** Skip environment analysis for faster intake */
     skipEnvironmentAnalysis?: boolean;
-    /** Only include warning+ severity issues in environment analysis */
     warningsOnly?: boolean;
 }
 export declare function intake(options: IntakeOptions | IntakeWithAnalysisOptions): Promise<IntakeResult>;