maskweaver 0.9.2 → 0.9.4

package/assets/commands/meta/commands.json

@@ -19,11 +19,11 @@
       "name": "map",
       "aliases": [],
       "deprecatedAliases": [],
-      "description": "코드베이스 구조 분석 + GDC 그래프 연동",
-      "descriptionEn": "Analyze codebase structure via GDC + Graphify (knowledge graph)",
+      "description": "Analyze codebase structure via GDC and optional Graphify",
+      "descriptionEn": "Analyze codebase structure via GDC and optional Graphify",
       "category": "analysis",
       "args": [
-        { "name": "deep", "type": "boolean", "default": false, "description": "Run deep analysis with graphify-windows skill" }
+        { "name": "deep", "type": "boolean", "default": false, "description": "Run deeper Graphify analysis when available" }
       ],
       "mdFile": "weave-map.md",
       "handler": "handleMap",
@@ -33,8 +33,8 @@
       "name": "interview",
       "aliases": [],
       "deprecatedAliases": [],
-      "description": "코드베이스 맵 기반 멀티스텝 요구사항 인터뷰",
-      "descriptionEn": "Multi-step question asking until clarity, with structural change detection",
+      "description": "Ask clarifying questions until requirements and structural changes are clear",
+      "descriptionEn": "Ask clarifying questions until requirements and structural changes are clear",
       "category": "analysis",
       "args": [
         { "name": "docsPath", "type": "string", "required": false, "description": "Path to requirements documents" }
@@ -47,12 +47,12 @@
       "name": "prepare",
       "aliases": [],
       "deprecatedAliases": [],
-      "description": "research + spec + plan을 한 번에 생성 (큰 계획은 자동 분할)",
-      "descriptionEn": "Create research + spec + plan with defaults (auto-splits oversized plans)",
+      "description": "Create research, spec, and phase plan artifacts from requirements",
+      "descriptionEn": "Create research, spec, and phase plan artifacts from requirements",
       "category": "planning",
       "args": [
         { "name": "docsPath", "type": "string", "required": false, "description": "Path to requirements documents" },
-        { "name": "planName", "type": "string", "required": false, "description": "Plan name (kebab-case)" },
+        { "name": "planName", "type": "string", "required": false, "description": "Plan name in kebab-case" },
         { "name": "splitPlans", "type": "boolean", "default": true, "description": "Auto-split oversized plans into multiple shard plan files" },
         { "name": "splitMaxPhases", "type": "number", "default": 3, "min": 2, "max": 8, "description": "Max phases per shard when splitPlans is enabled" },
         { "name": "splitMaxHours", "type": "number", "default": 10, "min": 4, "max": 40, "description": "Max estimated hours per shard when splitPlans is enabled" }
@@ -65,11 +65,11 @@
       "name": "refine-plan",
       "aliases": [],
       "deprecatedAliases": [],
-      "description": "Apply structured plan-note directives to active plan",
-      "descriptionEn": "Apply structured plan-note directives to active plan",
+      "description": "Apply structured plan-note directives to the active plan",
+      "descriptionEn": "Apply structured plan-note directives to the active plan",
       "category": "planning",
       "args": [
-        { "name": "notesPath", "type": "string", "required": false, "description": "Path to structured plan notes (default: tasks/plan-notes.md)" },
+        { "name": "notesPath", "type": "string", "required": false, "description": "Path to structured plan notes" },
         { "name": "applyNotes", "type": "boolean", "default": true, "description": "Auto-apply plan notes during approve" }
       ],
       "mdFile": "weave-refine-plan.md",
@@ -80,11 +80,11 @@
       "name": "approve",
       "aliases": [],
       "deprecatedAliases": [],
-      "description": "Plan 승인 게이트 통과 (구현 전 필수)",
+      "description": "Approve the plan, or finalize a crafted phase when phaseId is provided",
       "descriptionEn": "Approve the plan, or finalize a crafted phase when phaseId is provided",
       "category": "planning",
       "args": [
-        { "name": "phaseId", "type": "string", "required": false, "description": "Phase ID to finalize (optional)" },
+        { "name": "phaseId", "type": "string", "required": false, "description": "Phase ID to finalize" },
         { "name": "planReview", "type": "string", "required": false, "description": "Plan review summary text" },
         { "name": "applyNotes", "type": "boolean", "default": true, "description": "Auto-apply plan notes during approve" }
       ],
@@ -96,12 +96,12 @@
       "name": "craft",
       "aliases": [],
       "deprecatedAliases": [],
-      "description": "단일 Phase 수동 실행 준비 (실행 컨텍스트 생성)",
-      "descriptionEn": "Prepare execution context for a phase (phase auto-select if omitted)",
+      "description": "Prepare execution context for a phase",
+      "descriptionEn": "Prepare execution context for a phase",
       "category": "execution",
       "args": [
-        { "name": "phaseId", "type": "string", "required": false, "description": "Phase ID (auto-select if omitted)" },
-        { "name": "projectType", "type": "string", "required": false, "description": "Project type hint (react, nextjs, go, etc.)" }
+        { "name": "phaseId", "type": "string", "required": false, "description": "Phase ID, auto-selected if omitted" },
+        { "name": "projectType", "type": "string", "required": false, "description": "Project type hint" }
       ],
       "mdFile": "weave-craft.md",
       "handler": "handleCraft",
@@ -111,14 +111,14 @@
       "name": "build",
       "aliases": [],
       "deprecatedAliases": [],
-      "description": "자율 빌드 루프 실행 및 관리",
-      "descriptionEn": "Autonomous build loop — run, resume, or inspect builds",
+      "description": "Run, resume, stop, list, or inspect autonomous build loops",
+      "descriptionEn": "Run, resume, stop, list, or inspect autonomous build loops",
       "category": "execution",
       "args": [
         { "name": "action", "type": "enum", "values": ["run", "status", "stop", "list", "resume", "sync"], "default": "run", "description": "Build sub-action" },
         { "name": "phaseIds", "type": "string", "required": false, "description": "Comma-separated phase IDs for run action" },
         { "name": "buildId", "type": "string", "required": false, "description": "Build ID for status/stop/resume/sync actions" },
-        { "name": "maxRetries", "type": "number", "default": 3, "min": 1, "max": 10, "description": "Maximum retries per task (for run action)" },
+        { "name": "maxRetries", "type": "number", "default": 3, "min": 1, "max": 10, "description": "Maximum retries per task" },
         { "name": "maxIterations", "type": "number", "default": 1, "min": 1, "max": 20, "description": "Maximum loop iterations before blocking" },
         { "name": "maxNoProgress", "type": "number", "default": 1, "min": 0, "max": 10, "description": "Maximum repeated no-progress failures before blocking" }
       ],
@@ -136,8 +136,8 @@
       "name": "status",
       "aliases": [],
       "deprecatedAliases": [],
-      "description": "전체 플랜 목록 + 진행 상황 확인",
-      "descriptionEn": "View overall progress",
+      "description": "View plans, active phase, and progress",
+      "descriptionEn": "View plans, active phase, and progress",
       "category": "management",
       "args": [],
       "mdFile": "weave-status.md",
@@ -148,8 +148,8 @@
       "name": "worktree",
       "aliases": [],
       "deprecatedAliases": [],
-      "description": "git worktree 기반 병렬 작업 관리",
-      "descriptionEn": "Manage git worktrees for parallel work",
+      "description": "Manage git worktrees for parallel phase or feature work",
+      "descriptionEn": "Manage git worktrees for parallel phase or feature work",
       "category": "management",
       "args": [
         { "name": "worktreeAction", "type": "enum", "values": ["create", "list", "open", "remove", "merge"], "required": false, "description": "Worktree action" },
@@ -165,8 +165,8 @@
       "name": "verify",
       "aliases": [],
       "deprecatedAliases": [],
-      "description": "빌드/테스트 검증 실행 (프로젝트 유형 자동 감지)",
-      "descriptionEn": "Run build/test verification for current worktree",
+      "description": "Run build and test verification for the current worktree",
+      "descriptionEn": "Run build and test verification for the current worktree",
       "category": "management",
       "args": [
         { "name": "verifyMode", "type": "enum", "values": ["quick", "full"], "default": "full", "description": "Verification mode" },
@@ -180,7 +180,7 @@
       "name": "archive",
       "aliases": [],
       "deprecatedAliases": [],
-      "description": "검증된 변경사항 아카이브",
+      "description": "Archive the verified active change artifact",
       "descriptionEn": "Archive the verified active change artifact",
       "category": "management",
       "args": [],
@@ -192,13 +192,13 @@
       "name": "troubleshoot",
       "aliases": [],
       "deprecatedAliases": [],
-      "description": "글로벌 지식 검색 및 솔루션 기록",
+      "description": "Search global knowledge for solutions or record a new one",
       "descriptionEn": "Search global knowledge for solutions or record a new one",
       "category": "knowledge",
       "args": [
         { "name": "error", "type": "string", "required": false, "description": "Error message to search solutions for" },
         { "name": "record", "type": "boolean", "default": false, "description": "Record a new solution instead of searching" },
-        { "name": "solution", "type": "string", "required": false, "description": "Solution to record (when record=true)" },
+        { "name": "solution", "type": "string", "required": false, "description": "Solution to record when record=true" },
         { "name": "context", "type": "string", "required": false, "description": "Context for the troubleshooting entry" }
       ],
       "mdFile": "weave-troubleshoot.md",
@@ -212,7 +212,7 @@
       "name": "repair",
       "aliases": [],
       "deprecatedAliases": [],
-      "description": "plan YAML 파일 자동 검사 및 수리",
+      "description": "Scan and auto-repair corrupted plan YAML files",
       "descriptionEn": "Scan and auto-repair corrupted plan YAML files",
       "category": "knowledge",
       "args": [],
@@ -224,11 +224,11 @@
       "name": "agents",
       "aliases": [],
       "deprecatedAliases": [],
-      "description": "에이전트 파일 동기화 및 설정 초기화",
-      "descriptionEn": "Sync dummy-human agent files and initialize configuration",
+      "description": "Sync generated agent files and initialize runtime configuration",
+      "descriptionEn": "Sync generated agent files and initialize runtime configuration",
       "category": "configuration",
       "args": [
-        { "name": "sync", "type": "boolean", "default": false, "description": "Force regenerate agent .md files from config pool" },
+        { "name": "sync", "type": "boolean", "default": false, "description": "Force regenerate agent markdown files from config pool" },
         { "name": "init", "type": "boolean", "default": false, "description": "Create default maskweaver.config.json with pool template" }
       ],
       "mdFile": "weave-agents.md",
@@ -242,7 +242,7 @@
       "name": "help",
       "aliases": [],
       "deprecatedAliases": [],
-      "description": "Weave 워크플로우 도움말",
+      "description": "Show weave workflow help",
       "descriptionEn": "Show weave workflow help",
       "category": "meta",
       "args": [],

package/assets/commands/weave-agents.md

@@ -1,62 +1,22 @@
 ---
-description: 에이전트 파일 동기화 및 설정 초기화
+description: Sync generated agent files and initialize runtime configuration
 ---
 
-# /weave-agents - 에이전트 및 설정 관리
+# /weave-agents
 
-## 개요
+Manage the agent files that Maskweaver exposes to opencode.
 
-에이전트 파일과 설정 파일을 관리합니다. 기존 `sync-agents`와 `init-config`를 통합한 명령어입니다.
+Use the `weave` tool:
 
-| 플래그 | 설명 | 대응 기존 명령어 |
-|--------|------|-----------------|
-| `sync` | 설정 기준으로 더미 에이전트 파일 강제 재생성 | `weave sync-agents` |
-| `init` | 기본 설정 파일(maskweaver.config.json) 생성 | `weave init-config` |
-
----
-
-## 사용법
-
-```bash
-# 에이전트 파일 동기화
-/weave-agents --sync
-
-# 기본 설정 파일 생성
-/weave-agents --init
-
-# 동시 실행
-/weave-agents --sync --init
-```
-
----
-
-## 입력
-
-```yaml
-sync: true   # (선택) 에이전트 파일 강제 재생성
-init: true   # (선택) 기본 설정 파일 생성 (기존 파일 덮어쓰지 않음)
-```
-
----
-
-## 출력 예시
-
-### 동기화
-
-```markdown
-## 🔄 Agent Sync
-
-✅ Updated: `.opencode/agents/dummy-human-1.md`
-✅ Updated: `.opencode/agents/dummy-human-2.md`
-
-> ⚠️ **Important:** You may need to restart OpenCode for the updated agent files to take effect.
+```txt
+weave command=agents sync=true
+weave command=agents init=true
 ```
 
-### 설정 초기화
+## Modes
 
-```markdown
-## 📝 Config Initialization
+- `sync=true`: regenerate `.opencode/agents/*.md` from the configured dummy-human pool.
+- `init=true`: create the default runtime and plugin configuration files when they do not exist.
+- `sync=true init=true`: initialize config and refresh generated agent files in one pass.
 
-✅ Created runtime config: maskweaver.config.json
-✅ Created plugin config: .opencode/maskweaver.json
-```
+Prefer this command when agent markdown files are missing, stale, or out of sync with `maskweaver.config.json`.

package/assets/commands/weave-approve.md

@@ -1,61 +1,22 @@
 ---
-description: Plan 승인 게이트 통과 (구현 전 필수)
+description: Approve the plan or finalize a crafted phase
 ---
 
-# /weave-approve - Plan 승인 게이트
+# /weave-approve
 
-## 개요
+Pass the approval gate before implementation, or finalize a phase after craft and verify have completed.
 
-구현 전 **반드시 통과해야 하는 승인 게이트**입니다. Plan을 검토하고 승인하거나, 이미 craft 완료된 Phase를 최종 확정(finalize)합니다.
+Use the `weave` tool:
 
-**이전 명령어**: `approve-plan` (v0.9까지 alias로 동작)
-
----
-
-## 사용법
-
-```bash
-# Plan 승인 (가장 일반적)
-/weave-approve
-
-# Craft 완료된 Phase 최종 확정
-/weave-approve P1
+```txt
+weave command=approve
+weave command=approve phaseId="P1"
 ```
 
----
-
-## 입력
-
-```yaml
-phaseId: "P1"          # (선택) 최종 확정할 Phase ID. 미지정 시 Plan 승인
-planReview: "..."      # (선택) Plan 검토 요약
-applyNotes: true       # (선택) plan-notes 자동 반영 여부 (기본: true)
-```
-
----
+## Behavior
 
-## 동작 흐름
+- Without `phaseId`, approve the active plan so implementation can begin.
+- With `phaseId`, finalize the crafted phase after verification.
+- `applyNotes=true` applies structured notes before approval when plan notes are present.
 
-```
-1. 활성 Plan 로드
-2. phaseId 미지정 → Plan 승인
-   └─ applyNotes=true → plan-notes 자동 반영 후 승인
-3. phaseId 지정 → Phase 최종 확정 (finalize)
-   └─ verify → 통과 시 완료 처리
-```
-
----
-
-## 출력 예시
-
-### Plan 승인
-
-```markdown
-## ✅ Plan Approved
-
-- Plan: `.opencode/weave/plans/emotion-diary.yaml`
-- Approved at: 2025-04-28T10:30:00.000Z
-- Review note: Approved without additional notes.
-
-다음 단계: `weave command=craft phaseId="P1"`
-```
+Do not treat approval as a substitute for verification. Use `/weave-verify` or `/build` for evidence before finalizing work.

package/assets/commands/weave-archive.md

@@ -0,0 +1,21 @@
+---
+description: Archive the verified active change artifact
+---
+
+# /weave-archive
+
+Archive the active change after implementation has been verified and the phase or plan no longer needs to stay active.
+
+Use the `weave` tool:
+
+```txt
+weave command=archive
+```
+
+## When To Use
+
+- The active change has passed build/test verification.
+- The user has accepted the implementation result.
+- The plan should be preserved for history but removed from the active workflow.
+
+Do not archive unverified work. Run `/weave-verify` or `/build` first and keep the verification result in the change record.

package/assets/commands/weave-build.md

@@ -1,99 +1,30 @@
 ---
-description: 자율 빌드 루프 실행 및 관리 (run, status, stop, list, resume, sync)
+description: Run, resume, stop, list, or inspect autonomous build loops
 ---
 
-# /weave-build - 자율 빌드 루프 실행 및 관리
+# /weave-build
 
-## 개요
+Run the Maskweaver autonomous build loop for approved phases, or manage an existing build loop.
 
-승인된 플랜의 지정된 Phase(들)를 **자율 빌드 루프**로 실행하거나, 기존 빌드의 상태를 확인/관리합니다.
+Use the `weave` tool:
 
-| 서브 액션 | 설명 | 대응 기존 명령어 |
-|-----------|------|-----------------|
-| `run` (기본) | 활성 Phase를 Ralph-loop로 자율 실행 | `weave build`, `weave loop-run` |
-| `status` | 특정 빌드/루프의 상태 확인 | `weave loop-status` |
-| `stop` | 실행 중인 빌드/루프 중단 요청 | `weave loop-stop` |
-| `list` | 모든 빌드/루프 목록 조회 | `weave loop-list` |
-| `resume` | 중단(blocked)된 빌드 재개 | `weave build-resume` |
-| `sync` | 위임된 squad 결과 동기화 | `weave loop-sync` |
-
----
-
-## 사용법
-
-```bash
-# 자율 빌드 시작 (기본)
-/weave-build
-/weave-build P1,P2
-
-# 빌드 상태 확인
-/weave-build --status build-20250428-a1b2
-
-# 빌드 중단
-/weave-build --stop build-20250428-a1b2
-
-# 빌드 목록
-/weave-build --list
-
-# 중단 빌드 재개
-/weave-build --resume build-20250428-a1b2
-
-# 위임 결과 동기화
-/weave-build --sync build-20250428-a1b2
+```txt
+weave command=build
+weave command=build action=run phaseIds="P1,P2"
+weave command=build action=status buildId="build-20250428-a1b2"
+weave command=build action=stop buildId="build-20250428-a1b2"
+weave command=build action=list
+weave command=build action=resume buildId="build-20250428-a1b2"
+weave command=build action=sync buildId="build-20250428-a1b2"
 ```
 
----
-
-## 입력
-
-```yaml
-action: run | status | stop | list | resume | sync   # (선택) 서브 액션. 기본값: run
-phaseIds: "P1,P2"                                     # (선택, action=run) 쉼표로 구분된 Phase ID
-buildId: "build-xxx"                                  # (선택, action=status/stop/resume/sync) 대상 빌드 ID
-maxRetries: 3                                         # (선택, action=run) 태스크당 최대 재시도
-maxIterations: 1                                      # (선택) 최대 반복 횟수
-maxNoProgress: 1                                      # (선택) 무진행 허용 횟수
-```
-
----
-
-## 출력 예시
-
-### 성공 (run)
-
-```markdown
-## ✅ Build Complete
-
-**Build ID**: `build-20250428-a1b2`
-**Plan**: `emotion-diary`
-**Phases**: P1, P2
-
-| Phase | 상태 | 소요 시간 |
-|-------|------|----------|
-| P1 | ✅ 완료 | 12분 |
-| P2 | ✅ 완료 | 8분 |
-```
-
-### 일부 실패 (blocked)
-
-```markdown
-## ⚠️ Build Blocked
-
-**Build ID**: `build-20250428-c3d4`
-**Plan**: `emotion-diary`
-
-| Phase | 상태 | 실패 원인 |
-|-------|------|----------|
-| P1 | ✅ 완료 | - |
-| P2 | 🚫 blocked | 타입 검증 실패 (3회 재시도 소진) |
-
-**다음 동작**: `weave build action=resume buildId="build-20250428-c3d4"`
-```
-
----
+## Actions
 
-## 관련 명령어
+- `run`: execute selected phases, or the next approved work when phase IDs are omitted.
+- `status`: inspect one build loop.
+- `stop`: request a running loop to stop.
+- `list`: show known build loops.
+- `resume`: continue a blocked or stopped build.
+- `sync`: import squad/runtime results into the build record.
 
-- `/weave-craft [phaseId]` — 단일 Phase 수동 실행 준비
-- `/weave-verify` — 현재 워크트리 검증
-- `/weave-status` — 전체 진행 상황
+The short `/build` command is also installed for opencode users who expect build to appear as a direct command.

package/assets/commands/weave-craft.md

@@ -1,43 +1,22 @@
----
-description: Phase 실행 준비 (실행 컨텍스트 생성)
----
-
-# /weave-craft - Phase 실행 준비
-
-## 개요
-
-`/weave-craft`는 활성 플랜의 Phase를 실행 가능한 상태로 준비합니다.
-
-- 대상 phase 자동 선택(또는 직접 지정)
-- phase 상태/실행 계획 로드
-- 구현에 필요한 다음 액션 안내
-
-> 이 명령은 과거 자동 루프를 돌리지 않습니다.
-
-## 사용법
-
-```txt
-/weave-craft $ARGUMENTS
-```
-
-- `$ARGUMENTS` = 선택적 Phase ID (`P1`, `P2` 등)
-
-예시:
-
-```txt
-/weave-craft
-/weave-craft P1
-```
-
-## 내부 호출
-
-```txt
-weave command=craft phaseId="$ARGUMENTS"
-```
-
-## 권장 흐름
-
-1. `weave command=craft`로 phase 실행 컨텍스트 준비
-2. 코드 구현/위임 수행
-3. `weave command=verify`로 검증
-4. `weave command=approve-plan`으로 phase 확정
+---
+description: Prepare execution context for a phase
+---
+
+# /weave-craft
+
+Prepare one approved phase for implementation.
+
+Use the `weave` tool:
+
+```txt
+weave command=craft
+weave command=craft phaseId="P1"
+```
+
+## Behavior
+
+- Selects the next runnable phase when `phaseId` is omitted.
+- Loads plan, spec, masks, and execution context for the chosen phase.
+- Gives the implementer the bounded task context needed to start work.
+
+After implementation, run `/weave-verify` or `/build` before using `/weave-approve` to finalize the phase.