maskweaver 0.9.4 → 0.9.5

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

@@ -1,15 +1,3 @@
-/**
- * Context Management Tool
- *
- * 피처 기반 작업 컨텍스트 관리 도구
- *
- * 설계 원칙:
- * - 의도를 드러내는 코드 (Intention-Revealing)
- * - 명확한 에러 메시지
- * - 일관된 JSON 응답 형식
- *
- * @author Martin Fowler's Dummy Human
- */
 import { z } from "zod";
 import type { ToolFactory } from '../types.js';
 export declare const contextSchema: z.ZodObject<{

package/dist/plugin/tools/context.js

@@ -1,20 +1,5 @@
-/**
- * Context Management Tool
- *
- * 피처 기반 작업 컨텍스트 관리 도구
- *
- * 설계 원칙:
- * - 의도를 드러내는 코드 (Intention-Revealing)
- * - 명확한 에러 메시지
- * - 일관된 JSON 응답 형식
- *
- * @author Martin Fowler's Dummy Human
- */
 import { z } from "zod";
 import * as core from '../../context/index.js';
-// ============================================================================
-// Schema 정의
-// ============================================================================
 export const contextSchema = z.object({
     action: z.enum([
         "start", "switch", "status", "done",
@@ -38,9 +23,6 @@ function successResponse(action, message, data) {
 function errorResponse(action, message) {
     return createResponse(false, action, message);
 }
-// ============================================================================
-// Tool Factory
-// ============================================================================
 export function createContextTool() {
     return {
         description: `작업 컨텍스트를 관리합니다.
@@ -91,14 +73,6 @@ export function createContextTool() {
         }
     };
 }
-// ============================================================================
-// 액션 핸들러
-// ============================================================================
-/**
- * 새 피처 시작
- *
- * 피처를 생성하고 즉시 활성화합니다.
- */
 async function handleStart(basePath, name, goal) {
     if (!name || name.trim().length === 0) {
         return errorResponse("start", "피처 이름(name)을 입력해주세요. 예: name=\"login-oauth\"");
@@ -106,12 +80,10 @@ async function handleStart(basePath, name, goal) {
     if (!goal || goal.trim().length === 0) {
         return errorResponse("start", "피처 목표(goal)를 입력해주세요. 예: goal=\"OAuth 로그인 구현\"");
     }
-    // 피처 생성
     const createResult = await core.createFeature(basePath, name, goal);
     if (!createResult.success || !createResult.data) {
         return errorResponse("start", createResult.error || "피처 생성에 실패했습니다");
     }
-    // 생성된 피처를 활성화
     const switchResult = await core.switchFeature(basePath, createResult.data.id);
     if (!switchResult.success) {
         return errorResponse("start", switchResult.error || "피처 활성화에 실패했습니다");
@@ -123,16 +95,10 @@ async function handleStart(basePath, name, goal) {
         status: "active"
     });
 }
-/**
- * 피처 전환
- *
- * ID 또는 이름으로 피처를 찾아 전환합니다.
- */
 async function handleSwitch(basePath, id, name) {
     if (!id && !name) {
         return errorResponse("switch", "피처 ID(id) 또는 이름(name)을 입력해주세요");
     }
-    // ID가 없으면 이름으로 피처 찾기
     let featureId = id;
     if (!featureId && name) {
         const listResult = await core.listFeatures(basePath);
@@ -158,9 +124,6 @@ async function handleSwitch(basePath, id, name) {
         files: result.data.files
     });
 }
-/**
- * 현재 상태 표시
- */
 async function handleStatus(basePath) {
     const activeResult = await core.getActiveFeature(basePath);
     if (!activeResult.success) {
@@ -184,12 +147,8 @@ async function handleStatus(basePath) {
         blockers: feature.blockers
     });
 }
-/**
- * 피처 완료
- */
 async function handleDone(basePath, id) {
     let featureId = id;
-    // ID가 없으면 현재 활성 피처 사용
     if (!featureId) {
         const activeResult = await core.getActiveFeature(basePath);
         if (!activeResult.success) {
@@ -212,14 +171,10 @@ async function handleDone(basePath, id) {
         totalFiles: result.data.files.length
     });
 }
-/**
- * 파일 추가
- */
 async function handleAdd(basePath, file) {
     if (!file || file.trim().length === 0) {
         return errorResponse("add", "추가할 파일 경로(file)를 입력해주세요. 예: file=\"src/auth/oauth.ts\"");
     }
-    // 활성 피처 확인
     const activeResult = await core.getActiveFeature(basePath);
     if (!activeResult.success) {
         return errorResponse("add", activeResult.error || "활성 피처 조회에 실패했습니다");
@@ -237,14 +192,10 @@ async function handleAdd(basePath, file) {
         fileCount: result.data.files.length
     });
 }
-/**
- * 파일 제거
- */
 async function handleDrop(basePath, file) {
     if (!file || file.trim().length === 0) {
         return errorResponse("drop", "제거할 파일 경로(file)를 입력해주세요. 예: file=\"src/old-file.ts\"");
     }
-    // 활성 피처 확인
     const activeResult = await core.getActiveFeature(basePath);
     if (!activeResult.success) {
         return errorResponse("drop", activeResult.error || "활성 피처 조회에 실패했습니다");
@@ -262,14 +213,10 @@ async function handleDrop(basePath, file) {
         fileCount: result.data.files.length
     });
 }
-/**
- * 목표 변경
- */
 async function handleGoal(basePath, goal) {
     if (!goal || goal.trim().length === 0) {
         return errorResponse("goal", "새 목표(goal)를 입력해주세요. 예: goal=\"OAuth 로그인 + 소셜 연동\"");
     }
-    // 활성 피처 확인
     const activeResult = await core.getActiveFeature(basePath);
     if (!activeResult.success) {
         return errorResponse("goal", activeResult.error || "활성 피처 조회에 실패했습니다");
@@ -287,9 +234,6 @@ async function handleGoal(basePath, goal) {
         newGoal: result.data.goal
     });
 }
-/**
- * 모든 피처 목록
- */
 async function handleList(basePath) {
     const listResult = await core.listFeatures(basePath);
     if (!listResult.success || !listResult.data) {
@@ -302,7 +246,6 @@ async function handleList(basePath) {
             features: []
         });
     }
-    // 활성 피처 확인
     const projectResult = await core.getProjectContext(basePath);
     const activeId = projectResult.success && projectResult.data
         ? projectResult.data.activeFeatureId
@@ -316,7 +259,6 @@ async function handleList(basePath) {
         fileCount: f.files.length,
         updatedAt: f.updatedAt
     }));
-    // 상태별 카운트
     const counts = {
         active: features.filter(f => f.status === "active").length,
         paused: features.filter(f => f.status === "paused").length,

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

@@ -1,5 +1,2 @@
-/**
- * Mask Save Tool - Save effective masks to library
- */
 import type { ToolFactory } from "../types.js";
 export declare function createMaskSaveTool(): ToolFactory;

package/dist/plugin/tools/maskSave.js

@@ -1,6 +1,3 @@
-/**
- * Mask Save Tool - Save effective masks to library
- */
 import { z } from "zod";
 import { saveMask } from "../../retrospect/index.js";
 export function createMaskSaveTool() {

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

@@ -1,6 +1,3 @@
-/**
- * Memory Get Tool - Read memory file contents
- */
 import { z } from "zod";
 import type { ToolFactory } from '../types.js';
 export declare const memoryGetSchema: z.ZodObject<{

package/dist/plugin/tools/memoryGet.js

@@ -1,6 +1,3 @@
-/**
- * Memory Get Tool - Read memory file contents
- */
 import { z } from "zod";
 import { existsSync, readFileSync } from 'fs';
 export const memoryGetSchema = z.object({

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

@@ -1,5 +1,2 @@
-/**
- * Memory Indexer Tool - Index memory files for semantic search
- */
 import type { ToolFactory } from "../types.js";
 export declare function createMemoryIndexerTool(): ToolFactory;

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;