maskweaver 0.9.4 → 0.9.6

package/dist/plugin/config/index.js

@@ -1,13 +1,3 @@
-/**
- * Maskweaver Plugin Configuration Loader
- *
- * Loads maskweaver.json(c) configuration files with support for:
- * - Project-level configuration (.opencode/maskweaver.json)
- * - Global configuration (~/.config/opencode/maskweaver.json)
- * - JSONC format (comments, trailing commas)
- *
- * Based on oh-my-opencode pattern for plugin configuration management.
- */
 import { parse as parseJsonc } from 'jsonc-parser';
 import * as fs from 'node:fs';
 import * as path from 'node:path';
@@ -21,51 +11,23 @@ function pluginLog(ctx, level, message) {
         },
     });
 }
-// ============================================================================
-// Configuration Loader
-// ============================================================================
-/**
- * Get all possible configuration file locations in priority order
- *
- * Priority:
- * 1. .opencode/maskweaver.json (project)
- * 2. .opencode/maskweaver.jsonc (project)
- * 3. ~/.config/opencode/maskweaver.json (global)
- * 4. ~/.config/opencode/maskweaver.jsonc (global)
- */
 function getConfigLocations(directory) {
     const homeDir = os.homedir();
     return [
-        // Project-level configurations (highest priority)
         path.join(directory, '.opencode', 'maskweaver.json'),
         path.join(directory, '.opencode', 'maskweaver.jsonc'),
-        // Global configurations
         path.join(homeDir, '.config', 'opencode', 'maskweaver.json'),
         path.join(homeDir, '.config', 'opencode', 'maskweaver.jsonc'),
     ];
 }
-/**
- * Parse JSONC content (JSON with comments and trailing commas)
- */
 function parseJsoncContent(content) {
     try {
-        // Use jsonc-parser for robust JSONC parsing
         return parseJsonc(content);
     }
     catch (error) {
         throw new Error(`Failed to parse JSONC: ${error}`);
     }
 }
-/**
- * Load plugin configuration from directory
- *
- * Searches for configuration files in priority order and returns
- * the first found configuration. Returns empty object if no config found.
- *
- * @param directory - Project directory to search for config
- * @param ctx - Optional plugin context (for logging)
- * @returns Parsed configuration object
- */
 export function loadPluginConfig(directory, ctx) {
     const locations = getConfigLocations(directory);
     for (const location of locations) {
@@ -73,133 +35,61 @@ export function loadPluginConfig(directory, ctx) {
             try {
                 const content = fs.readFileSync(location, 'utf-8');
                 const config = parseJsoncContent(content);
-                // Log successful config load
                 if (ctx?.verbose) {
                     pluginLog(ctx, 'info', `Loaded config from: ${location}`);
                 }
                 return config;
             }
             catch (error) {
-                // Log error but continue searching
                 if (ctx) {
                     pluginLog(ctx, 'warn', `Failed to load config from ${location}: ${error}`);
                 }
             }
         }
     }
-    // No configuration found - return empty config
     if (ctx?.verbose) {
         pluginLog(ctx, 'info', 'No maskweaver.json found, using defaults');
     }
     return {};
 }
-// ============================================================================
-// Helper Functions
-// ============================================================================
-/**
- * Check if a tool is enabled in the configuration
- *
- * A tool is considered enabled if:
- * - No disabled_tools list exists, OR
- * - disabled_tools list exists but doesn't include the tool name
- *
- * @param config - Plugin configuration
- * @param toolName - Name of the tool to check
- * @returns true if tool is enabled, false otherwise
- */
 export function isToolEnabled(config, toolName) {
     if (!config.disabled_tools || config.disabled_tools.length === 0) {
         return true;
     }
     return !config.disabled_tools.includes(toolName);
 }
-/**
- * Check if a mask is enabled in the configuration
- *
- * A mask is considered enabled if:
- * - No disabled_masks list exists, OR
- * - disabled_masks list exists but doesn't include the mask ID
- *
- * @param config - Plugin configuration
- * @param maskId - ID of the mask to check
- * @returns true if mask is enabled, false otherwise
- */
 export function isMaskEnabled(config, maskId) {
     if (!config.disabled_masks || config.disabled_masks.length === 0) {
         return true;
     }
     return !config.disabled_masks.includes(maskId);
 }
-/**
- * Get the default mask ID from configuration
- *
- * @param config - Plugin configuration
- * @returns Default mask ID if configured, undefined otherwise
- */
 export function getDefaultMask(config) {
     return config.masks?.default;
 }
-/**
- * Check if auto-activation is enabled for the default mask
- *
- * @param config - Plugin configuration
- * @returns true if auto-activation is enabled, false otherwise
- */
 export function isAutoActivateEnabled(config) {
     return config.masks?.autoActivate ?? false;
 }
-/**
- * Get agent override for a specific agent
- *
- * @param config - Plugin configuration
- * @param agentName - Name of the agent
- * @returns Agent override config if exists, undefined otherwise
- */
 export function getAgentOverride(config, agentName) {
     return config.agents?.[agentName];
 }
-/**
- * Check if verbose logging is enabled
- *
- * @param config - Plugin configuration
- * @returns true if verbose logging is enabled, false otherwise
- */
 export function isVerboseLoggingEnabled(config) {
     return config.logging?.verbose ?? false;
 }
-/**
- * Check if completion sound notification is enabled
- *
- * @param config - Plugin configuration
- * @returns true if completion sound is enabled, false otherwise
- */
 export function isCompletionSoundEnabled(config) {
     return config.notifications?.completionSound?.enabled ?? false;
 }
-// ============================================================================
-// Configuration Validation
-// ============================================================================
-/**
- * Validate configuration structure
- *
- * @param config - Configuration to validate
- * @returns Array of validation error messages (empty if valid)
- */
 export function validateConfig(config) {
     const errors = [];
-    // Validate disabled_masks
     if (config.disabled_masks && !Array.isArray(config.disabled_masks)) {
         errors.push('disabled_masks must be an array of strings');
     }
-    // Validate disabled_tools
     if (config.disabled_tools && !Array.isArray(config.disabled_tools)) {
         errors.push('disabled_tools must be an array of strings');
     }
-    // Validate agents
     if (config.agents && typeof config.agents !== 'object') {
         errors.push('agents must be an object');
     }
-    // Validate masks config
     if (config.masks) {
         if (typeof config.masks !== 'object') {
             errors.push('masks must be an object');
@@ -213,7 +103,6 @@ export function validateConfig(config) {
             }
         }
     }
-    // Validate logging
     if (config.logging) {
         if (typeof config.logging !== 'object') {
             errors.push('logging must be an object');
@@ -224,7 +113,6 @@ export function validateConfig(config) {
             }
         }
     }
-    // Validate notifications
     if (config.notifications) {
         if (typeof config.notifications !== 'object') {
             errors.push('notifications must be an object');
@@ -240,9 +128,6 @@ export function validateConfig(config) {
     }
     return errors;
 }
-// ============================================================================
-// Export default for convenience
-// ============================================================================
 export default {
     loadPluginConfig,
     isToolEnabled,

package/dist/plugin/index.d.ts

@@ -1,16 +1,3 @@
-/**
-* Maskweaver Plugin for opencode
-*
-* Key features:
-* - Configuration-driven tool activation/deactivation
-* - Auto-activation of default masks
-* - Agent configuration overrides
-* - Event-based lifecycle hooks
-* - Memory and context management tools
-* - Clean plugin architecture
-*
-* Based on oh-my-opencode plugin development patterns.
-*/
 import { type Plugin } from '@opencode-ai/plugin';
 export declare const MaskweaverPlugin: Plugin;
 declare const _default: {

package/dist/plugin/index.js

@@ -1,16 +1,3 @@
-/**
-* Maskweaver Plugin for opencode
-*
-* Key features:
-* - Configuration-driven tool activation/deactivation
-* - Auto-activation of default masks
-* - Agent configuration overrides
-* - Event-based lifecycle hooks
-* - Memory and context management tools
-* - Clean plugin architecture
-*
-* Based on oh-my-opencode plugin development patterns.
-*/
 import { z } from 'zod';
 import * as fs from 'node:fs';
 import * as path from 'node:path';
@@ -19,7 +6,6 @@ import { spawnSync } from 'node:child_process';
 import { fileURLToPath } from 'node:url';
 import { VERSION } from '../version.js';
 import { loadPluginConfig, isMaskEnabled, isToolEnabled, getDefaultMask, isAutoActivateEnabled, isVerboseLoggingEnabled, isCompletionSoundEnabled, validateConfig, } from './config/index.js';
-// New tool imports
 import { createMemorySearchTool } from './tools/memorySearch.js';
 import { createMemoryWriteTool } from './tools/memoryWrite.js';
 import { createMemoryGetTool } from './tools/memoryGet.js';
@@ -53,17 +39,14 @@ function getAssetsDir() {
     try {
         const __filename = fileURLToPath(import.meta.url);
         const __dirname = path.dirname(__filename);
-        // 1. If in dist/plugin/ (production) -> ../../assets
         const distAssets = path.join(__dirname, '..', '..', 'assets');
         if (fs.existsSync(distAssets)) {
             return distAssets;
         }
-        // 2. If in src/plugin/ (development) -> ../../assets
         const srcAssets = path.join(__dirname, '..', '..', 'assets');
         if (fs.existsSync(srcAssets)) {
             return srcAssets;
         }
-        // 3. Fallback for npm package structure (node_modules/maskweaver/dist/plugin/index.js)
         return distAssets;
     }
     catch {
@@ -109,7 +92,6 @@ function installAssets(projectDir) {
     const homeDir = os.homedir();
     const globalConfigDir = path.join(homeDir, '.config', 'opencode');
     const projectOpencodeDir = path.join(projectDir, '.opencode');
-    // Install to both global and project directories to ensure visibility
     const targetDirs = [projectOpencodeDir];
     if (fs.existsSync(globalConfigDir)) {
         targetDirs.push(globalConfigDir);
@@ -124,21 +106,17 @@ function installAssets(projectDir) {
                 continue;
             }
         }
-        // Install agents
         const agentsSrc = path.join(assetsDir, 'agents');
         const agentsDest = path.join(targetDir, 'agents');
         copyDirRecursive(agentsSrc, agentsDest, result);
-        // Install masks
         const masksSrc = path.join(assetsDir, 'masks');
         const masksDest = path.join(targetDir, 'masks');
         copyDirRecursive(masksSrc, masksDest, result);
-        // Install commands (always overwrite to keep commands up-to-date)
         const commandsSrc = path.join(assetsDir, 'commands');
         const commandsDest = path.join(targetDir, 'commands');
         if (fs.existsSync(commandsSrc)) {
             copyDirRecursive(commandsSrc, commandsDest, result, true);
         }
-        // Hard-remove deprecated weave commands to keep a craft-centric flow.
         for (const commandFile of REMOVED_WEAVE_COMMAND_FILES) {
             const legacyPath = path.join(commandsDest, commandFile);
             if (!fs.existsSync(legacyPath))
@@ -153,29 +131,11 @@ function installAssets(projectDir) {
     }
     return result;
 }
-// ============================================================================
-// Pool Agent Generator
-// ============================================================================
-/**
- * Generate dummy-human agent .md files from maskweaver.config.json's dummyHumans.pool.
- *
- * For each pool entry with a non-empty model, creates .opencode/agents/dummy-{id}.md.
- * Skips existing files to protect user customizations — use `weave sync-agents`
- * to force overwrite from the config.
- *
- * Also skips entries with empty model names (template placeholders) to prevent
- * generating broken agent files.
- */
 function generatePoolAgents(projectDir) {
     const agentsDir = path.join(projectDir, '.opencode', 'agents');
-    // Use shared utility — force=false means skip existing
     const result = generatePoolAgentFilesFromConfig(projectDir, agentsDir, { force: false });
-    // Extract successfully created files (not skipped, not updated)
     return result.created;
 }
-// ============================================================================
-// Simple YAML Parser
-// ============================================================================
 function parseSimpleYaml(content) {
     const lines = content.split('\n');
     const result = {};
@@ -331,9 +291,6 @@ function parseValue(value) {
         return num;
     return value;
 }
-// ============================================================================
-// Mask Loader
-// ============================================================================
 class MaskLoader {
     masksDir;
     catalog = null;
@@ -354,7 +311,6 @@ class MaskLoader {
         return this.catalog;
     }
     async load(maskId) {
-        // Check if mask is disabled in configuration
         if (!isMaskEnabled(this.config, maskId)) {
             return null;
         }
@@ -388,7 +344,6 @@ class MaskLoader {
         const result = [];
         for (const [categoryId, category] of Object.entries(catalog.categories)) {
             for (const mask of category.masks) {
-                // Filter out disabled masks
                 if (isMaskEnabled(this.config, mask.id)) {
                     result.push({ ...mask, category: categoryId });
                 }
@@ -399,7 +354,6 @@ class MaskLoader {
     async listCategories() {
         const catalog = await this.loadCatalog();
         return Object.entries(catalog.categories).map(([id, cat]) => {
-            // Count only enabled masks
             const enabledMasks = cat.masks.filter(m => isMaskEnabled(this.config, m.id));
             return {
                 id,
@@ -410,9 +364,6 @@ class MaskLoader {
         });
     }
 }
-// ============================================================================
-// Prompt Builder
-// ============================================================================
 function buildRichPrompt(mask) {
     const parts = [];
     parts.push(`You are ${mask.profile.name}.`);
@@ -463,9 +414,6 @@ function pluginLog(client, level, message) {
         },
     });
 }
-// ============================================================================
-// Helper functions for tool factories
-// ============================================================================
 function createListMasksTool(maskLoader, activeMask) {
     return {
         description: 'List all available expert persona masks.',
@@ -580,7 +528,7 @@ function createMaskweaverStatusTool(maskLoader, masksDir, activeMask) {
                     masksCount = masks.length;
                     categoriesCount = categories.length;
                 }
-                catch (_e) { /* ignore */ }
+                catch (_e) { }
             }
             const active = activeMask();
             return `Maskweaver v${VERSION}
@@ -635,42 +583,27 @@ function playCompletionSound(config) {
             process.stdout.write('\u0007');
         }
         catch {
-            // Ignore failures - notification sound is best-effort only.
         }
     }
 }
 let state = null;
-// ============================================================================
 export const MaskweaverPlugin = async ({ client, directory, project, worktree, $, serverUrl }) => {
-    // ==========================================================================
-    // 1. Load Configuration (oh-my-opencode pattern)
-    // ==========================================================================
     const pluginConfig = loadPluginConfig(directory, { client, verbose: false });
-    // Validate configuration
     const configErrors = validateConfig(pluginConfig);
     if (configErrors.length > 0) {
         pluginLog(client, 'warn', `Configuration validation errors: ${configErrors.join(', ')}`);
     }
     const verbose = isVerboseLoggingEnabled(pluginConfig);
-    // ==========================================================================
-    // 2. Auto-install assets on first run
-    // ==========================================================================
     const installResult = installAssets(directory);
-    // Track if this is a first-time installation
     const isFirstInstall = installResult.installed.length > 0;
     if (isFirstInstall) {
         pluginLog(client, 'info', `Installed ${installResult.installed.length} files to .opencode/ (agents, masks)`);
-        // Show prominent restart message for first-time installation
         pluginLog(client, 'warn', `⚠️ RESTART REQUIRED: Please restart OpenCode to activate all Maskweaver features (agents, masks, commands).`);
     }
     if (installResult.errors.length > 0) {
         pluginLog(client, 'warn', `Asset errors: ${installResult.errors.join(', ')}`);
     }
-    // ==========================================================================
-    // 2b. Auto-create/migrate default config files (global first, then project)
-    // ==========================================================================
     const globalConfigDir = path.join(os.homedir(), '.config', 'opencode');
-    // Migrate/update global config with missing fields
     const globalConfigPath = path.join(globalConfigDir, 'maskweaver.config.json');
     if (fs.existsSync(globalConfigPath)) {
         try {
@@ -703,25 +636,17 @@ export const MaskweaverPlugin = async ({ client, directory, project, worktree, $
     if (createdPluginConfig) {
         pluginLog(client, 'info', `Created plugin config: ${path.relative(directory, createdPluginConfig)}`);
     }
-    // ==========================================================================
-    // 2c. Generate pool agents from maskweaver.config.json (dummyHumans.pool)
-    // ==========================================================================
     const generatedAgents = generatePoolAgents(directory);
     if (generatedAgents.length > 0) {
         pluginLog(client, 'info', `Generated ${generatedAgents.length} pool agent files from maskweaver.config.json: ${generatedAgents.map(p => path.basename(p)).join(', ')}`);
         pluginLog(client, 'warn', `⚠️ RESTART REQUIRED: Please restart OpenCode to activate the new pool agent files.`);
     }
-    // If project config was just created but pool has no agents, warn user
     if (createdRuntimeConfig && generatedAgents.length === 0) {
         pluginLog(client, 'warn', `⚠️ maskweaver.config.json was created. Edit it to configure your model pool, then restart OpenCode.`);
     }
-    // ==========================================================================
-    // 3. Initialize masks
-    // ==========================================================================
     const homeDir = os.homedir();
     const globalMasksDir = path.join(homeDir, '.config', 'opencode', 'masks');
     const projectMasksDir = path.join(directory, '.opencode', 'masks');
-    // Priority: project masks > global masks
     const masksDir = fs.existsSync(projectMasksDir) ? projectMasksDir : globalMasksDir;
     const pluginState = {
         maskLoader: null,
@@ -731,7 +656,6 @@ export const MaskweaverPlugin = async ({ client, directory, project, worktree, $
         currentSessionID: null,
     };
     state = pluginState;
-    // Log plugin loaded
     pluginLog(client, 'info', `Maskweaver plugin loaded v${VERSION}`);
     if (fs.existsSync(masksDir)) {
         pluginState.maskLoader = new MaskLoader(masksDir, pluginConfig);
@@ -746,9 +670,6 @@ export const MaskweaverPlugin = async ({ client, directory, project, worktree, $
             pluginState.maskLoader = null;
         }
     }
-    // ==========================================================================
-    // 4. Auto-activate default mask (oh-my-opencode pattern)
-    // ==========================================================================
     const defaultMaskId = getDefaultMask(pluginConfig);
     const autoActivate = isAutoActivateEnabled(pluginConfig);
     if (defaultMaskId && autoActivate && pluginState.maskLoader) {
@@ -766,28 +687,17 @@ export const MaskweaverPlugin = async ({ client, directory, project, worktree, $
             pluginLog(client, 'warn', `Failed to auto-activate default mask: ${e}`);
         }
     }
-    // ==========================================================================
-    // 5. Helper functions for tool factories
-    // ==========================================================================
     const getActiveMask = () => pluginState.activeMask;
     const setActiveMask = (mask) => {
         pluginState.activeMask = mask;
     };
-    // ==========================================================================
-    // 6. Conditional tool registration (oh-my-opencode pattern)
-    // ==========================================================================
     const isToolActive = (toolName) => isToolEnabled(pluginConfig, toolName);
-    // Helper to ensure tool arguments are compatible with opencode's expected format.
-    // opencode expects a ZodRawShape (raw object), NOT a ZodObject instance.
-    // Zod 4: schema.def.shape, Zod 3: schema._def.shape()
     const wrapSchema = (schema) => {
         if (!schema || typeof schema !== 'object')
             return schema;
-        // Zod 4 — def.shape is a plain object
         if (schema.def && typeof schema.def === 'object' && schema.type === 'object' && schema.def.shape && typeof schema.def.shape === 'object') {
             return schema.def.shape;
         }
-        // Zod 3 — _def.shape() returns a plain object
         if (schema._def && typeof schema._def.shape === 'function') {
             return schema._def.shape();
         }
@@ -821,7 +731,6 @@ export const MaskweaverPlugin = async ({ client, directory, project, worktree, $
         tool.args = wrapSchema(tool.args);
         tools.maskweaver_status = tool;
     }
-    // Memory tools
     if (isToolActive('memory_search')) {
         const memorySearchTool = createMemorySearchTool();
         tools.memory_search = {
@@ -854,7 +763,6 @@ export const MaskweaverPlugin = async ({ client, directory, project, worktree, $
             execute: (args) => memoryIndexerTool.execute(args, { worktree: directory }),
         };
     }
-    // Context tool
     if (isToolActive('context')) {
         const contextTool = createContextTool();
         tools.context = {
@@ -863,7 +771,6 @@ export const MaskweaverPlugin = async ({ client, directory, project, worktree, $
             execute: (args) => contextTool.execute(args, { worktree: directory }),
         };
     }
-    // Retrospect tool
     if (isToolActive('retrospect')) {
         const retrospectTool = createRetrospectTool();
         tools.retrospect = {
@@ -872,7 +779,6 @@ export const MaskweaverPlugin = async ({ client, directory, project, worktree, $
             execute: (args) => retrospectTool.execute(args, { worktree: directory }),
         };
     }
-    // Mask save tool
     if (isToolActive('mask_save')) {
         const maskSaveTool = createMaskSaveTool();
         tools.mask_save = {
@@ -881,7 +787,6 @@ export const MaskweaverPlugin = async ({ client, directory, project, worktree, $
             execute: (args) => maskSaveTool.execute(args, { worktree: directory }),
         };
     }
-    // Squad tool (multi-agent collaboration)
     if (isToolActive('squad')) {
         const squadTool = createSquadTool();
         tools.squad = {
@@ -890,7 +795,6 @@ export const MaskweaverPlugin = async ({ client, directory, project, worktree, $
             execute: (args) => squadTool.execute(args, { worktree: directory }),
         };
     }
-    // Weave tool (phase-driven development workflow)
     if (isToolActive('weave')) {
         const weaveTool = createWeaveTool();
         tools.weave = {
@@ -899,7 +803,6 @@ export const MaskweaverPlugin = async ({ client, directory, project, worktree, $
             execute: (args) => weaveTool.execute(args, { worktree: directory }),
         };
     }
-    // Slashcommand tool (handles /weave etc. on first run without restart)
     if (isToolActive('slashcommand')) {
         const slashcommandTool = createSlashcommandTool(getAssetsDir());
         tools.slashcommand = {
@@ -908,22 +811,7 @@ export const MaskweaverPlugin = async ({ client, directory, project, worktree, $
             execute: (args) => slashcommandTool.execute(args, { worktree: directory }),
         };
     }
-    // ==========================================================================
-    // 8. Agents are loaded from .opencode/agents/*.md files by OpenCode's
-    //    filesystem-based agent loader (see config/agent.ts:110-140).
-    //    installAssets() in step 2 copies agent .md files so they are picked up.
-    //    The 'agent' property in Hooks is NOT consumed by OpenCode — confirmed
-    //    by source analysis (packages/opencode/src/plugin/index.ts:92-103).
-    // ==========================================================================
-    // ==========================================================================
-    // 9. Return plugin hooks (official OpenCode Hooks interface only)
-    //    Note: Agents are registered via .opencode/agents/*.md files (installed by
-    //    installAssets()), NOT via the plugin return. The Hooks type does not
-    //    include 'agent' — OpenCode loads agents from the filesystem exclusively.
-    // ==========================================================================
     return {
-        // Agent registration handled via .opencode/agents/*.md files (see installAssets)
-        // System prompt transform - inject active mask
         'experimental.chat.system.transform': async (_input, output) => {
             if (state?.activeMask) {
                 const maskPrompt = `<ACTIVE_PERSONA>
@@ -934,11 +822,8 @@ ${buildRichPrompt(state.activeMask)}
                 (output.system ||= []).push(maskPrompt);
             }
         },
-        // Conditional tools
         tool: tools,
-        // Event hooks (oh-my-opencode pattern)
         event: async ({ event }) => {
-            // Session created - log available masks
             if (event.type === 'session.created') {
                 pluginState.currentSessionID = getSessionId(event);
                 if (pluginState.maskLoader && verbose) {
@@ -948,11 +833,9 @@ ${buildRichPrompt(state.activeMask)}
                         pluginLog(client, 'info', `Session started - ${masks.length} masks available across ${categories.length} categories`);
                     }
                     catch (_e) {
-                        // Ignore errors
                     }
                 }
             }
-            // Session idle - generation completed
             if (event.type === 'session.idle') {
                 const idleSessionID = getSessionId(event);
                 const isCurrentSession = !idleSessionID ||
@@ -962,7 +845,6 @@ ${buildRichPrompt(state.activeMask)}
                     playCompletionSound(pluginState.config);
                 }
             }
-            // Session deleted - cleanup
             if (event.type === 'session.deleted') {
                 const deletedSessionID = getSessionId(event);
                 if (!deletedSessionID || deletedSessionID === pluginState.currentSessionID) {
@@ -977,11 +859,7 @@ ${buildRichPrompt(state.activeMask)}
                 }
             }
         },
-        // Config hook - allows plugins to modify opencode configuration
         config: async (config) => {
-            // opencode discovers slash commands from config.command and command files.
-            // installAssets() writes command files for subsequent starts, while this
-            // hook makes the direct /build command visible on the current plugin load.
             config.command ||= {};
             config.command.build ||= {
                 description: 'Run or manage the Maskweaver autonomous build loop',

package/dist/plugin/tools/command-registry.d.ts

@@ -1,9 +1,3 @@
-/**
- * Command Registry for Weave Tool
- *
- * Loads commands.json and provides alias resolution, deprecation warnings,
- * and dynamic description/help generation.
- */
 export interface CommandArg {
     name: string;
     type: 'string' | 'boolean' | 'number' | 'enum';

package/dist/plugin/tools/command-registry.js

@@ -1,14 +1,5 @@
-/**
- * Command Registry for Weave Tool
- *
- * Loads commands.json and provides alias resolution, deprecation warnings,
- * and dynamic description/help generation.
- */
 import * as fs from 'node:fs';
 import * as path from 'node:path';
-// ============================================================================
-// Inline Default (fail-safe fallback when commands.json cannot be loaded)
-// ============================================================================
 const INLINE_DEFAULT = {
     schemaVersion: '1.0',
     lastUpdated: '2026-04-29',
@@ -246,13 +237,9 @@ const INLINE_DEFAULT = {
         },
     ],
 };
-// ============================================================================
-// Resolution
-// ============================================================================
 let _cached = null;
 let _cachePath = null;
 function resolveCommandsJsonPath() {
-    // Try relative to dist first, then src (for dev)
     const candidates = [
         path.join(process.cwd(), 'assets', 'commands', 'meta', 'commands.json'),
         path.join(process.cwd(), 'dist', 'assets', 'commands', 'meta', 'commands.json'),
@@ -279,7 +266,6 @@ export function loadCommandsJson() {
             return parsed;
         }
         catch {
-            // fall through to inline default
         }
     }
     _cached = INLINE_DEFAULT;