maskweaver 0.9.3 → 0.9.5

package/dist/weave/types.d.ts

@@ -1,8 +1,3 @@
-/**
- * Weave Types
- *
- * Core type definitions for the phase-driven development workflow.
- */
 export type PhaseStatus = 'pending' | 'in_progress' | 'completed' | 'blocked';
 export interface StructuralIssue {
     area: string;
@@ -148,11 +143,8 @@ export interface WeaveTask {
     lastError?: string;
     maskUsed?: string;
 }
-/** Agent tier for task delegation - maps to subagent_type */
 export type AgentTier = 'dummy-flash' | 'dummy-human' | 'dummy-premium';
-/** Task complexity assessment */
 export type TaskComplexity = 'simple' | 'standard' | 'complex';
-/** Execution plan for a single task within a phase */
 export interface TaskExecutionPlan {
     task: WeaveTask;
     mask: string | null;
@@ -160,7 +152,6 @@ export interface TaskExecutionPlan {
     complexity: TaskComplexity;
     troubleshootingHints: string[];
 }
-/** Execution plan for an entire phase */
 export interface PhaseExecutionPlan {
     phaseId: string;
     phaseName: string;
@@ -233,12 +224,6 @@ export interface WeaveLoopOperatorState {
     lastSummary?: string;
 }
 export interface WeavePlan {
-    /**
-     * Stable, filesystem-safe identifier for the plan.
-     * Used for plan filename and state.yaml active_plan.
-     *
-     * Example: "emotion-diary"
-     */
     planName?: string;
     projectName: string;
     createdAt: string;
@@ -250,14 +235,11 @@ export interface WeavePlan {
         database?: string;
         notes?: string;
     };
-    /** Optional research artifact path generated before planning. */
     researchPath?: string;
     researchUpdatedAt?: string;
-    /** Plan approval gate metadata (required before implementation). */
     planApproved?: boolean;
     planApprovedAt?: string;
     planApprovalNotes?: string;
-    /** Optional metadata for automatically split plans. */
     planRole?: 'standalone' | 'shard';
     parentPlanName?: string;
     shardIndex?: number;
@@ -265,11 +247,9 @@ export interface WeavePlan {
     nextPlanName?: string;
     activeChangeId?: string;
     changeIds?: string[];
-    /** Map / codebase analysis metadata. */
     mapGeneratedAt?: string;
     mapReportPath?: string;
     structuralChanges?: StructuralChange[];
-    /** OpenSpec artifact directory (relative path). */
     openspecDir?: string;
     phases: WeavePhase[];
     currentPhase?: string;

package/dist/weave/types.js

@@ -1,6 +1 @@
-/**
- * Weave Types
- *
- * Core type definitions for the phase-driven development workflow.
- */
 export {};

package/dist/weave/verification/commands.d.ts

@@ -1,21 +1,9 @@
-/**
- * Verification Command Recommendation
- *
- * Weave should not assume `npm run build/test` (web-centric). Instead, it
- * recommends build/test commands based on detected project tooling.
- *
- * This module is intentionally heuristic-based and conservative:
- * - Prefer project-defined scripts (package.json scripts)
- * - Fall back to common ecosystem defaults when evidence is strong
- */
 export type DetectedProjectType = 'node' | 'go' | 'rust' | 'python' | 'dotnet' | 'unknown';
 export type VerificationStepName = 'GdcSync' | 'GdcCheck' | 'TypeCheck' | 'Lint' | 'Build' | 'UnitTests';
 export interface VerificationCommandStep {
     name: VerificationStepName;
     cmd: string;
-    /** If false, this step may be skipped in lenient mode. */
     required: boolean;
-    /** Human-readable reason used for logs/debugging. */
     reason?: string;
 }
 export interface VerificationCommandRecommendation {

package/dist/weave/verification/commands.js

@@ -1,13 +1,3 @@
-/**
- * Verification Command Recommendation
- *
- * Weave should not assume `npm run build/test` (web-centric). Instead, it
- * recommends build/test commands based on detected project tooling.
- *
- * This module is intentionally heuristic-based and conservative:
- * - Prefer project-defined scripts (package.json scripts)
- * - Fall back to common ecosystem defaults when evidence is strong
- */
 import * as fs from 'node:fs';
 import * as path from 'node:path';
 function exists(projectPath, rel) {
@@ -47,7 +37,6 @@ function detectProjectType(projectPath, projectTypeHint) {
         evidence.push(`hint:${projectTypeHint}`);
         return { type: hinted, evidence };
     }
-    // Prefer strong ecosystem markers over package.json (monorepos often contain a package.json for tooling).
     if (exists(projectPath, 'go.mod')) {
         evidence.push('go.mod');
         return { type: 'go', evidence };
@@ -65,7 +54,6 @@ function detectProjectType(projectPath, projectTypeHint) {
             evidence.push('setup.py');
         return { type: 'python', evidence };
     }
-    // .NET (top-level scan for typical files)
     try {
         const entries = fs.readdirSync(projectPath, { withFileTypes: true });
         const hasSln = entries.some(e => e.isFile() && e.name.toLowerCase().endsWith('.sln'));
@@ -79,7 +67,6 @@ function detectProjectType(projectPath, projectTypeHint) {
         }
     }
     catch {
-        // ignore
     }
     if (exists(projectPath, 'package.json')) {
         evidence.push('package.json');
@@ -159,26 +146,21 @@ function recommendNode(projectPath) {
     }
     const build = [];
     const test = [];
-    // TypeCheck
     if (scripts.typecheck) {
         build.push({ name: 'TypeCheck', cmd: pmRun(pm, 'typecheck'), required: true, reason: 'package.json scripts.typecheck' });
     }
     else if (scripts.check) {
         build.push({ name: 'TypeCheck', cmd: pmRun(pm, 'check'), required: true, reason: 'package.json scripts.check' });
     }
-    // Lint
     if (scripts.lint) {
         build.push({ name: 'Lint', cmd: pmRun(pm, 'lint'), required: true, reason: 'package.json scripts.lint' });
     }
-    // Build
     if (scripts.build) {
         build.push({ name: 'Build', cmd: pmRun(pm, 'build'), required: true, reason: 'package.json scripts.build' });
     }
     else {
-        // Many Node repos are runtime-only and have no build step.
         notes.push('No build script detected; skipping Build step recommendation');
     }
-    // Unit tests
     if (scripts.test && !isDefaultNpmInitTestScript(String(scripts.test))) {
         test.push({ name: 'UnitTests', cmd: pmRun(pm, 'test'), required: true, reason: 'package.json scripts.test' });
     }
@@ -259,7 +241,6 @@ function recommendPython(projectPath) {
     if (hasRuff) {
         build.push({ name: 'Lint', cmd: `${prefix}ruff check .`.trim(), required: true, reason: 'ruff config detected' });
     }
-    // "Build" in Python is often packaging-specific; compileall is a safe baseline.
     build.push({ name: 'Build', cmd: `${prefix}python -m compileall .`.trim(), required: false, reason: 'python compileall baseline' });
     if (hasPytest) {
         test.push({ name: 'UnitTests', cmd: `${prefix}pytest`.trim(), required: true, reason: 'pytest config/tests detected' });

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

@@ -1,8 +1,2 @@
-/**
- * Weave Verification System
- *
- * Multi-layer AI verification for zero-defect development.
- * Exports platform-specific verification integrations.
- */
 export { checkPlaywrightSetup, initPlaywright, runPlaywrightTests, runPlaywrightTestFile, runVisualRegressionTests, capturePageScreenshot, getTestScreenshots, analyzePlaywrightError, generatePlaywrightConfig, generateExampleTest, type PlaywrightConfig, type PlaywrightTestResult, type PlaywrightFailure, type PlaywrightSetupStatus, type PlaywrightErrorAnalysis, } from './playwright.js';
 export { recommendVerificationCommands, formatRecommendedCommandsAsBash, type VerificationCommandRecommendation, type VerificationCommandStep, type DetectedProjectType, } from './commands.js';

package/dist/weave/verification/index.js

@@ -1,20 +1,2 @@
-/**
- * Weave Verification System
- *
- * Multi-layer AI verification for zero-defect development.
- * Exports platform-specific verification integrations.
- */
-// Playwright E2E Testing (Web)
-export { 
-// Setup & Detection
-checkPlaywrightSetup, initPlaywright, 
-// Test Execution
-runPlaywrightTests, runPlaywrightTestFile, runVisualRegressionTests, 
-// Screenshots
-capturePageScreenshot, getTestScreenshots, 
-// Error Analysis (for Global Knowledge RAG)
-analyzePlaywrightError, 
-// Config Generation
-generatePlaywrightConfig, generateExampleTest, } from './playwright.js';
-// Generic build/test command recommendations
+export { checkPlaywrightSetup, initPlaywright, runPlaywrightTests, runPlaywrightTestFile, runVisualRegressionTests, capturePageScreenshot, getTestScreenshots, analyzePlaywrightError, generatePlaywrightConfig, generateExampleTest, } from './playwright.js';
 export { recommendVerificationCommands, formatRecommendedCommandsAsBash, } from './commands.js';

package/dist/weave/verification/playwright.d.ts

@@ -1,37 +1,14 @@
-/**
- * Playwright E2E Testing Integration for Weave
- *
- * Provides automated browser testing for web projects.
- * Integrates with the multi-layer verification system.
- *
- * Key features:
- * - Auto-detection of Playwright installation
- * - Headless test execution with structured output parsing
- * - Screenshot capture on failure for visual debugging
- * - Test result integration with Global Knowledge RAG
- */
 export interface PlaywrightConfig {
-    /** Project root directory */
     projectPath: string;
-    /** Base URL for the dev server (e.g., "http://localhost:3000") */
     devServerUrl?: string;
-    /** Run in headed mode for debugging */
     headed?: boolean;
-    /** Specific test file or pattern to run */
     testMatch?: string;
-    /** Browser(s) to test: 'chromium' | 'firefox' | 'webkit' | 'all' */
     browsers?: 'chromium' | 'firefox' | 'webkit' | 'all';
-    /** Maximum timeout for tests in milliseconds */
     timeout?: number;
-    /** Number of retries for flaky tests */
     retries?: number;
-    /** Output directory for screenshots and traces */
     outputDir?: string;
-    /** Capture screenshots on failure */
     screenshotOnFailure?: boolean;
-    /** Record trace for debugging */
     traceOnFailure?: boolean;
-    /** Update snapshots mode */
     updateSnapshots?: boolean;
 }
 export interface PlaywrightTestResult {
@@ -62,36 +39,15 @@ export interface PlaywrightSetupStatus {
     browsersInstalled: boolean;
     message: string;
 }
-/**
- * Check if Playwright is properly set up in the project
- */
 export declare function checkPlaywrightSetup(projectPath: string): Promise<PlaywrightSetupStatus>;
-/**
- * Initialize Playwright in a project
- */
 export declare function initPlaywright(projectPath: string): Promise<{
     success: boolean;
     message: string;
 }>;
-/**
- * Run Playwright E2E tests
- */
 export declare function runPlaywrightTests(config: PlaywrightConfig): Promise<PlaywrightTestResult>;
-/**
- * Run specific test file
- */
 export declare function runPlaywrightTestFile(projectPath: string, testFile: string, options?: Partial<PlaywrightConfig>): Promise<PlaywrightTestResult>;
-/**
- * Run tests with visual comparison
- */
 export declare function runVisualRegressionTests(projectPath: string, options?: Partial<PlaywrightConfig>): Promise<PlaywrightTestResult>;
-/**
- * Capture a screenshot of the current page state
- */
 export declare function capturePageScreenshot(projectPath: string, url: string, outputPath?: string): Promise<string>;
-/**
- * Get list of screenshots from a test run
- */
 export declare function getTestScreenshots(projectPath: string): Promise<string[]>;
 export interface PlaywrightErrorAnalysis {
     errorType: 'timeout' | 'assertion' | 'element' | 'network' | 'navigation' | 'script' | 'unknown';
@@ -102,9 +58,6 @@ export interface PlaywrightErrorAnalysis {
     suggestedFix?: string;
     errorSignature: string;
 }
-/**
- * Analyze Playwright error for knowledge base indexing
- */
 export declare function analyzePlaywrightError(failure: PlaywrightFailure): PlaywrightErrorAnalysis;
 declare function generatePlaywrightConfig(projectPath: string): string;
 declare function generateExampleTest(): string;

package/dist/weave/verification/playwright.js

@@ -1,24 +1,6 @@
-/**
- * Playwright E2E Testing Integration for Weave
- *
- * Provides automated browser testing for web projects.
- * Integrates with the multi-layer verification system.
- *
- * Key features:
- * - Auto-detection of Playwright installation
- * - Headless test execution with structured output parsing
- * - Screenshot capture on failure for visual debugging
- * - Test result integration with Global Knowledge RAG
- */
 import { spawn } from 'child_process';
 import { promises as fs } from 'fs';
 import * as path from 'path';
-// ============================================================================
-// Setup & Detection
-// ============================================================================
-/**
- * Check if Playwright is properly set up in the project
- */
 export async function checkPlaywrightSetup(projectPath) {
     const result = {
         installed: false,
@@ -26,7 +8,6 @@ export async function checkPlaywrightSetup(projectPath) {
         browsersInstalled: false,
         message: '',
     };
-    // Check if @playwright/test is in package.json
     try {
         const packageJsonPath = path.join(projectPath, 'package.json');
         const packageJson = JSON.parse(await fs.readFile(packageJsonPath, 'utf-8'));
@@ -37,9 +18,7 @@ export async function checkPlaywrightSetup(projectPath) {
         }
     }
     catch {
-        // package.json not found or parse error
     }
-    // Check for playwright.config.ts or playwright.config.js
     const configFiles = [
         'playwright.config.ts',
         'playwright.config.js',
@@ -52,10 +31,8 @@ export async function checkPlaywrightSetup(projectPath) {
             break;
         }
         catch {
-            // Config file not found
         }
     }
-    // Try to detect if browsers are installed by running playwright --version
     try {
         const versionOutput = await runCommand('npx', ['playwright', '--version'], projectPath);
         if (versionOutput.exitCode === 0) {
@@ -64,9 +41,7 @@ export async function checkPlaywrightSetup(projectPath) {
         }
     }
     catch {
-        // Playwright not available
     }
-    // Generate message
     if (!result.installed) {
         result.message = 'Playwright is not installed. Run: npm install -D @playwright/test';
     }
@@ -81,17 +56,12 @@ export async function checkPlaywrightSetup(projectPath) {
     }
     return result;
 }
-/**
- * Initialize Playwright in a project
- */
 export async function initPlaywright(projectPath) {
-    // Check if already set up
     const status = await checkPlaywrightSetup(projectPath);
     if (status.installed && status.configExists && status.browsersInstalled) {
         return { success: true, message: 'Playwright is already set up' };
     }
     const steps = [];
-    // Install @playwright/test if not present
     if (!status.installed) {
         const installResult = await runCommand('npm', ['install', '-D', '@playwright/test'], projectPath);
         if (installResult.exitCode !== 0) {
@@ -99,14 +69,11 @@ export async function initPlaywright(projectPath) {
         }
         steps.push('Installed @playwright/test');
     }
-    // Initialize config if not present
     if (!status.configExists) {
-        // Create a minimal configuration
         const config = generatePlaywrightConfig(projectPath);
         await fs.writeFile(path.join(projectPath, 'playwright.config.ts'), config);
         steps.push('Created playwright.config.ts');
     }
-    // Install browsers
     if (!status.browsersInstalled) {
         const installResult = await runCommand('npx', ['playwright', 'install', '--with-deps', 'chromium'], projectPath);
         if (installResult.exitCode !== 0) {
@@ -114,7 +81,6 @@ export async function initPlaywright(projectPath) {
         }
         steps.push('Installed Chromium browser');
     }
-    // Create example test directory if it doesn't exist
     const testDir = path.join(projectPath, 'e2e');
     try {
         await fs.access(testDir);
@@ -129,16 +95,9 @@ export async function initPlaywright(projectPath) {
         message: `Playwright setup complete:\n${steps.map(s => `  ✓ ${s}`).join('\n')}`,
     };
 }
-// ============================================================================
-// Test Execution
-// ============================================================================
-/**
- * Run Playwright E2E tests
- */
 export async function runPlaywrightTests(config) {
     const { projectPath, headed, testMatch, browsers, timeout, retries, outputDir } = config;
     const args = ['playwright', 'test'];
-    // Add options
     if (headed) {
         args.push('--headed');
     }
@@ -157,17 +116,12 @@ export async function runPlaywrightTests(config) {
     if (outputDir) {
         args.push('--output', outputDir);
     }
-    // JSON reporter for structured output
     args.push('--reporter', 'json');
     const startTime = Date.now();
     const result = await runCommand('npx', args, projectPath);
     const duration = Date.now() - startTime;
-    // Parse JSON output
     return parsePlaywrightOutput(result.stdout, result.stderr, duration, projectPath);
 }
-/**
- * Run specific test file
- */
 export async function runPlaywrightTestFile(projectPath, testFile, options) {
     return runPlaywrightTests({
         projectPath,
@@ -175,9 +129,6 @@ export async function runPlaywrightTestFile(projectPath, testFile, options) {
         ...options,
     });
 }
-/**
- * Run tests with visual comparison
- */
 export async function runVisualRegressionTests(projectPath, options) {
     const result = await runPlaywrightTests({
         projectPath,
@@ -187,16 +138,8 @@ export async function runVisualRegressionTests(projectPath, options) {
     });
     return result;
 }
-// ============================================================================
-// Screenshot & Trace
-// ============================================================================
-/**
- * Capture a screenshot of the current page state
- */
 export async function capturePageScreenshot(projectPath, url, outputPath) {
-    // Generate inline script to capture screenshot
     const screenshotPath = outputPath || path.join(projectPath, '.weave', 'screenshots', `capture-${Date.now()}.png`);
-    // Ensure directory exists
     await fs.mkdir(path.dirname(screenshotPath), { recursive: true });
     const script = `
 const { chromium } = require('playwright');
@@ -213,19 +156,15 @@ const { chromium } = require('playwright');
     await fs.mkdir(path.dirname(scriptPath), { recursive: true });
     await fs.writeFile(scriptPath, script);
     const result = await runCommand('node', [scriptPath], projectPath);
-    // Cleanup temp script
     try {
         await fs.unlink(scriptPath);
     }
-    catch { /* ignore */ }
+    catch { }
     if (result.exitCode !== 0) {
         throw new Error(`Screenshot capture failed: ${result.stderr}`);
     }
     return screenshotPath;
 }
-/**
- * Get list of screenshots from a test run
- */
 export async function getTestScreenshots(projectPath) {
     const screenshotDirs = [
         path.join(projectPath, 'test-results'),
@@ -238,14 +177,10 @@ export async function getTestScreenshots(projectPath) {
             await collectScreenshots(dir, screenshots);
         }
         catch {
-            // Directory not found or other error
         }
     }
     return screenshots;
 }
-/**
- * Recursively collect screenshot files from a directory
- */
 async function collectScreenshots(dir, screenshots) {
     const entries = await fs.readdir(dir, { withFileTypes: true });
     for (const entry of entries) {
@@ -260,9 +195,6 @@ async function collectScreenshots(dir, screenshots) {
         }
     }
 }
-// ============================================================================
-// Output Parsing
-// ============================================================================
 function parsePlaywrightOutput(stdout, stderr, duration, projectPath) {
     const result = {
         passed: true,
@@ -276,9 +208,7 @@ function parsePlaywrightOutput(stdout, stderr, duration, projectPath) {
         traces: [],
         rawOutput: stdout + '\n' + stderr,
     };
-    // Try to parse JSON output
     try {
-        // Find JSON in output (might be mixed with other output)
         const jsonMatch = stdout.match(/\{[\s\S]*"suites"[\s\S]*\}/);
         if (jsonMatch) {
             const json = JSON.parse(jsonMatch[0]);
@@ -287,16 +217,13 @@ function parsePlaywrightOutput(stdout, stderr, duration, projectPath) {
             result.failedTests = json.stats?.unexpected || 0;
             result.skippedTests = json.stats?.skipped || 0;
             result.passed = result.failedTests === 0;
-            // Extract failures
             if (json.suites) {
                 extractFailures(json.suites, result.failures);
             }
         }
     }
     catch {
-        // Fallback: parse text output
         result.passed = !stderr.includes('failed') && !stdout.includes('failed');
-        // Try to extract test counts from text
         const passedMatch = stdout.match(/(\d+) passed/);
         const failedMatch = stdout.match(/(\d+) failed/);
         const skippedMatch = stdout.match(/(\d+) skipped/);
@@ -307,7 +234,6 @@ function parsePlaywrightOutput(stdout, stderr, duration, projectPath) {
         if (skippedMatch)
             result.skippedTests = parseInt(skippedMatch[1], 10);
         result.totalTests = result.passedTests + result.failedTests + result.skippedTests;
-        // Extract failure details from stderr
         if (!result.passed) {
             const errorLines = stderr.split('\n').filter(line => line.includes('Error') || line.includes('expect') || line.includes('Timeout'));
             if (errorLines.length > 0) {
@@ -347,9 +273,6 @@ function extractFailures(suites, failures) {
         }
     }
 }
-/**
- * Analyze Playwright error for knowledge base indexing
- */
 export function analyzePlaywrightError(failure) {
     const error = failure.error.toLowerCase();
     const analysis = {
@@ -357,7 +280,6 @@ export function analyzePlaywrightError(failure) {
         errorSignature: '',
         suggestedFix: '',
     };
-    // Timeout errors
     if (error.includes('timeout') || error.includes('exceeded')) {
         analysis.errorType = 'timeout';
         const selectorMatch = failure.error.match(/locator\(['"]([^'"]+)['"]\)/);
@@ -370,7 +292,6 @@ export function analyzePlaywrightError(failure) {
         }
         analysis.errorSignature = `playwright:timeout:${analysis.selector || 'page'}`;
     }
-    // Assertion errors
     else if (error.includes('expect') || error.includes('assertion')) {
         analysis.errorType = 'assertion';
         analysis.expectedValue = failure.expected;
@@ -378,7 +299,6 @@ export function analyzePlaywrightError(failure) {
         analysis.suggestedFix = `Expected "${analysis.expectedValue}" but got "${analysis.actualValue}". Verify the application state or update the test.`;
         analysis.errorSignature = `playwright:assertion:${failure.testName}`;
     }
-    // Element not found
     else if (error.includes('element') || error.includes('locator') || error.includes('selector')) {
         analysis.errorType = 'element';
         const selectorMatch = failure.error.match(/['"]([^'"]+)['"]/);
@@ -388,13 +308,11 @@ export function analyzePlaywrightError(failure) {
         analysis.suggestedFix = 'Element not found. Check if the selector is correct and the element exists in the DOM.';
         analysis.errorSignature = `playwright:element:${analysis.selector || 'unknown'}`;
     }
-    // Network errors
     else if (error.includes('net::') || error.includes('network') || error.includes('fetch')) {
         analysis.errorType = 'network';
         analysis.suggestedFix = 'Network request failed. Check if the server is running and accessible.';
         analysis.errorSignature = 'playwright:network:failed';
     }
-    // Navigation errors
     else if (error.includes('navigation') || error.includes('goto')) {
         analysis.errorType = 'navigation';
         const urlMatch = failure.error.match(/https?:\/\/[^\s'"]+/);
@@ -404,7 +322,6 @@ export function analyzePlaywrightError(failure) {
         analysis.suggestedFix = `Navigation to "${analysis.url}" failed. Check if the URL is correct and the server is running.`;
         analysis.errorSignature = `playwright:navigation:${analysis.url || 'unknown'}`;
     }
-    // Script errors
     else if (error.includes('script') || error.includes('evaluate')) {
         analysis.errorType = 'script';
         analysis.suggestedFix = 'JavaScript error in the page. Check browser console for details.';
@@ -416,9 +333,6 @@ export function analyzePlaywrightError(failure) {
     }
     return analysis;
 }
-// ============================================================================
-// Config Generation
-// ============================================================================
 function generatePlaywrightConfig(projectPath) {
     return `import { defineConfig, devices } from '@playwright/test';
 
@@ -574,7 +488,4 @@ async function runCommand(command, args, cwd) {
         });
     });
 }
-// ============================================================================
-// Exports
-// ============================================================================
 export { generatePlaywrightConfig, generateExampleTest, };

package/dist/weave/worktree.d.ts

@@ -1,30 +1,14 @@
-/**
- * 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 { type WorktreeInfo } from '../shared-context/worktree.js';
 export interface WeaveWorktreeCreateOptions {
-    /** Current worktree path (where command is invoked). */
     basePath: string;
-    /** Feature/worktree name (kebab-case recommended). */
     name: string;
-    /** Base ref to branch from. Defaults to HEAD of basePath worktree. */
     fromRef?: string;
-    /** Whether to copy weave artifacts from basePath into new worktree. */
     bootstrapWeave?: boolean;
-    /** Whether to copy .gdc/config + node specs into the worktree. */
     bootstrapGdc?: boolean;
 }
 export interface WeaveWorktreeRemoveOptions {
     basePath: string;
     name: string;
-    /** Also delete the worktree branch (default: false). */
     deleteBranch?: boolean;
 }
 export interface WeaveWorktreeListOptions {