sqlew 3.5.3 → 3.6.0

package/README.md

@@ -8,82 +8,37 @@
 
 ## What is sqlew?
 
-**sqlew** is a Model Context Protocol (MCP) server that gives AI agents organizational memory. It solves a critical problem: **AI agents can't remember decisions across sessions**.
+**sqlew** is a Model Context Protocol (MCP) server that gives AI agents organizational memory across sessions.
 
-### The Problem
+**The Problem:** Without sqlew, every Claude session starts with zero context. You must re-explain decisions, agents can reintroduce bugs, and there's no way to track WHY decisions were made.
 
-Without sqlew:
-- 🔴 Every new Claude session starts with zero context
-- 🔴 Must re-explain architectural decisions every time
-- 🔴 Agents can reintroduce bugs that were already fixed
-- 🔴 No way to track WHY decisions were made
+**The Solution:** sqlew lets agents remember decisions, query past context, prevent regressions with constraints, and coordinate via messaging and tasks.
 
-### The Solution
-
-With sqlew, AI agents can:
-- ✅ **Remember** architectural decisions across sessions
-- ✅ **Query** past context: "What breaking changes were made to the API?"
-- ✅ **Prevent** regressions by storing constraints: "Duration must NOT occur in Loom module"
-- ✅ **Coordinate** between multiple agents with messaging and task tracking
-
-**Real-World Example:**
-```typescript
-// Agent in Session 1 records:
-{
-  key: "api_v1_deprecated",
-  value: "/v1/users endpoint deprecated, use /v2/users",
-  tags: ["api", "breaking-change"]
-}
-
-// Agent in Session 2 (days later) queries:
-"What API changes should I know about?"
-→ Finds the deprecation decision
-→ Uses /v2/users endpoint automatically!
-```
+**Example:** Session 1 records "API v1 deprecated". Session 2 (days later) queries and automatically uses v2.
 
 ## Why Use sqlew?
 
 ### 🧠 Organizational Memory
-Traditional code only tells you **WHAT** and **HOW**. sqlew adds **WHY**:
-- Git history → WHAT changed
-- Code comments → HOW it works
-- **sqlew decisions** → **WHY** it was changed
-- **sqlew constraints** → **WHY** it must work this way
+Traditional code tells you **WHAT** and **HOW**. sqlew adds **WHY**:
+- **Decisions** → WHY it was changed
+- **Constraints** → WHY it must work this way
 
 ### ⚡ Token Efficiency
-**60-75% token reduction** in multi-session projects:
-- Store decisions once, query selectively
-- Structured data (20-30 tokens) vs prose (50-200 tokens)
-- Cross-session persistence eliminates context re-explanation
+**60-75% token reduction** in multi-session projects through structured data storage and selective querying.
 
 ### 🎯 Key Features
 - **7 Specialized Tools**: decisions, messages, tasks, files, constraints, stats, config
 - **Metadata-Driven**: Tag, layer, scope, and version everything
-- **Decision Context** (v3.2.2): Rich decision documentation with rationale and trade-offs
-  - Document **WHY** decisions were made, not just **WHAT**
-  - Store alternatives considered and pros/cons analysis
-  - Perfect for multi-session AI development and team handoffs
-  - Link decisions to tasks and constraints for full traceability
-- **Task Dependencies** (v3.2.0): Blocking relationships with circular detection
-  - Sequential workflow management (API before UI, DB before ORM)
-  - Bidirectional queries (find blockers and blocking tasks)
-  - Token-efficient metadata-only queries (~88% reduction)
-- **Auto-File Tracking** (v3.0.2): Zero-token task management via automatic file watching
-  - Auto-transition: `todo` → `in_progress` on file edit
-  - Auto-complete: `in_progress` → `done` when acceptance criteria pass
-  - 97% token reduction (4,650 tokens saved per 6-task session)
-- **Smart Review Detection** (v3.4.1): Quality-based auto-transition to `waiting_review`
-  - All watched files modified + TypeScript compiles + Tests pass + 15min idle
-  - Purely algorithmic - no AI instructions needed
-  - Configurable quality gates via `.sqlew/config.toml`
-  - Hybrid mode: Tasks with acceptance_criteria skip review → go directly to `done`
-- **Auto-Stale Detection & Auto-Archive**: Tasks automatically transition when idle
-  - `in_progress` → `waiting_review` (quality gates or >2 hours idle)
-  - `waiting_review` → `todo` (>24 hours idle)
-  - `done` → `archived` (>48 hours idle, weekend-aware)
-- **Weekend-Aware Cleanup**: Smart retention that pauses during weekends
+- **Decision Context**: Document WHY with rationale, alternatives, and trade-offs
+- **Task Dependencies**: Blocking relationships with circular detection
+- **Auto-File Tracking**: Zero-token task management via file watching
+- **Smart Review Detection**: Quality-based auto-transition to `waiting_review`
+- **Auto-Stale Detection**: Tasks auto-transition when idle
+- **Weekend-Aware Cleanup**: Smart retention during weekends
 - **Batch Operations**: Process up to 50 items atomically
 
+See [docs/TASK_OVERVIEW.md](docs/TASK_OVERVIEW.md) and [docs/DECISION_CONTEXT.md](docs/DECISION_CONTEXT.md) for details.
+
 ### 🔖Kanban-style AI Scrum
 ![kanban-style task management](assets/kanban-style.png)
 
@@ -114,104 +69,46 @@ Edit `claude_desktop_config.json`:
 }
 ```
 
-That's it! Restart Claude Desktop and sqlew is ready.
-
-### Custom Database Path (Optional)
-
-```json
-{
-  "mcpServers": {
-    "sqlew": {
-      "command": "npx",
-      "args": ["sqlew", "/path/to/database.db"]
-    }
-  }
-}
-```
+Restart Claude Desktop. Done!
 
-Default location: `.sqlew/sqlew.db` in current directory
+**Custom database path:** Add path as argument: `"args": ["sqlew", "/path/to/db.db"]`
+**Default location:** `.sqlew/sqlew.db`
 
 ## Configuration
 
 ### Optional Config File
 
-sqlew supports TOML configuration files for persistent settings (`.sqlew/config.toml`):
+Create `.sqlew/config.toml` for persistent settings:
 
 ```toml
 [database]
-path = ".sqlew/custom.db"  # Override database location
+path = ".sqlew/custom.db"
 
 [autodelete]
-ignore_weekend = true       # Skip weekends in retention
-message_hours = 48          # Keep messages 48 hours
-file_history_days = 14      # Keep file history 14 days
-
-[tasks]
-auto_archive_done_days = 2
-stale_hours_in_progress = 2
-auto_stale_enabled = true
-```
-
-**Setup:**
-```bash
-# Copy example config
-cp .sqlew/config.toml.example .sqlew/config.toml
-
-# Edit settings
-nano .sqlew/config.toml
-
-# Start sqlew (automatically loads config)
-npx sqlew
+ignore_weekend = true
+message_hours = 48
 ```
 
 **Priority:** CLI args > config.toml > database defaults
 
-**Complete Guide:** See [docs/CONFIGURATION.md](docs/CONFIGURATION.md) for:
-- All configuration options and validation rules
-- Common configurations (dev/prod/weekend-aware)
-- Runtime updates via MCP tools
-- Troubleshooting
+See [docs/CONFIGURATION.md](docs/CONFIGURATION.md) for all options and validation rules.
 
 ## Quick Start
 
-### For AI Agents
-
-⚠️ **Most Important Rule**: ALWAYS include the `action` parameter in every tool call.
-
-```javascript
-// ❌ WRONG
-{key: "auth_method", value: "jwt"}
-
-// ✅ CORRECT
-{action: "set", key: "auth_method", value: "jwt", layer: "business"}
-```
-
 ### Basic Usage
 
+All tools require an `action` parameter. Example:
+
 ```javascript
 // Store a decision
-{
-  action: "set",
-  key: "auth_method",
-  value: "JWT with refresh tokens",
-  layer: "business",
-  tags: ["authentication", "security"]
-}
-
-// Query it later
-{
-  action: "get",
-  key: "auth_method"
-}
+{action: "set", key: "auth_method", value: "JWT", layer: "business", tags: ["security"]}
 
-// Search by tags
-{
-  action: "search_tags",
-  tags: ["security"],
-  status: "active"
-}
+// Query later
+{action: "get", key: "auth_method"}
 ```
 
+For detailed examples, see [docs/TOOL_REFERENCE.md](docs/TOOL_REFERENCE.md).
+
 ### Available Tools
 
 | Tool | Purpose | Example Use |
@@ -230,157 +127,49 @@ Each tool supports `action: "help"` for full documentation and `action: "example
 
 ### On-Demand Documentation
 
-**All tools provide built-in documentation with zero upfront token cost:**
-- `action: "help"` - Detailed parameter reference, action descriptions, examples
-- `action: "example"` - Comprehensive usage scenarios, workflows, best practices
+All tools support:
+- `action: "help"` - Parameter reference and descriptions
+- `action: "example"` - Usage scenarios and examples
 
-**Example:**
-```javascript
-// Get detailed help for decision tool
-{action: "help"}
-
-// Get comprehensive examples for task tool
-{action: "example"}
-```
-
-### For AI Agents (68% Token Reduction)
+### For AI Agents
 
-**Tool Selection & Workflows:**
-- 📖 **[Tool Selection](docs/TOOL_SELECTION.md)** - Decision tree, when to use each tool (236 lines, ~12k tokens)
-- 🔄 **[Workflows](docs/WORKFLOWS.md)** - Multi-step examples, multi-agent coordination (602 lines, ~30k tokens)
-- 📚 **[Tool Reference](docs/TOOL_REFERENCE.md)** - Parameters, batch operations, templates (471 lines, ~24k tokens)
-- ✅ **[Best Practices](docs/BEST_PRACTICES.md)** - Common errors, troubleshooting (345 lines, ~17k tokens)
+**Essential Guides:**
+- [Tool Selection](docs/TOOL_SELECTION.md) - Decision tree, when to use each tool
+- [Workflows](docs/WORKFLOWS.md) - Multi-step examples, multi-agent coordination
+- [Tool Reference](docs/TOOL_REFERENCE.md) - Parameters, batch operations, templates
+- [Best Practices](docs/BEST_PRACTICES.md) - Common errors, troubleshooting
 
 **Task System:**
-- 📋 **[Task Overview](docs/TASK_OVERVIEW.md)** - Lifecycle, status transitions, auto-stale (363 lines, ~10k tokens)
-- ⚙️ **[Task Actions](docs/TASK_ACTIONS.md)** - All actions with examples (1,100+ lines, ~28k tokens)
-- 🔗 **[Task Dependencies](docs/TASK_DEPENDENCIES.md)** - Blocking relationships, circular detection (500+ lines, ~13k tokens) **NEW v3.2.0**
-- 🔗 **[Task Linking](docs/TASK_LINKING.md)** - Link tasks to decisions/constraints/files/tasks (900+ lines, ~23k tokens)
-- 🔄 **[Task Migration](docs/TASK_MIGRATION.md)** - Migrate from decision-based tracking (701 lines, ~18k tokens)
-
-**Decision Context (v3.2.2):**
-- 📝 **[Decision Context](docs/DECISION_CONTEXT.md)** - Rich decision documentation with rationale, alternatives, and tradeoffs (500+ lines, ~15k tokens) **NEW v3.2.2**
-
-**Auto File Tracking (v3.0.2):**
-- 🤖 **[Auto File Tracking](docs/AUTO_FILE_TRACKING.md)** - Zero-token task management, setup, troubleshooting
-- ✅ **[Acceptance Criteria](docs/ACCEPTANCE_CRITERIA.md)** - All check types (tests_pass, code_removed, code_contains, file_exists)
-
-**Shared References:**
-- 📘 **[Shared Concepts](docs/SHARED_CONCEPTS.md)** - Layer definitions, enum values, atomic mode (339 lines, ~17k tokens)
-- ⚙️ **[Configuration](docs/CONFIGURATION.md)** - Config file setup, all options, validation rules (800+ lines, ~20k tokens) **NEW v3.4.1**
-- 🏗️ **[Architecture](docs/ARCHITECTURE.md)** - Technical architecture and database schema
+- [Task Overview](docs/TASK_OVERVIEW.md) - Lifecycle, status transitions
+- [Task Actions](docs/TASK_ACTIONS.md) - All actions with examples
+- [Task Dependencies](docs/TASK_DEPENDENCIES.md) - Blocking relationships
+- [Task Linking](docs/TASK_LINKING.md) - Link to decisions/constraints/files
+- [Task Migration](docs/TASK_MIGRATION.md) - Migrate from decision-based tracking
+
+**Advanced Features:**
+- [Decision Context](docs/DECISION_CONTEXT.md) - Rich decision documentation
+- [Auto File Tracking](docs/AUTO_FILE_TRACKING.md) - Zero-token task management
+- [Acceptance Criteria](docs/ACCEPTANCE_CRITERIA.md) - All check types
+
+**Reference:**
+- [Shared Concepts](docs/SHARED_CONCEPTS.md) - Layer definitions, enum values
+- [Configuration](docs/CONFIGURATION.md) - Config file setup, all options
+- [Architecture](docs/ARCHITECTURE.md) - Technical architecture
 
 ### For Developers
 
-- **[Configuration Guide](docs/CONFIGURATION.md)** - TOML config file setup and options
-- **[Building from Source](docs/ARCHITECTURE.md#development)** - Setup and build instructions
-- **[Migration Guides](docs/MIGRATION_v2.md)** - Version upgrade guides
-- **[CLI Tool](docs/AI_AGENT_GUIDE.md#cli-usage)** - Query database from terminal
+- [Configuration Guide](docs/CONFIGURATION.md) - TOML config file setup
+- [Building from Source](docs/ARCHITECTURE.md#development) - Setup instructions
+- [Migration Guides](docs/MIGRATION_v2.md) - Version upgrade guides
 
-## Examples
+## Use Cases
 
-### Multi-Agent Coordination
+- **Multi-Agent Coordination**: Orchestrators create tasks, agents send status updates
+- **Breaking Change Management**: Record deprecations and add architectural constraints
+- **Decision Context**: Document rationale, alternatives considered, and trade-offs
+- **Session Continuity**: Save progress in Session 1, resume in Session 2
 
-```javascript
-// Orchestrator creates tasks
-{
-  action: "batch_create",
-  tasks: [
-    {title: "Setup database", assigned_agent: "db-agent"},
-    {title: "Create API", assigned_agent: "api-agent"}
-  ]
-}
-
-// Agents send status updates
-{
-  action: "send",
-  from_agent: "db-agent",
-  to_agent: "orchestrator",
-  message: "Database ready",
-  priority: "high"
-}
-```
-
-### Breaking Change Management
-
-```javascript
-// Record deprecation
-{
-  action: "set",
-  key: "api_v1_deprecated",
-  value: "/v1 endpoints deprecated, use /v2",
-  tags: ["breaking-change", "api"]
-}
-
-// Add constraint
-{
-  action: "add",
-  category: "architecture",
-  constraint_text: "All endpoints must use /v2 prefix",
-  priority: "high"
-}
-```
-
-### Decision Context (v3.2.2)
-
-```javascript
-// Record a decision with rich context
-{
-  action: "set",
-  key: "database_choice",
-  value: "PostgreSQL over MongoDB",
-  layer: "data",
-  tags: ["architecture", "database"]
-}
-
-// Add rationale and tradeoffs
-{
-  action: "add_decision_context",
-  key: "database_choice",
-  rationale: "Selected PostgreSQL because: (1) Complex relational queries required for reporting, (2) ACID compliance critical for financial data, (3) Team has strong SQL expertise",
-  alternatives_considered: [
-    {
-      option: "MongoDB",
-      reason: "Rejected due to weak consistency guarantees for financial data"
-    },
-    {
-      option: "MySQL",
-      reason: "Rejected due to limited JSON support needed for metadata"
-    }
-  ],
-  tradeoffs: {
-    pros: ["Strong consistency", "Complex queries", "Team expertise"],
-    cons: ["Less flexible schema", "Vertical scaling limitations"]
-  }
-}
-
-// Retrieve decision with full context
-{
-  action: "get",
-  key: "database_choice",
-  include_context: true
-}
-// → Returns decision + rationale + alternatives + tradeoffs
-```
-
-### Session Continuity
-
-```javascript
-// Session 1: Save state
-{
-  action: "set",
-  key: "refactor_progress",
-  value: "Completed 3/5 modules",
-  tags: ["session-state"]
-}
-
-// Session 2: Resume work
-{
-  action: "get",
-  key: "refactor_progress"
-}
-// → Returns: "Completed 3/5 modules"
-```
+See [docs/WORKFLOWS.md](docs/WORKFLOWS.md) for detailed multi-step examples.
 
 ## Performance
 
@@ -389,20 +178,9 @@ Each tool supports `action: "help"` for full documentation and `action: "example
 - **Storage efficiency**: ~140 bytes per decision
 - **Token savings**: 60-75% in typical projects
 
-## 💖 Support sqlew
-
-### One-time Support
-Perfect for trying out sponsorship!
-- ☕ $5 - Buy me a coffee
-- 🍕 $10 - Buy me a pizza
-
-### Monthly Support
-For ongoing development support:
-- ⭐ $1/month - Support Continual Development
-- 🚀 $5/month - Active support for Request
-- 💼 $10/month - Buy me more AI tokens
+## Support
 
-on [GitHub Sponsors](https://github.com/sponsors/sin5ddd)
+Support development via [GitHub Sponsors](https://github.com/sponsors/sin5ddd) - One-time or monthly options available.
 
 ## Version
 
@@ -411,19 +189,7 @@ See [CHANGELOG.md](CHANGELOG.md) for release history.
 
 ## License
 
-AGPLv3 - **Free to use**, open-source required when embedding/modifying.
-
-See [LICENSE](LICENSE) file for details.
-
-**Free to use for:**
-- Personal and commercial projects
-- Using sqlew as-is in Claude Desktop
-- Managing AI agent context
-
-**Open-source required when:**
-- Embedding sqlew into your application
-- Modifying and distributing sqlew
-- Offering sqlew as a network service
+AGPLv3 - Free to use. Open-source required when embedding or modifying. See [LICENSE](LICENSE) for details.
 
 ## Links
 
@@ -431,10 +197,10 @@ See [LICENSE](LICENSE) file for details.
 - [GitHub repository](https://github.com/sin5ddd/mcp-sqlew)
 - [Model Context Protocol](https://modelcontextprotocol.io/)
 
-## Support
+## Support & Documentation
 
-- **Issues**: [GitHub Issues](https://github.com/sin5ddd/mcp-sqlew/issues)
-- **Documentation**: [docs/](docs/) directory
+- Issues: [GitHub Issues](https://github.com/sin5ddd/mcp-sqlew/issues)
+- Docs: [docs/](docs/) directory
 
 ## Acknowledgments
 

package/assets/config.example.toml

@@ -0,0 +1,97 @@
+# 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]
+# Database file path (relative to project root or absolute)
+# Default: ".sqlew/sqlew.db"
+# path = ".sqlew/custom.db"
+# path = "/absolute/path/to/database.db"
+
+# ============================================================================
+# 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"
+
+# ============================================================================
+# 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
+
+# ============================================================================
+# Example Configurations
+# ============================================================================
+
+# 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

package/dist/adapters/index.d.ts

@@ -0,0 +1,11 @@
+export type { DatabaseAdapter } from './types.js';
+import { SQLiteAdapter } from './sqlite-adapter.js';
+import { PostgreSQLAdapter } from './postgresql-adapter.js';
+import { MySQLAdapter } from './mysql-adapter.js';
+import type { DatabaseAdapter } from './types.js';
+export { SQLiteAdapter, PostgreSQLAdapter, MySQLAdapter };
+/**
+ * Factory function to create database adapter
+ */
+export declare function createDatabaseAdapter(databaseType: 'sqlite' | 'postgresql' | 'mysql'): DatabaseAdapter;
+//# sourceMappingURL=index.d.ts.map

package/dist/adapters/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/adapters/index.ts"],"names":[],"mappings":"AAEA,YAAY,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAGlD,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAC5D,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAElD,OAAO,EAAE,aAAa,EAAE,iBAAiB,EAAE,YAAY,EAAE,CAAC;AAE1D;;GAEG;AACH,wBAAgB,qBAAqB,CACnC,YAAY,EAAE,QAAQ,GAAG,YAAY,GAAG,OAAO,GAC9C,eAAe,CAWjB"}

package/dist/adapters/index.js

@@ -0,0 +1,21 @@
+// Import adapter implementations
+import { SQLiteAdapter } from './sqlite-adapter.js';
+import { PostgreSQLAdapter } from './postgresql-adapter.js';
+import { MySQLAdapter } from './mysql-adapter.js';
+export { SQLiteAdapter, PostgreSQLAdapter, MySQLAdapter };
+/**
+ * Factory function to create database adapter
+ */
+export function createDatabaseAdapter(databaseType) {
+    switch (databaseType) {
+        case 'sqlite':
+            return new SQLiteAdapter();
+        case 'postgresql':
+            return new PostgreSQLAdapter();
+        case 'mysql':
+            return new MySQLAdapter();
+        default:
+            throw new Error(`Unsupported database type: ${databaseType}`);
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/adapters/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/adapters/index.ts"],"names":[],"mappings":"AAIA,iCAAiC;AACjC,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAC5D,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAGlD,OAAO,EAAE,aAAa,EAAE,iBAAiB,EAAE,YAAY,EAAE,CAAC;AAE1D;;GAEG;AACH,MAAM,UAAU,qBAAqB,CACnC,YAA+C;IAE/C,QAAQ,YAAY,EAAE,CAAC;QACrB,KAAK,QAAQ;YACX,OAAO,IAAI,aAAa,EAAE,CAAC;QAC7B,KAAK,YAAY;YACf,OAAO,IAAI,iBAAiB,EAAE,CAAC;QACjC,KAAK,OAAO;YACV,OAAO,IAAI,YAAY,EAAE,CAAC;QAC5B;YACE,MAAM,IAAI,KAAK,CAAC,8BAA8B,YAAY,EAAE,CAAC,CAAC;IAClE,CAAC;AACH,CAAC"}

package/dist/adapters/mysql-adapter.d.ts

@@ -0,0 +1,31 @@
+import type { Knex } from 'knex';
+import type { DatabaseAdapter } from './types.js';
+export declare class MySQLAdapter implements DatabaseAdapter {
+    private knexInstance;
+    readonly supportsReturning = false;
+    readonly supportsJSON = true;
+    readonly supportsUpsert = true;
+    readonly supportsCTE = true;
+    readonly supportsWindowFunctions = true;
+    readonly supportsSavepoints = true;
+    readonly databaseName: "mysql";
+    connect(config: Knex.Config): Promise<Knex>;
+    disconnect(): Promise<void>;
+    getKnex(): Knex;
+    insertReturning<T extends Record<string, any>>(table: string, data: Partial<T>): Promise<T>;
+    upsert<T extends Record<string, any>>(table: string, data: Partial<T>, conflictColumns: string[], updateColumns?: string[]): Promise<number>;
+    jsonExtract(column: string, path: string): Knex.Raw;
+    jsonBuildObject(fields: Record<string, any>): Knex.Raw;
+    currentTimestamp(): Knex.Raw;
+    fromUnixEpoch(epochColumn: string): Knex.Raw;
+    toUnixEpoch(timestampColumn: string): Knex.Raw;
+    concat(...values: Array<string | Knex.Raw>): Knex.Raw;
+    stringAgg(column: string, separator?: string): Knex.Raw;
+    transaction<T>(callback: (trx: Knex.Transaction) => Promise<T>, options?: {
+        isolationLevel?: 'serializable' | 'read committed' | 'repeatable read';
+    }): Promise<T>;
+    savepoint<T>(trx: Knex.Transaction, callback: (sp: Knex.Transaction) => Promise<T>): Promise<T>;
+    tableExists(tableName: string): Promise<boolean>;
+    autoIncrementColumn(table: Knex.CreateTableBuilder, columnName?: string): void;
+}
+//# sourceMappingURL=mysql-adapter.d.ts.map

package/dist/adapters/mysql-adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mysql-adapter.d.ts","sourceRoot":"","sources":["../../src/adapters/mysql-adapter.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AACjC,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAIlD,qBAAa,YAAa,YAAW,eAAe;IAClD,OAAO,CAAC,YAAY,CAAqB;IAGzC,QAAQ,CAAC,iBAAiB,SAAS;IACnC,QAAQ,CAAC,YAAY,QAAQ;IAC7B,QAAQ,CAAC,cAAc,QAAQ;IAC/B,QAAQ,CAAC,WAAW,QAAQ;IAC5B,QAAQ,CAAC,uBAAuB,QAAQ;IACxC,QAAQ,CAAC,kBAAkB,QAAQ;IACnC,QAAQ,CAAC,YAAY,EAAG,OAAO,CAAU;IAEnC,OAAO,CAAC,MAAM,EAAE,IAAI,CAAC,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAI3C,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAIjC,OAAO,IAAI,IAAI;IAIT,eAAe,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EACjD,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC,GACf,OAAO,CAAC,CAAC,CAAC;IAIP,MAAM,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EACxC,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC,EAChB,eAAe,EAAE,MAAM,EAAE,EACzB,aAAa,CAAC,EAAE,MAAM,EAAE,GACvB,OAAO,CAAC,MAAM,CAAC;IAIlB,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC,GAAG;IAInD,eAAe,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,IAAI,CAAC,GAAG;IAItD,gBAAgB,IAAI,IAAI,CAAC,GAAG;IAI5B,aAAa,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC,GAAG;IAI5C,WAAW,CAAC,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC,GAAG;IAI9C,MAAM,CAAC,GAAG,MAAM,EAAE,KAAK,CAAC,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,GAAG;IAIrD,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC,GAAG;IAIjD,WAAW,CAAC,CAAC,EACjB,QAAQ,EAAE,CAAC,GAAG,EAAE,IAAI,CAAC,WAAW,KAAK,OAAO,CAAC,CAAC,CAAC,EAC/C,OAAO,CAAC,EAAE;QAAE,cAAc,CAAC,EAAE,cAAc,GAAG,gBAAgB,GAAG,iBAAiB,CAAA;KAAE,GACnF,OAAO,CAAC,CAAC,CAAC;IAIP,SAAS,CAAC,CAAC,EACf,GAAG,EAAE,IAAI,CAAC,WAAW,EACrB,QAAQ,EAAE,CAAC,EAAE,EAAE,IAAI,CAAC,WAAW,KAAK,OAAO,CAAC,CAAC,CAAC,GAC7C,OAAO,CAAC,CAAC,CAAC;IAIP,WAAW,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAItD,mBAAmB,CAAC,KAAK,EAAE,IAAI,CAAC,kBAAkB,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI;CAG/E"}