maskweaver 0.9.4 → 0.9.6

package/dist/weave/bridge.js

@@ -1,24 +1,4 @@
-/**
- * Weave-Squad Bridge
- *
- * Converts between Weave types (WeaveTask, WeavePhase) and Squad types (TaskState)
- * to enable parallel execution of Weave phase tasks through the Squad system.
- *
- * This is the missing link between the two systems:
- * - Weave: Project-level milestone tracking (YAML plans)
- * - Squad: Multi-agent parallel execution (JSON sessions)
- */
 import { buildDAG } from '../shared-context/dag.js';
-// ============================================================================
-// WeaveTask -> TaskState Conversion
-// ============================================================================
-/**
- * Convert a WeaveTask to a TaskState for use in the Squad system.
- * Maps Weave concepts to Squad concepts:
- * - WeaveTask.id -> TaskState.taskId
- * - WeaveTask.status -> TaskState.status (with mapping)
- * - Complexity -> TaskState.priority
- */
 export function weaveTaskToSquadTask(task, options) {
     return {
         taskId: task.id,
@@ -30,9 +10,6 @@ export function weaveTaskToSquadTask(task, options) {
         createdAt: new Date().toISOString(),
     };
 }
-/**
- * Map Weave task status to Squad task status.
- */
 function mapWeaveStatusToSquad(weaveStatus) {
     switch (weaveStatus) {
         case 'pending': return 'pending';
@@ -41,9 +18,6 @@ function mapWeaveStatusToSquad(weaveStatus) {
         case 'failed': return 'failed';
     }
 }
-/**
- * Map TaskComplexity to Squad Priority.
- */
 export function complexityToPriority(complexity) {
     switch (complexity) {
         case 'simple': return 'low';
@@ -51,13 +25,6 @@ export function complexityToPriority(complexity) {
         case 'complex': return 'high';
     }
 }
-// ============================================================================
-// Phase -> Squad Task List Conversion
-// ============================================================================
-/**
- * Convert a PhaseExecutionPlan into a list of TaskStates for the Squad system.
- * Each TaskExecutionPlan determines the assignee (agent tier) and priority.
- */
 export function executionPlanToSquadTasks(plan) {
     return plan.taskPlans.map(tp => weaveTaskToSquadTask(tp.task, {
         assignee: tp.agentTier,
@@ -65,24 +32,11 @@ export function executionPlanToSquadTasks(plan) {
         dependencies: tp.task.dependsOn || [],
     }));
 }
-// ============================================================================
-// Parallel Execution Analysis
-// ============================================================================
-/**
- * Analyze a PhaseExecutionPlan for parallel execution opportunities.
- *
- * Uses task-level dependencies when available (`task.dependsOn`).
- * If there are no explicit dependencies, tasks are treated as fully parallel.
- *
- * Returns DAG analysis with wave grouping for parallel execution.
- */
 export function analyzeParallelOpportunities(plan) {
     const squadTasks = executionPlanToSquadTasks(plan);
-    // If no dependencies, all tasks are in wave 0 (fully parallel)
     const allIndependent = squadTasks.every(t => !t.dependencies || t.dependencies.length === 0);
     let dagAnalysis;
     if (allIndependent && squadTasks.length > 1) {
-        // All tasks are independent — one big parallel wave
         dagAnalysis = {
             nodes: new Map(),
             waves: [{ waveIndex: 0, taskIds: squadTasks.map(t => t.taskId) }],
@@ -92,10 +46,8 @@ export function analyzeParallelOpportunities(plan) {
         };
     }
     else {
-        // Use DAG analysis for dependency-aware wave grouping
         dagAnalysis = buildDAG(squadTasks);
     }
-    // Map waves back to execution plans
     const waveDetails = dagAnalysis.waves.map(wave => ({
         waveIndex: wave.waveIndex,
         tasks: wave.taskIds.map(taskId => {
@@ -112,9 +64,6 @@ export function analyzeParallelOpportunities(plan) {
         criticalPath: dagAnalysis.criticalPath,
     };
 }
-/**
- * Format parallel analysis as markdown for the Mask Weaver.
- */
 export function formatParallelAnalysis(analysis) {
     const lines = [];
     lines.push('### Parallel Execution Analysis');

package/dist/weave/environment/detector.d.ts

@@ -1,9 +1,3 @@
-/**
- * Environment Detector
- *
- * Proactive environment analysis for Weave workflow.
- * Detects OS, shell, runtime versions, and project tech stack.
- */
 import type { EnvironmentContext } from '../types.js';
 export declare function detectOS(): EnvironmentContext['os'];
 export declare function detectShell(): EnvironmentContext['shell'];

package/dist/weave/environment/detector.js

@@ -1,16 +1,7 @@
-/**
- * Environment Detector
- *
- * Proactive environment analysis for Weave workflow.
- * Detects OS, shell, runtime versions, and project tech stack.
- */
 import * as os from 'node:os';
 import * as fs from 'node:fs';
 import * as path from 'node:path';
 import { execSync } from 'node:child_process';
-// ============================================================================
-// OS Detection
-// ============================================================================
 export function detectOS() {
     const platform = os.platform();
     switch (platform) {
@@ -21,34 +12,26 @@ export function detectOS() {
         case 'linux':
             return 'linux';
         default:
-            return 'linux'; // Default fallback
+            return 'linux';
     }
 }
-// ============================================================================
-// Shell Detection
-// ============================================================================
 export function detectShell() {
     const currentOS = detectOS();
     if (currentOS === 'windows') {
-        // Check environment variables for shell hints
         const comspec = process.env.COMSPEC || '';
         const psModulePath = process.env.PSModulePath;
         const shellEnv = process.env.SHELL || '';
-        // PowerShell detection
         if (psModulePath || process.env.PSExecutionPolicyPreference) {
             return 'powershell';
         }
-        // Git Bash or WSL bash
         if (shellEnv.includes('bash')) {
             return 'bash';
         }
-        // CMD fallback
         if (comspec.toLowerCase().includes('cmd.exe')) {
             return 'cmd';
         }
-        return 'powershell'; // Default for Windows
+        return 'powershell';
     }
-    // Unix-like systems
     const shell = process.env.SHELL || '';
     if (shell.includes('zsh')) {
         return 'zsh';
@@ -56,14 +39,11 @@ export function detectShell() {
     if (shell.includes('bash')) {
         return 'bash';
     }
-    return 'bash'; // Default for Unix
+    return 'bash';
 }
-// ============================================================================
-// Runtime Version Detection
-// ============================================================================
 export function detectNodeVersion() {
     try {
-        return process.version; // e.g., "v20.10.0"
+        return process.version;
     }
     catch {
         return 'unknown';
@@ -71,11 +51,9 @@ export function detectNodeVersion() {
 }
 export function detectBunVersion() {
     try {
-        // Check if running in Bun
         if (globalThis.Bun) {
             return globalThis.Bun.version;
         }
-        // Try to detect installed bun
         const output = execSync('bun --version', {
             encoding: 'utf-8',
             timeout: 5000,
@@ -87,11 +65,7 @@ export function detectBunVersion() {
         return undefined;
     }
 }
-// ============================================================================
-// Package Manager Detection
-// ============================================================================
 export function detectPackageManager(projectPath) {
-    // Check lockfiles (order matters - most specific first)
     const lockfiles = [
         { file: 'bun.lockb', manager: 'bun' },
         { file: 'pnpm-lock.yaml', manager: 'pnpm' },
@@ -103,7 +77,6 @@ export function detectPackageManager(projectPath) {
             return manager;
         }
     }
-    // Check packageManager field in package.json
     try {
         const pkgPath = path.join(projectPath, 'package.json');
         if (fs.existsSync(pkgPath)) {
@@ -117,12 +90,10 @@ export function detectPackageManager(projectPath) {
         }
     }
     catch {
-        // Ignore parse errors
     }
     return 'unknown';
 }
 const STACK_DETECTIONS = [
-    // Frameworks
     { name: 'Next.js', patterns: { dependencies: ['next'] } },
     { name: 'React', patterns: { dependencies: ['react'] } },
     { name: 'Vue', patterns: { dependencies: ['vue'] } },
@@ -131,38 +102,31 @@ const STACK_DETECTIONS = [
     { name: 'Astro', patterns: { dependencies: ['astro'] } },
     { name: 'Remix', patterns: { dependencies: ['@remix-run/react'] } },
     { name: 'Nuxt', patterns: { dependencies: ['nuxt'] } },
-    // Runtime & Build
     { name: 'TypeScript', patterns: { devDependencies: ['typescript'] } },
     { name: 'Bun', patterns: { devDependencies: ['bun-types'], files: ['bun.lockb'] } },
     { name: 'Vite', patterns: { devDependencies: ['vite'] } },
     { name: 'Webpack', patterns: { devDependencies: ['webpack'] } },
     { name: 'ESBuild', patterns: { devDependencies: ['esbuild'] } },
-    // Styling
     { name: 'Tailwind CSS', patterns: { devDependencies: ['tailwindcss'] } },
     { name: 'Sass', patterns: { devDependencies: ['sass'] } },
     { name: 'PostCSS', patterns: { devDependencies: ['postcss'] } },
     { name: 'Styled Components', patterns: { dependencies: ['styled-components'] } },
-    // Database & ORM
     { name: 'Prisma', patterns: { devDependencies: ['prisma'], files: ['prisma/schema.prisma'] } },
     { name: 'Drizzle', patterns: { devDependencies: ['drizzle-kit'] } },
     { name: 'TypeORM', patterns: { dependencies: ['typeorm'] } },
     { name: 'Mongoose', patterns: { dependencies: ['mongoose'] } },
     { name: 'SQLite', patterns: { dependencies: ['better-sqlite3', 'sql.js'] } },
-    // Backend
     { name: 'Express', patterns: { dependencies: ['express'] } },
     { name: 'Fastify', patterns: { dependencies: ['fastify'] } },
     { name: 'NestJS', patterns: { dependencies: ['@nestjs/core'] } },
     { name: 'Hono', patterns: { dependencies: ['hono'] } },
-    // Testing
     { name: 'Jest', patterns: { devDependencies: ['jest'] } },
     { name: 'Vitest', patterns: { devDependencies: ['vitest'] } },
     { name: 'Playwright', patterns: { devDependencies: ['@playwright/test', 'playwright'] } },
     { name: 'Cypress', patterns: { devDependencies: ['cypress'] } },
-    // Linting & Formatting
     { name: 'ESLint', patterns: { devDependencies: ['eslint'], files: ['.eslintrc.js', '.eslintrc.json', 'eslint.config.js'] } },
     { name: 'Prettier', patterns: { devDependencies: ['prettier'] } },
     { name: 'Biome', patterns: { devDependencies: ['@biomejs/biome'] } },
-    // Auth & Services
     { name: 'Supabase', patterns: { dependencies: ['@supabase/supabase-js'] } },
     { name: 'Firebase', patterns: { dependencies: ['firebase'] } },
     { name: 'Clerk', patterns: { dependencies: ['@clerk/nextjs', '@clerk/clerk-react'] } },
@@ -170,7 +134,6 @@ const STACK_DETECTIONS = [
 ];
 export function detectTechStack(projectPath) {
     const detected = [];
-    // Read package.json
     let pkg = {};
     try {
         const pkgPath = path.join(projectPath, 'package.json');
@@ -179,7 +142,6 @@ export function detectTechStack(projectPath) {
         }
     }
     catch {
-        // Return empty if no package.json
         return detected;
     }
     const deps = pkg.dependencies || {};
@@ -187,7 +149,6 @@ export function detectTechStack(projectPath) {
     const allDeps = { ...deps, ...devDeps };
     for (const stack of STACK_DETECTIONS) {
         let found = false;
-        // Check dependencies
         if (stack.patterns.dependencies) {
             for (const dep of stack.patterns.dependencies) {
                 if (dep in deps || dep in allDeps) {
@@ -196,7 +157,6 @@ export function detectTechStack(projectPath) {
                 }
             }
         }
-        // Check devDependencies
         if (!found && stack.patterns.devDependencies) {
             for (const dep of stack.patterns.devDependencies) {
                 if (dep in devDeps || dep in allDeps) {
@@ -205,7 +165,6 @@ export function detectTechStack(projectPath) {
                 }
             }
         }
-        // Check files
         if (!found && stack.patterns.files) {
             for (const file of stack.patterns.files) {
                 if (fs.existsSync(path.join(projectPath, file))) {

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

@@ -1,9 +1,3 @@
-/**
- * Weave Environment Analysis Module
- *
- * Proactive knowledge system for detecting potential issues
- * BEFORE they occur, based on environment + stack combinations.
- */
 import type { EnvironmentContext, EnvironmentAnalysis } from '../types.js';
 import { type DetectorOptions } from './detector.js';
 import { type CollectIssuesOptions } from './issues.js';
@@ -12,21 +6,8 @@ export { collectPotentialIssues, filterIssuesBySeverity, filterIssuesByCategory,
 export type { DetectorOptions } from './detector.js';
 export type { CollectIssuesOptions, PhaseContext, FeatureContext, ContextSearchResult, } from './issues.js';
 export interface AnalyzeOptions extends DetectorOptions, CollectIssuesOptions {
-    /** If true, only include warnings and critical issues in the summary */
     warningsOnly?: boolean;
 }
-/**
- * Perform complete environment analysis.
- * Detects environment context and collects matching potential issues.
- */
 export declare function analyzeEnvironment(options?: AnalyzeOptions): Promise<EnvironmentAnalysis>;
-/**
- * Quick check if there are any critical issues for the current environment.
- * Useful for CLI warnings or pre-flight checks.
- */
 export declare function hasCriticalIssues(options?: AnalyzeOptions): Promise<boolean>;
-/**
- * Get a one-liner summary of the environment.
- * Useful for logging or status displays.
- */
 export declare function getEnvironmentOneLiner(context: EnvironmentContext): string;

package/dist/weave/environment/index.js

@@ -1,31 +1,14 @@
-/**
- * Weave Environment Analysis Module
- *
- * Proactive knowledge system for detecting potential issues
- * BEFORE they occur, based on environment + stack combinations.
- */
 import { detectEnvironment } from './detector.js';
 import { collectPotentialIssues, filterIssuesBySeverity } from './issues.js';
-// Re-export types and utilities
 export { detectEnvironment } from './detector.js';
-export { collectPotentialIssues, filterIssuesBySeverity, filterIssuesByCategory, 
-// Phase/Feature context search
-searchPhaseIssues, searchFeatureIssues, formatContextResults, } from './issues.js';
-/**
- * Perform complete environment analysis.
- * Detects environment context and collects matching potential issues.
- */
+export { collectPotentialIssues, filterIssuesBySeverity, filterIssuesByCategory, searchPhaseIssues, searchFeatureIssues, formatContextResults, } from './issues.js';
 export async function analyzeEnvironment(options = {}) {
     const { warningsOnly = false, ...otherOptions } = options;
-    // Detect environment
     const context = detectEnvironment(otherOptions);
-    // Collect potential issues
     let issues = await collectPotentialIssues(context, otherOptions);
-    // Filter if warningsOnly
     if (warningsOnly) {
         issues = filterIssuesBySeverity(issues, 'warning');
     }
-    // Generate summary
     const summary = generateSummary(context, issues);
     return {
         context,
@@ -34,14 +17,9 @@ export async function analyzeEnvironment(options = {}) {
         analyzedAt: new Date().toISOString(),
     };
 }
-// ============================================================================
-// Summary Generation
-// ============================================================================
 function generateSummary(context, issues) {
     const lines = [];
-    // Header
     lines.push('## 🔍 환경 분석 결과\n');
-    // Environment Context
     lines.push('### 📋 실행 환경');
     lines.push(`- **OS**: ${formatOS(context.os)}`);
     lines.push(`- **Shell**: ${context.shell}`);
@@ -54,7 +32,6 @@ function generateSummary(context, issues) {
         lines.push(`- **기술 스택**: ${context.stack.join(', ')}`);
     }
     lines.push('');
-    // Issues Summary
     const criticalCount = issues.filter(i => i.severity === 'critical').length;
     const warningCount = issues.filter(i => i.severity === 'warning').length;
     const infoCount = issues.filter(i => i.severity === 'info').length;
@@ -72,7 +49,6 @@ function generateSummary(context, issues) {
         if (infoCount > 0)
             lines.push(`- 🔵 **Info**: ${infoCount}개`);
         lines.push('');
-        // Critical issues first
         const criticalIssues = issues.filter(i => i.severity === 'critical');
         if (criticalIssues.length > 0) {
             lines.push('#### 🔴 Critical Issues');
@@ -85,7 +61,6 @@ function generateSummary(context, issues) {
                 lines.push('');
             }
         }
-        // Warning issues
         const warningIssues = issues.filter(i => i.severity === 'warning');
         if (warningIssues.length > 0) {
             lines.push('#### 🟡 Warnings');
@@ -98,7 +73,6 @@ function generateSummary(context, issues) {
                 lines.push('');
             }
         }
-        // Info issues (brief)
         const infoIssues = issues.filter(i => i.severity === 'info');
         if (infoIssues.length > 0) {
             lines.push('#### 🔵 참고 사항');
@@ -108,7 +82,6 @@ function generateSummary(context, issues) {
             lines.push('');
         }
     }
-    // Footer
     const builtinCount = issues.filter(i => i.source === 'builtin').length;
     const historyCount = issues.filter(i => i.source === 'project_history').length;
     lines.push('---');
@@ -130,21 +103,10 @@ function formatOS(os) {
             return os;
     }
 }
-// ============================================================================
-// Quick Check Functions
-// ============================================================================
-/**
- * Quick check if there are any critical issues for the current environment.
- * Useful for CLI warnings or pre-flight checks.
- */
 export async function hasCriticalIssues(options = {}) {
     const analysis = await analyzeEnvironment(options);
     return analysis.issues.some(i => i.severity === 'critical');
 }
-/**
- * Get a one-liner summary of the environment.
- * Useful for logging or status displays.
- */
 export function getEnvironmentOneLiner(context) {
     const parts = [
         formatOS(context.os),

package/dist/weave/environment/issues.d.ts

@@ -1,9 +1,3 @@
-/**
- * Potential Issues Collector
- *
- * Combines hardcoded known issues with project history from Global Knowledge.
- * Provides proactive warnings based on environment + stack combinations.
- */
 import type { EnvironmentContext, PotentialIssue } from '../types.js';
 export interface CollectIssuesOptions {
     includeProjectHistory?: boolean;
@@ -12,54 +6,25 @@ export interface CollectIssuesOptions {
 export declare function collectPotentialIssues(context: EnvironmentContext, options?: CollectIssuesOptions): Promise<PotentialIssue[]>;
 export declare function filterIssuesByCategory(issues: PotentialIssue[], category: PotentialIssue['category']): PotentialIssue[];
 export declare function filterIssuesBySeverity(issues: PotentialIssue[], minSeverity: PotentialIssue['severity']): PotentialIssue[];
-/**
- * Context for phase-specific issue search
- */
 export interface PhaseContext {
-    /** Phase name (e.g., "로그인 구현", "감정 선택 UI") */
     phaseName: string;
-    /** Phase ID (e.g., "P1", "P2") */
     phaseId?: string;
-    /** Tasks within this phase */
     tasks?: string[];
-    /** Done criteria */
     doneWhen?: string;
 }
-/**
- * Context for feature-specific issue search
- */
 export interface FeatureContext {
-    /** Feature name or description */
     featureName: string;
-    /** Related keywords for search */
     keywords?: string[];
-    /** Related tech stack for filtering */
     relatedStack?: string[];
 }
-/**
- * Result from context-based search
- */
 export interface ContextSearchResult extends PotentialIssue {
-    /** Relevance score (0-1) */
     relevance: number;
-    /** Which context matched */
     matchedContext: string;
 }
-/**
- * Search for issues relevant to a specific phase.
- * Combines phase metadata with environment context for targeted search.
- */
 export declare function searchPhaseIssues(phaseContext: PhaseContext, environmentContext: EnvironmentContext, options?: {
     limit?: number;
 }): Promise<ContextSearchResult[]>;
-/**
- * Search for issues relevant to a specific feature request.
- * Useful when implementing new features to find similar past problems.
- */
 export declare function searchFeatureIssues(featureContext: FeatureContext, environmentContext: EnvironmentContext, options?: {
     limit?: number;
 }): Promise<ContextSearchResult[]>;
-/**
- * Quick helper to format context search results as markdown.
- */
 export declare function formatContextResults(results: ContextSearchResult[], title?: string): string;