sqlew 4.0.3 → 4.0.5

package/README.md

@@ -2,91 +2,165 @@
 ![sqlew_logo](assets/sqlew-logo.png)
 
 [![npm version](https://img.shields.io/npm/v/sqlew.svg)](https://www.npmjs.com/package/sqlew)
-[![License: AGPL v3](https://img.shields.io/badge/License-AGPL%20v3-blue.svg)](https://www.gnu.org/licenses/agpl-3.0)
+[![License](https://img.shields.io/badge/License-Apache_2.0-blue.svg)](https://opensource.org/licenses/Apache-2.0)
 
-> **Never Start From Zero Context Again** – An MCP server that gives AI agents a shared SQL-backed context repository
+> **ADR (Architecture Decision Record) for AI Agents** – An MCP server that enables AI agents to create, query, and maintain architecture decision records in a structured SQL database
+
+## 🚀 Quick Start: /sqlew Command
+
+**The `/sqlew` command is the easiest way to use sqlew!** Just type `/sqlew` in Claude Code with natural language input.
+
+### Most Common Uses
+
+```bash
+# Show status and get suggestions
+/sqlew
+
+# Record a decision
+/sqlew record we use PostgreSQL 15 for production database
+
+# Search past decisions
+/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
+```
+
+The `/sqlew` command automatically detects your intent (search, record, list, execute, task creation) and invokes the appropriate MCP tools.
+
+---
 
 ## What is sqlew?
 
-**sqlew** is a Model Context Protocol (MCP) server that provides AI agents with a shared SQL-backed context repository across sessions.
+**sqlew** is a Model Context Protocol (MCP) server that brings ADR (Architecture Decision Record) capabilities to AI agents through a shared SQL-backed repository.
 
-### Concerns About AI Coding
-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.
+### The Problem: AI Agents Lack Decision Memory
+Every AI session starts with zero context. Agents must re-learn architectural decisions, can reintroduce previously rejected patterns, and have no systematic way to understand WHY past choices were made.
 
-It is possible to keep records using Markdown files.
-However, maintaining records for large-scale projects and long-term maintenance generates an enormous volume of documentation.
+Traditional ADR approaches use Markdown files scattered across repositories. While human-readable, this format creates challenges for AI agents:
+- **No structured querying** – AI must read entire files to find relevant decisions
+- **Context explosion** – Token costs grow linearly with decision history
+- **No duplicate detection** – AI cannot easily identify similar or conflicting decisions
+- **Poor discoverability** – Finding related decisions requires full-text search across many files
 
-This has become problematic because it causes context rotting in AI systems, leading to performance deterioration.
+### *sqlew* brings structured ADR to AI agents
+sqlew transforms ADR from static documentation into a **queryable, AI-native decision database**:
 
-### *sqlew* provides the solution for this problem
-sqlew builds an efficient external context repository for AI by using relational databases.
-- Records the reasoning behind decisions
-- Enables querying past context
-- Prevents anti-patterns through constraints
-- Eliminates duplicate work via task management
+- **Structured records** – Decisions stored as relational data with metadata, tags, and relationships
+- **Efficient querying** – AI agents retrieve only relevant decisions via SQL queries
+- **Smart suggestions** – Three-tier similarity system detects duplicate or related decisions
+- **Constraint tracking** – Architectural rules and principles as first-class entities
+- **Task integration** – Link decisions to implementation tasks and affected files
 
 > *This software does not send any data to external networks. We NEVER collect any data or usage statistics. Please use it with complete security.*
 
-## Concept: Decision & Constraint Repository Layer
+## Concept: ADR (Architecture Decision Record) for AI Agents
 
-sqlew originally started as a way to reduce duplicated work and inconsistent behavior across multiple AI agents. Instead of letting every new session re-read the same documents and reinvent similar code, sqlew centralizes context in a shared SQL database.
+**Architecture Decision Records (ADR)** document the architectural decisions made on a project, including context, consequences, and alternatives considered. sqlew extends this proven pattern to AI agents.
 
-With recent LLMs, the most valuable part of this shared context has proved to be the **history of Decisions and Constraints**:
+### Core ADR Concepts in sqlew
 
-- **Decisions** capture *why* a change or design choice was made (trade-offs, rejected options, rationale).
-- **Constraints** capture *how* things should be done (coding rules, architecture boundaries, performance requirements).
+**Decisions** capture architectural choices with full context:
+- **What** was decided (the decision itself)
+- **Why** it was chosen (rationale, trade-offs)
+- **What else** was considered (alternatives rejected)
+- **Impact** on the system (consequences, affected components)
 
-Modern versions of sqlew treat this decision & constraint history as **first-class data**:
+**Constraints** define architectural principles and rules:
+- **Performance requirements** (response time limits, throughput goals)
+- **Technology choices** ("must use PostgreSQL", "avoid microservices")
+- **Coding standards** ("async/await only", "no any types")
+- **Security policies** (authentication patterns, data handling rules)
 
-- The database schema is optimized around Decisions and Constraints instead of generic notes.
-- A three-tier **duplicate detection and suggestion system** helps you reuse existing Decisions/Constraints instead of creating nearly identical ones.
-- Legacy, unused features have been removed or simplified to keep the focus on long-term context and consistency.
+**Implementation tracking** connects decisions to reality:
+- **Tasks** link decisions to actual implementation work
+- **File tracking** shows which code was affected by decisions
+- **Status evolution** tracks decision lifecycle (draft → active → deprecated)
 
-In practice, sqlew acts as a **Decision & Constraint repository layer** for your AI tools: agents can query what was decided before, which rules already exist, and how similar situations were handled previously.
+### Why SQL for ADR?
 
-## Why Use sqlew?
+Traditional text-based ADR forces AI to:
+- Read complete files even for simple queries
+- Parse unstructured text to find relationships
+- Manually detect duplicate or conflicting decisions
 
-### 🧠 Organizational Memory
-Traditional code analysis like git tells you **WHAT** is done, sqlew adds **WHY** and **HOW** on it:
-- **Decisions** → WHY it was changed
-- **Constraints** → HOW should it be written
-- **Tasks** → WHAT needs to be done
+sqlew's **SQL-backed ADR repository** enables AI to:
+- Query by layer, tags, status in milliseconds (2-50ms)
+- Join decisions with constraints, tasks, and files
+- Leverage similarity algorithms to prevent duplicates
+- Scale to thousands of decisions without context explosion
 
-### ⚡ Token Efficiency
-**60-75% token reduction** in multi-session projects through structured data storage and selective querying.
+**Token efficiency**: 60-75% reduction compared to reading Markdown ADRs
 
-### 🎯 Key Benefits for Your Development Workflow
+### Why RDBMS + MCP for ADR?
 
-#### 🧠 **Context Persistence Across Sessions**
-- **No More Re-Explaining**: AI remembers decisions from weeks ago - no need to re-explain "why we chose PostgreSQL over MongoDB"
-- **Session Continuity**: Pick up exactly where you left off, even after days or weeks
-- **Team Knowledge Sharing**: New team members (or new AI sessions) instantly understand past decisions
+**RDBMS (Relational Database)** provides efficient structured queries:
+- **Indexed searches** – Find decisions by tags/layers in milliseconds, not seconds
+- **JOIN operations** – Query related decisions, constraints, and tasks in a single operation
+- **Transaction support** – ACID guarantees ensure data integrity across concurrent AI agents
+- **Scalability** – Handle thousands of ADRs without performance degradation
 
-#### 🛡️ **Prevents Context Rotting & Inconsistency**
-- **Architectural Constraints**: Define rules once ("always use async/await, never callbacks"), AI follows them forever
-- **Version History**: Track how decisions evolved - see what changed and when
+**MCP (Model Context Protocol)** enables seamless AI integration:
+- **Direct tool access** – AI agents call ADR operations as native functions
+- **Token efficiency** – Retrieve only required data, avoiding full-file reads
+- **Type safety** – Structured parameters prevent errors and guide correct usage
+- **Cross-session persistence** – ADRs survive beyond individual chat sessions
 
-#### 🎯 **Enables Consistent, High-Quality Code**
-- **Bug Prevention**: AI won't reintroduce bugs you already fixed (decisions document "what didn't work")
-- **Pattern Enforcement**: Constraints ensure AI writes code matching your team's style
-- **Context-Aware Suggestions**: AI sees related decisions before creating new ones ("Did you know we already solved this?")
-- **Rationale Documentation**: Every decision includes WHY it was made, preventing cargo-cult programming
+**Together**: AI agents gain SQL-powered ADR capabilities without managing databases directly.
 
-#### 📊 **Transparent AI Work Tracking**
-- **Task Dependencies**: AI knows Task B needs Task A completed first
-- **Auto File Watching**: Tasks auto-update when AI edits tracked files (zero manual updates)
-- **Progress Visibility**: See exactly what AI is working on, what's blocked, what's done
+## Why Use sqlew?
 
-#### ⚡ **Efficiency & Reliability**
-- **60-75% Token Reduction**: Structured data beats dumping entire context into prompts
-- **Reduce Context Rot**: No more "this README is 50 pages and AI ignores half of it"
-- **Production-Ready**: 495/495 tests passing (100%), battle-tested on real projects
+### 🏛️ ADR Made AI-Native
+Traditional ADR approaches weren't designed for AI agents. sqlew reimagines ADR for the AI era:
+
+| Traditional ADR (Markdown) | sqlew ADR (SQL) |
+|---------------------------|-----------------|
+| Read entire files | Query specific decisions |
+| Manual duplicate checking | Automatic similarity detection |
+| Text parsing required | Structured, typed data |
+| Linear token scaling | Constant-time lookups |
+| File-based organization | Relational queries with JOINs |
+
+### 🎯 Key Benefits for AI-Driven Development
+
+#### 📚 **Persistent Architectural Memory**
+- **Zero context loss** – AI agents remember every architectural decision across sessions
+- **Rationale preservation** – Never forget WHY a decision was made, not just WHAT
+- **Alternative tracking** – Document rejected options to prevent circular debates
+- **Evolution history** – See how decisions changed over time with full version history
+
+#### 🛡️ **Prevent Architectural Drift**
+- **Constraint enforcement** – Define architectural rules once, AI follows them forever
+- **Pattern consistency** – AI generates code matching established patterns automatically
+- **Anti-pattern prevention** – Document "what NOT to do" as enforceable constraints
+- **Regression prevention** – AI won't reintroduce previously rejected approaches
+
+#### 🔍 **Intelligent Decision Discovery**
+- **Similarity detection** – AI identifies duplicate or related decisions before creating new ones
+- **Context-aware search** – Query by layer, tags, or relationships to find relevant decisions
+- **Impact analysis** – Trace which files and tasks are affected by each decision
+- **Conflict detection** – Find decisions that contradict or supersede each other
+
+#### 📊 **Implementation Transparency**
+- **Decision-to-task linking** – Track implementation status of architectural choices
+- **File impact tracking** – See exactly which code implements each decision
+- **Status lifecycle** – Draft → Active → Deprecated → Superseded transitions
+- **Progress visibility** – Monitor which ADRs are implemented, which are pending
+
+#### ⚡ **Extreme Efficiency**
+- **60-75% token reduction** – Query only relevant decisions instead of reading all ADRs
+- **Millisecond queries** – 2-50ms response times even with thousands of decisions
+- **Scalable architecture** – Perform well with large decision histories
+- **Production-ready** – 495/495 tests passing (100%), battle-tested on real projects
 
 ---
 
-**Technical Features**: 6 specialized MCP tools (decisions, tasks, files, constraints, stats, suggest), smart similarity scoring (0-100 point algorithm), runtime reconnection, parameter validation, metadata-driven organization
+**Technical Features**: 8 MCP tools (5 core: decision, constraint, task, file, suggest + 3 utility: help, example, use_case), three-tier similarity detection (0-100 point scoring), ACID transaction support, multi-database backend (SQLite/PostgreSQL/MySQL), metadata-driven organization with layers and tags
 
-See [docs/TASK_OVERVIEW.md](docs/TASK_OVERVIEW.md) and [docs/DECISION_CONTEXT.md](docs/DECISION_CONTEXT.md) for details.
+See [docs/DECISION_CONTEXT.md](docs/DECISION_CONTEXT.md) for ADR data model details.
 
 ### 🔖Kanban-style AI Scrum
 ![kanban-style task management](assets/kanban-visualizer.png)
@@ -119,33 +193,6 @@ The first time, sqlew initializes database, installs custom agents and slash com
 
 It's Ready!
 
-## 🚀 Quick Start: /sqlew Command
-
-**The `/sqlew` command is the easiest way to use sqlew!** Just type `/sqlew` in Claude Code with natural language input.
-
-### Most Common Uses
-
-```bash
-# Show status and get suggestions
-/sqlew
-
-# Record a decision
-/sqlew record we use PostgreSQL 15 for production database
-
-# Search past decisions
-/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
-```
-
-The `/sqlew` command automatically detects your intent (search, record, list, execute, task creation) and invokes the appropriate MCP tools.
-
----
-
 **⚠️Note**: Global install (`npm install -g`) is **not recommended** because sqlew requires an independent settings per project. Each project should maintain its own context database in `.sqlew/sqlew.db`.
 
 **Custom database path:** Add path as argument: `"args": ["sqlew", "/path/to/db.db"]`
@@ -275,14 +322,23 @@ Power users can still call MCP tools directly. See [Available Tools](#available-
 
 ### Available Tools
 
+#### Core ADR Tools
+
 | Tool | Purpose | Example Use |
 |------|---------|------------|
-| **decision** | Record choices and reasons | "We chose PostgreSQL" |
-| **constraint** | Define rules | "DO NOT use raw SQL, use ORM" |
-| **task** | Track work | "Implement feature X" |
-| **file** | Track changes | "Modified auth.ts" |
-| **stats** | Database metrics | Get layer summary |
-| **suggest** | Find similar decisions (v3.9.0) | Duplicate detection, pattern search |
+| **decision** | Record architectural decisions with context | "We chose PostgreSQL over MongoDB (ACID requirement)" |
+| **constraint** | Define architectural rules and principles | "All API endpoints must use /v2/ prefix" |
+| **task** | Track implementation of decisions | "Implement JWT authentication" |
+| **file** | Track code changes linked to decisions | "Modified auth.ts per security ADR" |
+| **suggest** | Find similar decisions, prevent duplicates | Duplicate detection, similarity search |
+
+#### Utility Tools
+
+| Tool | Purpose | Example Use |
+|------|---------|------------|
+| **help** | Query action documentation and parameters | Get decision.set parameters |
+| **example** | Browse code examples by tool/action | Find task.create examples |
+| **use_case** | Complete workflow scenarios | Multi-step ADR workflows |
 
 
 ## Documentation
@@ -333,10 +389,32 @@ All tools support:
 
 ## Use Cases
 
-- **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
+### ADR-Driven Development with AI
+- **Architecture Evolution** – Document major architectural decisions with full context and alternatives
+- **Pattern Standardization** – Establish coding patterns as constraints, enforce via AI code generation
+- **Technical Debt Tracking** – Record temporary decisions with deprecation paths and future plans
+- **Onboarding Acceleration** – New AI sessions instantly understand architectural history
+
+### Cross-Session AI Workflows
+- **Multi-Session Projects** – AI maintains context across days/weeks without re-reading documentation
+- **Multi-Agent Coordination** – Multiple AI agents share architectural understanding through ADR database
+- **Breaking Change Management** – Document API changes, deprecations, and migration paths systematically
+- **Refactoring Guidance** – AI references past decisions to maintain architectural consistency during refactors
+
+### Real-World Examples
+```bash
+# Document an architectural decision with alternatives
+/sqlew record we use PostgreSQL over MongoDB. MongoDB was rejected due to lack of ACID transactions for our financial data requirements.
+
+# Search for past decisions before making new ones
+/sqlew search why did we choose JWT authentication
+
+# Create constraint to guide AI code generation
+/sqlew add constraint all API endpoints must use /v2/ prefix for versioning
+
+# Plan implementation of a decision
+/sqlew plan implementing the PostgreSQL connection pool with pgBouncer
+```
 
 See [docs/WORKFLOWS.md](docs/WORKFLOWS.md) for detailed multi-step examples.
 
@@ -370,7 +448,7 @@ See [docs/DECISION_INTELLIGENCE.md](docs/DECISION_INTELLIGENCE.md) for details o
 
 ## License
 
-AGPLv3 - Free to use. Open-source required when embedding or modifying. See [LICENSE](LICENSE) for details.
+Apache License 2.0 - Free for commercial and personal use. See [LICENSE](LICENSE) for details.
 
 ## Links
 

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

@@ -2,11 +2,11 @@
 
 When `<system-reminder>Plan mode is active</system-reminder>` appears:
 
-### Phase 1 (Research) - Check existing context:
+### Research Phase - 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:
+### Final Plan Phase - Record outcomes:
 - `mcp__sqlew__decision action="set"` - record key architectural decisions
 - `mcp__sqlew__task action="create_batch"` - create implementation tasks
 

package/assets/config.example.toml

@@ -190,6 +190,22 @@ architect = true
 # NOTE: Documentation is centralized in docs/SPECIALIZED_AGENTS.md
 # See: https://github.com/sin5ddd/mcp-sqlew/blob/main/docs/SPECIALIZED_AGENTS.md
 
+# ============================================================================
+# 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
 # ============================================================================

package/assets/sample-agents/sqlew-architect.md

@@ -3,6 +3,7 @@ name: sqlew-architect
 description: Use this agent when you need to document architectural decisions, enforce design constraints, maintain technical standards, and ensure long-term system integrity. Specialized in creating decision records with comprehensive rationale, establishing constraints, and validating architectural compliance. This agent is your guardian of design quality and consistency.
 model: opus
 color: green
+skills: sqlew-plan-guidance
 Examples:
 
 <example>

package/assets/sample-agents/sqlew-researcher.md

@@ -3,6 +3,7 @@ name: sqlew-researcher
 description: Use this agent when you need to query, analyze, and extract insights from sqlew's context database. Specialized in searching decisions, reviewing constraints, analyzing task patterns, and investigating historical context. This agent is your go-to for understanding "what was decided and why" across the project lifecycle.
 model: haiku
 color: blue
+skills: sqlew-plan-guidance
 Examples:
 
 <example>

package/assets/sample-agents/sqlew-scrum-master.md

@@ -3,6 +3,7 @@ name: scrum-master
 description: Use this agent when you need to coordinate multi-agent development work, manage agile workflows, track tasks and dependencies using sqlew, or facilitate sprint planning and execution. This agent should proactively monitor project progress and ensure efficient collaboration between sub-agents.
 model: sonnet
 color: purple
+skills: sqlew-plan-guidance
 Examples:
 
 <example>

package/dist/config/minimal-generator.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"minimal-generator.d.ts","sourceRoot":"","sources":["../../src/config/minimal-generator.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAKH;;;;GAIG;AACH,wBAAgB,qBAAqB,IAAI,MAAM,CA6F9C;AAED;;;;;GAKG;AACH,wBAAgB,8BAA8B,CAAC,WAAW,GAAE,MAAsB,GAAG,OAAO,CAmB3F;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,WAAW,GAAE,MAAsB,GAAG,MAAM,CAEzE"}
+{"version":3,"file":"minimal-generator.d.ts","sourceRoot":"","sources":["../../src/config/minimal-generator.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAKH;;;;GAIG;AACH,wBAAgB,qBAAqB,IAAI,MAAM,CA0E9C;AAED;;;;;GAKG;AACH,wBAAgB,8BAA8B,CAAC,WAAW,GAAE,MAAsB,GAAG,OAAO,CAmB3F;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,WAAW,GAAE,MAAsB,GAAG,MAAM,CAEzE"}

package/dist/config/minimal-generator.js

@@ -10,97 +10,78 @@ import { join, dirname } from 'path';
  * @returns TOML content string
  */
 export function generateMinimalConfig() {
-    return `# sqlew Minimal Configuration
-# Generated automatically - edit as needed
-# Full example: .sqlew/config.example.toml
-# Documentation: https://github.com/sin5ddd/mcp-sqlew
-
-# ============================================================================
-# Specialized Agents Settings
-# ============================================================================
-[agents]
-# Which specialized agents to install when running: npx sqlew-init-agents
-# Set to false to skip agents you don't need (reduces token consumption)
-
-# Scrum Master: Multi-agent coordination, task management, sprint planning
-# Token cost: ~12KB per conversation when loaded in Claude Code
-scrum_master = true
-
-# Researcher: Query decisions, analyze patterns, investigate context
-# Token cost: ~14KB per conversation when loaded in Claude Code
-researcher = true
-
-# Architect: Document decisions, enforce constraints, maintain standards
-# Token cost: ~20KB per conversation when loaded in Claude Code
-architect = true
-
-# Example: Minimal installation (only Scrum Master for task management)
-# [agents]
-# scrum_master = true
-# researcher = 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
-
-# /sqw-documentor: Document architectural decisions with context
-documentor = true
-
-# /sqw-secretary: Record decisions (like meeting minutes)
-secretary = true
-
-# /sqw-plan: Planning workflow (architecture + tasks)
-plan = true
-
-# /sqw-research: Search and analyze decision/task history
-research = true
-
-# /sqw-review: Validate architectural consistency
-review = true
-
-# /sqw-scrum: Task management + agent coordination
-scrum = true
-
-# Example: Minimal installation (only core workflows)
-# [commands]
-# plan = true
-# secretary = true
-# research = false
-# review = false
-# documentor = false
-# scrum = false
-
-# ============================================================================
-# Other Settings (Optional - uncomment to customize)
-# ============================================================================
-
-# [autodelete]
-# # Skip weekends when calculating retention periods
-# ignore_weekend = false
-# # Message retention period in hours
-# message_hours = 24
-# # File change history retention in days
-# file_history_days = 7
-
-# [tasks]
-# # Auto-archive done tasks after N days
-# auto_archive_done_days = 2
-# # Stale detection threshold for in_progress tasks (hours)
-# stale_hours_in_progress = 2
-# # Stale detection threshold for waiting_review tasks (hours)
-# stale_hours_waiting_review = 24
-# # Enable automatic stale detection
-# auto_stale_enabled = true
-
-# [debug]
-# # Debug log file path (optional)
-# # log_path = ".sqlew/debug.log"
-# # Log level: "error", "warn", "info", "debug"
-# # log_level = "info"
+    return `# sqlew Minimal Configuration
+# Generated automatically - edit as needed
+# Full example: .sqlew/config.example.toml
+# Documentation: https://github.com/sin5ddd/mcp-sqlew
+
+# ============================================================================
+# Specialized Agents Settings
+# ============================================================================
+[agents]
+# Which specialized agents to install when running: npx sqlew-init-agents
+# Set to false to skip agents you don't need (reduces token consumption)
+
+# Scrum Master: Multi-agent coordination, task management, sprint planning
+# Token cost: ~12KB per conversation when loaded in Claude Code
+scrum_master = true
+
+# Researcher: Query decisions, analyze patterns, investigate context
+# Token cost: ~14KB per conversation when loaded in Claude Code
+researcher = true
+
+# Architect: Document decisions, enforce constraints, maintain standards
+# Token cost: ~20KB per conversation when loaded in Claude Code
+architect = true
+
+# Example: Minimal installation (only Scrum Master for task management)
+# [agents]
+# scrum_master = true
+# researcher = 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
+sqlew = true
+
+# ============================================================================
+# Other Settings (Optional - uncomment to customize)
+# ============================================================================
+
+# [autodelete]
+# # Skip weekends when calculating retention periods
+# ignore_weekend = false
+# # Message retention period in hours
+# message_hours = 24
+# # File change history retention in days
+# file_history_days = 7
+
+# [tasks]
+# # Auto-archive done tasks after N days
+# auto_archive_done_days = 2
+# # Stale detection threshold for in_progress tasks (hours)
+# stale_hours_in_progress = 2
+# # Stale detection threshold for waiting_review tasks (hours)
+# stale_hours_waiting_review = 24
+# # Enable automatic stale detection
+# auto_stale_enabled = true
+
+# [debug]
+# # Debug log file path (optional)
+# # log_path = ".sqlew/debug.log"
+# # Log level: "error", "warn", "info", "debug"
+# # log_level = "info"
 `;
 }
 /**

package/dist/config/minimal-generator.js.map

@@ -1 +1 @@
-{"version":3,"file":"minimal-generator.js","sourceRoot":"","sources":["../../src/config/minimal-generator.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,IAAI,CAAC;AAC1D,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AAErC;;;;GAIG;AACH,MAAM,UAAU,qBAAqB;IACnC,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA2FR,CAAC;AACF,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,8BAA8B,CAAC,cAAsB,OAAO,CAAC,GAAG,EAAE;IAChF,MAAM,UAAU,GAAG,IAAI,CAAC,WAAW,EAAE,QAAQ,EAAE,aAAa,CAAC,CAAC;IAE9D,4CAA4C;IAC5C,IAAI,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;QAC3B,OAAO,KAAK,CAAC;IACf,CAAC;IAED,8CAA8C;IAC9C,MAAM,QAAQ,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;IACrC,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC1B,SAAS,CAAC,QAAQ,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC3C,CAAC;IAED,uBAAuB;IACvB,MAAM,OAAO,GAAG,qBAAqB,EAAE,CAAC;IACxC,aAAa,CAAC,UAAU,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;IAE5C,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,aAAa,CAAC,cAAsB,OAAO,CAAC,GAAG,EAAE;IAC/D,OAAO,IAAI,CAAC,WAAW,EAAE,QAAQ,EAAE,aAAa,CAAC,CAAC;AACpD,CAAC"}
+{"version":3,"file":"minimal-generator.js","sourceRoot":"","sources":["../../src/config/minimal-generator.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,IAAI,CAAC;AAC1D,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AAErC;;;;GAIG;AACH,MAAM,UAAU,qBAAqB;IACnC,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAwER,CAAC;AACF,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,8BAA8B,CAAC,cAAsB,OAAO,CAAC,GAAG,EAAE;IAChF,MAAM,UAAU,GAAG,IAAI,CAAC,WAAW,EAAE,QAAQ,EAAE,aAAa,CAAC,CAAC;IAE9D,4CAA4C;IAC5C,IAAI,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;QAC3B,OAAO,KAAK,CAAC;IACf,CAAC;IAED,8CAA8C;IAC9C,MAAM,QAAQ,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;IACrC,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC1B,SAAS,CAAC,QAAQ,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC3C,CAAC;IAED,uBAAuB;IACvB,MAAM,OAAO,GAAG,qBAAqB,EAAE,CAAC;IACxC,aAAa,CAAC,UAAU,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;IAE5C,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,aAAa,CAAC,cAAsB,OAAO,CAAC,GAAG,EAAE;IAC/D,OAAO,IAAI,CAAC,WAAW,EAAE,QAAQ,EAAE,aAAa,CAAC,CAAC;AACpD,CAAC"}

package/dist/config/types.d.ts

@@ -296,18 +296,8 @@ export interface AgentsConfig {
  * Slash commands configuration
  */
 export interface CommandsConfig {
-    /** Install /sqw-documentor command (document architectural decisions) */
-    documentor?: boolean;
-    /** Install /sqw-secretary command (record decisions like meeting minutes) */
-    secretary?: boolean;
-    /** Install /sqw-plan command (planning workflow) */
-    plan?: boolean;
-    /** Install /sqw-research command (research workflow) */
-    research?: boolean;
-    /** Install /sqw-review command (review workflow) */
-    review?: boolean;
-    /** Install /sqw-scrum command (task management + agent coordination) */
-    scrum?: boolean;
+    /** Install /sqlew command (unified natural language interface for decisions and tasks) */
+    sqlew?: boolean;
 }
 /**
  * Project configuration (v3.7.0+)

package/dist/config/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/config/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAMH;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,MAAM,WAAW,SAAS;IACxB;;;OAGG;IACH,EAAE,CAAC,EAAE,MAAM,CAAC;IAEZ;;;OAGG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd;;;OAGG;IACH,GAAG,CAAC,EAAE,MAAM,CAAC;IAEb;;;;;;OAMG;IACH,kBAAkB,CAAC,EAAE,OAAO,CAAC;CAC9B;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2CG;AACH,MAAM,WAAW,UAAU;IACzB;;;;;;OAMG;IACH,IAAI,EAAE,QAAQ,GAAG,SAAS,GAAG,SAAS,CAAC;IAEvC;;OAEG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB;;OAEG;IACH,GAAG,CAAC,EAAE,SAAS,CAAC;CACjB;AAED;;;;;;;;;;;;;;GAcG;AACH,MAAM,WAAW,gBAAgB;IAC/B;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb;;;;;OAKG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb;;;OAGG;IACH,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6DG;AACH,MAAM,WAAW,cAAc;IAC7B;;;OAGG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd;;;;;OAKG;IACH,IAAI,CAAC,EAAE,QAAQ,GAAG,UAAU,GAAG,OAAO,CAAC;IAEvC;;;;;OAKG;IACH,UAAU,CAAC,EAAE,gBAAgB,CAAC;IAE9B;;;;;OAKG;IACH,IAAI,CAAC,EAAE,UAAU,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,8CAA8C;IAC9C,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,wCAAwC;IACxC,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,4CAA4C;IAC5C,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,2CAA2C;IAC3C,sBAAsB,CAAC,EAAE,MAAM,CAAC;IAChC,8DAA8D;IAC9D,uBAAuB,CAAC,EAAE,MAAM,CAAC;IACjC,iEAAiE;IACjE,0BAA0B,CAAC,EAAE,MAAM,CAAC;IACpC,uCAAuC;IACvC,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B,gEAAgE;IAChE,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,6DAA6D;IAC7D,iCAAiC,CAAC,EAAE,OAAO,CAAC;IAC5C,0CAA0C;IAC1C,yBAAyB,CAAC,EAAE,OAAO,CAAC;IACpC,kDAAkD;IAClD,sBAAsB,CAAC,EAAE,OAAO,CAAC;CAClC;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,8EAA8E;IAC9E,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,sFAAsF;IACtF,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,+EAA+E;IAC/E,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,kFAAkF;IAClF,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,uFAAuF;IACvF,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,yEAAyE;IACzE,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,6EAA6E;IAC7E,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,oDAAoD;IACpD,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,wDAAwD;IACxD,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,oDAAoD;IACpD,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,wEAAwE;IACxE,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED;;;;;;;;GAQG;AACH,MAAM,WAAW,aAAa;IAC5B;;;;;;;;OAQG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb;;;OAGG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED;;;GAGG;AACH,MAAM,WAAW,WAAW;IAC1B,uCAAuC;IACvC,OAAO,CAAC,EAAE,aAAa,CAAC;IACxB,wBAAwB;IACxB,QAAQ,CAAC,EAAE,cAAc,CAAC;IAC1B,6BAA6B;IAC7B,UAAU,CAAC,EAAE,gBAAgB,CAAC;IAC9B,+BAA+B;IAC/B,KAAK,CAAC,EAAE,UAAU,CAAC;IACnB,6BAA6B;IAC7B,KAAK,CAAC,EAAE,WAAW,CAAC;IACpB,kCAAkC;IAClC,MAAM,CAAC,EAAE,YAAY,CAAC;IACtB,8BAA8B;IAC9B,QAAQ,CAAC,EAAE,cAAc,CAAC;CAC3B;AAED;;;GAGG;AACH,MAAM,WAAW,UAAU;IAEzB,yBAAyB,CAAC,EAAE,OAAO,CAAC;IACpC,wBAAwB,CAAC,EAAE,MAAM,CAAC;IAClC,4BAA4B,CAAC,EAAE,MAAM,CAAC;IAGtC,sBAAsB,CAAC,EAAE,MAAM,CAAC;IAChC,4BAA4B,CAAC,EAAE,MAAM,CAAC;IACtC,+BAA+B,CAAC,EAAE,MAAM,CAAC;IACzC,uBAAuB,CAAC,EAAE,OAAO,CAAC;IAGlC,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,iCAAiC,CAAC,EAAE,OAAO,CAAC;IAC5C,yBAAyB,CAAC,EAAE,OAAO,CAAC;IACpC,sBAAsB,CAAC,EAAE,OAAO,CAAC;CAClC;AAED;;GAEG;AACH,eAAO,MAAM,cAAc,EAAE,WAgC5B,CAAC"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/config/types.ts"],"names":[],"mappings":"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"}