@onlooker-community/ecosystem 0.31.1 → 0.32.1

package/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "ecosystem",
-  "version": "0.31.1",
+  "version": "0.32.1",
   "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,5 +1,5 @@
 {
-  ".": "0.31.1",
+  ".": "0.32.1",
   "plugins/archivist": "0.3.1",
   "plugins/tribunal": "1.1.1",
   "plugins/echo": "0.3.1",
@@ -9,11 +9,11 @@
   "plugins/scribe": "0.4.1",
   "plugins/counsel": "0.5.1",
   "plugins/warden": "0.3.1",
-  "plugins/librarian": "0.4.1",
+  "plugins/librarian": "0.6.0",
   "plugins/curator": "0.2.1",
-  "plugins/historian": "0.3.1",
+  "plugins/historian": "0.3.2",
   "plugins/assayer": "1.1.1",
-  "plugins/bursar": "0.2.1",
+  "plugins/bursar": "0.2.2",
   "plugins/lineage": "0.2.1",
   "plugins/inspector": "0.3.1"
 }

package/CHANGELOG.md

@@ -1,5 +1,94 @@
 # Changelog
 
+## [0.32.1](https://github.com/onlooker-community/ecosystem/compare/ecosystem-v0.32.0...ecosystem-v0.32.1) (2026-08-02)
+
+
+### Bug Fixes
+
+* librarian conflict detection + bursar rollup lock timeout ([#117](https://github.com/onlooker-community/ecosystem/issues/117)) ([16180a2](https://github.com/onlooker-community/ecosystem/commit/16180a210a6f0561c09b77a2b102849f63f1e730))
+
+## [0.32.0](https://github.com/onlooker-community/ecosystem/compare/ecosystem-v0.31.2...ecosystem-v0.32.0) (2026-08-02)
+
+
+### Features
+
+* add configuration and hooks for agent spawn tracking ([3ef4590](https://github.com/onlooker-community/ecosystem/commit/3ef459006bbbda246604bdd1ffaf9af0a59f9740))
+* add settings.json for plugin configuration ([67fbdfe](https://github.com/onlooker-community/ecosystem/commit/67fbdfe37f067a45801e7d0355c4a533b687f6b2))
+* **archivist:** introduce structured session memory plugin :rocket: ([378fff3](https://github.com/onlooker-community/ecosystem/commit/378fff3c14b40644af45b1a2335992e7b0428160))
+* **assayer:** introduce claim-verification plugin ([#70](https://github.com/onlooker-community/ecosystem/issues/70)) ([1d0500b](https://github.com/onlooker-community/ecosystem/commit/1d0500b64f8cd670d1cfa1ac070182d72696bdfd))
+* **bursar:** introduce multi-session budget rollup plugin ([#81](https://github.com/onlooker-community/ecosystem/issues/81)) ([b11e687](https://github.com/onlooker-community/ecosystem/commit/b11e687744bab70a94025c46c4aaa58fb7ea97f4))
+* **cartographer:** add proactive instruction-file audit plugin :mag: ([#35](https://github.com/onlooker-community/ecosystem/issues/35)) ([387d00a](https://github.com/onlooker-community/ecosystem/commit/387d00ad04da5aae91048254ad0526bb674ed498))
+* **compass:** pre-write intent clarity gate plugin :compass: ([#47](https://github.com/onlooker-community/ecosystem/issues/47)) ([144c2ef](https://github.com/onlooker-community/ecosystem/commit/144c2ef44d28bab3dcec14a9eace7ec76470d090))
+* **counsel:** add /counsel on-demand weekly-review command :rocket: ([#76](https://github.com/onlooker-community/ecosystem/issues/76)) ([8ce951c](https://github.com/onlooker-community/ecosystem/commit/8ce951cd5cb7b173f194f86c2960a31fb0d6889d))
+* **counsel:** weekly observability synthesis and coaching brief :robot: ([#51](https://github.com/onlooker-community/ecosystem/issues/51)) ([6364586](https://github.com/onlooker-community/ecosystem/commit/63645863cf3a1d7bbf0353aacb9b71e4f977dd56))
+* **coverage:** report node + bash coverage on every PR :sparkles: ([cb5d122](https://github.com/onlooker-community/ecosystem/commit/cb5d1221ad20e6257d66b507897dae14549a870f))
+* **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))
+* **echo:** add prompt regression detection plugin ([#32](https://github.com/onlooker-community/ecosystem/issues/32)) ([65274d4](https://github.com/onlooker-community/ecosystem/commit/65274d4d8326950d6c998ca292fed13b1b8c493b))
+* **ecosystem:** emit memory.recalled at SessionStart :link: ([#62](https://github.com/onlooker-community/ecosystem/issues/62)) ([d5876f9](https://github.com/onlooker-community/ecosystem/commit/d5876f9f819165cc07d691d733662b549863b7f5))
+* **governor:** resource governance and budget enforcement plugin :rocket: ([#43](https://github.com/onlooker-community/ecosystem/issues/43)) ([04e6d70](https://github.com/onlooker-community/ecosystem/commit/04e6d7051f27db752bb121d389d65b4d8ade04ad))
+* **historian:** introduce SessionEnd indexing :spiral_notepad: ([#59](https://github.com/onlooker-community/ecosystem/issues/59)) ([dd6c7f6](https://github.com/onlooker-community/ecosystem/commit/dd6c7f6ea872437cab6b16de50838dfc72750c7b))
+* **historian:** retrieval pipeline + ollama embedder :telescope: ([#61](https://github.com/onlooker-community/ecosystem/issues/61)) ([7eae752](https://github.com/onlooker-community/ecosystem/commit/7eae752a288c4678ab093042469f2e65d428f0d9))
+* **hooks:** add PreCompact and PostCompact context compaction trackers ([#15](https://github.com/onlooker-community/ecosystem/issues/15)) ([1ec5632](https://github.com/onlooker-community/ecosystem/commit/1ec5632404676ed8b35d324b79ad71a2e9093505))
+* **hooks:** add SessionStart and SessionEnd session trackers ([#10](https://github.com/onlooker-community/ecosystem/issues/10)) ([a48d680](https://github.com/onlooker-community/ecosystem/commit/a48d680dd24c98e79ef1c0401b07483ecebf9e8b))
+* **hooks:** add TaskCreated and TaskCompleted task lifecycle trackers ([#21](https://github.com/onlooker-community/ecosystem/issues/21)) ([986ffa8](https://github.com/onlooker-community/ecosystem/commit/986ffa84bdd857a464ca0d556671628190ed27bc))
+* **hooks:** add UserPromptSubmit turn and session duration trackers ([#12](https://github.com/onlooker-community/ecosystem/issues/12)) ([cbb7657](https://github.com/onlooker-community/ecosystem/commit/cbb7657979ed144efce506e6b487e037679b9462))
+* **hooks:** add WorktreeCreate and WorktreeRemove lifecycle trackers ([#24](https://github.com/onlooker-community/ecosystem/issues/24)) ([ff55e39](https://github.com/onlooker-community/ecosystem/commit/ff55e397a0c0adc3e76f66aba12c6b237149ad17))
+* **hooks:** emit canonical schema events for tool history :sparkles: ([1e49a24](https://github.com/onlooker-community/ecosystem/commit/1e49a24bfb930942fa477b594395ef352618f574))
+* **hooks:** enrich tool.file.read with read chunking observability ([#25](https://github.com/onlooker-community/ecosystem/issues/25)) ([8eb23c8](https://github.com/onlooker-community/ecosystem/commit/8eb23c8f4f03dfbeb701a30de1fa50c1c8ee48ac))
+* **hooks:** track skill usage via skill.invoked events ([23fff0f](https://github.com/onlooker-community/ecosystem/commit/23fff0f0bfad8ab91788d8c45a0457d099d2e870))
+* **hooks:** track tool call sequence on every PreToolUse :sparkles: ([0ad9546](https://github.com/onlooker-community/ecosystem/commit/0ad95465cc22a237e26115a67814a6e7b2951b1d))
+* **inspector:** ship the per-edit lint/typecheck plugin ([#88](https://github.com/onlooker-community/ecosystem/issues/88)) ([2018243](https://github.com/onlooker-community/ecosystem/commit/201824384abd6a4fc5f4395266924aa413a2ffd1))
+* **librarian:** /librarian review skill closes promotion loop :tada: ([#68](https://github.com/onlooker-community/ecosystem/issues/68)) ([8f3e3db](https://github.com/onlooker-community/ecosystem/commit/8f3e3dbdf6f08dceb0cf61d46281936a4f9954de))
+* **librarian:** implement conflict detection for memory promotion scanning ([#115](https://github.com/onlooker-community/ecosystem/issues/115)) ([8699577](https://github.com/onlooker-community/ecosystem/commit/86995773cb44127d915b5aea53aed66c771d8bfb))
+* **librarian:** land plugin end-to-end with memory layer designs :seedling: ([#55](https://github.com/onlooker-community/ecosystem/issues/55)) ([d4821ef](https://github.com/onlooker-community/ecosystem/commit/d4821efabfeb587e460e898d7db8f92fcc3f2c61))
+* **lineage:** introduce per-change provenance plugin ([#83](https://github.com/onlooker-community/ecosystem/issues/83)) ([86b00d3](https://github.com/onlooker-community/ecosystem/commit/86b00d3d7393e2b63c5b04d60692fc89f202bf6c))
+* **lint:** add marketplace cross-reference linter :nail_care: ([0f48817](https://github.com/onlooker-community/ecosystem/commit/0f488170326659ef1d0b8bd7ae4d207c78a43694))
+* **lint:** add plugin manifest validator :nail_care: ([e12615f](https://github.com/onlooker-community/ecosystem/commit/e12615ff99d43caf59d5e215d882c0acb3352c01))
+* **plugins:** installation enables plugins — remove per-plugin 'enabled' config key ([#108](https://github.com/onlooker-community/ecosystem/issues/108)) ([45e4e6b](https://github.com/onlooker-community/ecosystem/commit/45e4e6bd29a0a7545dbd5007bf3f09600e1be391))
+* **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))
+* **prompt-rules:** deterministic regex-triggered guidance injection :relieved: ([#28](https://github.com/onlooker-community/ecosystem/issues/28)) ([662c811](https://github.com/onlooker-community/ecosystem/commit/662c8119657cebc350900f859c43dbaca97d6703))
+* **scribe:** intent documentation from agent activity :pencil2: ([#50](https://github.com/onlooker-community/ecosystem/issues/50)) ([f0a95d1](https://github.com/onlooker-community/ecosystem/commit/f0a95d1058e36d1bb5f0f645964d9e88e8f98b66))
+* **tribunal:** add multi-agent code review plugin :sparkles: ([#30](https://github.com/onlooker-community/ecosystem/issues/30)) ([893f24a](https://github.com/onlooker-community/ecosystem/commit/893f24a8876fdd6ccb5c7dcf2636a7c902e88949))
+* **warden:** untrusted-content gate enforcing the Agents Rule of Two :shield: ([#53](https://github.com/onlooker-community/ecosystem/issues/53)) ([210aa51](https://github.com/onlooker-community/ecosystem/commit/210aa51bff66226a0eec1f17292a2af4ea4ef56a))
+
+
+### Bug Fixes
+
+* **cartographer:** correct typo in release-please bump-patch key :face_with_spiral_eyes: ([#91](https://github.com/onlooker-community/ecosystem/issues/91)) ([dfab160](https://github.com/onlooker-community/ecosystem/commit/dfab1602afda2b6255a72b0975ebab9289d75b8e))
+* **ci:** apply release-please extra-files for Claude plugin manifests ([#17](https://github.com/onlooker-community/ecosystem/issues/17)) ([da9913c](https://github.com/onlooker-community/ecosystem/commit/da9913ca4f7497280edc34f8c64baa903c1e6754))
+* **ci:** checkout release tag before npm publish :relieved: ([bc7bbdc](https://github.com/onlooker-community/ecosystem/commit/bc7bbdc7a886a55ba8f04fe09bfa60043648c766))
+* **ci:** grant id-token write for npm provenance on publish ([c78c9f0](https://github.com/onlooker-community/ecosystem/commit/c78c9f054c1d48ca8a83d0d26b76ce991fffe51b))
+* **ci:** parse release-please paths_released JSON for npm publish ([749e1a0](https://github.com/onlooker-community/ecosystem/commit/749e1a02b563f37f81a8da21fc3f6e10e179314a))
+* **ci:** stop upgrading npm globally before publish ([a7c7a0e](https://github.com/onlooker-community/ecosystem/commit/a7c7a0e1f25aee1bbb75bdd2af130dbc276480a6))
+* **ci:** use HTTPS repository URL for npm provenance ([a7e8927](https://github.com/onlooker-community/ecosystem/commit/a7e89275c5a025a8afee009853265b717091f6ca))
+* **ci:** use paths_released to gate npm publish :rage: ([#37](https://github.com/onlooker-community/ecosystem/issues/37)) ([c62b17f](https://github.com/onlooker-community/ecosystem/commit/c62b17f7e1352cfe260a23c8f48be30f72edbbed))
+* **compass:** resolve MultiEdit file path from the top-level field ([#85](https://github.com/onlooker-community/ecosystem/issues/85)) ([468abaa](https://github.com/onlooker-community/ecosystem/commit/468abaaad4bef59fe4308bd8887dfcf6d633921a))
+* **counsel:** drop unsupported --max-tokens flag from claude synthesis call :relieved: ([#79](https://github.com/onlooker-community/ecosystem/issues/79)) ([ade85ce](https://github.com/onlooker-community/ecosystem/commit/ade85cecb3243781f47e14fea4990ce31e69e8f4))
+* **counsel:** stop pipefail from discarding all events on large logs :relieved: ([#78](https://github.com/onlooker-community/ecosystem/issues/78)) ([638347d](https://github.com/onlooker-community/ecosystem/commit/638347dec3b9df740b7a85c3e475fa2ffe5d054b))
+* **emitter:** make emission dependency-free and fail-open :relieved: ([#99](https://github.com/onlooker-community/ecosystem/issues/99)) ([0dda7f8](https://github.com/onlooker-community/ecosystem/commit/0dda7f803ed2dfa28561bd8d9e4193b2b18e5bbf))
+* **historian:** export CLAUDE_PLUGIN_ROOT so config loads correctly :bug: ([#112](https://github.com/onlooker-community/ecosystem/issues/112)) ([f24b0b4](https://github.com/onlooker-community/ecosystem/commit/f24b0b4375c64385fefd329cd07d8874785002e9))
+* **historian:** repair CI broken by embedder check + document PR workflow :nail_care: ([#106](https://github.com/onlooker-community/ecosystem/issues/106)) ([02062a2](https://github.com/onlooker-community/ecosystem/commit/02062a21163e084705dae9cf421719b6e5a7b306))
+* **hooks:** replace flock with portable mkdir mutex :bug: ([3dffa6f](https://github.com/onlooker-community/ecosystem/commit/3dffa6f5e43ef9f3c117f2406ddd03ce485df1cd))
+* **package:** update repository URL format in package.json ([591ce9f](https://github.com/onlooker-community/ecosystem/commit/591ce9f54dd605ec04ceb77b9dcca40b3e08621e))
+* **plugins:** glob-discover ecosystem root so sub-plugins work from cache :relieved: ([#110](https://github.com/onlooker-community/ecosystem/issues/110)) ([3639240](https://github.com/onlooker-community/ecosystem/commit/3639240383e1b820e5d8ea42639e0b863ef0d90e))
+* **release:** sync marketplace.json out-of-band :relieved: ([0d2a0a3](https://github.com/onlooker-community/ecosystem/commit/0d2a0a38c0c4ee0e400b9a143a4be7904ea3f70a))
+* **scribe:** mark hook scripts executable :relieved: ([#64](https://github.com/onlooker-community/ecosystem/issues/64)) ([05603e5](https://github.com/onlooker-community/ecosystem/commit/05603e56895c009c1435d1712592adbbc4c15e61))
+* **tribunal:** persist all artifacts on every iteration including retries :relieved: ([#41](https://github.com/onlooker-community/ecosystem/issues/41)) ([1636105](https://github.com/onlooker-community/ecosystem/commit/163610535a4ce0fa73c8fb82dc5c6296d2d1065a))
+* vendor portable-lock.sh into cartographer and governor ([#73](https://github.com/onlooker-community/ecosystem/issues/73)) ([ab2c354](https://github.com/onlooker-community/ecosystem/commit/ab2c354b131c26cc642ebb51e84a043dc43cbaa1))
+
+
+### Performance Improvements
+
+* **bursar:** collapse process forks in SessionEnd hot path :relieved: ([#101](https://github.com/onlooker-community/ecosystem/issues/101)) ([7a426fe](https://github.com/onlooker-community/ecosystem/commit/7a426fe359785eca35ea1ad61523b05fda79e0da))
+* **historian:** fix O(n²) chunk loop and embedder false-positive :relieved: ([4ef130a](https://github.com/onlooker-community/ecosystem/commit/4ef130a4c01ec378da5b4d8baeeb7b4fb6059272))
+
+## [0.31.2](https://github.com/onlooker-community/ecosystem/compare/ecosystem-v0.31.1...ecosystem-v0.31.2) (2026-08-01)
+
+
+### Bug Fixes
+
+* **historian:** export CLAUDE_PLUGIN_ROOT so config loads correctly :bug: ([#112](https://github.com/onlooker-community/ecosystem/issues/112)) ([f24b0b4](https://github.com/onlooker-community/ecosystem/commit/f24b0b4375c64385fefd329cd07d8874785002e9))
+
 ## [0.31.1](https://github.com/onlooker-community/ecosystem/compare/ecosystem-v0.31.0...ecosystem-v0.31.1) (2026-08-01)
 
 

package/package.json

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

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

@@ -1,6 +1,6 @@
 {
   "name": "bursar",
-  "version": "0.2.1",
+  "version": "0.2.2",
   "description": "Multi-session, per-project budget accounting for the Onlooker ecosystem. Rolls each session's spend into a per-project ledger on SessionEnd and surfaces \"this project burned $X this week\" at SessionStart. Where governor regulates a single session, bursar is the cross-session rollup: it reads governor.session.complete off the shared event bus and emits bursar.* events for audit. Named for the officer who keeps the accounts. Builds on the Onlooker ecosystem plugin.",
   "author": {
     "name": "Onlooker Community",

package/plugins/bursar/CHANGELOG.md

@@ -1,5 +1,12 @@
 # Changelog
 
+## [0.2.2](https://github.com/onlooker-community/ecosystem/compare/bursar-v0.2.1...bursar-v0.2.2) (2026-08-02)
+
+
+### Bug Fixes
+
+* librarian conflict detection + bursar rollup lock timeout ([#117](https://github.com/onlooker-community/ecosystem/issues/117)) ([16180a2](https://github.com/onlooker-community/ecosystem/commit/16180a210a6f0561c09b77a2b102849f63f1e730))
+
 ## [0.2.1](https://github.com/onlooker-community/ecosystem/compare/bursar-v0.2.0...bursar-v0.2.1) (2026-08-01)
 
 

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

@@ -35,6 +35,11 @@ INPUT=$(cat)
 
 _done() { exit 0; }
 
+# Emit diagnostic errors to stderr when ledger recording fails.
+_log_error() {
+	printf 'bursar-session-end: %s\n' "$1" >&2
+}
+
 # Parse session_id and cwd in a single jq pass (one fork, not two).
 { IFS= read -r SESSION_ID; IFS= read -r CWD; } < <(printf '%s' "$INPUT" | jq -r '.session_id // "", .cwd // ""' 2>/dev/null)
 
@@ -142,10 +147,18 @@ MODEL=""
 # ledger upsert actually succeeds. A failed write (lock timeout, mv failure)
 # must keep the breadcrumb so the session→project attribution survives for a
 # later attempt rather than being lost behind a false "recorded" event.
-if [[ -n "$RECORD" ]] && bursar_ledger_record "$PROJECT_KEY" "$RECORD"; then
-	[[ -n "$EV" ]] && bursar_emit_event "bursar.session.recorded" "$EV" "$SESSION_ID" || true
-
-	rm -f "$BREADCRUMB" 2>/dev/null || true
+#
+# Use a longer lock timeout (60s) to handle high concurrency: under typical
+# usage, SessionEnd hooks from concurrent sessions compete for the per-project
+# ledger lock. The default 5s timeout is too aggressive with 100+ concurrent
+# sessions, leading to silent recording failures and breadcrumb accumulation.
+if [[ -n "$RECORD" ]]; then
+	if bursar_ledger_record "$PROJECT_KEY" "$RECORD" 60; then
+		[[ -n "$EV" ]] && bursar_emit_event "bursar.session.recorded" "$EV" "$SESSION_ID" || true
+		rm -f "$BREADCRUMB" 2>/dev/null || true
+	else
+		_log_error "ledger_record failed for session $SESSION_ID project $PROJECT_KEY (lock timeout after 60s?). Breadcrumb retained for retry."
+	fi
 fi
 
 _done

package/plugins/bursar/scripts/lib/portable-lock.sh

@@ -29,23 +29,41 @@
 # Avoid associative arrays so bash 3.2 (macOS default) keeps working.
 
 # Acquire an exclusive lock at LOCKPATH. Returns 0 on success, 1 on timeout.
+# Uses exponential backoff under high contention to reduce cache-line thrashing.
 lock_acquire() {
 	local lockpath="${1:-}"
 	local timeout="${2:-5}"
 	[[ -z "$lockpath" ]] && return 1
 
 	local lockdir="${lockpath}.d"
-	local waited=0
-	# Poll at 10 Hz so a 5s timeout = 50 attempts.
-	local max_iter=$((timeout * 10))
+	local start_time
+	start_time=$(date +%s 2>/dev/null) || start_time=0
+
+	local backoff=10  # Start at 10ms (1/100s)
 	while ! mkdir "$lockdir" 2>/dev/null; do
-		if ((waited >= max_iter)); then
-			return 1
+		# Check timeout using epoch comparison (works on all systems).
+		if ((start_time > 0)); then
+			local now
+			now=$(date +%s 2>/dev/null) || now=0
+			if (( (now - start_time) >= timeout )); then
+				return 1
+			fi
+		fi
+
+		# Exponential backoff: 10ms → 20ms → 40ms, capped at 100ms to avoid
+		# sleeping too long under sustained high contention. Reduces per-second
+		# mkdir() attempts from 10/sec (10Hz polling) to ~10-30/sec under load.
+		local sleep_ms=$((backoff))
+		if ((sleep_ms > 100)); then
+			sleep_ms=100
 		fi
-		# `sleep 0.1` works on Linux + macOS; the `|| sleep 1` is a paranoid
-		# fallback for embedded shells that only accept integer seconds.
-		sleep 0.1 2>/dev/null || sleep 1
-		waited=$((waited + 1))
+
+		# Convert to seconds: `sleep 0.01` is 10ms. Fallback for shells
+		# that only accept integer seconds.
+		awk -v ms="$sleep_ms" 'BEGIN { printf "%.2f\n", ms/1000 }' | \
+			xargs -I {} sleep {} 2>/dev/null || sleep 1
+
+		backoff=$((backoff * 2))
 	done
 	return 0
 }

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

@@ -1,6 +1,6 @@
 {
   "name": "historian",
-  "version": "0.3.1",
+  "version": "0.3.2",
   "description": "Episodic memory layer. At SessionEnd, chunks and sanitizes the session transcript and stores chunks under $ONLOOKER_DIR/historian/<project-key>/sessions/ (default $HOME/.onlooker). On UserPromptSubmit, embeds the prompt and performs similarity retrieval over stored chunks to surface relevant past context. Builds on the Onlooker ecosystem plugin.",
   "author": {
     "name": "Onlooker Community",

package/plugins/historian/CHANGELOG.md

@@ -1,5 +1,12 @@
 # Changelog
 
+## [0.3.2](https://github.com/onlooker-community/ecosystem/compare/historian-v0.3.1...historian-v0.3.2) (2026-08-01)
+
+
+### Bug Fixes
+
+* **historian:** export CLAUDE_PLUGIN_ROOT so config loads correctly :bug: ([#112](https://github.com/onlooker-community/ecosystem/issues/112)) ([f24b0b4](https://github.com/onlooker-community/ecosystem/commit/f24b0b4375c64385fefd329cd07d8874785002e9))
+
 ## [0.3.1](https://github.com/onlooker-community/ecosystem/compare/historian-v0.3.0...historian-v0.3.1) (2026-08-01)
 
 

package/plugins/historian/scripts/hooks/historian-prompt-submit.sh

@@ -50,7 +50,8 @@ if [[ -z "$_ECOSYSTEM_ROOT" ]]; then
 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"
+	export CLAUDE_PLUGIN_ROOT="$PLUGIN_ROOT"
+	source "${_ECOSYSTEM_ROOT}/scripts/lib/validate-path.sh"
 fi
 
 # shellcheck source=../lib/historian-config.sh

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

@@ -37,7 +37,8 @@ if [[ -z "$_ECOSYSTEM_ROOT" ]]; then
 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"
+	export CLAUDE_PLUGIN_ROOT="$PLUGIN_ROOT"
+	source "${_ECOSYSTEM_ROOT}/scripts/lib/validate-path.sh"
 fi
 
 # shellcheck source=../lib/historian-config.sh

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

@@ -1,6 +1,6 @@
 {
   "name": "librarian",
-  "version": "0.4.1",
+  "version": "0.6.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,24 @@
 # Changelog
 
+## [0.6.0](https://github.com/onlooker-community/ecosystem/compare/librarian-v0.5.0...librarian-v0.6.0) (2026-08-02)
+
+
+### Features
+
+* **librarian:** implement conflict detection for memory promotion scanning ([#115](https://github.com/onlooker-community/ecosystem/issues/115)) ([8699577](https://github.com/onlooker-community/ecosystem/commit/86995773cb44127d915b5aea53aed66c771d8bfb))
+
+
+### Bug Fixes
+
+* librarian conflict detection + bursar rollup lock timeout ([#117](https://github.com/onlooker-community/ecosystem/issues/117)) ([16180a2](https://github.com/onlooker-community/ecosystem/commit/16180a210a6f0561c09b77a2b102849f63f1e730))
+
+## [0.5.0](https://github.com/onlooker-community/ecosystem/compare/librarian-v0.4.1...librarian-v0.5.0) (2026-08-02)
+
+
+### Features
+
+* **librarian:** implement conflict detection for memory promotion scanning ([#115](https://github.com/onlooker-community/ecosystem/issues/115)) ([8699577](https://github.com/onlooker-community/ecosystem/commit/86995773cb44127d915b5aea53aed66c771d8bfb))
+
 ## [0.4.1](https://github.com/onlooker-community/ecosystem/compare/librarian-v0.4.0...librarian-v0.4.1) (2026-08-01)
 
 

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

@@ -57,6 +57,8 @@ source "${PLUGIN_ROOT}/scripts/lib/librarian-archivist-reader.sh"
 source "${PLUGIN_ROOT}/scripts/lib/librarian-durability.sh"
 # shellcheck source=../lib/librarian-classifier.sh
 source "${PLUGIN_ROOT}/scripts/lib/librarian-classifier.sh"
+# shellcheck source=../lib/librarian-conflict-detector.sh
+source "${PLUGIN_ROOT}/scripts/lib/librarian-conflict-detector.sh"
 
 INPUT=$(cat 2>/dev/null || true)
 CWD=$(printf '%s' "$INPUT" | jq -r '.cwd // ""' 2>/dev/null) || CWD=""
@@ -232,14 +234,75 @@ for ((i = 0; i < KEPT_COUNT; i++)); do
 		continue
 	fi
 
-	# Build and persist the proposal. Conflict detection against the user's
-	# memory store is deferred to a follow-up commit; everything ships as
-	# conflict_state: "none" for now.
+	# Build and persist the proposal. Detect conflicts against the user's
+	# memory store before writing.
 	PROPOSAL_ID=$(librarian_ulid)
 	FILENAME=$(librarian_classifier_filename "$MEMORY_TYPE" "$TITLE")
 	ARTIFACT_ID=$(printf '%s' "$ARTIFACT" | jq -r '.id // ""')
 	ARTIFACT_SESSION=$(printf '%s' "$ARTIFACT" | jq -r '.session_id // ""')
 
+	# Resolve the typed memory store path for this project.
+	MEMORY_STORE_PATH=$(librarian_config_get '.librarian.memory_store_path')
+	[[ -z "$MEMORY_STORE_PATH" || "$MEMORY_STORE_PATH" == "null" ]] && \
+		MEMORY_STORE_PATH='${HOME}/.claude/projects/${CLAUDE_PROJECT_ENCODED}/memory'
+
+	# Expand env vars in the path.
+	MEMORY_STORE_PATH=$(eval echo "$MEMORY_STORE_PATH")
+
+	# Initialize conflict state; will scan if memory dir exists.
+	CONFLICT_STATE="none"
+	CONFLICT_WITH="[]"
+
+	# Detect conflicts against existing memories only if the directory exists.
+	if [[ -d "$MEMORY_STORE_PATH" ]]; then
+		# Build a temporary proposal for conflict detection.
+		TEMP_PROPOSAL=$(jq -n \
+			--arg id "$PROPOSAL_ID" \
+			--arg memory_type "$MEMORY_TYPE" \
+			--arg filename "$FILENAME" \
+			--arg title "$TITLE" \
+			--arg body "$BODY" \
+			--argjson classifier_confidence "$CONFIDENCE" \
+			'{
+				id: $id,
+				proposed: {
+					type: $memory_type,
+					filename: $filename,
+					title: $title,
+					body: $body,
+					classifier_confidence: $classifier_confidence
+				}
+			}')
+
+		# Detect conflicts against existing memories.
+		DUP_THRESHOLD=$(librarian_config_get '.librarian.conflict.duplicate_threshold')
+		[[ -z "$DUP_THRESHOLD" || "$DUP_THRESHOLD" == "null" ]] && DUP_THRESHOLD="0.7"
+		MERGE_THRESHOLD=$(librarian_config_get '.librarian.conflict.merge_candidate_threshold')
+		[[ -z "$MERGE_THRESHOLD" || "$MERGE_THRESHOLD" == "null" ]] && MERGE_THRESHOLD="0.45"
+
+		CONFLICT_RESULT=$(librarian_conflict_scan "$TEMP_PROPOSAL" "$MEMORY_STORE_PATH" \
+			"$DUP_THRESHOLD" "$MERGE_THRESHOLD" 2>/dev/null) || CONFLICT_RESULT=""
+
+		# Ensure we have valid JSON; fall back to "none" if scan fails.
+		if [[ -z "$CONFLICT_RESULT" ]] || ! printf '%s' "$CONFLICT_RESULT" | jq -e '.' >/dev/null 2>&1; then
+			CONFLICT_RESULT='{"conflict_state":"none","conflict_with":[]}'
+		fi
+
+		CONFLICT_STATE=$(printf '%s' "$CONFLICT_RESULT" | jq -r '.conflict_state // "none"' 2>/dev/null) || CONFLICT_STATE="none"
+		CONFLICT_WITH=$(printf '%s' "$CONFLICT_RESULT" | jq -c '.conflict_with // []' 2>/dev/null) || CONFLICT_WITH="[]"
+
+		# Silently drop duplicates — no proposal written.
+		if [[ "$CONFLICT_STATE" == "duplicate" ]]; then
+			POST_CLASSIFIER_DROPPED=$((POST_CLASSIFIER_DROPPED + 1))
+			librarian_emit "librarian.candidate.dropped" "$SESSION_ID" "$(jq -cn \
+				--arg reason "duplicate" \
+				--arg src "$ARTIFACT_ID" \
+				'{ reason: $reason, source_artifact_id: (if $src == "" then null else $src end) }
+				 | with_entries(select(.value != null))')"
+			continue
+		fi
+	fi
+
 	PROPOSAL_JSON=$(jq -n \
 		--arg id "$PROPOSAL_ID" \
 		--arg created_at "$NOW_TS" \
@@ -248,7 +311,8 @@ for ((i = 0; i < KEPT_COUNT; i++)); do
 		--arg title "$TITLE" \
 		--arg body "$BODY" \
 		--argjson classifier_confidence "$CONFIDENCE" \
-		--arg conflict_state "none" \
+		--arg conflict_state "$CONFLICT_STATE" \
+		--argjson conflict_with "$CONFLICT_WITH" \
 		--arg artifact_id "$ARTIFACT_ID" \
 		--arg artifact_session "$ARTIFACT_SESSION" \
 		'{
@@ -264,7 +328,7 @@ for ((i = 0; i < KEPT_COUNT; i++)); do
 				classifier_confidence: $classifier_confidence
 			},
 			conflict_state: $conflict_state,
-			conflict_with: [],
+			conflict_with: $conflict_with,
 			status: "pending"
 		}')
 
@@ -314,7 +378,7 @@ for ((i = 0; i < KEPT_COUNT; i++)); do
 		--arg proposal_id "$PROPOSAL_ID" \
 		--arg memory_type "$MEMORY_TYPE" \
 		--argjson classifier_confidence "$CONFIDENCE" \
-		--arg conflict_state "none" \
+		--arg conflict_state "$CONFLICT_STATE" \
 		--arg src "$ARTIFACT_ID" \
 		'{
 			proposal_id: $proposal_id,

package/plugins/librarian/scripts/lib/librarian-conflict-detector.sh

@@ -0,0 +1,215 @@
+#!/usr/bin/env bash
+# Conflict and duplicate detection for librarian proposals.
+#
+# Compares proposed memories against existing memories in the user's
+# typed memory store (~/.claude/projects/<encoded>/memory/) and classifies
+# each proposal into one of:
+#   - none           (no similarity, safe to propose)
+#   - duplicate      (similarity >= duplicate_threshold; drop silently)
+#   - merge_candidate (merge_threshold <= similarity < duplicate_threshold)
+#   - conflict_candidate (opposing sentiment on overlapping content)
+#
+# Uses deterministic token-set Jaccard similarity (no LLM call) with
+# configurable thresholds.
+
+# Extract and normalize tokens from text for similarity comparison.
+# Lowercases, removes stopwords, splits on non-alphanumeric.
+_librarian_conflict_normalize() {
+	local text="$1"
+	printf '%s' "$text" \
+		| tr '[:upper:]' '[:lower:]' \
+		| tr -cs '[:alnum:]' '\n' \
+		| grep -v '^$' \
+		| sort -u \
+		| paste -sd ' ' -
+}
+
+# Compute Jaccard similarity (intersection / union) of two token sets.
+# Input: two space-separated token strings.
+# Output: float 0-1.
+_librarian_conflict_jaccard() {
+	local tokens1="$1"
+	local tokens2="$2"
+
+	[[ -z "$tokens1" || -z "$tokens2" ]] && { printf '0'; return; }
+
+	TOKENS1="$tokens1" TOKENS2="$tokens2" python3 -c '
+import os
+tokens1 = set(os.environ.get("TOKENS1", "").split())
+tokens2 = set(os.environ.get("TOKENS2", "").split())
+if not tokens1 and not tokens2:
+    print(0)
+else:
+    intersection = len(tokens1 & tokens2)
+    union = len(tokens1 | tokens2)
+    similarity = intersection / union if union > 0 else 0
+    print(f"{similarity:.2f}")
+'
+}
+
+# Check for opposing sentiment markers (do/don't, always/never, etc.).
+# Returns 0 if opposing markers found, 1 otherwise.
+_librarian_conflict_opposing_sentiment() {
+	local text1="$1"
+	local text2="$2"
+
+	# Normalize to lowercase.
+	text1=$(printf '%s' "$text1" | tr '[:upper:]' '[:lower:]')
+	text2=$(printf '%s' "$text2" | tr '[:upper:]' '[:lower:]')
+
+	# Define opposing pairs.
+	local -a pairs=("always:never" "never:always" "do:don't" "don't:do" "prefer:avoid"
+	                 "avoid:prefer" "enable:disable" "disable:enable" "keep:remove"
+	                 "remove:keep" "use:avoid" "avoid:use")
+
+	for pair in "${pairs[@]}"; do
+		local a="${pair%%:*}"
+		local b="${pair##*:}"
+
+		# Check if text1 has 'a' and text2 has 'b', or vice versa.
+		if [[ "$text1" == *"$a"* && "$text2" == *"$b"* ]]; then
+			return 0  # opposing
+		fi
+		if [[ "$text1" == *"$b"* && "$text2" == *"$a"* ]]; then
+			return 0  # opposing
+		fi
+	done
+
+	return 1  # not opposing
+}
+
+# Detect conflict state for a single proposal against a single existing memory.
+# Returns conflict classification and (optionally) the conflicting memory filename.
+#
+# Usage: librarian_conflict_check <proposal_body> <existing_memory_path> \
+#                                 <duplicate_threshold> <merge_threshold>
+#
+# Output: JSON object { conflict_state, conflicting_file (optional) }
+librarian_conflict_check() {
+	local proposal_body="$1"
+	local memory_path="$2"
+	local dup_threshold="${3:-0.7}"
+	local merge_threshold="${4:-0.45}"
+
+	[[ -z "$proposal_body" || -z "$memory_path" ]] && {
+		printf '%s' '{"conflict_state":"none"}'
+		return 0
+	}
+	[[ ! -f "$memory_path" ]] && {
+		printf '%s' '{"conflict_state":"none"}'
+		return 0
+	}
+
+	# Extract the body of the existing memory (skip frontmatter).
+	local existing_body
+	existing_body=$(awk '/^---$/{ if (++count == 2) { in_body = 1; next } }
+	                        in_body { print }' "$memory_path")
+
+	[[ -z "$existing_body" ]] && {
+		printf '%s' '{"conflict_state":"none"}'
+		return 0
+	}
+
+	# Normalize both bodies to token sets.
+	local prop_tokens existing_tokens
+	prop_tokens=$(_librarian_conflict_normalize "$proposal_body")
+	existing_tokens=$(_librarian_conflict_normalize "$existing_body")
+
+	# Compute Jaccard similarity.
+	local similarity
+	similarity=$(_librarian_conflict_jaccard "$prop_tokens" "$existing_tokens")
+
+	# Classify based on similarity + optional sentiment check.
+	if awk "BEGIN { exit !($similarity >= $dup_threshold) }"; then
+		# Definitely a duplicate.
+		jq -cn --arg file "$(basename "$memory_path")" \
+			'{ conflict_state: "duplicate", conflicting_file: $file }'
+	elif awk "BEGIN { exit !($similarity >= $merge_threshold) }"; then
+		# Merge candidate — significant overlap but not identical.
+		jq -cn --arg file "$(basename "$memory_path")" \
+			'{ conflict_state: "merge_candidate", conflicting_file: $file }'
+	elif awk "BEGIN { exit !($similarity >= $merge_threshold * 0.8) }"; then
+		# Check for opposing sentiment in the overlap zone.
+		if _librarian_conflict_opposing_sentiment "$proposal_body" "$existing_body"; then
+			jq -cn --arg file "$(basename "$memory_path")" \
+				'{ conflict_state: "conflict_candidate", conflicting_file: $file }'
+		else
+			printf '%s' '{"conflict_state":"none"}'
+		fi
+	else
+		# No meaningful overlap.
+		printf '%s' '{"conflict_state":"none"}'
+	fi
+}
+
+# Scan a proposal against all existing memories in the project.
+# Returns the highest-priority conflict found (duplicate > conflict > merge).
+#
+# Usage: librarian_conflict_scan <proposal_json> <memory_dir> \
+#                                <duplicate_threshold> <merge_threshold>
+#
+# Output: JSON object { conflict_state, conflict_with: [...] }
+librarian_conflict_scan() {
+	local proposal="$1"
+	local memory_dir="$2"
+	local dup_threshold="${3:-0.7}"
+	local merge_threshold="${4:-0.45}"
+
+	[[ -z "$proposal" || -z "$memory_dir" ]] && {
+		printf '%s' '{"conflict_state":"none","conflict_with":[]}'
+		return 0
+	}
+	[[ ! -d "$memory_dir" ]] && {
+		printf '%s' '{"conflict_state":"none","conflict_with":[]}'
+		return 0
+	}
+
+	local proposal_body
+	proposal_body=$(printf '%s' "$proposal" | jq -r '.proposed.body // ""')
+	[[ -z "$proposal_body" ]] && {
+		printf '%s' '{"conflict_state":"none","conflict_with":[]}'
+		return 0
+	}
+
+	local worst_state=""
+	local conflicts='[]'
+
+	# Scan all memory files in the project.
+	for memory_file in "$memory_dir"/*.md; do
+		[[ ! -f "$memory_file" ]] && continue
+
+		local check
+		check=$(librarian_conflict_check "$proposal_body" "$memory_file" \
+		                                  "$dup_threshold" "$merge_threshold")
+		[[ -z "$check" ]] && continue
+
+		local state
+		state=$(printf '%s' "$check" | jq -r '.conflict_state // "none"')
+		local filename
+		filename=$(printf '%s' "$check" | jq -r '.conflicting_file // ""')
+
+		# Track conflicts; prioritize by severity: duplicate > conflict > merge.
+		case "$state" in
+			duplicate)
+				worst_state="duplicate"
+				conflicts=$(printf '%s' "$conflicts" | jq --arg f "$filename" '. + [$f]')
+				;;
+			conflict_candidate)
+				if [[ "$worst_state" != "duplicate" ]]; then
+					worst_state="conflict_candidate"
+					conflicts=$(printf '%s' "$conflicts" | jq --arg f "$filename" '. + [$f]')
+				fi
+				;;
+			merge_candidate)
+				if [[ -z "$worst_state" ]]; then
+					worst_state="merge_candidate"
+					conflicts=$(printf '%s' "$conflicts" | jq --arg f "$filename" '. + [$f]')
+				fi
+				;;
+		esac
+	done
+
+	[[ -z "$worst_state" ]] && worst_state="none"
+	printf '%s' "$(jq -cn --arg state "$worst_state" --argjson files "$conflicts" \
+		'{ conflict_state: $state, conflict_with: $files }')"
+}

package/scripts/lib/portable-lock.sh

@@ -18,23 +18,41 @@
 # Avoid associative arrays so bash 3.2 (macOS default) keeps working.
 
 # Acquire an exclusive lock at LOCKPATH. Returns 0 on success, 1 on timeout.
+# Uses exponential backoff under high contention to reduce cache-line thrashing.
 lock_acquire() {
 	local lockpath="${1:-}"
 	local timeout="${2:-5}"
 	[[ -z "$lockpath" ]] && return 1
 
 	local lockdir="${lockpath}.d"
-	local waited=0
-	# Poll at 10 Hz so a 5s timeout = 50 attempts.
-	local max_iter=$((timeout * 10))
+	local start_time
+	start_time=$(date +%s 2>/dev/null) || start_time=0
+
+	local backoff=10  # Start at 10ms (1/100s)
 	while ! mkdir "$lockdir" 2>/dev/null; do
-		if ((waited >= max_iter)); then
-			return 1
+		# Check timeout using epoch comparison (works on all systems).
+		if ((start_time > 0)); then
+			local now
+			now=$(date +%s 2>/dev/null) || now=0
+			if (( (now - start_time) >= timeout )); then
+				return 1
+			fi
+		fi
+
+		# Exponential backoff: 10ms → 20ms → 40ms, capped at 100ms to avoid
+		# sleeping too long under sustained high contention. Reduces per-second
+		# mkdir() attempts from 10/sec (10Hz polling) to ~10-30/sec under load.
+		local sleep_ms=$((backoff))
+		if ((sleep_ms > 100)); then
+			sleep_ms=100
 		fi
-		# `sleep 0.1` works on Linux + macOS; the `|| sleep 1` is a paranoid
-		# fallback for embedded shells that only accept integer seconds.
-		sleep 0.1 2>/dev/null || sleep 1
-		waited=$((waited + 1))
+
+		# Convert to seconds: `sleep 0.01` is 10ms. Fallback for shells
+		# that only accept integer seconds.
+		awk -v ms="$sleep_ms" 'BEGIN { printf "%.2f\n", ms/1000 }' | \
+			xargs -I {} sleep {} 2>/dev/null || sleep 1
+
+		backoff=$((backoff * 2))
 	done
 	return 0
 }