sqlew 5.0.6 → 5.0.8

package/docs/MIGRATION_CLEANUP_GUIDE.md

@@ -1,212 +0,0 @@
-# v4 to v5 Migration Cleanup Guide
-
-This guide lists the **specific files** that were auto-generated by sqlew v4 (`sqlew --init`, `sqlew --hooks`). Delete only these files - other files in the same directories may have been created by you or other tools.
-
-## What Changed in v5
-
-| Feature | v4 (Legacy) | v5 (Plugin) |
-|---------|-------------|-------------|
-| Installation | `sqlew --init` per project | `sqlew-plugin` via Claude Plugin marketplace |
-| Skills/Hooks | `.claude/hooks/`, `.claude/skills/` | Managed by plugin |
-| Agents | `.claude/agents/` | Removed (Agent system deprecated) |
-| Rules | `.claude/rules/` | Global `~/.claude/rules/sqlew/` |
-| Commands | `.claude/commands/` | Global `~/.claude/commands/` |
-
----
-
-## Files to Delete (v4 Auto-Generated)
-
-### Agents (Added by sqlew v3.x, deprecated in v4.0.0)
-
-These agent definition files were created by early sqlew versions:
-
-| File | Description |
-|------|-------------|
-| `.claude/agents/parallel-orchestrator.md` | Parallel task orchestration agent |
-| `.claude/agents/sqlew-architect.md` | Architecture decision agent |
-| `.claude/agents/sqlew-researcher.md` | Context research agent |
-| `.claude/agents/sqlew-scrum-master.md` | Task management agent |
-
-### Commands (Added by `sqlew --init`)
-
-| File | Description |
-|------|-------------|
-| `.claude/commands/sqlew.md` | `/sqlew` slash command definition |
-
-**Note**: Now managed globally at `~/.claude/commands/sqlew.md` by the plugin.
-
-### Hooks (Added by `sqlew --hooks`)
-
-| File | Description |
-|------|-------------|
-| `.claude/hooks/check-ast-grep.mjs` | AST pattern validation hook |
-| `.claude/hooks/check-db-path.mjs` | Database path guardrail hook |
-| `.claude/hooks/check-migration.mjs` | Migration file protection hook |
-| `.claude/hooks/check-prod-db.mjs` | Production DB protection hook |
-
-**Note**: Now managed by sqlew-plugin.
-
-### Rules (Added by `sqlew --init`)
-
-| File | Description |
-|------|-------------|
-| `.claude/rules/plan-mode-integration.md` | Plan mode decision format guide |
-
-**Note**: Now managed globally at `~/.claude/rules/sqlew/plan-mode-integration.md`.
-
-### Skills (Added by `sqlew --init`)
-
-| Directory | Description |
-|-----------|-------------|
-| `.claude/skills/sqlew-plan-guidance/` | Plan mode quick reference |
-| `.claude/skills/sqlew-decision-format/` | Decision format guide |
-
-**Note**: Now managed globally:
-- `~/.claude/skills/sqlew-plan-guidance/`
-- `~/.claude/skills/plan-decision-format/`
-
----
-
-## settings.json Modification
-
-Remove hook entries that reference the deleted `.claude/hooks/*.mjs` files.
-
-**Before (v4):**
-```json
-{
-  "hooks": {
-    "PreToolUse": [
-      {
-        "matcher": "Edit|Write|MultiEdit",
-        "hooks": [
-          { "command": "node .claude/hooks/check-migration.mjs" },
-          { "command": "node .claude/hooks/check-ast-grep.mjs" }
-        ]
-      },
-      {
-        "matcher": "Bash",
-        "hooks": [
-          { "command": "node .claude/hooks/check-db-path.mjs" },
-          { "command": "node .claude/hooks/check-prod-db.mjs" }
-        ]
-      }
-    ]
-  }
-}
-```
-
-**After (v5):**
-Remove the PreToolUse entries that reference `.claude/hooks/`. The plugin handles these automatically.
-
----
-
-## Complete File List
-
-Copy-paste ready deletion commands for v4 auto-generated files:
-
-```bash
-# Windows (PowerShell)
-Remove-Item .claude\agents\parallel-orchestrator.md -ErrorAction SilentlyContinue
-Remove-Item .claude\agents\sqlew-architect.md -ErrorAction SilentlyContinue
-Remove-Item .claude\agents\sqlew-researcher.md -ErrorAction SilentlyContinue
-Remove-Item .claude\agents\sqlew-scrum-master.md -ErrorAction SilentlyContinue
-Remove-Item .claude\commands\sqlew.md -ErrorAction SilentlyContinue
-Remove-Item .claude\hooks\check-ast-grep.mjs -ErrorAction SilentlyContinue
-Remove-Item .claude\hooks\check-db-path.mjs -ErrorAction SilentlyContinue
-Remove-Item .claude\hooks\check-migration.mjs -ErrorAction SilentlyContinue
-Remove-Item .claude\hooks\check-prod-db.mjs -ErrorAction SilentlyContinue
-Remove-Item .claude\rules\plan-mode-integration.md -ErrorAction SilentlyContinue
-Remove-Item -Recurse .claude\skills\sqlew-plan-guidance -ErrorAction SilentlyContinue
-Remove-Item -Recurse .claude\skills\sqlew-decision-format -ErrorAction SilentlyContinue
-```
-
-```bash
-# Unix/macOS/Linux
-rm -f .claude/agents/parallel-orchestrator.md
-rm -f .claude/agents/sqlew-architect.md
-rm -f .claude/agents/sqlew-researcher.md
-rm -f .claude/agents/sqlew-scrum-master.md
-rm -f .claude/commands/sqlew.md
-rm -f .claude/hooks/check-ast-grep.mjs
-rm -f .claude/hooks/check-db-path.mjs
-rm -f .claude/hooks/check-migration.mjs
-rm -f .claude/hooks/check-prod-db.mjs
-rm -f .claude/rules/plan-mode-integration.md
-rm -rf .claude/skills/sqlew-plan-guidance
-rm -rf .claude/skills/sqlew-decision-format
-```
-
----
-
-## Verification
-
-After cleanup, verify your setup:
-
-1. **Check plugin is installed:**
-   ```bash
-   # In Claude Code
-   /plugin list
-   # Should show: sqlew-plugin@sqlew-plugin
-   ```
-
-2. **Check global rules exist:**
-   ```bash
-   # Windows
-   dir %USERPROFILE%\.claude\rules\sqlew\
-
-   # Unix/macOS
-   ls ~/.claude/rules/sqlew/
-   ```
-
-3. **Test /sqlew command:**
-   ```bash
-   # In Claude Code
-   /sqlew
-   # Should show status without errors
-   ```
-
-4. **Verify no duplicate hooks:**
-   - Open `.claude/settings.json`
-   - Ensure no references to `.claude/hooks/*.mjs`
-
----
-
-## Troubleshooting
-
-### Error: "Cannot find module '.claude/hooks/check-*.mjs'"
-
-**Cause**: `settings.json` still references deleted hook files.
-
-**Solution**: Remove the PreToolUse hooks section from `.claude/settings.json`.
-
-### /sqlew command not found
-
-**Cause**: Plugin not installed or global command not registered.
-
-**Solution**:
-```bash
-/plugin install sqlew-plugin
-# Restart Claude Code
-```
-
-### Decisions not being captured automatically
-
-**Cause**: Plugin hooks not active.
-
-**Solution**:
-1. Ensure plugin is installed at user level (not project level)
-2. Restart Claude Code
-3. Check `~/.claude/settings.json` for `enabledPlugins`
-
----
-
-## Summary
-
-| Category | Files to Delete |
-|----------|-----------------|
-| **Agents** | `parallel-orchestrator.md`, `sqlew-architect.md`, `sqlew-researcher.md`, `sqlew-scrum-master.md` |
-| **Commands** | `sqlew.md` |
-| **Hooks** | `check-ast-grep.mjs`, `check-db-path.mjs`, `check-migration.mjs`, `check-prod-db.mjs` |
-| **Rules** | `plan-mode-integration.md` |
-| **Skills** | `sqlew-plan-guidance/`, `sqlew-decision-format/` |
-| **settings.json** | Remove PreToolUse entries referencing `.claude/hooks/` |

package/docs/SLASH_COMMANDS.md

@@ -1,329 +0,0 @@
-# Unified /sqlew Command Guide
-
-**🎯 Recommended Interface**
-
-The `/sqlew` command is the PRIMARY way to interact with sqlew. It provides a natural language interface with automatic intent detection that is easier than raw MCP tool calls.
-
-## Why Use /sqlew?
-
-✅ **Natural language input** - Describe what you want, it figures out the intent
-✅ **Single command** - `/sqlew` handles all operations (search, record, list, execute, plan)
-✅ **Automatic intent detection** - Recognizes search, record, update, execute, task creation
-✅ **Error handling** - Built-in validation and helpful error messages
-✅ **No MCP knowledge needed** - Just describe what you want in plain English
-
-## Quick Start
-
-```bash
-# Show current status and suggested next actions
-/sqlew
-
-# Search for decisions
-/sqlew search why we chose Knex for migrations
-
-# Record a decision
-/sqlew record we use PostgreSQL 15 for production database
-
-# List remaining tasks
-/sqlew show remaining tasks
-
-# Create tasks from a plan
-/sqlew plan implementing user authentication
-```
-
----
-
-## Intent Detection System
-
-The `/sqlew` command analyzes your input and executes in this priority order:
-
-### 1. List/Status Intent (Highest Priority)
-
-**Keywords**: list, show, status, remaining, current, pending, what, overview, existing, left, 確認, 見せて, 表示, 一覧
-
-**Use when you want to**:
-- See all decisions
-- Check remaining tasks
-- Get current status
-- View what exists in the database
-
-**Examples**:
-```bash
-/sqlew
-/sqlew show remaining tasks
-/sqlew what decisions do we have
-/sqlew list all constraints
-```
-
-**Actions executed**:
-- Lists recent decisions
-- Shows task status summary
-- Provides suggestions for next steps
-
----
-
-### 2. Search Intent
-
-**Keywords**: search, find, look for, about, related, explore, 検索, 探して, 調べて
-
-**Use when you want to**:
-- Find related decisions
-- Search for past context
-- Understand why something was decided
-- Explore related patterns
-
-**Examples**:
-```bash
-/sqlew search why we chose PostgreSQL
-/sqlew find authentication decisions
-/sqlew look for API design decisions
-```
-
-**Actions executed**:
-- Queries decision tags and keys
-- Shows related context
-- Displays decision rationale
-
----
-
-### 3. Record Intent
-
-**Keywords**: record, add, save, register, decide, decided, decision, 記録, 登録, 保存
-
-**Use when you want to**:
-- Capture a new decision
-- Record meeting minutes
-- Document a choice made during development
-- Add a new constraint
-
-**Examples**:
-```bash
-/sqlew record we decided to use JWT for authentication
-/sqlew add PostgreSQL 15 as our production database
-/sqlew save that we use async/await pattern
-```
-
-**Actions executed**:
-- Checks for duplicates
-- Records decision with context
-- Suggests related decisions
-
----
-
-### 4. Update Intent
-
-**Keywords**: update, change, modify, revise, 更新, 変更, 修正
-
-**Use when you want to**:
-- Modify an existing decision
-- Change a constraint
-- Revise previous context
-
-**Examples**:
-```bash
-/sqlew update authentication to use OAuth2 instead
-/sqlew modify database choice to PostgreSQL 14
-/sqlew revise API response format
-```
-
-**Actions executed**:
-- Retrieves existing decision
-- Updates with new information
-- Shows before/after changes
-
----
-
-### 5. Execute Intent
-
-**Keywords**: execute, run, do, proceed, continue, finish, 実行, 進めて, 続けて, やって
-
-**Use when you want to**:
-- Start implementing pending tasks
-- Continue work from previous session
-- Execute next steps
-
-**Examples**:
-```bash
-/sqlew execute
-/sqlew run pending tasks
-/sqlew proceed with implementation
-/sqlew continue from where we left off
-```
-
-**Actions executed**:
-- Lists pending tasks
-- Coordinates implementation
-- Updates task status
-
----
-
-### 6. Task Creation Intent (Lowest Priority - Explicit Only)
-
-**Keywords**: create task, make task, breakdown, plan tasks, generate tasks, タスク作成, タスクを作って, 洗い出し
-
-**IMPORTANT**: Only triggers for EXPLICIT creation verbs. Does NOT trigger for:
-- "remaining tasks" → List/Status intent instead
-- "task list" → List/Status intent instead
-- "show tasks" → List/Status intent instead
-
-**Use when you want to**:
-- Break down a feature into tasks
-- Create an implementation plan
-- Generate task breakdown
-
-**Examples**:
-```bash
-/sqlew create tasks for user authentication feature
-/sqlew breakdown OAuth2 implementation into tasks
-/sqlew plan implementing password reset feature
-```
-
-**Actions executed**:
-- Parses input into tasks
-- Creates task records with dependencies
-- Provides task summary
-
----
-
-## Common Use Cases
-
-### Planning a Feature
-
-```bash
-# Step 1: Get current status
-/sqlew
-
-# Step 2: Record architectural decision
-/sqlew record we will use JWT for authentication with 24h expiry
-
-# Step 3: Create implementation tasks
-/sqlew plan implementing JWT authentication
-```
-
-### Onboarding to a Project
-
-```bash
-# Get overview
-/sqlew
-
-# Explore decisions
-/sqlew search authentication decisions
-/sqlew search database architecture
-
-# Check current work
-/sqlew show remaining tasks
-```
-
-### During Implementation
-
-```bash
-# Record decisions made
-/sqlew record we added Redis cache for performance
-
-# Check related past decisions
-/sqlew search caching decisions
-
-# Update status
-/sqlew continue with next task
-```
-
----
-
-## Advanced: Direct MCP Tool Access
-
-**Note**: For most use cases, the `/sqlew` command is sufficient and preferred.
-
-Power users can still call MCP tools directly via the tool interface:
-
-```
-mcp__sqlew__decision action="list"
-mcp__sqlew__task action="list"
-mcp__sqlew__decision action="search_tags" tags=["authentication"]
-```
-
-
----
-
-## Configuration
-
-The `/sqlew` command is configured in `.sqlew/config.toml`:
-
-```toml
-[sqlew]
-# Default enabled - no configuration needed
-```
-
----
-
-## Troubleshooting
-
-### Command not recognized
-
-**Symptom**: `/sqlew` appears as unrecognized command
-
-**Solution**:
-1. Restart Claude Code after installation
-2. Verify `.claude/commands/sqlew.md` exists
-3. Check MCP server is running (check console for errors)
-
-### Wrong intent detected
-
-**Symptom**: Command executes wrong action
-
-**Solution**:
-- Use more explicit keywords
-- Example: Instead of `/sqlew tasks`, use `/sqlew show remaining tasks`
-
-### Need more details
-
-**Symptom**: Result seems incomplete
-
-**Solution**:
-- Try searching directly: `/sqlew search <topic>`
-- Or list all: `/sqlew show what we have`
-
----
-
-## Performance Considerations
-
-### Token Usage
-
-The `/sqlew` command is designed for token efficiency:
-- **List/Status**: ~2-5KB (minimal queries)
-- **Search**: ~3-8KB (depending on results)
-- **Record**: ~2-6KB (single write operation)
-- **Execute**: ~5-15KB (task coordination)
-
----
-
-## Related Documentation
-
-
----
-
-## Version History
-
-### v4.1.0 (Current)
-
-- **Major Change**: Unified `/sqlew` command replaces multiple slash commands
-- **New**: Automatic intent detection (6 intent types)
-- **New**: Natural language interface
-- **Removed**: Legacy slash commands (`/sqw-plan`, `/sqw-scrum`, `/sqw-secretary`, etc.)
-- **Removed**: Custom agent definitions (replaced with unified command)
-
-### v4.0.0
-
-- Slash commands released (`/sqw-plan`, `/sqw-secretary`, `/sqw-scrum`, etc.)
-- Agent system refactored (agents completely removed from database in v4.0)
-
----
-
-## See Also
-
-
----
-
-## Contributing
-
-Found a bug or have a suggestion? Please report at:
-https://github.com/sqlew-io/sqlew/issues