sqlew 4.3.0 → 4.3.1

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

@@ -1,48 +1,50 @@
-## Plan Mode Integration
-
-### Decision & Constraint Recording Format
-
-When writing plans, use these formats to record decisions and constraints.
-They will be **auto-detected on ExitPlanMode** and registered as draft in sqlew.
-
-**Decision format:**
-```markdown
-### 📌 Decision: [key/path]
-- **Value**: Description of the decision
-- **Layer**: presentation | business | data | infrastructure | cross-cutting
-- **Tags**: tag1, tag2 (optional)
-```
-
-**Constraint format:**
-```markdown
-### 🚫 Constraint: [category]
-- **Rule**: Description of the constraint
-- **Priority**: critical | high | medium | low
-- **Tags**: tag1, tag2 (optional)
-```
-
-Category options: `architecture` | `security` | `code-style` | `performance`
-
-### With Claude Code Hooks (Recommended)
-
-If you've run `sqlew init --hooks`, sqlew integration is **fully automatic**:
-- Related decisions are auto-suggested before Task execution
-- Plan files are auto-tracked with unique IDs
-- 📌/🚫 patterns are auto-detected and registered as draft
-- Decisions are auto-saved when code is edited
-- Status updates to `in_review` when all tasks complete
-- Status updates to `implemented` after git merge/rebase
-
-### Manual Usage (Without Hooks)
-
-When `<system-reminder>Plan mode is active</system-reminder>` appears:
-
-**Research Phase:**
-- `/sqlew search for <topic>` - find related decisions
-- `/sqlew show remaining tasks` - check active tasks
-
-**Final Plan Phase:**
-- `/sqlew record <decision>` - record key architectural decisions
-- `/sqlew create task <description>` - create implementation tasks
-
-**Quick Reference**: `.claude/skills/sqlew-decision-format/SKILL.md`
+## Plan Mode Integration
+
+### REQUIRED: Decision & Constraint Recording
+
+**When writing plans, you MUST include the following sections:**
+
+1. **📌 Decisions** - Technology choices, architecture patterns, implementation approaches
+2. **🚫 Constraints** - Rules, restrictions, limitations, prohibited patterns from user requirements
+
+**IMPORTANT**: If the user mentions any restrictions, prohibitions, or "don't use X", these MUST be recorded as 🚫 Constraints.
+
+---
+
+**Decision format (REQUIRED for any technical choice):**
+
+```markdown
+### 📌 Decision: [key/path]
+- **Value**: Description of the decision
+- **Layer**: presentation | business | data | infrastructure | cross-cutting
+- **Tags**: tag1, tag2 (optional)
+```
+
+**Constraint format (REQUIRED when user specifies restrictions):**
+
+```markdown
+### 🚫 Constraint: [category]
+- **Rule**: Description of the constraint
+- **Priority**: critical | high | medium | low
+- **Tags**: tag1, tag2 (optional)
+```
+
+Category options: `architecture` | `security` | `code-style` | `performance`
+
+---
+
+### With Claude Code Hooks (Recommended)
+
+If you've run `sqlew --hooks`, sqlew integration is **fully automatic**:
+
+- 📌/🚫 patterns are auto-detected and registered as draft on ExitPlanMode
+- Related decisions are auto-suggested before Task execution
+- Decisions are auto-saved when code is edited
+
+### Manual Usage (Without Hooks)
+
+**Research Phase:**
+- `/sqlew search for <topic>` - find related decisions
+
+**Final Plan Phase:**
+- `/sqlew record <decision>` - record key architectural decisions

package/assets/config.example.toml

@@ -1,282 +1,120 @@
-# sqlew Configuration File
-# Copy this file to .sqlew/config.toml and customize as needed
-#
-# Priority: CLI arguments > config.toml > database m_config > defaults
-# Documentation: docs/CONFIGURATION.md
-
-# ============================================================================
-# Database Settings
-# ============================================================================
-[database]
-# SQLite Configuration (default, local development)
-# Database file path (relative to project root or absolute)
-# Default: ".sqlew/sqlew.db"
-# path = ".sqlew/custom.db"
-# path = "/absolute/path/to/database.db"
-
-# PostgreSQL/MySQL/MariaDB Configuration (multi-agent production)
-# Uncomment and configure for remote database access
-# type = "postgres"  # or "mysql" (also works with MariaDB 10.5+)
-
-# Connection settings (required for postgres/mysql/mariadb)
-# IMPORTANT: Database must already exist! User does NOT need CREATE DATABASE privilege.
-# [database.connection]
-# host = "localhost"
-# port = 5432  # PostgreSQL: 5432, MySQL/MariaDB: 3306
-# database = "sqlew"  # Must be created beforehand!
-
-# Authentication settings (required for postgres/mysql/mariadb)
-# Required user privileges: SELECT, INSERT, UPDATE, DELETE, CREATE, ALTER, INDEX, DROP, REFERENCES
-# [database.auth]
-# type = "direct"  # Options: "direct", "ssh", "aws-iam", "gcp-iam"
-# user = "postgres"  # or mysql_user, etc.
-# password = "your-password"
-
-# SSL/TLS Configuration (optional, for encrypted connections)
-# [database.auth.ssl]
-# ca = "/path/to/ca-cert.pem"  # or inline certificate content
-# cert = "/path/to/client-cert.pem"  # for mutual TLS
-# key = "/path/to/client-key.pem"  # for mutual TLS
-# rejectUnauthorized = true  # set to false for self-signed certs (not recommended for production)
-
-# SSH Tunnel Configuration (when type = "ssh")
-# Used for bastion host / jump server access
-# [database.auth.ssh]
-# host = "bastion.example.com"
-# port = 22
-# username = "deploy"
-# privateKeyPath = "/home/user/.ssh/id_rsa"  # or use password
-# password = "ssh-password"  # alternative to privateKeyPath
-# passphrase = "key-passphrase"  # if private key is encrypted
-# timeout = 30000  # SSH connection timeout in ms
-# keepalive = true
-# keepaliveInterval = 10000
-# localPort = 50000  # auto-allocated from 50000-60000 if not specified
-
-# ============================================================================
-# Auto-Deletion Settings
-# ============================================================================
-[autodelete]
-# Skip weekends when calculating retention periods
-# When true: 24 hours on Monday = previous Friday (skips Sat/Sun)
-# When false: 24 hours = exactly 24 hours ago
-# Default: false
-ignore_weekend = false
-
-# Message retention period in hours (1-720)
-# Messages older than this are automatically deleted
-# Default: 24 (1 day)
-message_hours = 24
-
-# File change history retention in days (1-365)
-# File changes older than this are automatically deleted
-# Default: 7 (1 week)
-file_history_days = 7
-
-# ============================================================================
-# Debug Logging Settings (v3.5.4)
-# ============================================================================
-[debug]
-# Debug log file path (optional)
-# When set, enables detailed debug logging for troubleshooting
-# Environment variable SQLEW_DEBUG takes precedence over this setting
-# Default: not set (logging disabled)
-# log_path = "/home/user/.sqlew/debug.log"
-# log_path = ".sqlew/debug.log"
-
-# Log level for debug output (case-insensitive)
-# Levels: "error", "warn", "info", "debug"
-# error: Only errors
-# warn: Errors and warnings
-# info: Errors, warnings, and informational messages
-# debug: All messages including debug details
-# Default: "info"
-# log_level = "info"
-
-# ============================================================================
-# Task Management Settings
-# ============================================================================
-[tasks]
-# Auto-archive done tasks after N days (1-365)
-# Tasks in 'done' status older than this are moved to 'archived'
-# Keeps task list clean while preserving history
-# Default: 2 (48 hours)
-auto_archive_done_days = 2
-
-# Stale detection threshold for 'in_progress' tasks (hours, 1-168)
-# Tasks stuck in 'in_progress' longer than this → move to 'waiting_review'
-# Helps recover from interrupted AI sessions
-# Default: 2 (2 hours)
-stale_hours_in_progress = 2
-
-# Stale detection threshold for 'waiting_review' tasks (hours, 1-720)
-# Tasks stuck in 'waiting_review' longer than this → move back to 'todo'
-# Prevents abandoned reviews from blocking workflow
-# Default: 24 (1 day)
-stale_hours_waiting_review = 24
-
-# Enable automatic stale detection
-# When true: Runs stale detection on startup and before task operations
-# When false: Stale detection disabled (manual only)
-# Default: true
-auto_stale_enabled = true
-
-# ============================================================================
-# VCS-Aware Auto-Complete Settings (v3.5.2)
-# ============================================================================
-[vcs]
-# Auto-complete tasks when files are staged (git add)
-# When true: waiting_review → done when files are staged
-# When false: Manual task completion required
-# Default: true
-git_auto_complete_on_stage = true
-
-# Auto-archive tasks when files are committed (git commit)
-# When true: done → archived when files are committed
-# When false: Manual task archiving required
-# Default: true
-git_auto_archive_on_commit = true
-
-# Require ALL watched files to be staged for auto-completion
-# When true: All files must be staged to trigger waiting_review → done
-# When false: At least one file staged is sufficient
-# Default: true
-require_all_files_staged = true
-
-# Require ALL watched files to be committed for auto-archiving
-# When true: All files must be committed to trigger done → archived
-# When false: At least one file committed is sufficient
-# Default: true
-require_all_files_committed_for_archive = true
-
-# ============================================================================
-# Specialized Agents Settings
-# ============================================================================
-[agents]
-# Which specialized agents to enable for your project
-# Set to false to skip agents you don't need (reduces token consumption)
-# Install by manually copying files from assets/sample-agents/ to ~/.claude/agents/
-# Note: Agents are only loaded into Claude Code conversations, not the MCP server
-
-# Scrum Master: Multi-agent coordination, task management, sprint planning
-# Token cost: ~12KB per conversation when loaded in Claude Code
-# Use when: Coordinating complex features, managing dependencies, tracking progress
-# Default: true
-scrum_master = true
-
-# Researcher: Query decisions, analyze patterns, investigate context
-# Token cost: ~14KB per conversation when loaded in Claude Code
-# Use when: Understanding past decisions, onboarding new members, sprint retrospectives
-# Default: true
-researcher = true
-
-# Architect: Document decisions, enforce constraints, maintain standards
-# Token cost: ~20KB per conversation when loaded in Claude Code
-# Use when: Making architectural choices, establishing rules, validating compliance
-# Default: true
-architect = true
-
-# Example: Minimal installation (only Scrum Master for task management)
-# [agents]
-# scrum_master = true
-# researcher = false
-# architect = false
-
-# Token Impact Examples:
-# - All 3 agents: ~46KB loaded per conversation (scrum 12KB + researcher 14KB + architect 20KB)
-# - Scrum + Architect: ~32KB (30% reduction)
-# - Scrum only: ~12KB (74% reduction)
-
-
-# ============================================================================
-# Slash Commands Settings
-# ============================================================================
-[commands]
-# Which slash commands to install on server startup
-# Set to false to skip commands you don't need
-
-# /sqlew: Unified natural language interface for decisions and tasks
-# Usage: /sqlew <what you want to do>
-# Examples:
-#   /sqlew show remaining tasks
-#   /sqlew search for auth decisions
-#   /sqlew record that we use PostgreSQL 15
-# Default: true
-sqlew = true
-
-# ============================================================================
-# Example Configurations
-# ============================================================================
-
-# Example 1: PostgreSQL with Direct Authentication + SSL
-# [database]
-# type = "postgres"
-# [database.connection]
-# host = "db.example.com"
-# port = 5432
-# database = "sqlew_production"
-# [database.auth]
-# type = "direct"
-# user = "postgres"
-# password = "secure-password"
-# [database.auth.ssl]
-# ca = "/path/to/ca-cert.pem"
-# rejectUnauthorized = true
-
-# Example 2: PostgreSQL through SSH Tunnel
-# [database]
-# type = "postgres"
-# [database.connection]
-# host = "db.internal.example.com"
-# port = 5432
-# database = "sqlew_production"
-# [database.auth]
-# type = "ssh"
-# user = "postgres"
-# password = "db-password"
-# [database.auth.ssh]
-# host = "bastion.example.com"
-# username = "deploy"
-# privateKeyPath = "/home/user/.ssh/id_rsa"
-
-# Example 3: MySQL with SSL and SSH
-# [database]
-# type = "mysql"
-# [database.connection]
-# host = "mysql.internal.example.com"
-# port = 3306
-# database = "sqlew_db"
-# [database.auth]
-# type = "ssh"
-# user = "mysql_user"
-# password = "db-password"
-# [database.auth.ssl]
-# ca = "-----BEGIN CERTIFICATE-----\nMIIE...\n-----END CERTIFICATE-----"
-# rejectUnauthorized = true
-# [database.auth.ssh]
-# host = "jump.example.com"
-# port = 22
-# username = "deploy"
-# privateKeyPath = "/home/user/.ssh/deploy_key"
-# passphrase = "key-passphrase"
-# localPort = 53306
-
-# Aggressive cleanup (development)
-# [autodelete]
-# message_hours = 1
-# file_history_days = 1
-# [tasks]
-# auto_archive_done_days = 1
-
-# Conservative cleanup (production)
-# [autodelete]
-# message_hours = 168  # 7 days
-# file_history_days = 30
-# [tasks]
-# auto_archive_done_days = 7
-
-# Weekend-aware workflow (for developers)
-# [autodelete]
-# ignore_weekend = true
-# message_hours = 48
-# file_history_days = 14
+# sqlew Configuration File
+# Copy this file to .sqlew/config.toml and customize as needed
+#
+# Priority: CLI arguments > config.toml > database m_config > defaults
+# Documentation: docs/CONFIGURATION.md
+
+# ============================================================================
+# Database Settings
+# ============================================================================
+[database]
+# SQLite Configuration (default, local development)
+# Database file path (relative to project root or absolute)
+# Default: ".sqlew/sqlew.db"
+# path = ".sqlew/custom.db"
+# path = "/absolute/path/to/database.db"
+
+# PostgreSQL/MySQL/MariaDB Configuration (multi-agent production)
+# Uncomment and configure for remote database access
+# type = "postgres"  # or "mysql" (also works with MariaDB 10.5+)
+
+# Connection settings (required for postgres/mysql/mariadb)
+# IMPORTANT: Database must already exist! User does NOT need CREATE DATABASE privilege.
+# [database.connection]
+# host = "localhost"
+# port = 5432  # PostgreSQL: 5432, MySQL/MariaDB: 3306
+# database = "sqlew"  # Must be created beforehand!
+
+# Authentication settings (required for postgres/mysql/mariadb)
+# Required user privileges: SELECT, INSERT, UPDATE, DELETE, CREATE, ALTER, INDEX, DROP, REFERENCES
+# [database.auth]
+# user = "postgres"  # or mysql_user, etc.
+# password = "your-password"
+
+
+# ============================================================================
+# Debug Logging Settings (v3.5.4)
+# ============================================================================
+[debug]
+# Debug log file path (optional)
+# When set, enables detailed debug logging for troubleshooting
+# Environment variable SQLEW_DEBUG takes precedence over this setting
+# Default: not set (logging disabled)
+# log_path = "/home/user/.sqlew/debug.log"
+# log_path = ".sqlew/debug.log"
+
+# Log level for debug output (case-insensitive)
+# Levels: "error", "warn", "info", "debug"
+# error: Only errors
+# warn: Errors and warnings
+# info: Errors, warnings, and informational messages
+# debug: All messages including debug details
+# Default: "info"
+# log_level = "info"
+
+
+# ============================================================================
+# Specialized Agents Settings (DEPRECATED)
+# ============================================================================
+[agents]
+# DEPRECATED: With Claude Opus 4.5's improved capabilities, specialized agents
+# are no longer necessary. The base model now handles coordination, research,
+# and architectural decisions effectively without additional agent overhead.
+#
+# These settings are preserved for backward compatibility but all agents are
+# disabled by default. Will be removed in v5.0.
+
+# Scrum Master: Multi-agent coordination (DEPRECATED)
+# Default: false
+scrum_master = false
+
+# Researcher: Query decisions, analyze patterns (DEPRECATED)
+# Default: false
+researcher = false
+
+# Architect: Document decisions, enforce constraints (DEPRECATED)
+# Default: false
+architect = false
+
+
+# ============================================================================
+# Slash Commands Settings
+# ============================================================================
+[commands]
+# Which slash commands to install on server startup
+# Set to false to skip commands you don't need
+
+# /sqlew: Unified natural language interface for decisions and tasks
+# Usage: /sqlew <what you want to do>
+# Examples:
+#   /sqlew show remaining tasks
+#   /sqlew search for auth decisions
+#   /sqlew record that we use PostgreSQL 15
+# Default: true
+sqlew = true
+
+# ============================================================================
+# Example Configurations
+# ============================================================================
+
+# Example 1: PostgreSQL with SSL
+# [database]
+# type = "postgres"
+# [database.connection]
+# host = "db.example.com"
+# port = 5432
+# database = "sqlew_production"
+# [database.auth]
+# user = "postgres"
+# password = "secure-password"
+
+# Example 2: MySQL/MariaDB
+# [database]
+# type = "mysql"
+# [database.connection]
+# host = "mysql.example.com"
+# port = 3306
+# database = "sqlew_db"
+# [database.auth]
+# user = "mysql_user"
+# password = "db-password"

package/dist/cli.js

@@ -16,7 +16,7 @@ import { saveCommand } from './cli/hooks/save.js';
 import { checkCompletionCommand } from './cli/hooks/check-completion.js';
 import { markDoneCommand } from './cli/hooks/mark-done.js';
 import { initHooksCommand } from './cli/hooks/init-hooks.js';
-import { initializeSkills, initializeClaudeMd, initializeGitignore } from './init-skills.js';
+import { initializeSkills, initializeRules, initializeGitignore } from './init-skills.js';
 import { onSubagentStopCommand } from './cli/hooks/on-subagent-stop.js';
 import { onStopCommand } from './cli/hooks/on-stop.js';
 import { onEnterPlanCommand } from './cli/hooks/on-enter-plan.js';
@@ -109,54 +109,54 @@ function formatTable(data, headers) {
  * Show help message
  */
 function showHelp() {
-    console.log(`
-sqlew CLI - Query and database migration tool for mcp-sqlew
-
-USAGE:
-  sqlew <command> [options]
-  sqlew --init              # One-shot project setup (recommended)
-
-COMMANDS:
-  Setup:
-    --init           One-shot initialization (Skills + CLAUDE.md + Hooks + gitignore)
-    init --hooks     Initialize Claude Code and Git hooks only
-
-  Database:
-    db:dump    Generate SQL dump for database migration (schema + data)
-    db:export  Export project data to JSON format (data-only, for append-import)
-    db:import  Import project data from JSON export (append to existing database)
-
-  Claude Code Hooks (v4.1.0+):
-    suggest          Find related decisions (PreToolUse hook for Task)
-    track-plan       Track plan files (PreToolUse hook for Write)
-    save             Save decisions on code edit (PostToolUse hook for Edit|Write)
-    check-completion Check task completion (PostToolUse hook for TodoWrite)
-    mark-done        Mark decisions as implemented (Git hooks or manual)
-
-  Plan Mode Hooks (v4.2.0+):
-    on-enter-plan    Inject TOML template (PostToolUse hook for EnterPlanMode)
-    on-exit-plan     Prompt TOML documentation (PostToolUse hook for ExitPlanMode)
-    on-subagent-stop Process Plan agent completion (SubagentStop hook)
-    on-stop          Process main agent stop (Stop hook)
-
-OPTIONS:
-  --init                   Initialize all sqlew integrations
-  --help                   Show this help message
-
-EXAMPLES:
-  # Full project setup (Skills, CLAUDE.md, Hooks, gitignore)
-  sqlew --init
-
-  # Initialize only hooks
-  sqlew init --hooks
-
-  # Generate MySQL dump for database migration
-  npm run db:dump -- mysql -o dump-mysql.sql
-
-For more information on commands, run:
-  npm run db:dump -- --help
-  npm run db:export -- --help
-  npm run db:import -- --help
+    console.log(`
+sqlew CLI - Query and database migration tool for mcp-sqlew
+
+USAGE:
+  sqlew <command> [options]
+  sqlew --init              # One-shot project setup (recommended)
+
+COMMANDS:
+  Setup:
+    --init           One-shot initialization (Skills + CLAUDE.md + Hooks + gitignore)
+    init --hooks     Initialize Claude Code and Git hooks only
+
+  Database:
+    db:dump    Generate SQL dump for database migration (schema + data)
+    db:export  Export project data to JSON format (data-only, for append-import)
+    db:import  Import project data from JSON export (append to existing database)
+
+  Claude Code Hooks (v4.1.0+):
+    suggest          Find related decisions (PreToolUse hook for Task)
+    track-plan       Track plan files (PreToolUse hook for Write)
+    save             Save decisions on code edit (PostToolUse hook for Edit|Write)
+    check-completion Check task completion (PostToolUse hook for TodoWrite)
+    mark-done        Mark decisions as implemented (Git hooks or manual)
+
+  Plan Mode Hooks (v4.2.0+):
+    on-enter-plan    Inject TOML template (PostToolUse hook for EnterPlanMode)
+    on-exit-plan     Prompt TOML documentation (PostToolUse hook for ExitPlanMode)
+    on-subagent-stop Process Plan agent completion (SubagentStop hook)
+    on-stop          Process main agent stop (Stop hook)
+
+OPTIONS:
+  --init                   Initialize all sqlew integrations
+  --help                   Show this help message
+
+EXAMPLES:
+  # Full project setup (Skills, CLAUDE.md, Hooks, gitignore)
+  sqlew --init
+
+  # Initialize only hooks
+  sqlew init --hooks
+
+  # Generate MySQL dump for database migration
+  npm run db:dump -- mysql -o dump-mysql.sql
+
+For more information on commands, run:
+  npm run db:dump -- --help
+  npm run db:export -- --help
+  npm run db:import -- --help
 `);
 }
 // ============================================================================
@@ -251,14 +251,14 @@ async function initAllCommand() {
     catch (error) {
         console.log(`      ✗ Skills failed: ${error instanceof Error ? error.message : String(error)}`);
     }
-    // 2. Initialize CLAUDE.md
-    console.log('[2/4] Updating CLAUDE.md...');
+    // 2. Initialize .claude/rules/
+    console.log('[2/4] Setting up .claude/rules/...');
     try {
-        initializeClaudeMd(projectPath);
-        console.log('      ✓ CLAUDE.md updated');
+        initializeRules(projectPath);
+        console.log('      ✓ Plan mode integration rule installed');
     }
     catch (error) {
-        console.log(`      ✗ CLAUDE.md failed: ${error instanceof Error ? error.message : String(error)}`);
+        console.log(`      ✗ Rules setup failed: ${error instanceof Error ? error.message : String(error)}`);
     }
     // 3. Initialize Hooks
     console.log('[3/4] Setting up Claude Code Hooks...');