maskweaver 0.9.2 → 0.9.4

package/README.md

@@ -1,22 +1,22 @@
-# 🎭 Maskweaver: Expert Persona Framework for OpenCode
+# ?렚 Maskweaver: Expert Persona Framework for OpenCode
 
 <div align="center">
 
 <img src="docs/images/hero.png" width="800" alt="Maskweaver Hero Image">
 
-> **The npm for AI personas** — Level up your OpenCode assistant with expert personalities
+> **The npm for AI personas** ??Level up your OpenCode assistant with expert personalities
 
 [![GitHub Release](https://img.shields.io/github/v/release/ulgerang/maskweaver?color=369eff&labelColor=black&logo=github&style=flat-square)](https://github.com/ulgerang/maskweaver/releases)
 [![License](https://img.shields.io/badge/license-MIT-white?labelColor=black&style=flat-square)](LICENSE)
 [![npm](https://img.shields.io/npm/v/maskweaver?color=ff6b35&labelColor=black&style=flat-square)](https://www.npmjs.com/package/maskweaver)
 
-[English](README.md) | [한국어](README.ko.md)
+[English](README.md) | [?쒓뎅??(README.ko.md)
 
 </div>
 
 ---
 
-## 🔌 OpenCode Plugin
+## ?뵆 OpenCode Plugin
 
 **Maskweaver is a handy plugin for [OpenCode](https://github.com/sst/opencode).**
 
@@ -24,8 +24,8 @@ While it can be used as a standalone library, it works great with OpenCode to ad
 - **Expert Personas (Masks)**: Standardized YAML profiles for legendary developers.
 - **Smart Delegation**: Multi-agent workflows optimized for OpenCode.
 - **Project Memory**: Hybrid semantic search for your entire codebase.
-- **🆕 Weave Workflow**: Phase-driven development with AI self-verification.
-- **🔗 GDC Integration**: Graph-Driven Codebase support for enhanced research and design-time verification gates.
+- **?넅 Weave Workflow**: Phase-driven development with AI self-verification.
+- **?뵕 GDC Integration**: Graph-Driven Codebase support for enhanced research and design-time verification gates.
 
 ---
 
@@ -58,7 +58,7 @@ Install and configure maskweaver by following the instructions here:
 https://raw.githubusercontent.com/ulgerang/maskweaver/master/docs/installation.md
 ```
 
-Or read the [Installation Guide](docs/installation.md) directly—but **we strongly recommend letting an agent handle it. Humans make mistakes.**
+Or read the [Installation Guide](docs/installation.md) directly?봟ut **we strongly recommend letting an agent handle it. Humans make mistakes.**
 
 ### For LLM Agents
 
@@ -145,7 +145,7 @@ npm list maskweaver
 
 # In OpenCode chat
 # Use the maskweaver_status tool or type:
-/weave help
+/weave-help
 ```
 
 ```typescript
@@ -174,7 +174,7 @@ console.log(VERSION); // "0.7.29"
 
 ## Features
 
-### 🎭 Expert Personas (Masks)
+### ?렚 Expert Personas (Masks)
 
 Apply legendary developer personalities to your AI assistant:
 
@@ -193,25 +193,25 @@ profile:
 ```
 
 **Current Masks:**
-- 🐧 **Linus Torvalds** - Systems, C, Linux, performance
-- 🏗️ **Martin Fowler** - Architecture, refactoring, patterns
-- 🧪 **Kent Beck** - TDD, XP, testing
-- 🧠 **Andrew Ng** - ML/AI systems
-- ⚛️ **Dan Abramov** - React, frontend architecture
+- ?맕 **Linus Torvalds** - Systems, C, Linux, performance
+- ?룛截?**Martin Fowler** - Architecture, refactoring, patterns
+- ?㎦ **Kent Beck** - TDD, XP, testing
+- ?쭬 **Andrew Ng** - ML/AI systems
+- ?쏉툘 **Dan Abramov** - React, frontend architecture
 
-### 🤖 Dummy-Human System
+### ?쨼 Dummy-Human System
 
 Smart subagents for cost-efficient multi-agent workflows:
 
 | Agent | Model Tier | Cost | Best For |
 |-------|-----------|------|----------|
-| `@dummy-flash` | Fast | 💰 | File search, summaries, simple tasks |
-| `@dummy-human` | Balanced | 💰💰 | Code writing, reviews, general work |
-| `@dummy-premium` | Powerful | 💰💰💰 | Architecture, complex debugging |
+| `@dummy-flash` | Fast | ?뮥 | File search, summaries, simple tasks |
+| `@dummy-human` | Balanced | ?뮥?뮥 | Code writing, reviews, general work |
+| `@dummy-premium` | Powerful | ?뮥?뮥?뮥 | Architecture, complex debugging |
 
-### 🧵 Weave Workflow
+### ?㏊ Weave Workflow
 
-**Phase-Driven Development** — "AI verifies, Human validates"
+**Phase-Driven Development** ??"AI verifies, Human validates"
 
 Weave is Maskweaver's flagship workflow. It breaks work into testable phases, auto-selects expert masks, and provides structured verification before handoff.
 
@@ -219,42 +219,37 @@ Weave is Maskweaver's flagship workflow. It breaks work into testable phases, au
 
 | Command | Description |
 |---------|-------------|
-| `/weave init` | Initialize Weave (once per repo) |
-| `/weave prepare [docs]` | Generate research + spec + plan in one step (auto-split if oversized) |
-| `/weave refine-plan` | Apply structured plan notes (`tasks/plan-notes.md`) to active plan |
-| `/weave approve` | Explicit human approval gate before implementation |
-| `/weave craft [P#]` | Prepare phase execution context and guidance |
-| `/weave build` | Autonomous build loop (`action=run/status/stop/list/resume/sync`) |
-| `/weave verify` | Run build/test verification (auto-detect) |
-| `/weave worktree ...` | Manage git worktrees for parallel work |
-| `/weave status` | View project progress and stats |
-| `/weave agents` | Sync agent files or init config (`sync=true` / `init=true`) |
-| `/weave troubleshoot` | Search global knowledge (`record=true` to save a solution) |
-| `/weave archive` | Archive the verified active change |
-| `/weave help` | Show documentation |
-
-> Tip: In OpenCode chat you can use `/weave ...` commands, and they map to the underlying `weave command=...` tool calls.
+| `/weave-init` | Initialize Weave (once per repo) |
+| `/weave-prepare [docs]` | Generate research + spec + plan in one step (auto-split if oversized) |
+| `/weave-refine-plan` | Apply structured plan notes (`tasks/plan-notes.md`) to active plan |
+| `/weave-approve` | Explicit human approval gate before implementation |
+| `/weave-craft [P#]` | Prepare phase execution context and guidance |
+| `/build` | Autonomous build loop (`action=run/status/stop/list/resume/sync`) |
+| `/weave-verify` | Run build/test verification (auto-detect) |
+| `/weave-worktree ...` | Manage git worktrees for parallel work |
+| `/weave-status` | View project progress and stats |
+| `/weave-agents` | Sync agent files or init config (`sync=true` / `init=true`) |
+| `/weave-troubleshoot` | Search global knowledge (`record=true` to save a solution) |
+| `/weave-archive` | Archive the verified active change |
+| `/weave-help` | Show documentation |
+
+> Tip: In OpenCode chat, use the visible slash commands above. They map to the underlying `weave command=...` tool calls.
 
 #### Workflow
 
 ```
-0. INIT (once): /weave init
-       ↓
-1. PLAN: /weave prepare docs/
+0. INIT (once): /weave-init
+       ??1. PLAN: /weave-prepare docs/
     - Generates research + spec + phase plan (auto-splits if oversized)
-       ↓
-2. REFINE (optional): /weave refine-plan
+       ??2. REFINE (optional): /weave-refine-plan
     - apply annotation notes from tasks/plan-notes.md
-       ↓
-3. APPROVAL GATE: /weave approve
+       ??3. APPROVAL GATE: /weave-approve
     - required before craft execution
-       ↓
-4. CRAFT: /weave craft
+       ??4. CRAFT: /weave-craft
      - Generates an execution plan and next actions
      - Implement/verify changes, then finalize with approve
-     - Use `/weave verify` anytime for build/test checks
-       ↓
-5. HANDOFF: You validate UX/intent and move to next phase
+     - Use `/weave-verify` anytime for build/test checks
+       ??5. HANDOFF: You validate UX/intent and move to next phase
 ```
 
 #### Multi-Layer AI Verification
@@ -263,15 +258,15 @@ Before handing off to you, AI runs these verification layers:
 
 | Layer | Type | Tool |
 |-------|------|------|
-| 1️⃣ TypeCheck | Build | `tsc --noEmit` |
-| 2️⃣ Lint | Build | `eslint` |
-| 3️⃣ Build | Build | `npm run build` |
-| 4️⃣ Unit Tests | Test | `jest` / `vitest` |
-| 5️⃣ E2E Tests | Test | **Playwright** |
-| 6️⃣ Screenshot | Visual | Playwright / browser capture |
-| 7️⃣ API Check | API | `fetch` health checks |
-| 8️⃣ A11y | Accessibility | `axe-core` |
-| 0️⃣ GDC Check | Design | `gdc check --machine` |
+| 1截뤴깵 TypeCheck | Build | `tsc --noEmit` |
+| 2截뤴깵 Lint | Build | `eslint` |
+| 3截뤴깵 Build | Build | `npm run build` |
+| 4截뤴깵 Unit Tests | Test | `jest` / `vitest` |
+| 5截뤴깵 E2E Tests | Test | **Playwright** |
+| 6截뤴깵 Screenshot | Visual | Playwright / browser capture |
+| 7截뤴깵 API Check | API | `fetch` health checks |
+| 8截뤴깵 A11y | Accessibility | `axe-core` |
+| 0截뤴깵 GDC Check | Design | `gdc check --machine` |
 
 #### GDC Integration (Graph-Driven Codebase)
 
@@ -324,23 +319,23 @@ The AI automatically picks the best expert for each task:
 
 | Task Type | Auto-Selected Mask |
 |-----------|-------------------|
-| Architecture/Design | 🏗️ Martin Fowler |
-| Testing/TDD | 🧪 Kent Beck |
-| React/Frontend | ⚛️ Dan Abramov |
-| Performance/Systems | 🐧 Linus Torvalds |
-| ML/AI | 🧠 Andrew Ng |
+| Architecture/Design | ?룛截?Martin Fowler |
+| Testing/TDD | ?㎦ Kent Beck |
+| React/Frontend | ?쏉툘 Dan Abramov |
+| Performance/Systems | ?맕 Linus Torvalds |
+| ML/AI | ?쭬 Andrew Ng |
 
 #### Global Knowledge Base (Cross-Project RAG)
 
 Troubleshooting solutions are stored globally and shared across all projects:
 
 ```
-Error occurs → Search ~/.maskweaver/knowledge.sqlite
-    ├── Found → Apply solution → Retry
-    └── Not found → Fix manually → Record solution for future
+Error occurs ??Search ~/.maskweaver/knowledge.sqlite
+    ?쒋??€ Found ??Apply solution ??Retry
+    ?붴??€ Not found ??Fix manually ??Record solution for future
 ```
 
-### 🧠 Memory System
+### ?쭬 Memory System
 
 Remember past conversations, decisions, and mask effectiveness:
 
@@ -359,13 +354,13 @@ const results = await memory.hybridSearch(
 ```
 
 **Embedding Providers:**
-- 🦙 **Ollama** - Local, private (bge-m3, nomic-embed)
-- 🤖 **OpenAI** - text-embedding-3-large
-- 🚀 **VoyageAI** - Code-specialized embeddings!
-- 🔀 **OpenRouter** - Access to multiple providers
-- 📝 **Text-only** - No embeddings, pure FTS5
+- ?쬂 **Ollama** - Local, private (bge-m3, nomic-embed)
+- ?쨼 **OpenAI** - text-embedding-3-large
+- ?? **VoyageAI** - Code-specialized embeddings!
+- ?? **OpenRouter** - Access to multiple providers
+- ?뱷 **Text-only** - No embeddings, pure FTS5
 
-### 🗂️ Context System
+### ?뾺截?Context System
 
 Track long-running features with file associations:
 
@@ -383,7 +378,7 @@ Track long-running features with file associations:
 @context done
 ```
 
-### 🔄 Retrospect System
+### ?봽 Retrospect System
 
 Evaluate mask effectiveness after each session:
 
@@ -404,7 +399,7 @@ Evaluate mask effectiveness after each session:
 
 ---
 
-## 📦 Package Structure
+## ?벀 Package Structure
 
 Maskweaver is a single npm package with modular exports:
 
@@ -434,12 +429,12 @@ import { WeaveOrchestrator, GlobalKnowledge } from 'maskweaver/weave';
 
 ---
 
-## 🧵 Weave Usage Guide
+## ?㏊ Weave Usage Guide
 
 ### Step 0: Initialize (Once)
 
 ```bash
-/weave init
+/weave-init
 ```
 
 ### Step 1: Create a Plan
@@ -447,13 +442,13 @@ import { WeaveOrchestrator, GlobalKnowledge } from 'maskweaver/weave';
 Generate research + spec + plan in one command:
 
 ```bash
-/weave prepare docs/
+/weave-prepare docs/
 ```
 
 Then approve the plan:
 
 ```bash
-/weave approve
+/weave-approve
 ```
 
 The AI will:
@@ -464,7 +459,7 @@ The AI will:
 
 Example output:
 ```markdown
-## 📋 Execution Plan
+## ?뱥 Execution Plan
 
 ### Vision
 Build a modern emotion diary app with AI-powered insights
@@ -482,7 +477,7 @@ Is this plan okay? Let me know if changes are needed.
 ### Step 2: Approve the Plan (Required)
 
 ```bash
-/weave approve
+/weave-approve
 ```
 
 ### Step 3: Craft a Phase (Auto-select if omitted)
@@ -490,10 +485,10 @@ Is this plan okay? Let me know if changes are needed.
 Start with the first phase:
 
 ```bash
-/weave craft
+/weave-craft
 ```
 
-`/weave craft` returns execution context for the phase. Implement changes, then rerun `/weave craft` if you want to refresh the plan view.
+`/weave-craft` returns execution context for the phase. Implement changes, then rerun `/weave-craft` if you want to refresh the plan view.
 
 ### Step 4: Continue Implementation
 
@@ -520,23 +515,23 @@ weave command=approve
 When all verifications pass:
 
 ```markdown
-## ✅ Phase P1 Verification Complete!
+## ??Phase P1 Verification Complete!
 
-### 🤖 AI Test Results
+### ?쨼 AI Test Results
 | Test | Result |
 |------|--------|
-| Build | ✅ Success |
-| Unit Tests | ✅ 15/15 |
-| Lint | ✅ Passed |
+| Build | ??Success |
+| Unit Tests | ??15/15 |
+| Lint | ??Passed |
 
-### 🎭 Masks Used
+### ?렚 Masks Used
 - Kent Beck (testing)
 - Dan Abramov (React components)
 
-### 🔗 Access
+### ?뵕 Access
 http://localhost:5173
 
-### 👤 Human Validation (Only you can judge)
+### ?뫀 Human Validation (Only you can judge)
 - [ ] Does it feel right?
 - [ ] Is the UX good?
 - [ ] Is this what you wanted?
@@ -547,24 +542,24 @@ http://localhost:5173
 ### Step 6: Check Status Anytime
 
 ```bash
-/weave status
+/weave-status
 ```
 
 Output:
 ```markdown
-## 📊 Weave Progress
+## ?뱤 Weave Progress
 
 **Project**: Emotion Diary App
 **Progress**: 40%
 
-[████████░░░░░░░░░░░░] 2/5
+[?댿뻽?댿뻽?댿뻽?댿뻽?묅뼇?묅뼇?묅뼇?묅뼇?묅뼇?묅뼇] 2/5
 
 ### Phases
-✅ **P1**: Emotion Selection UI (2.5h) [kent-beck, dan-abramov]
-🔄 **P2**: Data Persistence
-⏳ **P3**: History View
-⏳ **P4**: Statistics
-⏳ **P5**: Theme Settings
+??**P1**: Emotion Selection UI (2.5h) [kent-beck, dan-abramov]
+?봽 **P2**: Data Persistence
+??**P3**: History View
+??**P4**: Statistics
+??**P5**: Theme Settings
 
 ### Global Knowledge Stats
 - Total troubleshooting records: 47
@@ -574,7 +569,7 @@ Output:
 
 ---
 
-## 🎭 Creating Masks
+## ?렚 Creating Masks
 
 Masks are simple YAML files:
 
@@ -620,35 +615,35 @@ usage:
 
 ---
 
-## 🌍 Multilingual
+## ?뙇 Multilingual
 
 Infrastructure ready for:
-- 🇺🇸 English
-- 🇰🇷 Korean
-- 🇨🇳 Chinese *(coming soon)*
-- 🇯🇵 Japanese *(coming soon)*
+- ?눣?눡 English
+- ?눖?눟 Korean
+- ?눊?눛 Chinese *(coming soon)*
+- ?눓?눝 Japanese *(coming soon)*
 
 Masks can have multiple language versions:
 ```
 masks/
-├── linus-torvalds.en.yaml
-├── linus-torvalds.ko.yaml
-└── linus-torvalds.zh.yaml
+?쒋??€ linus-torvalds.en.yaml
+?쒋??€ linus-torvalds.ko.yaml
+?붴??€ linus-torvalds.zh.yaml
 ```
 
 ---
 
-## 🤝 Contributing
+## ?쩃 Contributing
 
 We need your help!
 
 ### Add a Mask
 
 Create a YAML file in `masks/` and submit a PR:
-- ✅ Real expertise (domain knowledge)
-- ✅ Distinct personality (thinking style)
-- ✅ Clear use cases (when to use)
-- ✅ Examples (expected behavior)
+- ??Real expertise (domain knowledge)
+- ??Distinct personality (thinking style)
+- ??Clear use cases (when to use)
+- ??Examples (expected behavior)
 
 ### Report Bugs
 
@@ -661,12 +656,13 @@ See [CONTRIBUTING.md](CONTRIBUTING.md) for more details.
 
 ---
 
-## 📄 License
+## ?뱞 License
 
 MIT - See [LICENSE](LICENSE)
 
 ---
 
 <p align="center">
-  <sub>Crafted with 🎭 by <a href="https://github.com/ulgerang">ULJI SOFT</a></sub>
+  <sub>Crafted with ?렚 by <a href="https://github.com/ulgerang">ULJI SOFT</a></sub>
 </p>
+

package/assets/commands/build.md

@@ -0,0 +1,17 @@
+---
+description: Run or manage the Maskweaver autonomous build loop
+---
+
+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.