maskweaver 0.9.3 → 0.9.5

package/assets/commands/weave-status.md

@@ -1,155 +1,22 @@
----
-description: 전체 플랜 목록 및 진행 상황 확인
----
-
-# /weave-status - 진행 상황 확인
-
-## 개요
-
-전체 플랜 목록과 활성 플랜의 Phase 진행 상황을 확인합니다.
-
-**사용법**:
-- `/weave-status` — 전체 개요 (모든 플랜 + 활성 플랜 상세)
-- `/weave-status $ARGUMENTS` — 특정 플랜 또는 Phase 상세
-  - `$ARGUMENTS` = 플랜 이름 (예: `emotion-diary`)
-  - `$ARGUMENTS` = Phase ID (예: `P2`, 활성 플랜의 Phase)
-
----
-
-## 데이터 로드 방법 (필수)
-
-**반드시 이 순서로 파일을 읽어야 합니다**:
-
-```
-1. .opencode/weave/state.yaml 읽기 → active_plan 확인
-2. .opencode/weave/plans/ 디렉토리의 모든 .yaml 파일 목록 확인
-3. 각 플랜 파일 읽어서 상태 집계
-```
-
-**state.yaml이 없는 경우**:
-```markdown
-📋 Weave가 초기화되지 않았습니다.
-
-시작하려면: `/weave-init`
-```
-
-**플랜이 하나도 없는 경우**:
-```markdown
-📋 아직 플랜이 없습니다.
-
-새 플랜을 만들려면: `/weave-design [docs-path]`
-```
-
----
-
-## 출력: 전체 개요 (`/weave-status`)
-
-```markdown
-## 📊 Weave 상태
-
-### 활성 플랜: `emotion-diary`
-**감정 일기 앱** — 진행률 40%
-
-[████████░░░░░░░░░░░░] 2/5
-
-| Phase | 이름 | 상태 | 마스크 |
-|-------|------|------|--------|
-| P1 | 감정 선택 UI | ✅ 완료 (2.5h) | kent-beck, dan-abramov |
-| P2 | 감정 저장 | 🔄 진행 중 | kent-beck |
-| P3 | 히스토리 뷰 | ⏳ 대기 | |
-| P4 | 통계 시각화 | ⏳ 대기 | |
-| P5 | 테마 설정 | ⏳ 대기 | |
-
-**다음**: `/weave-craft P2`
-
----
-
-### 전체 플랜 목록
-
-| 플랜 | 프로젝트 | 상태 | 진행률 |
-|------|---------|------|--------|
-| 📌 `emotion-diary` | 감정 일기 앱 | active | 40% (2/5) |
-| `todo-app` | Todo 앱 | paused | 60% (3/5) |
-| `auth-module` | 인증 모듈 | completed | 100% (4/4) |
-
-플랜 전환: `/weave-switch [플랜이름]`
-```
-
----
-
-## 출력: 특정 플랜 상세 (`/weave-status {plan-name}`)
-
-```markdown
-## 📊 플랜: `todo-app`
-
-**Todo 앱** — 상태: paused — 진행률 60%
-
-[████████████░░░░░░░░] 3/5
-
-### 비전
-사용자가 간단하게 할 일을 관리할 수 있는 웹 앱
-
-### Phases
-| Phase | 이름 | 상태 | 소요 시간 | 마스크 |
-|-------|------|------|----------|--------|
-| P1 | 기본 UI | ✅ 완료 | 2h | dan-abramov |
-| P2 | CRUD API | ✅ 완료 | 3h | martin-fowler |
-| P3 | 필터/정렬 | ✅ 완료 | 1.5h | kent-beck |
-| P4 | 드래그 정렬 | ⏳ 대기 | | |
-| P5 | PWA 지원 | ⏳ 대기 | | |
-
-### 아키텍처
-- Frontend: React + TypeScript
-- Backend: Express.js
-- Database: SQLite
-
-이 플랜으로 전환: `/weave-switch todo-app`
-```
-
----
-
-## 출력: 특정 Phase 상세 (`/weave-status P2`)
-
-활성 플랜의 해당 Phase를 상세 표시:
-
-```markdown
-## Phase P2: 감정 저장
-
-**플랜**: `emotion-diary`
-**상태**: 🔄 진행 중
-**시작**: 2026-02-06 10:30
-**경과**: 1.5시간
-
-### 사용된 마스크
-- Kent Beck
-
-### 발생한 이슈
-- 1회 재시도: JSON 직렬화 오류 → 해결됨
-
-### 다음
-`/weave-craft P2` — 계속 진행
-```
-
----
-
-## 상태 아이콘
-
-| 아이콘 | 상태 |
-|--------|------|
-| ✅ | 완료 (completed) |
-| 🔄 | 진행 중 (in_progress) |
-| ⏳ | 대기 (pending) |
-| 🚫 | 차단됨 (의존성 미완료) |
-| 📌 | 활성 플랜 표시 |
-| ⏸️ | 일시정지 (paused) |
-
----
-
-## 플랜 상태 종류
-
-| 상태 | 의미 |
-|------|------|
-| `active` | 현재 작업 중인 플랜 |
-| `paused` | 일시 중단 (다른 플랜 작업 중) |
-| `completed` | 모든 Phase 완료 |
-| `archived` | 보관됨 (목록에서 숨김, --all로 표시) |
+---
+description: View plans, active phase, and progress
+---
+
+# /weave-status
+
+Show the current Weave state.
+
+Use the `weave` tool:
+
+```txt
+weave command=status
+```
+
+## What It Reports
+
+- Whether Weave has been initialized.
+- Active plan and available plans.
+- Phase status and next recommended action.
+- Blocked, paused, completed, or archived work.
+
+Use this when resuming a project, switching plans, or checking whether a build or phase still needs verification.

package/assets/commands/weave-troubleshoot.md

@@ -1,57 +1,21 @@
 ---
-description: 글로벌 지식 검색 및 솔루션 기록
+description: Search global knowledge for solutions or record a new one
 ---
 
-# /weave-troubleshoot - 트러블슈팅
+# /weave-troubleshoot
 
-## 개요
+Search prior solution knowledge for an error, or record a new solution.
 
-글로벌 지식베이스에서 유사한 문제의 해결책을 검색하거나, 새로운 해결책을 기록합니다.
+Use the `weave` tool:
 
-**이전 명령어**: `record` (v0.9까지 deprecated alias, `--record` 플래그로 대체)
-
----
-
-## 사용법
-
-```bash
-# 해결책 검색
-/weave-troubleshoot "Cannot find module 'xyz'"
-
-# 새 해결책 기록
-/weave-troubleshoot --record error="..." solution="..."
-```
-
----
-
-## 입력
-
-```yaml
-error: "..."        # (검색 시 필수) 검색할 에러 메시지
-record: true        # (선택) 기록 모드 활성화
-solution: "..."     # (record 시 필수) 기록할 해결책
-context: "..."      # (선택) 추가 맥락
+```txt
+weave command=troubleshoot error="Cannot find module 'xyz'"
+weave command=troubleshoot record=true error="..." solution="..." context="..."
 ```
 
----
-
-## 출력 예시
+## Modes
 
-### 검색
+- Search mode: provide `error`.
+- Record mode: set `record=true` and provide `solution`.
 
-```markdown
-## 💡 유사한 해결책 발견
-
-### 1. (exact, 점수: 95%)
-**상황**: Cannot find module 'react'
-**해결책**: npm install react react-dom
-**효과성**: ⭐⭐⭐⭐⭐
-```
-
-### 기록
-
-```markdown
-✅ 트러블슈팅 솔루션이 기록되었습니다 (ID: 42)
-
-다음에 비슷한 에러가 발생하면 자동으로 이 해결책을 제안합니다.
-```
+Record only solutions that were actually validated. Prefer the exact command, config change, or code path that fixed the issue.

package/assets/commands/weave-verify.md

@@ -1,44 +1,23 @@
----
-description: 프로젝트 유형 자동 감지 기반 검증 실행 (build/test)
----
-
-# /weave-verify - 검증 실행
-
-## 개요
-
-현재 worktree(프로젝트 루트)에서 **빌드/테스트 검증**을 실행합니다.
-
-Weave는 특정 생태계(npm)만 가정하지 않고, 프로젝트 루트의 증거를 기반으로 검증 커맨드를 추천/실행합니다.
-
-- Node: `package.json scripts` 기반(`npm|pnpm|yarn|bun` 자동 감지)
-- Go: `go build ./...`, `go test ./...`
-- Rust: `cargo check`, `cargo test`
-- Python: `pytest` 또는 `python -m unittest` (+ optional ruff/mypy)
-- .NET: `dotnet build`, `dotnet test`
-
----
-
-## 실행
-
-```txt
-weave command=verify
-```
-
-프로젝트 타입 힌트를 주고 싶으면:
-
-```txt
-weave command=verify projectType="go"
-```
-
-빠르게(typecheck+tests만) 돌리려면:
-
-```txt
-weave command=verify verifyMode="quick"
-```
-
----
-
-## 결과
-
-- PASS면 `✅ Verification passed.`
-- FAIL이면 실패한 레이어와 로그(tail)를 출력합니다
+---
+description: Run build and test verification for the current worktree
+---
+
+# /weave-verify
+
+Run project-appropriate build and test checks in the current worktree.
+
+Use the `weave` tool:
+
+```txt
+weave command=verify
+weave command=verify verifyMode=quick
+weave command=verify projectType="go"
+```
+
+## Behavior
+
+- Detects common project types from files in the project root.
+- Recommends or runs build/test commands for Node, Go, Rust, Python, .NET, and similar stacks.
+- Reports command output and failure tails so the next action is clear.
+
+Verification evidence matters more than workflow metadata. Treat failing builds/tests as blockers unless the failure is clearly unrelated and already known.

package/assets/commands/weave-worktree.md

@@ -1,69 +1,27 @@
----
-description: git worktree 기반 병렬 작업(기능/Phase) 관리
----
-
-# /weave-worktree - 병렬 작업용 worktree
-
-## 개요
-
-`git worktree`를 이용해 **작업 디렉토리를 분리**하고, 여러 기능/Phase를 병렬로 진행할 수 있게 합니다.
-
-- 각 worktree는 서로 다른 브랜치 + 파일 시스템 분리
-- 충돌/오염을 줄이고, 동시에 여러 기능을 안전하게 개발할 수 있습니다
-
-Weave는 worktree 생성 시 `.opencode/weave` 아티팩트를 자동 bootstrap(복사/생성)하여,
-"weave init은 프로젝트당 1회" 원칙을 유지합니다.
-
----
-
-## 사용법
-
-### 1) worktree 생성
-
-```txt
-weave command=worktree worktreeAction=create name="feature-login"
-```
-
-### 2) 목록 보기
-
-```txt
-weave command=worktree worktreeAction=list
-```
-
-### 3) 경로 확인(열기)
-
-```txt
-weave command=worktree worktreeAction=open name="feature-login"
-```
-
-해당 폴더로 이동한 뒤, 평소처럼 진행하면 됩니다:
-
-```txt
-/weave-prepare docs/
-weave craft P1
-```
-
-### 4) 병합 가이드
-
-```txt
-weave command=worktree worktreeAction=merge name="feature-login"
-```
-
-### 5) worktree 제거
-
-```txt
-weave command=worktree worktreeAction=remove name="feature-login"
-```
-
-브랜치까지 삭제하려면:
-
-```txt
-weave command=worktree worktreeAction=remove name="feature-login" deleteBranch=true
-```
-
----
-
-## 주의(권장 정책)
-
-- 같은 파일/설정(package-lock, tsconfig 등)을 동시에 바꾸는 작업은 병렬 worktree라도 merge conflict 가능성이 큽니다
-- DB 마이그레이션/스키마 변경은 원칙적으로 순차 진행을 권장합니다
+---
+description: Manage git worktrees for parallel phase or feature work
+---
+
+# /weave-worktree
+
+Manage git worktrees so multiple phases or features can be worked on in separate directories.
+
+Use the `weave` tool:
+
+```txt
+weave command=worktree worktreeAction=create name="feature-login"
+weave command=worktree worktreeAction=list
+weave command=worktree worktreeAction=open name="feature-login"
+weave command=worktree worktreeAction=merge name="feature-login"
+weave command=worktree worktreeAction=remove name="feature-login"
+weave command=worktree worktreeAction=remove name="feature-login" deleteBranch=true
+```
+
+## Policy
+
+- Use worktrees for independent phases or features that can progress in parallel.
+- Avoid parallel worktrees when multiple tasks will edit the same lockfile, schema, generated artifact, or central config.
+- Bootstrap Weave artifacts into the new worktree so the user does not need to run `/weave-init` again.
+- Merge from the main worktree, resolve conflicts, then run integration verification once.
+
+This command explains git behavior without hiding it: each worktree has its own directory and branch, but merge conflicts are still possible when the same files change.

package/dist/cli/doctor.js

@@ -3,9 +3,6 @@ import * as path from "node:path";
 import * as os from "node:os";
 import { spawnSync } from "node:child_process";
 import { VERSION } from "../version.js";
-// ============================================================================
-// Constants
-// ============================================================================
 const MIN_OPENCODE_VERSION = "1.0.0";
 const PLUGIN_NAME = "maskweaver";
 const colors = {
@@ -18,9 +15,6 @@ const colors = {
     blue: "\x1b[34m",
     cyan: "\x1b[36m",
 };
-// ============================================================================
-// Utilities
-// ============================================================================
 function icon(status) {
     switch (status) {
         case "pass": return `${colors.green}✓${colors.reset}`;
@@ -56,9 +50,6 @@ function compareVersions(current, minimum) {
     }
     return true;
 }
-// ============================================================================
-// Checks
-// ============================================================================
 function checkOpenCodeVersion() {
     try {
         const result = spawnSync("opencode", ["--version"], {
@@ -107,7 +98,6 @@ function checkPluginRegistration() {
     const projectConfig = path.join(projectDir, "opencode.json");
     let foundIn = "";
     let legacyEntry = "";
-    // Check global
     if (fs.existsSync(globalConfig)) {
         try {
             const config = JSON.parse(fs.readFileSync(globalConfig, "utf-8"));
@@ -120,9 +110,8 @@ function checkPluginRegistration() {
                 }
             }
         }
-        catch { /* ignore */ }
+        catch { }
     }
-    // Check project
     if (!foundIn && fs.existsSync(projectConfig)) {
         try {
             const config = JSON.parse(fs.readFileSync(projectConfig, "utf-8"));
@@ -135,7 +124,7 @@ function checkPluginRegistration() {
                 }
             }
         }
-        catch { /* ignore */ }
+        catch { }
     }
     if (foundIn && legacyEntry) {
         return {
@@ -203,7 +192,7 @@ function checkMasksDirectory() {
                     location = label;
                 }
             }
-            catch { /* ignore */ }
+            catch { }
         }
     }
     if (count > 0) {
@@ -230,7 +219,7 @@ function checkAgentFiles() {
                 const files = fs.readdirSync(dir).filter((f) => f.endsWith(".md"));
                 count += files.length;
             }
-            catch { /* ignore */ }
+            catch { }
         }
     }
     if (count > 0) {
@@ -257,7 +246,7 @@ function checkCommandFiles() {
                 const files = fs.readdirSync(dir).filter((f) => f.endsWith(".md"));
                 count += files.length;
             }
-            catch { /* ignore */ }
+            catch { }
         }
     }
     if (count > 0) {
@@ -276,7 +265,6 @@ function checkCommandFiles() {
 }
 function checkGdcIntegration() {
     const projectDir = getProjectDir();
-    // Check for GDC-related files in .opencode
     const weaveDir = path.join(projectDir, "weave");
     if (fs.existsSync(weaveDir)) {
         return {
@@ -285,7 +273,6 @@ function checkGdcIntegration() {
             message: "weave/ 디렉토리 있음",
         };
     }
-    // Check for AGENTS.md (used by /init-deep)
     const agentsMd = path.join(process.cwd(), "AGENTS.md");
     if (fs.existsSync(agentsMd)) {
         return {
@@ -301,9 +288,6 @@ function checkGdcIntegration() {
         hint: "/weave init 으로 초기화하세요",
     };
 }
-// ============================================================================
-// Doctor Command
-// ============================================================================
 export function runDoctor() {
     const results = [
         checkOpenCodeVersion(),

package/dist/cli/install.d.ts

@@ -1,10 +1,2 @@
 #!/usr/bin/env node
-/**
- * Maskweaver CLI Installer
- *
- * Commands:
- * - maskweaver install   - Register plugin in opencode.json
- * - maskweaver uninstall - Remove plugin from opencode.json
- * - maskweaver status    - Show current installation status
- */
 export {};

package/dist/cli/install.js

@@ -1,12 +1,4 @@
 #!/usr/bin/env node
-/**
- * Maskweaver CLI Installer
- *
- * Commands:
- * - maskweaver install   - Register plugin in opencode.json
- * - maskweaver uninstall - Remove plugin from opencode.json
- * - maskweaver status    - Show current installation status
- */
 import { Command } from "commander";
 import * as fs from "node:fs";
 import * as path from "node:path";
@@ -14,14 +6,10 @@ import * as os from "node:os";
 import { VERSION } from "../version.js";
 import { runDoctor, printDoctorReport } from "./doctor.js";
 import { writeDefaultRuntimeConfig, writeDefaultPluginConfig } from "../shared/generate-agents.js";
-// ============================================================================
-// Constants
-// ============================================================================
 const PLUGIN_NAME = "maskweaver";
 const LEGACY_PLUGIN_NAMES = ["maskweaver/plugin", "@maskweaver/plugin"];
 const ALL_PLUGIN_NAMES = [PLUGIN_NAME, ...LEGACY_PLUGIN_NAMES];
 const CONFIG_NAME = "opencode.json";
-// ANSI Colors
 const colors = {
     reset: "\x1b[0m",
     bright: "\x1b[1m",
@@ -34,9 +22,6 @@ const colors = {
     cyan: "\x1b[36m",
     white: "\x1b[37m",
 };
-// ============================================================================
-// Utilities
-// ============================================================================
 function log(message, color) {
     const colorCode = color ? colors[color] : "";
     console.log(`${colorCode}${message}${colors.reset}`);
@@ -112,9 +97,6 @@ function normalizePluginEntries(config) {
     config.plugin = [...preserved, PLUGIN_NAME];
     return { migratedFrom, changed: true };
 }
-// ============================================================================
-// Commands
-// ============================================================================
 async function installPlugin(options) {
     const isLocal = options.local || false;
     const configPath = getConfigPath(isLocal);
@@ -126,9 +108,7 @@ async function installPlugin(options) {
     info(`설정 파일: ${configPath}`);
     log("");
     try {
-        // Read or create config
         let config = readConfig(configPath);
-        // Initialize plugin array if not exists
         if (!config.plugin) {
             config.plugin = [];
         }
@@ -140,20 +120,16 @@ async function installPlugin(options) {
             log("");
             return;
         }
-        // Check if already installed
         if (config.plugin.includes(PLUGIN_NAME)) {
             warning(`플러그인이 이미 설치되어 있습니다.`);
             info(`현재 ${scope} 설정에 등록되어 있습니다: ${PLUGIN_NAME}`);
             log("");
             return;
         }
-        // Add plugin
         config.plugin.push(PLUGIN_NAME);
-        // Save config
         writeConfig(configPath, config);
         let createdRuntimeConfig = false;
         let createdPluginConfig = false;
-        // Auto-create local maskweaver.config.json if not exists
         if (isLocal) {
             const runtimeCreated = writeDefaultRuntimeConfig(process.cwd());
             if (runtimeCreated) {
@@ -202,7 +178,6 @@ async function uninstallPlugin(options) {
     info(`설정 파일: ${configPath}`);
     log("");
     try {
-        // Read config
         if (!fs.existsSync(configPath)) {
             warning(`설정 파일이 존재하지 않습니다.`);
             info(`플러그인이 설치되어 있지 않습니다.`);
@@ -210,19 +185,15 @@ async function uninstallPlugin(options) {
             return;
         }
         let config = readConfig(configPath);
-        // Check if installed
         if (!isPluginInstalled(config)) {
             warning(`플러그인이 설치되어 있지 않습니다.`);
             log("");
             return;
         }
-        // Remove plugin
         config.plugin = config.plugin.filter((p) => !ALL_PLUGIN_NAMES.includes(p));
-        // Save config
         writeConfig(configPath, config);
         success(`플러그인이 성공적으로 제거되었습니다.`);
         log("");
-        // Cleanup notice
         log(`📋 정리 안내`, "bright");
         log(`━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━`, "dim");
         log("");
@@ -258,7 +229,6 @@ async function showStatus(options) {
     log(`━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━`, "dim");
     log("");
     try {
-        // Check global installation
         const globalPath = getConfigPath(false);
         const globalConfig = readConfig(globalPath);
         const globalInstalled = isPluginInstalled(globalConfig);
@@ -272,7 +242,6 @@ async function showStatus(options) {
             log(`   ❌ 미설치`, "dim");
         }
         log("");
-        // Check local installation
         const localPath = getConfigPath(true);
         const localConfig = fs.existsSync(localPath) ? readConfig(localPath) : {};
         const localInstalled = isPluginInstalled(localConfig);
@@ -286,7 +255,6 @@ async function showStatus(options) {
             log(`   ❌ 미설치`, "dim");
         }
         log("");
-        // Show plugin info
         if (globalInstalled || localInstalled) {
             log(`ℹ️  플러그인 정보:`, "cyan");
             log(`   이름: ${PLUGIN_NAME}`, "dim");
@@ -299,7 +267,6 @@ async function showStatus(options) {
             }
             log("");
         }
-        // Installation hint
         if (!globalInstalled && !localInstalled) {
             log(`설치하려면:`, "yellow");
             log(`  maskweaver install          # 전역 설치`, "dim");
@@ -313,9 +280,6 @@ async function showStatus(options) {
         process.exit(1);
     }
 }
-// ============================================================================
-// CLI Program
-// ============================================================================
 const program = new Command();
 program
     .name("maskweaver")
@@ -355,13 +319,10 @@ program
     printDoctorReport(report);
     process.exit(report.failed > 0 ? 1 : 0);
 });
-// Default action: show help
 program.action(() => {
     program.help();
 });
-// Parse command line arguments
 program.parse(process.argv);
-// Show help if no command provided
 if (!process.argv.slice(2).length) {
     program.help();
 }