maskweaver 0.9.3 → 0.9.5

package/dist/plugin/tools/memoryIndexer.js

@@ -1,15 +1,8 @@
-/**
- * Memory Indexer Tool - Index memory files for semantic search
- */
 import { z } from "zod";
 import { indexFile, reindexFile, indexAllMemoryFiles } from "../../memory/index.js";
 import { createProvider, selectBestProvider } from "../../memory/index.js";
 import { getMemoryProviderConfig } from "../../shared/config.js";
-/**
- * Get embedding provider based on configuration
- */
 async function getConfiguredProvider(worktree) {
-    // Try to load config from maskweaver.config.json
     const memoryConfig = getMemoryProviderConfig(worktree);
     if (memoryConfig && memoryConfig.provider) {
         const providerConfig = {
@@ -30,7 +23,6 @@ async function getConfiguredProvider(worktree) {
             console.warn(`Failed to create provider: ${error}`);
         }
     }
-    // Fallback
     const fallbackConfigs = [
         { type: "ollama", model: "bge-m3", dimensions: 1024 },
         { type: "ollama", model: "nomic-embed-text", dimensions: 768 },
@@ -53,13 +45,11 @@ Actions:
         async execute(args, context) {
             try {
                 const basePath = context.worktree;
-                // Create embedding provider from config
                 const provider = await getConfiguredProvider(basePath);
                 const getEmbedding = async (text) => {
                     const embeddings = await provider.embed([text]);
                     return embeddings[0];
                 };
-                // Execute action
                 switch (args.action) {
                     case "index":
                         await indexFile(args.path, getEmbedding, basePath);

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

@@ -1,27 +1,4 @@
-/**
- * Memory Search Tool
- *
- * Hybrid search: Vector similarity + Text matching
- *
- * "Clear is better than clever." - Rob Pike
- *
- * Architecture:
- * - Lazy provider initialization (only on first call)
- * - Graceful degradation (auto-fallback to working providers)
- * - Result caching at provider level
- * - JSON response format for consistent parsing
- */
 import { z } from "zod";
-/**
- * Memory search arguments schema
- *
- * Sources:
- * - memory: Long-term knowledge (MEMORY.md)
- * - masks: Mask usage history and effectiveness
- * - retrospect: Daily retrospectives and lessons
- * - daily: Today's work log
- * - user: User preferences and information (USER.md)
- */
 declare const memorySearchArgsSchema: z.ZodObject<{
     query: z.ZodString;
     maxResults: z.ZodOptional<z.ZodNumber>;
@@ -38,14 +15,6 @@ type MemorySearchArgs = z.infer<typeof memorySearchArgsSchema>;
 export interface MemorySearchToolContext {
     worktree: string;
 }
-/**
- * Create memory search tool
- *
- * Factory pattern allows:
- * - Dependency injection (context)
- * - Testing with mock providers
- * - Configuration per instance
- */
 export declare function createMemorySearchTool(): {
     description: string;
     args: z.ZodObject<{

package/dist/plugin/tools/memorySearch.js

@@ -1,33 +1,7 @@
-/**
- * Memory Search Tool
- *
- * Hybrid search: Vector similarity + Text matching
- *
- * "Clear is better than clever." - Rob Pike
- *
- * Architecture:
- * - Lazy provider initialization (only on first call)
- * - Graceful degradation (auto-fallback to working providers)
- * - Result caching at provider level
- * - JSON response format for consistent parsing
- */
 import { z } from "zod";
 import { hybridSearch, initDatabase, getDbPath, selectBestProvider, createProvider, CONFIG, } from "../../memory/index.js";
 import { getMemoryProviderConfig } from "../../shared/config.js";
 import path from "node:path";
-// ============================================================================
-// Schema Definition
-// ============================================================================
-/**
- * Memory search arguments schema
- *
- * Sources:
- * - memory: Long-term knowledge (MEMORY.md)
- * - masks: Mask usage history and effectiveness
- * - retrospect: Daily retrospectives and lessons
- * - daily: Today's work log
- * - user: User preferences and information (USER.md)
- */
 const memorySearchArgsSchema = z.object({
     query: z.string().describe("Natural language search query"),
     maxResults: z.number().optional().describe("Maximum results to return (default: 6)"),
@@ -37,37 +11,14 @@ const memorySearchArgsSchema = z.object({
         .optional()
         .describe("Filter by source types (default: all)"),
 });
-// ============================================================================
-// Provider State (Singleton Pattern)
-// ============================================================================
-/**
- * Lazy-initialized embedding provider
- *
- * Benefits:
- * - No initialization cost if tool is never used
- * - Automatic provider selection on first use
- * - Shared across all search calls
- */
 let providerInstance = null;
 let providerWorktree = null;
-/**
- * Get or initialize the embedding provider
- *
- * Reads configuration from maskweaver.config.json if available.
- * Falls back to default provider chain if no config found.
- *
- * @param worktree - Project root path for config lookup
- * @returns Initialized provider (may be text-only fallback)
- */
 async function getProvider(worktree) {
-    // Return cached provider if same worktree
     if (providerInstance && providerWorktree === worktree) {
         return providerInstance;
     }
-    // Try to load config from maskweaver.config.json
     const memoryConfig = getMemoryProviderConfig(worktree);
     if (memoryConfig && memoryConfig.provider) {
-        // Use configured provider
         const providerConfig = {
             type: memoryConfig.provider,
             model: memoryConfig.model,
@@ -90,7 +41,6 @@ async function getProvider(worktree) {
             console.warn(`Failed to create provider: ${error}`);
         }
     }
-    // Fallback: Try Ollama with bge-m3 (common default)
     const fallbackConfigs = [
         { type: "ollama", model: "bge-m3", dimensions: 1024 },
         { type: "ollama", model: "nomic-embed-text", dimensions: 768 },
@@ -100,14 +50,6 @@ async function getProvider(worktree) {
     providerWorktree = worktree;
     return providerInstance;
 }
-/**
- * Create memory search tool
- *
- * Factory pattern allows:
- * - Dependency injection (context)
- * - Testing with mock providers
- * - Configuration per instance
- */
 export function createMemorySearchTool() {
     return {
         description: `Search memories using semantic similarity and keyword matching.
@@ -122,32 +64,18 @@ Keywords: "remember", "before", "last time", "previous"`,
         args: memorySearchArgsSchema,
         async execute(args, context) {
             try {
-                // Configuration with defaults
                 const maxResults = args.maxResults ?? CONFIG.search.defaultMaxResults;
                 const minScore = args.minScore ?? CONFIG.search.defaultMinScore;
-                // ====================================================================
-                // 1. Initialize Database
-                // ====================================================================
                 const dbPath = getDbPath(context.worktree);
                 await initDatabase(dbPath);
-                // ====================================================================
-                // 2. Get Embedding Provider (lazy initialization)
-                // ====================================================================
                 const provider = await getProvider(context.worktree);
-                // Generate query embedding (embed takes array, returns array)
                 const embeddingResults = await provider.embed([args.query]);
                 const embedding = embeddingResults[0];
-                // ====================================================================
-                // 3. Hybrid Search
-                // ====================================================================
                 const results = hybridSearch(args.query, embedding, {
                     limit: maxResults,
                     minScore: minScore,
                     sourceFilter: args.sources,
                 });
-                // ====================================================================
-                // 4. Format Results
-                // ====================================================================
                 if (results.length === 0) {
                     return JSON.stringify({
                         results: [],
@@ -156,7 +84,6 @@ Keywords: "remember", "before", "last time", "previous"`,
                         message: "No relevant memories found.",
                     }, null, 2);
                 }
-                // Convert to relative paths and truncate snippets
                 const formattedResults = results.map((r) => {
                     const relativePath = path.relative(context.worktree, r.chunk.path);
                     const snippet = r.chunk.text.length > 200
@@ -179,11 +106,7 @@ Keywords: "remember", "before", "last time", "previous"`,
                 }, null, 2);
             }
             catch (error) {
-                // ====================================================================
-                // 5. Error Handling
-                // ====================================================================
                 const message = error instanceof Error ? error.message : String(error);
-                // Embedding service connection failure
                 if (message.includes("fetch") || message.includes("ECONNREFUSED")) {
                     return JSON.stringify({
                         error: true,
@@ -191,7 +114,6 @@ Keywords: "remember", "before", "last time", "previous"`,
                         query: args.query,
                     }, null, 2);
                 }
-                // Database initialization failure
                 if (message.includes("Database") || message.includes("SQLite")) {
                     return JSON.stringify({
                         error: true,
@@ -199,7 +121,6 @@ Keywords: "remember", "before", "last time", "previous"`,
                         query: args.query,
                     }, null, 2);
                 }
-                // Generic error
                 return JSON.stringify({
                     error: true,
                     message: message,

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

@@ -1,10 +1,2 @@
-/**
- * Memory Write Tool
- *
- * Saves content to memory files with automatic indexing.
- * Each function does one thing well.
- *
- * @author Kent Beck's Dummy Human
- */
 import type { ToolFactory } from "../types.js";
 export declare function createMemoryWriteTool(): ToolFactory;

package/dist/plugin/tools/memoryWrite.js

@@ -1,26 +1,12 @@
-/**
- * Memory Write Tool
- *
- * Saves content to memory files with automatic indexing.
- * Each function does one thing well.
- *
- * @author Kent Beck's Dummy Human
- */
 import { z } from "zod";
 import { readFileSync, writeFileSync, existsSync, mkdirSync } from "fs";
 import { dirname, join, relative } from "path";
 import { getMemoryPath, getTodayFileName, } from "../../memory/index.js";
-// ============================================================================
-// Schema Definition
-// ============================================================================
 const memoryWriteArgsSchema = z.object({
     content: z.string().describe("Content to save (markdown format)"),
     target: z.enum(["daily", "memory", "user"]).describe("Target location"),
     section: z.string().optional().describe("Section title (e.g., 'User Preferences')"),
 });
-// ============================================================================
-// Tool Factory
-// ============================================================================
 export function createMemoryWriteTool() {
     return {
         description: `Saves content to memory files.
@@ -44,9 +30,6 @@ export function createMemoryWriteTool() {
         },
     };
 }
-// ============================================================================
-// Path Resolution
-// ============================================================================
 function determineFilePath(target, worktree) {
     if (target === "daily") {
         const dailyDir = getMemoryPath("daily", worktree);
@@ -54,9 +37,6 @@ function determineFilePath(target, worktree) {
     }
     return getMemoryPath(target, worktree);
 }
-// ============================================================================
-// File System Operations
-// ============================================================================
 function ensureDirectoryExists(filePath) {
     const dir = dirname(filePath);
     if (!existsSync(dir)) {
@@ -73,9 +53,6 @@ function saveContent(filePath, content) {
     const normalized = content.trim() + "\n";
     writeFileSync(filePath, normalized, "utf-8");
 }
-// ============================================================================
-// Content Building
-// ============================================================================
 function buildNewContent(existing, newText, section) {
     if (section) {
         return updateSection(existing, section, newText);
@@ -127,21 +104,12 @@ function buildEntry(timestamp, text) {
 function isEmpty(content) {
     return content.trim().length === 0;
 }
-// ============================================================================
-// Indexing
-// ============================================================================
 async function tryReindexing(_filePath) {
-    // NOTE: Reindexing requires embedding provider setup
-    // For now, skip auto-reindex on write. Use memory_indexer tool instead.
-    // To enable: instantiate provider and call reindexFile(filePath, getEmbedding)
 }
 function logIndexingWarning(error) {
     const message = error instanceof Error ? error.message : String(error);
     console.warn("[memoryWrite] Indexing skipped:", message);
 }
-// ============================================================================
-// Response Formatting
-// ============================================================================
 function formatSuccessResponse(filePath, target, worktree) {
     const relativePath = relative(worktree, filePath);
     return JSON.stringify({

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

@@ -1,5 +1,2 @@
-/**
- * Retrospect Tool - Session retrospective
- */
 import type { ToolFactory } from "../types.js";
 export declare function createRetrospectTool(): ToolFactory;

package/dist/plugin/tools/retrospect.js

@@ -1,6 +1,3 @@
-/**
- * Retrospect Tool - Session retrospective
- */
 import { z } from "zod";
 import { performRetrospect } from "../../retrospect/index.js";
 export function createRetrospectTool() {

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

@@ -1,14 +1,3 @@
-/**
- * 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';
 export declare function createSlashcommandTool(assetsDir?: string): {
     description: string;

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<{