sqlew 4.0.1 → 4.0.3

package/CHANGELOG.md

@@ -7,6 +7,133 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ---
 
+## [4.0.3] - 2025-12-04
+
+### Added
+
+**Unified `/sqlew` Slash Command**
+
+- Consolidated all slash commands (`/sqw-plan`, `/sqw-scrum`, `/sqw-research`, etc.) into single `/sqlew` command
+- Natural language interface with automatic intent detection
+- 6-level intent priority: List/Status → Search → Record → Update → Execute → Task Creation
+- Supports both English and Japanese keywords
+- Removed custom agent definitions (sqlew-architect, scrum-master, sqlew-researcher)
+
+**Usage Examples:**
+```bash
+/sqlew                           # Show status and suggest next action
+/sqlew show remaining tasks      # List/Status intent
+/sqlew search for auth decisions # Search intent
+/sqlew record that we use JWT    # Record intent
+/sqlew execute pending tasks     # Execute intent
+```
+
+### Fixed
+
+**v4_task_details JOIN Bug**
+
+- Fixed `task.get` action failing with "no such column: td.project_id" error
+- Root cause: `v4_task_details` table has only `task_id` as PK, not `project_id`
+- Removed invalid `.andOn('t.project_id', '=', 'td.project_id')` from JOIN conditions
+- Affected files: `task-queries.ts`, `get.ts`
+
+### Changed
+
+**Documentation Updates**
+
+- Rewrote `CLAUDE.md` with unified `/sqlew` command section
+- Updated `README.md` Quick Start to use `/sqlew`
+- Rewrote `docs/SLASH_COMMANDS.md` as Unified /sqlew Command Guide
+- Marked `docs/SPECIALIZED_AGENTS.md` as deprecated with migration guide
+
+---
+
+## [4.0.2] - 2025-11-28
+
+### BREAKING CHANGES
+
+**SQL Dump No Longer Supports Cross-Database Format Conversion**
+
+The `db:dump` command now generates SQL for the **same database type only**. Cross-database migrations (e.g., SQLite → MySQL) must use JSON export/import instead.
+
+**Migration Required:**
+```bash
+# ❌ Old approach (no longer supported)
+npx sqlew db:dump mysql backup.sql  # Cross-DB conversion removed
+
+# ✅ New approach: Use JSON for cross-database migration
+npx sqlew db:export backup.json     # Export to JSON
+npx sqlew db:import backup.json     # Import to target database
+```
+
+**Rationale:**
+- SQL syntax differences between databases caused data corruption issues
+- Case-insensitive pattern matching failed in certain scenarios
+- JSON format is database-agnostic and handles all data types correctly
+
+**Node.js 20+ Required**
+
+Minimum Node.js version updated from 18.0.0 to 20.0.0.
+
+### Added
+
+**Unified CLI Entry Point**
+
+- `npx sqlew db:export`, `npx sqlew db:import`, `npx sqlew db:dump` now work directly
+- No `npm install` required - just use `npx sqlew <command>`
+- CLI commands and MCP server mode unified under single `sqlew` entry point
+- Removed separate `sqlew-cli` binary
+
+### Fixed
+
+**Case-Insensitive Validation for Master Records**
+
+- Added case-insensitive duplicate detection when registering new records
+- Prevents duplicate entries like "MyTag" and "mytag" from being created
+- Applies to tags, scopes, layers, and other master table entries
+- New utility: `src/utils/case-insensitive-validator.ts`
+
+**SQLite to MySQL SQL Dump Case-Sensitivity Bug**
+
+- Fixed regex pattern matching that failed with case variations
+- SQL dump now correctly handles mixed-case identifiers
+- Enhanced schema table export for better compatibility
+
+### Changed
+
+**Export Version Tracking**
+
+- Export JSON now includes proper version metadata
+- Version information helps with import compatibility checks
+- Clearer error messages when importing incompatible versions
+
+**CLI Documentation Update**
+
+- Updated `docs/cli/README.md` with JSON-first migration workflow
+- Added clear guidance on when to use `db:dump` vs `db:export`/`db:import`
+- Improved comparison table for migration scenarios
+
+### Added
+
+**Case-Insensitive Validator Utility**
+
+- New `src/utils/case-insensitive-validator.ts` for consistent validation
+- Comprehensive test suite: `src/tests/unit/utils/case-insensitive-validator.test.ts`
+- Reusable across all master table operations
+
+### Migration Notes
+
+**Backward Compatibility:**
+- Existing databases unaffected
+- JSON export/import workflows unchanged
+- SQL dumps for same-database-type operations still work
+
+**Action Required:**
+- Update any scripts that use `db:dump` for cross-database migrations
+- Switch to `db:export`/`db:import` for SQLite ↔ MySQL ↔ PostgreSQL migrations
+
+---
+
 ## [4.0.1] - 2025-11-28
 
 ### Removed

package/README.md

@@ -96,7 +96,7 @@ See [docs/TASK_OVERVIEW.md](docs/TASK_OVERVIEW.md) and [docs/DECISION_CONTEXT.md
 ## Installation
 
 ### Requirements
-- Node.js 18.0.0 or higher
+- Node.js 20.0.0 or higher
 - npm or npx
 
 ### Quick Install
@@ -119,27 +119,30 @@ The first time, sqlew initializes database, installs custom agents and slash com
 
 It's Ready!
 
-## 🚀 Quick Start: Slash Commands (Recommended)
+## 🚀 Quick Start: /sqlew Command
 
-**Slash commands are the easiest way to use sqlew!** Just type `/sqw-` in Claude Code to see available commands.
+**The `/sqlew` command is the easiest way to use sqlew!** Just type `/sqlew` in Claude Code with natural language input.
 
-### Most Common Commands
+### Most Common Uses
 
 ```bash
-# Plan a new feature (architecture + tasks)
-/sqw-plan "Implement user authentication"
+# Show status and get suggestions
+/sqlew
 
-# Record a decision (like meeting minutes)
-/sqw-secretary "Use PostgreSQL 15 for production database"
-
-# Implement a feature (creates tasks AND coordinates agents to build it!)
-/sqw-scrum implement JWT authentication
+# Record a decision
+/sqlew record we use PostgreSQL 15 for production database
 
 # Search past decisions
-/sqw-research "Why did we choose Knex for migrations?"
+/sqlew search why we chose Knex for migrations
+
+# List remaining tasks
+/sqlew show remaining tasks
+
+# Plan a new feature (breakdown into tasks)
+/sqlew plan implementing user authentication
 ```
 
-**All 6 commands** are installed automatically on first run. See [Slash Commands](#slash-commands) section below for complete guide.
+The `/sqlew` command automatically detects your intent (search, record, list, execute, task creation) and invokes the appropriate MCP tools.
 
 ---
 
@@ -262,100 +265,9 @@ or invoke Specialized Agent
 
 Specialized Agents use sqlew more efficiently.
 
-## Specialized Agents
-
-sqlew provides three specialized agents for efficient multi-agent coordination in Claude Code:
-
-| Agent | Purpose | Token Cost | Use When |
-|-------|---------|------------|----------|
-| **Scrum Master** | Multi-agent coordination, task management, sprint planning | 12KB/conversation | Coordinating complex features, managing dependencies, tracking progress |
-| **Researcher** | Query decisions, analyze patterns, investigate context | 14KB/conversation | Understanding past decisions, onboarding new members, sprint retrospectives |
-| **Architect** | Document decisions, enforce constraints, maintain standards | 20KB/conversation | Making architectural choices, establishing rules, validating compliance |
-
-### Detailed Installation
-
-**By default, all three specialized agents are automatically installed** to your project's `.claude/agents/` directory on first run.
-
-To disable specific agents, create `.sqlew/config.toml`:
-
-```toml
-[agents]
-scrum_master = true   # Coordination specialist (12KB)
-researcher = false    # Disable this agent
-architect = true      # Documentation specialist (20KB)
-```
-
-**Note**: Set an agent to `false` in the config file to prevent it from being installed.
-
-**Usage**: Invoke agents with the `@` prefix: `@sqlew-scrum-master`, `@sqlew-researcher`, `@sqlew-architect`
-
-**Recommendation**: Use all three agents together - they're complementary specialists (46KB total).
-
-**Token Optimization** (if needed): Disable unused agents in config.
-Savings: Scrum + Architect = 32KB (30%) | Scrum only = 12KB (74%)
-
-**See [docs/SPECIALIZED_AGENTS.md](docs/SPECIALIZED_AGENTS.md) for complete installation guide, usage examples, and customization.**
-
-## Slash Commands
-
-**🎯 Recommended for Human Users** - Slash commands provide guided workflows that are easier than raw MCP tool calls.
-
-Installed automatically to `.claude/commands/` on server startup. Just type `/sqw-` in Claude Code to get started!
-
-### Available Commands
-
-| Command | What It Does | Perfect For |
-|---------|--------------|-------------|
-| **`/sqw-plan`** | Complete feature planning (architecture + tasks) | Starting new features, planning sprints |
-| **`/sqw-secretary`** | Record decisions like meeting minutes | Documenting team decisions, capturing context |
-| **`/sqw-scrum`** | Create tasks AND coordinate agents to implement them | Actually building features end-to-end |
-| **`/sqw-documentor`** | Document architectural decisions with full context | Design reviews, architecture documentation |
-| **`/sqw-research`** | Search past decisions and analyze patterns | Onboarding, understanding past choices |
-| **`/sqw-review`** | Validate code/design against decisions & constraints | Code reviews, ensuring consistency |
-
-### Why Use Slash Commands?
-
-✅ **Guided workflows** - Commands prompt you through the process
-✅ **Agent coordination** - Automatically invokes the right agents
-✅ **Error handling** - Built-in validation and helpful error messages
-✅ **Mode detection** - `/sqw-scrum plan` manages tasks, `/sqw-scrum implement` builds code
-✅ **No MCP knowledge needed** - Just describe what you want in plain English
-
-### Quick Examples
-
-```bash
-# Starting a new feature
-/sqw-plan Add OAuth2 social login with Google and GitHub
-# → Architect documents decisions, Scrum creates tasks
-
-# Recording a decision from today's meeting
-/sqw-secretary Team decided to use PostgreSQL 15 for production
-# → Saves with context, checks for duplicates
-
-# Actually implementing a feature (game changer!)
-/sqw-scrum implement JWT authentication
-# → Creates tasks, coordinates agents, writes code, runs tests
-
-# Finding out why something was done
-/sqw-research Why did we choose Knex over Prisma?
-# → Searches decisions, shows rationale and tradeoffs
-```
-
-### Configuration
-
-All commands install by default. Customize in `.sqlew/config.toml`:
-
-```toml
-[commands]
-plan = true        # Feature planning
-secretary = true   # Record decisions
-scrum = true       # Task management + execution
-documentor = true  # Architecture docs
-research = true    # Search history
-review = true      # Code/design validation
-```
+---
 
-**📚 Complete Guide**: [docs/SLASH_COMMANDS.md](docs/SLASH_COMMANDS.md) - Usage patterns, customization, examples
+**Note**: The `/sqlew` command supersedes the previous multi-command system (`/sqw-plan`, `/sqw-scrum`, etc.). All functionality is now available through the unified `/sqlew` interface with automatic intent detection.
 
 ### Advanced: Direct MCP Tool Access
 
@@ -441,16 +353,20 @@ Support development via [GitHub Sponsors](https://github.com/sponsors/sin5ddd) -
 
 ## Version
 
-Current version: **3.9.0**
+Current version: **4.0.2**
 See [CHANGELOG.md](CHANGELOG.md) for release history.
 
-**What's New in v3.9.0:**
-- **Decision Intelligence System** - Three-tier duplicate detection (35-44 gentle nudge, 45-59 hard block, 60+ auto-update)
-- **New `suggest` Tool** - Find similar decisions by key, tags, or context
-- **Policy-Based Auto-Triggering** - Automatic suggestions when `suggest_similar=1`
-- **Enhanced Metadata** - Auto-update responses include `duplicate_reason`, `version_info`, `update_command`
+**What's New in v4.0.2:**
+- **Unified CLI Entry Point** - `npx sqlew db:export` works directly (no `npm install` required)
+- **Cross-DB Migration via JSON Only** - SQL dump no longer supports cross-database conversion
+- **Node.js 20+ Required** - Updated minimum version requirement
+
+**What's New in v4.0.0:**
+- **Schema Refactoring** - Unified v4_ table prefix, agent system completely removed
+- **Clean Schema** - No legacy columns, optimized for Decision & Constraint repository
+- **Improved Migration System** - Reorganized v3/v4 directories
 
-See [docs/DECISION_INTELLIGENCE.md](docs/DECISION_INTELLIGENCE.md) for details.
+See [docs/DECISION_INTELLIGENCE.md](docs/DECISION_INTELLIGENCE.md) for details on the suggest tool.
 
 ## License
 

package/assets/claude-md-snippets/plan-mode-integration.md

@@ -0,0 +1,13 @@
+## Plan Mode Integration
+
+When `<system-reminder>Plan mode is active</system-reminder>` appears:
+
+### Phase 1 (Research) - Check existing context:
+- `mcp__sqlew__suggest action="by_tags"` - find related decisions
+- `mcp__sqlew__task action="list" status="in_progress"` - check active tasks
+
+### Phase 4 (Final Plan) - Record outcomes:
+- `mcp__sqlew__decision action="set"` - record key architectural decisions
+- `mcp__sqlew__task action="create_batch"` - create implementation tasks
+
+**Quick Reference**: `.claude/skills/sqw-plan-guidance/SKILL.md`

package/assets/sample-commands/sqlew.md

@@ -0,0 +1,144 @@
+---
+allowed-tools: mcp__sqlew, Task, Read, Glob
+description: sqlew context manager - natural language interface for decisions and tasks
+argument-hint: <what you want to do in natural language>
+---
+
+## sqlew Context Manager
+
+You are an intelligent interface for the sqlew MCP server. Analyze user input and execute appropriate actions automatically.
+
+**Input**: $ARGUMENTS
+
+---
+
+## If No Arguments Provided
+
+Execute status check and suggest next action:
+
+### Step 1: Gather Current Status
+
+1. **Check plan files**: Use Glob to find `.claude/plans/*.md`
+2. **List decisions**: `mcp__sqlew__decision action="list" limit=5`
+3. **List tasks**: `mcp__sqlew__task action="list"`
+
+### Step 2: Analyze and Respond
+
+Based on the gathered information:
+
+| Situation | Action |
+|-----------|--------|
+| Plan exists & No tasks in sqlew | Ask: "Found plan. Create tasks from it?" |
+| Pending/in_progress tasks exist | Ask: "N tasks remaining. Execute them?" → If yes, run parallel |
+| No plan & Tasks exist | Show task status, suggest next action |
+| Nothing exists | Show usage guide |
+
+### Step 3: If User Approves Task Execution
+
+1. Get pending tasks: `mcp__sqlew__task action="list" status="pending"`
+2. For each task, launch a subagent using Task tool
+3. After completion, update status: `mcp__sqlew__task action="move" task_id=X status="done"`
+
+---
+
+## If Arguments Provided
+
+Analyze the input and determine intent. **CHECK IN THIS ORDER** (priority matters):
+
+### 1. List/Status Intent (CHECK FIRST - highest priority)
+**Keywords**: list, show, status, what, overview, remaining, current, existing, left, pending tasks
+
+**Japanese Keywords**: 残り, 残タスク, 書き出, 一覧, 確認, 見せて, 表示
+
+**Note**: If input mentions "remaining tasks", "task list", "show tasks" → This is List/Status, NOT Task creation
+
+**Action**:
+1. `mcp__sqlew__decision action="list" limit=10`
+2. `mcp__sqlew__task action="list"`
+3. Format as overview
+
+### 2. Search Intent
+**Keywords**: search, find, look for, about, related, explore
+
+**Japanese Keywords**: 検索, 探して, 調べて
+
+**Action**:
+1. Extract search term from input
+2. `mcp__sqlew__suggest action="by_tags" tags=["term"]`
+3. `mcp__sqlew__decision action="search_tags" tags=["term"]`
+4. Format and display results
+
+### 3. Record Intent
+**Keywords**: record, add, save, register, decide, decided, decision
+
+**Japanese Keywords**: 記録, 登録, 保存
+
+**Action**:
+1. Extract key, value, and rationale from input
+2. Check for duplicates: `mcp__sqlew__suggest action="check_duplicate" key="key"`
+3. If no duplicate: `mcp__sqlew__decision action="set" key="key" value="value" rationale="rationale"`
+4. Confirm what was recorded
+
+### 4. Update Intent
+**Keywords**: update, change, modify, revise
+
+**Japanese Keywords**: 更新, 変更, 修正
+
+**Action**:
+1. Extract key and new value from input
+2. Get existing: `mcp__sqlew__decision action="get" key="key"`
+3. Update: `mcp__sqlew__decision action="set" key="key" value="new_value"`
+4. Show before/after
+
+### 5. Execute Intent
+**Keywords**: execute, run, do, proceed, continue, finish
+
+**Japanese Keywords**: 実行, 進めて, 続けて, やって
+
+**Action**:
+1. Get pending tasks: `mcp__sqlew__task action="list" status="pending"`
+2. Confirm with user before execution
+3. Launch parallel subagents for each task using Task tool
+4. Update completed tasks to "done"
+
+### 6. Task Creation Intent (CHECK LAST - explicit creation only)
+**Keywords**: create task, make task, breakdown, plan tasks, generate tasks
+
+**Japanese Keywords**: タスク作成, タスクを作って, 洗い出し, タスク化
+
+**IMPORTANT**: Only trigger this if there's an EXPLICIT creation verb. Do NOT trigger for:
+- "remaining tasks" / "残タスク" → List/Status
+- "task list" / "タスク一覧" → List/Status
+- "show tasks" / "タスクを見せて" → List/Status
+
+**Action**:
+1. Read current plan file if exists
+2. Parse plan into tasks
+3. `mcp__sqlew__task action="create_batch" tasks=[...]`
+4. Confirm what was created
+
+---
+
+## Parallel Task Execution
+
+When executing remaining tasks:
+
+```
+For each pending task:
+  1. Use Task tool with subagent_type="general-purpose"
+  2. Provide task description as prompt
+  3. Wait for completion
+  4. Update task status to "done"
+```
+
+Launch multiple Task tools in a single message for parallel execution.
+
+---
+
+## Response Guidelines
+
+- Be concise and actionable
+- Always show what was done
+- Suggest logical next step
+- Use bullet points for clarity
+- If uncertain about intent, ask for clarification

package/assets/sample-skills/sqlew-plan-guidance/SKILL.md

@@ -0,0 +1,55 @@
+---
+name: sqlew-plan-guidance
+description: |
+  Quick reference for sqlew MCP tools.
+  Provides usage patterns for Plan mode integration.
+---
+
+## Quick Reference
+
+### Research (Check Existing Context)
+
+```typescript
+mcp__sqlew__suggest action="by_tags" tags=["tag"]
+mcp__sqlew__decision action="search_tags" tags=["tag"]
+mcp__sqlew__task action="list" status="in_progress"
+```
+
+### Decision Recording
+
+```typescript
+mcp__sqlew__decision action="set"
+  key="decision-key"
+  value="chosen approach"
+  rationale="why this decision was made"
+  alternatives_considered="what other options were evaluated"
+  tradeoffs="benefits and drawbacks"
+```
+
+### Task Creation
+
+```typescript
+mcp__sqlew__task action="create_batch" tasks=[
+  { title: "Task title", layer: "business", priority: 3, file_actions: [...] }
+]
+```
+
+### Constraint Management
+
+```typescript
+mcp__sqlew__constraint action="add"
+  category="architecture"
+  description="rule description"
+  priority=3
+```
+
+## Tool Selection Guide
+
+| Purpose | Tool | Action |
+|---------|------|--------|
+| Find related decisions | suggest | by_tags, by_key |
+| Check for duplicates | suggest | check_duplicate |
+| Record decision | decision | set |
+| Create tasks | task | create, create_batch |
+| Add constraint | constraint | add |
+| List tasks | task | list |

package/dist/cli/db-dump.d.ts

@@ -18,6 +18,10 @@ interface DbDumpArgs {
 export declare function showDbDumpHelp(): void;
 /**
  * Parse command-line arguments for db:dump
+ *
+ * Supports:
+ * - Positional: `db:dump mysql dump.sql`
+ * - key=value format: `db:dump to=mysql from=sqlite` (npm/PowerShell friendly)
  */
 export declare function parseDbDumpArgs(args: string[]): DbDumpArgs;
 /**

package/dist/cli/db-dump.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"db-dump.d.ts","sourceRoot":"","sources":["../../src/cli/db-dump.ts"],"names":[],"mappings":"AAMA,OAAO,EAAmB,KAAK,cAAc,EAAE,KAAK,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAGrG,UAAU,UAAU;IAClB,IAAI,CAAC,EAAE,QAAQ,GAAG,OAAO,GAAG,YAAY,CAAC;IACzC,MAAM,EAAE,cAAc,CAAC;IACvB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,aAAa,CAAC,EAAE,YAAY,CAAC;IAC7B,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAED;;GAEG;AACH,wBAAgB,cAAc,IAAI,IAAI,CA2ErC;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,UAAU,CAiD1D;AA0HD;;GAEG;AACH,wBAAsB,aAAa,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAsKnE;AAED;;GAEG;AACH,wBAAsB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAGjE"}
+{"version":3,"file":"db-dump.d.ts","sourceRoot":"","sources":["../../src/cli/db-dump.ts"],"names":[],"mappings":"AAMA,OAAO,EAAmB,KAAK,cAAc,EAAE,KAAK,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAGrG,UAAU,UAAU;IAClB,IAAI,CAAC,EAAE,QAAQ,GAAG,OAAO,GAAG,YAAY,CAAC;IACzC,MAAM,EAAE,cAAc,CAAC;IACvB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,aAAa,CAAC,EAAE,YAAY,CAAC;IAC7B,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAED;;GAEG;AACH,wBAAgB,cAAc,IAAI,IAAI,CA8CrC;AAED;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,UAAU,CA2C1D;AA0HD;;GAEG;AACH,wBAAsB,aAAa,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAwKnE;AAED;;GAEG;AACH,wBAAsB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAGjE"}