maskweaver 0.9.3 → 0.9.5

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 {};

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

@@ -1,8 +1,3 @@
-/**
- * Mask Schema Validator
- *
- * Validates mask YAML/JSON against the schema using Zod.
- */
 import { z } from 'zod';
 import type { MaskSchema } from './types';
 export declare const MaskSchemaValidator: z.ZodObject<{
@@ -75,9 +70,6 @@ export declare const MaskSchemaValidator: z.ZodObject<{
         temperature: z.ZodOptional<z.ZodNumber>;
     }, z.core.$strip>>;
 }, z.core.$strip>;
-/**
- * Validation result
- */
 export interface ValidationResult {
     success: boolean;
     data?: MaskSchema;
@@ -86,11 +78,5 @@ export interface ValidationResult {
         message: string;
     }>;
 }
-/**
- * Validate a mask object against the schema
- */
 export declare function validateMask(mask: unknown): ValidationResult;
-/**
- * Validate and throw on error
- */
 export declare function validateMaskOrThrow(mask: unknown): MaskSchema;

package/dist/core/schema/validator.js

@@ -1,15 +1,8 @@
-/**
- * Mask Schema Validator
- *
- * Validates mask YAML/JSON against the schema using Zod.
- */
 import { z } from 'zod';
-// Communication style enums
 const CommunicationToneSchema = z.enum(['direct', 'friendly', 'formal', 'socratic', 'enthusiastic']);
 const VerbositySchema = z.enum(['concise', 'moderate', 'detailed']);
 const TechnicalDepthSchema = z.enum(['beginner', 'intermediate', 'expert']);
 const LanguageSchema = z.enum(['en', 'ko', 'zh', 'ja']);
-// Metadata schema
 const MaskMetadataSchema = z.object({
     id: z.string().regex(/^[a-z0-9-]+$/, 'ID must be kebab-case'),
     version: z.literal('1.0'),
@@ -20,7 +13,6 @@ const MaskMetadataSchema = z.object({
     relatedMasks: z.array(z.string()).optional(),
     tags: z.array(z.string()).optional(),
 });
-// Profile schema
 const MaskProfileSchema = z.object({
     name: z.string().min(1, 'Name is required'),
     tagline: z.string().min(1, 'Tagline is required'),
@@ -30,7 +22,6 @@ const MaskProfileSchema = z.object({
     strengths: z.array(z.string()).min(1).max(10),
     limitations: z.array(z.string()).optional(),
 });
-// Behavior schema
 const MaskBehaviorSchema = z.object({
     systemPrompt: z.string().min(100, 'System prompt should be detailed'),
     communicationStyle: z.object({
@@ -46,7 +37,6 @@ const MaskBehaviorSchema = z.object({
     }),
     signaturePhrases: z.array(z.string()).optional(),
 });
-// Usage schema
 const MaskUsageExampleSchema = z.object({
     scenario: z.string(),
     expectedOutcome: z.string(),
@@ -56,7 +46,6 @@ const MaskUsageSchema = z.object({
     notSuitableFor: z.array(z.string()).optional(),
     examples: z.array(MaskUsageExampleSchema).min(1),
 });
-// Config schema
 const MaskConfigSchema = z.object({
     priority: z.number().min(0).max(100).optional(),
     allowedTools: z.array(z.string()).optional(),
@@ -64,7 +53,6 @@ const MaskConfigSchema = z.object({
     maxTokens: z.number().positive().optional(),
     temperature: z.number().min(0).max(2).optional(),
 }).optional();
-// Complete mask schema
 export const MaskSchemaValidator = z.object({
     metadata: MaskMetadataSchema,
     profile: MaskProfileSchema,
@@ -72,9 +60,6 @@ export const MaskSchemaValidator = z.object({
     usage: MaskUsageSchema,
     config: MaskConfigSchema,
 });
-/**
- * Validate a mask object against the schema
- */
 export function validateMask(mask) {
     const result = MaskSchemaValidator.safeParse(mask);
     if (result.success) {
@@ -91,9 +76,6 @@ export function validateMask(mask) {
         })),
     };
 }
-/**
- * Validate and throw on error
- */
 export function validateMaskOrThrow(mask) {
     const result = validateMask(mask);
     if (!result.success) {

package/dist/i18n/index.d.ts

@@ -1,27 +1,9 @@
-/**
- * @maskweaver/i18n
- *
- * Internationalization infrastructure for Maskweaver.
- * Phase 1: English only, but structure ready for expansion.
- */
 import en from './locales/en.json';
 export type Locale = 'en' | 'ko' | 'zh' | 'ja';
 export type TranslationKey = keyof typeof en;
-/**
- * Set the current locale
- */
 export declare function setLocale(locale: Locale): void;
-/**
- * Get the current locale
- */
 export declare function getLocale(): Locale;
-/**
- * Translate a key
- */
 export declare function t(key: string, params?: Record<string, string>): string;
-/**
- * Load translations for a locale
- */
 export declare function loadLocale(locale: Locale): Promise<void>;
 declare const _default: {
     t: typeof t;

package/dist/i18n/index.js

@@ -1,48 +1,29 @@
-/**
- * @maskweaver/i18n
- *
- * Internationalization infrastructure for Maskweaver.
- * Phase 1: English only, but structure ready for expansion.
- */
 import en from './locales/en.json';
 const translations = {
     en,
-    ko: en, // Fallback to English
-    zh: en, // Fallback to English
-    ja: en, // Fallback to English
+    ko: en,
+    zh: en,
+    ja: en,
 };
 let currentLocale = 'en';
-/**
- * Set the current locale
- */
 export function setLocale(locale) {
     currentLocale = locale;
 }
-/**
- * Get the current locale
- */
 export function getLocale() {
     return currentLocale;
 }
-/**
- * Translate a key
- */
 export function t(key, params) {
     const translation = translations[currentLocale][key] || translations.en[key] || key;
     if (!params) {
         return translation;
     }
-    // Replace {{param}} placeholders
     return translation.replace(/\{\{(\w+)\}\}/g, (_, paramKey) => {
         return params[paramKey] || `{{${paramKey}}}`;
     });
 }
-/**
- * Load translations for a locale
- */
 export async function loadLocale(locale) {
     if (translations[locale] && translations[locale] !== translations.en) {
-        return; // Already loaded
+        return;
     }
     try {
         const module = await import(`./locales/${locale}.json`);

package/dist/index.d.ts

@@ -1,11 +1,3 @@
-/**
- * Maskweaver - AI Expert Persona System
- *
- * 가면술사: AI 코딩 어시스턴트에게 전문가 인격을 부여하는 시스템
- *
- * @author ULJI SOFT <ulgerang@gmail.com>
- * @license MIT
- */
 import { MaskweaverPlugin } from "./plugin/index.js";
 export { MaskweaverPlugin };
 declare const _default: {

package/dist/index.js

@@ -1,11 +1,3 @@
-/**
- * Maskweaver - AI Expert Persona System
- *
- * 가면술사: AI 코딩 어시스턴트에게 전문가 인격을 부여하는 시스템
- *
- * @author ULJI SOFT <ulgerang@gmail.com>
- * @license MIT
- */
 import { MaskweaverPlugin } from "./plugin/index.js";
 export { MaskweaverPlugin };
 export default {

package/dist/lib.d.ts

@@ -1,8 +1,3 @@
-/**
- * Maskweaver - AI Expert Persona System
- *
- * Library exports for programmatic usage.
- */
 export { VERSION, getVersionString } from "./version.js";
 export * as core from "./core/index.js";
 export * as shared from "./shared/index.js";

package/dist/lib.js

@@ -1,19 +1,7 @@
-/**
- * Maskweaver - AI Expert Persona System
- *
- * Library exports for programmatic usage.
- */
-// Version
 export { VERSION, getVersionString } from "./version.js";
-// Core: Schema, validation, prompt builder
 export * as core from "./core/index.js";
-// Shared: Errors, types, config
 export * as shared from "./shared/index.js";
-// Memory: Embedding, vector search
 export * as memory from "./memory/index.js";
-// Context: Feature context management
 export * as context from "./context/index.js";
-// Retrospect: Session retrospective
 export * as retrospect from "./retrospect/index.js";
-// Verify: Code verification
 export * as verify from "./verify/index.js";

package/dist/memory/chunking.d.ts

@@ -1,26 +1,7 @@
-/**
- * Text Chunking - Break text into manageable pieces
- *
- * Simple line-based chunking with overlap.
- * Preserves context at chunk boundaries.
- */
 import { type Chunk } from './core.js';
-/**
- * Chunk text into overlapping segments.
- */
 export declare function chunkText(text: string, filePath: string): Chunk[];
-/**
- * Estimate tokens in text.
- */
 export declare function estimateTokens(text: string): number;
-/**
- * Split text into sentences.
- * Handles both English and Korean.
- */
 export declare function splitIntoSentences(text: string): string[];
-/**
- * Markdown section parsing.
- */
 export interface MarkdownSection {
     header: string;
     content: string;
@@ -28,7 +9,4 @@ export interface MarkdownSection {
     startLine: number;
     endLine: number;
 }
-/**
- * Parse markdown into sections.
- */
 export declare function parseMarkdownSections(content: string): MarkdownSection[];