@onlooker-community/ecosystem 0.6.0 → 0.7.0

package/.claude-plugin/marketplace.json

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

package/.claude-plugin/plugin.json

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

package/.github/workflows/release.yml

@@ -17,13 +17,55 @@ jobs:
     name: Release Please
     runs-on: ubuntu-latest
     steps:
-      - uses: googleapis/release-please-action@16a9c90856f42705d54a6fda1823352bdc62cf38 # v4.4.0
+      - name: Create Release PR
+        id: release
+        uses: googleapis/release-please-action@16a9c90856f42705d54a6fda1823352bdc62cf38 # v4.4.0
         with:
-          release-type: node
+          # 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 }}
+          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'}}
+        with:
+          node-version: '22'
+          cache: npm
+
+      - name: Publish tools packages to npm
+        if: ${{ steps.release.outputs.releases_created == 'true' }}
+        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

package/.release-please-manifest.json

@@ -1,3 +1,3 @@
 {
-  ".": "0.6.0"
+  ".": "0.7.0"
 }

package/CHANGELOG.md

@@ -1,5 +1,24 @@
 # Changelog
 
+## [0.7.0](https://github.com/onlooker-community/ecosystem/compare/v0.6.0...v0.7.0) (2026-05-22)
+
+
+### Features
+
+* **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))
+
+
+### 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))
+
+
+### Chores
+
+* enhance release workflow for npm packages ([3b37b56](https://github.com/onlooker-community/ecosystem/commit/3b37b56270a13fec95c2cd6ee8816ba5725a680a))
+* remove npm publish workflow ([5f29c33](https://github.com/onlooker-community/ecosystem/commit/5f29c33baca8c10289d48f8126dc6eb4b4fe8153))
+* remove test job from npm publish workflow ([f25bf9d](https://github.com/onlooker-community/ecosystem/commit/f25bf9d65fbe5066fe9963ce8d075fe81dc8e5c9))
+
 ## [0.6.0](https://github.com/onlooker-community/ecosystem/compare/v0.5.0...v0.6.0) (2026-05-22)
 
 

package/hooks/hooks.json

@@ -97,6 +97,46 @@
           }
         ]
       }
+    ],
+    "PreCompact": [
+      {
+        "matcher": "manual",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "\"$CLAUDE_PLUGIN_ROOT\"/scripts/hooks/pre-compact-tracker.sh"
+          }
+        ]
+      },
+      {
+        "matcher": "auto",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "\"$CLAUDE_PLUGIN_ROOT\"/scripts/hooks/pre-compact-tracker.sh"
+          }
+        ]
+      }
+    ],
+    "PostCompact": [
+      {
+        "matcher": "manual",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "\"$CLAUDE_PLUGIN_ROOT\"/scripts/hooks/context-compact-tracker.sh"
+          }
+        ]
+      },
+      {
+        "matcher": "auto",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "\"$CLAUDE_PLUGIN_ROOT\"/scripts/hooks/context-compact-tracker.sh"
+          }
+        ]
+      }
     ]
   }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@onlooker-community/ecosystem",
-  "version": "0.6.0",
+  "version": "0.7.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

@@ -8,11 +8,6 @@
       "include-component-in-tag": false,
       "include-v-in-tag": true,
       "extra-files": [
-        {
-          "type": "json",
-          "path": "package.json",
-          "jsonpath": "$.version"
-        },
         {
           "type": "json",
           "path": ".claude-plugin/plugin.json",
@@ -21,7 +16,7 @@
         {
           "type": "json",
           "path": ".claude-plugin/marketplace.json",
-          "jsonpath": "$.plugins[0].version"
+          "jsonpath": "$.plugins..version"
         }
       ],
       "changelog-sections": [

package/scripts/hooks/context-compact-tracker.sh

@@ -0,0 +1,37 @@
+#!/usr/bin/env bash
+# Onlooker Context Compact Tracker
+# Invoked by PostCompact (matchers: manual, auto) after context compaction.
+#
+# Persists compact summaries, emits canonical session.compact, and finalizes
+# compact tracker state.
+#
+# Usage:
+#   echo "$INPUT" | context-compact-tracker.sh
+
+set -uo pipefail # No -e: never alter compaction result
+
+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/tool-history.sh"
+source "$SCRIPT_DIR/../lib/session-tracker.sh"
+source "$SCRIPT_DIR/../lib/compact-tracker.sh"
+
+hook_register "context-compact-tracker" "Context Compact Tracker" "Records compaction results and emits session.compact"
+
+INPUT=$(cat)
+hook_set_context "$INPUT" "PostCompact"
+
+SESSION_ID=$(echo "$INPUT" | jq -r '.session_id // "unknown"')
+
+compact_tracker_append_summary "$SESSION_ID" "$INPUT" || hook_failure "Failed to append compact summary"
+compact_tracker_record_post "$SESSION_ID" "$INPUT" || hook_failure "Failed to finalize compact state"
+
+PAYLOAD=$(compact_tracker_build_compact_payload "$SESSION_ID" "$INPUT")
+if [[ -n "$PAYLOAD" ]]; then
+	session_tracker_emit "$SESSION_ID" "session.compact" "$PAYLOAD" \
+		|| hook_failure "Failed to emit session.compact"
+fi
+
+hook_success
+exit 0

package/scripts/hooks/pre-compact-tracker.sh

@@ -0,0 +1,36 @@
+#!/usr/bin/env bash
+# Onlooker Pre-Compact Tracker
+# Invoked by PreCompact (matchers: manual, auto) before context compaction.
+#
+# Records pending compact state and estimated tokens_before from the transcript.
+# Always approves compaction unless extended later with policy checks.
+#
+# Usage:
+#   echo "$INPUT" | pre-compact-tracker.sh
+
+set -uo pipefail # No -e: never block compaction unless policy added
+
+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/tool-history.sh"
+source "$SCRIPT_DIR/../lib/session-tracker.sh"
+source "$SCRIPT_DIR/../lib/compact-tracker.sh"
+
+hook_register "pre-compact-tracker" "Pre-Compact Tracker" "Records compaction intent before context is compacted"
+
+INPUT=$(cat)
+hook_set_context "$INPUT" "PreCompact"
+
+SESSION_ID=$(echo "$INPUT" | jq -r '.session_id // "unknown"')
+TRIGGER=$(echo "$INPUT" | jq -r '.trigger // "auto"')
+
+compact_tracker_record_pre "$SESSION_ID" "$INPUT" || hook_failure "Failed to record pre-compact state"
+
+json_response() {
+	jq -n --arg decision "$1" --arg reason "$2" '{ "decision": $decision, "reason": $reason }'
+}
+
+json_response "approve" "Compaction tracked (${TRIGGER})"
+hook_success
+exit 0

package/scripts/lib/compact-tracker.sh

@@ -0,0 +1,197 @@
+#!/usr/bin/env bash
+# Context compaction helpers — pre/post compact state and session.compact events.
+#
+# Source after validate-path.sh, onlooker-schema.sh, tool-history.sh, session-tracker.sh:
+#   source "$CLAUDE_PLUGIN_ROOT/scripts/lib/compact-tracker.sh"
+
+# Rough token estimate from byte length (chars / 4).
+# Usage: tokens=$(compact_tracker_estimate_tokens "$text_or_path" [is_file])
+compact_tracker_estimate_tokens() {
+	local value="${1:-}"
+	local is_file="${2:-false}"
+	local bytes=0
+
+	if [[ -z "$value" ]]; then
+		echo 0
+		return 0
+	fi
+
+	if [[ "$is_file" == "true" && -f "$value" ]]; then
+		bytes=$(wc -c <"$value" 2>/dev/null | tr -d ' ') || bytes=0
+	elif [[ "$is_file" == "true" ]]; then
+		echo 0
+		return 0
+	else
+		bytes=${#value}
+	fi
+
+	[[ ! "$bytes" =~ ^[0-9]+$ ]] && bytes=0
+	echo $((bytes / 4))
+}
+
+# Per-session compact state file path.
+compact_tracker_state_file() {
+	local session_id="${1:-}"
+	printf '%s/%s' "$ONLOOKER_COMPACT_TRACKERS_DIR" "$session_id"
+}
+
+# Record pre-compact metadata before compaction runs.
+# Usage: compact_tracker_record_pre "$SESSION_ID" "$INPUT_JSON"
+compact_tracker_record_pre() {
+	local session_id="${1:-}"
+	local input_json="${2:-}"
+	[[ -z "$session_id" || "$session_id" == "null" || -z "$input_json" ]] && return 0
+
+	ensure_dir_exists "$ONLOOKER_COMPACT_TRACKERS_DIR" || return 1
+	turn_state_ensure_session "$session_id" || return 1
+
+	local trigger custom_instructions transcript_path tokens_before turn_number now_ms state_file
+	trigger=$(echo "$input_json" | jq -r '.trigger // "auto"' 2>/dev/null) || trigger="auto"
+	custom_instructions=$(echo "$input_json" | jq -r '.custom_instructions // ""' 2>/dev/null) || custom_instructions=""
+	transcript_path=$(echo "$input_json" | jq -r '.transcript_path // ""' 2>/dev/null) || transcript_path=""
+	now_ms=$(session_tracker_now_ms)
+	state_file=$(compact_tracker_state_file "$session_id")
+
+	tokens_before=0
+	if [[ -n "$transcript_path" && -f "$transcript_path" ]]; then
+		tokens_before=$(compact_tracker_estimate_tokens "$transcript_path" true)
+	fi
+
+	if [[ -f "$ONLOOKER_SESSION_TRACKERS_DIR/$session_id" ]]; then
+		turn_number=$(jq -r '.turn_number // 1' "$ONLOOKER_SESSION_TRACKERS_DIR/$session_id" 2>/dev/null) || turn_number=1
+	else
+		turn_number=1
+	fi
+
+	local prior_count=0
+	if [[ -f "$state_file" ]]; then
+		prior_count=$(jq -r '.compact_count // 0' "$state_file" 2>/dev/null) || prior_count=0
+	fi
+	[[ ! "$prior_count" =~ ^[0-9]+$ ]] && prior_count=0
+
+	jq -n \
+		--argjson started_ms "$now_ms" \
+		--arg trigger "$trigger" \
+		--arg instructions "$custom_instructions" \
+		--argjson tokens_before "$tokens_before" \
+		--argjson turn_number "$turn_number" \
+		--argjson compact_count $((prior_count + 1)) \
+		'{
+			pending: true,
+			started_ms: $started_ms,
+			trigger: $trigger,
+			custom_instructions: (if $instructions != "" then $instructions else null end),
+			tokens_before: $tokens_before,
+			turn_number: $turn_number,
+			compact_count: $compact_count
+		}' >"$state_file"
+}
+
+# Append compact summary to session summaries dir (JSONL).
+# Usage: compact_tracker_append_summary "$SESSION_ID" "$INPUT_JSON"
+compact_tracker_append_summary() {
+	local session_id="${1:-}"
+	local input_json="${2:-}"
+	[[ -z "$session_id" || "$session_id" == "null" ]] && return 0
+
+	local summary trigger
+	summary=$(echo "$input_json" | jq -r '.compact_summary // ""' 2>/dev/null) || summary=""
+	[[ -z "$summary" ]] && return 0
+
+	trigger=$(echo "$input_json" | jq -r '.trigger // "auto"' 2>/dev/null) || trigger="auto"
+
+	ensure_dir_exists "$ONLOOKER_SESSION_SUMMARIES_DIR" || return 1
+	local summary_file="${ONLOOKER_SESSION_SUMMARIES_DIR}/${session_id}.jsonl"
+	local record
+	record=$(jq -n \
+		--arg ts "$(date -u +%Y-%m-%dT%H:%M:%SZ 2>/dev/null || date -u +%Y-%m-%dT%H:%M:%S)" \
+		--arg trigger "$trigger" \
+		--arg summary "$summary" \
+		'{recorded_at: $ts, trigger: $trigger, compact_summary: $summary}')
+
+	printf '%s\n' "$record" >>"$summary_file" 2>/dev/null
+}
+
+# Build session.compact payload from pre state and post-compact summary.
+# Usage: payload=$(compact_tracker_build_compact_payload "$SESSION_ID" "$INPUT_JSON")
+compact_tracker_build_compact_payload() {
+	local session_id="${1:-}"
+	local input_json="${2:-}"
+	[[ -z "$session_id" || "$session_id" == "null" ]] && return 1
+
+	local summary tokens_before tokens_after ratio state_file
+	summary=$(echo "$input_json" | jq -r '.compact_summary // ""' 2>/dev/null) || summary=""
+	tokens_after=$(compact_tracker_estimate_tokens "$summary" false)
+	(( tokens_after < 1 )) && tokens_after=1
+
+	state_file=$(compact_tracker_state_file "$session_id")
+	if [[ -f "$state_file" ]]; then
+		tokens_before=$(jq -r '.tokens_before // 0' "$state_file" 2>/dev/null) || tokens_before=0
+	fi
+	[[ ! "$tokens_before" =~ ^[0-9]+$ ]] && tokens_before=0
+
+	if (( tokens_before < tokens_after )); then
+		tokens_before=$((tokens_after * 2))
+	fi
+	(( tokens_before < 1 )) && tokens_before=1
+
+	ratio=$(awk "BEGIN {printf \"%.4f\", $tokens_after / $tokens_before}")
+
+	jq -n \
+		--argjson tokens_before "$tokens_before" \
+		--argjson tokens_after "$tokens_after" \
+		--argjson ratio "$ratio" \
+		'{
+			tokens_before: $tokens_before,
+			tokens_after: $tokens_after,
+			compression_ratio: $ratio
+		}'
+}
+
+# Finalize compact state after PostCompact.
+# Usage: compact_tracker_record_post "$SESSION_ID" "$INPUT_JSON"
+compact_tracker_record_post() {
+	local session_id="${1:-}"
+	local input_json="${2:-}"
+	[[ -z "$session_id" || "$session_id" == "null" ]] && return 0
+
+	local state_file now_ms summary_len trigger
+	state_file=$(compact_tracker_state_file "$session_id")
+	now_ms=$(session_tracker_now_ms)
+	summary_len=$(echo "$input_json" | jq -r '.compact_summary // ""' 2>/dev/null | wc -c | tr -d ' ') || summary_len=0
+	trigger=$(echo "$input_json" | jq -r '.trigger // "auto"' 2>/dev/null) || trigger="auto"
+
+	if [[ ! -f "$state_file" ]]; then
+		compact_tracker_record_pre "$session_id" "$input_json"
+		state_file=$(compact_tracker_state_file "$session_id")
+	fi
+
+	local temp_file
+	temp_file=$(mktemp)
+	if ! jq \
+		--argjson completed_ms "$now_ms" \
+		--argjson summary_chars "$summary_len" \
+		--arg trigger "$trigger" \
+		'.pending = false
+		| .completed_ms = $completed_ms
+		| .last_trigger = $trigger
+		| .last_summary_chars = $summary_chars' \
+		"$state_file" >"$temp_file" 2>/dev/null; then
+		rm -f "$temp_file"
+		return 1
+	fi
+	mv "$temp_file" "$state_file"
+
+	# Reset per-turn tool sequence after compaction (new context window).
+	local tracker_file="$ONLOOKER_SESSION_TRACKERS_DIR/$session_id"
+	if [[ -f "$tracker_file" ]]; then
+		temp_file=$(mktemp)
+		if jq --argjson now_ms "$now_ms" \
+			'.turn_tool_seq = 0 | .last_compact_ms = $now_ms' \
+			"$tracker_file" >"$temp_file" 2>/dev/null; then
+			mv "$temp_file" "$tracker_file"
+		else
+			rm -f "$temp_file"
+		fi
+	fi
+}

package/test/bats/compact-tracker.bats

@@ -0,0 +1,73 @@
+#!/usr/bin/env bats
+
+setup() {
+  # shellcheck source=../helpers/setup.bash
+  source "${BATS_TEST_DIRNAME}/../helpers/setup.bash"
+  load_validate_path
+  export CLAUDE_PLUGIN_ROOT="${REPO_ROOT}"
+  source "${REPO_ROOT}/scripts/lib/onlooker-schema.sh"
+  source "${REPO_ROOT}/scripts/lib/tool-history.sh"
+  source "${REPO_ROOT}/scripts/lib/session-tracker.sh"
+  source "${REPO_ROOT}/scripts/lib/compact-tracker.sh"
+}
+
+@test "pre-compact-tracker approves and records pending compact state" {
+  local fixture="${REPO_ROOT}/test/fixtures/hook-inputs/pre-compact-manual.json"
+  local session_id="compact-session-001"
+  local transcript="/tmp/onlooker-compact-transcript-${BATS_TEST_NUMBER}.jsonl"
+  local state_file="${ONLOOKER_COMPACT_TRACKERS_DIR}/${session_id}"
+
+  printf '%s\n' '{"type":"user","message":"hello"}' '{"type":"assistant","message":"world"}' >"$transcript"
+  local runtime_input="${BATS_TEST_TMPDIR}/pre-compact-input.json"
+  jq --arg path "$transcript" '.transcript_path = $path' "$fixture" >"$runtime_input"
+  rm -f "$state_file"
+
+  run bash -c "cat '${runtime_input}' | '${REPO_ROOT}/scripts/hooks/pre-compact-tracker.sh' 2>/dev/null"
+  [ "$status" -eq 0 ]
+  echo "$output" | jq -e '.decision == "approve"' >/dev/null
+
+  jq -e '.pending == true
+    and .trigger == "manual"
+    and .compact_count == 1
+    and (.tokens_before | type) == "number"' \
+    "$state_file" >/dev/null
+
+  rm -f "$transcript"
+}
+
+@test "context-compact-tracker emits session.compact and saves summary" {
+  local pre_fixture="${REPO_ROOT}/test/fixtures/hook-inputs/pre-compact-manual.json"
+  local post_fixture="${REPO_ROOT}/test/fixtures/hook-inputs/post-compact-manual.json"
+  local session_id="compact-session-001"
+  local transcript="/tmp/onlooker-compact-transcript-post-${BATS_TEST_NUMBER}.jsonl"
+  local state_file="${ONLOOKER_COMPACT_TRACKERS_DIR}/${session_id}"
+  local history_file="${ONLOOKER_SESSION_HISTORY_DIR}/${session_id}.jsonl"
+  local summary_file="${ONLOOKER_SESSION_SUMMARIES_DIR}/${session_id}.jsonl"
+
+  printf '%s\n' '{"type":"user","message":"long context"}' >"$transcript"
+  local pre_input post_input
+  pre_input=$(jq --arg path "$transcript" '.transcript_path = $path' "$pre_fixture")
+  post_input=$(jq --arg path "$transcript" '.transcript_path = $path' "$post_fixture")
+
+  rm -f "$state_file" "$history_file" "$summary_file"
+  printf '%s' "$pre_input" | "${REPO_ROOT}/scripts/hooks/pre-compact-tracker.sh" >/dev/null 2>&1
+
+  local post_runtime="${BATS_TEST_TMPDIR}/post-compact-input.json"
+  printf '%s' "$post_input" >"$post_runtime"
+  run bash -c "cat '${post_runtime}' | '${REPO_ROOT}/scripts/hooks/context-compact-tracker.sh' 2>/dev/null"
+  [ "$status" -eq 0 ]
+
+  jq -e '.pending == false and .last_trigger == "manual"' "$state_file" >/dev/null
+  jq -e '.event_type == "session.compact"
+    and (.payload.tokens_before >= .payload.tokens_after)
+    and (.payload.compression_ratio | type) == "number"' \
+    "$history_file" >/dev/null
+  run jq -e '.compact_summary | length > 0' "$summary_file"
+  [ "$status" -eq 0 ]
+
+  rm -f "$transcript"
+}
+
+@test "compact_tracker_estimate_tokens estimates from string length" {
+  [ "$(compact_tracker_estimate_tokens "abcdefghij" false)" -eq 2 ]
+}

package/test/bats/config.bats

@@ -10,6 +10,19 @@ setup_file() {
   [ "$status" -eq 0 ]
 }
 
+@test "claude plugin versions match package.json" {
+  local pkg_ver
+  pkg_ver=$(jq -r '.version' "${REPO_ROOT}/package.json")
+
+  run jq -e --arg v "$pkg_ver" '.version == $v' "${REPO_ROOT}/.claude-plugin/plugin.json"
+  [ "$status" -eq 0 ]
+
+  run jq -e --arg v "$pkg_ver" \
+    '[.plugins[].version] | unique | length == 1 and .[0] == $v' \
+    "${REPO_ROOT}/.claude-plugin/marketplace.json"
+  [ "$status" -eq 0 ]
+}
+
 @test "hooks.json wildcard matcher references tool-sequence-tracker" {
   run jq -e '.hooks.PreToolUse[0].matcher == "*"' "${REPO_ROOT}/hooks/hooks.json"
   [ "$status" -eq 0 ]
@@ -116,6 +129,38 @@ setup_file() {
   [ "$status" -eq 0 ]
 }
 
+@test "hooks.json PreCompact references pre-compact-tracker for manual and auto" {
+  run jq -e '.hooks.PreCompact | length == 2' "${REPO_ROOT}/hooks/hooks.json"
+  [ "$status" -eq 0 ]
+
+  local hook_cmd
+  hook_cmd=$(jq -r '.hooks.PreCompact[0].hooks[0].command' "${REPO_ROOT}/hooks/hooks.json")
+  [[ "$hook_cmd" == *pre-compact-tracker.sh ]]
+
+  run jq -e '.hooks.PreCompact[0].matcher == "manual" and .hooks.PreCompact[1].matcher == "auto"' \
+    "${REPO_ROOT}/hooks/hooks.json"
+  [ "$status" -eq 0 ]
+
+  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 PostCompact references context-compact-tracker for manual and auto" {
+  run jq -e '.hooks.PostCompact | length == 2' "${REPO_ROOT}/hooks/hooks.json"
+  [ "$status" -eq 0 ]
+
+  local hook_cmd
+  hook_cmd=$(jq -r '.hooks.PostCompact[0].hooks[0].command' "${REPO_ROOT}/hooks/hooks.json")
+  [[ "$hook_cmd" == *context-compact-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 SessionEnd references session-end-tracker" {
   run jq -e '.hooks.SessionEnd[0].matcher == "*"' "${REPO_ROOT}/hooks/hooks.json"
   [ "$status" -eq 0 ]

package/test/fixtures/hook-inputs/post-compact-manual.json

@@ -0,0 +1,8 @@
+{
+  "session_id": "compact-session-001",
+  "transcript_path": "/tmp/compact-transcript.jsonl",
+  "cwd": "/project/repo",
+  "hook_event_name": "PostCompact",
+  "trigger": "manual",
+  "compact_summary": "The user implemented session hooks including SessionStart, SessionEnd, and UserPromptSubmit trackers for turn and duration telemetry."
+}

package/test/fixtures/hook-inputs/pre-compact-manual.json

@@ -0,0 +1,8 @@
+{
+  "session_id": "compact-session-001",
+  "transcript_path": "/tmp/compact-transcript.jsonl",
+  "cwd": "/project/repo",
+  "hook_event_name": "PreCompact",
+  "trigger": "manual",
+  "custom_instructions": "Focus on API changes"
+}

package/.github/workflows/publish-npm.yml

@@ -1,132 +0,0 @@
-name: Publish npm Package
-
-on:
-  push:
-    tags:
-      - 'v*.*.*'
-  # Manual trigger for emergency releases.
-  workflow_dispatch:
-    inputs:
-      version:
-        description: 'Version to publish (without v prefix)'
-        required: true
-        type: string
-      tag:
-        description: 'npm dist-tag (latest, beta, next)'
-        required: true
-        default: 'latest'
-        type: choice
-        options:
-          - latest
-          - beta
-          - next
-
-permissions:
-  contents: read
-  id-token: write # for npm provenance
-
-jobs:
-  validate:
-    name: Validate
-    runs-on: ubuntu-latest
-    outputs:
-      version: ${{ steps.version.outputs.value }}
-      npm_tag: ${{ steps.tag.outputs.value }}
-      is_prerelease: ${{ steps.prerelease.outputs.value }}
-    steps:
-      - uses: actions/checkout@v4
-
-      - name: Resolve version
-        id: version
-        run: |
-          if [ "${{ github.event_name }}" = "workflow_dispatch" ]; then
-            echo "value=${{ inputs.version }}" >> "$GITHUB_OUTPUT"
-          else
-            echo "value=${GITHUB_REF#refs/tags/v}" >> "$GITHUB_OUTPUT"
-          fi
-
-      - name: Resolve npm tag
-        id: tag
-        run: |
-          VERSION=${{ steps.version.outputs.value }}
-          if [ "${{ github.event_name }}" = "workflow_dispatch" ]; then
-            echo "value=${{ inputs.tag }}" >> "$GITHUB_OUTPUT"
-          elif [[ "$VERSION" == *"-beta"* ]]; then
-            echo "value=beta" >> "$GITHUB_OUTPUT"
-          elif [[ "$VERSION" == *"-rc"* ]]; then
-            echo "value=next" >> "$GITHUB_OUTPUT"
-          else
-            echo "value=latest" >> "$GITHUB_OUTPUT"
-          fi
-
-      - name: Check if prerelease
-        id: prerelease
-        run: |
-          VERSION=${{ steps.version.outputs.value }}
-          if [[ "$VERSION" == *"-"* ]]; then
-            echo "value=true" >> "$GITHUB_OUTPUT"
-          else
-            echo "value=false" >> "$GITHUB_OUTPUT"
-          fi
-
-      - name: Verify package.json version matches
-        run: |
-          PKG_VERSION=$(node -p "require('./package.json').version")
-          TAG_VERSION=${{ steps.version.outputs.value }}
-          if [ "$PKG_VERSION" != "$TAG_VERSION" ]; then
-            echo "ERROR: package.json version ($PKG_VERSION) does not match tag ($TAG_VERSION)"
-            exit 1
-          fi
-  publish:
-    name: Publish to npm
-    runs-on: ubuntu-latest
-    needs: [validate]
-    environment: npm-publish
-    steps:
-      - uses: actions/checkout@v4
-
-      - uses: actions/setup-node@v4
-        with:
-          node-version: '22'
-          registry-url: 'https://registry.npmjs.org'
-          cache: npm
-
-      - run: npm ci
-
-      - name: Publish
-        run: |
-          npm publish \
-            --tag ${{ needs.validate.outputs.npm_tag }} \
-            --access public \
-            --provenance
-        env:
-          NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}
-
-  release:
-    name: Create GitHub Release
-    runs-on: ubuntu-latest
-    needs: [validate, publish]
-    permissions:
-      contents: write
-    steps:
-      - uses: actions/checkout@v4
-
-      - name: Extract changelog entry
-        id: changelog
-        run: |
-          VERSION=${{ needs.validate.outputs.version }}
-          NOTES=$(awk "/^## \[?${VERSION}\]?/{found=1; next} found && /^## /{exit} found{print}" CHANGELOG.md)
-          if [ -z "$NOTES" ]; then
-            NOTES="See CHANGELOG.md for details."
-          fi
-          echo "notes<<EOF" >> "$GITHUB_OUTPUT"
-          echo "$NOTES" >> "$GITHUB_OUTPUT"
-          echo "EOF" >> "$GITHUB_OUTPUT"
-
-      - name: Create GitHub release
-        uses: softprops/action-gh-release@v2
-        with:
-          name: v${{ needs.validate.outputs.version }}
-          body: ${{ steps.changelog.outputs.notes }}
-          prerelease: ${{ needs.validate.outputs.is_prerelease == 'true' }}
-          draft: false