maskweaver 0.9.4 → 0.9.5

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;

package/dist/core/engine/promptBuilder.js

@@ -1,27 +1,16 @@
-/**
- * Prompt Builder
- *
- * Builds system prompts from mask definitions.
- */
 const DEFAULT_OPTIONS = {
     includeMetadata: false,
     includeExamples: false,
 };
-/**
- * Build a system prompt from a mask
- */
 export function buildPrompt(mask, options = {}) {
     const opts = { ...DEFAULT_OPTIONS, ...options };
     const parts = [];
-    // Header (optional)
     if (opts.includeMetadata) {
         parts.push(`# ${mask.profile.name}`);
         parts.push(`> ${mask.profile.tagline}`);
         parts.push('');
     }
-    // Main system prompt (always included)
     parts.push(mask.behavior.systemPrompt.trim());
-    // Signature phrases (if available)
     if (mask.behavior.signaturePhrases && mask.behavior.signaturePhrases.length > 0) {
         parts.push('');
         parts.push('SIGNATURE PHRASES YOU MAY USE:');
@@ -29,7 +18,6 @@ export function buildPrompt(mask, options = {}) {
             parts.push(`- "${phrase}"`);
         }
     }
-    // Usage examples (optional)
     if (opts.includeExamples && mask.usage.examples.length > 0) {
         parts.push('');
         parts.push('EXAMPLE SCENARIOS:');
@@ -38,7 +26,6 @@ export function buildPrompt(mask, options = {}) {
             parts.push(`  → ${example.expectedOutcome}`);
         }
     }
-    // Additional context (optional)
     if (opts.additionalContext) {
         parts.push('');
         parts.push('ADDITIONAL CONTEXT:');
@@ -46,52 +33,38 @@ export function buildPrompt(mask, options = {}) {
     }
     return parts.join('\n');
 }
-/**
- * Build a minimal prompt (just the core system prompt)
- */
 export function buildMinimalPrompt(mask) {
     return mask.behavior.systemPrompt.trim();
 }
-/**
- * Build a rich prompt with all available information
- */
 export function buildRichPrompt(mask) {
     const parts = [];
-    // Identity header
     parts.push(`You are ${mask.profile.name}.`);
     parts.push(`${mask.profile.tagline}`);
     parts.push('');
-    // Background
     parts.push('BACKGROUND:');
     parts.push(mask.profile.background.trim());
     parts.push('');
-    // Expertise
     parts.push('YOUR EXPERTISE:');
     for (const exp of mask.profile.expertise) {
         parts.push(`- ${exp}`);
     }
     parts.push('');
-    // Thinking style
     parts.push('YOUR THINKING STYLE:');
     parts.push(mask.profile.thinkingStyle.trim());
     parts.push('');
-    // Main behavior instructions
     parts.push('INSTRUCTIONS:');
     parts.push(mask.behavior.systemPrompt.trim());
     parts.push('');
-    // Communication style
     const style = mask.behavior.communicationStyle;
     parts.push('COMMUNICATION STYLE:');
     parts.push(`- Tone: ${style.tone}`);
     parts.push(`- Verbosity: ${style.verbosity}`);
     parts.push(`- Technical depth: ${style.technicalDepth}`);
     parts.push('');
-    // Strengths
     parts.push('YOUR STRENGTHS:');
     for (const strength of mask.profile.strengths) {
         parts.push(`- ${strength}`);
     }
-    // Limitations (if any)
     if (mask.profile.limitations && mask.profile.limitations.length > 0) {
         parts.push('');
         parts.push('ACKNOWLEDGE YOUR LIMITATIONS:');
@@ -99,7 +72,6 @@ export function buildRichPrompt(mask) {
             parts.push(`- ${limitation}`);
         }
     }
-    // Signature phrases
     if (mask.behavior.signaturePhrases && mask.behavior.signaturePhrases.length > 0) {
         parts.push('');
         parts.push('PHRASES YOU MIGHT USE:');

package/dist/core/index.d.ts

@@ -1,9 +1,3 @@
-/**
- * @maskweaver/core
- *
- * Core library for Maskweaver - AI expert persona system.
- * 가면술사 핵심 라이브러리
- */
 export type { Result } from '../shared/types.js';
 export type { MaskSchema, MaskMetadata, MaskProfile, MaskBehavior, MaskUsage, MaskUsageExample, MaskConfig, MaskCatalog, MaskCatalogEntry, MaskCategory, LoadedMask, CommunicationTone, Verbosity, TechnicalDepth, } from './schema/types';
 export { validateMask, validateMaskOrThrow, MaskSchemaValidator, type ValidationResult, } from './schema/validator';

package/dist/core/index.js

@@ -1,12 +1,3 @@
-/**
- * @maskweaver/core
- *
- * Core library for Maskweaver - AI expert persona system.
- * 가면술사 핵심 라이브러리
- */
-// Validator
 export { validateMask, validateMaskOrThrow, MaskSchemaValidator, } from './schema/validator';
-// Loader
 export { MaskLoader, } from './loader/MaskLoader';
-// Prompt builder
 export { promptBuilder, buildPrompt, buildMinimalPrompt, buildRichPrompt, } from './engine/promptBuilder';

package/dist/core/loader/MaskLoader.d.ts

@@ -1,8 +1,3 @@
-/**
- * Mask Loader
- *
- * Loads mask definitions from the file system.
- */
 import type { MaskCatalog, LoadedMask, MaskCatalogEntry } from '../schema/types';
 export interface MaskLoaderOptions {
     masksDir: string;
@@ -12,35 +7,17 @@ export declare class MaskLoader {
     private catalog;
     private cache;
     constructor(options: MaskLoaderOptions);
-    /**
-     * Load the mask catalog (index.json)
-     */
     loadCatalog(): Promise<MaskCatalog>;
-    /**
-     * Load all masks from the catalog
-     */
     loadAll(): Promise<LoadedMask[]>;
-    /**
-     * Load a single mask by ID
-     */
     load(maskId: string): Promise<LoadedMask | null>;
-    /**
-     * List all masks (metadata only)
-     */
     listAll(): Promise<Array<MaskCatalogEntry & {
         category: string;
     }>>;
-    /**
-     * List categories
-     */
     listCategories(): Promise<Array<{
         id: string;
         name: string;
         description: string;
         count: number;
     }>>;
-    /**
-     * Clear the cache
-     */
     clearCache(): void;
 }

package/dist/core/loader/MaskLoader.js

@@ -1,8 +1,3 @@
-/**
- * Mask Loader
- *
- * Loads mask definitions from the file system.
- */
 import { readFile } from 'fs/promises';
 import { existsSync } from 'fs';
 import { parse as parseYaml } from 'yaml';
@@ -14,9 +9,6 @@ export class MaskLoader {
     constructor(options) {
         this.masksDir = options.masksDir;
     }
-    /**
-     * Load the mask catalog (index.json)
-     */
     async loadCatalog() {
         if (this.catalog) {
             return this.catalog;
@@ -29,9 +21,6 @@ export class MaskLoader {
         this.catalog = JSON.parse(content);
         return this.catalog;
     }
-    /**
-     * Load all masks from the catalog
-     */
     async loadAll() {
         const catalog = await this.loadCatalog();
         const masks = [];
@@ -50,16 +39,11 @@ export class MaskLoader {
         }
         return masks;
     }
-    /**
-     * Load a single mask by ID
-     */
     async load(maskId) {
-        // Check cache
         if (this.cache.has(maskId)) {
             return this.cache.get(maskId);
         }
         const catalog = await this.loadCatalog();
-        // Find mask in catalog
         let entry = null;
         let categoryId = null;
         for (const [catId, category] of Object.entries(catalog.categories)) {
@@ -73,7 +57,6 @@ export class MaskLoader {
         if (!entry || !categoryId) {
             return null;
         }
-        // Load mask file
         const filePath = `${this.masksDir}/${entry.file}`;
         if (!existsSync(filePath)) {
             throw new Error(`Mask file not found: ${filePath}`);
@@ -82,21 +65,15 @@ export class MaskLoader {
         const parsed = filePath.endsWith('.yaml') || filePath.endsWith('.yml')
             ? parseYaml(content)
             : JSON.parse(content);
-        // Validate
         const validated = validateMaskOrThrow(parsed);
-        // Create loaded mask
         const loadedMask = {
             ...validated,
             category: categoryId,
             filePath,
         };
-        // Cache it
         this.cache.set(maskId, loadedMask);
         return loadedMask;
     }
-    /**
-     * List all masks (metadata only)
-     */
     async listAll() {
         const catalog = await this.loadCatalog();
         const result = [];
@@ -110,9 +87,6 @@ export class MaskLoader {
         }
         return result;
     }
-    /**
-     * List categories
-     */
     async listCategories() {
         const catalog = await this.loadCatalog();
         return Object.entries(catalog.categories).map(([id, cat]) => ({
@@ -122,9 +96,6 @@ export class MaskLoader {
             count: cat.masks.length,
         }));
     }
-    /**
-     * Clear the cache
-     */
     clearCache() {
         this.cache.clear();
         this.catalog = null;

package/dist/core/schema/types.d.ts

@@ -1,62 +1,38 @@
-/**
- * Mask Schema v1.0
- *
- * Defines the structure for AI expert personas.
- * 가면술사 (Maskweaver) - Core Type Definitions
- */
 export interface MaskMetadata {
-    /** Unique identifier (kebab-case) */
     id: string;
-    /** Schema version for future compatibility */
     version: '1.0';
-    /** Primary language of this mask definition */
     language: 'en' | 'ko' | 'zh' | 'ja';
-    /** Creation/update timestamps (ISO 8601) */
     created: string;
     updated: string;
-    /** Contributors/authors */
     authors?: string[];
-    /** Related mask IDs for cross-referencing */
     relatedMasks?: string[];
-    /** Tags for categorization and search */
     tags?: string[];
 }
 export interface MaskProfile {
-    /** Display name of the persona */
     name: string;
-    /** One-line tagline */
     tagline: string;
-    /** Detailed background (2-3 paragraphs) */
     background: string;
-    /** Core expertise areas (3-5 items) */
     expertise: string[];
-    /** Thinking style description */
     thinkingStyle: string;
-    /** Key strengths (3-5 bullet points) */
     strengths: string[];
-    /** Limitations/weaknesses (honesty is key) */
     limitations?: string[];
 }
 export type CommunicationTone = 'direct' | 'friendly' | 'formal' | 'socratic' | 'enthusiastic';
 export type Verbosity = 'concise' | 'moderate' | 'detailed';
 export type TechnicalDepth = 'beginner' | 'intermediate' | 'expert';
 export interface MaskBehavior {
-    /** System prompt injected when mask is applied */
     systemPrompt: string;
-    /** Communication style guidelines */
     communicationStyle: {
         tone: CommunicationTone;
         verbosity: Verbosity;
         technicalDepth: TechnicalDepth;
     };
-    /** Task approach patterns */
     approachPatterns: {
         problemSolving: string;
         codeReview: string;
         architecture?: string;
         debugging?: string;
     };
-    /** Example phrases this persona might use */
     signaturePhrases?: string[];
 }
 export interface MaskUsageExample {
@@ -64,28 +40,17 @@ export interface MaskUsageExample {
     expectedOutcome: string;
 }
 export interface MaskUsage {
-    /** When to use this mask */
     suitableFor: string[];
-    /** When NOT to use this mask */
     notSuitableFor?: string[];
-    /** Example use cases */
     examples: MaskUsageExample[];
 }
 export interface MaskConfig {
-    /** Runtime configuration */
     priority?: number;
-    /** Tool restrictions */
     allowedTools?: string[];
     disallowedTools?: string[];
-    /** Session settings */
     maxTokens?: number;
     temperature?: number;
 }
-/**
- * Complete Mask Definition
- *
- * This is the main schema for defining expert personas (masks).
- */
 export interface MaskSchema {
     metadata: MaskMetadata;
     profile: MaskProfile;
@@ -93,9 +58,6 @@ export interface MaskSchema {
     usage: MaskUsage;
     config?: MaskConfig;
 }
-/**
- * Mask Catalog Entry (for index.json)
- */
 export interface MaskCatalogEntry {
     id: string;
     name: string;
@@ -103,24 +65,15 @@ export interface MaskCatalogEntry {
     tags: string[];
     category?: string;
 }
-/**
- * Mask Category (for index.json)
- */
 export interface MaskCategory {
     name: string;
     description: string;
     masks: MaskCatalogEntry[];
 }
-/**
- * Mask Catalog (masks/index.json)
- */
 export interface MaskCatalog {
     version: string;
     categories: Record<string, MaskCategory>;
 }
-/**
- * Loaded Mask (with resolved category info)
- */
 export interface LoadedMask extends MaskSchema {
     category: string;
     filePath: string;

package/dist/core/schema/types.js

@@ -1,7 +1 @@
-/**
- * Mask Schema v1.0
- *
- * Defines the structure for AI expert personas.
- * 가면술사 (Maskweaver) - Core Type Definitions
- */
 export {};