maskweaver 0.9.4 → 0.9.6

package/dist/weave/worktree.js

@@ -1,22 +1,9 @@
-/**
- * Weave Worktree Utilities
- *
- * Provides git worktree helpers tailored for Weave workflows.
- *
- * Goals:
- * - Enable parallel feature/phase work on isolated working directories
- * - Bootstrap .opencode/weave artifacts into newly created worktrees
- * - Keep "weave init once" principle by copying/creating required files
- */
 import * as fs from 'node:fs';
 import * as path from 'node:path';
 import { execFile } from 'node:child_process';
 import { promisify } from 'node:util';
 import { createWorktreeManager } from '../shared-context/worktree.js';
 const execFileAsync = promisify(execFile);
-// ============================================================================
-// Git helpers
-// ============================================================================
 async function git(cwd, args) {
     try {
         const { stdout } = await execFileAsync('git', args, { cwd });
@@ -44,9 +31,6 @@ function toKebabCase(input) {
         .replace(/[^a-z0-9]+/g, '-')
         .replace(/^-+|-+$/g, '');
 }
-// ============================================================================
-// Bootstrap helpers
-// ============================================================================
 export function ensureIgnoreOverride(projectRoot) {
     const ignorePath = path.join(projectRoot, '.ignore');
     const allowLine = '!.opencode/weave/';
@@ -148,7 +132,6 @@ function copyDirectoryRecursive(srcDir, destDir) {
 export function bootstrapWeaveArtifacts(fromRoot, toRoot) {
     ensureIgnoreOverride(toRoot);
     ensureWeaveState(toRoot);
-    // Copy weave artifacts if they exist in the source worktree.
     copyIfExists(path.join(fromRoot, '.opencode', 'weave', 'state.yaml'), path.join(toRoot, '.opencode', 'weave', 'state.yaml'));
     copyYamlDirIfExists(path.join(fromRoot, '.opencode', 'weave', 'plans'), path.join(toRoot, '.opencode', 'weave', 'plans'));
     copyYamlDirIfExists(path.join(fromRoot, '.opencode', 'weave', 'specs'), path.join(toRoot, '.opencode', 'weave', 'specs'));
@@ -162,9 +145,6 @@ export function bootstrapGdcArtifacts(fromRoot, toRoot) {
     const destNodes = path.join(toRoot, '.gdc', 'nodes');
     copyGdcNodesRecursive(srcNodes, destNodes);
 }
-// ============================================================================
-// Public API
-// ============================================================================
 export async function createWeaveWorktree(options) {
     const basePath = path.resolve(options.basePath);
     const slug = toKebabCase(options.name);
@@ -230,9 +210,6 @@ export async function removeWeaveWorktree(options) {
         worktreeBase: path.join('.worktrees', 'weave'),
         branchPrefix: 'weave/',
     });
-    // Remove worktree directory via git.
-    // NOTE: The shared worktree manager also deletes the branch. For user-facing
-    // flows we make branch deletion optional.
     const info = await manager.get(slug);
     if (!info)
         return;

package/dist/weave/yaml-repair.d.ts

@@ -1,19 +1,8 @@
-/**
- * YAML Repair Utility
- *
- * Provides YAML string escaping, corruption detection, and auto-repair
- * for Weave plan files. Handles common YAML corruption patterns:
- * - Unclosed/mismatched quotes
- * - Unescaped special characters in string values
- * - Tab→space conversion
- * - Truncated files
- */
 export interface RepairResult {
     file: string;
     status: 'ok' | 'repaired' | 'unrecoverable';
     error?: string;
     details?: string;
-    /** Structured info about what's missing for user-assisted repair */
     missingInfo?: MissingInfo[];
 }
 export interface MissingInfo {
@@ -21,31 +10,13 @@ export interface MissingInfo {
     description: string;
     lineHint?: number;
 }
-/**
- * Properly escape a string value for YAML double-quoted format.
- * Handles all YAML special characters that would break parsing.
- */
 export declare function yamlEscapeString(value: string): string;
-/**
- * Attempt to repair corrupted YAML content.
- * Returns the repaired content or null if unrecoverable.
- */
 export declare function repairYamlContent(content: string): {
     repaired: string | null;
     changes: string[];
     missingInfo: MissingInfo[];
 };
-/**
- * Write a file atomically with backup.
- * 1. Copy existing file to .bak
- * 2. Write to .tmp
- * 3. Rename .tmp to target
- */
 export declare function safeWriteFile(filePath: string, content: string): void;
-/**
- * Safely read and parse a YAML file with auto-repair on failure.
- * Returns the parsed object, or an error message.
- */
 export declare function safeReadYaml(filePath: string): Promise<{
     data: any | null;
     repaired: boolean;
@@ -53,19 +24,9 @@ export declare function safeReadYaml(filePath: string): Promise<{
     changes?: string[];
     missingInfo?: MissingInfo[];
 }>;
-/**
- * Repair a single plan YAML file.
- */
 export declare function repairPlanFile(filePath: string): Promise<RepairResult>;
-/**
- * Scan and repair all plan YAML files in the plans/ directory.
- */
 export declare function repairAllPlans(basePath?: string): Promise<{
     results: RepairResult[];
     summary: string;
 }>;
-/**
- * Validate and sanitize plan structure after parsing.
- * Filters out invalid phases and ensures required fields exist.
- */
 export declare function validatePlanStructure(raw: any): any;

package/dist/weave/yaml-repair.js

@@ -1,27 +1,9 @@
-/**
- * YAML Repair Utility
- *
- * Provides YAML string escaping, corruption detection, and auto-repair
- * for Weave plan files. Handles common YAML corruption patterns:
- * - Unclosed/mismatched quotes
- * - Unescaped special characters in string values
- * - Tab→space conversion
- * - Truncated files
- */
 import * as fs from 'node:fs';
 import * as path from 'node:path';
-// ============================================================================
-// YAML String Escaping
-// ============================================================================
-/**
- * Properly escape a string value for YAML double-quoted format.
- * Handles all YAML special characters that would break parsing.
- */
 export function yamlEscapeString(value) {
     if (value === undefined || value === null)
         return '""';
     const str = String(value);
-    // If the string is simple (no special chars), return as-is with quotes
     if (/^[a-zA-Z0-9가-힣ぁ-んァ-ヶ\s.,;:!?@#%^&*()_+=\-\[\]{}/<>~`|']+$/.test(str)
         && !str.includes('"')
         && !str.includes('\\')
@@ -29,40 +11,30 @@ export function yamlEscapeString(value) {
         && !str.endsWith(' ')) {
         return `"${str}"`;
     }
-    // Escape special characters for YAML double-quoted strings
     const escaped = str
-        .replace(/\\/g, '\\\\') // backslash first
-        .replace(/"/g, '\\"') // double quotes
-        .replace(/\n/g, '\\n') // newlines
-        .replace(/\r/g, '\\r') // carriage returns
-        .replace(/\t/g, '\\t') // tabs
-        .replace(/\0/g, '\\0'); // null bytes
+        .replace(/\\/g, '\\\\')
+        .replace(/"/g, '\\"')
+        .replace(/\n/g, '\\n')
+        .replace(/\r/g, '\\r')
+        .replace(/\t/g, '\\t')
+        .replace(/\0/g, '\\0');
     return `"${escaped}"`;
 }
-// ============================================================================
-// YAML Corruption Detection
-// ============================================================================
-/**
- * Detect common YAML corruption patterns and return error details.
- */
 function detectCorruption(content) {
     const issues = [];
     const lines = content.split('\n');
     for (let i = 0; i < lines.length; i++) {
         const line = lines[i];
         const lineNum = i + 1;
-        // Check for unclosed double quotes in value positions
         const valueMatch = line.match(/^(\s*[\w_-]+:\s*)"(.*)/);
         if (valueMatch) {
             const afterColon = valueMatch[2];
-            // Count unescaped quotes
             const unescaped = afterColon.replace(/\\"/g, '');
             const quoteCount = (unescaped.match(/"/g) || []).length;
             if (quoteCount % 2 !== 0) {
                 issues.push(`Line ${lineNum}: Unclosed double quote in value`);
             }
         }
-        // Check for array items with unclosed quotes
         const arrayMatch = line.match(/^(\s*-\s*)"(.*)/);
         if (arrayMatch && !line.match(/^(\s*-\s*\w+:\s*)/)) {
             const afterDash = arrayMatch[2];
@@ -72,7 +44,6 @@ function detectCorruption(content) {
                 issues.push(`Line ${lineNum}: Unclosed double quote in array item`);
             }
         }
-        // Check for tabs (YAML requires spaces)
         if (line.includes('\t') && !line.match(/:\s*".*\t.*"/)) {
             issues.push(`Line ${lineNum}: Tab character in indentation`);
         }
@@ -82,23 +53,14 @@ function detectCorruption(content) {
         issues,
     };
 }
-// ============================================================================
-// YAML Content Repair
-// ============================================================================
-/**
- * Attempt to repair corrupted YAML content.
- * Returns the repaired content or null if unrecoverable.
- */
 export function repairYamlContent(content) {
     const changes = [];
     const missingInfo = [];
     let repaired = content;
-    // 1. Convert tabs to spaces (YAML requires spaces)
     if (repaired.includes('\t')) {
         repaired = repaired.replace(/\t/g, '  ');
         changes.push('Converted tabs to spaces');
     }
-    // 2. Normalize line endings
     if (repaired.includes('\r\n')) {
         repaired = repaired.replace(/\r\n/g, '\n');
         changes.push('Normalized line endings (CRLF→LF)');
@@ -107,27 +69,22 @@ export function repairYamlContent(content) {
         repaired = repaired.replace(/\r/g, '\n');
         changes.push('Normalized line endings (CR→LF)');
     }
-    // 3. Fix unclosed quotes in key-value pairs
     const lines = repaired.split('\n');
     const fixedLines = [];
     for (let i = 0; i < lines.length; i++) {
         let line = lines[i];
         const lineNum = i + 1;
-        // Pattern: key: "value with "embedded" quotes or unclosed
         const kvMatch = line.match(/^(\s*)([\w_-]+):\s*"(.*)$/);
         if (kvMatch) {
             const [, indent, key, rest] = kvMatch;
-            // Check if the rest ends with a properly closed quote
             if (!rest.endsWith('"') || hasUnbalancedQuotes(rest)) {
-                // Fix: escape internal quotes and ensure closure
                 const fixedValue = rest
-                    .replace(/"$/g, '') // remove trailing quote if any
-                    .replace(/(?<!\\)"/g, '\\"'); // escape unescaped internal quotes
+                    .replace(/"$/g, '')
+                    .replace(/(?<!\\)"/g, '\\"');
                 line = `${indent}${key}: "${fixedValue}"`;
                 changes.push(`Line ${lineNum}: Fixed unclosed/mismatched quotes in '${key}'`);
             }
         }
-        // Pattern: array item - "value with unclosed quotes
         const arrayMatch = line.match(/^(\s*-\s*)"(.*)$/);
         if (arrayMatch && !line.match(/^(\s*-\s*\w+:\s*)/)) {
             const [, prefix, rest] = arrayMatch;
@@ -139,7 +96,6 @@ export function repairYamlContent(content) {
                 changes.push(`Line ${lineNum}: Fixed unclosed quotes in array item`);
             }
         }
-        // Pattern: array item key: "value with unclosed quotes
         const arrayKvMatch = line.match(/^(\s*-?\s*)([\w_-]+):\s*"(.*)$/);
         if (arrayKvMatch) {
             const [, indent, key, rest] = arrayKvMatch;
@@ -154,9 +110,7 @@ export function repairYamlContent(content) {
         fixedLines.push(line);
     }
     repaired = fixedLines.join('\n');
-    // 4. Validate the repaired content by attempting a parse
     try {
-        // Dynamic import would be async, so we do a basic structural check
         if (!hasBasicYamlStructure(repaired)) {
             missingInfo.push({
                 field: 'structure',
@@ -165,78 +119,48 @@ export function repairYamlContent(content) {
         }
     }
     catch {
-        // ignore validation errors at this stage
     }
     if (changes.length === 0 && missingInfo.length > 0) {
         return { repaired: null, changes, missingInfo };
     }
     return { repaired, changes, missingInfo };
 }
-/**
- * Check if a string (after the opening quote) has unbalanced quotes.
- */
 function hasUnbalancedQuotes(str) {
-    // Remove escaped quotes
     const cleaned = str.replace(/\\"/g, '');
-    // Count remaining quotes (should be odd number since the opening was already stripped)
     const count = (cleaned.match(/"/g) || []).length;
-    // After opening quote was stripped, remaining should have odd count
-    // (one for closing). Even count means unbalanced.
     return count % 2 === 0;
 }
-/**
- * Basic structural validation for a Weave plan YAML.
- */
 function hasBasicYamlStructure(content) {
     return content.includes('project_name:') && content.includes('phases:');
 }
-// ============================================================================
-// Safe File I/O
-// ============================================================================
-/**
- * Write a file atomically with backup.
- * 1. Copy existing file to .bak
- * 2. Write to .tmp
- * 3. Rename .tmp to target
- */
 export function safeWriteFile(filePath, content) {
-    // Create backup of existing file
     if (fs.existsSync(filePath)) {
         try {
             fs.copyFileSync(filePath, `${filePath}.bak`);
         }
         catch {
-            // Backup failed, continue anyway
         }
     }
     const tmpPath = `${filePath}.tmp`;
     try {
         fs.writeFileSync(tmpPath, content, 'utf-8');
-        // Atomic rename
         try {
             fs.renameSync(tmpPath, filePath);
         }
         catch {
-            // Windows fallback: rename can fail if target exists
             fs.writeFileSync(filePath, content, 'utf-8');
             try {
                 fs.unlinkSync(tmpPath);
             }
-            catch { /* ignore */ }
+            catch { }
         }
     }
     catch (e) {
-        // Last resort: direct write
         fs.writeFileSync(filePath, content, 'utf-8');
     }
 }
-/**
- * Safely read and parse a YAML file with auto-repair on failure.
- * Returns the parsed object, or an error message.
- */
 export async function safeReadYaml(filePath) {
     const { parse } = await import('yaml');
-    // 1. Try normal read + parse
     try {
         const content = fs.readFileSync(filePath, 'utf-8');
         const data = parse(content);
@@ -244,18 +168,16 @@ export async function safeReadYaml(filePath) {
     }
     catch (parseError) {
         const errorMsg = parseError instanceof Error ? parseError.message : String(parseError);
-        // 2. Try auto-repair
         try {
             const rawContent = fs.readFileSync(filePath, 'utf-8');
             const repair = repairYamlContent(rawContent);
             if (repair.repaired) {
                 try {
                     const data = parse(repair.repaired);
-                    // Save corrupted backup and write repaired content
                     try {
                         fs.copyFileSync(filePath, `${filePath}.corrupted`);
                     }
-                    catch { /* ignore backup failure */ }
+                    catch { }
                     safeWriteFile(filePath, repair.repaired);
                     console.log(`[PhaseManager] Auto-repaired ${path.basename(filePath)}: ${repair.changes.join(', ')}`);
                     return {
@@ -266,29 +188,25 @@ export async function safeReadYaml(filePath) {
                     };
                 }
                 catch (repairParseError) {
-                    // Repair didn't fix the parse error
                 }
             }
         }
-        catch { /* repair attempt failed */ }
-        // 3. Try .bak file
+        catch { }
         const bakPath = `${filePath}.bak`;
         if (fs.existsSync(bakPath)) {
             try {
                 const bakContent = fs.readFileSync(bakPath, 'utf-8');
                 const data = parse(bakContent);
-                // Save corrupted file and restore from backup
                 try {
                     fs.copyFileSync(filePath, `${filePath}.corrupted`);
                 }
-                catch { /* ignore */ }
+                catch { }
                 fs.copyFileSync(bakPath, filePath);
                 console.log(`[PhaseManager] Restored ${path.basename(filePath)} from backup`);
                 return { data, repaired: true, changes: ['Restored from .bak backup'] };
             }
-            catch { /* .bak also corrupted */ }
+            catch { }
         }
-        // 4. Unrecoverable
         return {
             data: null,
             repaired: false,
@@ -300,12 +218,6 @@ export async function safeReadYaml(filePath) {
         };
     }
 }
-// ============================================================================
-// Plan File Repair
-// ============================================================================
-/**
- * Repair a single plan YAML file.
- */
 export async function repairPlanFile(filePath) {
     const fileName = path.basename(filePath);
     if (!fs.existsSync(filePath)) {
@@ -330,24 +242,18 @@ export async function repairPlanFile(filePath) {
         missingInfo: result.missingInfo,
     };
 }
-/**
- * Scan and repair all plan YAML files in the plans/ directory.
- */
 export async function repairAllPlans(basePath = process.cwd()) {
     const weaveDir = path.join(basePath, '.opencode', 'weave');
     const plansDir = path.join(weaveDir, 'plans');
     const results = [];
-    // Check legacy PLAN.yaml
     const legacyPath = path.join(weaveDir, 'PLAN.yaml');
     if (fs.existsSync(legacyPath)) {
         results.push(await repairPlanFile(legacyPath));
     }
-    // Check state.yaml
     const statePath = path.join(weaveDir, 'state.yaml');
     if (fs.existsSync(statePath)) {
         results.push(await repairPlanFile(statePath));
     }
-    // Scan plans/ directory
     if (fs.existsSync(plansDir)) {
         try {
             const files = fs.readdirSync(plansDir).filter(f => f.endsWith('.yaml'));
@@ -360,7 +266,6 @@ export async function repairAllPlans(basePath = process.cwd()) {
             console.error('[YamlRepair] Failed to scan plans directory:', e);
         }
     }
-    // Generate summary
     const ok = results.filter(r => r.status === 'ok').length;
     const repaired = results.filter(r => r.status === 'repaired').length;
     const unrecoverable = results.filter(r => r.status === 'unrecoverable').length;
@@ -391,7 +296,6 @@ export async function repairAllPlans(basePath = process.cwd()) {
             lines.push('');
         }
     }
-    // Advice for unrecoverable files
     if (unrecoverable > 0) {
         lines.push('---');
         lines.push('### Recovery Options for Unrecoverable Files\n');
@@ -401,18 +305,12 @@ export async function repairAllPlans(basePath = process.cwd()) {
     }
     return { results, summary: lines.join('\n') };
 }
-/**
- * Validate and sanitize plan structure after parsing.
- * Filters out invalid phases and ensures required fields exist.
- */
 export function validatePlanStructure(raw) {
     if (!raw || typeof raw !== 'object')
         return null;
-    // Ensure required fields
     if (!raw.project_name && !raw.projectName) {
         raw.project_name = 'Unknown (recovered)';
     }
-    // Filter invalid phases
     if (Array.isArray(raw.phases)) {
         raw.phases = raw.phases.filter((p) => {
             if (!p || typeof p !== 'object')
@@ -421,7 +319,6 @@ export function validatePlanStructure(raw) {
                 return false;
             return true;
         });
-        // Sanitize each phase
         for (const phase of raw.phases) {
             if (!phase.name)
                 phase.name = phase.id;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "maskweaver",
-  "version": "0.9.4",
+  "version": "0.9.6",
   "description": "AI Expert Persona System - Give your AI coding assistant expert personalities (가면술사)",
   "type": "module",
   "main": "./dist/index.js",