maskweaver 0.9.4 → 0.9.5

package/dist/plugin/tools/slashcommand.js

@@ -1,24 +1,9 @@
-/**
- * Slashcommand Tool for OpenCode Plugin
- *
- * Handles slash commands directly as a tool, inspired by oh-my-opencode.
- * This ensures commands work on first run without requiring restart.
- *
- * Pattern: Commands are discovered from:
- * 1. Built-in embedded commands (always available)
- * 2. Package assets/commands/ folder
- * 3. Project .opencode/commands/ folder (overrides)
- */
 import { z } from 'zod';
-// Inline shim: tool() is just an identity function in @opencode-ai/plugin
 const tool = (input) => input;
 import * as fs from 'node:fs';
 import * as path from 'node:path';
 import { parse as parseYaml } from 'yaml';
 import { loadCommandsJson } from './command-registry.js';
-// ============================================================================
-// Built-in Commands from Registry (commands.json)
-// ============================================================================
 function getBuiltinCommandsFromRegistry() {
     const registry = loadCommandsJson();
     const builtins = {};
@@ -40,9 +25,6 @@ function getBuiltinCommandsFromRegistry() {
     }
     return builtins;
 }
-// ============================================================================
-// Command Discovery
-// ============================================================================
 function parseFrontmatter(content) {
     const parts = content.split('---');
     if (parts.length < 3) {
@@ -93,17 +75,14 @@ function discoverCommandsFromDir(commandsDir, scope) {
 }
 function getAllCommands(assetsDir, projectDir) {
     const BUILTIN_COMMANDS = getBuiltinCommandsFromRegistry();
-    // Start with builtin commands
     const commands = Object.entries(BUILTIN_COMMANDS).map(([name, cmd]) => ({
         name,
         metadata: cmd.metadata,
         content: cmd.content,
         scope: 'builtin',
     }));
-    // Load from package assets
     if (assetsDir) {
         const packageCommands = discoverCommandsFromDir(path.join(assetsDir, 'commands'), 'package');
-        // Package commands override builtins
         for (const cmd of packageCommands) {
             const existingIndex = commands.findIndex(c => c.name === cmd.name);
             if (existingIndex >= 0) {
@@ -114,7 +93,6 @@ function getAllCommands(assetsDir, projectDir) {
             }
         }
     }
-    // Load from project .opencode/commands (highest priority)
     const projectCommands = discoverCommandsFromDir(path.join(projectDir, '.opencode', 'commands'), 'project');
     for (const cmd of projectCommands) {
         const existingIndex = commands.findIndex(c => c.name === cmd.name);
@@ -127,9 +105,6 @@ function getAllCommands(assetsDir, projectDir) {
     }
     return commands;
 }
-// ============================================================================
-// Tool Factory
-// ============================================================================
 export function createSlashcommandTool(assetsDir) {
     const registry = loadCommandsJson();
     const descLines = ['Execute a slash command. Available commands include:'];
@@ -138,7 +113,6 @@ export function createSlashcommandTool(assetsDir) {
     }
     descLines.push('');
     descLines.push('Use command="list" to see all available commands.');
-    // Build dynamic shorthand list from registry
     const shorthandSet = new Set();
     for (const cmd of registry.commands) {
         shorthandSet.add(cmd.name);
@@ -156,9 +130,7 @@ export function createSlashcommandTool(assetsDir) {
         },
         execute: async (args, context) => {
             const projectDir = context.worktree;
-            // Discover all commands (builtin + package + project)
             const commands = getAllCommands(assetsDir, projectDir);
-            // Handle "list" command
             if (args.command === 'list' || !args.command) {
                 const lines = ['# Available Slash Commands\n'];
                 for (const cmd of commands) {
@@ -168,41 +140,31 @@ export function createSlashcommandTool(assetsDir) {
                 lines.push(`\n**Total**: ${commands.length} commands`);
                 return lines.join('\n');
             }
-            // Normalize command name (remove leading /)
             let cmdName = args.command.replace(/^\//, '').toLowerCase();
-            // Handle "weave" command with optional subcommand
-            // e.g., "weave status" -> "weave-status"
-            // e.g., "status" (alone) -> might mean "weave-status"
             if (cmdName.startsWith('weave ')) {
-                // "weave design" -> "weave-design"
                 cmdName = cmdName.replace(' ', '-');
             }
             else if (cmdName === 'weave') {
-                // Just "weave" -> "weave-help"
                 const helpCmd = commands.find(c => c.name === 'weave-help');
                 if (helpCmd) {
                     return helpCmd.content || 'Weave help content not available.';
                 }
             }
             else if (shorthandList.includes(cmdName)) {
-                // Shorthand: "status" -> "weave-status"
                 const weaveCmd = commands.find(c => c.name === `weave-${cmdName}`);
                 if (weaveCmd) {
                     return weaveCmd.content || `weave-${cmdName} content not available.`;
                 }
             }
-            // Find exact match
             const exactMatch = commands.find(c => c.name.toLowerCase() === cmdName);
             if (exactMatch) {
                 return exactMatch.content || `/${exactMatch.name} has no content.`;
             }
-            // Find partial matches
             const partialMatches = commands.filter(c => c.name.toLowerCase().includes(cmdName));
             if (partialMatches.length > 0) {
                 const matchList = partialMatches.map(c => `/${c.name}`).join(', ');
                 return `No exact match for "/${cmdName}". Did you mean: ${matchList}?`;
             }
-            // No match found
             const available = commands.slice(0, 10).map(c => `/${c.name}`).join(', ');
             return `Command "/${cmdName}" not found. Available: ${available}...`;
         },

package/dist/plugin/tools/squad.d.ts

@@ -1,15 +1,3 @@
-/**
- * Squad Management Tool
- *
- * Multi-agent collaboration session and squad management
- *
- * Design Principles:
- * - Intention-Revealing Code
- * - Clear error messages
- * - Consistent JSON response format (following context.ts pattern)
- *
- * @author Martin Fowler's Dummy Human
- */
 import { z } from "zod";
 import type { ToolFactory } from '../types.js';
 export declare const squadSchema: z.ZodObject<{

package/dist/plugin/tools/squad.js

@@ -1,39 +1,22 @@
-/**
- * Squad Management Tool
- *
- * Multi-agent collaboration session and squad management
- *
- * Design Principles:
- * - Intention-Revealing Code
- * - Clear error messages
- * - Consistent JSON response format (following context.ts pattern)
- *
- * @author Martin Fowler's Dummy Human
- */
 import { z } from "zod";
 import * as shared from '../../shared-context/index.js';
 import { join } from "path";
 import { getModelRegistry } from '../../shared/model-registry.js';
-// ============================================================================
-// Schema Definition
-// ============================================================================
 export const squadSchema = z.object({
     action: z.enum([
-        "start", // Start new session (goal required)
-        "squad", // Create squad (mission required)
-        "assign", // Assign task (squadId, description, assignee required)
-        "update", // Update task (squadId, taskId, status required)
-        "complete", // Complete task (squadId, taskId, result required)
-        "status", // View session/squad status
-        "watchdog", // Run watchdog (dryRun optional)
-        "list", // List all squads
-        "plan", // Analyze task dependencies and create parallel execution plan
-        "models" // Query available models and their concurrency status
+        "start",
+        "squad",
+        "assign",
+        "update",
+        "complete",
+        "status",
+        "watchdog",
+        "list",
+        "plan",
+        "models"
     ]).describe("Action to execute"),
-    // start action params
     goal: z.string().optional().describe("Session goal (for start action)"),
     createdBy: z.string().optional().describe("Agent ID creating the session"),
-    // squad action params
     mission: z.string().optional().describe("Squad mission (for squad action)"),
     operator: z.string().optional().describe("Squad operator agent ID"),
     scope: z.object({
@@ -45,25 +28,21 @@ export const squadSchema = z.object({
         tokenBudget: z.number().optional(),
         maxWorkers: z.number().optional(),
     }).optional().describe("Squad resource constraints"),
-    // assign action params
     squadId: z.string().optional().describe("Target squad ID"),
     assignee: z.string().optional().describe("Agent to assign task to"),
     description: z.string().optional().describe("Task description"),
     priority: z.enum(["low", "medium", "high", "critical"]).optional()
         .describe("Task priority"),
-    // update action params
     taskId: z.string().optional().describe("Task ID to update"),
     status: z.enum(["pending", "active", "paused", "completed", "failed"]).optional()
         .describe("New task status"),
     startedAt: z.string().optional().describe("Task start timestamp"),
-    // complete action params
     success: z.boolean().optional().describe("Whether task succeeded"),
     output: z.unknown().optional().describe("Task output data"),
     error: z.object({
         code: z.string(),
         message: z.string(),
     }).optional().describe("Task error info"),
-    // watchdog action params
     dryRun: z.boolean().optional().describe("Run watchdog without side effects"),
 });
 function createResponse(success, action, message, data) {
@@ -79,9 +58,6 @@ function successResponse(action, message, data) {
 function errorResponse(action, message) {
     return createResponse(false, action, message);
 }
-// ============================================================================
-// Active Session Management
-// ============================================================================
 const ACTIVE_SESSION_FILE = "shared/active.json";
 async function getActiveSessionId(basePath) {
     const storage = new shared.FileStorageAdapter(join(basePath, ".opencode"));
@@ -104,12 +80,6 @@ async function loadActiveSession(basePath) {
     const storage = new shared.FileStorageAdapter(join(basePath, ".opencode"));
     return shared.loadSession(storage, sessionId);
 }
-// ============================================================================
-// Tool Factory
-// ============================================================================
-/**
- * Analyze task dependencies and create parallel execution plan
- */
 async function handlePlan(basePath, squadId) {
     if (!squadId || squadId.trim().length === 0) {
         return errorResponse("plan", 'Squad ID is required. Example: squadId="squad-abc123"');
@@ -138,7 +108,7 @@ async function handlePlan(basePath, squadId) {
             criticalPath: plan.dag.criticalPath,
             hasCycle: plan.dag.hasCycle,
             waves: plan.waves,
-            rawOutput: planOutput, // Include a raw string for easier display
+            rawOutput: planOutput,
         });
     }
     catch (error) {
@@ -224,14 +194,6 @@ Direct use of assign/update/complete by primary agent pollutes strategic context
         }
     };
 }
-// ============================================================================
-// Action Handlers
-// ============================================================================
-/**
- * Start a new collaboration session
- *
- * Creates a session and sets it as the active session.
- */
 async function handleStart(basePath, goal, createdBy) {
     if (!goal || goal.trim().length === 0) {
         return errorResponse("start", 'Session goal (goal) is required. Example: goal="Implement OAuth login"');
@@ -242,7 +204,6 @@ async function handleStart(basePath, goal, createdBy) {
         goal,
         createdBy: agentId,
     });
-    // Set as active session
     await setActiveSession(basePath, session.manifest.sessionId, goal);
     return successResponse("start", `Session started: ${goal}`, {
         sessionId: session.manifest.sessionId,
@@ -252,9 +213,6 @@ async function handleStart(basePath, goal, createdBy) {
         basePath: session.sessionPath,
     });
 }
-/**
- * Create a new squad within the active session
- */
 async function handleSquad(basePath, mission, operator, scope, constraints) {
     if (!mission || mission.trim().length === 0) {
         return errorResponse("squad", 'Squad mission is required. Example: mission="Implement user authentication"');
@@ -282,9 +240,6 @@ async function handleSquad(basePath, mission, operator, scope, constraints) {
         createdAt: spec.createdAt,
     });
 }
-/**
- * Assign a task to an agent within a squad
- */
 async function handleAssign(basePath, squadId, assignee, description, priority) {
     if (!squadId || squadId.trim().length === 0) {
         return errorResponse("assign", 'Squad ID is required. Example: squadId="squad-abc123"');
@@ -313,9 +268,6 @@ async function handleAssign(basePath, squadId, assignee, description, priority)
         createdAt: task.createdAt,
     });
 }
-/**
- * Update a task's status
- */
 async function handleUpdate(basePath, squadId, taskId, status, startedAt) {
     if (!squadId || squadId.trim().length === 0) {
         return errorResponse("update", 'Squad ID is required. Example: squadId="squad-abc123"');
@@ -343,9 +295,6 @@ async function handleUpdate(basePath, squadId, taskId, status, startedAt) {
         startedAt: updatedTask.startedAt,
     });
 }
-/**
- * Complete a task with result
- */
 async function handleComplete(basePath, squadId, taskId, success, output, error) {
     if (!squadId || squadId.trim().length === 0) {
         return errorResponse("complete", 'Squad ID is required. Example: squadId="squad-abc123"');
@@ -360,7 +309,6 @@ async function handleComplete(basePath, squadId, taskId, success, output, error)
     if (!session) {
         return errorResponse("complete", 'No active session. Start a session first with action="start"');
     }
-    // Build TaskResult
     const result = success
         ? { success: true, output }
         : { success: false, error: error ?? { code: "UNKNOWN", message: "Task failed" } };
@@ -373,9 +321,6 @@ async function handleComplete(basePath, squadId, taskId, success, output, error)
         result: completedTask.result,
     });
 }
-/**
- * View session or squad status
- */
 async function handleStatus(basePath, squadId) {
     const session = await loadActiveSession(basePath);
     if (!session) {
@@ -383,7 +328,6 @@ async function handleStatus(basePath, squadId) {
             hasActiveSession: false,
         });
     }
-    // If squadId provided, show squad details
     if (squadId && squadId.trim().length > 0) {
         const squad = await shared.getSquad(session, squadId);
         if (!squad) {
@@ -409,7 +353,6 @@ async function handleStatus(basePath, squadId) {
             updatedAt: squad.state.updatedAt,
         });
     }
-    // Show session overview
     const squads = [];
     for (const sid of session.manifest.squads) {
         const squad = await shared.getSquad(session, sid);
@@ -431,9 +374,6 @@ async function handleStatus(basePath, squadId) {
         squads,
     });
 }
-/**
- * Run watchdog to detect stuck squads/tasks
- */
 async function handleWatchdog(basePath, dryRun) {
     const session = await loadActiveSession(basePath);
     if (!session) {
@@ -455,9 +395,6 @@ async function handleWatchdog(basePath, dryRun) {
         dryRun: dryRun ?? false,
     });
 }
-/**
- * List all squads in the active session
- */
 async function handleList(basePath) {
     const session = await loadActiveSession(basePath);
     if (!session) {
@@ -482,7 +419,6 @@ async function handleList(basePath) {
             });
         }
     }
-    // Group by status
     const counts = {
         pending: squads.filter(s => s.status === "pending").length,
         active: squads.filter(s => s.status === "active").length,
@@ -497,13 +433,6 @@ async function handleList(basePath) {
         squads,
     });
 }
-// ============================================================================
-// Models Handler - Query model pool status
-// ============================================================================
-/**
- * Show available models and their concurrency status.
- * Used by Squad Operator to make informed assignee decisions.
- */
 async function handleModels() {
     try {
         const registry = getModelRegistry();
@@ -521,7 +450,6 @@ async function handleModels() {
             available: m.available,
             description: m.entry.description || '',
         }));
-        // Group by tier
         const byTier = {};
         for (const m of modelDetails) {
             (byTier[m.tier] ??= []).push(m);

package/dist/plugin/tools/weave.d.ts

@@ -1,9 +1,3 @@
-/**
- * Weave Tool for OpenCode Plugin
- *
- * Integrates Weave workflow into OpenCode as a tool.
- * Commands: design, craft, status
- */
 import { z } from 'zod';
 export declare function createWeaveTool(): {
     description: string;