maskweaver 0.8.16 → 0.9.0

package/assets/commands/meta/commands.json

@@ -0,0 +1,254 @@
+{
+  "$schema": "./commands.schema.json",
+  "schemaVersion": "1.0",
+  "lastUpdated": "2026-04-29",
+  "commands": [
+    {
+      "name": "init",
+      "aliases": [],
+      "deprecatedAliases": [],
+      "description": "Initialize weave workspace files and probe GDC integration",
+      "descriptionEn": "Initialize weave workspace files and probe GDC integration",
+      "category": "meta",
+      "args": [],
+      "mdFile": "weave-init.md",
+      "handler": "handleInit",
+      "examples": ["weave command=init"]
+    },
+    {
+      "name": "map",
+      "aliases": [],
+      "deprecatedAliases": [],
+      "description": "코드베이스 구조 분석 + GDC 그래프 연동",
+      "descriptionEn": "Analyze codebase structure via GDC + Graphify (knowledge graph)",
+      "category": "analysis",
+      "args": [
+        { "name": "deep", "type": "boolean", "default": false, "description": "Run deep analysis with graphify-windows skill" }
+      ],
+      "mdFile": "weave-map.md",
+      "handler": "handleMap",
+      "examples": ["weave command=map", "weave command=map deep=true"]
+    },
+    {
+      "name": "interview",
+      "aliases": [],
+      "deprecatedAliases": [],
+      "description": "코드베이스 맵 기반 멀티스텝 요구사항 인터뷰",
+      "descriptionEn": "Multi-step question asking until clarity, with structural change detection",
+      "category": "analysis",
+      "args": [
+        { "name": "docsPath", "type": "string", "required": false, "description": "Path to requirements documents" }
+      ],
+      "mdFile": "weave-interview.md",
+      "handler": "handleInterview",
+      "examples": ["weave command=interview", "weave command=interview docsPath=\"docs/\""]
+    },
+    {
+      "name": "prepare",
+      "aliases": [],
+      "deprecatedAliases": [],
+      "description": "research + spec + plan을 한 번에 생성 (큰 계획은 자동 분할)",
+      "descriptionEn": "Create research + spec + plan with defaults (auto-splits oversized plans)",
+      "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": "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" }
+      ],
+      "mdFile": "weave-prepare.md",
+      "handler": "handlePrepare",
+      "examples": ["weave command=prepare docsPath=\"docs/\"", "weave command=prepare docsPath=\"docs/\" planName=\"emotion-diary\""]
+    },
+    {
+      "name": "refine-plan",
+      "aliases": [],
+      "deprecatedAliases": [],
+      "description": "Apply structured plan-note directives to active plan",
+      "descriptionEn": "Apply structured plan-note directives to active plan",
+      "category": "planning",
+      "args": [
+        { "name": "notesPath", "type": "string", "required": false, "description": "Path to structured plan notes (default: tasks/plan-notes.md)" },
+        { "name": "applyNotes", "type": "boolean", "default": true, "description": "Auto-apply plan notes during approve" }
+      ],
+      "mdFile": "weave-refine-plan.md",
+      "handler": "handleRefinePlan",
+      "examples": ["weave command=refine-plan"]
+    },
+    {
+      "name": "approve",
+      "aliases": [],
+      "deprecatedAliases": [],
+      "description": "Plan 승인 게이트 통과 (구현 전 필수)",
+      "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": "planReview", "type": "string", "required": false, "description": "Plan review summary text" },
+        { "name": "applyNotes", "type": "boolean", "default": true, "description": "Auto-apply plan notes during approve" }
+      ],
+      "mdFile": "weave-approve.md",
+      "handler": "handleApprove",
+      "examples": ["weave command=approve", "weave command=approve phaseId=\"P1\""]
+    },
+    {
+      "name": "craft",
+      "aliases": [],
+      "deprecatedAliases": [],
+      "description": "단일 Phase 수동 실행 준비 (실행 컨텍스트 생성)",
+      "descriptionEn": "Prepare execution context for a phase (phase auto-select if omitted)",
+      "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.)" }
+      ],
+      "mdFile": "weave-craft.md",
+      "handler": "handleCraft",
+      "examples": ["weave command=craft", "weave command=craft phaseId=\"P1\""]
+    },
+    {
+      "name": "build",
+      "aliases": [],
+      "deprecatedAliases": [],
+      "description": "자율 빌드 루프 실행 및 관리",
+      "descriptionEn": "Autonomous build loop — run, resume, or inspect builds",
+      "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": "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" }
+      ],
+      "mdFile": "weave-build.md",
+      "handler": "handleBuild",
+      "examples": [
+        "weave command=build",
+        "weave command=build action=run phaseIds=\"P1,P2\"",
+        "weave command=build action=status buildId=\"build-20250428-a1b2\"",
+        "weave command=build action=resume buildId=\"build-20250428-a1b2\"",
+        "weave command=build action=list"
+      ]
+    },
+    {
+      "name": "status",
+      "aliases": [],
+      "deprecatedAliases": [],
+      "description": "전체 플랜 목록 + 진행 상황 확인",
+      "descriptionEn": "View overall progress",
+      "category": "management",
+      "args": [],
+      "mdFile": "weave-status.md",
+      "handler": "handleStatus",
+      "examples": ["weave command=status"]
+    },
+    {
+      "name": "worktree",
+      "aliases": [],
+      "deprecatedAliases": [],
+      "description": "git worktree 기반 병렬 작업 관리",
+      "descriptionEn": "Manage git worktrees for parallel work",
+      "category": "management",
+      "args": [
+        { "name": "worktreeAction", "type": "enum", "values": ["create", "list", "open", "remove", "merge"], "required": false, "description": "Worktree action" },
+        { "name": "name", "type": "string", "required": false, "description": "Worktree name" },
+        { "name": "fromRef", "type": "string", "required": false, "description": "Base git ref to branch from" },
+        { "name": "deleteBranch", "type": "boolean", "default": false, "description": "Delete branch when removing worktree" }
+      ],
+      "mdFile": "weave-worktree.md",
+      "handler": "handleWorktree",
+      "examples": ["weave command=worktree worktreeAction=list"]
+    },
+    {
+      "name": "verify",
+      "aliases": [],
+      "deprecatedAliases": [],
+      "description": "빌드/테스트 검증 실행 (프로젝트 유형 자동 감지)",
+      "descriptionEn": "Run build/test verification for current worktree",
+      "category": "management",
+      "args": [
+        { "name": "verifyMode", "type": "enum", "values": ["quick", "full"], "default": "full", "description": "Verification mode" },
+        { "name": "projectType", "type": "string", "required": false, "description": "Project type hint" }
+      ],
+      "mdFile": "weave-verify.md",
+      "handler": "handleVerify",
+      "examples": ["weave command=verify", "weave command=verify verifyMode=quick"]
+    },
+    {
+      "name": "archive",
+      "aliases": [],
+      "deprecatedAliases": [],
+      "description": "검증된 변경사항 아카이브",
+      "descriptionEn": "Archive the verified active change artifact",
+      "category": "management",
+      "args": [],
+      "mdFile": "weave-archive.md",
+      "handler": "handleArchive",
+      "examples": ["weave command=archive"]
+    },
+    {
+      "name": "troubleshoot",
+      "aliases": [],
+      "deprecatedAliases": [],
+      "description": "글로벌 지식 검색 및 솔루션 기록",
+      "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": "context", "type": "string", "required": false, "description": "Context for the troubleshooting entry" }
+      ],
+      "mdFile": "weave-troubleshoot.md",
+      "handler": "handleTroubleshoot",
+      "examples": [
+        "weave command=troubleshoot error=\"Cannot find module 'xyz'\"",
+        "weave command=troubleshoot record=true solution=\"Restart dev server\""
+      ]
+    },
+    {
+      "name": "repair",
+      "aliases": [],
+      "deprecatedAliases": [],
+      "description": "plan YAML 파일 자동 검사 및 수리",
+      "descriptionEn": "Scan and auto-repair corrupted plan YAML files",
+      "category": "knowledge",
+      "args": [],
+      "mdFile": "weave-repair.md",
+      "handler": "handleRepair",
+      "examples": ["weave command=repair"]
+    },
+    {
+      "name": "agents",
+      "aliases": [],
+      "deprecatedAliases": [],
+      "description": "에이전트 파일 동기화 및 설정 초기화",
+      "descriptionEn": "Sync dummy-human agent files and initialize configuration",
+      "category": "configuration",
+      "args": [
+        { "name": "sync", "type": "boolean", "default": false, "description": "Force regenerate agent .md files from config pool" },
+        { "name": "init", "type": "boolean", "default": false, "description": "Create default maskweaver.config.json with pool template" }
+      ],
+      "mdFile": "weave-agents.md",
+      "handler": "handleAgents",
+      "examples": [
+        "weave command=agents sync=true",
+        "weave command=agents init=true"
+      ]
+    },
+    {
+      "name": "help",
+      "aliases": [],
+      "deprecatedAliases": [],
+      "description": "Weave 워크플로우 도움말",
+      "descriptionEn": "Show weave workflow help",
+      "category": "meta",
+      "args": [],
+      "mdFile": "weave-help.md",
+      "handler": "getHelpMessage",
+      "examples": ["weave command=help"]
+    }
+  ]
+}

package/assets/commands/weave-agents.md

@@ -0,0 +1,62 @@
+---
+description: 에이전트 파일 동기화 및 설정 초기화
+---
+
+# /weave-agents - 에이전트 및 설정 관리
+
+## 개요
+
+에이전트 파일과 설정 파일을 관리합니다. 기존 `sync-agents`와 `init-config`를 통합한 명령어입니다.
+
+| 플래그 | 설명 | 대응 기존 명령어 |
+|--------|------|-----------------|
+| `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.
+```
+
+### 설정 초기화
+
+```markdown
+## 📝 Config Initialization
+
+✅ Created runtime config: maskweaver.config.json
+✅ Created plugin config: .opencode/maskweaver.json
+```

package/assets/commands/weave-approve.md

@@ -0,0 +1,61 @@
+---
+description: Plan 승인 게이트 통과 (구현 전 필수)
+---
+
+# /weave-approve - Plan 승인 게이트
+
+## 개요
+
+구현 전 **반드시 통과해야 하는 승인 게이트**입니다. Plan을 검토하고 승인하거나, 이미 craft 완료된 Phase를 최종 확정(finalize)합니다.
+
+**이전 명령어**: `approve-plan` (v0.9까지 alias로 동작)
+
+---
+
+## 사용법
+
+```bash
+# Plan 승인 (가장 일반적)
+/weave-approve
+
+# Craft 완료된 Phase 최종 확정
+/weave-approve P1
+```
+
+---
+
+## 입력
+
+```yaml
+phaseId: "P1"          # (선택) 최종 확정할 Phase ID. 미지정 시 Plan 승인
+planReview: "..."      # (선택) Plan 검토 요약
+applyNotes: true       # (선택) plan-notes 자동 반영 여부 (기본: true)
+```
+
+---
+
+## 동작 흐름
+
+```
+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"`
+```

package/assets/commands/weave-build.md

@@ -0,0 +1,99 @@
+---
+description: 자율 빌드 루프 실행 및 관리 (run, status, stop, list, resume, sync)
+---
+
+# /weave-build - 자율 빌드 루프 실행 및 관리
+
+## 개요
+
+승인된 플랜의 지정된 Phase(들)를 **자율 빌드 루프**로 실행하거나, 기존 빌드의 상태를 확인/관리합니다.
+
+| 서브 액션 | 설명 | 대응 기존 명령어 |
+|-----------|------|-----------------|
+| `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
+```
+
+---
+
+## 입력
+
+```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"`
+```
+
+---
+
+## 관련 명령어
+
+- `/weave-craft [phaseId]` — 단일 Phase 수동 실행 준비
+- `/weave-verify` — 현재 워크트리 검증
+- `/weave-status` — 전체 진행 상황