sqlew 4.0.4 → 4.1.0

package/assets/sample-commands/README.md

@@ -1,57 +1,56 @@
-# Slash Commands for sqlew
-
-This directory contains slash command templates for Claude Code integration with mcp-sqlew.
-
-## Documentation
-
-**For complete installation guide and usage:**
-
-➡️ **[docs/SLASH_COMMANDS.md](../../docs/SLASH_COMMANDS.md)**
-
-## Command Files
-
-- `sqw-documentor.md` - Document architectural decisions
-- `sqw-secretary.md` - Record decisions (meeting minutes)
-- `sqw-plan.md` - Planning workflow (architecture + tasks)
-- `sqw-research.md` - Search decision/task history
-- `sqw-review.md` - Validate architectural consistency
-- `sqw-scrum.md` - Task management + agent coordination
-
-## Quick Install
-
-### Automatic (Recommended)
-
-Commands are automatically installed when the MCP server starts. Configure in `.sqlew/config.toml`:
-
-```toml
-[commands]
-documentor = true
-secretary = true
-plan = true
-research = true
-review = true
-scrum = true
-```
-
-### Manual Installation
-
-```bash
-# Install all enabled commands
-npx mcp-sqlew init-commands
-
-# Install to custom location
-npx mcp-sqlew init-commands --path /custom/path
-```
-
-Commands are installed to `.claude/commands/` in your project directory.
-
-**Usage**: Invoke commands with the `/` prefix: `/sqw-plan`, `/sqw-documentor`, `/sqw-scrum`
-
-See [docs/SLASH_COMMANDS.md](../../docs/SLASH_COMMANDS.md) for detailed usage examples and customization options.
-
-## Links
-
-- [Main README](../../README.md)
-- [Slash Commands Documentation](../../docs/SLASH_COMMANDS.md)
-- [Specialized Agents](../../docs/SPECIALIZED_AGENTS.md)
-- [Project Repository](https://github.com/sin5ddd/mcp-sqlew)
+# Slash Commands for sqlew
+
+This directory contains slash command templates for Claude Code integration with mcp-sqlew.
+
+## Documentation
+
+**For complete installation guide and usage:**
+
+➡️ **[docs/SLASH_COMMANDS.md](../../docs/SLASH_COMMANDS.md)**
+
+## Command Files
+
+- `sqw-documentor.md` - Document architectural decisions
+- `sqw-secretary.md` - Record decisions (meeting minutes)
+- `sqw-plan.md` - Planning workflow (architecture + tasks)
+- `sqw-research.md` - Search decision/task history
+- `sqw-review.md` - Validate architectural consistency
+- `sqw-scrum.md` - Task management + agent coordination
+
+## Quick Install
+
+### Automatic (Recommended)
+
+Commands are automatically installed when the MCP server starts. Configure in `.sqlew/config.toml`:
+
+```toml
+[commands]
+documentor = true
+secretary = true
+plan = true
+research = true
+review = true
+scrum = true
+```
+
+### Manual Installation
+
+```bash
+# Install all enabled commands
+npx mcp-sqlew init-commands
+
+# Install to custom location
+npx mcp-sqlew init-commands --path /custom/path
+```
+
+Commands are installed to `.claude/commands/` in your project directory.
+
+**Usage**: Invoke commands with the `/` prefix: `/sqw-plan`, `/sqw-documentor`, `/sqw-scrum`
+
+See [docs/SLASH_COMMANDS.md](../../docs/SLASH_COMMANDS.md) for detailed usage examples and customization options.
+
+## Links
+
+- [Main README](../../README.md)
+- [Slash Commands Documentation](../../docs/SLASH_COMMANDS.md)
+- [Project Repository](https://github.com/sin5ddd/mcp-sqlew)

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

@@ -1,17 +1,37 @@
 ---
 name: sqlew-plan-guidance
 description: |
-  Quick reference for sqlew MCP tools.
-  Provides usage patterns for Plan mode integration.
+  Quick reference for sqlew integration.
+  Provides usage patterns for Plan mode with Claude Code Hooks automation.
 ---
 
-## Quick Reference
+## Automatic Integration (v4.1.0+)
 
-### Research (Check Existing Context)
+With `sqlew init --hooks`, everything is **automatic**:
+
+| Event | Hook | Action |
+|-------|------|--------|
+| Task tool called | PreToolUse | Auto-suggest related decisions |
+| Plan file written | PreToolUse | Auto-track with plan ID |
+| Code edited | PostToolUse | Auto-save decision (status: draft) |
+| All todos completed | PostToolUse | Auto-update status to active |
+| Git merge/rebase | Git hooks | Auto-mark as implemented |
+
+## Manual Commands (Slash Command)
+
+```bash
+/sqlew                           # Show status
+/sqlew search for <topic>        # Find related decisions
+/sqlew record <decision>         # Record decision
+/sqlew show remaining tasks      # List active tasks
+```
+
+## Direct MCP Tool Usage (Advanced)
+
+### Research
 
 ```typescript
 mcp__sqlew__suggest action="by_tags" tags=["tag"]
-mcp__sqlew__decision action="search_tags" tags=["tag"]
 mcp__sqlew__task action="list" status="in_progress"
 ```
 
@@ -21,35 +41,22 @@ mcp__sqlew__task action="list" status="in_progress"
 mcp__sqlew__decision action="set"
   key="decision-key"
   value="chosen approach"
-  rationale="why this decision was made"
-  alternatives_considered="what other options were evaluated"
-  tradeoffs="benefits and drawbacks"
 ```
 
 ### Task Creation
 
 ```typescript
 mcp__sqlew__task action="create_batch" tasks=[
-  { title: "Task title", layer: "business", priority: 3, file_actions: [...] }
+  { title: "Task title", layer: "business", priority: 3 }
 ]
 ```
 
-### Constraint Management
+## Decision Workflow (Hooks)
 
-```typescript
-mcp__sqlew__constraint action="add"
-  category="architecture"
-  description="rule description"
-  priority=3
 ```
-
-## Tool Selection Guide
-
-| Purpose | Tool | Action |
-|---------|------|--------|
-| Find related decisions | suggest | by_tags, by_key |
-| Check for duplicates | suggest | check_duplicate |
-| Record decision | decision | set |
-| Create tasks | task | create, create_batch |
-| Add constraint | constraint | add |
-| List tasks | task | list |
+Code Edit      All Todos Done    Git Merge
+    │               │                │
+    ▼               ▼                ▼
+ [draft] ──────→ [active] ──────→ [active]
+         (workflow:in_progress)  (workflow:in_review)  (workflow:implemented)
+```

package/dist/cli/hooks/check-completion.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Check Completion Hook Command
+ *
+ * PostToolUse hook for TodoWrite tool - checks if all tasks are completed.
+ * When all todos are completed, updates the decision status to "in_review".
+ *
+ * Usage:
+ *   echo '{"tool_input": {"todos": [...]}}' | sqlew check-completion
+ *
+ * @since v4.1.0
+ */
+/**
+ * Main check-completion command entry point
+ *
+ * Called as PostToolUse hook when TodoWrite tool completes.
+ * Updates decision to in_review when all todos are completed.
+ */
+export declare function checkCompletionCommand(): Promise<void>;
+//# sourceMappingURL=check-completion.d.ts.map

package/dist/cli/hooks/check-completion.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"check-completion.d.ts","sourceRoot":"","sources":["../../../src/cli/hooks/check-completion.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAyBH;;;;;GAKG;AACH,wBAAsB,sBAAsB,IAAI,OAAO,CAAC,IAAI,CAAC,CA4E5D"}

package/dist/cli/hooks/check-completion.js

@@ -0,0 +1,104 @@
+/**
+ * Check Completion Hook Command
+ *
+ * PostToolUse hook for TodoWrite tool - checks if all tasks are completed.
+ * When all todos are completed, updates the decision status to "in_review".
+ *
+ * Usage:
+ *   echo '{"tool_input": {"todos": [...]}}' | sqlew check-completion
+ *
+ * @since v4.1.0
+ */
+import { readStdinJson, sendContinue, areAllTodosCompleted, getProjectPath } from './stdin-parser.js';
+import { loadCurrentPlan } from '../../config/global-config.js';
+import { initializeDatabase } from '../../database.js';
+import { setDecision } from '../../tools/context/actions/set.js';
+import { join } from 'path';
+// ============================================================================
+// Constants
+// ============================================================================
+/** Decision key prefix for plan-based decisions */
+const PLAN_DECISION_PREFIX = 'plan/implementation';
+/** Status for in-review decisions (using 'active' as DB only supports active/deprecated/draft) */
+const IN_REVIEW_STATUS = 'active';
+/** Workflow tag for in-review state */
+const WORKFLOW_TAG_IN_REVIEW = 'workflow:in_review';
+// ============================================================================
+// Main Entry Point
+// ============================================================================
+/**
+ * Main check-completion command entry point
+ *
+ * Called as PostToolUse hook when TodoWrite tool completes.
+ * Updates decision to in_review when all todos are completed.
+ */
+export async function checkCompletionCommand() {
+    try {
+        const input = await readStdinJson();
+        // Only process TodoWrite tool
+        if (input.tool_name !== 'TodoWrite') {
+            sendContinue();
+            return;
+        }
+        // Check if all todos are completed
+        if (!areAllTodosCompleted(input)) {
+            // Not all completed - continue without action
+            sendContinue();
+            return;
+        }
+        const projectPath = getProjectPath(input);
+        if (!projectPath) {
+            sendContinue();
+            return;
+        }
+        // Check if there's a current plan being tracked
+        const planInfo = loadCurrentPlan(projectPath);
+        if (!planInfo) {
+            // No plan being tracked - continue without action
+            sendContinue();
+            return;
+        }
+        // Only update if the decision was recorded
+        if (!planInfo.recorded) {
+            sendContinue();
+            return;
+        }
+        // Initialize database
+        const dbPath = join(projectPath, '.sqlew', 'sqlew.db');
+        try {
+            await initializeDatabase({ configPath: dbPath });
+        }
+        catch {
+            // Database not initialized - continue without updating
+            sendContinue();
+            return;
+        }
+        // Build decision key from plan file name
+        const planName = planInfo.plan_file.replace(/\.md$/, '');
+        const decisionKey = `${PLAN_DECISION_PREFIX}/${planName}`;
+        // Update decision status to active (in_review tracked via tag)
+        try {
+            await setDecision({
+                key: decisionKey,
+                value: `All tasks completed for plan: ${planInfo.plan_file}`,
+                status: IN_REVIEW_STATUS,
+                layer: 'cross-cutting',
+                tags: ['plan', 'implementation', WORKFLOW_TAG_IN_REVIEW, planInfo.plan_id.slice(0, 8)],
+            });
+            sendContinue(`[sqlew] All tasks completed! Decision updated to status: ${IN_REVIEW_STATUS}`);
+        }
+        catch (error) {
+            // Log error but continue
+            const message = error instanceof Error ? error.message : String(error);
+            console.error(`[sqlew check-completion] Error updating decision: ${message}`);
+            sendContinue();
+        }
+    }
+    catch (error) {
+        // On error, log to stderr but continue execution
+        const message = error instanceof Error ? error.message : String(error);
+        console.error(`[sqlew check-completion] Error: ${message}`);
+        sendContinue();
+    }
+}
+//# sourceMappingURL=check-completion.js.map

package/dist/cli/hooks/check-completion.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"check-completion.js","sourceRoot":"","sources":["../../../src/cli/hooks/check-completion.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,oBAAoB,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACtG,OAAO,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AAChE,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AACvD,OAAO,EAAE,WAAW,EAAE,MAAM,oCAAoC,CAAC;AACjE,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAE5B,+EAA+E;AAC/E,YAAY;AACZ,+EAA+E;AAE/E,mDAAmD;AACnD,MAAM,oBAAoB,GAAG,qBAAqB,CAAC;AAEnD,kGAAkG;AAClG,MAAM,gBAAgB,GAAG,QAAiB,CAAC;AAE3C,uCAAuC;AACvC,MAAM,sBAAsB,GAAG,oBAAoB,CAAC;AAEpD,+EAA+E;AAC/E,mBAAmB;AACnB,+EAA+E;AAE/E;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,sBAAsB;IAC1C,IAAI,CAAC;QACH,MAAM,KAAK,GAAG,MAAM,aAAa,EAAE,CAAC;QAEpC,8BAA8B;QAC9B,IAAI,KAAK,CAAC,SAAS,KAAK,WAAW,EAAE,CAAC;YACpC,YAAY,EAAE,CAAC;YACf,OAAO;QACT,CAAC;QAED,mCAAmC;QACnC,IAAI,CAAC,oBAAoB,CAAC,KAAK,CAAC,EAAE,CAAC;YACjC,8CAA8C;YAC9C,YAAY,EAAE,CAAC;YACf,OAAO;QACT,CAAC;QAED,MAAM,WAAW,GAAG,cAAc,CAAC,KAAK,CAAC,CAAC;QAC1C,IAAI,CAAC,WAAW,EAAE,CAAC;YACjB,YAAY,EAAE,CAAC;YACf,OAAO;QACT,CAAC;QAED,gDAAgD;QAChD,MAAM,QAAQ,GAAG,eAAe,CAAC,WAAW,CAAC,CAAC;QAC9C,IAAI,CAAC,QAAQ,EAAE,CAAC;YACd,kDAAkD;YAClD,YAAY,EAAE,CAAC;YACf,OAAO;QACT,CAAC;QAED,2CAA2C;QAC3C,IAAI,CAAC,QAAQ,CAAC,QAAQ,EAAE,CAAC;YACvB,YAAY,EAAE,CAAC;YACf,OAAO;QACT,CAAC;QAED,sBAAsB;QACtB,MAAM,MAAM,GAAG,IAAI,CAAC,WAAW,EAAE,QAAQ,EAAE,UAAU,CAAC,CAAC;QACvD,IAAI,CAAC;YACH,MAAM,kBAAkB,CAAC,EAAE,UAAU,EAAE,MAAM,EAAE,CAAC,CAAC;QACnD,CAAC;QAAC,MAAM,CAAC;YACP,uDAAuD;YACvD,YAAY,EAAE,CAAC;YACf,OAAO;QACT,CAAC;QAED,yCAAyC;QACzC,MAAM,QAAQ,GAAG,QAAQ,CAAC,SAAS,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;QACzD,MAAM,WAAW,GAAG,GAAG,oBAAoB,IAAI,QAAQ,EAAE,CAAC;QAE1D,+DAA+D;QAC/D,IAAI,CAAC;YACH,MAAM,WAAW,CAAC;gBAChB,GAAG,EAAE,WAAW;gBAChB,KAAK,EAAE,iCAAiC,QAAQ,CAAC,SAAS,EAAE;gBAC5D,MAAM,EAAE,gBAAgB;gBACxB,KAAK,EAAE,eAAe;gBACtB,IAAI,EAAE,CAAC,MAAM,EAAE,gBAAgB,EAAE,sBAAsB,EAAE,QAAQ,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;aACvF,CAAC,CAAC;YAEH,YAAY,CACV,4DAA4D,gBAAgB,EAAE,CAC/E,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,yBAAyB;YACzB,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YACvE,OAAO,CAAC,KAAK,CAAC,qDAAqD,OAAO,EAAE,CAAC,CAAC;YAC9E,YAAY,EAAE,CAAC;QACjB,CAAC;IACH,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,iDAAiD;QACjD,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QACvE,OAAO,CAAC,KAAK,CAAC,mCAAmC,OAAO,EAAE,CAAC,CAAC;QAC5D,YAAY,EAAE,CAAC;IACjB,CAAC;AACH,CAAC"}

package/dist/cli/hooks/init-hooks.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Init Hooks Command
+ *
+ * Initializes Claude Code Hooks configuration for sqlew.
+ * Creates/updates .claude/settings.local.json with hook settings.
+ * Optionally installs Git hooks (post-merge, post-rewrite).
+ *
+ * Usage:
+ *   sqlew init --hooks              # Initialize all hooks
+ *   sqlew init --hooks --no-git     # Skip Git hooks
+ *
+ * Auto-initialization:
+ *   Called automatically on MCP server startup (first time only).
+ *   Silent mode - no console output unless errors occur.
+ *
+ * @since v4.1.0
+ */
+/**
+ * Main init hooks command entry point
+ *
+ * @param args - Command line arguments
+ */
+export declare function initHooksCommand(args?: string[]): Promise<void>;
+/**
+ * Auto-initialize hooks on MCP server startup
+ *
+ * Called from initializeSqlewIntegrations() during server startup.
+ * Silent mode - only logs via debugLog, no console output.
+ * Only runs if hooks are not already configured.
+ *
+ * @param projectPath - Project root path
+ * @returns true if hooks were initialized, false if already configured or skipped
+ */
+export declare function autoInitializeHooks(projectPath: string): boolean;
+//# sourceMappingURL=init-hooks.d.ts.map

package/dist/cli/hooks/init-hooks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"init-hooks.d.ts","sourceRoot":"","sources":["../../../src/cli/hooks/init-hooks.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AA8RH;;;;GAIG;AACH,wBAAsB,gBAAgB,CAAC,IAAI,GAAE,MAAM,EAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAwCzE;AAoCD;;;;;;;;;GASG;AACH,wBAAgB,mBAAmB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CA6BhE"}