maskweaver 0.9.3 → 0.9.5

package/dist/retrospect/types.js

@@ -1,8 +1 @@
-/**
- * Retrospect Type Definitions
- *
- * 회고 시스템의 타입 정의
- *
- * "Make the types express intent" - Kent Beck
- */
 export {};

package/dist/shared/config.d.ts

@@ -1,61 +1,27 @@
 import type { LogLevel } from "./types.js";
-/**
- * Memory provider types
- */
 export type MemoryProviderType = "ollama" | "openai" | "voyage" | "openrouter" | "text-only";
-/**
- * Verify mode
- */
 export type VerifyMode = "auto" | "manual" | "off";
-/**
- * Reviewer types for verification
- */
 export type ReviewerType = "dummy-flash" | "dummy-human" | "dummy-premium";
-/**
- * Retrospect depth levels
- */
 export type RetrospectDepth = "quick" | "standard" | "deep";
-/**
- * Configuration for the Context feature (always enabled)
- */
 export interface ContextConfig {
     enabled: true;
 }
-/**
- * Configuration for the Memory feature
- */
 export interface MemoryConfig {
     enabled: boolean;
     provider: MemoryProviderType;
 }
-/**
- * Configuration for the Retrospect feature
- */
 export interface RetrospectConfig {
     enabled: boolean;
 }
-/**
- * Configuration for the Verify feature
- */
 export interface VerifyConfig {
     enabled: boolean;
 }
-/**
- * Feature configuration map
- */
 export interface FeaturesConfig {
-    /** Context is always enabled */
     context: ContextConfig;
-    /** Memory is optional */
     memory?: MemoryConfig;
-    /** Retrospect is optional */
     retrospect?: RetrospectConfig;
-    /** Verify is optional */
     verify?: VerifyConfig;
 }
-/**
- * Memory provider-specific configurations
- */
 export interface MemoryProviderConfigs {
     provider: MemoryProviderType;
     vectorStore?: {
@@ -86,9 +52,6 @@ export interface MemoryProviderConfigs {
         keywordWeight: number;
     };
 }
-/**
- * Verification configuration
- */
 export interface VerifyConfigOptions {
     mode: VerifyMode;
     reviewer: ReviewerType;
@@ -104,32 +67,16 @@ export interface VerifyConfigOptions {
         onTestFail?: boolean;
     };
 }
-/**
- * Logging configuration
- */
 export interface LoggingConfig {
     level: LogLevel;
 }
-/**
- * Main Maskweaver configuration
- */
 export interface MaskweaverConfig {
-    /** Feature toggles */
     features: FeaturesConfig;
-    /** Memory system configuration */
     memory?: MemoryProviderConfigs;
-    /** Verification system configuration */
     verify?: VerifyConfigOptions;
-    /** Logging configuration */
     logging?: LoggingConfig;
 }
-/**
- * Default configuration
- */
 export declare const DEFAULT_CONFIG: MaskweaverConfig;
-/**
- * Runtime memory configuration from maskweaver.config.json
- */
 export interface RuntimeMemoryConfig {
     provider: MemoryProviderType;
     model?: string;
@@ -137,9 +84,6 @@ export interface RuntimeMemoryConfig {
     enabled?: boolean;
     baseUrl?: string;
 }
-/**
- * Runtime GDC integration configuration from maskweaver.config.json
- */
 export interface RuntimeGdcConfig {
     enabled?: boolean | 'auto';
     strictVerify?: boolean;
@@ -163,82 +107,33 @@ export interface RuntimeConfig {
     gdc?: RuntimeGdcConfig;
     language?: string;
 }
-/** Cost tier for budget-aware scheduling */
 export type ModelCostTier = 'low' | 'medium' | 'high';
-/** Agent tier mapping */
 export type ModelTier = 'flash' | 'human' | 'premium';
-/** Known capability tags for task-model matching */
 export type ModelCapability = 'search' | 'formatting' | 'simple-coding' | 'file-ops' | 'coding' | 'testing' | 'refactoring' | 'architecture' | 'debugging' | 'reasoning' | 'complex-coding' | 'frontend' | 'backend' | 'database' | 'devops' | 'ml' | string;
-/**
- * A single model entry in the pool.
- * Each entry represents one AI model subscription the user has access to.
- */
 export interface ModelPoolEntry {
-    /** Unique identifier for this model slot (e.g., "gemini-flash", "claude-opus") */
     id: string;
-    /** Full model name as used by the provider (e.g., "google/antigravity-gemini-3-flash") */
     model: string;
-    /** Which agent tier this model maps to */
     tier: ModelTier;
-    /** Maximum concurrent uses allowed (API/subscription limit) */
     maxConcurrent: number;
-    /** Task capabilities this model excels at */
     capabilities: ModelCapability[];
-    /** Cost tier for budget-aware scheduling */
     costTier: ModelCostTier;
-    /** Human-readable description */
     description?: string;
 }
-/**
- * DummyHumans configuration.
- * Supports two formats:
- * - Legacy: Record<string, string> mapping tier names to model IDs
- * - Pool:   { pool: ModelPoolEntry[] } with detailed model definitions
- */
 export type DummyHumansConfig = Record<string, string> | {
     pool: ModelPoolEntry[];
 };
-/** Type guard for pool format */
 export declare function isPoolConfig(config: DummyHumansConfig): config is {
     pool: ModelPoolEntry[];
 };
-/**
- * Normalize legacy config to pool entries.
- * Converts { flash: "model-a", human: "model-b", premium: "model-c" }
- * into ModelPoolEntry[] with sensible defaults.
- */
 export declare function normalizeDummyHumansConfig(config: DummyHumansConfig): ModelPoolEntry[];
-/**
- * Runtime configuration from maskweaver.config.json
- */
 export interface RuntimeConfig {
     dummyHumans?: DummyHumansConfig;
     memory?: RuntimeMemoryConfig;
     gdc?: RuntimeGdcConfig;
     language?: string;
 }
-/**
- * Load maskweaver.config.json from project root or global config
- *
- * Searches in order:
- * 1. {basePath}/maskweaver.config.json
- * 2. {basePath}/.opencode/maskweaver.config.json
- * 3. ~/.config/opencode/maskweaver.config.json (global fallback)
- */
 export declare function loadRuntimeConfig(basePath?: string): RuntimeConfig;
-/**
- * Get memory provider configuration from runtime config
- */
 export declare function getMemoryProviderConfig(basePath?: string): RuntimeMemoryConfig | undefined;
-/**
- * Get GDC integration configuration from runtime config
- */
 export declare function getGdcConfig(basePath?: string): RuntimeGdcConfig | undefined;
-/**
- * Get operator model configuration from runtime config
- */
 export declare function getOperatorConfig(basePath?: string): RuntimeOperatorConfig | undefined;
-/**
- * Clear cached runtime config (for testing)
- */
 export declare function clearRuntimeConfigCache(): void;

package/dist/shared/config.js

@@ -1,9 +1,6 @@
 import * as fs from "node:fs";
 import * as os from "node:os";
 import * as path from "node:path";
-/**
- * Default configuration
- */
 export const DEFAULT_CONFIG = {
     features: {
         context: { enabled: true },
@@ -12,24 +9,16 @@ export const DEFAULT_CONFIG = {
         level: "info",
     },
 };
-/** Type guard for pool format */
 export function isPoolConfig(config) {
     return 'pool' in config && Array.isArray(config.pool);
 }
-/**
- * Normalize legacy config to pool entries.
- * Converts { flash: "model-a", human: "model-b", premium: "model-c" }
- * into ModelPoolEntry[] with sensible defaults.
- */
 export function normalizeDummyHumansConfig(config) {
-    // Defensive guard: if called with null/undefined at runtime, return empty
     if (!config || typeof config !== 'object') {
         return [];
     }
     if (isPoolConfig(config)) {
         return config.pool;
     }
-    // Legacy format → convert to pool entries
     const tierDefaults = {
         flash: { tier: 'flash', costTier: 'low', maxConcurrent: 5, capabilities: ['search', 'formatting', 'simple-coding', 'file-ops'] },
         human: { tier: 'human', costTier: 'medium', maxConcurrent: 2, capabilities: ['coding', 'testing', 'refactoring'] },
@@ -48,16 +37,7 @@ export function normalizeDummyHumansConfig(config) {
 }
 let cachedRuntimeConfig = null;
 let cachedConfigPath = null;
-/**
- * Load maskweaver.config.json from project root or global config
- *
- * Searches in order:
- * 1. {basePath}/maskweaver.config.json
- * 2. {basePath}/.opencode/maskweaver.config.json
- * 3. ~/.config/opencode/maskweaver.config.json (global fallback)
- */
 export function loadRuntimeConfig(basePath = process.cwd()) {
-    // Return cached config if same path
     if (cachedRuntimeConfig && cachedConfigPath === basePath) {
         return cachedRuntimeConfig;
     }
@@ -80,35 +60,22 @@ export function loadRuntimeConfig(basePath = process.cwd()) {
             }
         }
     }
-    // Return empty config if not found
     cachedRuntimeConfig = {};
     cachedConfigPath = basePath;
     return {};
 }
-/**
- * Get memory provider configuration from runtime config
- */
 export function getMemoryProviderConfig(basePath = process.cwd()) {
     const config = loadRuntimeConfig(basePath);
     return config.memory;
 }
-/**
- * Get GDC integration configuration from runtime config
- */
 export function getGdcConfig(basePath = process.cwd()) {
     const config = loadRuntimeConfig(basePath);
     return config.gdc;
 }
-/**
- * Get operator model configuration from runtime config
- */
 export function getOperatorConfig(basePath = process.cwd()) {
     const config = loadRuntimeConfig(basePath);
     return config.operator;
 }
-/**
- * Clear cached runtime config (for testing)
- */
 export function clearRuntimeConfigCache() {
     cachedRuntimeConfig = null;
     cachedConfigPath = null;

package/dist/shared/errors.d.ts

@@ -1,35 +1,17 @@
-/**
- * Error handling for Maskweaver
- */
-/**
- * Base error class for all Maskweaver errors
- */
 export declare class MaskweaverError extends Error {
     readonly code?: string | undefined;
     readonly context?: Record<string, unknown> | undefined;
     constructor(message: string, code?: string | undefined, context?: Record<string, unknown> | undefined);
 }
-/**
- * Configuration error
- */
 export declare class ConfigError extends MaskweaverError {
     constructor(message: string, context?: Record<string, unknown>);
 }
-/**
- * Provider error (for memory providers, etc.)
- */
 export declare class ProviderError extends MaskweaverError {
     constructor(message: string, context?: Record<string, unknown>);
 }
-/**
- * Storage error
- */
 export declare class StorageError extends MaskweaverError {
     constructor(message: string, context?: Record<string, unknown>);
 }
-/**
- * Validation error
- */
 export declare class ValidationError extends MaskweaverError {
     constructor(message: string, context?: Record<string, unknown>);
 }

package/dist/shared/errors.js

@@ -1,9 +1,3 @@
-/**
- * Error handling for Maskweaver
- */
-/**
- * Base error class for all Maskweaver errors
- */
 export class MaskweaverError extends Error {
     code;
     context;
@@ -12,42 +6,29 @@ export class MaskweaverError extends Error {
         this.code = code;
         this.context = context;
         this.name = "MaskweaverError";
-        // Maintains proper stack trace for where our error was thrown (only available on V8)
         if (Error.captureStackTrace) {
             Error.captureStackTrace(this, MaskweaverError);
         }
     }
 }
-/**
- * Configuration error
- */
 export class ConfigError extends MaskweaverError {
     constructor(message, context) {
         super(message, "CONFIG_ERROR", context);
         this.name = "ConfigError";
     }
 }
-/**
- * Provider error (for memory providers, etc.)
- */
 export class ProviderError extends MaskweaverError {
     constructor(message, context) {
         super(message, "PROVIDER_ERROR", context);
         this.name = "ProviderError";
     }
 }
-/**
- * Storage error
- */
 export class StorageError extends MaskweaverError {
     constructor(message, context) {
         super(message, "STORAGE_ERROR", context);
         this.name = "StorageError";
     }
 }
-/**
- * Validation error
- */
 export class ValidationError extends MaskweaverError {
     constructor(message, context) {
         super(message, "VALIDATION_ERROR", context);

package/dist/shared/generate-agents.d.ts

@@ -1,65 +1,22 @@
-/**
- * Generate Agent Files from Pool Configuration
- *
- * Shared utility to create/update dummy-human agent .md files from
- * maskweaver.config.json pool entries. Used by both:
- * - Plugin startup (auto-generate if not exists)
- * - `weave sync-agents` command (force overwrite from user config)
- */
 import type { ModelPoolEntry } from './config.js';
 export interface GenerateAgentsResult {
-    /** Files that were created (did not exist before) */
     created: string[];
-    /** Files that were updated (existed and were overwritten) */
     updated: string[];
-    /** Files that were skipped (existed and force was false) */
     skipped: string[];
-    /** Error messages */
     errors: string[];
 }
 export interface GenerateAgentsOptions {
-    /** Force overwrite existing files (default: false) */
     force?: boolean;
-    /** Base project directory */
     projectDir?: string;
-    /** Custom agents output directory (default: {projectDir}/.opencode/agents) */
     agentsDir?: string;
-    /** Custom pool entries (if not provided, reads from config) */
     pool?: ModelPoolEntry[];
 }
-/**
- * Generate agent files from a ModelPoolEntry array.
- *
- * @param pool - Array of model pool entries
- * @param agentsDir - Output directory for agent .md files
- * @param options - Force overwrite option
- * @returns Result summary
- */
 export declare function generatePoolAgentFiles(pool: ModelPoolEntry[], agentsDir: string, options?: {
     force?: boolean;
 }): GenerateAgentsResult;
-/**
- * Read maskweaver.config.json (project or global) and generate agent files.
- *
- * Search order:
- * 1. {projectDir}/maskweaver.config.json
- * 2. {projectDir}/.opencode/maskweaver.config.json
- * 3. ~/.config/opencode/maskweaver.config.json (user global)
- *
- * @param projectDir - Project base directory
- * @param agentsDir - Output directory for agent .md files
- * @param options - Force overwrite and other options
- * @returns Result summary
- */
 export declare function generatePoolAgentFilesFromConfig(projectDir: string, agentsDir: string, options?: {
     force?: boolean;
 }): GenerateAgentsResult;
-/**
- * Default runtime config template (maskweaver.config.json).
- *
- * This is a minimal template with the standard tier entries but WITHOUT
- * model names — users must fill in their actual model IDs.
- */
 export declare const DEFAULT_RUNTIME_CONFIG_TEMPLATE: {
     readonly dummyHumans: {
         readonly pool: readonly [{
@@ -120,9 +77,6 @@ export declare const DEFAULT_RUNTIME_CONFIG_TEMPLATE: {
     };
     readonly language: "ko";
 };
-/**
- * Default plugin config template (.opencode/maskweaver.json).
- */
 export declare const DEFAULT_PLUGIN_CONFIG_TEMPLATE: {
     $schema: string;
     masks: {
@@ -137,29 +91,6 @@ export declare const DEFAULT_PLUGIN_CONFIG_TEMPLATE: {
         };
     };
 };
-/**
- * Write a default maskweaver.config.json to the project directory.
- * Does NOT overwrite if the file already exists.
- *
- * @param projectDir - Project base directory
- * @returns The path to the created file, or null if it already existed
- */
 export declare function writeDefaultRuntimeConfig(projectDir: string): string | null;
-/**
- * Write a default .opencode/maskweaver.json (plugin config) to the project.
- * Does NOT overwrite if the file already exists.
- *
- * @param projectDir - Project base directory
- * @returns The path to the created file, or null if it already existed
- */
 export declare function writeDefaultPluginConfig(projectDir: string): string | null;
-/**
- * Check if a user-level config exists at ~/.config/opencode/ and return it.
- *
- * Search order:
- * 1. ~/.config/opencode/maskweaver.config.json
- * 2. ~/.config/opencode/maskweaver.json (plugin config with agents)
- *
- * @returns The config path if found, or null
- */
 export declare function findUserGlobalConfig(): string | null;

package/dist/shared/generate-agents.js

@@ -1,21 +1,7 @@
-/**
- * Generate Agent Files from Pool Configuration
- *
- * Shared utility to create/update dummy-human agent .md files from
- * maskweaver.config.json pool entries. Used by both:
- * - Plugin startup (auto-generate if not exists)
- * - `weave sync-agents` command (force overwrite from user config)
- */
 import * as fs from 'node:fs';
 import * as path from 'node:path';
 import * as os from 'node:os';
 import { loadRuntimeConfig, normalizeDummyHumansConfig } from './config.js';
-// ============================================================================
-// Agent File Template
-// ============================================================================
-/**
- * Generate the content for a dummy-human agent .md file
- */
 function buildAgentFileContent(entry) {
     const lines = [
         '---',
@@ -34,17 +20,6 @@ function buildAgentFileContent(entry) {
     ];
     return lines.join('\n');
 }
-// ============================================================================
-// Agent File Generation
-// ============================================================================
-/**
- * Generate agent files from a ModelPoolEntry array.
- *
- * @param pool - Array of model pool entries
- * @param agentsDir - Output directory for agent .md files
- * @param options - Force overwrite option
- * @returns Result summary
- */
 export function generatePoolAgentFiles(pool, agentsDir, options = {}) {
     const result = {
         created: [],
@@ -56,7 +31,6 @@ export function generatePoolAgentFiles(pool, agentsDir, options = {}) {
         result.errors.push('Pool is empty or undefined. No agents to generate.');
         return result;
     }
-    // Ensure agents directory exists
     if (!fs.existsSync(agentsDir)) {
         try {
             fs.mkdirSync(agentsDir, { recursive: true });
@@ -74,7 +48,6 @@ export function generatePoolAgentFiles(pool, agentsDir, options = {}) {
             result.skipped.push(agentPath);
             continue;
         }
-        // Validate: model must not be empty
         if (!entry.model || entry.model.trim() === '') {
             result.errors.push(`Entry "${entry.id}" has no model configured. Skipping.`);
             continue;
@@ -95,24 +68,7 @@ export function generatePoolAgentFiles(pool, agentsDir, options = {}) {
     }
     return result;
 }
-// ============================================================================
-// Config-Based Agent Generation
-// ============================================================================
-/**
- * Read maskweaver.config.json (project or global) and generate agent files.
- *
- * Search order:
- * 1. {projectDir}/maskweaver.config.json
- * 2. {projectDir}/.opencode/maskweaver.config.json
- * 3. ~/.config/opencode/maskweaver.config.json (user global)
- *
- * @param projectDir - Project base directory
- * @param agentsDir - Output directory for agent .md files
- * @param options - Force overwrite and other options
- * @returns Result summary
- */
 export function generatePoolAgentFilesFromConfig(projectDir, agentsDir, options = {}) {
-    // Try project config first
     const projectConfig = loadRuntimeConfig(projectDir);
     if (projectConfig.dummyHumans) {
         const pool = normalizeDummyHumansConfig(projectConfig.dummyHumans);
@@ -120,7 +76,6 @@ export function generatePoolAgentFilesFromConfig(projectDir, agentsDir, options
             return generatePoolAgentFiles(pool, agentsDir, options);
         }
     }
-    // Try user global config (~/.config/opencode/maskweaver.config.json)
     const homeDir = os.homedir();
     const globalConfigPath = path.join(homeDir, '.config', 'opencode', 'maskweaver.config.json');
     if (fs.existsSync(globalConfigPath)) {
@@ -145,15 +100,6 @@ export function generatePoolAgentFilesFromConfig(projectDir, agentsDir, options
         errors: ['No maskweaver.config.json found with dummyHumans configuration. Create one or run `weave init-config` to generate a default.'],
     };
 }
-// ============================================================================
-// Default Config File Creator
-// ============================================================================
-/**
- * Default runtime config template (maskweaver.config.json).
- *
- * This is a minimal template with the standard tier entries but WITHOUT
- * model names — users must fill in their actual model IDs.
- */
 export const DEFAULT_RUNTIME_CONFIG_TEMPLATE = {
     dummyHumans: {
         pool: [
@@ -220,9 +166,6 @@ export const DEFAULT_RUNTIME_CONFIG_TEMPLATE = {
     },
     language: 'ko',
 };
-/**
- * Default plugin config template (.opencode/maskweaver.json).
- */
 export const DEFAULT_PLUGIN_CONFIG_TEMPLATE = {
     $schema: 'https://raw.githubusercontent.com/ulgerang/maskweaver/master/schemas/plugin-config.json',
     masks: {
@@ -237,17 +180,10 @@ export const DEFAULT_PLUGIN_CONFIG_TEMPLATE = {
         },
     },
 };
-/**
- * Write a default maskweaver.config.json to the project directory.
- * Does NOT overwrite if the file already exists.
- *
- * @param projectDir - Project base directory
- * @returns The path to the created file, or null if it already existed
- */
 export function writeDefaultRuntimeConfig(projectDir) {
     const targetPath = path.join(projectDir, 'maskweaver.config.json');
     if (fs.existsSync(targetPath)) {
-        return null; // Already exists, don't overwrite
+        return null;
     }
     try {
         fs.writeFileSync(targetPath, JSON.stringify(DEFAULT_RUNTIME_CONFIG_TEMPLATE, null, 2) + '\n', 'utf-8');
@@ -257,20 +193,12 @@ export function writeDefaultRuntimeConfig(projectDir) {
         return null;
     }
 }
-/**
- * Write a default .opencode/maskweaver.json (plugin config) to the project.
- * Does NOT overwrite if the file already exists.
- *
- * @param projectDir - Project base directory
- * @returns The path to the created file, or null if it already existed
- */
 export function writeDefaultPluginConfig(projectDir) {
     const opencodeDir = path.join(projectDir, '.opencode');
     const targetPath = path.join(opencodeDir, 'maskweaver.json');
     if (fs.existsSync(targetPath)) {
-        return null; // Already exists, don't overwrite
+        return null;
     }
-    // Ensure .opencode directory exists
     if (!fs.existsSync(opencodeDir)) {
         try {
             fs.mkdirSync(opencodeDir, { recursive: true });
@@ -287,18 +215,6 @@ export function writeDefaultPluginConfig(projectDir) {
         return null;
     }
 }
-// ============================================================================
-// User Config Detection
-// ============================================================================
-/**
- * Check if a user-level config exists at ~/.config/opencode/ and return it.
- *
- * Search order:
- * 1. ~/.config/opencode/maskweaver.config.json
- * 2. ~/.config/opencode/maskweaver.json (plugin config with agents)
- *
- * @returns The config path if found, or null
- */
 export function findUserGlobalConfig() {
     const homeDir = os.homedir();
     const candidates = [