@su-record/vibe 2.7.16 → 2.7.18

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.4",
-#     "gemini": "gemini-3.1-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.4",
+#     "gemini": "gemini-3.1-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,134 +1,153 @@
-# 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
-
-### Convergence Principle (Over-Diagnosis Prevention)
-
-- **P1 only is mandatory, P2/P3 are best-effort** — P1=0 means done
-- **Repeated reviews narrow scope** — Round 2: P1+P2 only, Round 3+: P1 only
-- **Convergence detection** — Same results as previous round → stop immediately
-- **3 failures = escalation** — No more retries, move to TODO
-- **Changed files only** — Never scan the entire project
-
-### 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 -->
+# 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
+
+### Convergence Principle (Over-Diagnosis Prevention)
+
+- **P1 only is mandatory, P2/P3 are best-effort** — P1=0 means done
+- **Repeated reviews narrow scope** — Round 2: P1+P2 only, Round 3+: P1 only
+- **Convergence detection** — Same results as previous round → stop immediately
+- **3 failures = escalation** — No more retries, move to TODO
+- **Changed files only** — Never scan the entire project
+
+### 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/` |
+| Telemetry (local JSONL) | `src/infra/lib/telemetry/` |
+| Test helpers (shared) | `src/test-helpers/` |
+| Skill catalog generator | `scripts/gen-skill-docs.ts` |
+
+### 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 |
+
+## Proactive Skill Suggestions
+
+When the user's context matches a pattern below, suggest the relevant skill **once** per session. If the user says "stop suggesting", disable for the rest of the session.
+
+| User Context | Suggested Skill | Signal |
+|-------------|-----------------|--------|
+| Writing a new SPEC / planning | `/vibe.spec` | "let's build", "new feature", "requirements" |
+| SPEC exists, ready to implement | `/vibe.run` | SPEC file present, no implementation started |
+| Implementation done, verifying | `/vibe.trace` | Code changes match SPEC phases |
+| Complex feature, unknown tech | `/parallel-research` | "how should we", "which library", architecture questions |
+| Debugging errors repeatedly | `/vibe.trace` | 3+ error cycles without resolution |
+| Pre-merge / PR preparation | `/commit-push-pr` | "ready to merge", "create PR" |
+| Session ending, work incomplete | `/handoff` | 70%+ context, incomplete tasks |
+| Technical debt accumulating | `/techdebt` | Multiple `any` types, console.log, unused imports |
+| Multi-file refactoring planned | `/exec-plan` | 3+ files to change, complex dependencies |
+
+## 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.