maskweaver 0.9.4 → 0.9.5

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[];

package/dist/memory/chunking.js

@@ -1,13 +1,4 @@
-/**
- * Text Chunking - Break text into manageable pieces
- *
- * Simple line-based chunking with overlap.
- * Preserves context at chunk boundaries.
- */
 import { CONFIG, hashText, determineSource } from './core.js';
-/**
- * Chunk text into overlapping segments.
- */
 export function chunkText(text, filePath) {
     const { maxTokens, overlapTokens, charsPerToken } = CONFIG.chunking;
     const source = determineSource(filePath);
@@ -16,32 +7,28 @@ export function chunkText(text, filePath) {
     const maxChars = maxTokens * charsPerToken;
     const overlapChars = overlapTokens * charsPerToken;
     let currentChunkLines = [];
-    let currentChunkStart = 1; // 1-based line number
+    let currentChunkStart = 1;
     let currentLength = 0;
     for (let i = 0; i < lines.length; i++) {
         const line = lines[i];
-        const lineLength = line.length + 1; // +1 for newline
+        const lineLength = line.length + 1;
         if (currentLength + lineLength <= maxChars) {
             currentChunkLines.push(line);
             currentLength += lineLength;
         }
         else {
-            // Save current chunk
             if (currentChunkLines.length > 0) {
                 const chunkText = currentChunkLines.join('\n');
                 if (chunkText.trim().length > 0) {
                     chunks.push(createChunk(filePath, currentChunkStart, currentChunkStart + currentChunkLines.length - 1, chunkText, source));
                 }
             }
-            // Calculate overlap
             const overlapLines = calculateOverlapLines(currentChunkLines, overlapChars);
-            // Start new chunk
             currentChunkStart = i + 1 - overlapLines.length;
             currentChunkLines = [...overlapLines, line];
             currentLength = currentChunkLines.join('\n').length;
         }
     }
-    // Save last chunk
     if (currentChunkLines.length > 0) {
         const chunkText = currentChunkLines.join('\n');
         if (chunkText.trim().length > 0) {
@@ -50,9 +37,6 @@ export function chunkText(text, filePath) {
     }
     return chunks;
 }
-/**
- * Calculate overlap lines from end of chunk.
- */
 function calculateOverlapLines(lines, overlapChars) {
     const result = [];
     let length = 0;
@@ -65,9 +49,6 @@ function calculateOverlapLines(lines, overlapChars) {
     }
     return result;
 }
-/**
- * Create chunk object.
- */
 function createChunk(path, startLine, endLine, text, source) {
     return {
         path,
@@ -78,27 +59,17 @@ function createChunk(path, startLine, endLine, text, source) {
         source,
     };
 }
-/**
- * Estimate tokens in text.
- */
 export function estimateTokens(text) {
     if (!text || text.length === 0)
         return 0;
-    // Korean characters: ~2 tokens per char
     const koreanChars = (text.match(/[\uAC00-\uD7A3]/g) || []).length;
-    // English words: ~1.3 tokens per word
     const englishWords = (text.match(/[a-zA-Z]+/g) || []).length;
-    // Other chars
     const otherChars = text.length - koreanChars - (englishWords * 5);
     const koreanTokens = koreanChars * 2;
     const englishTokens = englishWords * 1.3;
     const otherTokens = Math.max(0, otherChars) / 4;
     return Math.ceil(koreanTokens + englishTokens + otherTokens);
 }
-/**
- * Split text into sentences.
- * Handles both English and Korean.
- */
 export function splitIntoSentences(text) {
     const sentenceEnders = /([.!?。！？])\s+/g;
     const sentences = [];
@@ -114,9 +85,6 @@ export function splitIntoSentences(text) {
     return sentences.filter(s => s.length > 0);
 }
 const HEADER_REGEX = /^(#{1,6})\s+(.+)$/;
-/**
- * Parse markdown into sections.
- */
 export function parseMarkdownSections(content) {
     const lines = content.split('\n');
     const sections = [];
@@ -128,7 +96,6 @@ export function parseMarkdownSections(content) {
         const lineNumber = i + 1;
         const headerMatch = line.match(HEADER_REGEX);
         if (headerMatch) {
-            // Save previous section
             if (currentSection !== null || currentLines.length > 0) {
                 sections.push({
                     header: currentSection?.header || '',
@@ -138,7 +105,6 @@ export function parseMarkdownSections(content) {
                     endLine: lineNumber - 1
                 });
             }
-            // Start new section
             currentSection = {
                 header: headerMatch[2],
                 content: '',
@@ -153,7 +119,6 @@ export function parseMarkdownSections(content) {
             currentLines.push(line);
         }
     }
-    // Save last section
     if (currentLines.length > 0) {
         sections.push({
             header: currentSection?.header || '',

package/dist/memory/core.d.ts

@@ -1,8 +1,3 @@
-/**
- * Memory Core - Simple utilities for text processing
- *
- * Clear is better than clever.
- */
 export declare const CONFIG: {
     readonly chunking: {
         readonly maxTokens: 400;
@@ -36,34 +31,10 @@ export interface SearchResult {
     score: number;
     matchType: 'vector' | 'text' | 'hybrid';
 }
-/**
- * Hash text using djb2 algorithm.
- * Simple, fast, good enough for our use case.
- */
 export declare function hashText(text: string): string;
-/**
- * Estimate token count.
- * Rough approximation: 4 chars ≈ 1 token
- */
 export declare function estimateTokens(text: string): number;
-/**
- * Determine source type from file path.
- */
 export declare function determineSource(filePath: string): SourceType;
-/**
- * Calculate cosine similarity between two vectors.
- * Single pass for efficiency.
- *
- * Returns 0 on dimension mismatch instead of throwing,
- * to prevent a single bad embedding from crashing the entire search.
- */
 export declare function cosineSimilarity(a: number[], b: number[]): number;
-/**
- * Float32 version - more memory efficient.
- *
- * Returns 0 on dimension mismatch instead of throwing,
- * to prevent a single bad embedding from crashing the entire search.
- */
 export declare function cosineSimilarityFloat32(a: Float32Array, b: Float32Array): number;
 export declare function toFloat32Array(embedding: number[]): Float32Array;
 export declare function embeddingToBlob(embedding: number[]): Buffer;

package/dist/memory/core.js

@@ -1,12 +1,4 @@
-/**
- * Memory Core - Simple utilities for text processing
- *
- * Clear is better than clever.
- */
 import { join } from "path";
-// ============================================================================
-// Configuration
-// ============================================================================
 export const CONFIG = {
     chunking: {
         maxTokens: 400,
@@ -23,31 +15,17 @@ export const CONFIG = {
         defaultMinScore: 0.35,
     },
 };
-// ============================================================================
-// Text Processing
-// ============================================================================
-/**
- * Hash text using djb2 algorithm.
- * Simple, fast, good enough for our use case.
- */
 export function hashText(text) {
     let hash = 5381;
     for (let i = 0; i < text.length; i++) {
         hash = ((hash << 5) + hash) + text.charCodeAt(i);
-        hash = hash & hash; // Convert to 32bit integer
+        hash = hash & hash;
     }
     return Math.abs(hash).toString(16);
 }
-/**
- * Estimate token count.
- * Rough approximation: 4 chars ≈ 1 token
- */
 export function estimateTokens(text) {
     return Math.ceil(text.length / CONFIG.chunking.charsPerToken);
 }
-/**
- * Determine source type from file path.
- */
 export function determineSource(filePath) {
     const lower = filePath.toLowerCase().replace(/\\/g, '/');
     if (lower.includes('/daily/') || (lower.endsWith('.md') && /\d{4}-\d{2}-\d{2}/.test(lower))) {
@@ -67,18 +45,7 @@ export function determineSource(filePath) {
     }
     return 'code';
 }
-// ============================================================================
-// Similarity
-// ============================================================================
-// Deduplicated warning: only log dimension mismatch once per session
 let _dimensionMismatchWarned = false;
-/**
- * Calculate cosine similarity between two vectors.
- * Single pass for efficiency.
- *
- * Returns 0 on dimension mismatch instead of throwing,
- * to prevent a single bad embedding from crashing the entire search.
- */
 export function cosineSimilarity(a, b) {
     if (a.length === 0 || b.length === 0)
         return 0;
@@ -104,12 +71,6 @@ export function cosineSimilarity(a, b) {
     const magnitude = Math.sqrt(magnitudeA) * Math.sqrt(magnitudeB);
     return magnitude === 0 ? 0 : dotProduct / magnitude;
 }
-/**
- * Float32 version - more memory efficient.
- *
- * Returns 0 on dimension mismatch instead of throwing,
- * to prevent a single bad embedding from crashing the entire search.
- */
 export function cosineSimilarityFloat32(a, b) {
     if (a.length === 0 || b.length === 0)
         return 0;
@@ -135,9 +96,6 @@ export function cosineSimilarityFloat32(a, b) {
     const magnitude = Math.sqrt(magnitudeA) * Math.sqrt(magnitudeB);
     return magnitude === 0 ? 0 : dotProduct / magnitude;
 }
-// ============================================================================
-// Embedding Conversion
-// ============================================================================
 export function toFloat32Array(embedding) {
     return new Float32Array(embedding);
 }
@@ -152,9 +110,6 @@ export function blobToNumberArray(blob) {
     const float32 = new Float32Array(blob.buffer, blob.byteOffset, blob.byteLength / 4);
     return Array.from(float32);
 }
-// ============================================================================
-// Date Utilities
-// ============================================================================
 export function getTodayFileName() {
     const now = new Date();
     const year = now.getFullYear();
@@ -168,9 +123,6 @@ export function dateToFileName(date) {
     const day = String(date.getDate()).padStart(2, '0');
     return `${year}-${month}-${day}.md`;
 }
-// ============================================================================
-// Path Utilities
-// ============================================================================
 export function getMemoryPath(type, basePath = process.cwd()) {
     const memoryDir = join(basePath, CONFIG.paths.memoryDir);
     switch (type) {
@@ -194,9 +146,6 @@ export function getDbPath(basePath = process.cwd()) {
 export function getDataDir(basePath = process.cwd()) {
     return join(basePath, CONFIG.paths.dataDir);
 }
-// ============================================================================
-// Utilities
-// ============================================================================
 export function sleep(ms) {
     return new Promise(resolve => setTimeout(resolve, ms));
 }

package/dist/memory/index.d.ts

@@ -1,8 +1,3 @@
-/**
- * @maskweaver/memory
- *
- * Memory system with embeddings and vector search
- */
 export type { SourceType, MemoryType, Chunk, SearchResult, } from "./core.js";
 export { CONFIG, hashText, estimateTokens, determineSource, cosineSimilarity, cosineSimilarityFloat32, toFloat32Array, embeddingToBlob, blobToEmbedding, blobToNumberArray, getTodayFileName, dateToFileName, getMemoryPath, getDbPath, getDataDir, sleep, getConfig, } from "./core.js";
 export type { Embedding, ProviderType, HealthCheckResult, ProviderConfig, IEmbeddingProvider, } from "./providers/types.js";

package/dist/memory/index.js

@@ -1,21 +1,11 @@
-/**
- * @maskweaver/memory
- *
- * Memory system with embeddings and vector search
- */
 export { CONFIG, hashText, estimateTokens, determineSource, cosineSimilarity, cosineSimilarityFloat32, toFloat32Array, embeddingToBlob, blobToEmbedding, blobToNumberArray, getTodayFileName, dateToFileName, getMemoryPath, getDbPath, getDataDir, sleep, getConfig, } from "./core.js";
 export { OllamaProvider } from "./providers/ollama.js";
 export { OpenAIProvider } from "./providers/openai.js";
 export { VoyageProvider } from "./providers/voyage.js";
 export { OpenRouterProvider } from "./providers/openrouter.js";
 export { TextOnlyProvider } from "./providers/text-only.js";
-// Provider factory
 export { createProvider, selectBestProvider, getDefaultConfigs, } from "./providers/factory.js";
-// Chunking
 export { chunkText, parseMarkdownSections, splitIntoSentences } from "./chunking.js";
-// Storage
 export { MemoryDatabase, initDatabase, getDatabase, tryGetDatabase, isSqliteAvailable, getSqliteUnavailableReason, upsertChunk, searchByVector, searchByText, deleteChunksByPath, getChunksByPath, } from "./store/sqlite.js";
-// Search
 export { hybridSearch } from "./search/hybrid.js";
-// Indexing
 export { indexFile, reindexFile, indexAllMemoryFiles, classifySource, } from "./indexer.js";

package/dist/memory/indexer.d.ts

@@ -1,8 +1,3 @@
-/**
- * File Indexer - Process markdown files into searchable chunks
- *
- * Read file → Parse sections → Chunk → Hash → Embed → Store
- */
 import { type SourceType } from './core.js';
 type EmbeddingProvider = (text: string) => Promise<number[]>;
 export interface MarkdownSection {
@@ -12,25 +7,9 @@ export interface MarkdownSection {
     startLine: number;
     endLine: number;
 }
-/**
- * Parse markdown into sections.
- */
 export declare function parseMarkdownSections(content: string): MarkdownSection[];
-/**
- * Classify source from file path.
- */
 export declare function classifySource(filePath: string): SourceType;
-/**
- * Index a single file.
- * Only re-embeds chunks that changed (based on hash).
- */
 export declare function indexFile(filePath: string, getEmbedding: EmbeddingProvider, basePath?: string): Promise<void>;
-/**
- * Reindex file (delete all chunks and reindex).
- */
 export declare function reindexFile(filePath: string, getEmbedding: EmbeddingProvider, basePath?: string): Promise<void>;
-/**
- * Index all memory files in directory.
- */
 export declare function indexAllMemoryFiles(baseDir: string, getEmbedding: EmbeddingProvider, basePath?: string): Promise<void>;
 export {};