sqlew 5.1.0 → 5.2.1

package/dist/help-data/queue.toml

@@ -1,134 +1,134 @@
-# Queue Tool - Hook Queue Management
-# Manage pending items in .sqlew/queue/pending.json
-
-[tool]
-name = "queue"
-description = "Hook queue management - list, clear, remove pending items from .sqlew/queue/pending.json. Safe operations with lock mechanism to prevent race conditions with QueueWatcher."
-
-# =============================================================================
-# ACTIONS
-# =============================================================================
-
-[[actions]]
-name = "list"
-description = "List all pending items in the queue"
-
-  [[actions.params]]
-  name = "action"
-  type = "string"
-  required = true
-  description = "Must be \"list\""
-
-  [[actions.examples]]
-  title = "List queue items"
-  code = '''
-{
-  "action": "list"
-}
-'''
-  explanation = "Show all pending decisions/constraints in the queue with their index, type, and metadata"
-
-# -----------------------------------------------------------------------------
-
-[[actions]]
-name = "clear"
-description = "Clear all items from the queue"
-
-  [[actions.params]]
-  name = "action"
-  type = "string"
-  required = true
-  description = "Must be \"clear\""
-
-  [[actions.examples]]
-  title = "Clear all queue items"
-  code = '''
-{
-  "action": "clear"
-}
-'''
-  explanation = "Remove all pending items from the queue at once"
-
-# -----------------------------------------------------------------------------
-
-[[actions]]
-name = "remove"
-description = "Remove a specific item from the queue by index"
-
-  [[actions.params]]
-  name = "action"
-  type = "string"
-  required = true
-  description = "Must be \"remove\""
-
-  [[actions.params]]
-  name = "index"
-  type = "number"
-  required = true
-  description = "0-based index of the item to remove (use 'list' first to see indices)"
-
-  [[actions.examples]]
-  title = "Remove item at index 0"
-  code = '''
-{
-  "action": "remove",
-  "index": 0
-}
-'''
-  explanation = "Remove the first item from the queue. Use 'list' first to see available indices."
-
-# -----------------------------------------------------------------------------
-
-[[actions]]
-name = "help"
-description = "Get queue tool documentation"
-
-  [[actions.params]]
-  name = "action"
-  type = "string"
-  required = true
-  description = "Must be \"help\""
-
-  [[actions.examples]]
-  title = "Get help"
-  code = '''
-{
-  "action": "help"
-}
-'''
-  explanation = "Display queue tool documentation"
-
-# -----------------------------------------------------------------------------
-
-[[actions]]
-name = "example"
-description = "Get queue tool usage examples"
-
-  [[actions.params]]
-  name = "action"
-  type = "string"
-  required = true
-  description = "Must be \"example\""
-
-  [[actions.examples]]
-  title = "Get examples"
-  code = '''
-{
-  "action": "example"
-}
-'''
-  explanation = "Display queue tool usage examples"
-
-# =============================================================================
-# USE CASES
-# =============================================================================
-
-[[use_cases]]
-title = "Handle stuck items due to High Similarity"
-description = "Items may remain in queue if they have 60%+ similarity to existing decisions"
-steps = [
-  "1. Use `queue list` to see stuck items",
-  "2. Check existing decisions with `/sqlew search for <topic>`",
-  "3. If truly duplicate: Use `queue remove` with the item index",
-  "4. If different intent: Update the key to be more specific and retry"
-]
+# Queue Tool - Hook Queue Management
+# Manage pending items in .sqlew/queue/pending.json
+
+[tool]
+name = "queue"
+description = "Hook queue management - list, clear, remove pending items from .sqlew/queue/pending.json. Safe operations with lock mechanism to prevent race conditions with QueueWatcher."
+
+# =============================================================================
+# ACTIONS
+# =============================================================================
+
+[[actions]]
+name = "list"
+description = "List all pending items in the queue"
+
+  [[actions.params]]
+  name = "action"
+  type = "string"
+  required = true
+  description = "Must be \"list\""
+
+  [[actions.examples]]
+  title = "List queue items"
+  code = '''
+{
+  "action": "list"
+}
+'''
+  explanation = "Show all pending decisions/constraints in the queue with their index, type, and metadata"
+
+# -----------------------------------------------------------------------------
+
+[[actions]]
+name = "clear"
+description = "Clear all items from the queue"
+
+  [[actions.params]]
+  name = "action"
+  type = "string"
+  required = true
+  description = "Must be \"clear\""
+
+  [[actions.examples]]
+  title = "Clear all queue items"
+  code = '''
+{
+  "action": "clear"
+}
+'''
+  explanation = "Remove all pending items from the queue at once"
+
+# -----------------------------------------------------------------------------
+
+[[actions]]
+name = "remove"
+description = "Remove a specific item from the queue by index"
+
+  [[actions.params]]
+  name = "action"
+  type = "string"
+  required = true
+  description = "Must be \"remove\""
+
+  [[actions.params]]
+  name = "index"
+  type = "number"
+  required = true
+  description = "0-based index of the item to remove (use 'list' first to see indices)"
+
+  [[actions.examples]]
+  title = "Remove item at index 0"
+  code = '''
+{
+  "action": "remove",
+  "index": 0
+}
+'''
+  explanation = "Remove the first item from the queue. Use 'list' first to see available indices."
+
+# -----------------------------------------------------------------------------
+
+[[actions]]
+name = "help"
+description = "Get queue tool documentation"
+
+  [[actions.params]]
+  name = "action"
+  type = "string"
+  required = true
+  description = "Must be \"help\""
+
+  [[actions.examples]]
+  title = "Get help"
+  code = '''
+{
+  "action": "help"
+}
+'''
+  explanation = "Display queue tool documentation"
+
+# -----------------------------------------------------------------------------
+
+[[actions]]
+name = "example"
+description = "Get queue tool usage examples"
+
+  [[actions.params]]
+  name = "action"
+  type = "string"
+  required = true
+  description = "Must be \"example\""
+
+  [[actions.examples]]
+  title = "Get examples"
+  code = '''
+{
+  "action": "example"
+}
+'''
+  explanation = "Display queue tool usage examples"
+
+# =============================================================================
+# USE CASES
+# =============================================================================
+
+[[use_cases]]
+title = "Handle stuck items due to High Similarity"
+description = "Items may remain in queue if they have 60%+ similarity to existing decisions"
+steps = [
+  "1. Use `queue list` to see stuck items",
+  "2. Check existing decisions with `/sqlew search for <topic>`",
+  "3. If truly duplicate: Use `queue remove` with the item index",
+  "4. If different intent: Update the key to be more specific and retry"
+]

package/dist/server/tool-schemas.js

@@ -121,38 +121,38 @@ export const TOOL_SCHEMAS = {
 export const TOOL_DESCRIPTIONS = {
     decision: 'Context Management - Store decisions with versioning and metadata. Use action: "help" for documentation.',
     constraint: 'Architectural Rules - Define and manage project constraints with priorities. Use action: "help" for documentation.',
-    help: `**REQUIRED PARAMETER**: action (must be specified in ALL calls)
-
-Help System - Query action documentation, parameters, and workflow guidance
-
-Actions:
-- query_action: Get action documentation with parameters and examples
-- query_params: Get parameter list only (quick reference)
-- query_tool: Get tool overview and all actions
-- workflow_hints: Get common next actions after current action
-- batch_guide: Get guidance for batch operations
-- error_recovery: Analyze errors and suggest fixes
-
+    help: `**REQUIRED PARAMETER**: action (must be specified in ALL calls)
+
+Help System - Query action documentation, parameters, and workflow guidance
+
+Actions:
+- query_action: Get action documentation with parameters and examples
+- query_params: Get parameter list only (quick reference)
+- query_tool: Get tool overview and all actions
+- workflow_hints: Get common next actions after current action
+- batch_guide: Get guidance for batch operations
+- error_recovery: Analyze errors and suggest fixes
+
 Use this tool to understand how to use other sqlew tools. Returns only requested information (80-95% token reduction vs legacy help).`,
-    example: `**REQUIRED PARAMETER**: action (must be specified in ALL calls)
-
-Example System - Browse and search code examples for sqlew tools
-
-Actions:
-- get: Get examples by tool, action, or topic
-- search: Search examples by keyword
-- list_all: List all available examples with filtering
-
+    example: `**REQUIRED PARAMETER**: action (must be specified in ALL calls)
+
+Example System - Browse and search code examples for sqlew tools
+
+Actions:
+- get: Get examples by tool, action, or topic
+- search: Search examples by keyword
+- list_all: List all available examples with filtering
+
 Use this tool to find working code snippets. Returns only requested examples (token-efficient).`,
-    use_case: `**REQUIRED PARAMETER**: action (must be specified in ALL calls)
-
-Use Case Catalog - Browse and search complete workflow scenarios
-
-Actions:
-- get: Get complete use case workflow by ID
-- search: Search use cases by keyword/category
-- list_all: List all use cases with filtering and pagination
-
+    use_case: `**REQUIRED PARAMETER**: action (must be specified in ALL calls)
+
+Use Case Catalog - Browse and search complete workflow scenarios
+
+Actions:
+- get: Get complete use case workflow by ID
+- search: Search use cases by keyword/category
+- list_all: List all use cases with filtering and pagination
+
 Use this tool to learn end-to-end workflows and multi-step operations. Returns workflow steps with executable code examples.`,
     suggest: 'Intelligent decision/constraint suggestion system. Find related decisions by key pattern, tags, or full context. Prevents duplicates and ensures consistency.',
     queue: 'Hook queue management - list, clear, remove pending items from .sqlew/queue/pending.json. Use action: "help" for documentation.',

package/dist/tests/docker/native/db-init.js

@@ -103,11 +103,11 @@ export async function teardownDatabase(db) {
 async function dropAllTables(db, dbType) {
     if (dbType === 'mysql' || dbType === 'mariadb') {
         await db.raw('SET FOREIGN_KEY_CHECKS=0');
-        const tables = await db.raw(`
-      SELECT TABLE_NAME
-      FROM INFORMATION_SCHEMA.TABLES
-      WHERE TABLE_SCHEMA = DATABASE()
-        AND TABLE_TYPE = 'BASE TABLE'
+        const tables = await db.raw(`
+      SELECT TABLE_NAME
+      FROM INFORMATION_SCHEMA.TABLES
+      WHERE TABLE_SCHEMA = DATABASE()
+        AND TABLE_TYPE = 'BASE TABLE'
     `);
         for (const row of tables[0]) {
             await db.raw(`DROP TABLE IF EXISTS \`${row.TABLE_NAME}\``);
@@ -115,10 +115,10 @@ async function dropAllTables(db, dbType) {
         await db.raw('SET FOREIGN_KEY_CHECKS=1');
     }
     else if (dbType === 'postgresql') {
-        const tables = await db.raw(`
-      SELECT tablename
-      FROM pg_tables
-      WHERE schemaname = 'public'
+        const tables = await db.raw(`
+      SELECT tablename
+      FROM pg_tables
+      WHERE schemaname = 'public'
     `);
         for (const row of tables.rows) {
             await db.raw(`DROP TABLE IF EXISTS "${row.tablename}" CASCADE`);

package/dist/tests/unit/hooks/codex-hook-normalization.test.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Codex Hook Normalization Unit Tests
+ *
+ * @since v5.2.1
+ */
+export {};
+//# sourceMappingURL=codex-hook-normalization.test.d.ts.map

package/dist/tests/unit/hooks/codex-hook-normalization.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"codex-hook-normalization.test.d.ts","sourceRoot":"","sources":["../../../../src/tests/unit/hooks/codex-hook-normalization.test.ts"],"names":[],"mappings":"AAAA;;;;GAIG"}

package/dist/tests/unit/hooks/codex-hook-normalization.test.js

@@ -0,0 +1,112 @@
+/**
+ * Codex Hook Normalization Unit Tests
+ *
+ * @since v5.2.1
+ */
+import { describe, it, beforeEach, afterEach } from 'node:test';
+import assert from 'node:assert';
+import { homedir } from 'os';
+import { join } from 'path';
+import { normalizeHookInput, isPlanMode, } from '../../../cli/hooks/stdin-parser.js';
+import { findCodexTranscriptPath, extractPlanMarkdownFromCodexTranscript, } from '../../../cli/hooks/codex-transcript.js';
+import { determineProjectRoot } from '../../../utils/project-root.js';
+describe('codex-hook-normalization', () => {
+    const originalEnv = { ...process.env };
+    beforeEach(() => {
+        delete process.env.CODEX_SESSION_ID;
+        delete process.env.CODEX_CWD;
+        delete process.env.CODEX_HOME;
+        delete process.env.GROK_HOOK_EVENT;
+        delete process.env.GROK_WORKSPACE_ROOT;
+        delete process.env.CLAUDE_PROJECT_DIR;
+        delete process.env.SQLEW_PROJECT_ROOT;
+    });
+    afterEach(() => {
+        process.env = { ...originalEnv };
+    });
+    describe('normalizeHookInput', () => {
+        it('should normalize Codex shell_command to Bash', () => {
+            const result = normalizeHookInput({
+                hook_event_name: 'PreToolUse',
+                tool_name: 'shell_command',
+                cwd: 'C:/project',
+            });
+            assert.strictEqual(result.client, 'codex');
+            assert.strictEqual(result.tool_name, 'Bash');
+            assert.strictEqual(result.cwd, 'C:/project');
+        });
+        it('should normalize Codex apply_patch to Edit', () => {
+            const result = normalizeHookInput({
+                hook_event_name: 'PostToolUse',
+                tool_name: 'apply_patch',
+                cwd: 'C:/project',
+            });
+            assert.strictEqual(result.client, 'codex');
+            assert.strictEqual(result.tool_name, 'Edit');
+        });
+        it('should map collaboration_mode plan to permission_mode plan', () => {
+            const result = normalizeHookInput({
+                hook_event_name: 'UserPromptSubmit',
+                collaboration_mode: { mode: 'plan' },
+                cwd: 'C:/project',
+                session_id: 'sess-codex-1',
+            });
+            assert.strictEqual(result.client, 'codex');
+            assert.strictEqual(result.collaboration_mode, 'plan');
+            assert.strictEqual(result.permission_mode, 'plan');
+        });
+        it('should use CODEX env vars when stdin is empty', () => {
+            process.env.CODEX_SESSION_ID = 'sess-1';
+            process.env.CODEX_CWD = 'C:/project';
+            const result = normalizeHookInput({});
+            assert.strictEqual(result.client, 'codex');
+            assert.strictEqual(result.session_id, 'sess-1');
+            assert.strictEqual(result.cwd, 'C:/project');
+        });
+    });
+    describe('isPlanMode', () => {
+        it('should detect Codex plan mode via collaboration_mode', () => {
+            assert.strictEqual(isPlanMode({ client: 'codex', collaboration_mode: 'plan' }), true);
+        });
+        it('should detect Codex after normalization', () => {
+            const normalized = normalizeHookInput({
+                hook_event_name: 'UserPromptSubmit',
+                collaboration_mode_kind: 'plan',
+                cwd: 'C:/project',
+            });
+            assert.strictEqual(isPlanMode(normalized), true);
+        });
+    });
+    describe('findCodexTranscriptPath', () => {
+        it('should reject invalid session ids', () => {
+            assert.strictEqual(findCodexTranscriptPath('../escape'), null);
+            assert.strictEqual(findCodexTranscriptPath(''), null);
+        });
+        it('should find an existing local rollout transcript when present', () => {
+            const sessionId = '019e85cb-a131-7760-9a30-f164fcf83073';
+            const expected = join(homedir(), '.codex', 'sessions', '2026', '06', '02', `rollout-2026-06-02T09-46-15-${sessionId}.jsonl`);
+            const found = findCodexTranscriptPath(sessionId);
+            if (found) {
+                assert.strictEqual(found, expected);
+            }
+        });
+    });
+    describe('extractPlanMarkdownFromCodexTranscript', () => {
+        it('should return null for missing files', () => {
+            assert.strictEqual(extractPlanMarkdownFromCodexTranscript('C:/missing/transcript.jsonl'), null);
+        });
+    });
+    describe('determineProjectRoot', () => {
+        // determineProjectRoot uses path.isAbsolute(), which is platform-specific:
+        // 'C:/...' is absolute only on win32. Build paths that are absolute on the
+        // current platform so the precedence assertions hold on Linux CI too.
+        const absRoot = (p) => (process.platform === 'win32' ? `C:${p}` : p);
+        it('should prefer CODEX_CWD over SQLEW_PROJECT_ROOT', () => {
+            const codexRoot = absRoot('/codex-workspace');
+            process.env.CODEX_CWD = codexRoot;
+            process.env.SQLEW_PROJECT_ROOT = absRoot('/other');
+            assert.strictEqual(determineProjectRoot({}), codexRoot);
+        });
+    });
+});
+//# sourceMappingURL=codex-hook-normalization.test.js.map

package/dist/tests/unit/hooks/codex-hook-normalization.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"codex-hook-normalization.test.js","sourceRoot":"","sources":["../../../../src/tests/unit/hooks/codex-hook-normalization.test.ts"],"names":[],"mappings":"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"}

package/dist/tests/unit/hooks/grok-hook-normalization.test.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Grok Build Hook Normalization Unit Tests
+ *
+ * Tests normalizeHookInput() and computeGrokPlanPath() for Grok Build compatibility.
+ *
+ * @since v5.2.0
+ */
+export {};
+//# sourceMappingURL=grok-hook-normalization.test.d.ts.map

package/dist/tests/unit/hooks/grok-hook-normalization.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"grok-hook-normalization.test.d.ts","sourceRoot":"","sources":["../../../../src/tests/unit/hooks/grok-hook-normalization.test.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG"}

package/dist/tests/unit/hooks/grok-hook-normalization.test.js

@@ -0,0 +1,136 @@
+/**
+ * Grok Build Hook Normalization Unit Tests
+ *
+ * Tests normalizeHookInput() and computeGrokPlanPath() for Grok Build compatibility.
+ *
+ * @since v5.2.0
+ */
+import { describe, it, beforeEach, afterEach } from 'node:test';
+import assert from 'node:assert';
+import { homedir } from 'os';
+import { join } from 'path';
+import { normalizeHookInput, computeGrokPlanPath, isPlanMode, } from '../../../cli/hooks/stdin-parser.js';
+import { determineProjectRoot } from '../../../utils/project-root.js';
+describe('grok-hook-normalization', () => {
+    const originalEnv = { ...process.env };
+    beforeEach(() => {
+        delete process.env.GROK_HOOK_EVENT;
+        delete process.env.GROK_WORKSPACE_ROOT;
+        delete process.env.GROK_SESSION_ID;
+        delete process.env.CLAUDE_PROJECT_DIR;
+        delete process.env.SQLEW_PROJECT_ROOT;
+    });
+    afterEach(() => {
+        process.env = { ...originalEnv };
+    });
+    describe('normalizeHookInput', () => {
+        it('should pass through Claude payloads unchanged', () => {
+            const input = {
+                hook_event_name: 'PostToolUse',
+                tool_name: 'ExitPlanMode',
+                cwd: 'C:/project',
+                session_id: 'abc-123',
+            };
+            const result = normalizeHookInput(input);
+            assert.strictEqual(result.hook_event_name, 'PostToolUse');
+            assert.strictEqual(result.tool_name, 'ExitPlanMode');
+            assert.strictEqual(result.client, undefined);
+        });
+        it('should normalize Grok camelCase payload to Claude shape', () => {
+            const result = normalizeHookInput({
+                hookEventName: 'post_tool_use',
+                toolName: 'exit_plan_mode',
+                sessionId: '019eb585-d6ec-7ae0-992a-d60340763a20',
+                workspaceRoot: 'C:\\Users\\kitayama\\RustroverProjects\\mcp-sqlew',
+            });
+            assert.strictEqual(result.client, 'grok');
+            assert.strictEqual(result.hook_event_name, 'PostToolUse');
+            assert.strictEqual(result.tool_name, 'ExitPlanMode');
+            assert.strictEqual(result.session_id, '019eb585-d6ec-7ae0-992a-d60340763a20');
+            assert.strictEqual(result.cwd, 'C:\\Users\\kitayama\\RustroverProjects\\mcp-sqlew');
+        });
+        it('should map enter_plan_mode PreToolUse event', () => {
+            const result = normalizeHookInput({
+                hookEventName: 'pre_tool_use',
+                toolName: 'enter_plan_mode',
+                workspaceRoot: 'C:/project',
+            });
+            assert.strictEqual(result.hook_event_name, 'PreToolUse');
+            assert.strictEqual(result.tool_name, 'EnterPlanMode');
+        });
+        it('should use env vars when stdin is empty', () => {
+            process.env.GROK_HOOK_EVENT = 'post_tool_use';
+            process.env.GROK_WORKSPACE_ROOT = 'C:/project';
+            process.env.GROK_SESSION_ID = 'sess-1';
+            const result = normalizeHookInput({});
+            assert.strictEqual(result.client, 'grok');
+            assert.strictEqual(result.hook_event_name, 'PostToolUse');
+            assert.strictEqual(result.cwd, 'C:/project');
+            assert.strictEqual(result.session_id, 'sess-1');
+        });
+    });
+    describe('isPlanMode', () => {
+        it('should detect Claude plan mode via permission_mode', () => {
+            assert.strictEqual(isPlanMode({ hook_event_name: 'UserPromptSubmit', permission_mode: 'plan' }), true);
+        });
+        it('should return false for Claude non-plan prompts', () => {
+            assert.strictEqual(isPlanMode({ hook_event_name: 'UserPromptSubmit', permission_mode: 'default' }), false);
+        });
+        it('should detect Grok plan mode after normalization (enter_plan_mode)', () => {
+            // Regression: normalizeHookInput maps enter_plan_mode -> EnterPlanMode,
+            // so isPlanMode must match the normalized PascalCase name.
+            const normalized = normalizeHookInput({
+                hookEventName: 'pre_tool_use',
+                toolName: 'enter_plan_mode',
+                workspaceRoot: 'C:/project',
+            });
+            assert.strictEqual(isPlanMode(normalized), true);
+        });
+        it('should detect Grok plan mode after normalization (exit_plan_mode)', () => {
+            const normalized = normalizeHookInput({
+                hookEventName: 'post_tool_use',
+                toolName: 'exit_plan_mode',
+                workspaceRoot: 'C:/project',
+            });
+            assert.strictEqual(isPlanMode(normalized), true);
+        });
+        it('should accept raw snake_case tool names defensively', () => {
+            assert.strictEqual(isPlanMode({ tool_name: 'enter_plan_mode' }), true);
+        });
+        it('should return false for unrelated tools', () => {
+            assert.strictEqual(isPlanMode({ tool_name: 'Bash' }), false);
+        });
+    });
+    describe('computeGrokPlanPath', () => {
+        it('should encode Windows workspace path for session directory', () => {
+            const workspace = 'C:\\Users\\kitayama\\RustroverProjects\\mcp-sqlew';
+            const sessionId = '019eb585-d6ec-7ae0-992a-d60340763a20';
+            const planPath = computeGrokPlanPath(workspace, sessionId);
+            const encoded = encodeURIComponent(workspace);
+            assert.strictEqual(planPath, join(homedir(), '.grok', 'sessions', encoded, sessionId, 'plan.md'));
+        });
+        it('should reject path traversal in sessionId', () => {
+            assert.strictEqual(computeGrokPlanPath('C:/project', '../escape'), null);
+            assert.strictEqual(computeGrokPlanPath('C:/project', ''), null);
+        });
+    });
+    describe('determineProjectRoot', () => {
+        // determineProjectRoot uses path.isAbsolute(), which is platform-specific:
+        // 'C:/...' is absolute only on win32. Build paths that are absolute on the
+        // current platform so the precedence assertions hold on Linux CI too.
+        const absRoot = (p) => (process.platform === 'win32' ? `C:${p}` : p);
+        it('should prefer GROK_WORKSPACE_ROOT over SQLEW_PROJECT_ROOT', () => {
+            const grokRoot = absRoot('/grok-workspace');
+            process.env.GROK_WORKSPACE_ROOT = grokRoot;
+            process.env.SQLEW_PROJECT_ROOT = absRoot('/other');
+            assert.strictEqual(determineProjectRoot({}), grokRoot);
+        });
+        it('should prefer CLAUDE_PROJECT_DIR over GROK_WORKSPACE_ROOT', () => {
+            const claudeRoot = absRoot('/claude-project');
+            process.env.CLAUDE_PROJECT_DIR = claudeRoot;
+            process.env.GROK_WORKSPACE_ROOT = absRoot('/grok-workspace');
+            assert.strictEqual(determineProjectRoot({}), claudeRoot);
+        });
+    });
+});
+//# sourceMappingURL=grok-hook-normalization.test.js.map