wave-agent-sdk 0.10.4 → 0.11.1

package/src/types/hooks.ts

@@ -19,7 +19,7 @@ export type HookEvent =
   | "UserPromptSubmit"
   | "Stop"
   | "SubagentStop"
-  | "Notification"
+  | "PermissionRequest"
   | "WorktreeCreate";
 
 // Individual hook command configuration
@@ -100,7 +100,7 @@ export function isValidHookEvent(event: string): event is HookEvent {
     "UserPromptSubmit",
     "Stop",
     "SubagentStop",
-    "Notification",
+    "PermissionRequest",
     "WorktreeCreate",
   ].includes(event);
 }
@@ -154,16 +154,14 @@ export interface HookJsonInput {
   session_id: string; // Format: "wave_session_{uuid}_{shortId}"
   transcript_path: string; // Format: "~/.wave/sessions/session_{shortId}.json"
   cwd: string; // Absolute path to current working directory
-  hook_event_name: HookEvent; // "PreToolUse" | "PostToolUse" | "UserPromptSubmit" | "Stop" | "SubagentStop" | "Notification"
+  hook_event_name: HookEvent; // "PreToolUse" | "PostToolUse" | "UserPromptSubmit" | "Stop" | "SubagentStop" | "PermissionRequest" | "WorktreeCreate"
 
   // Optional fields based on event type
-  tool_name?: string; // Present for PreToolUse, PostToolUse
-  tool_input?: unknown; // Present for PreToolUse, PostToolUse
+  tool_name?: string; // Present for PreToolUse, PostToolUse, PermissionRequest
+  tool_input?: unknown; // Present for PreToolUse, PostToolUse, PermissionRequest
   tool_response?: unknown; // Present for PostToolUse only
   user_prompt?: string; // Present for UserPromptSubmit only
   subagent_type?: string; // Present when hook is executed by a subagent
-  message?: string; // Present for Notification events
-  notification_type?: string; // Present for Notification events
   name?: string; // Present for WorktreeCreate events
 }
 
@@ -177,8 +175,6 @@ export interface ExtendedHookExecutionContext extends HookExecutionContext {
   env?: Record<string, string>; // Additional environment variables (from configuration)
   userPrompt?: string; // User prompt text (UserPromptSubmit only)
   subagentType?: string; // Subagent type when hook is executed by a subagent
-  message?: string; // Notification message (Notification only)
-  notificationType?: string; // Notification type (Notification only)
   worktreeName?: string; // Worktree name (WorktreeCreate only)
 }
 

package/src/types/index.ts

@@ -35,3 +35,4 @@ export * from "./memoryRule.js";
 export * from "./history.js";
 export * from "./tasks.js";
 export * from "./agent.js";
+export * from "./cron.js";

package/src/types/messaging.ts

@@ -11,7 +11,7 @@ export enum MessageSource {
 }
 
 export interface Message {
-  id?: string; // Unique identifier for the message
+  id: string; // Unique identifier for the message
   role: "user" | "assistant";
   blocks: MessageBlock[];
   usage?: Usage; // Usage data for this message's AI operation (assistant messages only)

package/src/utils/configPaths.ts

@@ -22,16 +22,18 @@ const __dirname = dirname(__filename);
  * Get the builtin skills directory path
  */
 export function getBuiltinSkillsDir(): string {
-  // In development, it's in src/builtin-skills
-  // In production (dist), it should be in dist/builtin-skills
-  // We'll look for it relative to this file
-  const devPath = join(__dirname, "..", "builtin-skills");
-  const prodPath = join(__dirname, "builtin-skills");
-
-  if (existsSync(devPath)) {
-    return devPath;
-  }
-  return prodPath;
+  // Builtin skills are now in the 'builtin/skills' directory at the root of the package
+  // Relative to this file (src/utils/configPaths.ts), it's ../../builtin/skills
+  return join(__dirname, "..", "..", "builtin", "skills");
+}
+
+/**
+ * Get the builtin subagents directory path
+ */
+export function getBuiltinSubagentsDir(): string {
+  // Builtin subagents are now in the 'builtin/subagents' directory at the root of the package
+  // Relative to this file (src/utils/configPaths.ts), it's ../../builtin/subagents
+  return join(__dirname, "..", "..", "builtin", "subagents");
 }
 
 /**

package/src/utils/containerSetup.ts

@@ -14,6 +14,7 @@ import { SkillManager } from "../managers/skillManager.js";
 import { SlashCommandManager } from "../managers/slashCommandManager.js";
 import { PluginManager } from "../managers/pluginManager.js";
 import { BangManager } from "../managers/bangManager.js";
+import { CronManager } from "../managers/cronManager.js";
 import { MemoryRuleManager } from "../managers/MemoryRuleManager.js";
 import { ReversionManager } from "../managers/reversionManager.js";
 import { SubagentManager } from "../managers/subagentManager.js";
@@ -21,6 +22,7 @@ import { LiveConfigManager } from "../managers/liveConfigManager.js";
 import { ConfigurationService } from "../services/configurationService.js";
 import { ReversionService } from "../services/reversionService.js";
 import { MemoryService } from "../services/memory.js";
+import { getGitMainRepoRoot } from "./gitUtils.js";
 import type { AgentOptions } from "../types/index.js";
 import type {
   PermissionMode,
@@ -69,11 +71,17 @@ export function setupAgentContainer(
 
   const callbacks = options.callbacks || {};
   const container = new Container();
+  container.register("AgentOptions", options);
 
   const foregroundTaskManager = new ForegroundTaskManager(container);
   container.register("ForegroundTaskManager", foregroundTaskManager);
   container.register("ConfigurationService", configurationService);
 
+  if (options.worktreeName) {
+    container.register("WorktreeName", options.worktreeName);
+    container.register("MainRepoRoot", getGitMainRepoRoot(workdir));
+  }
+
   const memoryService = new MemoryService(container);
   container.register("MemoryService", memoryService);
 
@@ -130,13 +138,17 @@ export function setupAgentContainer(
   const lspManager = options.lspManager || new LspManager(container);
   container.register("LspManager", lspManager);
 
-  const permissionManager = new PermissionManager(container, { workdir });
+  const permissionManager = new PermissionManager(container, {
+    workdir,
+    instanceAllowedRules: options.allowedTools,
+    instanceDeniedRules: options.disallowedTools,
+  });
   if (configurationService.resolveAutoMemoryEnabled()) {
     const autoMemoryDir = memoryService.getAutoMemoryDirectory(workdir);
     permissionManager.addSystemAdditionalDirectory(autoMemoryDir);
   }
   container.register("PermissionManager", permissionManager);
-  permissionManager.setOnConfiguredDefaultModeChange((mode) => {
+  permissionManager.setOnConfiguredPermissionModeChange((mode) => {
     handlePlanModeTransition(mode);
     onPermissionModeChange(mode);
   });
@@ -153,30 +165,45 @@ export function setupAgentContainer(
   });
   container.register("SkillManager", skillManager);
 
-  container.register(
-    "ReversionService",
-    new ReversionService(messageManager.getTranscriptPath()),
-  );
+  const rootSessionId = messageManager.getRootSessionId();
+
+  container.register("ReversionService", new ReversionService(rootSessionId));
   const reversionManager = new ReversionManager(container);
   container.register("ReversionManager", reversionManager);
 
-  const canUseToolWithNotification = options.canUseTool
+  const canUseToolWithPermissionRequest = options.canUseTool
     ? async (context: ToolPermissionContext) => {
         try {
-          const notificationMessage = `Claude needs your permission to use ${context.toolName}`;
-          await hookManager.executeHooks("Notification", {
-            event: "Notification",
+          const results = await hookManager.executeHooks("PermissionRequest", {
+            event: "PermissionRequest",
             projectDir: workdir,
             timestamp: new Date(),
             sessionId: messageManager.getSessionId(),
             transcriptPath: messageManager.getTranscriptPath(),
             cwd: workdir,
-            message: notificationMessage,
-            notificationType: "permission_prompt",
+            toolName: context.toolName,
+            toolInput: context.toolInput,
             env: configurationService.getEnvironmentVars(),
           });
+
+          if (results.length > 0) {
+            const processResult = hookManager.processHookResults(
+              "PermissionRequest",
+              results,
+              messageManager,
+            );
+
+            if (processResult.shouldBlock) {
+              return {
+                behavior: "deny",
+                message:
+                  processResult.errorMessage ||
+                  "Permission denied by hook execution",
+              };
+            }
+          }
         } catch (error) {
-          logger.warn("Failed to execute notification hooks", {
+          logger.warn("Failed to execute permission request hooks", {
             toolName: context.toolName,
             error: error instanceof Error ? error.message : String(error),
           });
@@ -215,9 +242,9 @@ export function setupAgentContainer(
 
   container.register("PermissionMode", options.permissionMode);
   logger.info("Registering CanUseToolCallback", {
-    hasCallback: !!canUseToolWithNotification,
+    hasCallback: !!canUseToolWithPermissionRequest,
   });
-  container.register("CanUseToolCallback", canUseToolWithNotification);
+  container.register("CanUseToolCallback", canUseToolWithPermissionRequest);
 
   const liveConfigManager = new LiveConfigManager(container, { workdir });
   container.register("LiveConfigManager", liveConfigManager);
@@ -233,11 +260,14 @@ export function setupAgentContainer(
       onSubagentAssistantReasoningUpdated:
         callbacks.onSubagentAssistantReasoningUpdated,
       onSubagentToolBlockUpdated: callbacks.onSubagentToolBlockUpdated,
-      onSubagentMessagesChange: callbacks.onSubagentMessagesChange,
+      onSubagentMessagesChange: (subagentId, messages) => {
+        callbacks.onSubagentMessagesChange?.(subagentId, messages);
+      },
       onSubagentLatestTotalTokensChange:
         callbacks.onSubagentLatestTotalTokensChange,
     },
     onUsageAdded: (usage: Usage) => addUsage(usage),
+    stream,
   });
   container.register("SubagentManager", subagentManager);
 
@@ -262,5 +292,9 @@ export function setupAgentContainer(
   const bangManager = new BangManager(container, { workdir });
   container.register("BangManager", bangManager);
 
+  const cronManager = new CronManager(container);
+  container.register("CronManager", cronManager);
+  cronManager.start();
+
   return container;
 }

package/src/utils/fileSearch.ts

@@ -4,6 +4,8 @@ import fuzzysort from "fuzzysort";
 import type { FileItem } from "../types/fileSearch.js";
 import { logger } from "./globalLogger.js";
 
+const EXCLUDED_FILES = [".git", ".DS_Store"];
+
 /**
  * Execute ripgrep to get all file paths
  */
@@ -39,7 +41,11 @@ async function getAllFiles(workingDirectory: string): Promise<string[]> {
       const files = stdout
         .trim()
         .split("\n")
-        .filter((f) => f.length > 0)
+        .filter((f) => {
+          if (f.length === 0) return false;
+          const parts = f.split(/[/\\]/);
+          return !parts.some((part) => EXCLUDED_FILES.includes(part));
+        })
         .map((f) => f.replace(/\\/g, "/")); // Normalize to forward slashes
       resolve(files);
     });

package/src/utils/mcpUtils.ts

@@ -79,6 +79,7 @@ export function createMcpToolPlugin(
   executeTool: (
     name: string,
     args: Record<string, unknown>,
+    context?: ToolContext,
   ) => Promise<{
     success: boolean;
     content: string;
@@ -95,11 +96,7 @@ export function createMcpToolPlugin(
       context?: ToolContext,
     ): Promise<ToolResult> {
       try {
-        // Context is available for future use when MCP tools need execution context
-        if (context) {
-          // Future: Could pass working directory or other context to MCP tools
-        }
-        const result = await executeTool(prefixedName, args);
+        const result = await executeTool(prefixedName, args, context);
         return {
           success: true,
           content: result.content || `Executed ${mcpTool.name}`,

package/src/utils/subagentParser.ts

@@ -1,6 +1,7 @@
 import { readFileSync, readdirSync, statSync } from "fs";
-import { join, extname } from "path";
+import { join, extname, basename } from "path";
 import { logger } from "./globalLogger.js";
+import { getBuiltinSubagentsDir } from "./configPaths.js";
 
 export interface SubagentConfiguration {
   name: string;
@@ -122,18 +123,27 @@ function validateConfiguration(
  */
 function parseSubagentFile(
   filePath: string,
-  scope: "project" | "user",
+  scope: "project" | "user" | "builtin",
 ): SubagentConfiguration {
   try {
     const content = readFileSync(filePath, "utf-8");
     const { frontmatter, body } = parseFrontmatter(content);
 
+    // Use filename as default name if not specified in frontmatter
+    if (!frontmatter.name) {
+      frontmatter.name = basename(filePath, extname(filePath));
+    }
+
     validateConfiguration(frontmatter, filePath);
 
     if (!body.trim()) {
       throw new Error(`Empty system prompt in ${filePath}`);
     }
 
+    let priority = 1;
+    if (scope === "user") priority = 2;
+    if (scope === "builtin") priority = 3;
+
     return {
       name: frontmatter.name!,
       description: frontmatter.description!,
@@ -142,7 +152,7 @@ function parseSubagentFile(
       systemPrompt: body,
       filePath,
       scope,
-      priority: scope === "project" ? 1 : 2,
+      priority,
     };
   } catch (error) {
     throw new Error(
@@ -156,7 +166,7 @@ function parseSubagentFile(
  */
 function scanSubagentDirectory(
   dirPath: string,
-  scope: "project" | "user",
+  scope: "project" | "user" | "builtin",
 ): SubagentConfiguration[] {
   const configurations: SubagentConfiguration[] = [];
 
@@ -194,10 +204,10 @@ export async function loadSubagentConfigurations(
 ): Promise<SubagentConfiguration[]> {
   const projectDir = join(workdir, ".wave", "agents");
   const userDir = join(process.env.HOME || "~", ".wave", "agents");
+  const builtinDir = getBuiltinSubagentsDir();
 
   // Load configurations from all sources
-  const { getBuiltinSubagents } = await import("./builtinSubagents.js");
-  const builtinConfigs = getBuiltinSubagents();
+  const builtinConfigs = scanSubagentDirectory(builtinDir, "builtin");
   const projectConfigs = scanSubagentDirectory(projectDir, "project");
   const userConfigs = scanSubagentDirectory(userDir, "user");
 

package/dist/builtin-skills/settings/HOOKS.md

@@ -1,95 +0,0 @@
-# Wave Hooks Configuration
-
-Hooks allow you to automate tasks when certain events occur in Wave. This document provides detailed guidance on how to configure complex hooks in `settings.json`.
-
-## Hook Events
-
-Wave supports the following hook events:
-
-- `WorktreeCreate`: Triggered when a new worktree is created.
-- `TaskStart`: Triggered when a task starts.
-- `TaskComplete`: Triggered when a task is completed.
-- `TaskError`: Triggered when a task fails.
-- `SessionStart`: Triggered when a new session starts.
-- `SessionEnd`: Triggered when a session ends.
-
-## Hook Configuration Structure
-
-Hooks are configured in the `hooks` field of `settings.json`. Each event can have multiple hook configurations.
-
-```json
-{
-  "hooks": {
-    "WorktreeCreate": [
-      {
-        "command": "pnpm install",
-        "description": "Install dependencies in new worktree",
-        "blocking": true,
-        "timeout": 300000
-      }
-    ],
-    "TaskComplete": [
-      {
-        "command": "pnpm test",
-        "description": "Run tests after task completion",
-        "blocking": false
-      }
-    ]
-  }
-}
-```
-
-## Hook Configuration Fields
-
-- `command`: The shell command to execute.
-- `description`: A brief description of the hook's purpose.
-- `blocking`: (Optional) Whether the hook should block the main agent's execution (default: `false`).
-- `timeout`: (Optional) Maximum execution time in milliseconds (default: `60000`).
-- `env`: (Optional) Environment variables specific to this hook.
-- `cwd`: (Optional) Working directory for the hook command.
-
-## Advanced Hook Examples
-
-### 1. Conditional Hooks
-You can use shell logic within the `command` field to create conditional hooks.
-```json
-{
-  "hooks": {
-    "TaskComplete": [
-      {
-        "command": "if [ \"$WAVE_TASK_STATUS\" = \"completed\" ]; then pnpm lint; fi",
-        "description": "Run linting only on successful task completion"
-      }
-    ]
-  }
-}
-```
-
-### 2. Hook Chaining
-You can chain multiple commands in a single hook or define multiple hooks for the same event.
-```json
-{
-  "hooks": {
-    "WorktreeCreate": [
-      {
-        "command": "pnpm install && pnpm build",
-        "description": "Install and build in new worktree"
-      }
-    ]
-  }
-}
-```
-
-### 3. Using Environment Variables
-Wave provides several environment variables to hooks:
-- `WAVE_PROJECT_DIR`: The root directory of the project.
-- `WAVE_SESSION_ID`: The current session ID.
-- `WAVE_TASK_ID`: The current task ID (if applicable).
-- `WAVE_TASK_STATUS`: The status of the task (for `TaskComplete` and `TaskError`).
-
-## Best Practices
-
-- **Keep hooks fast**: Long-running hooks can slow down your workflow, especially if they are `blocking`.
-- **Use descriptive names**: Help yourself and others understand what each hook does.
-- **Test your hooks**: Run the commands manually first to ensure they work as expected.
-- **Use local overrides**: For machine-specific hooks, use `.wave/settings.local.json`.

package/dist/utils/builtinSubagents.d.ts

@@ -1,7 +0,0 @@
-import type { SubagentConfiguration } from "./subagentParser.js";
-/**
- * Get all built-in subagent configurations
- * Built-in subagents have priority 3 (lowest) and can be overridden by user/project configs
- */
-export declare function getBuiltinSubagents(): SubagentConfiguration[];
-//# sourceMappingURL=builtinSubagents.d.ts.map

package/dist/utils/builtinSubagents.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"builtinSubagents.d.ts","sourceRoot":"","sources":["../../src/utils/builtinSubagents.ts"],"names":[],"mappings":"AAmBA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAEjE;;;GAGG;AACH,wBAAgB,mBAAmB,IAAI,qBAAqB,EAAE,CAQ7D"}

package/dist/utils/builtinSubagents.js

@@ -1,94 +0,0 @@
-import { BASH_SUBAGENT_TYPE, EXPLORE_SUBAGENT_TYPE, PLAN_SUBAGENT_TYPE, GENERAL_PURPOSE_SUBAGENT_TYPE, } from "../constants/subagents.js";
-import { BASH_SUBAGENT_SYSTEM_PROMPT, GENERAL_PURPOSE_SYSTEM_PROMPT, PLAN_SUBAGENT_SYSTEM_PROMPT, EXPLORE_SUBAGENT_SYSTEM_PROMPT, } from "../prompts/index.js";
-import { BASH_TOOL_NAME, GLOB_TOOL_NAME, GREP_TOOL_NAME, READ_TOOL_NAME, LSP_TOOL_NAME, } from "../constants/tools.js";
-/**
- * Get all built-in subagent configurations
- * Built-in subagents have priority 3 (lowest) and can be overridden by user/project configs
- */
-export function getBuiltinSubagents() {
-    return [
-        createBashSubagent(),
-        createExploreSubagent(),
-        createGeneralPurposeSubagent(),
-        createPlanSubagent(),
-        // Add more built-in subagents here as needed
-    ];
-}
-/**
- * Create the Bash built-in subagent configuration
- * Specialized for executing bash commands and git operations
- */
-function createBashSubagent() {
-    return {
-        name: BASH_SUBAGENT_TYPE,
-        description: "Command execution specialist for running bash commands. Use this for git operations, command execution, and other terminal tasks.",
-        systemPrompt: BASH_SUBAGENT_SYSTEM_PROMPT,
-        tools: [BASH_TOOL_NAME],
-        model: "inherit",
-        filePath: `<builtin:${BASH_SUBAGENT_TYPE}>`,
-        scope: "builtin",
-        priority: 3,
-    };
-}
-/**
- * Create the General-Purpose built-in subagent configuration
- * Specialized for multi-step research and implementation tasks
- */
-function createGeneralPurposeSubagent() {
-    return {
-        name: GENERAL_PURPOSE_SUBAGENT_TYPE,
-        description: "General-purpose agent for researching complex questions, searching for code, and executing multi-step tasks. When you are searching for a keyword or file and are not confident that you will find the right match in the first few tries use this agent to perform the search for you.",
-        systemPrompt: GENERAL_PURPOSE_SYSTEM_PROMPT,
-        filePath: `<builtin:${GENERAL_PURPOSE_SUBAGENT_TYPE}>`,
-        scope: "builtin",
-        priority: 3,
-    };
-}
-/**
- * Create the Explore built-in subagent configuration
- * Specialized for codebase exploration and file search tasks
- */
-function createExploreSubagent() {
-    // Define allowed tools for read-only operations
-    const allowedTools = [
-        GLOB_TOOL_NAME,
-        GREP_TOOL_NAME,
-        READ_TOOL_NAME,
-        BASH_TOOL_NAME,
-        LSP_TOOL_NAME,
-    ];
-    return {
-        name: EXPLORE_SUBAGENT_TYPE,
-        description: 'Fast agent specialized for exploring codebases. Use this when you need to quickly find files by patterns (eg. "src/components/**/*.tsx"), search code for keywords (eg. "API endpoints"), or answer questions about the codebase (eg. "how do API endpoints work?"). When calling this agent, specify the desired thoroughness level: "quick" for basic searches, "medium" for moderate exploration, or "very thorough" for comprehensive analysis across multiple locations and naming conventions.',
-        systemPrompt: EXPLORE_SUBAGENT_SYSTEM_PROMPT,
-        tools: allowedTools,
-        model: "fastModel", // Special value that will use parent's fastModel
-        filePath: `<builtin:${EXPLORE_SUBAGENT_TYPE}>`,
-        scope: "builtin",
-        priority: 3, // Lowest priority - can be overridden by user configs
-    };
-}
-/**
- * Create the Plan built-in subagent configuration
- * Specialized for designing implementation plans and exploring codebases in read-only mode
- */
-function createPlanSubagent() {
-    // Define allowed tools for read-only operations
-    const allowedTools = [
-        GLOB_TOOL_NAME,
-        GREP_TOOL_NAME,
-        READ_TOOL_NAME,
-        BASH_TOOL_NAME,
-        LSP_TOOL_NAME,
-    ];
-    return {
-        name: PLAN_SUBAGENT_TYPE,
-        description: "Software architect agent for designing implementation plans. Use this when you need to plan the implementation strategy for a task. Returns step-by-step plans, identifies critical files, and considers architectural trade-offs.",
-        systemPrompt: PLAN_SUBAGENT_SYSTEM_PROMPT,
-        tools: allowedTools,
-        model: "inherit", // Uses parent agent's model
-        filePath: `<builtin:${PLAN_SUBAGENT_TYPE}>`,
-        scope: "builtin",
-        priority: 3, // Lowest priority - can be overridden by user configs
-    };
-}

package/src/builtin-skills/settings/HOOKS.md

@@ -1,95 +0,0 @@
-# Wave Hooks Configuration
-
-Hooks allow you to automate tasks when certain events occur in Wave. This document provides detailed guidance on how to configure complex hooks in `settings.json`.
-
-## Hook Events
-
-Wave supports the following hook events:
-
-- `WorktreeCreate`: Triggered when a new worktree is created.
-- `TaskStart`: Triggered when a task starts.
-- `TaskComplete`: Triggered when a task is completed.
-- `TaskError`: Triggered when a task fails.
-- `SessionStart`: Triggered when a new session starts.
-- `SessionEnd`: Triggered when a session ends.
-
-## Hook Configuration Structure
-
-Hooks are configured in the `hooks` field of `settings.json`. Each event can have multiple hook configurations.
-
-```json
-{
-  "hooks": {
-    "WorktreeCreate": [
-      {
-        "command": "pnpm install",
-        "description": "Install dependencies in new worktree",
-        "blocking": true,
-        "timeout": 300000
-      }
-    ],
-    "TaskComplete": [
-      {
-        "command": "pnpm test",
-        "description": "Run tests after task completion",
-        "blocking": false
-      }
-    ]
-  }
-}
-```
-
-## Hook Configuration Fields
-
-- `command`: The shell command to execute.
-- `description`: A brief description of the hook's purpose.
-- `blocking`: (Optional) Whether the hook should block the main agent's execution (default: `false`).
-- `timeout`: (Optional) Maximum execution time in milliseconds (default: `60000`).
-- `env`: (Optional) Environment variables specific to this hook.
-- `cwd`: (Optional) Working directory for the hook command.
-
-## Advanced Hook Examples
-
-### 1. Conditional Hooks
-You can use shell logic within the `command` field to create conditional hooks.
-```json
-{
-  "hooks": {
-    "TaskComplete": [
-      {
-        "command": "if [ \"$WAVE_TASK_STATUS\" = \"completed\" ]; then pnpm lint; fi",
-        "description": "Run linting only on successful task completion"
-      }
-    ]
-  }
-}
-```
-
-### 2. Hook Chaining
-You can chain multiple commands in a single hook or define multiple hooks for the same event.
-```json
-{
-  "hooks": {
-    "WorktreeCreate": [
-      {
-        "command": "pnpm install && pnpm build",
-        "description": "Install and build in new worktree"
-      }
-    ]
-  }
-}
-```
-
-### 3. Using Environment Variables
-Wave provides several environment variables to hooks:
-- `WAVE_PROJECT_DIR`: The root directory of the project.
-- `WAVE_SESSION_ID`: The current session ID.
-- `WAVE_TASK_ID`: The current task ID (if applicable).
-- `WAVE_TASK_STATUS`: The status of the task (for `TaskComplete` and `TaskError`).
-
-## Best Practices
-
-- **Keep hooks fast**: Long-running hooks can slow down your workflow, especially if they are `blocking`.
-- **Use descriptive names**: Help yourself and others understand what each hook does.
-- **Test your hooks**: Run the commands manually first to ensure they work as expected.
-- **Use local overrides**: For machine-specific hooks, use `.wave/settings.local.json`.