maskweaver 0.9.2 → 0.9.4

package/assets/commands/weave-refine-plan.md

@@ -1,59 +1,26 @@
----
-description: plan-notes 지시문을 active plan에 자동 반영
----
-
-# /weave-refine-plan - 계획 정제(Annotation Cycle)
-
-## 개요
-
-`/weave-refine-plan`은 `tasks/plan-notes.md`의 지시문을 읽어서 active plan YAML에 자동 반영합니다.
-
-- 구현 전에 계획을 여러 번 정제하는 annotation cycle용
-- 반영이 일어나면 plan 승인 상태를 자동으로 해제
-- 반영 후에는 `weave approve-plan`을 다시 실행해야 구현 가능
-
----
-
-## 기본 사용법
-
-```txt
-/weave-refine-plan
-```
-
-내부 호출:
-
-```txt
-weave command=refine-plan
-```
-
-노트 파일 경로를 바꾸려면:
-
-```txt
-weave command=refine-plan notesPath="tasks/my-plan-notes.md"
-```
-
----
-
-## 노트 문법 (예시)
-
-`tasks/plan-notes.md`에 아래처럼 작성:
-
-```txt
-@plan vision: 로그인 이후 대시보드 흐름을 단순화한다
-@arch frontend: React + Vite + TanStack Query
-
-@phase P1 done_when: 유저가 이메일/비밀번호로 로그인할 수 있다
-@phase P1 add_checklist: 로그인 실패 메시지가 명확히 보인다
-
-@phase add P4: 운영 모니터링 | done=로그/메트릭 대시보드가 동작한다 | hours=3
-@phase remove P7
-```
-
----
-
-## 다음 단계
-
-```txt
-weave command=approve-plan
-weave command=craft
-```
+---
+description: Apply structured plan-note directives to the active plan
+---
+
+# /weave-refine-plan
+
+Apply structured review notes to the active plan before approval.
+
+Use the `weave` tool:
+
+```txt
+weave command=refine-plan
+weave command=refine-plan notesPath="tasks/plan-notes.md"
+```
+
+## Note Examples
+
+```txt
+@plan vision: Keep the first release focused on login and dashboard.
+@phase P1 done_when: A user can sign in with email and password.
+@phase P1 add_checklist: Failed login shows a clear message.
+@phase add P4: Observability | done=errors are logged | hours=3
+@phase remove P7
+```
+
+Run `/weave-approve` again after changing the active plan.

package/assets/commands/weave-repair.md

@@ -1,70 +1,22 @@
----
-description: 깨진 YAML 플랜 파일을 스캔하고 자동 수복
----
-
-# /weave-repair - YAML 자동 수복
-
-## 개요
-
-Weave 플랜 YAML 파일의 손상을 감지하고 자동으로 수복합니다.
-
-**사용법**:
-- `/weave-repair` — 전체 플랜 파일 스캔 및 수복
-- `/weave-repair $ARGUMENTS` — 특정 파일만 수복 (예: `holon-x-openclaw-evolution-v3`)
-
----
-
-## 실행 절차
-
-### 1단계: 플랜 파일 스캔
-
-```
-1. .opencode/weave/state.yaml 확인
-2. .opencode/weave/plans/ 디렉토리의 모든 .yaml 파일 목록 확인
-3. .opencode/weave/PLAN.yaml (레거시) 확인
-```
-
-### 2단계: weave tool로 수복 실행
-
-`weave command=repair`를 호출하여 자동 수복을 실행합니다.
-
-### 3단계: 결과 보고
-
-수복 결과를 유저에게 보여줍니다:
-- **OK**: 정상 파일
-- **FIXED**: 자동 수복 성공 (무엇을 고쳤는지 표시)
-- **FAIL**: 자동 수복 불가 (유저에게 복구 옵션 안내)
-
----
-
-## 자동 수복 가능한 문제
-
-| 문제 | 예시 | 수복 방법 |
-|------|------|----------|
-| 닫히지 않은 따옴표 | `done_when: "1. fs.edit가 SecurityHook에` | 내부 따옴표 이스케이프 후 닫기 |
-| 탭 문자 | 들여쓰기에 탭 사용 | 스페이스 2칸으로 변환 |
-| 줄바꿈 문제 | CR+LF 혼합 | LF로 통일 |
-| 백업 복원 | 파싱 완전 실패 | `.bak` 파일에서 복원 |
-
----
-
-## 자동 수복 불가한 경우
-
-수복이 불가능한 파일이 있으면 유저에게 다음 옵션을 안내합니다:
-
-1. **원본 요구사항이 있다면**: `/weave-design`으로 플랜 재생성
-2. **`.corrupted` 백업 확인**: plans 디렉토리에 백업 파일 존재 여부
-3. **수동 복구**: 유저가 플랜 내용을 기억하면 그 정보로 YAML 재구성
-
-**유저에게 물어볼 것**:
-- 해당 플랜의 프로젝트 이름이 무엇이었는지
-- 어떤 Phase들이 있었는지
-- 각 Phase의 진행 상태 (완료/진행중/대기)
-
----
-
-## 참고
-
-- 수복 시 원본 파일은 `.corrupted` 확장자로 백업됩니다
-- 매 저장마다 `.bak` 백업이 자동 생성됩니다
-- `weave status`나 `weave craft` 실행 시에도 YAML 로드 실패하면 자동 수복을 시도합니다
+---
+description: Scan and auto-repair corrupted plan YAML files
+---
+
+# /weave-repair
+
+Repair malformed Weave plan YAML when status, craft, or approve cannot load the plan.
+
+Use the `weave` tool:
+
+```txt
+weave command=repair
+```
+
+## Behavior
+
+- Scans `.opencode/weave/state.yaml` and plan files.
+- Reports files as OK, fixed, or failed.
+- Creates backups before risky repairs when supported.
+- Gives manual recovery guidance when automatic repair is not possible.
+
+Use this for artifact recovery only. Do not use it to rewrite requirements or change implementation scope.

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/plugin/index.js

@@ -31,11 +31,23 @@ import { createSquadTool } from './tools/squad.js';
 import { createWeaveTool } from './tools/weave.js';
 import { createSlashcommandTool } from './tools/slashcommand.js';
 import { generatePoolAgentFilesFromConfig, writeDefaultRuntimeConfig, writeDefaultPluginConfig, } from '../shared/generate-agents.js';
+const BUILD_COMMAND_TEMPLATE = `Use the \`weave\` tool with \`command="build"\`.
+
+Forward the user arguments from \`$ARGUMENTS\` to the build command:
+
+- No arguments: run the default build loop.
+- \`status <buildId>\`: call \`weave\` with \`command="build"\`, \`action="status"\`, and \`buildId\`.
+- \`stop <buildId>\`: call \`weave\` with \`command="build"\`, \`action="stop"\`, and \`buildId\`.
+- \`list\`: call \`weave\` with \`command="build"\` and \`action="list"\`.
+- \`resume <buildId>\`: call \`weave\` with \`command="build"\`, \`action="resume"\`, and \`buildId\`.
+- \`sync <buildId>\`: call \`weave\` with \`command="build"\`, \`action="sync"\`, and \`buildId\`.
+- Otherwise, treat \`$ARGUMENTS\` as phase IDs or build options for \`action="run"\`.
+
+Do not run shell build commands directly unless the \`weave\` tool asks for verification.`;
 const REMOVED_WEAVE_COMMAND_FILES = [
     'weave-task.md',
     'weave-task-auto.md',
     'wave-task-auto.md',
-    'weave-approve.md',
 ];
 function getAssetsDir() {
     try {
@@ -967,7 +979,14 @@ ${buildRichPrompt(state.activeMask)}
         },
         // Config hook - allows plugins to modify opencode configuration
         config: async (config) => {
-            // Reserved for future configuration injection (model, provider, etc.)
+            // opencode discovers slash commands from config.command and command files.
+            // installAssets() writes command files for subsequent starts, while this
+            // hook makes the direct /build command visible on the current plugin load.
+            config.command ||= {};
+            config.command.build ||= {
+                description: 'Run or manage the Maskweaver autonomous build loop',
+                template: BUILD_COMMAND_TEMPLATE,
+            };
             return;
         },
     };

package/dist/version.d.ts

@@ -9,7 +9,7 @@
  * 2. Update this constant
  * 3. That's it — all other files import from here
  */
-export declare const VERSION = "0.9.2";
+export declare const VERSION = "0.9.4";
 /**
  * Returns a formatted version string for display.
  * @example "Maskweaver v0.7.29"

package/dist/version.js

@@ -9,7 +9,7 @@
  * 2. Update this constant
  * 3. That's it — all other files import from here
  */
-export const VERSION = '0.9.2';
+export const VERSION = '0.9.4';
 /**
  * Returns a formatted version string for display.
  * @example "Maskweaver v0.7.29"

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "maskweaver",
-  "version": "0.9.2",
+  "version": "0.9.4",
   "description": "AI Expert Persona System - Give your AI coding assistant expert personalities (가면술사)",
   "type": "module",
   "main": "./dist/index.js",