@onlooker-community/ecosystem 0.7.2 → 0.9.0

package/.claude-plugin/marketplace.json

@@ -12,7 +12,7 @@
       "name": "ecosystem",
       "source": "./",
       "description": "Fill this out",
-      "version": "0.7.2",
+      "version": "0.9.0",
       "author": {
         "name": "Onlooker Community"
       },

package/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "ecosystem",
-  "version": "0.7.2",
+  "version": "0.9.0",
   "description": "TODO fill this out",
   "author": {
     "name": "Onlooker Community",

package/.github/workflows/release.yml

@@ -1,8 +1,4 @@
-name: Release
-
-concurrency:
-  group: ${{ github.workflow }}
-
+name: Release Please
 on:
   push:
     branches:
@@ -11,65 +7,29 @@ on:
 permissions:
   contents: write
   pull-requests: write
-  issues: write
-  # Required for npm publish --provenance (OIDC attestation)
-  id-token: write
 
 jobs:
   release-please:
-    name: Release Please
     runs-on: ubuntu-latest
     steps:
-      - name: Create Release PR
+      - uses: googleapis/release-please-action@v4
         id: release
-        uses: googleapis/release-please-action@16a9c90856f42705d54a6fda1823352bdc62cf38 # v4.4.0
         with:
-          # Do not set release-type here — it overrides release-please-config.json
-          # and skips extra-files (plugin.json, marketplace.json). Release type
-          # is defined per-package in release-please-config.json.
-          config-file: release-please-config.json
-          manifest-file: .release-please-manifest.json
-          # Use a PAT instead of GITHUB_TOKEN so the release PR triggers
-          # downstream workflows (CI, etc.). Events caused by GITHUB_TOKEN
-          # deliberately do not fan out to other workflows; that policy
-          # leaves release PRs unchecked. Set RELEASE_PLEASE_PAT to a
-          # fine-grained token with Contents:write + Pull requests:write
-          # scoped to this repo.
-          token: ${{ secrets.RELEASE_PLEASE_PAT }}
-
-      - uses: actions/checkout@v6
-        if: ${{ steps.release.outputs.releases_created == 'true'}}
-
-      - uses: actions/setup-node@v6
-        if: ${{ steps.release.outputs.releases_created == 'true'}}
+          token: ${{ secrets.RELEASE_PLEASE_TOKEN }}
+          
+      - uses: actions/checkout@v4
+        if: ${{ steps.release.outputs.release_created }}
+        
+      - uses: actions/setup-node@v4
+        if: ${{ steps.release.outputs.release_created }}
         with:
           node-version: '22'
-          registry-url: https://registry.npmjs.org
-          cache: npm
-
-      - name: Publish tools packages to npm
-        if: ${{ steps.release.outputs.releases_created == 'true' }}
+          registry-url: 'https://registry.npmjs.org'
+          
+      - run: npm ci
+        if: ${{ steps.release.outputs.release_created }}
+        
+      - run: npm publish
+        if: ${{ steps.release.outputs.release_created }}
         env:
-          NPM_TOKEN: ${{ secrets.NPM_TOKEN }}
-          PATHS_RELEASED: ${{ steps.release.outputs.paths_released }}
-        run: |
-          set -euo pipefail
-          if [[ -z "${NPM_TOKEN}" ]]; then
-            echo "NPM_TOKEN secret is required to publish to npm." >&2
-            exit 1
-          fi
-          printf '%s\n' "//registry.npmjs.org/:_authToken=${NPM_TOKEN}" >> "${HOME}/.npmrc"
-          npm ci
-          # paths_released is JSON (e.g. ["."], not bare paths)
-          mapfile -t release_paths < <(echo "${PATHS_RELEASED}" | jq -r '.[]')
-          if [[ "${#release_paths[@]}" -eq 0 ]]; then
-            echo "No paths in paths_released; skipping npm publish." >&2
-            exit 0
-          fi
-          for path in "${release_paths[@]}"; do
-            if [[ "$path" == "." ]]; then
-              npm publish --access public --provenance
-            else
-              (cd "$path" && npm publish --access public --provenance)
-            fi
-          done
+          NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}

package/.release-please-manifest.json

@@ -1,3 +1,3 @@
 {
-  ".": "0.7.2"
+  ".": "0.9.0"
 }

package/CHANGELOG.md

@@ -1,5 +1,46 @@
+# [0.8.0](https://github.com/onlooker-community/ecosystem/compare/v0.7.2...v0.8.0) (2026-05-22)
+
+
+### Features
+
+* **hooks:** add TaskCreated and TaskCompleted task lifecycle trackers ([#21](https://github.com/onlooker-community/ecosystem/issues/21)) ([986ffa8](https://github.com/onlooker-community/ecosystem/commit/986ffa84bdd857a464ca0d556671628190ed27bc))
+
 # Changelog
 
+## [0.9.0](https://github.com/onlooker-community/ecosystem/compare/ecosystem-v0.8.0...ecosystem-v0.9.0) (2026-05-22)
+
+
+### Features
+
+* add configuration and hooks for agent spawn tracking ([3ef4590](https://github.com/onlooker-community/ecosystem/commit/3ef459006bbbda246604bdd1ffaf9af0a59f9740))
+* add settings.json for plugin configuration ([67fbdfe](https://github.com/onlooker-community/ecosystem/commit/67fbdfe37f067a45801e7d0355c4a533b687f6b2))
+* **hooks:** add PreCompact and PostCompact context compaction trackers ([#15](https://github.com/onlooker-community/ecosystem/issues/15)) ([1ec5632](https://github.com/onlooker-community/ecosystem/commit/1ec5632404676ed8b35d324b79ad71a2e9093505))
+* **hooks:** add SessionStart and SessionEnd session trackers ([#10](https://github.com/onlooker-community/ecosystem/issues/10)) ([a48d680](https://github.com/onlooker-community/ecosystem/commit/a48d680dd24c98e79ef1c0401b07483ecebf9e8b))
+* **hooks:** add TaskCreated and TaskCompleted task lifecycle trackers ([#21](https://github.com/onlooker-community/ecosystem/issues/21)) ([986ffa8](https://github.com/onlooker-community/ecosystem/commit/986ffa84bdd857a464ca0d556671628190ed27bc))
+* **hooks:** add UserPromptSubmit turn and session duration trackers ([#12](https://github.com/onlooker-community/ecosystem/issues/12)) ([cbb7657](https://github.com/onlooker-community/ecosystem/commit/cbb7657979ed144efce506e6b487e037679b9462))
+* **hooks:** add WorktreeCreate and WorktreeRemove lifecycle trackers ([#24](https://github.com/onlooker-community/ecosystem/issues/24)) ([ff55e39](https://github.com/onlooker-community/ecosystem/commit/ff55e397a0c0adc3e76f66aba12c6b237149ad17))
+* **hooks:** emit canonical schema events for tool history :sparkles: ([1e49a24](https://github.com/onlooker-community/ecosystem/commit/1e49a24bfb930942fa477b594395ef352618f574))
+* **hooks:** track skill usage via skill.invoked events ([23fff0f](https://github.com/onlooker-community/ecosystem/commit/23fff0f0bfad8ab91788d8c45a0457d099d2e870))
+* **hooks:** track tool call sequence on every PreToolUse :sparkles: ([0ad9546](https://github.com/onlooker-community/ecosystem/commit/0ad95465cc22a237e26115a67814a6e7b2951b1d))
+
+
+### Bug Fixes
+
+* **ci:** apply release-please extra-files for Claude plugin manifests ([#17](https://github.com/onlooker-community/ecosystem/issues/17)) ([da9913c](https://github.com/onlooker-community/ecosystem/commit/da9913ca4f7497280edc34f8c64baa903c1e6754))
+* **ci:** checkout release tag before npm publish :relieved: ([bc7bbdc](https://github.com/onlooker-community/ecosystem/commit/bc7bbdc7a886a55ba8f04fe09bfa60043648c766))
+* **ci:** grant id-token write for npm provenance on publish ([c78c9f0](https://github.com/onlooker-community/ecosystem/commit/c78c9f054c1d48ca8a83d0d26b76ce991fffe51b))
+* **ci:** parse release-please paths_released JSON for npm publish ([749e1a0](https://github.com/onlooker-community/ecosystem/commit/749e1a02b563f37f81a8da21fc3f6e10e179314a))
+* **ci:** stop upgrading npm globally before publish ([a7c7a0e](https://github.com/onlooker-community/ecosystem/commit/a7c7a0e1f25aee1bbb75bdd2af130dbc276480a6))
+* **ci:** use HTTPS repository URL for npm provenance ([a7e8927](https://github.com/onlooker-community/ecosystem/commit/a7e89275c5a025a8afee009853265b717091f6ca))
+* **package:** update repository URL format in package.json ([591ce9f](https://github.com/onlooker-community/ecosystem/commit/591ce9f54dd605ec04ceb77b9dcca40b3e08621e))
+
+## [0.8.0](https://github.com/onlooker-community/ecosystem/compare/v0.7.2...v0.8.0) (2026-05-22)
+
+
+### Features
+
+* **hooks:** add TaskCreated and TaskCompleted task lifecycle trackers ([#21](https://github.com/onlooker-community/ecosystem/issues/21)) ([986ffa8](https://github.com/onlooker-community/ecosystem/commit/986ffa84bdd857a464ca0d556671628190ed27bc))
+
 ## [0.7.2](https://github.com/onlooker-community/ecosystem/compare/v0.7.1...v0.7.2) (2026-05-22)
 
 

package/hooks/hooks.json

@@ -137,6 +137,46 @@
           }
         ]
       }
+    ],
+    "TaskCreated": [
+      {
+        "hooks": [
+          {
+            "type": "command",
+            "command": "\"$CLAUDE_PLUGIN_ROOT\"/scripts/hooks/task-tracker.sh"
+          }
+        ]
+      }
+    ],
+    "TaskCompleted": [
+      {
+        "hooks": [
+          {
+            "type": "command",
+            "command": "\"$CLAUDE_PLUGIN_ROOT\"/scripts/hooks/task-tracker.sh"
+          }
+        ]
+      }
+    ],
+    "WorktreeCreate": [
+      {
+        "hooks": [
+          {
+            "type": "command",
+            "command": "\"$CLAUDE_PLUGIN_ROOT\"/scripts/hooks/worktree-tracker.sh"
+          }
+        ]
+      }
+    ],
+    "WorktreeRemove": [
+      {
+        "hooks": [
+          {
+            "type": "command",
+            "command": "\"$CLAUDE_PLUGIN_ROOT\"/scripts/hooks/worktree-tracker.sh"
+          }
+        ]
+      }
     ]
   }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@onlooker-community/ecosystem",
-  "version": "0.7.2",
+  "version": "0.9.0",
   "description": "Agents, skills, hooks, commands, rules, and MCP configurations that power [Onlooker](https://onlooker.dev)",
   "author": {
     "name": "Onlooker Community",
@@ -9,7 +9,7 @@
   "license": "MIT",
   "repository": {
     "type": "git",
-    "url": "https://github.com/onlooker-community/ecosystem"
+    "url": "git+https://github.com/onlooker-community/ecosystem.git"
   },
   "homepage": "https://github.com/onlooker-community/ecosystem#readme",
   "bugs": {

package/release-please-config.json

@@ -1,13 +1,18 @@
 {
-  "$schema": "https://raw.githubusercontent.com/googleapis/release-please/main/schemas/config.json",
   "packages": {
     ".": {
-      "release-type": "node",
-      "pull-request-title-pattern": "chore: release ${version}",
       "changelog-path": "CHANGELOG.md",
-      "include-component-in-tag": false,
-      "include-v-in-tag": true,
+      "release-type": "node",
+      "bump-minor-pre-major": false,
+      "bump-patch-for-minor-pre-major": false,
+      "draft": false,
+      "prerelease": false,
       "extra-files": [
+        {
+          "type": "json",
+          "path": "package.json",
+          "jsonpath": "$.version"
+        },
         {
           "type": "json",
           "path": ".claude-plugin/plugin.json",
@@ -16,20 +21,10 @@
         {
           "type": "json",
           "path": ".claude-plugin/marketplace.json",
-          "jsonpath": "$.plugins..version"
+          "jsonpath": "$.plugins[0].version"
         }
-      ],
-      "changelog-sections": [
-        { "type": "feat", "section": "Features" },
-        { "type": "fix", "section": "Bug Fixes" },
-        { "type": "perf", "section": "Performance" },
-        { "type": "refactor", "section": "Refactoring" },
-        { "type": "docs", "section": "Documentation" },
-        { "type": "test", "section": "Tests" },
-        { "type": "chore", "section": "Chores" },
-        { "type": "ci", "section": "CI/CD" },
-        { "type": "build", "section": "Build" }
       ]
     }
-  }
+  },
+  "$schema": "https://raw.githubusercontent.com/googleapis/release-please/main/schemas/config.json"
 }

package/scripts/hooks/task-tracker.sh

@@ -0,0 +1,61 @@
+#!/usr/bin/env bash
+# Onlooker Task Tracker
+# Invoked by TaskCreated and TaskCompleted when agent team tasks are created or completed.
+#
+# Records canonical task.start and task.complete events to:
+#   ~/.onlooker/session-history/<session_id>.jsonl
+#   ~/.onlooker/logs/onlooker-events.jsonl
+#
+# Usage:
+#   echo "$INPUT" | task-tracker.sh
+
+set -uo pipefail # No -e: never block task create/complete
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+source "$SCRIPT_DIR/../lib/validate-path.sh"
+source "$SCRIPT_DIR/../lib/onlooker-schema.sh"
+source "$SCRIPT_DIR/../lib/session-tracker.sh"
+source "$SCRIPT_DIR/../lib/tool-history.sh"
+source "$SCRIPT_DIR/../lib/task-tracker.sh"
+
+hook_register "task-tracker" "Task Tracker" "Records task.start and task.complete canonical events"
+
+INPUT=$(cat)
+
+HOOK_EVENT=$(echo "$INPUT" | jq -r '.hook_event_name // ""')
+hook_set_context "$INPUT" "$HOOK_EVENT"
+
+SESSION_ID=$(echo "$INPUT" | jq -r '.session_id // "unknown"')
+TASK_ID=$(echo "$INPUT" | jq -r '.task_id // ""')
+
+turn_state_export "$SESSION_ID"
+
+case "$HOOK_EVENT" in
+TaskCreated)
+	task_tracker_record_created "$SESSION_ID" "$TASK_ID" \
+		|| hook_failure "Failed to record task start time"
+	;;
+TaskCompleted)
+	DURATION_MS=$(task_tracker_duration_ms "$SESSION_ID" "$TASK_ID")
+	if [[ -n "$DURATION_MS" ]]; then
+		export ONLOOKER_TASK_DURATION_MS="$DURATION_MS"
+	fi
+	;;
+*)
+	hook_success
+	exit 0
+	;;
+esac
+
+RECORD=$(task_tracker_build_record "$INPUT")
+if [[ -n "$RECORD" ]]; then
+	task_tracker_append "$SESSION_ID" "$RECORD" || hook_failure "Failed to append session history"
+	onlooker_append_event "$RECORD" || hook_failure "Failed to append global event log"
+fi
+
+if [[ "$HOOK_EVENT" == "TaskCompleted" && -n "$TASK_ID" ]]; then
+	task_tracker_clear "$SESSION_ID" "$TASK_ID"
+fi
+
+hook_success
+exit 0

package/scripts/hooks/worktree-tracker.sh

@@ -0,0 +1,121 @@
+#!/usr/bin/env bash
+# Onlooker Worktree Tracker
+# Invoked by WorktreeCreate and WorktreeRemove for isolated agent/git worktree sessions.
+#
+# WorktreeCreate replaces default git behavior: this hook creates the worktree, records
+# telemetry, and prints the absolute worktree path on stdout (stderr for diagnostics).
+# WorktreeRemove records telemetry and removes the git worktree when present.
+#
+# Records canonical tool.shell.exec events (interim until worktree.* schema types exist) to:
+#   ~/.onlooker/session-history/<session_id>.jsonl
+#   ~/.onlooker/logs/onlooker-events.jsonl
+#
+# Usage:
+#   echo "$INPUT" | worktree-tracker.sh
+
+set -uo pipefail
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+source "$SCRIPT_DIR/../lib/validate-path.sh"
+source "$SCRIPT_DIR/../lib/onlooker-schema.sh"
+source "$SCRIPT_DIR/../lib/session-tracker.sh"
+source "$SCRIPT_DIR/../lib/tool-history.sh"
+source "$SCRIPT_DIR/../lib/worktree-tracker.sh"
+
+hook_register "worktree-tracker" "Worktree Tracker" "Creates/removes git worktrees and records lifecycle telemetry"
+
+INPUT=$(cat)
+
+HOOK_EVENT=$(echo "$INPUT" | jq -r '.hook_event_name // ""')
+hook_set_context "$INPUT" "$HOOK_EVENT"
+
+SESSION_ID=$(echo "$INPUT" | jq -r '.session_id // "unknown"')
+CWD=$(echo "$INPUT" | jq -r '.cwd // ""')
+
+turn_state_export "$SESSION_ID"
+
+worktree_tracker_emit() {
+	local enriched_input="${1:-}"
+	local record
+	record=$(worktree_tracker_build_record "$enriched_input")
+	if [[ -n "$record" ]]; then
+		worktree_tracker_append "$SESSION_ID" "$record" || hook_failure "Failed to append session history"
+		onlooker_append_event "$record" || hook_failure "Failed to append global event log"
+	fi
+}
+
+case "$HOOK_EVENT" in
+WorktreeCreate)
+	NAME=$(echo "$INPUT" | jq -r '.name // ""')
+	if [[ -z "$NAME" ]]; then
+		echo "WorktreeCreate requires a worktree name" >&2
+		exit 1
+	fi
+
+	REPO_ROOT=$(worktree_tracker_repo_root "$CWD")
+	if [[ -z "$REPO_ROOT" ]]; then
+		echo "WorktreeCreate requires a git repository (cwd: ${CWD:-unknown})" >&2
+		exit 1
+	fi
+
+	START_MS=$(session_tracker_now_ms)
+	WORKTREE_PATH=$(worktree_tracker_git_create "$REPO_ROOT" "$NAME")
+	if [[ -z "$WORKTREE_PATH" ]]; then
+		echo "Failed to create git worktree for name: $NAME" >&2
+		exit 1
+	fi
+
+	BRANCH="worktree-${NAME}"
+	worktree_tracker_record_created "$SESSION_ID" "$NAME" "$WORKTREE_PATH" "$BRANCH" \
+		|| hook_failure "Failed to record worktree start time"
+
+	END_MS=$(session_tracker_now_ms)
+	export ONLOOKER_WORKTREE_DURATION_MS="$((END_MS - START_MS))"
+
+	ENRICHED=$(echo "$INPUT" | jq \
+		--arg path "$WORKTREE_PATH" \
+		--arg branch "$BRANCH" \
+		--arg repo "$REPO_ROOT" \
+		'. + {worktree_path: $path, branch_name: $branch, repo_root: $repo}')
+	RECORD=$(worktree_tracker_build_record "$ENRICHED")
+	if [[ -n "$RECORD" ]]; then
+		worktree_tracker_append "$SESSION_ID" "$RECORD" \
+			|| hook_failure "Failed to append session history"
+		onlooker_append_event "$RECORD" \
+			|| hook_failure "Failed to append global event log"
+	fi
+
+	# stdout must be only the absolute worktree path for Claude Code
+	printf '%s' "$WORKTREE_PATH"
+	exit 0
+	;;
+WorktreeRemove)
+	WORKTREE_PATH=$(echo "$INPUT" | jq -r '.worktree_path // ""')
+	if [[ -z "$WORKTREE_PATH" ]]; then
+		hook_success
+		exit 0
+	fi
+
+	REPO_ROOT=$(worktree_tracker_repo_root "$CWD")
+	DURATION_MS=$(worktree_tracker_duration_ms "$SESSION_ID" "$WORKTREE_PATH")
+	if [[ -n "$DURATION_MS" ]]; then
+		export ONLOOKER_WORKTREE_DURATION_MS="$DURATION_MS"
+	fi
+
+	ENRICHED=$(echo "$INPUT" | jq --arg repo "${REPO_ROOT:-}"} '. + {repo_root: $repo}')
+	worktree_tracker_emit "$ENRICHED"
+
+	if [[ -n "$REPO_ROOT" ]]; then
+		worktree_tracker_git_remove "$REPO_ROOT" "$WORKTREE_PATH"
+	fi
+
+	worktree_tracker_clear_by_path "$SESSION_ID" "$WORKTREE_PATH"
+
+	hook_success
+	exit 0
+	;;
+*)
+	hook_success
+	exit 0
+	;;
+esac

package/scripts/lib/onlooker-event.mjs

@@ -9,6 +9,8 @@ import { join } from 'node:path';
 import {
   createEvent,
   SKILL_INVOKED,
+  TASK_COMPLETE,
+  TASK_START,
   TOOL_AGENT_COMPLETE,
   TOOL_AGENT_SPAWN,
   TOOL_FILE_EDIT,
@@ -145,6 +147,109 @@ export function mapSkillHookInput(hookInput, options) {
   return { valid: true, event: result.event };
 }
 
+/**
+ * Map TaskCreated / TaskCompleted hook input to task.start or task.complete.
+ * Returns null when the hook input is not a task lifecycle event.
+ */
+export function mapTaskHookInput(hookInput, options) {
+  const { onlookerDir, plugin, runtime = 'claude-code', adapter_id = 'ecosystem.hooks' } = options;
+  const hookEvent = hookInput?.hook_event_name;
+  const sessionId = hookInput?.session_id ?? 'unknown';
+  const taskSubject = hookInput?.task_subject;
+  if (!taskSubject) return null;
+
+  let eventType;
+  let payload;
+
+  if (hookEvent === 'TaskCreated') {
+    eventType = TASK_START;
+    payload = stripUndefined({
+      task_summary: taskSubject,
+    });
+  } else if (hookEvent === 'TaskCompleted') {
+    eventType = TASK_COMPLETE;
+    const durationRaw = process.env.ONLOOKER_TASK_DURATION_MS;
+    const durationMs = durationRaw != null && durationRaw !== '' ? Number.parseInt(String(durationRaw), 10) : undefined;
+    const description = hookInput?.task_description;
+    payload = stripUndefined({
+      success: true,
+      duration_ms: Number.isFinite(durationMs) && durationMs >= 0 ? durationMs : undefined,
+      output_summary: description ? summarizeText(description, 500) : summarizeText(taskSubject, 500),
+    });
+  } else {
+    return null;
+  }
+
+  const event = buildCanonicalEvent({
+    onlookerDir,
+    runtime,
+    adapter_id,
+    plugin,
+    session_id: sessionId,
+    event_type: eventType,
+    payload,
+  });
+
+  const result = validate(event);
+  if (!result.valid) {
+    return { valid: false, errors: result.errors, event_type: eventType };
+  }
+  return { valid: true, event: result.event };
+}
+
+/**
+ * Map WorktreeCreate / WorktreeRemove hook input to tool.shell.exec (interim until
+ * worktree.* event types exist in @onlooker-community/schema).
+ */
+export function mapWorktreeHookInput(hookInput, options) {
+  const { onlookerDir, plugin, runtime = 'claude-code', adapter_id = 'ecosystem.hooks' } = options;
+  const hookEvent = hookInput?.hook_event_name;
+  const sessionId = hookInput?.session_id ?? 'unknown';
+  const cwd = hookInput?.cwd;
+
+  let command;
+  let worktreePath = hookInput?.worktree_path;
+
+  if (hookEvent === 'WorktreeCreate') {
+    const name = hookInput?.name;
+    if (!name) return null;
+    const branch = hookInput?.branch_name ?? `worktree-${name}`;
+    worktreePath = hookInput?.worktree_path;
+    command = `worktree:create name=${name} branch=${branch}${worktreePath ? ` path=${worktreePath}` : ''}`;
+  } else if (hookEvent === 'WorktreeRemove') {
+    if (!worktreePath) return null;
+    command = `worktree:remove path=${worktreePath}`;
+  } else {
+    return null;
+  }
+
+  const durationRaw = process.env.ONLOOKER_WORKTREE_DURATION_MS;
+  const durationMs = durationRaw != null && durationRaw !== '' ? Number.parseInt(String(durationRaw), 10) : undefined;
+
+  const payload = stripUndefined({
+    command,
+    exit_code: 0,
+    duration_ms: Number.isFinite(durationMs) && durationMs >= 0 ? durationMs : undefined,
+    working_directory: cwd,
+  });
+
+  const event = buildCanonicalEvent({
+    onlookerDir,
+    runtime,
+    adapter_id,
+    plugin,
+    session_id: sessionId,
+    event_type: TOOL_SHELL_EXEC,
+    payload,
+  });
+
+  const result = validate(event);
+  if (!result.valid) {
+    return { valid: false, errors: result.errors, event_type: TOOL_SHELL_EXEC };
+  }
+  return { valid: true, event: result.event };
+}
+
 /**
  * Map Claude Code hook input to a canonical event.
  * Returns null when the hook input is not mapped to a schema event type.
@@ -153,6 +258,12 @@ export function mapHookInputToCanonical(hookInput, options) {
   const skillMapped = mapSkillHookInput(hookInput, options);
   if (skillMapped) return skillMapped;
 
+  const taskMapped = mapTaskHookInput(hookInput, options);
+  if (taskMapped) return taskMapped;
+
+  const worktreeMapped = mapWorktreeHookInput(hookInput, options);
+  if (worktreeMapped) return worktreeMapped;
+
   const { onlookerDir, plugin, runtime = 'claude-code', adapter_id = 'ecosystem.hooks' } = options;
 
   const toolName = hookInput?.tool_name;

package/scripts/lib/onlooker-schema.sh

@@ -26,6 +26,8 @@ onlooker_event_from_hook() {
 
 	printf '%s' "$hook_input" | ONLOOKER_DIR="$ONLOOKER_DIR" ONLOOKER_PLUGIN_NAME="$ONLOOKER_PLUGIN_NAME" \
 		ONLOOKER_TURN_NUMBER="${ONLOOKER_TURN_NUMBER:-}" \
+		ONLOOKER_TASK_DURATION_MS="${ONLOOKER_TASK_DURATION_MS:-}" \
+		ONLOOKER_WORKTREE_DURATION_MS="${ONLOOKER_WORKTREE_DURATION_MS:-}" \
 		node "$_ONLOOKER_EVENT_JS" emit-from-hook 2>/dev/null
 }
 

package/scripts/lib/task-tracker.sh

@@ -0,0 +1,84 @@
+#!/usr/bin/env bash
+# Task lifecycle helpers — task.start / task.complete canonical events.
+#
+# Source after validate-path.sh, onlooker-schema.sh, session-tracker.sh, and tool-history.sh:
+#   source "$CLAUDE_PLUGIN_ROOT/scripts/lib/task-tracker.sh"
+
+# Record task creation time in the per-session tracker for duration on complete.
+# Usage: task_tracker_record_created "$SESSION_ID" "$TASK_ID"
+task_tracker_record_created() {
+	local session_id="${1:-}"
+	local task_id="${2:-}"
+	[[ -z "$session_id" || "$session_id" == "null" || -z "$task_id" || "$task_id" == "null" ]] && return 0
+
+	turn_state_ensure_session "$session_id" || return 1
+
+	local tracker_file="${ONLOOKER_SESSION_TRACKERS_DIR}/${session_id}"
+	local now_ms
+	now_ms=$(session_tracker_now_ms)
+
+	local temp_file
+	temp_file=$(mktemp)
+	if jq --arg id "$task_id" --argjson ms "$now_ms" \
+		'.tasks[$id] = {start_time_ms: $ms}' \
+		"$tracker_file" >"$temp_file" 2>/dev/null; then
+		mv "$temp_file" "$tracker_file"
+	else
+		rm -f "$temp_file"
+		return 1
+	fi
+}
+
+# Compute duration since task creation; prints empty when unknown.
+# Usage: duration_ms=$(task_tracker_duration_ms "$SESSION_ID" "$TASK_ID")
+task_tracker_duration_ms() {
+	local session_id="${1:-}"
+	local task_id="${2:-}"
+	[[ -z "$session_id" || -z "$task_id" ]] && return 0
+
+	local tracker_file="${ONLOOKER_SESSION_TRACKERS_DIR}/${session_id}"
+	[[ ! -f "$tracker_file" ]] && return 0
+
+	local start_ms
+	start_ms=$(jq -r --arg id "$task_id" '.tasks[$id].start_time_ms // empty' "$tracker_file" 2>/dev/null)
+	[[ -z "$start_ms" || "$start_ms" == "null" ]] && return 0
+
+	local now_ms elapsed
+	now_ms=$(session_tracker_now_ms)
+	elapsed=$((now_ms - start_ms))
+	if [[ "$elapsed" -ge 0 ]]; then
+		printf '%s' "$elapsed"
+	fi
+}
+
+# Remove task timing entry after completion.
+# Usage: task_tracker_clear "$SESSION_ID" "$TASK_ID"
+task_tracker_clear() {
+	local session_id="${1:-}"
+	local task_id="${2:-}"
+	[[ -z "$session_id" || -z "$task_id" ]] && return 0
+
+	local tracker_file="${ONLOOKER_SESSION_TRACKERS_DIR}/${session_id}"
+	[[ ! -f "$tracker_file" ]] && return 0
+
+	local temp_file
+	temp_file=$(mktemp)
+	if jq --arg id "$task_id" 'del(.tasks[$id])' "$tracker_file" >"$temp_file" 2>/dev/null; then
+		mv "$temp_file" "$tracker_file"
+	else
+		rm -f "$temp_file"
+	fi
+}
+
+# Build a canonical task.* event from hook stdin (empty when unmapped).
+# Usage: record=$(task_tracker_build_record "$INPUT")
+task_tracker_build_record() {
+	local input_json="${1:-}"
+	onlooker_event_from_hook "$input_json"
+}
+
+# Append a canonical task event to session history (reuses tool-history flock).
+# Usage: task_tracker_append "$SESSION_ID" "$event_json"
+task_tracker_append() {
+	tool_history_append "$1" "$2"
+}

package/scripts/lib/worktree-tracker.sh

@@ -0,0 +1,148 @@
+#!/usr/bin/env bash
+# Worktree lifecycle helpers — git worktree create/remove and telemetry state.
+#
+# Source after validate-path.sh, onlooker-schema.sh, session-tracker.sh, and tool-history.sh:
+#   source "$CLAUDE_PLUGIN_ROOT/scripts/lib/worktree-tracker.sh"
+
+# Resolve repository root from hook cwd (must be inside a git work tree).
+# Usage: repo_root=$(worktree_tracker_repo_root "$CWD")
+worktree_tracker_repo_root() {
+	local cwd="${1:-}"
+	[[ -z "$cwd" ]] && return 1
+	git -C "$cwd" rev-parse --show-toplevel 2>/dev/null
+}
+
+# Create a Claude-style git worktree; prints absolute path on stdout, diagnostics on stderr.
+# Usage: path=$(worktree_tracker_git_create "$REPO_ROOT" "$NAME")
+worktree_tracker_git_create() {
+	local repo_root="${1:-}"
+	local name="${2:-}"
+	[[ -z "$repo_root" || -z "$name" ]] && return 1
+
+	local worktree_dir="${repo_root}/.claude/worktrees/${name}"
+	local branch="worktree-${name}"
+
+	mkdir -p "${repo_root}/.claude/worktrees"
+
+	if [[ -d "$worktree_dir" ]]; then
+		(cd "$worktree_dir" && pwd -P)
+		return 0
+	fi
+
+	local base_ref="HEAD"
+	if git -C "$repo_root" rev-parse --abbrev-ref HEAD >/dev/null 2>&1; then
+		base_ref=$(git -C "$repo_root" rev-parse --abbrev-ref HEAD)
+	fi
+
+	if git -C "$repo_root" show-ref --verify --quiet "refs/heads/${branch}" 2>/dev/null; then
+		git -C "$repo_root" worktree add "$worktree_dir" "$branch" >&2 || return 1
+	else
+		git -C "$repo_root" worktree add -b "$branch" "$worktree_dir" "$base_ref" >&2 || return 1
+	fi
+
+	(cd "$worktree_dir" && pwd -P)
+}
+
+# Remove a git worktree when it is registered for the repo (best-effort).
+# Usage: worktree_tracker_git_remove "$REPO_ROOT" "$WORKTREE_PATH"
+worktree_tracker_git_remove() {
+	local repo_root="${1:-}"
+	local worktree_path="${2:-}"
+	[[ -z "$repo_root" || -z "$worktree_path" ]] && return 0
+
+	local resolved_path="$worktree_path"
+	if [[ -d "$worktree_path" ]]; then
+		resolved_path=$(cd "$worktree_path" && pwd -P)
+	fi
+
+	if git -C "$repo_root" worktree list --porcelain 2>/dev/null | grep -Fq "worktree ${resolved_path}"; then
+		git -C "$repo_root" worktree remove --force "$resolved_path" >&2 || true
+	fi
+}
+
+# Record worktree creation in the per-session tracker for duration on remove.
+# Usage: worktree_tracker_record_created "$SESSION_ID" "$NAME" "$PATH" "$BRANCH"
+worktree_tracker_record_created() {
+	local session_id="${1:-}"
+	local name="${2:-}"
+	local worktree_path="${3:-}"
+	local branch="${4:-}"
+	[[ -z "$session_id" || -z "$name" || -z "$worktree_path" ]] && return 0
+
+	turn_state_ensure_session "$session_id" || return 1
+
+	local tracker_file="${ONLOOKER_SESSION_TRACKERS_DIR}/${session_id}"
+	local now_ms
+	now_ms=$(session_tracker_now_ms)
+
+	local temp_file
+	temp_file=$(mktemp)
+	if jq --arg name "$name" --arg path "$worktree_path" --arg branch "$branch" --argjson ms "$now_ms" \
+		'.worktrees[$name] = {path: $path, branch: $branch, start_time_ms: $ms}' \
+		"$tracker_file" >"$temp_file" 2>/dev/null; then
+		mv "$temp_file" "$tracker_file"
+	else
+		rm -f "$temp_file"
+		return 1
+	fi
+}
+
+# Compute duration for a worktree path; prints empty when unknown.
+# Usage: duration_ms=$(worktree_tracker_duration_ms "$SESSION_ID" "$WORKTREE_PATH")
+worktree_tracker_duration_ms() {
+	local session_id="${1:-}"
+	local worktree_path="${2:-}"
+	[[ -z "$session_id" || -z "$worktree_path" ]] && return 0
+
+	local tracker_file="${ONLOOKER_SESSION_TRACKERS_DIR}/${session_id}"
+	[[ ! -f "$tracker_file" ]] && return 0
+
+	local start_ms
+	start_ms=$(
+		jq -r --arg path "$worktree_path" '
+			[.worktrees // {} | to_entries[] | select(.value.path == $path) | .value.start_time_ms] | first // empty
+		' "$tracker_file" 2>/dev/null
+	)
+	[[ -z "$start_ms" || "$start_ms" == "null" ]] && return 0
+
+	local now_ms elapsed
+	now_ms=$(session_tracker_now_ms)
+	elapsed=$((now_ms - start_ms))
+	if [[ "$elapsed" -ge 0 ]]; then
+		printf '%s' "$elapsed"
+	fi
+}
+
+# Remove worktree timing entry after removal telemetry is recorded.
+# Usage: worktree_tracker_clear_by_path "$SESSION_ID" "$WORKTREE_PATH"
+worktree_tracker_clear_by_path() {
+	local session_id="${1:-}"
+	local worktree_path="${2:-}"
+	[[ -z "$session_id" || -z "$worktree_path" ]] && return 0
+
+	local tracker_file="${ONLOOKER_SESSION_TRACKERS_DIR}/${session_id}"
+	[[ ! -f "$tracker_file" ]] && return 0
+
+	local temp_file
+	temp_file=$(mktemp)
+	if jq --arg path "$worktree_path" '
+			.worktrees |= with_entries(select(.value.path != $path))
+		' "$tracker_file" >"$temp_file" 2>/dev/null; then
+		mv "$temp_file" "$tracker_file"
+	else
+		rm -f "$temp_file"
+	fi
+}
+
+# Build a canonical event from hook stdin (empty when unmapped).
+# Usage: record=$(worktree_tracker_build_record "$INPUT")
+worktree_tracker_build_record() {
+	local input_json="${1:-}"
+	onlooker_event_from_hook "$input_json"
+}
+
+# Append a canonical worktree event to session history.
+# Usage: worktree_tracker_append "$SESSION_ID" "$event_json"
+worktree_tracker_append() {
+	tool_history_append "$1" "$2"
+}

package/test/bats/config.bats

@@ -175,6 +175,50 @@ setup_file() {
   [ "$status" -eq 0 ]
 }
 
+@test "hooks.json TaskCreated references task-tracker" {
+  local hook_cmd
+  hook_cmd=$(jq -r '.hooks.TaskCreated[0].hooks[0].command' "${REPO_ROOT}/hooks/hooks.json")
+  [[ "$hook_cmd" == *task-tracker.sh ]]
+
+  local script_path="${hook_cmd//\$CLAUDE_PLUGIN_ROOT/$REPO_ROOT}"
+  script_path="${script_path//\"/}"
+  run test -x "$script_path"
+  [ "$status" -eq 0 ]
+}
+
+@test "hooks.json TaskCompleted references task-tracker" {
+  local hook_cmd
+  hook_cmd=$(jq -r '.hooks.TaskCompleted[0].hooks[0].command' "${REPO_ROOT}/hooks/hooks.json")
+  [[ "$hook_cmd" == *task-tracker.sh ]]
+
+  local script_path="${hook_cmd//\$CLAUDE_PLUGIN_ROOT/$REPO_ROOT}"
+  script_path="${script_path//\"/}"
+  run test -x "$script_path"
+  [ "$status" -eq 0 ]
+}
+
+@test "hooks.json WorktreeCreate references worktree-tracker" {
+  local hook_cmd
+  hook_cmd=$(jq -r '.hooks.WorktreeCreate[0].hooks[0].command' "${REPO_ROOT}/hooks/hooks.json")
+  [[ "$hook_cmd" == *worktree-tracker.sh ]]
+
+  local script_path="${hook_cmd//\$CLAUDE_PLUGIN_ROOT/$REPO_ROOT}"
+  script_path="${script_path//\"/}"
+  run test -x "$script_path"
+  [ "$status" -eq 0 ]
+}
+
+@test "hooks.json WorktreeRemove references worktree-tracker" {
+  local hook_cmd
+  hook_cmd=$(jq -r '.hooks.WorktreeRemove[0].hooks[0].command' "${REPO_ROOT}/hooks/hooks.json")
+  [[ "$hook_cmd" == *worktree-tracker.sh ]]
+
+  local script_path="${hook_cmd//\$CLAUDE_PLUGIN_ROOT/$REPO_ROOT}"
+  script_path="${script_path//\"/}"
+  run test -x "$script_path"
+  [ "$status" -eq 0 ]
+}
+
 @test "plugin.json is valid JSON" {
   run jq -e '.name and .version' "${REPO_ROOT}/.claude-plugin/plugin.json"
   [ "$status" -eq 0 ]

package/test/bats/task-tracker.bats

@@ -0,0 +1,99 @@
+#!/usr/bin/env bats
+
+setup() {
+  # shellcheck source=../helpers/setup.bash
+  source "${BATS_TEST_DIRNAME}/../helpers/setup.bash"
+  load_validate_path
+  # shellcheck source=../../scripts/lib/onlooker-schema.sh
+  source "${REPO_ROOT}/scripts/lib/onlooker-schema.sh"
+  # shellcheck source=../../scripts/lib/session-tracker.sh
+  source "${REPO_ROOT}/scripts/lib/session-tracker.sh"
+  # shellcheck source=../../scripts/lib/tool-history.sh
+  source "${REPO_ROOT}/scripts/lib/tool-history.sh"
+  # shellcheck source=../../scripts/lib/task-tracker.sh
+  source "${REPO_ROOT}/scripts/lib/task-tracker.sh"
+  export CLAUDE_PLUGIN_ROOT="${REPO_ROOT}"
+}
+
+@test "task_tracker_build_record maps TaskCreated to task.start" {
+  local fixture="${REPO_ROOT}/test/fixtures/hook-inputs/task-created.json"
+  local record
+  record=$(task_tracker_build_record "$(cat "$fixture")")
+  echo "$record" | jq -e \
+    '.schema_version == "1.0"
+     and .event_type == "task.start"
+     and .payload.task_summary == "Implement user authentication"
+     and .session_id == "task-session-001"' \
+    >/dev/null
+  echo "$record" | onlooker_validate_event
+}
+
+@test "task_tracker_build_record maps TaskCompleted to task.complete" {
+  local fixture="${REPO_ROOT}/test/fixtures/hook-inputs/task-completed.json"
+  export ONLOOKER_TASK_DURATION_MS=5000
+  local record
+  record=$(task_tracker_build_record "$(cat "$fixture")")
+  echo "$record" | jq -e \
+    '.event_type == "task.complete"
+     and .payload.success == true
+     and .payload.duration_ms == 5000
+     and .payload.output_summary == "Add login and signup endpoints"' \
+    >/dev/null
+  echo "$record" | onlooker_validate_event
+}
+
+@test "task-tracker records task.start on TaskCreated" {
+  local fixture="${REPO_ROOT}/test/fixtures/hook-inputs/task-created.json"
+  local history_file="${ONLOOKER_SESSION_HISTORY_DIR}/task-session-001.jsonl"
+  rm -f "$history_file" "${history_file}.lock"
+  rm -f "${ONLOOKER_SESSION_TRACKERS_DIR}/task-session-001"
+
+  run bash -c "cat '${fixture}' | '${REPO_ROOT}/scripts/hooks/task-tracker.sh' 2>/dev/null"
+  [ "$status" -eq 0 ]
+  [ -f "$history_file" ]
+  tail -n 1 "$history_file" | jq -e '.event_type == "task.start"' >/dev/null
+  tail -n 1 "$history_file" | onlooker_validate_event
+
+  jq -e '.tasks["task-001"].start_time_ms | type == "number"' \
+    "${ONLOOKER_SESSION_TRACKERS_DIR}/task-session-001" >/dev/null
+}
+
+@test "task-tracker records task.complete with duration on TaskCompleted" {
+  local created_fixture="${REPO_ROOT}/test/fixtures/hook-inputs/task-created.json"
+  local completed_fixture="${REPO_ROOT}/test/fixtures/hook-inputs/task-completed.json"
+  local history_file="${ONLOOKER_SESSION_HISTORY_DIR}/task-session-001.jsonl"
+  rm -f "$history_file" "${history_file}.lock"
+  rm -f "${ONLOOKER_SESSION_TRACKERS_DIR}/task-session-001"
+
+  cat "$created_fixture" | "${REPO_ROOT}/scripts/hooks/task-tracker.sh" >/dev/null 2>&1
+
+  local tracker="${ONLOOKER_SESSION_TRACKERS_DIR}/task-session-001"
+  local past_ms
+  past_ms=$(python3 -c 'import time; print(int((time.time() - 2) * 1000))' 2>/dev/null || echo 0)
+  jq --argjson start_ms "$past_ms" '.tasks["task-001"].start_time_ms = $start_ms' "$tracker" >"${tracker}.tmp"
+  mv "${tracker}.tmp" "$tracker"
+
+  run bash -c "cat '${completed_fixture}' | '${REPO_ROOT}/scripts/hooks/task-tracker.sh' 2>/dev/null"
+  [ "$status" -eq 0 ]
+
+  tail -n 1 "$history_file" | jq -e \
+    '.event_type == "task.complete"
+     and .payload.success == true
+     and (.payload.duration_ms | type) == "number"
+     and .payload.duration_ms >= 0' \
+    >/dev/null
+  tail -n 1 "$history_file" | onlooker_validate_event
+
+  run jq -e '.tasks["task-001"]' "$tracker"
+  [ "$status" -ne 0 ]
+}
+
+@test "task-tracker mirrors task events to global events log" {
+  local fixture="${REPO_ROOT}/test/fixtures/hook-inputs/task-created.json"
+  : >"$ONLOOKER_EVENTS_LOG"
+
+  cat "$fixture" | "${REPO_ROOT}/scripts/hooks/task-tracker.sh" >/dev/null 2>&1
+
+  tail -n 1 "$ONLOOKER_EVENTS_LOG" | jq -e '.event_type == "task.start"' >/dev/null
+  tail -n 1 "$ONLOOKER_EVENTS_LOG" | onlooker_validate_event
+}

package/test/bats/worktree-tracker.bats

@@ -0,0 +1,129 @@
+#!/usr/bin/env bats
+
+setup() {
+  # shellcheck source=../helpers/setup.bash
+  source "${BATS_TEST_DIRNAME}/../helpers/setup.bash"
+  load_validate_path
+  # shellcheck source=../../scripts/lib/onlooker-schema.sh
+  source "${REPO_ROOT}/scripts/lib/onlooker-schema.sh"
+  # shellcheck source=../../scripts/lib/session-tracker.sh
+  source "${REPO_ROOT}/scripts/lib/session-tracker.sh"
+  # shellcheck source=../../scripts/lib/tool-history.sh
+  source "${REPO_ROOT}/scripts/lib/tool-history.sh"
+  # shellcheck source=../../scripts/lib/worktree-tracker.sh
+  source "${REPO_ROOT}/scripts/lib/worktree-tracker.sh"
+  export CLAUDE_PLUGIN_ROOT="${REPO_ROOT}"
+
+  GIT_REPO="${BATS_TEST_TMPDIR}/git-repo"
+  rm -rf "$GIT_REPO"
+  mkdir -p "$GIT_REPO"
+  git -C "$GIT_REPO" init -q
+  git -C "$GIT_REPO" config user.email "test@example.com"
+  git -C "$GIT_REPO" config user.name "Test User"
+  echo "hello" >"$GIT_REPO/README.md"
+  git -C "$GIT_REPO" add README.md
+  git -C "$GIT_REPO" commit -q -m "init"
+}
+
+@test "worktree_tracker_build_record maps WorktreeCreate to tool.shell.exec" {
+  local fixture="${REPO_ROOT}/test/fixtures/hook-inputs/worktree-create.json"
+  local enriched
+  enriched=$(jq \
+    --arg path "${GIT_REPO}/.claude/worktrees/feature-auth" \
+    --arg branch "worktree-feature-auth" \
+    '. + {worktree_path: $path, branch_name: $branch}' \
+    "$fixture")
+  export ONLOOKER_WORKTREE_DURATION_MS=42
+  local record
+  record=$(worktree_tracker_build_record "$enriched")
+  echo "$record" | jq -e \
+    '.event_type == "tool.shell.exec"
+     and .payload.exit_code == 0
+     and .payload.duration_ms == 42
+     and (.payload.command | test("worktree:create"))
+     and .payload.working_directory == "/project/repo"' \
+    >/dev/null
+  echo "$record" | onlooker_validate_event
+}
+
+@test "worktree_tracker_build_record maps WorktreeRemove to tool.shell.exec" {
+  local fixture="${REPO_ROOT}/test/fixtures/hook-inputs/worktree-remove.json"
+  export ONLOOKER_WORKTREE_DURATION_MS=9000
+  local record
+  record=$(worktree_tracker_build_record "$(cat "$fixture")")
+  echo "$record" | jq -e \
+    '.event_type == "tool.shell.exec"
+     and (.payload.command | test("worktree:remove"))
+     and .payload.duration_ms == 9000' \
+    >/dev/null
+  echo "$record" | onlooker_validate_event
+}
+
+@test "worktree-tracker WorktreeCreate prints absolute path on stdout" {
+  local history_file="${ONLOOKER_SESSION_HISTORY_DIR}/worktree-session-001.jsonl"
+  rm -f "$history_file" "${history_file}.lock"
+  rm -f "${ONLOOKER_SESSION_TRACKERS_DIR}/worktree-session-001"
+
+  local input_file="${BATS_TEST_TMPDIR}/worktree-create-input.json"
+  jq \
+    --arg cwd "$GIT_REPO" \
+    --arg sid "worktree-session-001" \
+    '.cwd = $cwd | .session_id = $sid' \
+    "${REPO_ROOT}/test/fixtures/hook-inputs/worktree-create.json" >"$input_file"
+
+  local worktree_path
+  worktree_path=$(cat "$input_file" | "${REPO_ROOT}/scripts/hooks/worktree-tracker.sh")
+  [ -d "$worktree_path" ]
+  [[ "$worktree_path" == "$(cd "$worktree_path" && pwd -P)" ]]
+  [ -f "$history_file" ]
+  tail -n 1 "$history_file" | jq -e '.event_type == "tool.shell.exec"' >/dev/null
+}
+
+@test "worktree-tracker WorktreeRemove records telemetry and removes worktree" {
+  local history_file="${ONLOOKER_SESSION_HISTORY_DIR}/worktree-session-001.jsonl"
+  rm -f "$history_file" "${history_file}.lock"
+  rm -f "${ONLOOKER_SESSION_TRACKERS_DIR}/worktree-session-001"
+
+  local create_input_file="${BATS_TEST_TMPDIR}/worktree-create-input.json"
+  local remove_input_file="${BATS_TEST_TMPDIR}/worktree-remove-input.json"
+  jq \
+    --arg cwd "$GIT_REPO" \
+    --arg sid "worktree-session-001" \
+    '.cwd = $cwd | .session_id = $sid' \
+    "${REPO_ROOT}/test/fixtures/hook-inputs/worktree-create.json" >"$create_input_file"
+
+  local worktree_path
+  worktree_path=$(cat "$create_input_file" | "${REPO_ROOT}/scripts/hooks/worktree-tracker.sh")
+
+  jq \
+    --arg cwd "$GIT_REPO" \
+    --arg path "$worktree_path" \
+    --arg sid "worktree-session-001" \
+    '.cwd = $cwd | .worktree_path = $path | .session_id = $sid' \
+    "${REPO_ROOT}/test/fixtures/hook-inputs/worktree-remove.json" >"$remove_input_file"
+
+  run bash -c "cat '${remove_input_file}' | '${REPO_ROOT}/scripts/hooks/worktree-tracker.sh' 2>/dev/null"
+  [ "$status" -eq 0 ]
+  [ ! -d "$worktree_path" ]
+
+  tail -n 1 "$history_file" | jq -e \
+    '.event_type == "tool.shell.exec"
+     and (.payload.command | test("worktree:remove"))' \
+    >/dev/null
+}
+
+@test "worktree-tracker mirrors worktree events to global events log" {
+  local input
+  input=$(jq \
+    --arg cwd "$GIT_REPO" \
+    '.cwd = $cwd' \
+    "${REPO_ROOT}/test/fixtures/hook-inputs/worktree-create.json")
+  : >"$ONLOOKER_EVENTS_LOG"
+
+  printf '%s' "$input" | "${REPO_ROOT}/scripts/hooks/worktree-tracker.sh" >/dev/null
+
+  tail -n 1 "$ONLOOKER_EVENTS_LOG" | jq -e \
+    '.event_type == "tool.shell.exec"
+     and (.payload.command | test("worktree:create"))' \
+    >/dev/null
+}

package/test/fixtures/hook-inputs/task-completed.json

@@ -0,0 +1,12 @@
+{
+  "session_id": "task-session-001",
+  "transcript_path": "/tmp/transcript.jsonl",
+  "cwd": "/project/repo",
+  "permission_mode": "default",
+  "hook_event_name": "TaskCompleted",
+  "task_id": "task-001",
+  "task_subject": "Implement user authentication",
+  "task_description": "Add login and signup endpoints",
+  "teammate_name": "implementer",
+  "team_name": "my-project"
+}

package/test/fixtures/hook-inputs/task-created.json

@@ -0,0 +1,12 @@
+{
+  "session_id": "task-session-001",
+  "transcript_path": "/tmp/transcript.jsonl",
+  "cwd": "/project/repo",
+  "permission_mode": "default",
+  "hook_event_name": "TaskCreated",
+  "task_id": "task-001",
+  "task_subject": "Implement user authentication",
+  "task_description": "Add login and signup endpoints",
+  "teammate_name": "implementer",
+  "team_name": "my-project"
+}

package/test/fixtures/hook-inputs/worktree-create.json

@@ -0,0 +1,8 @@
+{
+  "session_id": "worktree-session-001",
+  "transcript_path": "/tmp/transcript.jsonl",
+  "cwd": "/project/repo",
+  "permission_mode": "default",
+  "hook_event_name": "WorktreeCreate",
+  "name": "feature-auth"
+}

package/test/fixtures/hook-inputs/worktree-remove.json

@@ -0,0 +1,8 @@
+{
+  "session_id": "worktree-session-001",
+  "transcript_path": "/tmp/transcript.jsonl",
+  "cwd": "/project/repo",
+  "permission_mode": "default",
+  "hook_event_name": "WorktreeRemove",
+  "worktree_path": "/project/repo/.claude/worktrees/feature-auth"
+}

package/test/node/schema-events.test.mjs

@@ -5,7 +5,13 @@ import { join } from 'node:path';
 import { test } from 'node:test';
 import { fileURLToPath } from 'node:url';
 import { validate } from '@onlooker-community/schema';
-import { buildCanonicalEvent, mapHookInputToCanonical, mapSkillHookInput } from '../../scripts/lib/onlooker-event.mjs';
+import {
+  buildCanonicalEvent,
+  mapHookInputToCanonical,
+  mapSkillHookInput,
+  mapTaskHookInput,
+  mapWorktreeHookInput,
+} from '../../scripts/lib/onlooker-event.mjs';
 
 const REPO_ROOT = join(fileURLToPath(new URL('../..', import.meta.url)));
 const FIXTURES = join(REPO_ROOT, 'test/fixtures/hook-inputs');
@@ -72,6 +78,89 @@ test('mapSkillHookInput maps PreToolUse Skill to skill.invoked', () => {
   assert.equal(validate(mapped.event).valid, true);
 });
 
+test('mapTaskHookInput maps TaskCreated to task.start', () => {
+  const hookInput = loadFixture('task-created.json');
+  const tmpDir = join(REPO_ROOT, 'test/tmp-schema-events');
+  const mapped = mapTaskHookInput(hookInput, {
+    onlookerDir: tmpDir,
+    plugin: 'onlooker',
+  });
+
+  assert.equal(mapped.valid, true);
+  assert.equal(mapped.event.event_type, 'task.start');
+  assert.equal(mapped.event.payload.task_summary, 'Implement user authentication');
+  assert.equal(validate(mapped.event).valid, true);
+});
+
+test('mapTaskHookInput maps TaskCompleted to task.complete', () => {
+  const hookInput = loadFixture('task-completed.json');
+  const tmpDir = join(REPO_ROOT, 'test/tmp-schema-events');
+  const prev = process.env.ONLOOKER_TASK_DURATION_MS;
+  process.env.ONLOOKER_TASK_DURATION_MS = '1200';
+  const mapped = mapTaskHookInput(hookInput, {
+    onlookerDir: tmpDir,
+    plugin: 'onlooker',
+  });
+  if (prev === undefined) delete process.env.ONLOOKER_TASK_DURATION_MS;
+  else process.env.ONLOOKER_TASK_DURATION_MS = prev;
+
+  assert.equal(mapped.valid, true);
+  assert.equal(mapped.event.event_type, 'task.complete');
+  assert.equal(mapped.event.payload.success, true);
+  assert.equal(mapped.event.payload.duration_ms, 1200);
+  assert.equal(mapped.event.payload.output_summary, 'Add login and signup endpoints');
+  assert.equal(validate(mapped.event).valid, true);
+});
+
+test('mapWorktreeHookInput maps WorktreeCreate to tool.shell.exec', () => {
+  const hookInput = {
+    ...loadFixture('worktree-create.json'),
+    worktree_path: '/project/repo/.claude/worktrees/feature-auth',
+    branch_name: 'worktree-feature-auth',
+  };
+  const tmpDir = join(REPO_ROOT, 'test/tmp-schema-events');
+  const prev = process.env.ONLOOKER_WORKTREE_DURATION_MS;
+  process.env.ONLOOKER_WORKTREE_DURATION_MS = '15';
+  const mapped = mapWorktreeHookInput(hookInput, {
+    onlookerDir: tmpDir,
+    plugin: 'onlooker',
+  });
+  if (prev === undefined) delete process.env.ONLOOKER_WORKTREE_DURATION_MS;
+  else process.env.ONLOOKER_WORKTREE_DURATION_MS = prev;
+
+  assert.equal(mapped.valid, true);
+  assert.equal(mapped.event.event_type, 'tool.shell.exec');
+  assert.equal(mapped.event.payload.exit_code, 0);
+  assert.equal(mapped.event.payload.duration_ms, 15);
+  assert.match(mapped.event.payload.command, /worktree:create/);
+  assert.equal(validate(mapped.event).valid, true);
+});
+
+test('mapWorktreeHookInput maps WorktreeRemove to tool.shell.exec', () => {
+  const hookInput = loadFixture('worktree-remove.json');
+  const tmpDir = join(REPO_ROOT, 'test/tmp-schema-events');
+  const mapped = mapWorktreeHookInput(hookInput, {
+    onlookerDir: tmpDir,
+    plugin: 'onlooker',
+  });
+
+  assert.equal(mapped.valid, true);
+  assert.match(mapped.event.payload.command, /worktree:remove/);
+  assert.equal(validate(mapped.event).valid, true);
+});
+
+test('mapHookInputToCanonical routes TaskCreated through task mapping', () => {
+  const hookInput = loadFixture('task-created.json');
+  const tmpDir = join(REPO_ROOT, 'test/tmp-schema-events');
+  const mapped = mapHookInputToCanonical(hookInput, {
+    onlookerDir: tmpDir,
+    plugin: 'onlooker',
+  });
+
+  assert.equal(mapped.valid, true);
+  assert.equal(mapped.event.event_type, 'task.start');
+});
+
 test('buildCanonicalEvent assigns monotonic file-backed sequence', () => {
   const tmpDir = mkdtempSync(join(tmpdir(), 'onlooker-seq-'));
   const a = buildCanonicalEvent({

package/.claude/settings.local.json

@@ -1,5 +0,0 @@
-{
-  "enabledPlugins": {
-    "ecosystem@onlooker-community": true
-  }
-}