maskweaver 0.9.4 → 0.9.6

package/dist/plugin/tools/weave.js

@@ -1,11 +1,4 @@
-/**
- * Weave Tool for OpenCode Plugin
- *
- * Integrates Weave workflow into OpenCode as a tool.
- * Commands: design, craft, status
- */
 import { z } from 'zod';
-// Inline shim: tool() is just an identity function in @opencode-ai/plugin
 const tool = (input) => input;
 import { createHash } from 'node:crypto';
 import * as os from 'node:os';
@@ -39,9 +32,6 @@ import { acquireLoopOperatorLock, appendLoopEvent, createLoopRun, ensureLoopCont
 import { getEffectiveGdcConfig, runGdcMachineCommand, countGdcCheckIssues, getStatsNodeSummary, } from '../../weave/gdc.js';
 import { generatePoolAgentFilesFromConfig, writeDefaultRuntimeConfig, writeDefaultPluginConfig, } from '../../shared/generate-agents.js';
 import { resolveCommand, loadCommandsJson } from './command-registry.js';
-// ============================================================================
-// Tool Factory
-// ============================================================================
 export function createWeaveTool() {
     return {
         description: (() => {
@@ -145,7 +135,6 @@ export function createWeaveTool() {
         execute: async (args, context) => {
             const { command } = args;
             const basePath = context.worktree;
-            // Resolve command aliases and deprecation
             const resolved = resolveCommand(command);
             if ('error' in resolved) {
                 return `Error: ${resolved.error}`;
@@ -215,9 +204,6 @@ export function createWeaveTool() {
         },
     };
 }
-// ============================================================================
-// Command Handlers
-// ============================================================================
 function toWorkspaceRelative(basePath, filePath) {
     const rel = path.relative(basePath, filePath);
     if (!rel || rel.startsWith('..'))
@@ -1094,7 +1080,6 @@ async function migrateLegacyPlanIfNeeded(basePath, activePlan) {
         await unlink(legacyPlanPath);
     }
     catch {
-        // Non-fatal. Keep migrated plan and continue.
     }
     return {
         migrated: true,
@@ -1241,7 +1226,6 @@ async function handleInit(basePath) {
     lines.push('');
     lines.push(...gdcReport);
     lines.push('');
-    // Check global config
     const globalConfigPath = path.join(os.homedir(), '.config', 'opencode', 'maskweaver.config.json');
     if (!fs.existsSync(globalConfigPath)) {
         lines.push('');
@@ -1389,7 +1373,6 @@ async function handleApprovePlan(args, basePath) {
             }
         }
         catch {
-            // Optional note file.
         }
     }
     activePlan.planApproved = true;
@@ -1416,7 +1399,6 @@ async function handleDesign(args, basePath) {
     if (!docsPath) {
         return 'Error: docsPath is required for design command. Example: weave design docs/';
     }
-    // Step 1: Intake
     const resolvedDocsPath = resolveUnderBase(basePath, docsPath);
     const intakeResult = await intake({ docsPath: resolvedDocsPath });
     const researchResult = await writeResearchReport({
@@ -1425,7 +1407,6 @@ async function handleDesign(args, basePath) {
         basePath,
         projectName: projectName || 'My Project',
     });
-    // Check if there are questions
     if (intakeResult.questions.length > 0) {
         const lines = [];
         lines.push(researchResult.summary);
@@ -1449,7 +1430,6 @@ async function handleDesign(args, basePath) {
         lines.push('(또는 기본값으로 진행하려면 "기본값으로 진행해"라고 해주세요)');
         return lines.join('\n');
     }
-    // Step 2: Plan (if no questions or defaults accepted)
     const planResult = await plan({
         intake: intakeResult,
         projectName: projectName || 'My Project',
@@ -1508,7 +1488,6 @@ async function handlePrepare(args, basePath) {
     const intakeResult = await intake({ docsPath: resolvedDocsPath });
     const gdcPrepareSync = await runGdcPrepareSync(basePath);
     const normalizedPlanName = normalizePlanName(args.planName, projectName, resolvedDocsPath);
-    // Cache-aware skip: skip steps if artifacts already exist
     const researchPath = path.join(basePath, 'tasks', 'research.md');
     const specsDir = path.join(basePath, '.opencode', 'weave', 'specs');
     const plansDir = path.join(basePath, '.opencode', 'weave', 'plans');
@@ -1529,7 +1508,6 @@ async function handlePrepare(args, basePath) {
             return false;
         }
     })();
-    // Step 1: Research
     const researchResult = hasResearch
         ? {
             summary: `> ⏭️ Research skipped: \`${toWorkspaceRelative(basePath, researchPath)}\` already exists.`,
@@ -1541,7 +1519,6 @@ async function handlePrepare(args, basePath) {
             basePath,
             projectName: projectName || 'My Project',
         });
-    // Step 2: Spec (baseline)
     const specResult = hasSpec
         ? { summary: `> ⏭️ Spec skipped: existing artifact found in \`${toWorkspaceRelative(basePath, specsDir)}\`.` }
         : await createSpec({
@@ -1550,7 +1527,6 @@ async function handlePrepare(args, basePath) {
             specName: normalizedPlanName,
             basePath,
         });
-    // Step 3: Plan
     const planResult = hasPlan
         ? { summary: `> ⏭️ Plan skipped: existing artifact found in \`${toWorkspaceRelative(basePath, plansDir)}\`.` }
         : await plan({
@@ -1647,7 +1623,6 @@ async function handleFlow(args, basePath) {
     if (!phaseBeforeCraft) {
         return `Error: Phase not found: ${resolvedPhaseId}`;
     }
-    // Legacy plans may not have explicit tasks yet.
     if (!phaseBeforeCraft.tasks || phaseBeforeCraft.tasks.length === 0) {
         await manager.addTasks(resolvedPhaseId, generateDefaultPhaseTasks(phaseBeforeCraft));
     }
@@ -1770,9 +1745,6 @@ async function handleFlow(args, basePath) {
     });
     return lines.join('\n');
 }
-// ============================================================================
-// Handle Map — Codebase Analysis
-// ============================================================================
 async function handleMap(args, basePath) {
     const lines = [];
     lines.push('## 🔍 Codebase Map');
@@ -1803,9 +1775,6 @@ async function handleMap(args, basePath) {
     lines.push('Next: `weave command=interview docsPath="doc"` to discuss the plan.');
     return lines.join('\n');
 }
-// ============================================================================
-// Handle Interview — Multi-step Question Asking
-// ============================================================================
 async function handleInterview(args, basePath) {
     const docsPath = args.docsPath || 'docs';
     const lines = [];
@@ -1858,9 +1827,6 @@ async function handleInterview(args, basePath) {
     }
     return lines.join('\n');
 }
-// ============================================================================
-// Handle Build — Ralph-loop Autonomous Execution
-// ============================================================================
 async function handleBuild(args, basePath) {
     const lines = [];
     lines.push('## 🏗️ Build');
@@ -1908,9 +1874,6 @@ async function handleBuild(args, basePath) {
     }
     return lines.join('\n');
 }
-// ============================================================================
-// Handle Build Resume
-// ============================================================================
 async function handleBuildResume(args, basePath) {
     const lines = [];
     lines.push('## 🔄 Build Resume');
@@ -1957,10 +1920,8 @@ async function handleCraft(args, basePath) {
         return formatPlanApprovalRequired(basePath, activePlan);
     }
     if (!resolvedPhaseId) {
-        // Get next phase
         const manager = getPhaseManager(basePath);
         await manager.loadPlan();
-        // Show any recovery messages from auto-repair during load
         const recoveryMsgs = manager.getRecoveryMessages();
         recoveryPrefix = recoveryMsgs.length > 0
             ? `> **Auto-repair**: ${recoveryMsgs.join('; ')}\n\n`
@@ -1976,7 +1937,6 @@ async function handleCraft(args, basePath) {
         resolvedPhaseId = nextPhase.id;
         autoSelectedPhase = true;
     }
-    // Ensure tasks exist for legacy plans. (Old plans may have empty task arrays.)
     {
         const manager = getPhaseManager(basePath);
         await manager.loadPlan();
@@ -1988,7 +1948,6 @@ async function handleCraft(args, basePath) {
             await manager.addTasks(resolvedPhaseId, generateDefaultPhaseTasks(current));
         }
     }
-    // Prepare execution plan (validates, marks in_progress, generates plan)
     const events = [];
     const { plan: executionPlan } = await preparePhaseExecution({
         phaseId: resolvedPhaseId,
@@ -1996,7 +1955,6 @@ async function handleCraft(args, basePath) {
         onEvent: (event) => events.push(event),
         basePath,
     });
-    // Format the execution plan as markdown for the Mask Weaver
     const planMarkdown = formatExecutionPlan(executionPlan);
     const manager = getPhaseManager(basePath);
     await manager.loadPlan();
@@ -2086,14 +2044,11 @@ async function handleStatus(basePath) {
     const manager = getPhaseManager(basePath);
     const activePlan = await manager.loadPlan();
     const report = await generateStatusReport(basePath);
-    // Show any recovery messages from auto-repair
     const recoveryMsgs = manager.getRecoveryMessages();
-    // Add global knowledge stats
     const knowledge = new GlobalKnowledge();
     await knowledge.init();
     const stats = await knowledge.getStats();
     const lines = [];
-    // Show recovery warnings at the top
     if (recoveryMsgs.length > 0) {
         lines.push('### YAML Auto-Repair Report\n');
         for (const msg of recoveryMsgs) {
@@ -2247,7 +2202,6 @@ async function handleVerify(args, basePath) {
     return verification.report;
 }
 async function handleTroubleshoot(args) {
-    // Unified: record mode (absorbs old 'record' command)
     if (args.record) {
         if (!args.error || !args.solution) {
             return 'Error: error and solution are required when record=true. Example: weave command=troubleshoot record=true error="..." solution="..."';
@@ -2294,17 +2248,6 @@ async function handleRepair(basePath) {
     const { results, summary } = await manager.repairPlans();
     return summary;
 }
-/**
- * Handle `sync-agents` command.
- *
- * Reads maskweaver.config.json (project or global ~/.config/opencode/)
- * and force-overwrites all dummy-human agent .md files in .opencode/agents/.
- *
- * Search order:
- * 1. {projectDir}/maskweaver.config.json
- * 2. {projectDir}/.opencode/maskweaver.config.json
- * 3. ~/.config/opencode/maskweaver.config.json (user global)
- */
 async function handleSyncAgents(basePath) {
     const agentsDir = path.join(basePath, '.opencode', 'agents');
     const result = generatePoolAgentFilesFromConfig(basePath, agentsDir, { force: true });
@@ -2344,18 +2287,10 @@ async function handleSyncAgents(basePath) {
     }
     return lines.join('\n');
 }
-/**
- * Handle `init-config` command.
- *
- * Creates default maskweaver.config.json (runtime config with pool template)
- * and .opencode/maskweaver.json (plugin config) if they don't exist.
- * Does NOT overwrite existing files.
- */
 async function handleInitConfig(basePath) {
     const lines = [];
     lines.push('## 📝 Config Initialization');
     lines.push('');
-    // Create runtime config (maskweaver.config.json)
     const runtimePath = writeDefaultRuntimeConfig(basePath);
     if (runtimePath) {
         lines.push(`✅ Created runtime config: ${toWorkspaceRelative(basePath, runtimePath)}`);
@@ -2366,7 +2301,6 @@ async function handleInitConfig(basePath) {
         lines.push('⏭️  maskweaver.config.json already exists (skipped)');
     }
     lines.push('');
-    // Create plugin config (.opencode/maskweaver.json)
     const pluginPath = writeDefaultPluginConfig(basePath);
     if (pluginPath) {
         lines.push(`✅ Created plugin config: ${toWorkspaceRelative(basePath, pluginPath)}`);
@@ -2379,9 +2313,6 @@ async function handleInitConfig(basePath) {
     lines.push('>   with your model pool, then run `weave sync-agents` in any project to apply it.');
     return lines.join('\n');
 }
-// ============================================================================
-// Unified Build Handler (absorbs build, build-resume, loop-*)
-// ============================================================================
 async function handleBuildUnified(args, basePath) {
     const action = args.action || 'run';
     switch (action) {
@@ -2413,9 +2344,6 @@ async function handleBuildUnified(args, basePath) {
             return `Error: Unknown build action: ${action}. Available: run, status, stop, list, resume, sync.`;
     }
 }
-// ============================================================================
-// Agents Handler (absorbs sync-agents, init-config)
-// ============================================================================
 async function handleAgents(args, basePath) {
     if (!args.sync && !args.init) {
         return 'Error: agents requires an action. Use `sync=true` to regenerate agent files, or `init=true` to create default config.';
@@ -3065,7 +2993,6 @@ async function handleApprove(args, basePath) {
                 `Finalization blocked: verification failed for ${resolvedPhaseId}.`,
             ]);
         }
-        // If no commands detected, allow finalization but make it explicit.
         if (verification.results.length === 0) {
             await phaseManager.markAllTasksPassed(resolvedPhaseId);
             const result = await handleUserResponse(resolvedPhaseId, 'approve', undefined, basePath);
@@ -3082,7 +3009,6 @@ async function handleApprove(args, basePath) {
                 shardSwitch ? 'Advanced to next shard.' : '',
             ].filter(Boolean));
         }
-        // Optional: commit during finalization
         if (commit) {
             try {
                 await ensureGitRepo(basePath);
@@ -3121,7 +3047,6 @@ async function handleApprove(args, basePath) {
                 const secretWarning = findings.length > 0
                     ? formatSecretScanReport(findings)
                     : null;
-                // Commit message fallback: Pn: Phase Name
                 const phase = phaseManager.getPhase(resolvedPhaseId);
                 const defaultMsg = phase ? `${phase.id}: ${phase.name}` : `${resolvedPhaseId}: complete`;
                 const msg = (commitMessage && commitMessage.trim().length > 0)
@@ -3157,7 +3082,6 @@ async function handleApprove(args, basePath) {
                 ]);
             }
         }
-        // Passed with results: include report in approval output.
         {
             await phaseManager.markAllTasksPassed(resolvedPhaseId);
         }
@@ -3320,7 +3244,6 @@ async function syncWorkflowArtifacts(basePath, manager, options) {
         await writeFile(todoPath, `${lines.join('\n')}\n`, 'utf-8');
     }
     catch {
-        // Non-fatal: artifact sync should never break workflow execution.
     }
 }
 function sanitizeLessonText(input, maxLength = 240) {
@@ -3363,7 +3286,6 @@ async function appendWorkflowLesson(basePath, lesson) {
         await writeFile(lessonsPath, `${current.trimEnd()}\n\n${entry}`, 'utf-8');
     }
     catch {
-        // Non-fatal: lesson capture should not block workflow execution.
     }
 }
 function resolveUnderBase(basePath, inputPath) {

package/dist/plugin/types.d.ts

@@ -1,32 +1,12 @@
-/**
- * Plugin Types
- *
- * Shared types for Maskweaver plugin tools
- *
- * Based on @opencode-ai/plugin tool definitions.
- */
 import type { z } from 'zod';
-/**
- * Minimal context required by Maskweaver tool factories.
- * SDK provides richer context, but factories only need worktree.
- */
 export interface ToolContext {
     worktree: string;
 }
-/**
- * Tool factory interface for creating OpenCode tools
- */
 export interface ToolFactory {
-    /** Tool description shown to LLM */
     description: string;
-    /** Zod schema for argument validation */
     args: z.ZodType<any>;
-    /** Execute function that returns string result */
     execute: (args: any, context: ToolContext) => Promise<string>;
 }
-/**
- * Standard tool response format
- */
 export interface ToolResponse<T = unknown> {
     success: boolean;
     data?: T;

package/dist/plugin/types.js

@@ -1,8 +1 @@
-/**
- * Plugin Types
- *
- * Shared types for Maskweaver plugin tools
- *
- * Based on @opencode-ai/plugin tool definitions.
- */
 export {};

package/dist/retrospect/index.d.ts

@@ -1,10 +1,3 @@
-/**
- * Retrospect Package
- *
- * 회고 및 가면 관리 시스템
- *
- * "Export only what matters" - Kent Beck
- */
 export type { RetrospectTrigger, RetrospectDepth, MaskUsageRecord, RetrospectInput, RetrospectResult, } from './types.js';
 export type { RetrospectStrategy } from './strategies/base.js';
 export { selectStrategy, QuickRetrospectStrategy, StandardRetrospectStrategy, DeepRetrospectStrategy, } from './strategies/index.js';

package/dist/retrospect/index.js

@@ -1,12 +1,3 @@
-/**
- * Retrospect Package
- *
- * 회고 및 가면 관리 시스템
- *
- * "Export only what matters" - Kent Beck
- */
 export { selectStrategy, QuickRetrospectStrategy, StandardRetrospectStrategy, DeepRetrospectStrategy, } from './strategies/index.js';
-// Core functions
 export { performRetrospect, getMemoryPath, getDbPath } from './retrospect.js';
-// Mask save
 export { saveMask } from './mask-save.js';

package/dist/retrospect/mask-save.d.ts

@@ -1,10 +1,3 @@
-/**
- * Mask Save Logic
- *
- * 효과적인 가면을 MASKS.md에 저장
- *
- * "Clean code reads like well-written prose" - Kent Beck
- */
 interface MaskSaveInput {
     name: string;
     expertise: string;
@@ -21,10 +14,5 @@ interface MaskSaveResult {
     effectivenessScore?: number;
     message: string;
 }
-/**
- * 가면 저장
- *
- * "Make each function tell a story" - Kent Beck
- */
 export declare function saveMask(basePath: string, input: MaskSaveInput): MaskSaveResult;
 export type { MaskSaveInput, MaskSaveResult };

package/dist/retrospect/mask-save.js

@@ -1,21 +1,8 @@
-/**
- * Mask Save Logic
- *
- * 효과적인 가면을 MASKS.md에 저장
- *
- * "Clean code reads like well-written prose" - Kent Beck
- */
 import { join } from 'path';
 import { existsSync, readFileSync, writeFileSync, mkdirSync } from 'fs';
 import { getMemoryPath } from './retrospect.js';
-// ============================================================================
-// Constants
-// ============================================================================
 const EFFECTIVENESS_NEW_SCORE_WEIGHT = 0.3;
 const CUSTOM_SECTION_HEADER = '## 커스텀 가면';
-// ============================================================================
-// Date Formatting
-// ============================================================================
 function formatTimestamp() {
     const now = new Date();
     const year = now.getFullYear();
@@ -25,36 +12,19 @@ function formatTimestamp() {
     const minute = String(now.getMinutes()).padStart(2, '0');
     return `${year}-${month}-${day} ${hour}:${minute}`;
 }
-// ============================================================================
-// Effectiveness Score Calculation
-// ============================================================================
-/**
- * 이동 평균으로 효과성 점수 계산
- *
- * "The simplest thing that could possibly work" - Kent Beck
- */
 function calculateMovingAverageScore(currentScore, newScore, weight = EFFECTIVENESS_NEW_SCORE_WEIGHT) {
     if (currentScore === 0) {
         return newScore;
     }
     const updatedScore = currentScore * (1 - weight) + newScore * weight;
-    return Math.round(updatedScore * 10) / 10; // 소수점 첫째 자리까지
+    return Math.round(updatedScore * 10) / 10;
 }
-// ============================================================================
-// Markdown Parsing
-// ============================================================================
-/**
- * 이름을 비교 가능한 형태로 정규화
- */
 function normalizeNameForComparison(name) {
     return name
         .toLowerCase()
         .replace(/\s+/g, '')
         .replace(/[()]/g, '');
 }
-/**
- * MASKS.md에서 특정 가면 섹션을 찾습니다.
- */
 function findMaskSection(content, maskName) {
     const lines = content.split('\n');
     const normalizedTarget = normalizeNameForComparison(maskName);
@@ -63,23 +33,19 @@ function findMaskSection(content, maskName) {
     let currentScore = 0;
     for (let i = 0; i < lines.length; i++) {
         const line = lines[i];
-        // ### 가면명 형식 감지
         if (line.startsWith('### ')) {
-            // 이전 가면 섹션 종료 체크
             if (currentMaskStart !== -1) {
                 const normalizedCurrent = normalizeNameForComparison(currentMaskName);
                 if (normalizedCurrent === normalizedTarget) {
                     return { start: currentMaskStart, end: i - 1, score: currentScore };
                 }
             }
-            // 새 가면 섹션 시작
             currentMaskStart = i;
             const withoutPrefix = line.replace(/^###\s*/, '');
             const nameMatch = withoutPrefix.match(/^([^(]+)/);
             currentMaskName = nameMatch ? nameMatch[1].trim() : withoutPrefix.trim();
             currentScore = 0;
         }
-        // 효과성 점수 추출
         if (currentMaskStart !== -1 && line.includes('**효과성 점수**')) {
             const colonIndex = line.indexOf(':');
             if (colonIndex !== -1) {
@@ -88,7 +54,6 @@ function findMaskSection(content, maskName) {
             }
         }
     }
-    // 마지막 가면 체크
     if (currentMaskStart !== -1) {
         const normalizedCurrent = normalizeNameForComparison(currentMaskName);
         if (normalizedCurrent === normalizedTarget) {
@@ -97,12 +62,6 @@ function findMaskSection(content, maskName) {
     }
     return null;
 }
-// ============================================================================
-// Markdown Generation
-// ============================================================================
-/**
- * 새 가면 섹션 마크다운 생성
- */
 function generateNewMaskSection(input) {
     const timestamp = formatTimestamp();
     const usageRecord = input.usageNote
@@ -118,29 +77,22 @@ function generateNewMaskSection(input) {
 ${usageRecord}
 `;
 }
-/**
- * 기존 가면 섹션 업데이트
- */
 function updateExistingMask(content, section, newScore, usageNote) {
     const lines = content.split('\n');
     const timestamp = formatTimestamp();
     const newUsageRecord = usageNote
         ? `  - ${timestamp} (점수: ${newScore}) - ${usageNote}`
         : `  - ${timestamp} (점수: ${newScore})`;
-    // 효과성 점수 업데이트
     const updatedScore = calculateMovingAverageScore(section.score, newScore);
     const sectionLines = lines.slice(section.start, section.end + 1);
     const result = [];
     let usageRecordInserted = false;
     for (const line of sectionLines) {
-        // 효과성 점수 라인 업데이트
         if (line.includes('**효과성 점수**')) {
             result.push(`- **효과성 점수**: ${updatedScore}`);
         }
-        // 사용 기록 라인 찾기
         else if (line.includes('**사용 기록**')) {
             result.push(line);
-            // 바로 다음에 새 기록 추가
             result.push(newUsageRecord);
             usageRecordInserted = true;
         }
@@ -148,43 +100,28 @@ function updateExistingMask(content, section, newScore, usageNote) {
             result.push(line);
         }
     }
-    // 사용 기록 섹션이 없으면 마지막에 추가
     if (!usageRecordInserted) {
         result.push(`- **사용 기록**: `);
         result.push(newUsageRecord);
     }
-    // 전체 파일 재구성
     const before = lines.slice(0, section.start);
     const after = lines.slice(section.end + 1);
     return [...before, ...result, ...after].join('\n');
 }
-/**
- * 새 가면 추가
- */
 function addNewMask(content, input) {
     const newSection = generateNewMaskSection(input);
-    // 커스텀 가면 섹션 찾기
     const customSectionIndex = content.indexOf(CUSTOM_SECTION_HEADER);
     if (customSectionIndex !== -1) {
-        // 커스텀 섹션 바로 다음에 추가
         const insertPosition = customSectionIndex + CUSTOM_SECTION_HEADER.length;
         const afterHeader = content.slice(insertPosition);
         const beforeHeader = content.slice(0, insertPosition);
         return `${beforeHeader}\n\n${newSection}${afterHeader}`;
     }
-    // 커스텀 섹션이 없으면 파일 끝에 추가
     return `${content}\n${CUSTOM_SECTION_HEADER}\n\n${newSection}`;
 }
-// ============================================================================
-// File Operations
-// ============================================================================
-/**
- * MASKS.md 파일 읽기
- */
 function readMasksFile(basePath) {
     const masksPath = getMemoryPath('masks', basePath);
     if (!existsSync(masksPath)) {
-        // 기본 템플릿 반환
         return `# 가면 라이브러리 (Mask Library)
 
 이 파일은 가면술사가 사용하는 가면들의 정의와 효과성을 기록합니다.
@@ -202,9 +139,6 @@ ${CUSTOM_SECTION_HEADER}
     }
     return readFileSync(masksPath, 'utf-8');
 }
-/**
- * MASKS.md 파일 쓰기
- */
 function writeMasksFile(basePath, content) {
     const masksPath = getMemoryPath('masks', basePath);
     const dir = join(basePath, '.opencode', 'memory');
@@ -213,32 +147,19 @@ function writeMasksFile(basePath, content) {
     }
     writeFileSync(masksPath, content, 'utf-8');
 }
-// ============================================================================
-// Main Function
-// ============================================================================
-/**
- * 가면 저장
- *
- * "Make each function tell a story" - Kent Beck
- */
 export function saveMask(basePath, input) {
     try {
-        // 1. MASKS.md 읽기
         let content = readMasksFile(basePath);
-        // 2. 해당 가면이 있는지 확인
         const existingSection = findMaskSection(content, input.name);
         let action;
         if (existingSection) {
-            // 3a. 기존 가면 업데이트
             content = updateExistingMask(content, existingSection, input.effectivenessScore, input.usageNote);
             action = 'updated';
         }
         else {
-            // 3b. 새 가면 추가
             content = addNewMask(content, input);
             action = 'created';
         }
-        // 4. 파일 저장
         writeMasksFile(basePath, content);
         return {
             success: true,

package/dist/retrospect/retrospect.d.ts

@@ -1,23 +1,5 @@
-/**
- * Retrospect Core
- *
- * 회고 시스템의 메인 로직
- *
- * "Each function has one clear purpose" - Kent Beck
- */
 import type { RetrospectInput, RetrospectResult } from './types.js';
-/**
- * 메모리 경로 반환
- */
 declare function getMemoryPath(type: string, basePath: string): string;
-/**
- * DB 경로 반환
- */
 declare function getDbPath(basePath: string): string;
-/**
- * 회고 수행
- *
- * "Make it work, make it right, make it fast" - Kent Beck
- */
 export declare function performRetrospect(basePath: string, input: RetrospectInput): RetrospectResult;
 export { getMemoryPath, getDbPath };