maskweaver 0.9.3 → 0.9.5

package/dist/context/config.d.ts

@@ -1,10 +1,3 @@
-/**
- * Context Configuration
- *
- * 컨텍스트 시스템의 설정과 경로 유틸리티
- *
- * "Configuration should be obvious and in one place" - Kent Beck
- */
 export declare const CONTEXT_CONFIG: {
     readonly paths: {
         readonly contextDir: ".opencode/context";
@@ -15,23 +8,8 @@ export declare const CONTEXT_CONFIG: {
         readonly status: "active";
     };
 };
-/**
- * 컨텍스트 디렉토리 경로 반환
- */
 export declare function getContextDir(basePath: string): string;
-/**
- * 프로젝트 컨텍스트 파일 경로 반환
- */
 export declare function getProjectPath(basePath: string): string;
-/**
- * 피처 디렉토리 경로 반환
- */
 export declare function getFeaturesDir(basePath: string): string;
-/**
- * 특정 피처 파일 경로 반환
- */
 export declare function getFeaturePath(basePath: string, id: string): string;
-/**
- * 설정 내보내기 (외부 모듈에서 참조용)
- */
 export declare function getContextConfig(): typeof CONTEXT_CONFIG;

package/dist/context/config.js

@@ -1,14 +1,4 @@
-/**
- * Context Configuration
- *
- * 컨텍스트 시스템의 설정과 경로 유틸리티
- *
- * "Configuration should be obvious and in one place" - Kent Beck
- */
 import { join } from 'path';
-// ============================================================================
-// Configuration
-// ============================================================================
 export const CONTEXT_CONFIG = {
     paths: {
         contextDir: '.opencode/context',
@@ -19,36 +9,18 @@ export const CONTEXT_CONFIG = {
         status: 'active',
     },
 };
-// ============================================================================
-// Path Utilities
-// ============================================================================
-/**
- * 컨텍스트 디렉토리 경로 반환
- */
 export function getContextDir(basePath) {
     return join(basePath, CONTEXT_CONFIG.paths.contextDir);
 }
-/**
- * 프로젝트 컨텍스트 파일 경로 반환
- */
 export function getProjectPath(basePath) {
     return join(getContextDir(basePath), CONTEXT_CONFIG.paths.projectFile);
 }
-/**
- * 피처 디렉토리 경로 반환
- */
 export function getFeaturesDir(basePath) {
     return join(getContextDir(basePath), CONTEXT_CONFIG.paths.featuresDir);
 }
-/**
- * 특정 피처 파일 경로 반환
- */
 export function getFeaturePath(basePath, id) {
     return join(getFeaturesDir(basePath), `${id}.json`);
 }
-/**
- * 설정 내보내기 (외부 모듈에서 참조용)
- */
 export function getContextConfig() {
     return CONTEXT_CONFIG;
 }

package/dist/context/feature.d.ts

@@ -1,48 +1,9 @@
-/**
- * Feature Management
- *
- * 피처의 생성, 조회, 업데이트, 목록, 전환, 완료, 삭제
- *
- * "Keep functions small and focused" - Kent Beck
- */
 import type { FeatureContext, FeatureUpdate, Result } from './types.js';
-/**
- * 새로운 피처를 생성합니다.
- */
 export declare function createFeature(basePath: string, name: string, goal: string): Promise<Result<FeatureContext>>;
-/**
- * 특정 피처를 조회합니다.
- */
 export declare function getFeature(basePath: string, id: string): Promise<Result<FeatureContext>>;
-/**
- * 피처를 업데이트합니다.
- */
 export declare function updateFeature(basePath: string, id: string, updates: FeatureUpdate): Promise<Result<FeatureContext>>;
-/**
- * 모든 피처 목록을 반환합니다.
- */
 export declare function listFeatures(basePath: string): Promise<Result<FeatureContext[]>>;
-/**
- * 활성 피처를 전환합니다.
- *
- * 프로젝트 컨텍스트의 activeFeatureId를 업데이트하고,
- * 해당 피처의 상태를 'active'로 변경합니다.
- */
 export declare function switchFeature(basePath: string, id: string): Promise<Result<FeatureContext>>;
-/**
- * 피처를 완료 처리합니다.
- *
- * - 상태를 'completed'로 변경
- * - activeFeatureId에서 제거
- */
 export declare function completeFeature(basePath: string, id: string): Promise<Result<FeatureContext>>;
-/**
- * 피처를 삭제합니다.
- *
- * 주의: 이 작업은 되돌릴 수 없습니다.
- */
 export declare function deleteFeature(basePath: string, id: string): Promise<Result<void>>;
-/**
- * 현재 활성 피처를 조회합니다.
- */
 export declare function getActiveFeature(basePath: string): Promise<Result<FeatureContext | null>>;

package/dist/context/feature.js

@@ -1,32 +1,17 @@
-/**
- * Feature Management
- *
- * 피처의 생성, 조회, 업데이트, 목록, 전환, 완료, 삭제
- *
- * "Keep functions small and focused" - Kent Beck
- */
 import { randomUUID } from 'crypto';
 import { readFile, writeFile, readdir, unlink } from 'fs/promises';
 import { existsSync } from 'fs';
 import { CONTEXT_CONFIG, getFeaturePath, getFeaturesDir } from './config.js';
 import { now, errorMessage } from './utils.js';
 import { getProjectContext, saveProjectContext, initContextDir } from './project.js';
-// ============================================================================
-// Create Feature
-// ============================================================================
-/**
- * 새로운 피처를 생성합니다.
- */
 export async function createFeature(basePath, name, goal) {
     try {
-        // 입력 검증
         if (!name || name.trim().length === 0) {
             return { success: false, error: '[Context] Feature name is required' };
         }
         if (!goal || goal.trim().length === 0) {
             return { success: false, error: '[Context] Feature goal is required' };
         }
-        // 디렉토리 확인/초기화
         if (!existsSync(getFeaturesDir(basePath))) {
             const initResult = await initContextDir(basePath);
             if (!initResult.success) {
@@ -55,12 +40,6 @@ export async function createFeature(basePath, name, goal) {
         };
     }
 }
-// ============================================================================
-// Read Feature
-// ============================================================================
-/**
- * 특정 피처를 조회합니다.
- */
 export async function getFeature(basePath, id) {
     try {
         const featurePath = getFeaturePath(basePath, id);
@@ -81,20 +60,12 @@ export async function getFeature(basePath, id) {
         };
     }
 }
-// ============================================================================
-// Update Feature
-// ============================================================================
-/**
- * 피처를 업데이트합니다.
- */
 export async function updateFeature(basePath, id, updates) {
     try {
-        // 기존 피처 조회
         const existing = await getFeature(basePath, id);
         if (!existing.success || !existing.data) {
             return existing;
         }
-        // 업데이트 적용 (id와 createdAt은 불변)
         const updated = {
             ...existing.data,
             ...updates,
@@ -113,12 +84,6 @@ export async function updateFeature(basePath, id, updates) {
         };
     }
 }
-// ============================================================================
-// List Features
-// ============================================================================
-/**
- * 모든 피처 목록을 반환합니다.
- */
 export async function listFeatures(basePath) {
     try {
         const featuresDir = getFeaturesDir(basePath);
@@ -135,7 +100,6 @@ export async function listFeatures(basePath) {
                 features.push(result.data);
             }
         }
-        // 최신 업데이트 순으로 정렬
         features.sort((a, b) => new Date(b.updatedAt).getTime() - new Date(a.updatedAt).getTime());
         return { success: true, data: features };
     }
@@ -146,44 +110,29 @@ export async function listFeatures(basePath) {
         };
     }
 }
-// ============================================================================
-// Switch Feature
-// ============================================================================
-/**
- * 활성 피처를 전환합니다.
- *
- * 프로젝트 컨텍스트의 activeFeatureId를 업데이트하고,
- * 해당 피처의 상태를 'active'로 변경합니다.
- */
 export async function switchFeature(basePath, id) {
     try {
-        // 피처 존재 확인
         const feature = await getFeature(basePath, id);
         if (!feature.success || !feature.data) {
             return feature;
         }
-        // 이미 completed인 피처는 전환 불가
         if (feature.data.status === 'completed') {
             return {
                 success: false,
                 error: '[Context] Cannot switch to completed feature. Reopen it first.',
             };
         }
-        // 프로젝트 컨텍스트 업데이트
         const projectResult = await getProjectContext(basePath);
         const project = projectResult.success && projectResult.data
             ? projectResult.data
             : { name: 'unnamed' };
-        // 이전 활성 피처를 paused로 변경
         if (project.activeFeatureId && project.activeFeatureId !== id) {
             await updateFeature(basePath, project.activeFeatureId, { status: 'paused' });
         }
-        // 현재 피처를 active로 변경
         const updated = await updateFeature(basePath, id, { status: 'active' });
         if (!updated.success) {
             return updated;
         }
-        // 프로젝트 컨텍스트에 activeFeatureId 저장
         project.activeFeatureId = id;
         await saveProjectContext(basePath, project);
         return updated;
@@ -195,23 +144,12 @@ export async function switchFeature(basePath, id) {
         };
     }
 }
-// ============================================================================
-// Complete Feature
-// ============================================================================
-/**
- * 피처를 완료 처리합니다.
- *
- * - 상태를 'completed'로 변경
- * - activeFeatureId에서 제거
- */
 export async function completeFeature(basePath, id) {
     try {
-        // 피처 상태 변경
         const updated = await updateFeature(basePath, id, { status: 'completed' });
         if (!updated.success) {
             return updated;
         }
-        // 프로젝트 컨텍스트에서 activeFeatureId 제거 (해당 피처인 경우)
         const projectResult = await getProjectContext(basePath);
         if (projectResult.success && projectResult.data) {
             if (projectResult.data.activeFeatureId === id) {
@@ -228,14 +166,6 @@ export async function completeFeature(basePath, id) {
         };
     }
 }
-// ============================================================================
-// Delete Feature
-// ============================================================================
-/**
- * 피처를 삭제합니다.
- *
- * 주의: 이 작업은 되돌릴 수 없습니다.
- */
 export async function deleteFeature(basePath, id) {
     try {
         const featurePath = getFeaturePath(basePath, id);
@@ -245,7 +175,6 @@ export async function deleteFeature(basePath, id) {
                 error: `[Context] Feature not found: ${id}`,
             };
         }
-        // 활성 피처인 경우 프로젝트 컨텍스트에서 제거
         const projectResult = await getProjectContext(basePath);
         if (projectResult.success && projectResult.data) {
             if (projectResult.data.activeFeatureId === id) {
@@ -263,12 +192,6 @@ export async function deleteFeature(basePath, id) {
         };
     }
 }
-// ============================================================================
-// Get Active Feature
-// ============================================================================
-/**
- * 현재 활성 피처를 조회합니다.
- */
 export async function getActiveFeature(basePath) {
     try {
         const projectResult = await getProjectContext(basePath);

package/dist/context/files.d.ts

@@ -1,16 +1,3 @@
-/**
- * Feature File Management
- *
- * 피처에 파일 추가/제거
- *
- * "Simple operations, clearly named" - Kent Beck
- */
 import type { FeatureContext, Result } from './types.js';
-/**
- * 피처에 파일을 추가합니다.
- */
 export declare function addFileToFeature(basePath: string, id: string, filePath: string): Promise<Result<FeatureContext>>;
-/**
- * 피처에서 파일을 제거합니다.
- */
 export declare function removeFileFromFeature(basePath: string, id: string, filePath: string): Promise<Result<FeatureContext>>;

package/dist/context/files.js

@@ -1,47 +1,24 @@
-/**
- * Feature File Management
- *
- * 피처에 파일 추가/제거
- *
- * "Simple operations, clearly named" - Kent Beck
- */
 import { normalizePath } from './utils.js';
 import { getFeature, updateFeature } from './feature.js';
-// ============================================================================
-// Add File
-// ============================================================================
-/**
- * 피처에 파일을 추가합니다.
- */
 export async function addFileToFeature(basePath, id, filePath) {
     const feature = await getFeature(basePath, id);
     if (!feature.success || !feature.data) {
         return feature;
     }
-    // 정규화된 경로
     const normalizedPath = normalizePath(filePath);
-    // 중복 체크
     if (feature.data.files.includes(normalizedPath)) {
-        return { success: true, data: feature.data }; // 이미 있으면 그냥 성공
+        return { success: true, data: feature.data };
     }
     const updatedFiles = [...feature.data.files, normalizedPath];
     return updateFeature(basePath, id, { files: updatedFiles });
 }
-// ============================================================================
-// Remove File
-// ============================================================================
-/**
- * 피처에서 파일을 제거합니다.
- */
 export async function removeFileFromFeature(basePath, id, filePath) {
     const feature = await getFeature(basePath, id);
     if (!feature.success || !feature.data) {
         return feature;
     }
-    // 정규화된 경로
     const normalizedPath = normalizePath(filePath);
     const updatedFiles = feature.data.files.filter(f => f !== normalizedPath);
-    // 변경이 없으면 그냥 성공
     if (updatedFiles.length === feature.data.files.length) {
         return { success: true, data: feature.data };
     }

package/dist/context/index.d.ts

@@ -1,10 +1,3 @@
-/**
- * Context Package
- *
- * 피처 기반 컨텍스트 관리 시스템
- *
- * "Export only what's needed" - Kent Beck
- */
 export type { FeatureContext, ProjectContext, FeatureUpdate, Result, } from './types.js';
 export { CONTEXT_CONFIG, getContextDir, getProjectPath, getFeaturesDir, getFeaturePath, getContextConfig, } from './config.js';
 export { getProjectContext, saveProjectContext, initContextDir, } from './project.js';

package/dist/context/index.js

@@ -1,17 +1,5 @@
-/**
- * Context Package
- *
- * 피처 기반 컨텍스트 관리 시스템
- *
- * "Export only what's needed" - Kent Beck
- */
-// Configuration
 export { CONTEXT_CONFIG, getContextDir, getProjectPath, getFeaturesDir, getFeaturePath, getContextConfig, } from './config.js';
-// Project Context
 export { getProjectContext, saveProjectContext, initContextDir, } from './project.js';
-// Feature Management
 export { createFeature, getFeature, updateFeature, listFeatures, switchFeature, completeFeature, deleteFeature, getActiveFeature, } from './feature.js';
-// File Management
 export { addFileToFeature, removeFileFromFeature, } from './files.js';
-// Utilities
 export { now, errorMessage, normalizePath, } from './utils.js';

package/dist/context/project.d.ts

@@ -1,25 +1,4 @@
-/**
- * Project Context Management
- *
- * 프로젝트 전체 메타데이터 관리
- *
- * "Each function should do one thing and do it well" - Kent Beck
- */
 import type { ProjectContext, Result } from './types.js';
-/**
- * 프로젝트 컨텍스트를 읽어옵니다.
- */
 export declare function getProjectContext(basePath: string): Promise<Result<ProjectContext>>;
-/**
- * 프로젝트 컨텍스트를 저장합니다.
- */
 export declare function saveProjectContext(basePath: string, context: ProjectContext): Promise<Result<void>>;
-/**
- * 컨텍스트 디렉토리 구조를 초기화합니다.
- *
- * 생성 구조:
- * .opencode/context/
- * ├── project.json
- * └── features/
- */
 export declare function initContextDir(basePath: string): Promise<Result<void>>;

package/dist/context/project.js

@@ -1,20 +1,7 @@
-/**
- * Project Context Management
- *
- * 프로젝트 전체 메타데이터 관리
- *
- * "Each function should do one thing and do it well" - Kent Beck
- */
 import { mkdir, readFile, writeFile } from 'fs/promises';
 import { existsSync } from 'fs';
 import { getContextDir, getProjectPath } from './config.js';
 import { errorMessage } from './utils.js';
-// ============================================================================
-// Project Context Operations
-// ============================================================================
-/**
- * 프로젝트 컨텍스트를 읽어옵니다.
- */
 export async function getProjectContext(basePath) {
     try {
         const projectPath = getProjectPath(basePath);
@@ -35,13 +22,9 @@ export async function getProjectContext(basePath) {
         };
     }
 }
-/**
- * 프로젝트 컨텍스트를 저장합니다.
- */
 export async function saveProjectContext(basePath, context) {
     try {
         const projectPath = getProjectPath(basePath);
-        // 디렉토리가 없으면 초기화
         if (!existsSync(getContextDir(basePath))) {
             const initResult = await initContextDir(basePath);
             if (!initResult.success) {
@@ -58,25 +41,12 @@ export async function saveProjectContext(basePath, context) {
         };
     }
 }
-// ============================================================================
-// Directory Initialization
-// ============================================================================
-/**
- * 컨텍스트 디렉토리 구조를 초기화합니다.
- *
- * 생성 구조:
- * .opencode/context/
- * ├── project.json
- * └── features/
- */
 export async function initContextDir(basePath) {
     try {
         const { getFeaturesDir } = await import('./config.js');
         const featuresDir = getFeaturesDir(basePath);
         const projectPath = getProjectPath(basePath);
-        // 디렉토리 생성 (recursive)
         await mkdir(featuresDir, { recursive: true });
-        // project.json이 없으면 기본값으로 생성
         if (!existsSync(projectPath)) {
             const defaultProject = {
                 name: basePath.split(/[/\\]/).pop() || 'unnamed-project',

package/dist/context/types.d.ts

@@ -1,69 +1,21 @@
-/**
- * Context Type Definitions
- *
- * 피처 기반 컨텍스트 관리 시스템의 타입 정의
- *
- * 설계 원칙:
- * - 명확한 이름으로 의도 표현 (Intention-Revealing Names)
- * - 타입 안전성 (Type Safety)
- * - 불변성 강조 (Immutability)
- *
- * @author Kent Beck's Dummy Human
- */
-/**
- * 피처 컨텍스트
- *
- * 하나의 작업 단위를 나타냅니다. 로그인 기능 구현, 버그 수정 등
- * 각 피처는 관련 파일들과 현재 진행 상태를 추적합니다.
- */
 export interface FeatureContext {
-    /** 고유 식별자 (UUID) */
     id: string;
-    /** 피처 이름 (예: "login-oauth") */
     name: string;
-    /** 한 줄 목표 설명 */
     goal: string;
-    /** 현재 상태 */
     status: 'active' | 'paused' | 'completed';
-    /** 관련 파일 목록 */
     files: string[];
-    /** 마지막 작업 상태 스냅샷 */
     lastContext: string;
-    /** 막힌 부분 (선택) */
     blockers?: string;
-    /** 생성 시각 (ISO 8601) */
     createdAt: string;
-    /** 마지막 수정 시각 (ISO 8601) */
     updatedAt: string;
 }
-/**
- * 프로젝트 컨텍스트
- *
- * 프로젝트 전체에 대한 메타 정보를 관리합니다.
- */
 export interface ProjectContext {
-    /** 프로젝트 이름 */
     name: string;
-    /** 기술 스택 */
     techStack?: string[];
-    /** 코딩 컨벤션 */
     conventions?: string;
-    /** 현재 활성 피처 ID */
     activeFeatureId?: string;
 }
-/**
- * 피처 업데이트 입력
- *
- * Partial을 사용하되 id와 createdAt은 변경 불가
- */
 export type FeatureUpdate = Partial<Omit<FeatureContext, 'id' | 'createdAt'>>;
-/**
- * 작업 결과 타입
- *
- * 모든 작업은 성공/실패를 명시적으로 반환
- *
- * "Make the return value obvious" - Kent Beck
- */
 export interface Result<T> {
     success: boolean;
     data?: T;

package/dist/context/types.js

@@ -1,13 +1 @@
-/**
- * Context Type Definitions
- *
- * 피처 기반 컨텍스트 관리 시스템의 타입 정의
- *
- * 설계 원칙:
- * - 명확한 이름으로 의도 표현 (Intention-Revealing Names)
- * - 타입 안전성 (Type Safety)
- * - 불변성 강조 (Immutability)
- *
- * @author Kent Beck's Dummy Human
- */
 export {};

package/dist/context/utils.d.ts

@@ -1,21 +1,3 @@
-/**
- * Context Utilities
- *
- * 작은, 재사용 가능한 유틸리티 함수들
- *
- * "Small functions, well named, doing one thing" - Kent Beck
- */
-/**
- * 현재 시각을 ISO 8601 형식으로 반환
- */
 export declare function now(): string;
-/**
- * 에러에서 메시지 추출
- *
- * "Handle errors gracefully" - Kent Beck
- */
 export declare function errorMessage(error: unknown): string;
-/**
- * 파일 경로 정규화 (Windows 백슬래시 → 슬래시)
- */
 export declare function normalizePath(filePath: string): string;

package/dist/context/utils.js

@@ -1,39 +1,12 @@
-/**
- * Context Utilities
- *
- * 작은, 재사용 가능한 유틸리티 함수들
- *
- * "Small functions, well named, doing one thing" - Kent Beck
- */
-// ============================================================================
-// Time Utilities
-// ============================================================================
-/**
- * 현재 시각을 ISO 8601 형식으로 반환
- */
 export function now() {
     return new Date().toISOString();
 }
-// ============================================================================
-// Error Handling
-// ============================================================================
-/**
- * 에러에서 메시지 추출
- *
- * "Handle errors gracefully" - Kent Beck
- */
 export function errorMessage(error) {
     if (error instanceof Error) {
         return error.message;
     }
     return String(error);
 }
-// ============================================================================
-// Path Normalization
-// ============================================================================
-/**
- * 파일 경로 정규화 (Windows 백슬래시 → 슬래시)
- */
 export function normalizePath(filePath) {
     return filePath.replace(/\\/g, '/');
 }

package/dist/core/engine/promptBuilder.d.ts

@@ -1,28 +1,11 @@
-/**
- * Prompt Builder
- *
- * Builds system prompts from mask definitions.
- */
 import type { MaskSchema, LoadedMask } from '../schema/types';
 export interface PromptBuilderOptions {
-    /** Include metadata in prompt header */
     includeMetadata?: boolean;
-    /** Include usage examples */
     includeExamples?: boolean;
-    /** Additional context to append */
     additionalContext?: string;
 }
-/**
- * Build a system prompt from a mask
- */
 export declare function buildPrompt(mask: MaskSchema | LoadedMask, options?: PromptBuilderOptions): string;
-/**
- * Build a minimal prompt (just the core system prompt)
- */
 export declare function buildMinimalPrompt(mask: MaskSchema | LoadedMask): string;
-/**
- * Build a rich prompt with all available information
- */
 export declare function buildRichPrompt(mask: MaskSchema | LoadedMask): string;
 export declare const promptBuilder: {
     build: typeof buildPrompt;