maskweaver 0.9.4 → 0.9.6

package/dist/retrospect/retrospect.js

@@ -1,42 +1,16 @@
-/**
- * Retrospect Core
- *
- * 회고 시스템의 메인 로직
- *
- * "Each function has one clear purpose" - Kent Beck
- */
 import { join } from 'path';
 import { existsSync, readFileSync, writeFileSync, mkdirSync } from 'fs';
 import { selectStrategy } from './strategies/index.js';
-// ============================================================================
-// Constants
-// ============================================================================
 const RETROSPECT_SECTION_HEADER = '## 회고 기록';
-// ============================================================================
-// Path Utilities
-// ============================================================================
-/**
- * 메모리 경로 반환
- */
 function getMemoryPath(type, basePath) {
     return join(basePath, '.opencode', 'memory', `${type.toUpperCase()}.md`);
 }
-/**
- * DB 경로 반환
- */
 function getDbPath(basePath) {
     return join(basePath, '.opencode', 'memory', 'memory.db');
 }
-// ============================================================================
-// File Operations
-// ============================================================================
-/**
- * RETROSPECT.md 파일 읽기
- */
 function readRetrospectFile(basePath) {
     const retrospectPath = getMemoryPath('retrospect', basePath);
     if (!existsSync(retrospectPath)) {
-        // 기본 템플릿 반환
         return `# 회고록 (Retrospective Journal)
 
 이 파일은 가면술사의 회고와 성찰을 기록합니다.
@@ -50,9 +24,6 @@ ${RETROSPECT_SECTION_HEADER}
     }
     return readFileSync(retrospectPath, 'utf-8');
 }
-/**
- * RETROSPECT.md 파일 쓰기
- */
 function writeRetrospectFile(basePath, content) {
     const retrospectPath = getMemoryPath('retrospect', basePath);
     const dir = join(basePath, '.opencode', 'memory');
@@ -61,12 +32,6 @@ function writeRetrospectFile(basePath, content) {
     }
     writeFileSync(retrospectPath, content, 'utf-8');
 }
-/**
- * 회고 내용을 파일에 추가
- *
- * 회고 기록 섹션 바로 다음에 새 회고를 추가합니다.
- * (최신 회고가 위에 오도록)
- */
 function appendRetrospect(content, retrospectContent) {
     const sectionIndex = content.indexOf(RETROSPECT_SECTION_HEADER);
     if (sectionIndex !== -1) {
@@ -75,30 +40,19 @@ function appendRetrospect(content, retrospectContent) {
         const after = content.slice(insertPosition);
         return `${before}\n\n${retrospectContent}${after}`;
     }
-    // 섹션이 없으면 끝에 추가
     return `${content}\n${RETROSPECT_SECTION_HEADER}\n\n${retrospectContent}`;
 }
-// ============================================================================
-// Statistics
-// ============================================================================
-/**
- * 평균 효과성 계산
- */
 function calculateAverageEffectiveness(masks) {
     if (masks.length === 0)
         return 0;
     const sum = masks.reduce((acc, mask) => acc + mask.effectiveness, 0);
     return sum / masks.length;
 }
-/**
- * 회고 요약 통계 계산
- */
 function calculateSummaryStats(input) {
     const masksUsed = input.masksUsed?.length ?? 0;
     const avgEffectiveness = input.masksUsed && input.masksUsed.length > 0
         ? calculateAverageEffectiveness(input.masksUsed)
         : 0;
-    // 작업 수는 요약에서 줄바꿈으로 대략 추정
     const summaryText = input.summary ?? '';
     const tasksCompleted = summaryText.split('\n').filter(l => l.trim().startsWith('-')).length || 1;
     return {
@@ -107,29 +61,15 @@ function calculateSummaryStats(input) {
         averageEffectiveness: Math.round(avgEffectiveness * 10) / 10
     };
 }
-// ============================================================================
-// Main Retrospect Function
-// ============================================================================
-/**
- * 회고 수행
- *
- * "Make it work, make it right, make it fast" - Kent Beck
- */
 export function performRetrospect(basePath, input) {
     try {
         const depth = input.depth ?? 'standard';
-        // 1. 전략 선택
         const strategy = selectStrategy(depth);
-        // 2. 회고 내용 생성
         const retrospectContent = strategy.generateContent(input);
-        // 3. RETROSPECT.md 읽기 및 업데이트
         let content = readRetrospectFile(basePath);
         content = appendRetrospect(content, retrospectContent);
-        // 4. 파일 저장
         writeRetrospectFile(basePath, content);
-        // 5. 통계 계산
         const summaryStats = calculateSummaryStats(input);
-        // 6. 결과 반환
         const retrospectPath = getMemoryPath('retrospect', basePath);
         const TRIGGER_LABELS = {
             manual: '수동 요청',
@@ -158,7 +98,4 @@ export function performRetrospect(basePath, input) {
         };
     }
 }
-// ============================================================================
-// Export Path Utilities (for mask-save)
-// ============================================================================
 export { getMemoryPath, getDbPath };

package/dist/retrospect/strategies/base.d.ts

@@ -1,19 +1,4 @@
-/**
- * Retrospect Strategy Pattern
- *
- * 회고 깊이에 따른 전략 패턴
- *
- * "Use patterns when they make code clearer" - Kent Beck
- */
 import type { RetrospectInput } from '../types.js';
-/**
- * 전략 패턴: 회고 깊이에 따른 마크다운 생성
- *
- * 이 패턴을 선택한 이유:
- * - 각 깊이의 로직이 명확히 분리됨
- * - 새로운 깊이 추가가 용이
- * - 조건문 중첩 방지
- */
 export interface RetrospectStrategy {
     generateContent(input: RetrospectInput): string;
 }

package/dist/retrospect/strategies/base.js

@@ -1,8 +1 @@
-/**
- * Retrospect Strategy Pattern
- *
- * 회고 깊이에 따른 전략 패턴
- *
- * "Use patterns when they make code clearer" - Kent Beck
- */
 export {};

package/dist/retrospect/strategies/deep.d.ts

@@ -1,17 +1,5 @@
-/**
- * Deep Retrospect Strategy
- *
- * 심층 회고: 전체 정보 + 통계 + 교훈
- *
- * "Reflect deeply on what matters" - Kent Beck
- */
 import type { RetrospectInput } from '../types.js';
 import type { RetrospectStrategy } from './base.js';
-/**
- * Deep 회고 전략
- *
- * 가장 상세한 회고. 모든 정보와 통계, 교훈까지 기록합니다.
- */
 export declare class DeepRetrospectStrategy implements RetrospectStrategy {
     generateContent(input: RetrospectInput): string;
 }

package/dist/retrospect/strategies/deep.js

@@ -1,10 +1,3 @@
-/**
- * Deep Retrospect Strategy
- *
- * 심층 회고: 전체 정보 + 통계 + 교훈
- *
- * "Reflect deeply on what matters" - Kent Beck
- */
 function formatTimestamp() {
     const now = new Date();
     const year = now.getFullYear();
@@ -19,9 +12,6 @@ const TRIGGER_LABELS = {
     session_end: '세션 종료',
     periodic: '주기적 회고'
 };
-/**
- * 효과성 점수에 따른 라벨 반환
- */
 function getEffectivenessLabel(score) {
     if (score >= 90)
         return '매우 효과적';
@@ -33,20 +23,12 @@ function getEffectivenessLabel(score) {
         return '개선 필요';
     return '재고 필요';
 }
-/**
- * 평균 효과성 계산
- */
 function calculateAverageEffectiveness(masks) {
     if (masks.length === 0)
         return 0;
     const sum = masks.reduce((acc, mask) => acc + mask.effectiveness, 0);
     return sum / masks.length;
 }
-/**
- * Deep 회고 전략
- *
- * 가장 상세한 회고. 모든 정보와 통계, 교훈까지 기록합니다.
- */
 export class DeepRetrospectStrategy {
     generateContent(input) {
         const timestamp = formatTimestamp();
@@ -58,7 +40,6 @@ export class DeepRetrospectStrategy {
             input.summary ?? '(요약 없음)',
             ''
         ];
-        // 가면 사용 정보 - 상세
         if (input.masksUsed && input.masksUsed.length > 0) {
             lines.push('#### 사용한 가면');
             for (const mask of input.masksUsed) {
@@ -67,12 +48,10 @@ export class DeepRetrospectStrategy {
                 lines.push(`  - 평가: ${getEffectivenessLabel(mask.effectiveness)}`);
             }
             lines.push('');
-            // 가면 사용 통계
             const avgEffectiveness = calculateAverageEffectiveness(input.masksUsed);
             lines.push(`> 가면 사용 통계: ${input.masksUsed.length}개 사용, 평균 효과성 ${avgEffectiveness.toFixed(1)}/100`);
             lines.push('');
         }
-        // 잘된 점
         if (input.wellDone && input.wellDone.length > 0) {
             lines.push('#### 잘된 점');
             for (const item of input.wellDone) {
@@ -80,7 +59,6 @@ export class DeepRetrospectStrategy {
             }
             lines.push('');
         }
-        // 개선할 점
         if (input.improvements && input.improvements.length > 0) {
             lines.push('#### 개선할 점');
             for (const item of input.improvements) {
@@ -88,7 +66,6 @@ export class DeepRetrospectStrategy {
             }
             lines.push('');
         }
-        // 배운 교훈 - 심층 회고에서만
         if (input.lessons && input.lessons.length > 0) {
             lines.push('#### 배운 교훈');
             for (const lesson of input.lessons) {
@@ -96,7 +73,6 @@ export class DeepRetrospectStrategy {
             }
             lines.push('');
         }
-        // 구분선
         lines.push('---');
         lines.push('');
         return lines.join('\n');

package/dist/retrospect/strategies/index.d.ts

@@ -1,17 +1,5 @@
-/**
- * Retrospect Strategies
- *
- * 전략 선택 및 export
- *
- * "Polymorphism beats switch statements" - Kent Beck
- */
 import type { RetrospectDepth } from '../types.js';
 import type { RetrospectStrategy } from './base.js';
-/**
- * 깊이에 따른 전략 선택
- *
- * "Choose the right tool for the job" - Kent Beck
- */
 export declare function selectStrategy(depth: RetrospectDepth): RetrospectStrategy;
 export type { RetrospectStrategy } from './base.js';
 export { QuickRetrospectStrategy } from './quick.js';

package/dist/retrospect/strategies/index.js

@@ -1,18 +1,6 @@
-/**
- * Retrospect Strategies
- *
- * 전략 선택 및 export
- *
- * "Polymorphism beats switch statements" - Kent Beck
- */
 import { QuickRetrospectStrategy } from './quick.js';
 import { StandardRetrospectStrategy } from './standard.js';
 import { DeepRetrospectStrategy } from './deep.js';
-/**
- * 깊이에 따른 전략 선택
- *
- * "Choose the right tool for the job" - Kent Beck
- */
 export function selectStrategy(depth) {
     const strategies = {
         quick: new QuickRetrospectStrategy(),

package/dist/retrospect/strategies/quick.d.ts

@@ -1,17 +1,5 @@
-/**
- * Quick Retrospect Strategy
- *
- * 요약만 기록하는 빠른 회고
- *
- * "Do the simplest thing that could possibly work" - Kent Beck
- */
 import type { RetrospectInput } from '../types.js';
 import type { RetrospectStrategy } from './base.js';
-/**
- * Quick 회고 전략
- *
- * 가장 간단한 회고. 요약과 가면 사용 정보만 기록합니다.
- */
 export declare class QuickRetrospectStrategy implements RetrospectStrategy {
     generateContent(input: RetrospectInput): string;
 }

package/dist/retrospect/strategies/quick.js

@@ -1,13 +1,3 @@
-/**
- * Quick Retrospect Strategy
- *
- * 요약만 기록하는 빠른 회고
- *
- * "Do the simplest thing that could possibly work" - Kent Beck
- */
-/**
- * 현재 시각을 포맷팅
- */
 function formatTimestamp() {
     const now = new Date();
     const year = now.getFullYear();
@@ -17,19 +7,11 @@ function formatTimestamp() {
     const minute = String(now.getMinutes()).padStart(2, '0');
     return `${year}-${month}-${day} ${hour}:${minute}`;
 }
-/**
- * 트리거 라벨
- */
 const TRIGGER_LABELS = {
     manual: '수동 요청',
     session_end: '세션 종료',
     periodic: '주기적 회고'
 };
-/**
- * Quick 회고 전략
- *
- * 가장 간단한 회고. 요약과 가면 사용 정보만 기록합니다.
- */
 export class QuickRetrospectStrategy {
     generateContent(input) {
         const timestamp = formatTimestamp();
@@ -41,7 +23,6 @@ export class QuickRetrospectStrategy {
             input.summary ?? '(요약 없음)',
             ''
         ];
-        // 가면 사용 정보가 있으면 간략히 추가
         if (input.masksUsed && input.masksUsed.length > 0) {
             lines.push('#### 사용한 가면');
             for (const mask of input.masksUsed) {

package/dist/retrospect/strategies/standard.d.ts

@@ -1,17 +1,5 @@
-/**
- * Standard Retrospect Strategy
- *
- * 표준 회고: 요약 + 가면 + 잘된 점/개선점
- *
- * "Make it work, make it right, make it fast" - Kent Beck
- */
 import type { RetrospectInput } from '../types.js';
 import type { RetrospectStrategy } from './base.js';
-/**
- * Standard 회고 전략
- *
- * 기본 회고. 작업 요약, 가면 사용, 잘된 점, 개선점을 기록합니다.
- */
 export declare class StandardRetrospectStrategy implements RetrospectStrategy {
     generateContent(input: RetrospectInput): string;
 }

package/dist/retrospect/strategies/standard.js

@@ -1,10 +1,3 @@
-/**
- * Standard Retrospect Strategy
- *
- * 표준 회고: 요약 + 가면 + 잘된 점/개선점
- *
- * "Make it work, make it right, make it fast" - Kent Beck
- */
 function formatTimestamp() {
     const now = new Date();
     const year = now.getFullYear();
@@ -19,11 +12,6 @@ const TRIGGER_LABELS = {
     session_end: '세션 종료',
     periodic: '주기적 회고'
 };
-/**
- * Standard 회고 전략
- *
- * 기본 회고. 작업 요약, 가면 사용, 잘된 점, 개선점을 기록합니다.
- */
 export class StandardRetrospectStrategy {
     generateContent(input) {
         const timestamp = formatTimestamp();
@@ -35,7 +23,6 @@ export class StandardRetrospectStrategy {
             input.summary ?? '(요약 없음)',
             ''
         ];
-        // 가면 사용 정보
         if (input.masksUsed && input.masksUsed.length > 0) {
             lines.push('#### 사용한 가면');
             for (const mask of input.masksUsed) {
@@ -44,7 +31,6 @@ export class StandardRetrospectStrategy {
             }
             lines.push('');
         }
-        // 잘된 점
         if (input.wellDone && input.wellDone.length > 0) {
             lines.push('#### 잘된 점');
             for (const item of input.wellDone) {
@@ -52,7 +38,6 @@ export class StandardRetrospectStrategy {
             }
             lines.push('');
         }
-        // 개선할 점
         if (input.improvements && input.improvements.length > 0) {
             lines.push('#### 개선할 점');
             for (const item of input.improvements) {

package/dist/retrospect/types.d.ts

@@ -1,10 +1,3 @@
-/**
- * Retrospect Type Definitions
- *
- * 회고 시스템의 타입 정의
- *
- * "Make the types express intent" - Kent Beck
- */
 export type RetrospectTrigger = 'manual' | 'session_end' | 'periodic';
 export type RetrospectDepth = 'quick' | 'standard' | 'deep';
 export interface MaskUsageRecord {

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;