@onlooker-community/ecosystem 0.20.0 → 0.22.0

package/.claude-plugin/marketplace.json

@@ -124,6 +124,45 @@
       "license": "MIT",
       "keywords": ["security", "prompt-injection", "rule-of-two", "safety", "content-gate", "untrusted-content"],
       "tags": ["safety", "security"]
+    },
+    {
+      "name": "librarian",
+      "source": "./plugins/librarian",
+      "description": "Consolidation layer between archivist's per-session artifacts and the user's durable typed memory store. Reads archivist artifacts at SessionEnd, applies a durability filter, classifies survivors via Haiku into the four memory types (user, feedback, project, reference), and queues proposals for explicit confirmation via /librarian review. Auto-promotion is opt-in. Requires the ecosystem plugin.",
+      "author": {
+        "name": "Onlooker Community"
+      },
+      "homepage": "https://onlooker.dev",
+      "repository": "https://github.com/onlooker-community/ecosystem",
+      "license": "MIT",
+      "keywords": ["memory", "consolidation", "promotion", "classifier", "auto-memory", "session"],
+      "tags": ["memory", "context-engineering"]
+    },
+    {
+      "name": "curator",
+      "source": "./plugins/curator",
+      "description": "Maintenance layer for the typed auto-memory store. At every SessionStart, runs four cheap heuristic checks against the memories at ~/.claude/projects/<encoded>/memory/ — date_decayed (ISO-8601 dates past the grace period), path_broken (path-shaped references that don't resolve under the repo root), broken_index (MEMORY.md pointing at missing files), and orphaned_memory (files in the dir not referenced from MEMORY.md). Surfaces findings via /curator review; never edits the memory store directly. Parallel to cartographer (which audits hand-maintained instruction files), curator audits the auto-memory substrate. Requires the ecosystem plugin.",
+      "author": {
+        "name": "Onlooker Community"
+      },
+      "homepage": "https://onlooker.dev",
+      "repository": "https://github.com/onlooker-community/ecosystem",
+      "license": "MIT",
+      "keywords": ["memory", "audit", "staleness", "findings", "auto-memory", "decay"],
+      "tags": ["memory", "context-engineering"]
+    },
+    {
+      "name": "historian",
+      "source": "./plugins/historian",
+      "description": "Episodic memory layer for past Claude Code sessions. At SessionEnd, reads the session transcript, drops tool calls and tool results, chunks the remaining user + assistant turns at turn boundaries with overlap, redacts secret-shaped substrings (AWS keys, GitHub PATs, Anthropic API keys, KEY=value env assignments), and appends one JSONL line per surviving chunk to ~/.onlooker/historian/<project-key>/sessions/<session-id>.jsonl. Future-tense retrieval (vector embeddings + UserPromptSubmit similarity surfacer) lands in a follow-up; this version ships the indexing pipeline only. Requires the ecosystem plugin.",
+      "author": {
+        "name": "Onlooker Community"
+      },
+      "homepage": "https://onlooker.dev",
+      "repository": "https://github.com/onlooker-community/ecosystem",
+      "license": "MIT",
+      "keywords": ["memory", "episodic", "transcript", "indexing", "session", "retrieval"],
+      "tags": ["memory", "context-engineering"]
     }
   ]
 }

package/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "ecosystem",
-  "version": "0.20.0",
+  "version": "0.22.0",
   "description": "Observability substrate for Claude Code. Provides the shared ~/.onlooker/ storage root, canonical schema-validated event emission, session and tool tracking hooks, and prompt rules. Required by all other Onlooker plugins.",
   "author": {
     "name": "Onlooker Community",

package/.release-please-manifest.json

@@ -1,5 +1,5 @@
 {
-  ".": "0.20.0",
+  ".": "0.22.0",
   "plugins/archivist": "0.1.0",
   "plugins/tribunal": "1.0.1",
   "plugins/echo": "0.2.0",
@@ -9,5 +9,7 @@
   "plugins/scribe": "0.2.0",
   "plugins/counsel": "0.2.0",
   "plugins/warden": "0.2.0",
-  "plugins/librarian": "0.1.0"
+  "plugins/librarian": "0.1.0",
+  "plugins/curator": "0.1.0",
+  "plugins/historian": "0.1.0"
 }

package/CHANGELOG.md

@@ -1,5 +1,19 @@
 # Changelog
 
+## [0.22.0](https://github.com/onlooker-community/ecosystem/compare/ecosystem-v0.21.0...ecosystem-v0.22.0) (2026-06-04)
+
+
+### Features
+
+* **historian:** introduce SessionEnd indexing :spiral_notepad: ([#59](https://github.com/onlooker-community/ecosystem/issues/59)) ([dd6c7f6](https://github.com/onlooker-community/ecosystem/commit/dd6c7f6ea872437cab6b16de50838dfc72750c7b))
+
+## [0.21.0](https://github.com/onlooker-community/ecosystem/compare/ecosystem-v0.20.0...ecosystem-v0.21.0) (2026-06-04)
+
+
+### Features
+
+* **curator:** introduce plugin with cheap-tier checks :microscope: ([#57](https://github.com/onlooker-community/ecosystem/issues/57)) ([7f9fa18](https://github.com/onlooker-community/ecosystem/commit/7f9fa18bbde29c8b5bd1eaad185bd4c5595a3762))
+
 ## [0.20.0](https://github.com/onlooker-community/ecosystem/compare/ecosystem-v0.19.0...ecosystem-v0.20.0) (2026-06-04)
 
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@onlooker-community/ecosystem",
-  "version": "0.20.0",
+  "version": "0.22.0",
   "description": "Agents, skills, hooks, commands, rules, and MCP configurations that power [Onlooker](https://onlooker.dev)",
   "author": {
     "name": "Onlooker Community",
@@ -26,7 +26,7 @@
     "test": "npm run test:bats && npm run test:schema",
     "test:bats": "bats test/bats",
     "test:schema": "node --test test/node/*.test.mjs",
-    "test:shellcheck": "shellcheck -S error -x install.sh scripts/common.sh scripts/hooks/*.sh scripts/lib/*.sh plugins/archivist/scripts/hooks/*.sh plugins/archivist/scripts/lib/*.sh plugins/tribunal/scripts/hooks/*.sh plugins/tribunal/scripts/lib/*.sh plugins/echo/scripts/hooks/*.sh plugins/echo/scripts/lib/*.sh plugins/governor/scripts/hooks/*.sh plugins/governor/scripts/lib/*.sh plugins/compass/scripts/hooks/*.sh plugins/compass/scripts/lib/*.sh plugins/scribe/scripts/hooks/*.sh plugins/scribe/scripts/lib/*.sh plugins/counsel/scripts/hooks/*.sh plugins/counsel/scripts/lib/*.sh plugins/warden/scripts/hooks/*.sh plugins/warden/scripts/lib/*.sh plugins/librarian/scripts/hooks/*.sh plugins/librarian/scripts/lib/*.sh",
+    "test:shellcheck": "shellcheck -S error -x install.sh scripts/common.sh scripts/hooks/*.sh scripts/lib/*.sh plugins/archivist/scripts/hooks/*.sh plugins/archivist/scripts/lib/*.sh plugins/tribunal/scripts/hooks/*.sh plugins/tribunal/scripts/lib/*.sh plugins/echo/scripts/hooks/*.sh plugins/echo/scripts/lib/*.sh plugins/governor/scripts/hooks/*.sh plugins/governor/scripts/lib/*.sh plugins/compass/scripts/hooks/*.sh plugins/compass/scripts/lib/*.sh plugins/scribe/scripts/hooks/*.sh plugins/scribe/scripts/lib/*.sh plugins/counsel/scripts/hooks/*.sh plugins/counsel/scripts/lib/*.sh plugins/warden/scripts/hooks/*.sh plugins/warden/scripts/lib/*.sh plugins/librarian/scripts/hooks/*.sh plugins/librarian/scripts/lib/*.sh plugins/curator/scripts/hooks/*.sh plugins/curator/scripts/lib/*.sh plugins/historian/scripts/hooks/*.sh plugins/historian/scripts/lib/*.sh",
     "lint:references": "node scripts/lint/check-references.mjs",
     "lint:manifests": "node scripts/lint/check-manifests.mjs",
     "coverage:node": "node scripts/coverage/run-coverage.mjs",

package/plugins/curator/.claude-plugin/plugin.json

@@ -0,0 +1,14 @@
+{
+  "name": "curator",
+  "version": "0.1.0",
+  "description": "Maintenance layer for the user's typed auto-memory store. At every SessionStart, runs four cheap heuristic checks (date_decayed, path_broken, broken_index, orphaned_memory) against the memories at ~/.claude/projects/<encoded>/memory/ inside a wall-clock budget. Surfaces findings as a one-line pointer to /curator review; never edits the memory store directly. Builds on the Onlooker ecosystem plugin.",
+  "author": {
+    "name": "Onlooker Community",
+    "url": "https://onlooker.dev"
+  },
+  "homepage": "https://onlooker.dev",
+  "repository": "https://github.com/onlooker-community/ecosystem",
+  "license": "MIT",
+  "skills": [],
+  "agents": []
+}

package/plugins/curator/CHANGELOG.md

@@ -0,0 +1,10 @@
+# Changelog
+
+## [0.1.0](https://github.com/onlooker-community/ecosystem/compare/curator-v0.0.1...curator-v0.1.0) (2026-06-04)
+
+
+### Features
+
+* **curator:** introduce plugin with cheap-tier checks :microscope: ([#57](https://github.com/onlooker-community/ecosystem/issues/57)) ([7f9fa18](https://github.com/onlooker-community/ecosystem/commit/7f9fa18bbde29c8b5bd1eaad185bd4c5595a3762))
+
+## Changelog

package/plugins/curator/README.md

@@ -0,0 +1,55 @@
+# Curator
+
+Maintenance layer for the user's typed auto-memory store.
+
+At every `SessionStart`, Curator runs cheap heuristic checks against the memories at `~/.claude/projects/<encoded-project>/memory/` — stale ISO-8601 dates past the grace period, broken path references, broken `MEMORY.md` index entries, and orphaned memory files — and surfaces findings as a one-line pointer to `/curator review`. Curator never edits the memory store directly.
+
+The weekly LLM-backed contradiction sweep described in [`docs/design.md`](docs/design.md) is a future capability — see the **Status** section below for what's actually shipped today.
+
+Curator is a sibling plugin to [`ecosystem`](../../) and assumes the Onlooker observability substrate (`~/.onlooker/`) is present. It is parallel to [`cartographer`](../cartographer) (which audits hand-maintained instruction files like `CLAUDE.md`) — same audit shape, different substrate.
+
+## How it works
+
+| Hook | What Curator does |
+|------|---------------------|
+| `SessionStart` | Runs the four cheap-tier checks (date_decayed, path_broken, broken_index, orphaned_memory) against the memory store, inside a wall-clock budget (`cheap_checks.wall_clock_budget_ms`, default 500ms). Writes new findings under `~/.onlooker/curator/<project-key>/findings/` keyed by ULID, deduping repeat findings via `deduped_hash`. Injects a one-line `additionalContext` pointer when open findings exist. |
+
+## Activation
+
+Curator is **off by default**. Enable per-project in `.claude/settings.json`:
+
+```json
+{
+  "curator": {
+    "enabled": true
+  }
+}
+```
+
+Or globally in `~/.claude/settings.json`. See [`config.json`](config.json) for the full set of tunable defaults.
+
+## Storage layout
+
+```text
+~/.onlooker/curator/<project-key>/
+├── manifest.json                    # project metadata
+├── last_llm_sweep.json              # watermark for the weekly LLM pass
+├── last_cheap_scan.json             # watermark for the per-session check
+└── findings/<ulid>.json             # one finding per file
+```
+
+## Status
+
+This plugin ships **scaffolding + four cheap-tier checks (date_decayed, path_broken, broken_index, orphaned_memory) + SessionStart surfacer**. Deferred to follow-up landings:
+
+- **LLM contradiction sweep** — design and the watermark plumbing (`last_llm_sweep.json`) are in place; the Haiku pair-evaluation loop is not implemented. `llm_sweep.enabled` defaults to `false` and is a no-op until the sweep ships.
+- **`/curator review` interactive walkthrough** — accept / prune / edit / reclassify / acknowledge / defer for surfaced findings.
+- **Usage tracker** (zero-recall-window findings) — depends on a substrate-level `memory.recalled` emitter that doesn't exist yet. `usage_tracker.enabled` defaults to `false`; see [`docs/design.md`](docs/design.md) Open Question #1.
+- **Symbol reference check** — backtick-wrapped identifiers grep'd against the repo. Not yet wired.
+
+## Requirements
+
+- The `ecosystem` plugin installed (for `~/.onlooker/` substrate).
+- `jq` for JSON manipulation.
+- `python3` for date math and path resolution.
+- `git` to resolve the project key and (for the reference check) the repo root.

package/plugins/curator/config.json

@@ -0,0 +1,41 @@
+{
+  "plugin_name": "curator",
+  "storage_path": "~/.onlooker",
+  "curator": {
+    "enabled": false,
+    "memory_store_path": "${HOME}/.claude/projects/${CLAUDE_PROJECT_ENCODED}/memory",
+    "cheap_checks": {
+      "enabled": true,
+      "wall_clock_budget_ms": 500,
+      "skip_if_session_age_under_seconds": 5
+    },
+    "date_check": {
+      "enabled": true,
+      "date_grace_period_days": 14
+    },
+    "reference_check": {
+      "enabled": true,
+      "check_urls": false,
+      "url_allowlist": []
+    },
+    "usage_tracker": {
+      "enabled": false,
+      "usage_window_days": 30,
+      "_note": "Disabled until the substrate memory.recalled emitter ships. Setting to true today is a no-op."
+    },
+    "llm_sweep": {
+      "enabled": false,
+      "_note": "Disabled until the Haiku pair-evaluation loop ships. Setting to true today is a no-op.",
+      "model": "claude-haiku-4-5-20251001",
+      "temperature": 0.2,
+      "max_output_tokens": 96,
+      "interval_days": 7,
+      "max_pair_evaluations_per_sweep": 50,
+      "contradiction_similarity_threshold": 0.4
+    },
+    "surfacer": {
+      "max_pointer_chars": 200,
+      "skip_when_zero": true
+    }
+  }
+}

package/plugins/curator/hooks/hooks.json

@@ -0,0 +1,15 @@
+{
+  "hooks": {
+    "SessionStart": [
+      {
+        "matcher": "*",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "\"$CLAUDE_PLUGIN_ROOT\"/scripts/hooks/curator-session-start.sh"
+          }
+        ]
+      }
+    ]
+  }
+}

package/plugins/curator/scripts/hooks/curator-session-start.sh

@@ -0,0 +1,343 @@
+#!/usr/bin/env bash
+# Curator SessionStart hook.
+#
+# Runs cheap-tier checks against the typed memory store and emits findings
+# under ~/.onlooker/curator/<project-key>/findings/. Surfaces a one-line
+# pointer to /curator review when open findings exist.
+#
+# Hook contract:
+#   - Always exits 0. Never blocks session start.
+#   - Emits valid hookSpecificOutput JSON even when nothing to inject.
+#   - No-ops when curator.enabled is not true.
+#   - No-ops when no git context, no memory store path, or no checks pass
+#     the rate gate.
+#
+# LLM contradiction sweep is deferred to a follow-up commit.
+
+set -uo pipefail
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+PLUGIN_ROOT="$(cd "${SCRIPT_DIR}/../.." && pwd)"
+
+_ECOSYSTEM_ROOT="${ONLOOKER_ECOSYSTEM_ROOT:-}"
+if [[ -z "$_ECOSYSTEM_ROOT" ]]; then
+	_candidate="$(cd "${PLUGIN_ROOT}/../.." 2>/dev/null && pwd)"
+	if [[ -f "${_candidate}/scripts/lib/validate-path.sh" ]]; then
+		_ECOSYSTEM_ROOT="$_candidate"
+	fi
+fi
+if [[ -n "$_ECOSYSTEM_ROOT" && -f "${_ECOSYSTEM_ROOT}/scripts/lib/validate-path.sh" ]]; then
+	# shellcheck disable=SC1091
+	CLAUDE_PLUGIN_ROOT="$_ECOSYSTEM_ROOT" source "${_ECOSYSTEM_ROOT}/scripts/lib/validate-path.sh"
+fi
+
+# shellcheck source=../lib/curator-config.sh
+source "${PLUGIN_ROOT}/scripts/lib/curator-config.sh"
+# shellcheck source=../lib/curator-project-key.sh
+source "${PLUGIN_ROOT}/scripts/lib/curator-project-key.sh"
+# shellcheck source=../lib/curator-ulid.sh
+source "${PLUGIN_ROOT}/scripts/lib/curator-ulid.sh"
+# shellcheck source=../lib/curator-storage.sh
+source "${PLUGIN_ROOT}/scripts/lib/curator-storage.sh"
+# shellcheck source=../lib/curator-emit.sh
+source "${PLUGIN_ROOT}/scripts/lib/curator-emit.sh"
+# shellcheck source=../lib/curator-memory-reader.sh
+source "${PLUGIN_ROOT}/scripts/lib/curator-memory-reader.sh"
+# shellcheck source=../lib/curator-checks.sh
+source "${PLUGIN_ROOT}/scripts/lib/curator-checks.sh"
+
+_emit() {
+	local context="${1:-}"
+	jq -cn --arg ctx "$context" '{
+		hookSpecificOutput: {
+			hookEventName: "SessionStart",
+			additionalContext: $ctx
+		}
+	}'
+}
+
+INPUT=$(cat 2>/dev/null || true)
+CWD=$(printf '%s' "$INPUT" | jq -r '.cwd // ""' 2>/dev/null) || CWD=""
+SESSION_ID=$(printf '%s' "$INPUT" | jq -r '.session_id // ""' 2>/dev/null) || SESSION_ID=""
+[[ -z "$CWD" ]] && CWD="$(pwd)"
+[[ -z "$SESSION_ID" ]] && SESSION_ID="unknown"
+
+REPO_ROOT=$(curator_project_repo_root "$CWD")
+curator_config_load "$REPO_ROOT"
+
+if ! curator_config_enabled; then
+	_emit ""
+	exit 0
+fi
+
+PROJECT_KEY=$(curator_project_key "$CWD")
+if [[ -z "$PROJECT_KEY" ]]; then
+	_emit ""
+	exit 0
+fi
+
+curator_storage_init "$PROJECT_KEY" || { _emit ""; exit 0; }
+REMOTE_URL=$(curator_project_remote_url "$CWD")
+curator_storage_write_manifest "$PROJECT_KEY" "$REMOTE_URL" "$REPO_ROOT" || true
+
+# ----------------------------------------------------------------------------
+# Resolve the typed memory store path. Skip the audit if it can't be resolved.
+# ----------------------------------------------------------------------------
+
+MEM_PATH_TEMPLATE=$(curator_config_get '.curator.memory_store_path')
+if [[ -z "$MEM_PATH_TEMPLATE" || "$MEM_PATH_TEMPLATE" == "null" ]]; then
+	MEM_PATH_TEMPLATE='${HOME}/.claude/projects/${CLAUDE_PROJECT_ENCODED}/memory'
+fi
+MEM_DIR=$(curator_memory_resolve_path "$MEM_PATH_TEMPLATE")
+
+if [[ -z "$MEM_DIR" || ! -d "$MEM_DIR" ]]; then
+	# No memory store, nothing to audit. Still emit a scan event so the
+	# observability stream shows curator ran.
+	curator_emit "curator.scan.started" "$SESSION_ID" "$(jq -cn '{ mode: "cheap" }')"
+	curator_emit "curator.scan.complete" "$SESSION_ID" "$(jq -cn '{
+		mode: "cheap", outcome: "ok",
+		findings_new: 0, findings_resolved: 0, duration_ms: 0
+	}')"
+	_emit ""
+	exit 0
+fi
+
+# ----------------------------------------------------------------------------
+# Cheap-tier rate gate.
+#
+# Three knobs:
+#   cheap_checks.enabled            global on/off for the cheap tier
+#   cheap_checks.wall_clock_budget_ms   abort phases past this elapsed
+#   surfacer.max_pointer_chars      truncate additionalContext at this
+# ----------------------------------------------------------------------------
+
+CHEAP_ENABLED=$(curator_config_get '.curator.cheap_checks.enabled')
+SCAN_START_MS=$(python3 -c 'import time; print(int(time.time() * 1000))' 2>/dev/null) \
+	|| SCAN_START_MS=$(($(date +%s) * 1000))
+SCAN_START_S=$((SCAN_START_MS / 1000))
+
+curator_emit "curator.scan.started" "$SESSION_ID" "$(jq -cn '{ mode: "cheap" }')"
+
+if [[ "$CHEAP_ENABLED" == "false" ]]; then
+	# Cheap tier explicitly off — emit scan.complete with skip_reason
+	# and skip straight to the surfacer (which reads previously-persisted
+	# findings, if any).
+	curator_emit "curator.scan.complete" "$SESSION_ID" "$(jq -cn \
+		--arg mode "cheap" --arg outcome "skipped" \
+		--arg skip_reason "disabled" \
+		--argjson findings_new 0 --argjson findings_resolved 0 \
+		--argjson duration_ms 0 \
+		'{ mode: $mode, outcome: $outcome, skip_reason: $skip_reason,
+		   findings_new: $findings_new, findings_resolved: $findings_resolved,
+		   duration_ms: $duration_ms }')"
+	FINDINGS_NEW=0
+	# Skip the per-check pipeline; fall through to the surfacer.
+	OUTCOME_FOR_SCAN_COMPLETE="skipped"
+else
+	OUTCOME_FOR_SCAN_COMPLETE="ok"
+fi
+
+BUDGET_MS=$(curator_config_get '.curator.cheap_checks.wall_clock_budget_ms')
+[[ -z "$BUDGET_MS" || "$BUDGET_MS" == "null" ]] && BUDGET_MS=500
+
+_curator_now_ms() {
+	python3 -c 'import time; print(int(time.time() * 1000))' 2>/dev/null \
+		|| echo "$(( $(date +%s) * 1000 ))"
+}
+
+_curator_over_budget() {
+	local now elapsed
+	now=$(_curator_now_ms)
+	elapsed=$((now - SCAN_START_MS))
+	(( elapsed > BUDGET_MS ))
+}
+
+# When the cheap tier is enabled, run the four checks under the budget
+# gate. Each phase checks the budget BEFORE its work — partial phases
+# are allowed to finish since check work itself is cheap.
+DATE_FINDINGS='[]'
+PATH_FINDINGS='[]'
+BROKEN_INDEX='[]'
+ORPHANED='[]'
+BUDGET_TRIPPED="false"
+MEMORIES='[]'
+
+if [[ "$CHEAP_ENABLED" != "false" ]]; then
+	if _curator_over_budget; then
+		BUDGET_TRIPPED="true"
+	else
+		MEMORIES=$(curator_memory_load_all "$MEM_DIR")
+	fi
+
+	DATE_GRACE=$(curator_config_get '.curator.date_check.date_grace_period_days')
+	[[ -z "$DATE_GRACE" || "$DATE_GRACE" == "null" ]] && DATE_GRACE=14
+	DATE_CHECK_ENABLED=$(curator_config_get '.curator.date_check.enabled')
+
+	if [[ "$BUDGET_TRIPPED" != "true" && "$DATE_CHECK_ENABLED" != "false" ]]; then
+		if _curator_over_budget; then
+			BUDGET_TRIPPED="true"
+		else
+			DATE_FINDINGS=$(curator_check_dates "$MEMORIES" "$DATE_GRACE") || DATE_FINDINGS='[]'
+		fi
+	fi
+
+	REF_CHECK_ENABLED=$(curator_config_get '.curator.reference_check.enabled')
+	if [[ "$BUDGET_TRIPPED" != "true" && "$REF_CHECK_ENABLED" != "false" && -n "$REPO_ROOT" ]]; then
+		if _curator_over_budget; then
+			BUDGET_TRIPPED="true"
+		else
+			PATH_FINDINGS=$(curator_check_paths "$MEMORIES" "$REPO_ROOT") || PATH_FINDINGS='[]'
+		fi
+	fi
+
+	if [[ "$BUDGET_TRIPPED" != "true" ]]; then
+		if _curator_over_budget; then
+			BUDGET_TRIPPED="true"
+		else
+			BROKEN_INDEX=$(curator_check_broken_index "$MEMORIES")
+			ORPHANED=$(curator_check_orphaned "$MEMORIES")
+		fi
+	fi
+fi
+
+# ----------------------------------------------------------------------------
+# Persist findings (with dedup by deduped_hash) and emit per-finding events.
+# Skipped entirely when the cheap tier is disabled — the disabled path above
+# already emitted scan.complete and set FINDINGS_NEW=0.
+# ----------------------------------------------------------------------------
+
+NOW_TS=$(date -u +"%Y-%m-%dT%H:%M:%SZ")
+[[ "$CHEAP_ENABLED" == "false" ]] || FINDINGS_NEW=0
+
+_write_finding() {
+	local kind="$1"
+	local payload="$2"
+	local hash_input
+	hash_input="${kind}|$(printf '%s' "$payload" | jq -cS '.')"
+	local hash
+	hash=$(curator_finding_hash "$hash_input") || hash=""
+	[[ -z "$hash" ]] && return 0
+
+	# Dedup: skip if an open finding with the same hash already exists.
+	if curator_storage_has_finding_with_hash "$PROJECT_KEY" "$hash"; then
+		return 0
+	fi
+
+	local id record
+	id=$(curator_ulid)
+	record=$(jq -n \
+		--arg id "$id" \
+		--arg kind "$kind" \
+		--arg created_at "$NOW_TS" \
+		--arg deduped_hash "$hash" \
+		--argjson detail "$payload" \
+		'{
+			id: $id, kind: $kind, created_at: $created_at,
+			status: "open", deduped_hash: $deduped_hash, detail: $detail
+		}')
+	curator_storage_write_finding "$PROJECT_KEY" "$id" "$record" >/dev/null || return 0
+	FINDINGS_NEW=$((FINDINGS_NEW + 1))
+
+	# Per-kind event payload.
+	local event_type event_payload
+	event_type="curator.finding.${kind}"
+	event_payload=$(jq -cn --arg fid "$id" --argjson detail "$payload" \
+		'{ finding_id: $fid } + $detail')
+	curator_emit "$event_type" "$SESSION_ID" "$event_payload"
+}
+
+# Convert each finding-array entry into a stored + emitted finding.
+_emit_kind_findings() {
+	local kind="$1" findings_json="$2"
+	local n
+	n=$(printf '%s' "$findings_json" | jq 'length' 2>/dev/null) || n=0
+	local i payload
+	for ((i = 0; i < n; i++)); do
+		payload=$(printf '%s' "$findings_json" | jq -c ".[$i]")
+		[[ -z "$payload" || "$payload" == "null" ]] && continue
+		_write_finding "$kind" "$payload"
+	done
+}
+
+if [[ "$CHEAP_ENABLED" != "false" ]]; then
+	_emit_kind_findings "date_decayed" "$DATE_FINDINGS"
+	_emit_kind_findings "path_broken" "$PATH_FINDINGS"
+	_emit_kind_findings "broken_index" "$BROKEN_INDEX"
+	_emit_kind_findings "orphaned_memory" "$ORPHANED"
+fi
+
+# ----------------------------------------------------------------------------
+# Watermark + scan.complete. The disabled-tier branch above already emitted
+# scan.complete; this branch fires only when the cheap tier ran (success or
+# budget tripped).
+# ----------------------------------------------------------------------------
+
+if [[ "$CHEAP_ENABLED" != "false" ]]; then
+	curator_storage_write_watermark "$(curator_last_cheap_scan_path "$PROJECT_KEY")" || true
+
+	DURATION_MS=$(( $(_curator_now_ms) - SCAN_START_MS ))
+	if [[ "$BUDGET_TRIPPED" == "true" ]]; then
+		curator_emit "curator.scan.complete" "$SESSION_ID" "$(jq -cn \
+			--arg mode "cheap" --arg outcome "skipped" \
+			--arg skip_reason "over_budget" \
+			--argjson findings_new "$FINDINGS_NEW" \
+			--argjson findings_resolved 0 \
+			--argjson duration_ms "$DURATION_MS" \
+			'{ mode: $mode, outcome: $outcome, skip_reason: $skip_reason,
+			   findings_new: $findings_new,
+			   findings_resolved: $findings_resolved,
+			   duration_ms: $duration_ms }')"
+	else
+		curator_emit "curator.scan.complete" "$SESSION_ID" "$(jq -cn \
+			--arg mode "cheap" --arg outcome "ok" \
+			--argjson findings_new "$FINDINGS_NEW" \
+			--argjson findings_resolved 0 \
+			--argjson duration_ms "$DURATION_MS" \
+			'{ mode: $mode, outcome: $outcome,
+			   findings_new: $findings_new,
+			   findings_resolved: $findings_resolved,
+			   duration_ms: $duration_ms }')"
+	fi
+fi
+
+# ----------------------------------------------------------------------------
+# Surfacer.
+# ----------------------------------------------------------------------------
+
+SKIP_WHEN_ZERO=$(curator_config_get '.curator.surfacer.skip_when_zero')
+[[ -z "$SKIP_WHEN_ZERO" || "$SKIP_WHEN_ZERO" == "null" ]] && SKIP_WHEN_ZERO="true"
+
+OPEN_COUNT=$(curator_storage_count_open "$PROJECT_KEY")
+[[ -z "$OPEN_COUNT" || "$OPEN_COUNT" == "null" ]] && OPEN_COUNT=0
+
+if [[ "$OPEN_COUNT" -eq 0 && "$SKIP_WHEN_ZERO" == "true" ]]; then
+	_emit ""
+	exit 0
+fi
+
+# Build a compact "2 path-broken, 1 date-decayed" descriptor for the
+# pointer message.
+COUNTS_BY_KIND=$(curator_storage_open_counts_by_kind "$PROJECT_KEY")
+SUMMARY=$(printf '%s' "$COUNTS_BY_KIND" | jq -r '
+	map( (.count|tostring) + " " + (.kind | gsub("_"; "-")) )
+	| join(", ")
+')
+
+CONTEXT=$(printf 'Curator: %s open finding%s (%s). Review with `/curator review`.' \
+	"$OPEN_COUNT" \
+	"$([ "$OPEN_COUNT" -eq 1 ] && echo "" || echo "s")" \
+	"$SUMMARY")
+
+# Cap the pointer length so a long per-kind summary never overflows the
+# user's SessionStart context.
+MAX_POINTER=$(curator_config_get '.curator.surfacer.max_pointer_chars')
+[[ -z "$MAX_POINTER" || "$MAX_POINTER" == "null" ]] && MAX_POINTER=200
+if [[ "${#CONTEXT}" -gt "$MAX_POINTER" ]]; then
+	# Reserve room for the truncation ellipsis without exceeding the cap.
+	TRUNC=$((MAX_POINTER - 1))
+	(( TRUNC < 1 )) && TRUNC=1
+	CONTEXT="${CONTEXT:0:TRUNC}…"
+fi
+
+_emit "$CONTEXT"
+exit 0