@onlooker-community/ecosystem 0.7.1 → 0.8.0

package/.claude-plugin/marketplace.json

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

package/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "ecosystem",
-  "version": "0.7.1",
+  "version": "0.8.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,63 +7,30 @@ on:
 permissions:
   contents: write
   pull-requests: 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'}}
+          release-type: node
+          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'
-          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.1"
+  ".": "0.8.0"
 }

package/CHANGELOG.md

@@ -1,5 +1,19 @@
+# [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.7.2](https://github.com/onlooker-community/ecosystem/compare/v0.7.1...v0.7.2) (2026-05-22)
+
+
+### Bug Fixes
+
+* **ci:** grant id-token write for npm provenance on publish ([c78c9f0](https://github.com/onlooker-community/ecosystem/commit/c78c9f054c1d48ca8a83d0d26b76ce991fffe51b))
+
 ## [0.7.1](https://github.com/onlooker-community/ecosystem/compare/v0.7.0...v0.7.1) (2026-05-22)
 
 

package/hooks/hooks.json

@@ -137,6 +137,26 @@
           }
         ]
       }
+    ],
+    "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"
+          }
+        ]
+      }
     ]
   }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@onlooker-community/ecosystem",
-  "version": "0.7.1",
+  "version": "0.8.0",
   "description": "Agents, skills, hooks, commands, rules, and MCP configurations that power [Onlooker](https://onlooker.dev)",
   "author": {
     "name": "Onlooker Community",

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/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,56 @@ 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 Claude Code hook input to a canonical event.
  * Returns null when the hook input is not mapped to a schema event type.
@@ -153,6 +205,9 @@ export function mapHookInputToCanonical(hookInput, options) {
   const skillMapped = mapSkillHookInput(hookInput, options);
   if (skillMapped) return skillMapped;
 
+  const taskMapped = mapTaskHookInput(hookInput, options);
+  if (taskMapped) return taskMapped;
+
   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,7 @@ 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:-}" \
 		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/test/bats/config.bats

@@ -175,6 +175,28 @@ 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 "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/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/node/schema-events.test.mjs

@@ -5,7 +5,12 @@ 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,
+} 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 +77,52 @@ 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('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({