maskweaver 0.9.3 → 0.9.5

package/dist/weave/environment/issues.js

@@ -1,13 +1,4 @@
-/**
- * Potential Issues Collector
- *
- * Combines hardcoded known issues with project history from Global Knowledge.
- * Provides proactive warnings based on environment + stack combinations.
- */
 const KNOWN_ISSUES = [
-    // =========================================================================
-    // Windows-Specific Issues
-    // =========================================================================
     {
         id: 'WIN-BUN-SYMLINK',
         category: 'environment',
@@ -72,9 +63,6 @@ const KNOWN_ISSUES = [
             packageManager: ['pnpm', 'bun'],
         },
     },
-    // =========================================================================
-    // macOS-Specific Issues
-    // =========================================================================
     {
         id: 'MAC-M1-NODEGYP',
         category: 'environment',
@@ -99,9 +87,6 @@ const KNOWN_ISSUES = [
             os: ['macos'],
         },
     },
-    // =========================================================================
-    // Framework Version Issues
-    // =========================================================================
     {
         id: 'PRISMA-7-MIGRATION',
         category: 'version',
@@ -174,9 +159,6 @@ const KNOWN_ISSUES = [
             stack: ['TypeScript'],
         },
     },
-    // =========================================================================
-    // Shell-Specific Issues
-    // =========================================================================
     {
         id: 'SHELL-ENV-QUOTES',
         category: 'shell',
@@ -200,29 +182,21 @@ const KNOWN_ISSUES = [
         },
     },
 ];
-// ============================================================================
-// Issue Matching Logic
-// ============================================================================
 function matchesConditions(context, conditions) {
-    // OS check
     if (conditions.os && !conditions.os.includes(context.os)) {
         return false;
     }
-    // Shell check
     if (conditions.shell && !conditions.shell.includes(context.shell)) {
         return false;
     }
-    // Package manager check
     if (conditions.packageManager && !conditions.packageManager.includes(context.packageManager)) {
         return false;
     }
-    // Stack check (ANY match)
     if (conditions.stack) {
         const hasAny = conditions.stack.some(s => context.stack.some(cs => cs.toLowerCase().includes(s.toLowerCase())));
         if (!hasAny)
             return false;
     }
-    // Stack exact check (ALL match)
     if (conditions.stackExact) {
         const hasAll = conditions.stackExact.every(s => context.stack.some(cs => cs.toLowerCase().includes(s.toLowerCase())));
         if (!hasAll)
@@ -233,7 +207,6 @@ function matchesConditions(context, conditions) {
 export async function collectPotentialIssues(context, options = {}) {
     const { includeProjectHistory = true, historyLimit = 5 } = options;
     const issues = [];
-    // 1. Collect matching built-in issues
     for (const known of KNOWN_ISSUES) {
         if (matchesConditions(context, known.conditions)) {
             issues.push({
@@ -248,31 +221,23 @@ export async function collectPotentialIssues(context, options = {}) {
             });
         }
     }
-    // 2. Search project history from Global Knowledge (optional)
     if (includeProjectHistory) {
         try {
             const historyIssues = await searchProjectHistory(context, historyLimit);
             issues.push(...historyIssues);
         }
         catch (e) {
-            // Project history is optional, don't fail
             console.log('[Issues] Project history search failed:', e);
         }
     }
-    // Sort by severity (critical > warning > info)
     const severityOrder = { critical: 0, warning: 1, info: 2 };
     issues.sort((a, b) => severityOrder[a.severity] - severityOrder[b.severity]);
     return issues;
 }
-// ============================================================================
-// Project History Search (Global Knowledge Integration)
-// ============================================================================
 async function searchProjectHistory(context, limit) {
     const issues = [];
     try {
-        // Dynamic import to avoid circular dependencies
         const { searchTroubleshooting } = await import('../knowledge/global.js');
-        // Build search query from context
         const queryParts = [
             context.os,
             context.shell,
@@ -280,11 +245,9 @@ async function searchProjectHistory(context, limit) {
             ...context.stack.slice(0, 5),
         ].filter(Boolean);
         const query = queryParts.join(' ');
-        // Search Global Knowledge
         const results = await searchTroubleshooting(query, { limit });
         for (const result of results) {
             const entry = result.entry;
-            // Convert troubleshooting entry to potential issue
             issues.push({
                 id: `HISTORY-${entry.id}`,
                 category: 'compatibility',
@@ -298,13 +261,9 @@ async function searchProjectHistory(context, limit) {
         }
     }
     catch (e) {
-        // Global Knowledge might not be available
     }
     return issues;
 }
-// ============================================================================
-// Utility: Get Issues by Category
-// ============================================================================
 export function filterIssuesByCategory(issues, category) {
     return issues.filter(i => i.category === category);
 }
@@ -313,16 +272,11 @@ export function filterIssuesBySeverity(issues, minSeverity) {
     const minOrder = severityOrder[minSeverity];
     return issues.filter(i => severityOrder[i.severity] <= minOrder);
 }
-/**
- * Search for issues relevant to a specific phase.
- * Combines phase metadata with environment context for targeted search.
- */
 export async function searchPhaseIssues(phaseContext, environmentContext, options = {}) {
     const { limit = 5 } = options;
     const results = [];
     try {
         const { searchTroubleshooting } = await import('../knowledge/global.js');
-        // Build query from phase context
         const queryParts = [
             phaseContext.phaseName,
             ...(phaseContext.tasks || []),
@@ -333,7 +287,6 @@ export async function searchPhaseIssues(phaseContext, environmentContext, option
         const searchResults = await searchTroubleshooting(query, { limit });
         for (const result of searchResults) {
             const entry = result.entry;
-            // Calculate relevance based on phase name match
             let relevance = result.score;
             const phaseNameLower = phaseContext.phaseName.toLowerCase();
             if (entry.context.toLowerCase().includes(phaseNameLower)) {
@@ -359,20 +312,14 @@ export async function searchPhaseIssues(phaseContext, environmentContext, option
     catch (e) {
         console.log('[Issues] Phase search failed:', e);
     }
-    // Sort by relevance
     results.sort((a, b) => b.relevance - a.relevance);
     return results.slice(0, limit);
 }
-/**
- * Search for issues relevant to a specific feature request.
- * Useful when implementing new features to find similar past problems.
- */
 export async function searchFeatureIssues(featureContext, environmentContext, options = {}) {
     const { limit = 5 } = options;
     const results = [];
     try {
         const { searchTroubleshooting } = await import('../knowledge/global.js');
-        // Build query from feature context
         const queryParts = [
             featureContext.featureName,
             ...(featureContext.keywords || []),
@@ -382,7 +329,6 @@ export async function searchFeatureIssues(featureContext, environmentContext, op
         const searchResults = await searchTroubleshooting(query, { limit });
         for (const result of searchResults) {
             const entry = result.entry;
-            // Calculate relevance based on feature keyword match
             let relevance = result.score;
             const featureWords = featureContext.featureName.toLowerCase().split(/\s+/);
             for (const word of featureWords) {
@@ -390,7 +336,6 @@ export async function searchFeatureIssues(featureContext, environmentContext, op
                     relevance = Math.min(1, relevance + 0.05);
                 }
             }
-            // Boost if tech stack matches
             if (featureContext.relatedStack && entry.techStack) {
                 const stackMatch = featureContext.relatedStack.some(s => entry.techStack.some(es => es.toLowerCase().includes(s.toLowerCase())));
                 if (stackMatch) {
@@ -414,13 +359,9 @@ export async function searchFeatureIssues(featureContext, environmentContext, op
     catch (e) {
         console.log('[Issues] Feature search failed:', e);
     }
-    // Sort by relevance
     results.sort((a, b) => b.relevance - a.relevance);
     return results.slice(0, limit);
 }
-/**
- * Quick helper to format context search results as markdown.
- */
 export function formatContextResults(results, title = '관련 이슈') {
     if (results.length === 0) {
         return `### ✅ ${title}\n기록된 관련 이슈가 없습니다.\n`;

package/dist/weave/git.d.ts

@@ -1,11 +1,3 @@
-/**
- * Git Utilities (Weave)
- *
- * Weave needs a small, safe subset of git operations for:
- * - staging files (optional)
- * - listing staged files
- * - creating commits (optional)
- */
 export interface GitCommandResult {
     stdout: string;
     stderr: string;

package/dist/weave/git.js

@@ -1,11 +1,3 @@
-/**
- * Git Utilities (Weave)
- *
- * Weave needs a small, safe subset of git operations for:
- * - staging files (optional)
- * - listing staged files
- * - creating commits (optional)
- */
 import { execFile } from 'node:child_process';
 import { promisify } from 'node:util';
 const execFileAsync = promisify(execFile);

package/dist/weave/index.d.ts

@@ -1,16 +1,3 @@
-/**
- * @maskweaver/weave
- *
- * Phase-Driven Development Workflow
- * "AI가 검증하고, 유저가 확인한다"
- *
- * Integrates with all Maskweaver modules:
- * - core: Expert mask auto-selection per task
- * - memory: Cross-project knowledge sharing (troubleshooting, patterns)
- * - context: Phase-based file tracking
- * - verify: Self-verification loop with 3-tier escalation
- * - retrospect: Phase completion analysis
- */
 export type { WeavePhase, WeavePlan, WeaveTask, WeaveStatus, WeaveConfig, TroubleshootingEntry, EnvironmentContext, EnvironmentAnalysis, PotentialIssue, } from './types.js';
 export { createWeaveWorktree, listWeaveWorktrees, resolveWeaveWorktree, removeWeaveWorktree, bootstrapWeaveArtifacts, } from './worktree.js';
 export { intake } from './stages/intake.js';

package/dist/weave/index.js

@@ -1,19 +1,4 @@
-/**
- * @maskweaver/weave
- *
- * Phase-Driven Development Workflow
- * "AI가 검증하고, 유저가 확인한다"
- *
- * Integrates with all Maskweaver modules:
- * - core: Expert mask auto-selection per task
- * - memory: Cross-project knowledge sharing (troubleshooting, patterns)
- * - context: Phase-based file tracking
- * - verify: Self-verification loop with 3-tier escalation
- * - retrospect: Phase completion analysis
- */
-// Worktree utilities (parallel development)
 export { createWeaveWorktree, listWeaveWorktrees, resolveWeaveWorktree, removeWeaveWorktree, bootstrapWeaveArtifacts, } from './worktree.js';
-// Core workflow stages
 export { intake } from './stages/intake.js';
 export { buildResearchReport, writeResearchReport } from './stages/research.js';
 export { refinePlanFromNotes } from './stages/refine.js';
@@ -21,22 +6,11 @@ export { spec } from './stages/spec.js';
 export { plan } from './stages/plan.js';
 export { execute } from './stages/execute.js';
 export { handoff } from './stages/handoff.js';
-// Orchestrator (mask auto-selection)
 export { WeaveOrchestrator } from './orchestrator.js';
-// Global Knowledge Base (cross-project RAG)
 export { GlobalKnowledge, recordTroubleshooting, searchTroubleshooting, getGlobalDbPath, } from './knowledge/global.js';
-// Environment Analysis (Proactive Knowledge)
-export { analyzeEnvironment, detectEnvironment, collectPotentialIssues, filterIssuesBySeverity, filterIssuesByCategory, hasCriticalIssues, getEnvironmentOneLiner, 
-// Phase/Feature context search
-searchPhaseIssues, searchFeatureIssues, formatContextResults, } from './environment/index.js';
-// Phase management
+export { analyzeEnvironment, detectEnvironment, collectPotentialIssues, filterIssuesBySeverity, filterIssuesByCategory, hasCriticalIssues, getEnvironmentOneLiner, searchPhaseIssues, searchFeatureIssues, formatContextResults, } from './environment/index.js';
 export { PhaseManager, createPhase, getPhase, updatePhaseStatus, listPhases, } from './phase-manager.js';
-// Git + Security
 export { execGit, ensureGitRepo, stageAllChanges, listStagedFiles, hasStagedChanges, commitStagedChanges, } from './git.js';
 export { scanFilesForSecrets, loadSecretScanConfig, shouldBlockOnFindings, formatSecretScanReport, } from './security/secret-scan.js';
-// YAML Repair
 export { yamlEscapeString, repairYamlContent, safeWriteFile, safeReadYaml, repairPlanFile, repairAllPlans, validatePlanStructure, } from './yaml-repair.js';
-// Verification System (Playwright, Visual, API)
-export { 
-// Playwright E2E Testing
-checkPlaywrightSetup, initPlaywright, runPlaywrightTests, runPlaywrightTestFile, runVisualRegressionTests, capturePageScreenshot, getTestScreenshots, analyzePlaywrightError, generatePlaywrightConfig, generateExampleTest, } from './verification/index.js';
+export { checkPlaywrightSetup, initPlaywright, runPlaywrightTests, runPlaywrightTestFile, runVisualRegressionTests, capturePageScreenshot, getTestScreenshots, analyzePlaywrightError, generatePlaywrightConfig, generateExampleTest, } from './verification/index.js';

package/dist/weave/knowledge/global.d.ts

@@ -1,18 +1,5 @@
-/**
- * Global Knowledge Base
- *
- * Cross-project RAG system for sharing troubleshooting knowledge.
- * This is the KEY differentiator - lessons learned in one project
- * benefit all future projects.
- *
- * Storage: ~/.maskweaver/knowledge.sqlite (global, not per-project)
- */
 import type { TroubleshootingEntry, KnowledgeSearchResult } from '../types.js';
 export declare function getGlobalDbPath(): string;
-/**
- * Normalize error messages to create searchable signatures.
- * Strips out project-specific paths, line numbers, etc.
- */
 export declare function normalizeErrorSignature(error: string): string;
 export declare class GlobalKnowledge {
     private db;
@@ -21,34 +8,16 @@ export declare class GlobalKnowledge {
     private sqlJsDb;
     private ftsAvailable;
     init(): Promise<void>;
-    /**
-     * Create a wrapper that mimics better-sqlite3 API using sql.js
-     */
     private createSqlJsWrapper;
     private createTables;
-    /**
-     * Record a troubleshooting experience for future reference.
-     */
     record(entry: Omit<TroubleshootingEntry, 'id' | 'errorSignature' | 'createdAt' | 'usedCount'>): Promise<number>;
-    /**
-     * Search for solutions to a similar error.
-     */
     search(errorMessage: string, options?: {
         projectType?: string;
         limit?: number;
         minEffectiveness?: number;
     }): Promise<KnowledgeSearchResult[]>;
-    /**
-     * Mark a solution as used (increases its ranking).
-     */
     markUsed(id: number): Promise<void>;
-    /**
-     * Update effectiveness rating after user feedback.
-     */
     updateEffectiveness(id: number, effectiveness: number): Promise<void>;
-    /**
-     * Get statistics about the knowledge base.
-     */
     getStats(): Promise<{
         totalEntries: number;
         topProjectTypes: {
@@ -63,15 +32,7 @@ export declare class GlobalKnowledge {
     }>;
     private rowToEntry;
 }
-/**
- * Record a troubleshooting experience.
- * Call this when an error is successfully resolved.
- */
 export declare function recordTroubleshooting(entry: Omit<TroubleshootingEntry, 'id' | 'errorSignature' | 'createdAt' | 'usedCount'>): Promise<number>;
-/**
- * Search for solutions to a similar error.
- * Call this when encountering an error during execution.
- */
 export declare function searchTroubleshooting(errorMessage: string, options?: {
     projectType?: string;
     limit?: number;

package/dist/weave/knowledge/global.js

@@ -1,18 +1,6 @@
-/**
- * Global Knowledge Base
- *
- * Cross-project RAG system for sharing troubleshooting knowledge.
- * This is the KEY differentiator - lessons learned in one project
- * benefit all future projects.
- *
- * Storage: ~/.maskweaver/knowledge.sqlite (global, not per-project)
- */
 import * as fs from 'node:fs';
 import * as path from 'node:path';
 import * as os from 'node:os';
-// ============================================================================
-// Configuration
-// ============================================================================
 const GLOBAL_DIR = path.join(os.homedir(), '.maskweaver');
 const GLOBAL_DB_FILE = 'knowledge.sqlite';
 export function getGlobalDbPath() {
@@ -23,32 +11,18 @@ function ensureGlobalDir() {
         fs.mkdirSync(GLOBAL_DIR, { recursive: true });
     }
 }
-// ============================================================================
-// Error Signature Normalization
-// ============================================================================
-/**
- * Normalize error messages to create searchable signatures.
- * Strips out project-specific paths, line numbers, etc.
- */
 export function normalizeErrorSignature(error) {
     return error
-        // Remove file paths
         .replace(/[A-Za-z]:\\[^\s:]+/g, '<PATH>')
         .replace(/\/[^\s:]+/g, '<PATH>')
-        // Remove line/column numbers
         .replace(/:\d+:\d+/g, '')
         .replace(/line \d+/gi, 'line <N>')
         .replace(/column \d+/gi, 'column <N>')
-        // Remove specific variable/function names that look generated
         .replace(/_[a-f0-9]{8,}/g, '_<HASH>')
-        // Normalize whitespace
         .replace(/\s+/g, ' ')
         .trim()
         .toLowerCase();
 }
-// ============================================================================
-// Global Knowledge Class
-// ============================================================================
 export class GlobalKnowledge {
     db = null;
     initialized = false;
@@ -59,7 +33,6 @@ export class GlobalKnowledge {
         if (this.initialized)
             return;
         ensureGlobalDir();
-        // Try better-sqlite3 first (fastest, native)
         try {
             const Database = await import('better-sqlite3').then(m => m.default);
             this.db = new Database(getGlobalDbPath());
@@ -68,14 +41,10 @@ export class GlobalKnowledge {
             return;
         }
         catch {
-            // better-sqlite3 not available, try sql.js
         }
-        // Fallback to sql.js (works everywhere, WASM-based)
         try {
-            // @ts-ignore - sql.js doesn't have TypeScript types
             const initSqlJs = await import('sql.js').then(m => m.default);
             const SQL = await initSqlJs();
-            // Try to load existing database file
             const dbPath = getGlobalDbPath();
             let data;
             try {
@@ -85,7 +54,6 @@ export class GlobalKnowledge {
                 }
             }
             catch {
-                // File doesn't exist or can't be read
             }
             this.sqlJsDb = data ? new SQL.Database(data) : new SQL.Database();
             this.db = this.createSqlJsWrapper(this.sqlJsDb, dbPath);
@@ -95,16 +63,11 @@ export class GlobalKnowledge {
             return;
         }
         catch {
-            // sql.js also not available
         }
-        // Final fallback: in-memory only (no persistence)
         console.warn('[GlobalKnowledge] No SQLite driver available. Knowledge will not persist between sessions.');
         this.db = null;
         this.initialized = true;
     }
-    /**
-     * Create a wrapper that mimics better-sqlite3 API using sql.js
-     */
     createSqlJsWrapper(sqlJsDb, dbPath) {
         const saveToFile = () => {
             try {
@@ -113,7 +76,6 @@ export class GlobalKnowledge {
                 fs.writeFileSync(dbPath, Buffer.from(data));
             }
             catch {
-                // Ignore save errors
             }
         };
         return {
@@ -125,7 +87,6 @@ export class GlobalKnowledge {
                 return {
                     run: (...params) => {
                         try {
-                            // Flatten params if first element is array
                             const flatParams = params.length === 1 && Array.isArray(params[0])
                                 ? params[0]
                                 : params;
@@ -141,7 +102,6 @@ export class GlobalKnowledge {
                     get: (...params) => {
                         try {
                             const stmt = sqlJsDb.prepare(sql);
-                            // Flatten params if first element is array
                             const flatParams = params.length === 1 && Array.isArray(params[0])
                                 ? params[0]
                                 : params;
@@ -165,7 +125,6 @@ export class GlobalKnowledge {
                         try {
                             const results = [];
                             const stmt = sqlJsDb.prepare(sql);
-                            // Flatten params if first element is array
                             const flatParams = params.length === 1 && Array.isArray(params[0])
                                 ? params[0]
                                 : params;
@@ -194,7 +153,6 @@ export class GlobalKnowledge {
     createTables() {
         if (!this.db)
             return;
-        // Core table and indexes — always works
         this.db.exec(`
       CREATE TABLE IF NOT EXISTS troubleshooting (
         id INTEGER PRIMARY KEY AUTOINCREMENT,
@@ -217,9 +175,6 @@ export class GlobalKnowledge {
       CREATE INDEX IF NOT EXISTS idx_project_type 
         ON troubleshooting(project_type);
     `);
-        // FTS5 virtual table and sync triggers — requires FTS5 extension
-        // (available in better-sqlite3 but NOT in default sql.js WASM builds)
-        // Skip FTS5 entirely for sql.js to avoid WASM-level warnings
         if (this.usingSqlJs) {
             this.ftsAvailable = false;
         }
@@ -256,14 +211,10 @@ export class GlobalKnowledge {
                 this.ftsAvailable = true;
             }
             catch {
-                // FTS5 not available — search falls back to exact matches only
                 this.ftsAvailable = false;
             }
         }
     }
-    /**
-     * Record a troubleshooting experience for future reference.
-     */
     async record(entry) {
         await this.init();
         if (!this.db) {
@@ -282,9 +233,6 @@ export class GlobalKnowledge {
         const result = stmt.run(signature, entry.errorMessage, entry.context, entry.solution, entry.projectType || null, entry.techStack ? JSON.stringify(entry.techStack) : null, entry.tags ? JSON.stringify(entry.tags) : null, entry.effectiveness || 5, now);
         return result.lastInsertRowid;
     }
-    /**
-     * Search for solutions to a similar error.
-     */
     async search(errorMessage, options = {}) {
         await this.init();
         if (!this.db)
@@ -292,7 +240,6 @@ export class GlobalKnowledge {
         const { projectType, limit = 5, minEffectiveness = 3 } = options;
         const signature = normalizeErrorSignature(errorMessage);
         const results = [];
-        // 1. Exact signature match (highest priority)
         const exactStmt = this.db.prepare(`
       SELECT * FROM troubleshooting 
       WHERE error_signature = ? 
@@ -308,11 +255,9 @@ export class GlobalKnowledge {
                 matchType: 'exact',
             });
         }
-        // 2. FTS search for similar errors (if not enough exact matches)
         if (this.ftsAvailable && results.length < limit) {
             const remaining = limit - results.length;
             const existingIds = results.map(r => r.entry.id);
-            // Extract key terms from error
             const searchTerms = errorMessage
                 .replace(/[^\w\s]/g, ' ')
                 .split(/\s+/)
@@ -339,21 +284,17 @@ export class GlobalKnowledge {
                     for (const row of ftsMatches) {
                         results.push({
                             entry: this.rowToEntry(row),
-                            score: Math.min(0.9, 1 / (1 - row.rank)), // BM25 score normalization
+                            score: Math.min(0.9, 1 / (1 - row.rank)),
                             matchType: 'similar',
                         });
                     }
                 }
                 catch (e) {
-                    // FTS query might fail with special characters
                 }
             }
         }
         return results;
     }
-    /**
-     * Mark a solution as used (increases its ranking).
-     */
     async markUsed(id) {
         await this.init();
         if (!this.db)
@@ -366,9 +307,6 @@ export class GlobalKnowledge {
     `);
         stmt.run(new Date().toISOString(), id);
     }
-    /**
-     * Update effectiveness rating after user feedback.
-     */
     async updateEffectiveness(id, effectiveness) {
         await this.init();
         if (!this.db)
@@ -380,9 +318,6 @@ export class GlobalKnowledge {
     `);
         stmt.run(Math.max(1, Math.min(10, effectiveness)), id);
     }
-    /**
-     * Get statistics about the knowledge base.
-     */
     async getStats() {
         await this.init();
         if (!this.db) {
@@ -409,7 +344,7 @@ export class GlobalKnowledge {
         return {
             totalEntries: total.count,
             topProjectTypes: projectTypes,
-            topTags: [], // TODO: Parse JSON tags and aggregate
+            topTags: [],
             averageEffectiveness: avg.avg || 0,
         };
     }
@@ -430,9 +365,6 @@ export class GlobalKnowledge {
         };
     }
 }
-// ============================================================================
-// Convenience Functions
-// ============================================================================
 let globalInstance = null;
 async function getGlobalKnowledge() {
     if (!globalInstance) {
@@ -441,18 +373,10 @@ async function getGlobalKnowledge() {
     }
     return globalInstance;
 }
-/**
- * Record a troubleshooting experience.
- * Call this when an error is successfully resolved.
- */
 export async function recordTroubleshooting(entry) {
     const knowledge = await getGlobalKnowledge();
     return knowledge.record(entry);
 }
-/**
- * Search for solutions to a similar error.
- * Call this when encountering an error during execution.
- */
 export async function searchTroubleshooting(errorMessage, options) {
     const knowledge = await getGlobalKnowledge();
     return knowledge.search(errorMessage, options);

package/dist/weave/loop.js

@@ -247,7 +247,6 @@ export async function acquireLoopOperatorLock(input) {
             }
         }
         catch {
-            // Overwrite unreadable or partial lock files.
         }
     }
     await writeFile(lockPath, `${JSON.stringify({
@@ -277,7 +276,6 @@ export async function refreshLoopOperatorLock(input) {
         }, null, 2)}\n`, 'utf-8');
     }
     catch {
-        // Ignore broken lock refresh attempts.
     }
 }
 export async function releaseLoopOperatorLock(input) {
@@ -294,7 +292,6 @@ export async function releaseLoopOperatorLock(input) {
         await rm(lockPath, { force: true });
     }
     catch {
-        // Best-effort cleanup only.
     }
 }
 export async function requestLoopStop(input) {