@onlooker-community/ecosystem 0.29.3 → 0.30.0

package/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "ecosystem",
-  "version": "0.29.3",
+  "version": "0.30.0",
   "description": "Observability substrate for Claude Code. Provides the shared $ONLOOKER_DIR storage root (default $HOME/.onlooker), 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,15 +1,15 @@
 {
-  ".": "0.29.3",
-  "plugins/archivist": "0.1.0",
+  ".": "0.30.0",
+  "plugins/archivist": "0.2.0",
   "plugins/tribunal": "1.0.1",
   "plugins/echo": "0.2.0",
   "plugins/cartographer": "0.2.1",
   "plugins/governor": "0.2.1",
   "plugins/compass": "0.3.0",
-  "plugins/scribe": "0.2.1",
-  "plugins/counsel": "0.3.1",
+  "plugins/scribe": "0.3.0",
+  "plugins/counsel": "0.4.0",
   "plugins/warden": "0.2.0",
-  "plugins/librarian": "0.2.0",
+  "plugins/librarian": "0.3.0",
   "plugins/curator": "0.1.0",
   "plugins/historian": "0.2.0",
   "plugins/assayer": "1.0.0",

package/CHANGELOG.md

@@ -1,5 +1,12 @@
 # Changelog
 
+## [0.30.0](https://github.com/onlooker-community/ecosystem/compare/ecosystem-v0.29.3...ecosystem-v0.30.0) (2026-06-24)
+
+
+### Features
+
+* **plugins:** persist structured JSON and emit onlooker.artifact.ready :outbox_tray: ([#103](https://github.com/onlooker-community/ecosystem/issues/103)) ([9b689a4](https://github.com/onlooker-community/ecosystem/commit/9b689a41aa4bdb481fef93b484e6446da731e8f1))
+
 ## [0.29.3](https://github.com/onlooker-community/ecosystem/compare/ecosystem-v0.29.2...ecosystem-v0.29.3) (2026-06-24)
 
 

package/package.json

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

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

@@ -1,6 +1,6 @@
 {
   "name": "archivist",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "Structured session memory across context truncation: extracts decisions, dead ends, and open questions on PreCompact and reinjects the most important items at SessionStart. Builds on the Onlooker ecosystem plugin.",
   "author": {
     "name": "Onlooker Community",

package/plugins/archivist/CHANGELOG.md

@@ -1,5 +1,12 @@
 # Changelog
 
+## [0.2.0](https://github.com/onlooker-community/ecosystem/compare/archivist-v0.1.0...archivist-v0.2.0) (2026-06-24)
+
+
+### Features
+
+* **plugins:** persist structured JSON and emit onlooker.artifact.ready :outbox_tray: ([#103](https://github.com/onlooker-community/ecosystem/issues/103)) ([9b689a4](https://github.com/onlooker-community/ecosystem/commit/9b689a41aa4bdb481fef93b484e6446da731e8f1))
+
 ## [0.1.0](https://github.com/onlooker-community/ecosystem/compare/archivist-v0.0.1...archivist-v0.1.0) (2026-05-23)
 
 

package/plugins/archivist/scripts/hooks/archivist-extract.sh

@@ -44,6 +44,8 @@ source "${PLUGIN_ROOT}/scripts/lib/archivist-ulid.sh"
 source "${PLUGIN_ROOT}/scripts/lib/archivist-storage.sh"
 # shellcheck source=../lib/archivist-config.sh
 source "${PLUGIN_ROOT}/scripts/lib/archivist-config.sh"
+# shellcheck source=../lib/archivist-events.sh
+CLAUDE_PLUGIN_ROOT="${_ECOSYSTEM_ROOT:-$PLUGIN_ROOT}" source "${PLUGIN_ROOT}/scripts/lib/archivist-events.sh"
 
 # Always approve compaction at exit, no matter what happened above.
 _approve() {
@@ -234,5 +236,37 @@ for KIND_PAIR in "decisions:decision" "dead_ends:dead_end" "open_questions:open_
 	done
 done
 
+# Write an aggregate extract JSON for the artifact browser. This is the
+# single-file representation of everything extracted this compact cycle:
+# decisions, dead ends, and open questions in one document. The session_id
+# doubles as the artifact key so the stable uuid from artifact.FromEvent
+# deduplicates re-uploads of the same session.
+if [[ "$WRITE_COUNT" -gt 0 && -n "$SESSION_ID" ]]; then
+	EXTRACTS_DIR="$(archivist_project_dir "$PROJECT_KEY")/extracts"
+	mkdir -p "$EXTRACTS_DIR" 2>/dev/null || true
+	EXTRACT_PATH="${EXTRACTS_DIR}/${SESSION_ID}.json"
+
+	AGGREGATE=$(jq -n \
+		--argjson decisions "$(printf '%s' "$CLEAN_RESPONSE" | jq '.decisions // []')" \
+		--argjson dead_ends "$(printf '%s' "$CLEAN_RESPONSE" | jq '.dead_ends // []')" \
+		--argjson open_questions "$(printf '%s' "$CLEAN_RESPONSE" | jq '.open_questions // []')" \
+		'{decisions: $decisions, dead_ends: $dead_ends, open_questions: $open_questions}') || AGGREGATE=""
+
+	if [[ -n "$AGGREGATE" ]]; then
+		printf '%s\n' "$AGGREGATE" > "$EXTRACT_PATH" 2>/dev/null || true
+
+		SESSION_SHORT="${SESSION_ID:0:8}"
+		ARTIFACT_PAYLOAD=$(jq -n \
+			--arg plugin "archivist" \
+			--arg artifact_kind "extract" \
+			--arg artifact_path "$EXTRACT_PATH" \
+			--arg artifact_title "Archivist Extract · $SESSION_SHORT" \
+			'{plugin: $plugin, artifact_kind: $artifact_kind,
+			  artifact_path: $artifact_path, artifact_title: $artifact_title}') || ARTIFACT_PAYLOAD=""
+		[[ -n "$ARTIFACT_PAYLOAD" ]] && \
+			archivist_emit_event "onlooker.artifact.ready" "$ARTIFACT_PAYLOAD" || true
+	fi
+fi
+
 _approve "Archivist: wrote ${WRITE_COUNT} artifacts (trigger=${TRIGGER})"
 exit 0

package/plugins/archivist/scripts/lib/archivist-events.sh

@@ -0,0 +1,80 @@
+#!/usr/bin/env bash
+# Canonical archivist.* event emission.
+#
+# Thin wrapper around the ecosystem plugin's onlooker-event.mjs `emit` mode.
+# Every emission is validated against @onlooker-community/schema before being
+# appended to $ONLOOKER_EVENTS_LOG (defaults to $ONLOOKER_DIR/logs/onlooker-events.jsonl).
+#
+# Usage:
+#   archivist_emit_event "onlooker.artifact.ready" \
+#     '{"plugin":"archivist","artifact_kind":"extract","artifact_path":"...","artifact_title":"..."}'
+
+_ARCHIVIST_PLUGIN_NAME="archivist"
+
+_archivist_event_js_path() {
+	if [[ -n "${_ONLOOKER_EVENT_JS:-}" && -f "$_ONLOOKER_EVENT_JS" ]]; then
+		printf '%s' "$_ONLOOKER_EVENT_JS"
+		return 0
+	fi
+	local plugin_root="${CLAUDE_PLUGIN_ROOT:-}"
+	local candidates=(
+		"${plugin_root}/scripts/lib/onlooker-event.mjs"
+		"${plugin_root}/../../scripts/lib/onlooker-event.mjs"
+	)
+	local c
+	for c in "${candidates[@]}"; do
+		[[ -f "$c" ]] && { printf '%s' "$c"; return 0; }
+	done
+	return 1
+}
+
+_archivist_session_id() {
+	if [[ -n "${_HOOK_SESSION_ID:-}" ]]; then
+		printf '%s' "$_HOOK_SESSION_ID"
+		return 0
+	fi
+	if [[ -n "${CLAUDE_SESSION_ID:-}" ]]; then
+		printf '%s' "$CLAUDE_SESSION_ID"
+		return 0
+	fi
+	printf 'unknown'
+}
+
+archivist_emit_event() {
+	local event_type="${1:-}"
+	local payload="${2:-}"
+
+	[[ -z "$event_type" || -z "$payload" ]] && return 1
+
+	local event_js
+	event_js=$(_archivist_event_js_path) || return 1
+
+	local session_id
+	session_id=$(_archivist_session_id)
+
+	local params
+	params=$(jq -n \
+		--arg plugin "$_ARCHIVIST_PLUGIN_NAME" \
+		--arg sid "$session_id" \
+		--arg type "$event_type" \
+		--argjson payload "$payload" \
+		'{plugin: $plugin, session_id: $sid, event_type: $type, payload: $payload}' \
+		2>/dev/null) || return 1
+
+	local event stderr_file
+	stderr_file=$(mktemp -t archivist-event-err.XXXXXX 2>/dev/null) || stderr_file="/tmp/archivist-event-err.$$"
+	event=$(printf '%s' "$params" \
+		| ONLOOKER_DIR="${ONLOOKER_DIR:-$HOME/.onlooker}" \
+		  ONLOOKER_PLUGIN_NAME="$_ARCHIVIST_PLUGIN_NAME" \
+		  node "$event_js" emit 2>"$stderr_file") || {
+		printf 'archivist_emit_event: schema validation failed for %s\n' "$event_type" >&2
+		[[ -s "$stderr_file" ]] && cat "$stderr_file" >&2
+		rm -f "$stderr_file"
+		return 1
+	}
+	rm -f "$stderr_file"
+
+	local log_path="${ONLOOKER_EVENTS_LOG:-${ONLOOKER_DIR:-$HOME/.onlooker}/logs/onlooker-events.jsonl}"
+	mkdir -p "$(dirname "$log_path")" 2>/dev/null || return 1
+	printf '%s\n' "$event" >> "$log_path"
+}

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

@@ -1,6 +1,6 @@
 {
   "name": "counsel",
-  "version": "0.3.1",
+  "version": "0.4.0",
   "description": "Weekly synthesis and recommendations from the full observability stack. Reads all plugin event logs, produces a structured improvement brief, and injects it at session start when the last brief is stale.",
   "author": {
     "name": "Onlooker Community",

package/plugins/counsel/CHANGELOG.md

@@ -1,5 +1,12 @@
 # Changelog
 
+## [0.4.0](https://github.com/onlooker-community/ecosystem/compare/counsel-v0.3.1...counsel-v0.4.0) (2026-06-24)
+
+
+### Features
+
+* **plugins:** persist structured JSON and emit onlooker.artifact.ready :outbox_tray: ([#103](https://github.com/onlooker-community/ecosystem/issues/103)) ([9b689a4](https://github.com/onlooker-community/ecosystem/commit/9b689a41aa4bdb481fef93b484e6446da731e8f1))
+
 ## [0.3.1](https://github.com/onlooker-community/ecosystem/compare/counsel-v0.3.0...counsel-v0.3.1) (2026-06-12)
 
 

package/plugins/counsel/scripts/lib/counsel-brief.sh

@@ -248,6 +248,18 @@ counsel_generate_brief() {
 		return 1
 	}
 
+	# Also persist structured JSON alongside the markdown so the agent can
+	# upload full brief content without re-parsing markdown.
+	local json_path="${briefs_dir}/${week_label}.json"
+	local full_brief_json
+	full_brief_json=$(printf '%s' "$brief_json" | jq \
+		--arg ps "$period_start" \
+		--arg pe "$period_end" \
+		--argjson src "$sources_json" \
+		'. + {period_start: $ps, period_end: $pe, sources_consulted: $src}' 2>/dev/null) \
+		|| full_brief_json="$brief_json"
+	printf '%s\n' "$full_brief_json" > "$json_path" 2>/dev/null || true
+
 	# Emit counsel.brief.generated.
 	local rec_count
 	rec_count=$(printf '%s' "$brief_json" | jq '.recommendations | length' 2>/dev/null) || rec_count=0
@@ -268,5 +280,16 @@ counsel_generate_brief() {
 		printf 'counsel_generate_brief: skipped counsel.brief.generated (no valid period bounds)\n' >&2
 	fi
 
+	# Emit onlooker.artifact.ready so the agent can upload the full brief content.
+	local artifact_payload
+	artifact_payload=$(jq -n \
+		--arg plugin "counsel" \
+		--arg artifact_kind "brief" \
+		--arg artifact_path "$json_path" \
+		--arg artifact_title "Counsel Brief · $week_label" \
+		'{plugin: $plugin, artifact_kind: $artifact_kind,
+		  artifact_path: $artifact_path, artifact_title: $artifact_title}') || artifact_payload=""
+	[[ -n "$artifact_payload" ]] && counsel_emit_event "onlooker.artifact.ready" "$artifact_payload" || true
+
 	printf '%s' "$output_path"
 }

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

@@ -1,6 +1,6 @@
 {
   "name": "librarian",
-  "version": "0.2.0",
+  "version": "0.3.0",
   "description": "Consolidation layer between archivist's per-session artifacts and the user's durable typed memory store. Detects which session decisions, dead-ends, and open questions deserve to live across sessions, classifies them into the user/feedback/project/reference types, and queues them as proposals for explicit confirmation. Auto-promotion is opt-in. Builds on the Onlooker ecosystem plugin.",
   "author": {
     "name": "Onlooker Community",

package/plugins/librarian/CHANGELOG.md

@@ -1,5 +1,12 @@
 # Changelog
 
+## [0.3.0](https://github.com/onlooker-community/ecosystem/compare/librarian-v0.2.0...librarian-v0.3.0) (2026-06-24)
+
+
+### Features
+
+* **plugins:** persist structured JSON and emit onlooker.artifact.ready :outbox_tray: ([#103](https://github.com/onlooker-community/ecosystem/issues/103)) ([9b689a4](https://github.com/onlooker-community/ecosystem/commit/9b689a41aa4bdb481fef93b484e6446da731e8f1))
+
 ## [0.2.0](https://github.com/onlooker-community/ecosystem/compare/librarian-v0.1.0...librarian-v0.2.0) (2026-06-04)
 
 

package/plugins/librarian/scripts/hooks/librarian-session-end.sh

@@ -265,6 +265,43 @@ for ((i = 0; i < KEPT_COUNT; i++)); do
 
 	PROPOSED_COUNT=$((PROPOSED_COUNT + 1))
 
+	# Write a flat artifact JSON for the artifact browser. The proposal file
+	# uses a nested `proposed.*` structure; this flat copy matches the web's
+	# LibrarianContent type so the dashboard can render it directly.
+	ARTIFACT_CONTENT=$(jq -n \
+		--arg type "$MEMORY_TYPE" \
+		--arg title "$TITLE" \
+		--arg body "$BODY" \
+		--argjson classifier_confidence "$CONFIDENCE" \
+		--arg conflict_state "none" \
+		--argjson source_session_ids \
+			"$(if [[ -n "$ARTIFACT_SESSION" ]]; then
+				printf '["%s"]' "$ARTIFACT_SESSION"
+			else
+				printf '[]'
+			fi)" \
+		'{type: $type, title: $title, body: $body,
+		  classifier_confidence: $classifier_confidence,
+		  conflict_state: $conflict_state,
+		  source_session_ids: $source_session_ids}') || ARTIFACT_CONTENT=""
+
+	if [[ -n "$ARTIFACT_CONTENT" ]]; then
+		ARTIFACTS_DIR="$(librarian_project_dir "$PROJECT_KEY")/artifacts"
+		mkdir -p "$ARTIFACTS_DIR" 2>/dev/null || true
+		ARTIFACT_PATH="${ARTIFACTS_DIR}/${PROPOSAL_ID}.json"
+		printf '%s\n' "$ARTIFACT_CONTENT" > "$ARTIFACT_PATH" 2>/dev/null || ARTIFACT_PATH=""
+	fi
+
+	if [[ -n "${ARTIFACT_PATH:-}" ]]; then
+		librarian_emit "onlooker.artifact.ready" "$SESSION_ID" "$(jq -cn \
+			--arg plugin "librarian" \
+			--arg artifact_kind "proposal" \
+			--arg artifact_path "$ARTIFACT_PATH" \
+			--arg artifact_title "$TITLE" \
+			'{plugin: $plugin, artifact_kind: $artifact_kind,
+			  artifact_path: $artifact_path, artifact_title: $artifact_title}')"
+	fi
+
 	librarian_emit "librarian.candidate.proposed" "$SESSION_ID" "$(jq -cn \
 		--arg proposal_id "$PROPOSAL_ID" \
 		--arg memory_type "$MEMORY_TYPE" \

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

@@ -1,6 +1,6 @@
 {
   "name": "scribe",
-  "version": "0.2.1",
+  "version": "0.3.0",
   "description": "Intent documentation from agent activity. Captures why changes were made — problem context, decisions, tradeoffs — and distills them into readable artifacts at session end.",
   "author": {
     "name": "Onlooker Community",

package/plugins/scribe/CHANGELOG.md

@@ -1,5 +1,12 @@
 # Changelog
 
+## [0.3.0](https://github.com/onlooker-community/ecosystem/compare/scribe-v0.2.1...scribe-v0.3.0) (2026-06-24)
+
+
+### Features
+
+* **plugins:** persist structured JSON and emit onlooker.artifact.ready :outbox_tray: ([#103](https://github.com/onlooker-community/ecosystem/issues/103)) ([9b689a4](https://github.com/onlooker-community/ecosystem/commit/9b689a41aa4bdb481fef93b484e6446da731e8f1))
+
 ## [0.2.1](https://github.com/onlooker-community/ecosystem/compare/scribe-v0.2.0...scribe-v0.2.1) (2026-06-04)
 
 

package/plugins/scribe/scripts/lib/scribe-distill.sh

@@ -225,6 +225,11 @@ scribe_distill() {
 		fi
 	fi
 
+	# Also persist the structured JSON alongside the markdown so the agent
+	# can upload it without re-parsing markdown.
+	local json_path="${output_dir}/${date_str}-${session_short}.json"
+	printf '%s\n' "$intent_json" > "$json_path" 2>/dev/null || true
+
 	# Emit scribe.distill.complete.
 	local payload
 	payload=$(jq -n \
@@ -235,5 +240,16 @@ scribe_distill() {
 
 	[[ -n "$payload" ]] && scribe_emit_event "scribe.distill.complete" "$payload" || true
 
+	# Emit onlooker.artifact.ready so the agent can upload the structured content.
+	local artifact_payload
+	artifact_payload=$(jq -n \
+		--arg plugin "scribe" \
+		--arg artifact_kind "intent" \
+		--arg artifact_path "$json_path" \
+		--arg artifact_title "Session Intent · $date_str" \
+		'{plugin: $plugin, artifact_kind: $artifact_kind,
+		  artifact_path: $artifact_path, artifact_title: $artifact_title}') || artifact_payload=""
+	[[ -n "$artifact_payload" ]] && scribe_emit_event "onlooker.artifact.ready" "$artifact_payload" || true
+
 	printf '%s' "$output_path"
 }