maskweaver 0.8.16 → 0.9.0

package/assets/commands/weave-help.md

@@ -1,158 +1,112 @@
----
-description: Weave 워크플로우 도움말
----
-
-# /weave-help - Weave 워크플로우 도움말
-
-## Weave란?
-
-Maskweaver의 **Phase-Driven Development** 워크플로우입니다.
-"AI가 검증하고, 유저가 확인한다"
-
-**멀티 플랜**: 하나의 프로젝트에서 여러 플랜을 동시에 관리할 수 있습니다.
-
----
-
-## 버전 확인
-
-설치된 Maskweaver 버전을 확인하는 방법:
-
-| 방법 | 명령어 |
-|------|--------|
-| CLI | `maskweaver --version` 또는 `maskweaver -V` |
-| npm | `npm list maskweaver` |
-| 채팅 내 | `maskweaver_status` 도구 사용 |
-| Weave | `/weave help` |
-| Node.js | `import { VERSION } from 'maskweaver'` |
-
----
-
-## 핵심 철학
-
-```
-1. 테스트 먼저 (Protect Before Change)
-2. 작게 자주 (Small & Often)
-3. 동작이 정답 (Working > Perfect)
-```
-
----
-
-## 명령어 목록
-
-| 명령어 | 설명 |
-|--------|------|
-| `/weave-init` | Weave 초기화 (프로젝트당 1회) |
-| `/weave-research [docs]` | 문서+워크스페이스를 깊게 조사하고 `tasks/research.md` 생성 |
-| `/weave-spec [docs]` | 요구사항 정제 + 검증 기준(AC) 추출 (선택) |
-| `/weave-prepare [docs]` | **research + spec + plan을 한 번에 생성** (큰 계획은 자동 분할) |
-| `/weave-refine-plan` | `tasks/plan-notes.md` 지시문을 plan에 자동 반영 |
-| `/weave-approve-plan` | 구현 전 계획 승인 게이트 통과 |
-| `/weave-flow [docs]` | **원커맨드** prepare → approve-plan gate → craft |
-| `/weave-design [docs]` | 요구사항 분석 → Phase 계획 (새 플랜 생성, 큰 계획은 자동 분할) |
-| `/weave-plan [docs]` | `/weave-design` 별칭 (호환용) |
-| `/weave-craft [phase-id]` | 활성 플랜의 Phase 실행 준비 (실행 컨텍스트 생성) |
-| `/weave-status` | 전체 플랜 목록 + 진행 상황 |
-| `/weave-switch [plan]` | 활성 플랜 전환 / 아카이브 |
-| `/weave-worktree` | git worktree 기반 병렬 작업(기능/Phase) 관리 |
-| `/weave-verify` | 빌드/테스트 검증 실행(프로젝트 유형 자동 감지) |
-| `/weave-help` | 이 도움말 |
-
----
-
-## 멀티 플랜 워크플로우
-
-```
-/weave-init                    ← 프로젝트 초기화 (1회)
-    ↓
-/weave-flow docs/              ← (원커맨드) prepare→approve-plan gate→craft
-    ↓
-/weave-prepare docs/           ← (수동 경로) research+spec+plan 한 번에 생성
-    ↓
-/weave-refine-plan             ← (선택) plan-notes 기반 자동 정제
-    ↓
-/weave-approve-plan            ← 구현 전 계획 승인 (필수)
-    ↓
-/weave-craft                   ← 다음 Phase 자동 선택 실행 준비
-    ↓
-/weave-design wiki/new-feat    ← 두 번째 플랜 추가 (또는 prepare)
-    ↓
-/weave-switch first-plan       ← 첫 번째 플랜으로 돌아가기
-    ↓
-/weave-status                  ← 전체 상황 확인
-```
-
-### 플랜 상태 흐름
-
-```
-active ──→ paused ──→ active (switch로 전환)
-  │                      │
-  └──→ completed ──→ archived (switch archive)
-                         │
-                         └──→ paused (switch unarchive)
-```
-
----
-
-## 파일 구조
-
-```
-.opencode/weave/
-├── state.yaml           ← 활성 플랜 추적
-├── specs/
-│   ├── emotion-diary.yaml    ← baseline spec 1
-│   └── todo-app.yaml         ← baseline spec 2
-└── plans/
-    ├── emotion-diary.yaml   ← 플랜 1
-    ├── todo-app.yaml        ← 플랜 2
-    └── auth-module.yaml     ← 플랜 3
-```
-
----
-
-## Maskweaver 통합 기능
-
-### 마스크 자동 선택
-
-작업 맥락에 따라 전문가 마스크가 자동 선택됩니다:
-- 아키텍처 → Martin Fowler
-- 테스트 → Kent Beck
-- React → Dan Abramov
-- 성능 → Linus Torvalds
-
-### 글로벌 지식 공유
-
-트러블슈팅 경험이 프로젝트 간 공유됩니다:
-- 에러 발생 시 → 과거 솔루션 검색
-- 해결 시 → 새 솔루션 기록
-
-### 다층 자동 검증
-
-Phase 실행 시 자동 검증:
-1. TypeCheck → Lint → Build
-2. Unit Tests → E2E Tests
-3. Screenshot → A11y Check
-
----
-
-## 빠른 시작
-
-```bash
-# 1. 초기화 (프로젝트당 1회)
-/weave-init
-
-# 2. (추천) spec + plan을 한 번에 생성
-/weave-prepare wiki/
-
-# 3. 계획 검토 후 승인 게이트 통과
-/weave-refine-plan   # (선택) notes 반영
-/weave-approve-plan
-
-# 4. 다음 Phase 자동 선택 실행
-/weave-craft
-
-# 5. 새 기능 추가? 새 플랜!
-/weave-design docs/new-feature
-
-# 6. 플랜 사이 전환
-/weave-switch emotion-diary
-```
+---
+description: Weave 워크플로우 도움말
+---
+
+# /weave-help - Weave 워크플로우 도움말
+
+## Weave란?
+
+Maskweaver의 **Phase-Driven Development** 워크플로우입니다.
+"AI가 검증하고, 유저가 확인한다"
+
+**멀티 플랜**: 하나의 프로젝트에서 여러 플랜을 동시에 관리할 수 있습니다.
+
+---
+
+## 버전 확인
+
+| 방법 | 명령어 |
+|------|--------|
+| CLI | `maskweaver --version` 또는 `maskweaver -V` |
+| npm | `npm list maskweaver` |
+| 채팅 내 | `maskweaver_status` 도구 사용 |
+| Weave | `/weave help` |
+
+---
+
+## 핵심 철학
+
+```
+1. 테스트 먼저 (Protect Before Change)
+2. 작게 자주 (Small & Often)
+3. 동작이 정답 (Working > Perfect)
+```
+
+---
+
+## 통합 후 명령어 목록 (v0.9+)
+
+| 명령어 | 설명 |
+|--------|------|
+| `/weave-init` | Weave 초기화 (프로젝트당 1회) |
+| `/weave-map [deep]` | 코드베이스 구조 분석 + GDC 그래프 연동 |
+| `/weave-interview [docs]` | 코드베이스 맵 기반 멀티스텝 요구사항 인터뷰 |
+| `/weave-prepare [docs]` | **research + spec + plan을 한 번에 생성** (큰 계획은 자동 분할) |
+| `/weave-refine-plan` | `tasks/plan-notes.md` 지시문을 plan에 자동 반영 |
+| `/weave-approve` | 구현 전 계획 승인 게이트 통과 |
+| `/weave-craft [phase-id]` | 활성 플랜의 Phase 실행 준비 (실행 컨텍스트 생성) |
+| `/weave-build [action]` | **자율 빌드 루프** — run, status, stop, list, resume, sync |
+| `/weave-status` | 전체 플랜 목록 + 진행 상황 |
+| `/weave-worktree` | git worktree 기반 병렬 작업 관리 |
+| `/weave-verify` | 빌드/테스트 검증 실행 (프로젝트 유형 자동 감지) |
+| `/weave-archive` | 검증된 변경사항 아카이브 |
+| `/weave-troubleshoot [error]` | 글로벌 지식 검색 / 솔루션 기록 (`--record`) |
+| `/weave-repair` | plan YAML 자동 검사 및 수리 |
+| `/weave-agents [flags]` | 에이전트 동기화 (`--sync`) / 설정 초기화 (`--init`) |
+| `/weave-help` | 이 도움말 |
+
+---
+
+## 워크플로우
+
+```
+/weave-init                    ← 프로젝트 초기화 (1회)
+    ↓
+/weave-prepare docs/           ← research + spec + plan 한 번에 생성
+    ↓
+/weave-refine-plan             ← (선택) plan-notes 기반 자동 정제
+    ↓
+/weave-approve                 ← 구현 전 계획 승인 (필수)
+    ↓
+/weave-craft                   ← 다음 Phase 자동 선택 실행 준비
+    ↓
+/weave-build                   ← 자율 빌드 루프 실행
+    ↓
+/weave-verify                  ← 검증
+    ↓
+/weave-archive                 ← 아카이브
+```
+
+---
+
+## 파일 구조
+
+```
+.opencode/weave/
+├── state.yaml           ← 활성 플랜 추적
+├── specs/
+│   └── *.yaml           ← baseline spec
+└── plans/
+    └── *.yaml           ← 플랜
+```
+
+---
+
+## 마이그레이션 노트 (v0.9)
+
+| 기존 명령어 | 새 명령어 | 비고 |
+|-------------|-----------|------|
+| `approve-plan` | `approve` | alias로 v0.9까지 동작 |
+| `build-resume` | `build --resume` | alias로 v0.9까지 동작 |
+| `loop-run` | `build` | alias로 v0.9까지 동작 |
+| `loop-status` | `build --status` | alias로 v0.9까지 동작 |
+| `loop-stop` | `build --stop` | alias로 v0.9까지 동작 |
+| `loop-list` | `build --list` | alias로 v0.9까지 동작 |
+| `loop-sync` | `build --sync` | alias로 v0.9까지 동작 |
+| `record` | `troubleshoot --record` | alias로 v0.9까지 동작 |
+| `sync-agents` | `agents --sync` | alias로 v0.9까지 동작 |
+| `init-config` | `agents --init` | alias로 v0.9까지 동작 |
+| `research` | `prepare` | deprecated alias (v0.9 경고) |
+| `spec` | `prepare` | deprecated alias (v0.9 경고) |
+| `design` | `prepare` | deprecated alias (v0.9 경고) |
+| `flow` | `prepare` → `approve` → `craft` | deprecated alias (v0.9 경고) |

package/assets/commands/weave-interview.md

@@ -0,0 +1,121 @@
+---
+description: 코드베이스 맵 결과를 바탕으로 사용자 요구사항 인터뷰 수행
+---
+
+# /weave-interview - 요구사항 인터뷰
+
+## 개요
+
+`/weave-map` 분석 결과를 바탕으로 **사용자와의 멀티스텝 인터뷰**를 수행합니다.  
+코드베이스의 현재 상태와 구조적 변경 가능성을 파악하고, 명확해질 때까지 질문을 반복합니다.
+
+**사용법**:
+- `/weave-interview` — 기본 인터뷰 (코드베이스 맵 기반)
+- `/weave-interview docs/` — 문서 경로를 함께 참조하며 인터뷰
+
+---
+
+## 데이터 로드 방법 (필수)
+
+```
+1. .opencode/weave/maps/map-result.yaml 로드 (map 먼저 실행되어 있어야 함)
+2. map 결과가 없으면: 자동으로 기본 map 분석 수행 후 진행
+3. (선택) docsPath의 문서 로드
+4. 코드베이스 기술 스택 및 구조적 이슈 확인
+```
+
+---
+
+## 입력
+
+```yaml
+docsPath: "docs/"    # (선택) 요구사항 문서 경로
+```
+
+---
+
+## 동작 흐름
+
+```
+1. 코드베이스 맵 결과 로드 (없으면 자동 생성)
+2. 구조적 변경 감지 (structural changes)
+   - 현재 상태 vs 제안된 변경
+   - Breaking change 여부
+   - 영향받는 파일 목록
+3. 사용자에게 질문 생성
+   - 변경 영역에 대한 의도 확인
+   - 우선순위 및 범위 조정
+4. 충분한 명확성 달성 시 인터뷰 종료
+   - 종료 기준: 모든 structural changes에 대해 agreed 상태
+```
+
+---
+
+## 출력 예시
+
+### 인터뷰 진행 중
+
+```markdown
+## 🎤 Weave Interview
+
+**기반 맵**: `map-20250428-a1b2`
+**프로젝트 타입**: TypeScript / React
+
+### 감지된 구조적 변경
+
+1. **Auth 모듈 분리**
+   - 현재: `src/lib/auth.ts` (단일 파일)
+   - 제안: `src/auth/` 디렉토리로 분리
+   - 영향: 8개 파일
+   - Breaking: ❌ 아니오
+
+2. **Prisma → Drizzle 마이그레이션**
+   - 현재: Prisma ORM
+   - 제안: Drizzle ORM으로 전환
+   - 영향: 15개 파일
+   - Breaking: ⚠️ 예 (DB 스키마 변경)
+
+---
+
+### 질문
+
+> **Q1**: Auth 모듈 분리는 단순 코드 구조 개선인가요, 아니면 새로운 인증 기능(예: OAuth) 추가를 위한 준비인가요?
+>
+> 답변 후 다음 질문으로 진행합니다.
+```
+
+### 인터뷰 완료
+
+```markdown
+## ✅ Interview Complete
+
+**모든 구조적 변경이 명확해졌습니다.**
+
+| 변경 영역 | 상태 | 결정 |
+|-----------|------|------|
+| Auth 모듈 분리 | ✅ Agreed | 디렉토리 분리 + OAuth 확장 준비 |
+| Prisma → Drizzle | ⏳ Pending | Phase 2로 연기 (현재는 Prisma 유지) |
+
+### 다음 단계
+- `/weave-design` — 결정사항을 바탕으로 계획 수립
+- `/weave-prepare` — research + spec + plan 한 번에 생성
+```
+
+---
+
+## 아티팩트 저장 위치
+
+인터뷰 결과는 `.opencode/weave/interviews/`에 저장됩니다:
+
+```
+.opencode/weave/interviews/
+└── interview-{id}.yaml    # 질문-답변 기록 및 structural changes 상태
+```
+
+---
+
+## 관련 명령어
+
+- `/weave-map` — 코드베이스 맵 생성 (인터뷰 선행 조건)
+- `/weave-design` — 인터뷰 결과를 바탕으로 계획 수립
+- `/weave-prepare` — 전체 워크플로우 한 번에 실행

package/assets/commands/weave-map.md

@@ -0,0 +1,109 @@
+---
+description: 코드베이스 구조를 분석하고 지식 그래프(knowledge graph) 생성
+---
+
+# /weave-map - 코드베이스 맵 분석
+
+## 개요
+
+현재 프로젝트의 코드베이스 구조를 분석하여 **기술 스택 자동 감지**, **디렉토리 구조 분석**, **GDC 그래프 연동** 결과를 생성합니다.  
+`deep` 옵션 사용 시 `graphify-windows` 스킬을 활용한 딥 그래프 분석도 수행합니다.
+
+**사용법**:
+- `/weave-map` — 기본 코드베이스 분석
+- `/weave-map --deep` — 심층 그래프 분석 (graphify-windows)
+
+---
+
+## 데이터 로드 방법 (필수)
+
+```
+1. 프로젝트 루트의 package.json, tsconfig.json, Cargo.toml, go.mod 등 탐지
+2. GDC 설정 확인 (.gdc/config.yaml 또는 .opencode/gdc/)
+3. GDC 활성화 시: gdc graph + gdc stats 명령 실행
+4. deep 옵션 시: graphify-windows 스킬 실행
+```
+
+---
+
+## 입력
+
+```yaml
+deep: false      # (선택) true 시 graphify-windows 딥 분석 실행
+```
+
+---
+
+## 출력 예시
+
+### 기본 분석
+
+```markdown
+## 🗺️ Codebase Map
+
+**프로젝트 타입**: TypeScript / Node.js
+**기술 스택**: React, Next.js, Prisma, Tailwind
+
+### 디렉토리 구조
+```
+src/
+├── app/           # Next.js App Router
+├── components/    # React 컴포넌트
+├── lib/           # 유틸리티
+└── db/            # Prisma 스키마
+```
+
+### GDC 그래프
+- **노드**: 42개
+- **엣지**: 78개
+- **커버리지**: 85% 구현, 60% 테스트
+
+### 주요 의존성
+- next: ^14.0
+- react: ^18.2
+- @prisma/client: ^5.0
+```
+
+### 심층 분석 (deep)
+
+```markdown
+## 🗺️ Codebase Map (Deep)
+
+**그래프 분석 완료**
+
+### 커뮤니티 클러스터
+| 클러스터 | 파일 수 | 핵심 엔티티 |
+|----------|--------|------------|
+| C1 | 12 | User, Auth, Session |
+| C2 | 8 | Post, Comment, Feed |
+| C3 | 6 | Payment, Subscription |
+
+### 구조적 이슈
+- ⚠️ 순환 의존성: `src/lib/api.ts` ↔ `src/lib/auth.ts`
+- ⚠️ 고립 노드: `src/utils/legacy-helpers.ts` (참조 없음)
+
+### 추천 리팩토링
+1. `api.ts`와 `auth.ts` 순환 의존성 해소
+2. `legacy-helpers.ts` 제거 또는 통합
+```
+
+---
+
+## 아티팩트 저장 위치
+
+분석 결과는 `.opencode/weave/maps/`에 저장됩니다:
+
+```
+.opencode/weave/maps/
+├── map-report.yaml          # 구조 분석 요약
+├── map-result.yaml          # GDC 연동 결과
+└── graphify-report.html     # deep 분석 시 생성
+```
+
+---
+
+## 관련 명령어
+
+- `/weave-interview` — 맵 결과를 바탕으로 사용자 인터뷰
+- `/weave-design` — 분석 결과를 바탕으로 계획 수립
+- `/weave-init` — weave 워크스페이스 초기화

package/assets/commands/weave-troubleshoot.md

@@ -0,0 +1,57 @@
+---
+description: 글로벌 지식 검색 및 솔루션 기록
+---
+
+# /weave-troubleshoot - 트러블슈팅
+
+## 개요
+
+글로벌 지식베이스에서 유사한 문제의 해결책을 검색하거나, 새로운 해결책을 기록합니다.
+
+**이전 명령어**: `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: "..."      # (선택) 추가 맥락
+```
+
+---
+
+## 출력 예시
+
+### 검색
+
+```markdown
+## 💡 유사한 해결책 발견
+
+### 1. (exact, 점수: 95%)
+**상황**: Cannot find module 'react'
+**해결책**: npm install react react-dom
+**효과성**: ⭐⭐⭐⭐⭐
+```
+
+### 기록
+
+```markdown
+✅ 트러블슈팅 솔루션이 기록되었습니다 (ID: 42)
+
+다음에 비슷한 에러가 발생하면 자동으로 이 해결책을 제안합니다.
+```

package/dist/plugin/index.d.ts

@@ -13,5 +13,9 @@
 */
 import { type Plugin } from '@opencode-ai/plugin';
 export declare const MaskweaverPlugin: Plugin;
-export default MaskweaverPlugin;
+declare const _default: {
+    id: string;
+    server: Plugin;
+};
+export default _default;
 //# sourceMappingURL=index.d.ts.map

package/dist/plugin/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/plugin/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;EAYE;AAGF,OAAO,EAAQ,KAAK,MAAM,EAAE,MAAM,qBAAqB,CAAC;AA6yBxD,eAAO,MAAM,gBAAgB,EAAE,MAkY9B,CAAC;AAEF,eAAe,gBAAgB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/plugin/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;EAYE;AAGF,OAAO,EAAQ,KAAK,MAAM,EAAE,MAAM,qBAAqB,CAAC;AA6yBxD,eAAO,MAAM,gBAAgB,EAAE,MAkY9B,CAAC;;;;;AAEF,wBAGE"}

package/dist/plugin/index.js

@@ -504,12 +504,12 @@ function createSelectMaskTool(maskLoader, activeMask, setActiveMask) {
                     return `Error: Mask "${args.maskId}" not found.\nAvailable: ${available.map(m => m.id).join(', ')}`;
                 }
                 setActiveMask(mask);
-                return `✓ Mask activated: ${mask.profile.name}
-
-"${mask.profile.tagline}"
-
-Expertise: ${mask.profile.expertise.join(', ')}
-
+                return `✓ Mask activated: ${mask.profile.name}
+
+"${mask.profile.tagline}"
+
+Expertise: ${mask.profile.expertise.join(', ')}
+
 The mask prompt will be injected into all future messages.`;
             }
             catch (e) {
@@ -571,11 +571,11 @@ function createMaskweaverStatusTool(maskLoader, masksDir, activeMask) {
                 catch (_e) { /* ignore */ }
             }
             const active = activeMask();
-            return `Maskweaver v${VERSION}
-Masks directory: ${masksDir}
-Available: ${maskLoader ? 'yes' : 'no'}
-Total masks: ${masksCount}
-Categories: ${categoriesCount}
+            return `Maskweaver v${VERSION}
+Masks directory: ${masksDir}
+Available: ${maskLoader ? 'yes' : 'no'}
+Total masks: ${masksCount}
+Categories: ${categoriesCount}
 Active mask: ${active ? `${active.profile.name} (${active.metadata.id})` : 'none'}`;
         },
     };
@@ -889,7 +889,7 @@ export const MaskweaverPlugin = async ({ client, directory, project, worktree, $
     }
     // Slashcommand tool (handles /weave etc. on first run without restart)
     if (isToolActive('slashcommand')) {
-        const slashcommandTool = createSlashcommandTool();
+        const slashcommandTool = createSlashcommandTool(getAssetsDir());
         tools.slashcommand = {
             description: slashcommandTool.description,
             args: wrapSchema(slashcommandTool.args),
@@ -914,10 +914,10 @@ export const MaskweaverPlugin = async ({ client, directory, project, worktree, $
         // System prompt transform - inject active mask
         'experimental.chat.system.transform': async (_input, output) => {
             if (state?.activeMask) {
-                const maskPrompt = `<ACTIVE_PERSONA>
-You are currently embodying the "${state.activeMask.profile.name}" persona.
-
-${buildRichPrompt(state.activeMask)}
+                const maskPrompt = `<ACTIVE_PERSONA>
+You are currently embodying the "${state.activeMask.profile.name}" persona.
+
+${buildRichPrompt(state.activeMask)}
 </ACTIVE_PERSONA>`;
                 (output.system ||= []).push(maskPrompt);
             }
@@ -972,5 +972,8 @@ ${buildRichPrompt(state.activeMask)}
         },
     };
 };
-export default MaskweaverPlugin;
+export default {
+    id: 'maskweaver',
+    server: MaskweaverPlugin,
+};
 //# sourceMappingURL=index.js.map