@su-record/vibe 2.7.10 → 2.7.12

package/.env.example

@@ -1,37 +1,37 @@
-# ─── VIBE Configuration ─────────────────────────────────────────────
-#
-# All credentials, channels, and model overrides are stored in:
-#   ~/.vibe/config.json
-#
-# Use CLI commands to configure:
-#   vibe setup                    Interactive setup wizard
-#   vibe gpt auth                 GPT OAuth (Plus/Pro)
-#   vibe gpt key <key>            GPT API key
-#   vibe gemini auth              Gemini OAuth
-#   vibe gemini key <key>         Gemini API key
-#   vibe claude key <key>         Claude API key
-#   vibe telegram setup <token>   Telegram bot
-#   vibe slack setup <bot> <app>  Slack bot
-#   vibe status                   Check all status
-#
-# Config structure (~/.vibe/config.json):
-# {
-#   "version": "1",
-#   "credentials": {
-#     "gpt": { "apiKey": "sk-..." },
-#     "gemini": { "apiKey": "AIza..." }
-#   },
-#   "channels": {
-#     "telegram": { "botToken": "123:ABC", "allowedChatIds": ["-100..."] },
-#     "slack": { "botToken": "xoxb-...", "appToken": "xapp-..." }
-#   },
-#   "models": {
-#     "gpt": "gpt-5.2",
-#     "gemini": "gemini-3-pro-preview",
-#     "claudeBackground": "claude-sonnet-4-5"
-#   }
-# }
-#
-# Environment variables are still supported as fallback:
-#   OPENAI_API_KEY, GEMINI_API_KEY, GPT_MODEL, etc.
-# ────────────────────────────────────────────────────────────────────
+# ─── VIBE Configuration ─────────────────────────────────────────────
+#
+# All credentials, channels, and model overrides are stored in:
+#   ~/.vibe/config.json
+#
+# Use CLI commands to configure:
+#   vibe setup                    Interactive setup wizard
+#   vibe gpt auth                 GPT OAuth (Plus/Pro)
+#   vibe gpt key <key>            GPT API key
+#   vibe gemini auth              Gemini OAuth
+#   vibe gemini key <key>         Gemini API key
+#   vibe claude key <key>         Claude API key
+#   vibe telegram setup <token>   Telegram bot
+#   vibe slack setup <bot> <app>  Slack bot
+#   vibe status                   Check all status
+#
+# Config structure (~/.vibe/config.json):
+# {
+#   "version": "1",
+#   "credentials": {
+#     "gpt": { "apiKey": "sk-..." },
+#     "gemini": { "apiKey": "AIza..." }
+#   },
+#   "channels": {
+#     "telegram": { "botToken": "123:ABC", "allowedChatIds": ["-100..."] },
+#     "slack": { "botToken": "xoxb-...", "appToken": "xapp-..." }
+#   },
+#   "models": {
+#     "gpt": "gpt-5.2",
+#     "gemini": "gemini-3-pro-preview",
+#     "claudeBackground": "claude-sonnet-4-5"
+#   }
+# }
+#
+# Environment variables are still supported as fallback:
+#   OPENAI_API_KEY, GEMINI_API_KEY, GPT_MODEL, etc.
+# ────────────────────────────────────────────────────────────────────

package/CLAUDE.md

@@ -1,222 +1,126 @@
-# VIBE
-
-## Project Nature
-
-> **This project is the source code for the `@su-record/vibe` npm package.**
-> All bug fixes and improvements MUST be made in **this project source** — not in installed locations.
-> Always modify files in this repository, never the installed copy.
-
-## Philosophy
-
-> **vibe = Easy vibe coding + Minimum quality guaranteed**
-
-| Principle | Description |
-|-----------|-------------|
-| **Easy Vibe Coding** | Fast flow, intuitive development, think collaboratively with AI |
-| **Minimum Quality Guaranteed** | Type safety, code quality, security — automatic baseline enforcement |
-| **Iterative Reasoning (Type 6)** | Don't delegate answers to AI — break down problems, ask questions, reason together |
-
-### Quality Guardrails
-
-| Guardrail | Mechanism |
-|-----------|-----------|
-| Type Safety | Quality Gate — blocks `any` / `Any` / `@ts-ignore` |
-| Code Review | 13+ agent parallel review (security, performance, architecture, etc.) |
-| Completion Check | Ralph Loop — iterate until 100% complete (no scope reduction) |
-| Memory RAG | SQLite + FTS5 BM25 persistent memory |
-| Multi-LLM | GPT + Gemini cross-validation via ReviewRace |
-
-## Code Quality Standards (Mandatory)
-
-### Core Principles
-
-- **Modify only requested scope** — Don't touch unrelated code
-- **Preserve existing style** — Follow project conventions
-- **Keep working code** — No unnecessary refactoring
-- **Edit existing files, never create new ones** — Fix the problem at its source
-- **Respect user interrupts** — If user interrupts (Ctrl+C/Escape), the previous task is CANCELLED. Respond ONLY to the new message
-
-### Code Complexity Limits
-
-| Metric | Limit |
-|--------|-------|
-| Function length | ≤30 lines (recommended), ≤50 lines (allowed) |
-| Nesting depth | ≤3 levels |
-| Parameters | ≤5 |
-| Cyclomatic complexity | ≤10 |
-
-### TypeScript Rules
-
-- No `any` type — use `unknown` + type guards
-- No `as any` casting — define proper interfaces
-- No `@ts-ignore` — fix type issues at root
-- Explicit return types on all functions
-
-### Forbidden Patterns
-
-- No console.log in commits
-- No hardcoded strings/numbers
-- No commented-out code
-- No incomplete code without TODO
-
-## Configuration
-
-### Global: `~/.vibe/config.json`
-
-All credentials, channel config, and model settings in one file (0o600 permissions).
-
-```json
-{
-  "credentials": { "gpt": {}, "gemini": {} },
-  "channels": { "telegram": {}, "slack": {} },
-  "models": { "gpt": "gpt-5.2", "gemini": "gemini-3-pro-preview" }
-}
-```
-
-CLI commands: `vibe gpt key`, `vibe gemini auth`, `vibe telegram setup`, etc.
-
-### Project: `.claude/vibe/config.json`
-
-Project-specific settings (language, quality, stacks, details, references).
-
-## Workflow
-
-```text
-/vibe.spec → /new → /vibe.spec.review → /vibe.run → /vibe.trace → (auto) code review → Done
-```
-
-| Task Size | Recommended |
-|-----------|-------------|
-| Simple changes (1-2 files) | Plan Mode |
-| Complex features (3+ files) | `/vibe.spec` |
-
-## ULTRAWORK Mode
-
-Add `ultrawork` or `ulw` keyword:
-
-- Parallel sub-agent exploration (3+ concurrent)
-- Background agents + Phase pipelining
-- Boulder Loop (auto-continue until all Phases complete)
-- Auto-retry on error (max 3), Auto-save at 70%+ context
-
-## Commands (Slash)
-
-| Command | Description |
-|---------|-------------|
-| `/vibe.spec "name"` | Write SPEC (PTCF) + parallel research |
-| `/vibe.spec.review "name"` | SPEC quality review (GPT + Gemini 3-round) |
-| `/vibe.run "name"` | Execute implementation |
-| `/vibe.run "name" ultrawork` | Maximum performance mode |
-| `/vibe.verify "name"` | Verification against SPEC |
-| `/vibe.review` | 13+ agent parallel code review |
-| `/vibe.trace "name"` | Requirements traceability matrix |
-| `/vibe.reason "problem"` | Systematic reasoning |
-| `/vibe.analyze` | Project analysis |
-| `/vibe.utils` | Utilities (--e2e, --diagram, --ui, --continue) |
-| `/vibe.voice` | Voice-to-coding (Gemini audio) |
-
-## CLI Commands
-
-| Command | Description |
-|---------|-------------|
-| `vibe init [project]` | Project initialization |
-| `vibe setup` | Interactive setup wizard |
-| `vibe update` | Update project configuration |
-| `vibe upgrade` | Upgrade to latest version |
-| `vibe remove` | Remove from project |
-| `vibe status` | Full status check |
-| `vibe version` | Show version |
-| `vibe claude <cmd>` | Claude (key, status, logout) |
-| `vibe gpt <cmd>` | GPT (auth, key, status, logout, remove) |
-| `vibe gemini <cmd>` | Gemini (auth, key, import, status, logout, remove) |
-| `vibe telegram <cmd>` | Telegram (setup, chat, status) |
-| `vibe slack <cmd>` | Slack (setup, channel, status) |
-| `vibe env import [path]` | .env → ~/.vibe/config.json migration |
-
-## External LLM Integration
-
-- **GPT**: `vibe gpt auth` (OAuth) / `vibe gpt key` (API Key) — Responses API
-- **Gemini**: `vibe gemini auth` (OAuth) / `vibe gemini key` (API Key) — Gemini API
-- Auth priority: OAuth → API Key → Azure (GPT) / gemini-cli → OAuth → API Key (Gemini)
-- All credentials stored in `~/.vibe/config.json`
-
-## External Channels
-
-- **Telegram**: `vibe telegram setup <token>` — `~/.vibe/config.json` channels.telegram
-- **Slack**: `vibe slack setup <bot-token> <app-token>` — `~/.vibe/config.json` channels.slack
-
-## Magic Keywords
-
-| Keyword | Effect |
-|---------|--------|
-| `ultrawork` / `ulw` | Parallel + auto-continue + Ralph Loop |
-| `ralph` | Iterate until 100% complete (no scope reduction) |
-| `ralplan` | Iterative planning + persistence |
-| `verify` | Strict verification mode |
-| `quick` | Fast mode, minimal verification |
-
-## Agents (49)
-
-### Main (19)
-
-Explorer (high/medium/low), Implementer (high/medium/low), Architect (high/medium/low), Searcher, Tester, Simplifier, Refactor Cleaner, Build Error Resolver, Compounder, Diagrammer, E2E Tester, UI Previewer, Junior Mentor
-
-### Review (12)
-
-security, performance, architecture, complexity, simplicity, data-integrity, test-coverage, git-history, typescript, python, rails, react
-
-### Research (4)
-
-best-practices, framework-docs, codebase-patterns, security-advisory
-
-### UI/UX (8)
-
-ui-industry-analyzer, ui-design-system-gen, ui-layout-architect, ui-stack-implementer, ui-dataviz-advisor, ux-compliance-reviewer, ui-a11y-auditor, ui-antipattern-detector
-
-### Planning (2), QA (2), Docs (2)
-
-requirements-analyst, ux-advisor, edge-case-finder, acceptance-tester, api-documenter, changelog-writer
-
-### Agent Teams (9)
-
-Lite, Dev (ULTRAWORK), Research, Review Debate, SPEC Debate, Debug, Security, Migration, Fullstack
-
-## Built-in Tools (41+)
-
-- **Memory & Session** (21): save/recall/search/link memories, session RAG (save_session_item, retrieve_session_context, manage_goals)
-- **Code Quality** (8): find_symbol, find_references, analyze_complexity, validate_code_quality, etc.
-- **SPEC & Testing** (9): spec_generator, traceability_matrix, e2e_test_generator, etc.
-- **UI & Utility** (3+): preview_ui_ascii, get_current_time, send_slack
-
-## Hooks System
-
-| Event | Hooks |
-|-------|-------|
-| SessionStart | `session-start.js` |
-| PreToolUse | `sentinel-guard.js`, `pre-tool-guard.js` |
-| PostToolUse | `post-edit.js`, `code-check.js` |
-| UserPromptSubmit | `prompt-dispatcher.js` → `keyword-detector.js`, `llm-orchestrate.js` |
-| Notification | `context-save.js` (80/90/95%) |
-| Stop | `stop-notify.js` |
-
-## Language Support (25 frameworks)
-
-- **TypeScript**: Next.js, React, Angular, NestJS, Vue, Svelte, Nuxt, Tauri, Electron, React Native, Node, Astro
-- **Python**: Django, FastAPI
-- **Java**: Spring
-- **Kotlin**: Android
-- **Ruby**: Rails
-- **Go**, **Rust**, **Swift** (iOS), **C#** (Unity), **Dart** (Flutter), **GDScript** (Godot)
-
-## Context Management
-
-- **Exploration/Search**: Haiku | **Implementation**: Sonnet | **Architecture**: Opus
-- At 70%+ context: Use `save_memory` → `/new` → `/vibe.utils --continue`
-
-## Git Commit Rules
-
-**Must include:** `.claude/vibe/specs/`, `.claude/vibe/features/`, `.claude/vibe/todos/`, `.claude/vibe/config.json`, `CLAUDE.md`
-
-**Exclude:** `~/.claude/vibe/rules/`, `~/.claude/commands/`, `~/.claude/agents/`, `~/.claude/skills/`, `.claude/settings.local.json`
-
-<!-- VIBE:END -->
+# VIBE
+
+## Project Nature
+
+> **This is the source code for `@su-record/vibe` npm package.**
+> Modify files in THIS repository only — never the installed copy (`~/.claude/`, `~/.vibe/`).
+
+## Philosophy
+
+> **vibe = Easy vibe coding + Minimum quality guaranteed**
+
+- **Easy Vibe Coding** — Fast flow, think collaboratively with AI
+- **Minimum Quality Guaranteed** — Type safety, code quality, security — automatic baseline
+- **Iterative Reasoning** — Break down problems, ask questions, reason together (don't delegate)
+
+## Constraints (Hard Rules)
+
+### Code Behavior
+
+- **Modify only requested scope** — Don't touch unrelated code
+- **Preserve existing style** — Follow project conventions
+- **Edit existing files, never create new ones** — Fix problems at source
+- **Respect user interrupts** — Ctrl+C/Escape = previous task CANCELLED
+
+### Complexity Limits
+
+| Metric | Limit |
+|--------|-------|
+| Function length | ≤50 lines |
+| Nesting depth | ≤3 levels |
+| Parameters | ≤5 |
+| Cyclomatic complexity | ≤10 |
+
+### TypeScript (Enforced by Quality Gate hooks)
+
+- No `any` — use `unknown` + type guards
+- No `as any` — define proper interfaces
+- No `@ts-ignore` — fix type issues at root
+- Explicit return types on all functions
+
+### Forbidden Patterns
+
+- No `console.log` in commits
+- No hardcoded strings/numbers (use constants)
+- No commented-out code
+- No incomplete code without TODO
+
+## Architecture (What's NOT Obvious)
+
+### Module System
+
+- ESM only (`"type": "module"`) — imports need `.js` extension
+- TypeScript strict mode → `dist/` via `tsc`
+- Build before test: `npm run build && npx vitest run`
+
+### Config Locations (Don't Confuse)
+
+| Path | Purpose |
+|------|---------|
+| `~/.vibe/config.json` | Global credentials, channels, models (0o600) |
+| `.claude/vibe/config.json` | Project stacks, capabilities, details |
+| `.claude/settings.local.json` | Project hooks (auto-generated, don't commit) |
+
+### Installation Flow
+
+- `postinstall` → global assets (`~/.claude/agents/`, `~/.claude/skills/`, `~/.claude/commands/`)
+- `vibe init` → project setup (detect stacks → config → constitution → rules → hooks → local skills + languages)
+- `vibe update` → re-detect stacks, refresh project config (preserves user capabilities)
+
+### Key Directories (Where to Find Things)
+
+| What | Where |
+|------|-------|
+| CLI commands | `src/cli/commands/` |
+| Postinstall modules | `src/cli/postinstall/` |
+| Stack detection | `src/cli/detect.ts` |
+| Auth (all LLMs) | `src/cli/auth.ts` |
+| Setup helpers | `src/cli/setup.ts`, `src/cli/setup/` |
+| Hooks scripts | `hooks/scripts/` |
+| Agent definitions | `agents/` |
+| Skill definitions | `skills/` |
+| Language rules | `languages/` |
+| SPEC/rule templates | `vibe/rules/`, `vibe/templates/` |
+| Infra (daemon, memory, policy) | `src/infra/` |
+
+### Gotchas
+
+- `better-sqlite3` WAL mode — DB module uses synchronous API
+- `crypto.timingSafeEqual` requires same-length buffers — check length first
+- `STACK_TO_LANGUAGE_FILE`, `STACK_TO_SKILLS`, `CAPABILITY_SKILLS` in `src/cli/postinstall/constants.ts` — single source of truth for stack→asset mapping
+- Hook dispatch chain: `prompt-dispatcher.js` → `keyword-detector.js` → `llm-orchestrate.js` (order matters)
+- Pre-existing test failures in `prdParser.test.ts` (7) and `traceabilityMatrix.test.ts` (1) — unrelated to current work
+
+## Workflow
+
+```text
+/vibe.spec → /new → /vibe.spec.review → /vibe.run → /vibe.trace → (auto) code review → Done
+```
+
+| Task Size | Approach |
+|-----------|----------|
+| 1-2 files | Plan Mode |
+| 3+ files | `/vibe.spec` |
+
+## Magic Keywords
+
+| Keyword | Effect |
+|---------|--------|
+| `ultrawork` / `ulw` | Parallel agents + auto-continue + Ralph Loop |
+| `ralph` | Iterate until 100% complete (no scope reduction) |
+| `ralplan` | Iterative planning + persistence |
+| `verify` | Strict verification mode |
+| `quick` | Fast mode, minimal verification |
+
+## Context Management
+
+- **Exploration/Search**: Haiku | **Implementation**: Sonnet | **Architecture**: Opus
+- At 70%+ context: `save_memory` → `/new` → `/vibe.utils --continue`
+
+## Git Commit Rules
+
+**Must include:** `.claude/vibe/specs/`, `.claude/vibe/features/`, `.claude/vibe/todos/`, `.claude/vibe/config.json`, `CLAUDE.md`
+
+**Exclude:** `~/.claude/vibe/rules/`, `~/.claude/commands/`, `~/.claude/agents/`, `~/.claude/skills/`, `.claude/settings.local.json`
+
+<!-- VIBE:END -->

package/LICENSE

@@ -1,21 +1,21 @@
-MIT License
-
-Copyright (c) 2025 Su
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.
+MIT License
+
+Copyright (c) 2025 Su
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.