sqlew 4.3.1 → 5.0.1

package/docs/cli/DATA_EXPORT_IMPORT.md

@@ -30,26 +30,26 @@ solutions including schema + data using SQL dumps.
 
 ```bash
 # Export all projects (no installation required!)
-npx sqlew db:export backup.json
+sqlew db:export backup.json
 
 # Export specific project to file
-npx sqlew db:export backup.json project=my-project
+sqlew db:export backup.json project=my-project
 
 # Export to stdout (pipe to another command)
-npx sqlew db:export project=visualizer
+sqlew db:export project=visualizer
 ```
 
 ### Import a Project
 
 ```bash
 # Import from JSON export
-npx sqlew db:import backup.json
+sqlew db:import backup.json
 
 # Import with custom project name
-npx sqlew db:import backup.json project-name=new-name
+sqlew db:import backup.json project-name=new-name
 
 # Dry-run validation (no actual import)
-npx sqlew db:import backup.json dry-run=true
+sqlew db:import backup.json dry-run=true
 ```
 
 ## Export Command
@@ -57,16 +57,16 @@ npx sqlew db:import backup.json dry-run=true
 ### Syntax
 
 ```bash
-npx sqlew db:export [output-file] [key=value ...]
+sqlew db:export [output-file] [key=value ...]
 ```
 
 ### Options
 
-| Option            | Description                     | Default           |
-|-------------------|---------------------------------|-------------------|
-| `project=<name>`  | Export specific project by name | All projects      |
-| `db-path=<path>`  | Database file path              | `.sqlew/sqlew.db` |
-| `config=<path>`   | Config file path                | Auto-detect       |
+| Option           | Description                     | Default           |
+| ---------------- | ------------------------------- | ----------------- |
+| `project=<name>` | Export specific project by name | All projects      |
+| `db-path=<path>` | Database file path              | `.sqlew/sqlew.db` |
+| `config=<path>`  | Config file path                | Auto-detect       |
 
 ### What Gets Exported
 
@@ -95,19 +95,19 @@ npx sqlew db:export [output-file] [key=value ...]
 ### Syntax
 
 ```bash
-npx sqlew db:import <source-file> [key=value ...]
+sqlew db:import <source-file> [key=value ...]
 ```
 
 ### Options
 
-| Option                   | Description                   | Default            |
-|--------------------------|-------------------------------|--------------------|
-| `<source-file>`          | JSON export file path         | **Required**       |
-| `project-name=<name>`    | Target project name           | Use name from JSON |
-| `skip-if-exists=true`    | Skip import if project exists | `true`             |
-| `dry-run=true`           | Validate only, don't import   | `false`            |
-| `db-path=<path>`         | Database file path            | `.sqlew/sqlew.db`  |
-| `config=<path>`          | Config file path              | Auto-detect        |
+| Option                | Description                   | Default            |
+| --------------------- | ----------------------------- | ------------------ |
+| `<source-file>`       | JSON export file path         | **Required**       |
+| `project-name=<name>` | Target project name           | Use name from JSON |
+| `skip-if-exists=true` | Skip import if project exists | `true`             |
+| `dry-run=true`        | Validate only, don't import   | `false`            |
+| `db-path=<path>`      | Database file path            | `.sqlew/sqlew.db`  |
+| `config=<path>`       | Config file path              | Auto-detect        |
 
 ### Import Process
 
@@ -152,16 +152,17 @@ npx sqlew db:import <source-file> [key=value ...]
 
 ```bash
 # Export data
-npx sqlew db:export backup.json
+sqlew db:export backup.json
 
 # Import data
-npx sqlew db:import backup.json
+sqlew db:import backup.json
 
 # SQL dump (same-database backup)
-npx sqlew db:dump sqlite backup.sql
+sqlew db:dump sqlite backup.sql
 ```
 
 **Note**: Both MCP server mode and CLI commands use the same `sqlew` entry point. The first argument determines the mode:
+
 - `db:export`, `db:import`, `db:dump`, `query` → CLI mode
 - No argument or MCP-related args → MCP server mode
 
@@ -177,13 +178,13 @@ consolidate all project contexts into one shared database.
 ```bash
 # Step 1: Export from each project's SQLite database
 cd ~/project-a
-npx sqlew db:export /tmp/project-a.json project=project-a
+sqlew db:export /tmp/project-a.json project=project-a
 
 cd ~/project-b
-npx sqlew db:export /tmp/project-b.json project=project-b
+sqlew db:export /tmp/project-b.json project=project-b
 
 cd ~/project-c
-npx sqlew db:export /tmp/project-c.json project=project-c
+sqlew db:export /tmp/project-c.json project=project-c
 
 # Step 2: Create shared database and import all projects
 cd ~/shared-database
@@ -197,9 +198,9 @@ cd ~/shared-database
 # password = "mypassword"
 # database = "shared_sqlew_db"
 
-npx sqlew db:import /tmp/project-a.json
-npx sqlew db:import /tmp/project-b.json
-npx sqlew db:import /tmp/project-c.json
+sqlew db:import /tmp/project-a.json
+sqlew db:import /tmp/project-b.json
+sqlew db:import /tmp/project-c.json
 
 # Step 3: Configure each project to use shared database
 # In each project's .mcp.json:
@@ -230,11 +231,11 @@ npx sqlew db:import /tmp/project-c.json
 
 ```bash
 # Export from source database
-npx sqlew db:export main-export.json project=main
+sqlew db:export main-export.json project=main
 
 # Import to different database (different machine or different database type)
 # This works because the project doesn't exist in the target database yet
-npx sqlew db:import main-export.json db-path=/path/to/new/database.db
+sqlew db:import main-export.json db-path=/path/to/new/database.db
 ```
 
 **Note**: Import skips if project name exists.
@@ -243,44 +244,44 @@ npx sqlew db:import main-export.json db-path=/path/to/new/database.db
 
 ```bash
 # Backup with SQL dump (preserves schema + data)
-npx sqlew db:dump sqlite backup-$(date +%Y%m%d).sql
+sqlew db:dump sqlite backup-$(date +%Y%m%d).sql
 
 # Or simple SQLite file copy
 cp .sqlew/sqlew.db .sqlew/backup-$(date +%Y%m%d).db
 ```
 
-See `npx sqlew db:dump --help` for full backup options.
+See `sqlew db:dump --help` for full backup options.
 
 ### Project Sharing
 
 ```bash
 # Developer A: Export project
-npx sqlew db:export feature-x.json project=feature-x
+sqlew db:export feature-x.json project=feature-x
 
 # Developer B: Import project
-npx sqlew db:import feature-x.json
+sqlew db:import feature-x.json
 ```
 
 ### Multi-Project Consolidation
 
 ```bash
 # Export from different databases
-npx sqlew db:export vis.json project=visualizer
-npx sqlew db:export api.json project=api
+sqlew db:export vis.json project=visualizer
+sqlew db:export api.json project=api
 
 # Import to single database
-npx sqlew db:import vis.json
-npx sqlew db:import api.json
+sqlew db:import vis.json
+sqlew db:import api.json
 ```
 
 ### Cross-Database Migration
 
 ```bash
 # Export from SQLite
-npx sqlew db:export data.json db-path=.sqlew/sqlew.db
+sqlew db:export data.json db-path=.sqlew/sqlew.db
 
 # Import to MySQL (configure .sqlew/config.toml for MySQL first)
-npx sqlew db:import data.json
+sqlew db:import data.json
 ```
 
 ---
@@ -307,7 +308,7 @@ Before starting a migration, ensure you have:
 cd /path/to/your/project
 
 # Export all data to JSON
-npx sqlew db:export migration-backup.json
+sqlew db:export migration-backup.json
 ```
 
 #### Step 2: Prepare MySQL Database
@@ -352,17 +353,17 @@ name = "your-project-name"
 
 ```bash
 # Import data to MySQL (config.toml will be used automatically)
-npx sqlew db:import migration-backup.json
+sqlew db:import migration-backup.json
 ```
 
 #### Step 5: Verify Migration
 
 ```bash
 # Test MCP server connection
-npx sqlew --config-path=.sqlew/config.toml
+sqlew --config-path=.sqlew/config.toml
 
 # Or test with MCP Inspector
-npx @modelcontextprotocol/inspector npx sqlew
+npx @modelcontextprotocol/inspector sqlew
 ```
 
 ---
@@ -375,7 +376,7 @@ npx @modelcontextprotocol/inspector npx sqlew
 cd /path/to/your/project
 
 # Export all data to JSON
-npx sqlew db:export migration-backup.json
+sqlew db:export migration-backup.json
 ```
 
 #### Step 2: Prepare PostgreSQL Database
@@ -422,14 +423,14 @@ name = "your-project-name"
 
 ```bash
 # Import data to PostgreSQL
-npx sqlew db:import migration-backup.json
+sqlew db:import migration-backup.json
 ```
 
 #### Step 5: Verify Migration
 
 ```bash
 # Test MCP server connection
-npx sqlew --config-path=.sqlew/config.toml
+sqlew --config-path=.sqlew/config.toml
 ```
 
 ---
@@ -458,7 +459,7 @@ password = "mysql-password"
 Then export:
 
 ```bash
-npx sqlew db:export migration-backup.json
+sqlew db:export migration-backup.json
 ```
 
 #### Step 2: Prepare PostgreSQL Database
@@ -500,7 +501,7 @@ name = "your-project-name"
 #### Step 4: Import to PostgreSQL
 
 ```bash
-npx sqlew db:import migration-backup.json
+sqlew db:import migration-backup.json
 ```
 
 ---
@@ -528,10 +529,10 @@ SELECT COUNT(*) FROM v4_file_changes;
 
 ```bash
 # Start MCP server with new config
-npx sqlew
+sqlew
 
 # Or use MCP Inspector for interactive testing
-npx @modelcontextprotocol/inspector npx sqlew
+npx @modelcontextprotocol/inspector sqlew
 ```
 
 #### 3. Verify in Claude Code
@@ -540,12 +541,12 @@ Update your `.mcp.json` to use the new database:
 
 ```json
 {
-  "mcpServers": {
-    "sqlew": {
-      "command": "npx",
-      "args": ["sqlew", "--config-path", "/path/to/.sqlew/config.toml"]
+    "mcpServers": {
+        "sqlew": {
+            "command": "npx",
+            "args": ["sqlew", "--config-path", "/path/to/.sqlew/config.toml"]
+        }
     }
-  }
 }
 ```
 
@@ -584,6 +585,7 @@ Error: permission denied for schema public
 ```
 
 **Solution**: Grant schema privileges to the user:
+
 ```sql
 -- PostgreSQL
 GRANT ALL ON SCHEMA public TO sqlew_user;
@@ -632,7 +634,7 @@ Solution: Ensure all referenced entities exist in export
 Always test imports with `dry-run=true` first:
 
 ```bash
-npx sqlew db:import data.json dry-run=true
+sqlew db:import data.json dry-run=true
 ```
 
 This validates:
@@ -666,16 +668,16 @@ This validates:
 
 ## Comparison with db:dump
 
-| Feature            | db:export (JSON)                     | db:dump (SQL)                         |
-|--------------------|--------------------------------------|---------------------------------------|
-| Format             | JSON data only                       | SQL DDL + data                        |
-| Schema             | Not included                         | Full schema included                  |
-| Use Case           | **Cross-DB migration**, sharing      | **Same-DB backup/restore**            |
-| Cross-DB           | ✅ **Yes (ONLY option for cross-DB)** | ❌ No (v4.0.2+ same-DB only)           |
-| Size               | Smaller (~40% reduction)             | Larger (includes schema)              |
-| Import Speed       | Slower (ID remapping)                | Faster (direct SQL execution)         |
-| Conflict Handling  | Smart deduplication                  | Overwrite or fail                     |
-| Restore Capability | ❌ Skips if exists                    | ✅ Full restore                        |
+| Feature            | db:export (JSON)                      | db:dump (SQL)                 |
+| ------------------ | ------------------------------------- | ----------------------------- |
+| Format             | JSON data only                        | SQL DDL + data                |
+| Schema             | Not included                          | Full schema included          |
+| Use Case           | **Cross-DB migration**, sharing       | **Same-DB backup/restore**    |
+| Cross-DB           | ✅ **Yes (ONLY option for cross-DB)** | ❌ No (v4.0.2+ same-DB only)  |
+| Size               | Smaller (~40% reduction)              | Larger (includes schema)      |
+| Import Speed       | Slower (ID remapping)                 | Faster (direct SQL execution) |
+| Conflict Handling  | Smart deduplication                   | Overwrite or fail             |
+| Restore Capability | ❌ Skips if exists                    | ✅ Full restore               |
 
 **When to use db:export (JSON)** - **REQUIRED FOR CROSS-DATABASE**:
 

package/package.json

@@ -1,12 +1,11 @@
 {
   "name": "sqlew",
   "description": "Automated ADR (Architecture Decision Records) for Claude Code - MCP server with SQL-backed decision repository",
-  "version": "4.3.1",
+  "version": "5.0.1",
   "main": "dist/index.js",
   "type": "module",
   "bin": {
-    "sqlew": "dist/index.js",
-    "sqlew-init-commands": "dist/init-commands.js"
+    "sqlew": "dist/index.js"
   },
   "files": [
     "dist/",
@@ -20,7 +19,7 @@
     "MIGRATION_v2.md"
   ],
   "scripts": {
-    "build": "tsc",
+    "build": "tsc && node scripts/copy-help-data.js",
     "start": "node dist/index.js",
     "dev": "tsc --watch",
     "clean": "rimraf dist",
@@ -41,12 +40,12 @@
   },
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/sin5ddd/mcp-sqlew.git"
+    "url": "git+https://github.com/sqlew-io/sqlew.git"
   },
   "bugs": {
-    "url": "https://github.com/sin5ddd/mcp-sqlew/issues"
+    "url": "https://github.com/sqlew-io/sqlew/issues"
   },
-  "homepage": "https://github.com/sin5ddd/mcp-sqlew#readme",
+  "homepage": "https://github.com/sqlew-io/sqlew#readme",
   "keywords": [
     "adr",
     "architecture-decision-record",
@@ -62,7 +61,7 @@
     "mysql",
     "token-efficiency"
   ],
-  "author": "sin5ddd",
+  "author": "sqlew-io",
   "license": "Apache-2.0",
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.21.1",

package/scripts/copy-help-data.js

@@ -0,0 +1,19 @@
+/**
+ * Copy help-data TOML files to dist directory
+ * Used in build process since tsc doesn't copy non-TS files
+ */
+
+import { cpSync } from 'fs';
+import { fileURLToPath } from 'url';
+import { dirname, join } from 'path';
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+const projectRoot = join(__dirname, '..');
+
+const src = join(projectRoot, 'src', 'help-data');
+const dest = join(projectRoot, 'dist', 'help-data');
+
+cpSync(src, dest, { recursive: true });
+
+console.log('✅ Copied help-data to dist/');

package/assets/config.example.toml

@@ -1,120 +0,0 @@
-# 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/assets/sample-agents/README.md

@@ -1,36 +0,0 @@
-# Specialized Agents for sqlew
-
-This directory contains specialized agent files for efficient multi-agent coordination using mcp-sqlew.
-
-## Documentation
-
-**For complete installation guide, usage examples, and customization:**
-
-
-## Agent Files
-
-- `sqlew-scrum-master.md` - Multi-agent coordination, task management, sprint planning (12KB tokens)
-- `sqlew-researcher.md` - Query decisions, analyze patterns, investigate context (14KB tokens)
-- `sqlew-architect.md` - Document decisions, enforce constraints, maintain standards (20KB tokens)
-
-
-## Quick Install
-
-Configure which agents to install in `.sqlew/config.toml`:
-
-```toml
-[agents]
-scrum_master = true
-researcher = true
-architect = true
-```
-
-Agents configured as `true` are automatically installed to your project's `.claude/agents/` directory.
-
-**Usage**: Invoke agents with the `@` prefix: `@sqlew-scrum-master`, `@sqlew-researcher`, `@sqlew-architect`
-
-
-## Links
-
-- [Main README](../../README.md#specialized-agents)
-- [Project Repository](https://github.com/sin5ddd/mcp-sqlew)