pluribus-context 0.3.31 → 0.3.32

package/CHANGELOG.md

@@ -4,6 +4,27 @@
 
 All notable changes to Pluribus are documented here.
 
+## 0.3.32 - 2026-05-26
+
+- Added an executable compaction transaction/rollback receipt fixture for failed `/compact` runs, proving summary failure, `swap_committed=false`, original-context preservation, restored deferred-tool registry/system-reminder queue, and no stale reminder replay without logging raw transcript/tool output.
+- Extended the context-budget guide, context input evidence docs, and context receipts Agent Skill recipe with compaction atomicity checks for failed summary calls and half-committed context state.
+
+## 0.3.31 - 2026-05-26
+
+- Added pruning/compaction smoke coverage to the context receipts Agent Skill and published `pluribus-context@0.3.31` so npm latest includes lifecycle receipts for pre-load, runtime boundary, and post-hoc pruning/protection.
+
+## 0.3.30 - 2026-05-25
+
+- Added executable pruning receipt fixtures for context-cleaning runs, covering start, per-strategy evaluation, completion, backup verification, protected counts, and privacy flags.
+
+## 0.3.29 - 2026-05-25
+
+- Added ToolSearch propagation receipt fixtures for Claude Code-style subagents, separating policy intent, `tools:` declaration shape, and runtime deferred-tool exposure.
+
+## 0.3.28 - 2026-05-25
+
+- Added per-agent MCP injection checks to the context receipts Agent Skill recipe and npm release, covering allowed/excluded servers, loaded/deferred definitions, and startup budget buckets.
+
 ## 0.3.27 - 2026-05-25
 
 - Added a copyable Agent Skill recipe for privacy-safe context receipts, with 60-second smokes for Tool Search/lazy MCP, skill/prompt context, and subagent/manager boundaries.

package/docs/context-budget-receipts.md

@@ -66,6 +66,31 @@ Public trace:
 
 - `examples/context-input-evidence/pruning-otel-trace.json`
 
+## Compaction transaction / rollback
+
+A failed `/compact` is not just a bad summary. It can leave several state surfaces disagreeing: prior context, candidate summary, deferred-tool registry, system-reminder replay queue, local command output, and post-token metadata. The receipt should prove whether compaction committed a new authoritative state or rolled back cleanly.
+
+The receipt should prove:
+
+- summary call status and duration bucket;
+- whether a candidate summary was available/validated;
+- `swap_committed` and `original_context_preserved`;
+- backup availability;
+- deferred-tool registry and system-reminder queue restoration;
+- replayed stale reminder count stayed zero on rollback;
+- `post_tokens_recorded_as_success` stayed false on failure; and
+- raw transcript, tool output, private paths, errors, secrets, and summary text stayed out of the receipt.
+
+Runnable fixture:
+
+```bash
+node examples/context-input-evidence/convert-compaction-transaction-log.mjs
+```
+
+Public trace:
+
+- `examples/context-input-evidence/compaction-transaction-otel-trace.json`
+
 ## Subagent boot budget
 
 Subagents can fail before task #1 if they inherit every MCP schema, skill listing, rule, or memory index from the parent. The receipt should separate:

package/docs/context-input-evidence.md

@@ -330,6 +330,21 @@ It reads `sample-compaction-log.jsonl` and writes `compaction-receipt.ndjson` pl
 
 This is for reliability/auditability work where users need to know whether the original engineering objective survived compaction. The receipt should prove the compaction boundary and item decisions without exposing raw prompts, private instructions, tool outputs, memory bodies, summaries, customer data, or transcripts.
 
+To test compaction transaction / rollback receipts — where a summary attempt fails and the harness must prove it did **not** commit a half-compacted state — run:
+
+```bash
+node examples/context-input-evidence/convert-compaction-transaction-log.mjs
+```
+
+It reads `sample-compaction-transaction-log.jsonl` and writes `compaction-transaction-receipt.ndjson` plus `compaction-transaction-otel-trace.json`. The sample emits four event types:
+
+- `context.compaction.transaction.started` — trigger, before-token bucket, deferred-tool registry count, system-reminder queue count, backup identity, and hashes for active task/tool state.
+- `context.compaction.summary.attempted` — summary-call status, duration bucket, candidate availability, error hash, and privacy flags.
+- `context.compaction.rollback.completed` — rollback reason, `swap_committed=false`, original context preservation, restored registries/queues, replayed-reminder count, and whether post-tokens were incorrectly recorded as success.
+- `context.compaction.transaction.completed` — final status, authoritative state, after-token/registry/reminder buckets, operator-summary hash, and explicit audit gap.
+
+This is for `/compact` failure modes where the dangerous state is not only lossy summarization, but a partial mutation: stale tool results or system reminders replayed as fresh state, deferred-tool registries reset, or `postTokens` recorded as if a failed summary committed. The receipt should prove commit vs rollback without exporting raw transcript, tool output, paths, secrets, customer payloads, or summary text.
+
 To test post-hoc pruning / context-cleaning receipts — where a Claude Code-style session cleaner trims, minifies, stubs, or dedupes context after it entered the transcript — run:
 
 ```bash

package/examples/agent-skills/context-receipts/README.md

@@ -13,15 +13,16 @@ It is intentionally markdown-only so it can be copied into a local skills direct
 Ask an agent or harness using the skill to emit a receipt for one workflow and verify these constraints:
 
 ```bash
-grep -E 'mcp\.tool_index\.loaded|context\.skill\.registry\.index\.loaded|subagent\.mcp_policy\.applied|subagent\.toolsearch\.propagation\.evaluated|context\.prune\.completed|subagent\.delegation\.requested' receipt.jsonl
+grep -E 'mcp\.tool_index\.loaded|context\.skill\.registry\.index\.loaded|subagent\.mcp_policy\.applied|subagent\.toolsearch\.propagation\.evaluated|context\.prune\.completed|context\.compaction\.rollback\.completed|subagent\.delegation\.requested' receipt.jsonl
 grep -E 'raw_(schema|query|args|result|output|transcript|text)_copied":false|raw.*CopiedToReceipt":false' receipt.jsonl
 ```
 
 Then manually check that the receipt contains counts, hashes, ids, buckets, and `audit_gap`, but does **not** contain private prompts, raw schemas, tool args/results, skill bodies, memory bodies, customer names, secrets, or transcript text.
 
-For executable fixture examples, see [`../../context-input-evidence/`](../../context-input-evidence/), including the ToolSearch propagation and pruning smokes:
+For executable fixture examples, see [`../../context-input-evidence/`](../../context-input-evidence/), including the ToolSearch propagation, pruning, and compaction transaction smokes:
 
 ```bash
 node ../../context-input-evidence/convert-subagent-toolsearch-propagation-log.mjs
 node ../../context-input-evidence/convert-pruning-log.mjs
+node ../../context-input-evidence/convert-compaction-transaction-log.mjs
 ```

package/examples/agent-skills/context-receipts/SKILL.md

@@ -114,6 +114,23 @@ Minimal JSONL event names:
 {"event":"context.prune.completed","after_token_bucket":"75k_100k","backup_verified":true,"protected_summary_count":2,"raw_text_copied":false,"audit_gap":"proves pruning/protection counts, not semantic disposability"}
 ```
 
+For failed compaction, also prove transaction safety:
+
+- did the summary call succeed, fail, or timeout;
+- was a candidate summary validated before any swap;
+- did the harness commit a context swap or preserve the original context;
+- were deferred-tool registries and system-reminder queues restored on rollback;
+- did stale system reminders/tool results replay as fresh state;
+- was post-token metadata recorded as success even though summary failed.
+
+Minimal JSONL event names:
+
+```jsonl
+{"event":"context.compaction.summary.attempted","summary_call_status":"failed_rate_limited","candidate_summary_available":false,"raw_error_copied":false}
+{"event":"context.compaction.rollback.completed","swap_committed":false,"original_context_preserved":true,"deferred_tool_registry_restored":true,"system_reminder_queue_restored":true,"replayed_system_reminder_count":0}
+{"event":"context.compaction.transaction.completed","status":"rolled_back","authoritative_state":"pre_compaction_context","post_tokens_recorded_as_success":false,"raw_context_copied":false}
+```
+
 ## Subagent / manager boundary smoke
 
 For subagents, manager agents, or child workers, answer:

package/examples/context-input-evidence/compaction-transaction-otel-trace.json

@@ -0,0 +1,477 @@
+{
+  "resourceSpans": [
+    {
+      "resource": {
+        "attributes": [
+          {
+            "key": "service.name",
+            "value": {
+              "stringValue": "pluribus-compaction-transaction-receipt-demo"
+            }
+          },
+          {
+            "key": "service.version",
+            "value": {
+              "stringValue": "0.0.0-fixture"
+            }
+          },
+          {
+            "key": "deployment.environment.name",
+            "value": {
+              "stringValue": "local-fixture"
+            }
+          }
+        ]
+      },
+      "scopeSpans": [
+        {
+          "scope": {
+            "name": "pluribus.context_input_evidence.compaction_transaction_demo",
+            "version": "0.0.0-fixture"
+          },
+          "spans": [
+            {
+              "traceId": "87ad256b18f3351f51b593961c988bb8",
+              "spanId": "c74740fd56dea619",
+              "parentSpanId": "",
+              "name": "agent.session.context_compaction_transaction",
+              "kind": 1,
+              "startTimeUnixNano": "1779793080000000000",
+              "endTimeUnixNano": "1779793090000000000",
+              "attributes": [
+                {
+                  "key": "session.id",
+                  "value": {
+                    "stringValue": "sess-compact-failure-001"
+                  }
+                },
+                {
+                  "key": "gen_ai.conversation.id",
+                  "value": {
+                    "stringValue": "conv-compact-failure-001"
+                  }
+                },
+                {
+                  "key": "agent.name",
+                  "value": {
+                    "stringValue": "claude-code"
+                  }
+                },
+                {
+                  "key": "workspace.hash",
+                  "value": {
+                    "stringValue": "sha256:7beaf7a791c25a7a084ba436e7056c92e574ee7c4f0c46aa70dc77b77693aca0"
+                  }
+                },
+                {
+                  "key": "gen_ai.request.model",
+                  "value": {
+                    "stringValue": "claude-opus-4.6"
+                  }
+                },
+                {
+                  "key": "context.compaction.transaction.id_hash",
+                  "value": {
+                    "stringValue": "sha256:805db5aa5360"
+                  }
+                },
+                {
+                  "key": "context.compaction.transaction.status",
+                  "value": {
+                    "stringValue": "rolled_back"
+                  }
+                },
+                {
+                  "key": "context.compaction.swap_committed",
+                  "value": {
+                    "boolValue": false
+                  }
+                },
+                {
+                  "key": "context.compaction.original_context_preserved",
+                  "value": {
+                    "boolValue": true
+                  }
+                }
+              ],
+              "events": [
+                {
+                  "name": "context.compaction.transaction.started",
+                  "timeUnixNano": "1779793080000000000",
+                  "attributes": [
+                    {
+                      "key": "session.id",
+                      "value": {
+                        "stringValue": "sess-compact-failure-001"
+                      }
+                    },
+                    {
+                      "key": "gen_ai.conversation.id",
+                      "value": {
+                        "stringValue": "conv-compact-failure-001"
+                      }
+                    },
+                    {
+                      "key": "agent.name",
+                      "value": {
+                        "stringValue": "claude-code"
+                      }
+                    },
+                    {
+                      "key": "context.compaction.transaction.id_hash",
+                      "value": {
+                        "stringValue": "sha256:805db5aa5360"
+                      }
+                    },
+                    {
+                      "key": "context.compaction.attempt",
+                      "value": {
+                        "intValue": "1"
+                      }
+                    },
+                    {
+                      "key": "context.compaction.trigger",
+                      "value": {
+                        "stringValue": "manual_slash_compact"
+                      }
+                    },
+                    {
+                      "key": "context.compaction.reason",
+                      "value": {
+                        "stringValue": "context_window_pressure"
+                      }
+                    },
+                    {
+                      "key": "context.compaction.token_count.before_bucket",
+                      "value": {
+                        "stringValue": "under_200k"
+                      }
+                    },
+                    {
+                      "key": "context.compaction.context_window_bucket",
+                      "value": {
+                        "stringValue": "over_200k"
+                      }
+                    },
+                    {
+                      "key": "context.compaction.deferred_tool_registry.count_bucket",
+                      "value": {
+                        "stringValue": "under_100"
+                      }
+                    },
+                    {
+                      "key": "context.compaction.system_reminder_queue.count_bucket",
+                      "value": {
+                        "stringValue": "under_25"
+                      }
+                    },
+                    {
+                      "key": "context.compaction.backup.id_hash",
+                      "value": {
+                        "stringValue": "sha256:5eeefe35b7bf"
+                      }
+                    },
+                    {
+                      "key": "context.compaction.active_task.hash",
+                      "value": {
+                        "stringValue": "sha256:82147db072d020ce2ac8b662fc0296ff4d648fb7f44a891317ae993aa4afa632"
+                      }
+                    },
+                    {
+                      "key": "context.compaction.recent_tool_output.hash",
+                      "value": {
+                        "stringValue": "sha256:361345a74863bc83520ad833fa352e7efd3e8765fc4ebea221aaaab5e64be887"
+                      }
+                    },
+                    {
+                      "key": "context.compaction.deferred_tools.hash",
+                      "value": {
+                        "stringValue": "sha256:5aea705e426312000671b8d9a939170e50a1aa4d0ce6adf7a724c85b9c799971"
+                      }
+                    },
+                    {
+                      "key": "privacy.raw_prompt_recorded",
+                      "value": {
+                        "boolValue": false
+                      }
+                    },
+                    {
+                      "key": "privacy.raw_tool_output_recorded",
+                      "value": {
+                        "boolValue": false
+                      }
+                    },
+                    {
+                      "key": "privacy.raw_tool_registry_recorded",
+                      "value": {
+                        "boolValue": false
+                      }
+                    },
+                    {
+                      "key": "privacy.raw_context_recorded",
+                      "value": {
+                        "boolValue": false
+                      }
+                    }
+                  ]
+                },
+                {
+                  "name": "context.compaction.summary.attempted",
+                  "timeUnixNano": "1779793088000000000",
+                  "attributes": [
+                    {
+                      "key": "session.id",
+                      "value": {
+                        "stringValue": "sess-compact-failure-001"
+                      }
+                    },
+                    {
+                      "key": "gen_ai.conversation.id",
+                      "value": {
+                        "stringValue": "conv-compact-failure-001"
+                      }
+                    },
+                    {
+                      "key": "context.compaction.transaction.id_hash",
+                      "value": {
+                        "stringValue": "sha256:805db5aa5360"
+                      }
+                    },
+                    {
+                      "key": "context.compaction.summary.call_status",
+                      "value": {
+                        "stringValue": "failed_rate_limited"
+                      }
+                    },
+                    {
+                      "key": "context.compaction.summary.duration_bucket",
+                      "value": {
+                        "stringValue": "under_15s"
+                      }
+                    },
+                    {
+                      "key": "context.compaction.summary.candidate_available",
+                      "value": {
+                        "boolValue": false
+                      }
+                    },
+                    {
+                      "key": "context.compaction.summary.error_hash",
+                      "value": {
+                        "stringValue": "sha256:d294b4e487433a21ae31f3d50335e2a38d0754d878f17f8d565d024eb58980be"
+                      }
+                    },
+                    {
+                      "key": "context.compaction.summary.candidate_hash",
+                      "value": {
+                        "stringValue": ""
+                      }
+                    },
+                    {
+                      "key": "privacy.raw_error_recorded",
+                      "value": {
+                        "boolValue": false
+                      }
+                    },
+                    {
+                      "key": "privacy.raw_summary_recorded",
+                      "value": {
+                        "boolValue": false
+                      }
+                    },
+                    {
+                      "key": "privacy.raw_context_recorded",
+                      "value": {
+                        "boolValue": false
+                      }
+                    }
+                  ]
+                },
+                {
+                  "name": "context.compaction.rollback.completed",
+                  "timeUnixNano": "1779793089000000000",
+                  "attributes": [
+                    {
+                      "key": "session.id",
+                      "value": {
+                        "stringValue": "sess-compact-failure-001"
+                      }
+                    },
+                    {
+                      "key": "gen_ai.conversation.id",
+                      "value": {
+                        "stringValue": "conv-compact-failure-001"
+                      }
+                    },
+                    {
+                      "key": "context.compaction.transaction.id_hash",
+                      "value": {
+                        "stringValue": "sha256:805db5aa5360"
+                      }
+                    },
+                    {
+                      "key": "context.compaction.rollback.reason",
+                      "value": {
+                        "stringValue": "summary_call_failed_before_validation"
+                      }
+                    },
+                    {
+                      "key": "context.compaction.swap_committed",
+                      "value": {
+                        "boolValue": false
+                      }
+                    },
+                    {
+                      "key": "context.compaction.original_context_preserved",
+                      "value": {
+                        "boolValue": true
+                      }
+                    },
+                    {
+                      "key": "context.compaction.backup_available",
+                      "value": {
+                        "boolValue": true
+                      }
+                    },
+                    {
+                      "key": "context.compaction.deferred_tool_registry_restored",
+                      "value": {
+                        "boolValue": true
+                      }
+                    },
+                    {
+                      "key": "context.compaction.system_reminder_queue_restored",
+                      "value": {
+                        "boolValue": true
+                      }
+                    },
+                    {
+                      "key": "context.compaction.replayed_system_reminder.count_bucket",
+                      "value": {
+                        "stringValue": "zero"
+                      }
+                    },
+                    {
+                      "key": "context.compaction.post_tokens_recorded_as_success",
+                      "value": {
+                        "boolValue": false
+                      }
+                    },
+                    {
+                      "key": "context.compaction.rollback.note_hash",
+                      "value": {
+                        "stringValue": "sha256:c3a100a46da5c02c2534fd4cac32b9e6df189f082b7fd60e5645bdb3d2f15f15"
+                      }
+                    },
+                    {
+                      "key": "privacy.raw_rollback_note_recorded",
+                      "value": {
+                        "boolValue": false
+                      }
+                    },
+                    {
+                      "key": "privacy.raw_tool_output_recorded",
+                      "value": {
+                        "boolValue": false
+                      }
+                    },
+                    {
+                      "key": "privacy.raw_context_recorded",
+                      "value": {
+                        "boolValue": false
+                      }
+                    }
+                  ]
+                },
+                {
+                  "name": "context.compaction.transaction.completed",
+                  "timeUnixNano": "1779793090000000000",
+                  "attributes": [
+                    {
+                      "key": "session.id",
+                      "value": {
+                        "stringValue": "sess-compact-failure-001"
+                      }
+                    },
+                    {
+                      "key": "gen_ai.conversation.id",
+                      "value": {
+                        "stringValue": "conv-compact-failure-001"
+                      }
+                    },
+                    {
+                      "key": "context.compaction.transaction.id_hash",
+                      "value": {
+                        "stringValue": "sha256:805db5aa5360"
+                      }
+                    },
+                    {
+                      "key": "context.compaction.transaction.status",
+                      "value": {
+                        "stringValue": "rolled_back"
+                      }
+                    },
+                    {
+                      "key": "context.compaction.authoritative_state",
+                      "value": {
+                        "stringValue": "pre_compaction_context"
+                      }
+                    },
+                    {
+                      "key": "context.compaction.token_count.after_bucket",
+                      "value": {
+                        "stringValue": "under_200k"
+                      }
+                    },
+                    {
+                      "key": "context.compaction.deferred_tool_registry.after_count_bucket",
+                      "value": {
+                        "stringValue": "under_100"
+                      }
+                    },
+                    {
+                      "key": "context.compaction.system_reminder_queue.after_count_bucket",
+                      "value": {
+                        "stringValue": "under_25"
+                      }
+                    },
+                    {
+                      "key": "context.compaction.audit_gap",
+                      "value": {
+                        "stringValue": "proves transaction boundary and rollback flags, not semantic completeness of the preserved context"
+                      }
+                    },
+                    {
+                      "key": "context.compaction.operator_summary.hash",
+                      "value": {
+                        "stringValue": "sha256:f55024c1bc84cc2a3d5fc2ccf2fc355cd9d0e9987ee53d2da7f879d749dc29af"
+                      }
+                    },
+                    {
+                      "key": "privacy.raw_operator_summary_recorded",
+                      "value": {
+                        "boolValue": false
+                      }
+                    },
+                    {
+                      "key": "privacy.raw_prompt_recorded",
+                      "value": {
+                        "boolValue": false
+                      }
+                    },
+                    {
+                      "key": "privacy.raw_context_recorded",
+                      "value": {
+                        "boolValue": false
+                      }
+                    }
+                  ]
+                }
+              ]
+            }
+          ]
+        }
+      ]
+    }
+  ]
+}

package/examples/context-input-evidence/compaction-transaction-receipt.ndjson

@@ -0,0 +1,4 @@
+{"trace_id":"87ad256b18f3351f51b593961c988bb8","span_id":"c74740fd56dea619","name":"context.compaction.transaction.started","time":"2026-05-26T10:58:00.000Z","attributes":{"session.id":"sess-compact-failure-001","gen_ai.conversation.id":"conv-compact-failure-001","agent.name":"claude-code","context.compaction.transaction.id_hash":"sha256:805db5aa5360","context.compaction.attempt":1,"context.compaction.trigger":"manual_slash_compact","context.compaction.reason":"context_window_pressure","context.compaction.token_count.before_bucket":"under_200k","context.compaction.context_window_bucket":"over_200k","context.compaction.deferred_tool_registry.count_bucket":"under_100","context.compaction.system_reminder_queue.count_bucket":"under_25","context.compaction.backup.id_hash":"sha256:5eeefe35b7bf","context.compaction.active_task.hash":"sha256:82147db072d020ce2ac8b662fc0296ff4d648fb7f44a891317ae993aa4afa632","context.compaction.recent_tool_output.hash":"sha256:361345a74863bc83520ad833fa352e7efd3e8765fc4ebea221aaaab5e64be887","context.compaction.deferred_tools.hash":"sha256:5aea705e426312000671b8d9a939170e50a1aa4d0ce6adf7a724c85b9c799971","privacy.raw_prompt_recorded":false,"privacy.raw_tool_output_recorded":false,"privacy.raw_tool_registry_recorded":false,"privacy.raw_context_recorded":false}}
+{"trace_id":"87ad256b18f3351f51b593961c988bb8","span_id":"c74740fd56dea619","name":"context.compaction.summary.attempted","time":"2026-05-26T10:58:08.000Z","attributes":{"session.id":"sess-compact-failure-001","gen_ai.conversation.id":"conv-compact-failure-001","context.compaction.transaction.id_hash":"sha256:805db5aa5360","context.compaction.summary.call_status":"failed_rate_limited","context.compaction.summary.duration_bucket":"under_15s","context.compaction.summary.candidate_available":false,"context.compaction.summary.error_hash":"sha256:d294b4e487433a21ae31f3d50335e2a38d0754d878f17f8d565d024eb58980be","context.compaction.summary.candidate_hash":"","privacy.raw_error_recorded":false,"privacy.raw_summary_recorded":false,"privacy.raw_context_recorded":false}}
+{"trace_id":"87ad256b18f3351f51b593961c988bb8","span_id":"c74740fd56dea619","name":"context.compaction.rollback.completed","time":"2026-05-26T10:58:09.000Z","attributes":{"session.id":"sess-compact-failure-001","gen_ai.conversation.id":"conv-compact-failure-001","context.compaction.transaction.id_hash":"sha256:805db5aa5360","context.compaction.rollback.reason":"summary_call_failed_before_validation","context.compaction.swap_committed":false,"context.compaction.original_context_preserved":true,"context.compaction.backup_available":true,"context.compaction.deferred_tool_registry_restored":true,"context.compaction.system_reminder_queue_restored":true,"context.compaction.replayed_system_reminder.count_bucket":"zero","context.compaction.post_tokens_recorded_as_success":false,"context.compaction.rollback.note_hash":"sha256:c3a100a46da5c02c2534fd4cac32b9e6df189f082b7fd60e5645bdb3d2f15f15","privacy.raw_rollback_note_recorded":false,"privacy.raw_tool_output_recorded":false,"privacy.raw_context_recorded":false}}
+{"trace_id":"87ad256b18f3351f51b593961c988bb8","span_id":"c74740fd56dea619","name":"context.compaction.transaction.completed","time":"2026-05-26T10:58:10.000Z","attributes":{"session.id":"sess-compact-failure-001","gen_ai.conversation.id":"conv-compact-failure-001","context.compaction.transaction.id_hash":"sha256:805db5aa5360","context.compaction.transaction.status":"rolled_back","context.compaction.authoritative_state":"pre_compaction_context","context.compaction.token_count.after_bucket":"under_200k","context.compaction.deferred_tool_registry.after_count_bucket":"under_100","context.compaction.system_reminder_queue.after_count_bucket":"under_25","context.compaction.audit_gap":"proves transaction boundary and rollback flags, not semantic completeness of the preserved context","context.compaction.operator_summary.hash":"sha256:f55024c1bc84cc2a3d5fc2ccf2fc355cd9d0e9987ee53d2da7f879d749dc29af","privacy.raw_operator_summary_recorded":false,"privacy.raw_prompt_recorded":false,"privacy.raw_context_recorded":false}}

package/examples/context-input-evidence/convert-compaction-transaction-log.mjs

@@ -0,0 +1,271 @@
+#!/usr/bin/env node
+import { createHash } from 'node:crypto';
+import { readFileSync, writeFileSync } from 'node:fs';
+import { dirname, join, resolve } from 'node:path';
+import { fileURLToPath } from 'node:url';
+
+const here = dirname(fileURLToPath(import.meta.url));
+const inputPath = process.argv[2] ? resolve(process.argv[2]) : join(here, 'sample-compaction-transaction-log.jsonl');
+const receiptPath = process.argv[3] ? resolve(process.argv[3]) : join(here, 'compaction-transaction-receipt.ndjson');
+const tracePath = process.argv[4] ? resolve(process.argv[4]) : join(here, 'compaction-transaction-otel-trace.json');
+
+function sha256(value) {
+  return `sha256:${createHash('sha256').update(value ?? '').digest('hex')}`;
+}
+
+function hashRef(value) {
+  return sha256(value ?? '').slice(0, 19);
+}
+
+function readJsonl(path) {
+  return readFileSync(path, 'utf8')
+    .trim()
+    .split('\n')
+    .filter(Boolean)
+    .map((line, index) => {
+      try {
+        return JSON.parse(line);
+      } catch (error) {
+        throw new Error(`Invalid JSONL at ${path}:${index + 1}: ${error.message}`);
+      }
+    });
+}
+
+function unixNano(isoTimestamp) {
+  return `${BigInt(Date.parse(isoTimestamp)) * 1_000_000n}`;
+}
+
+function otelValue(value) {
+  if (typeof value === 'boolean') return { boolValue: value };
+  if (typeof value === 'number' && Number.isInteger(value)) return { intValue: String(value) };
+  if (typeof value === 'number') return { doubleValue: value };
+  if (value == null) return { stringValue: '' };
+  return { stringValue: String(value) };
+}
+
+function attributesToOtel(attributes) {
+  return Object.entries(attributes).map(([key, value]) => ({ key, value: otelValue(value) }));
+}
+
+function tokenBucket(value) {
+  if (value < 1_000) return 'under_1k';
+  if (value < 10_000) return 'under_10k';
+  if (value < 50_000) return 'under_50k';
+  if (value < 100_000) return 'under_100k';
+  if (value < 200_000) return 'under_200k';
+  return 'over_200k';
+}
+
+function countBucket(value) {
+  if (value === 0) return 'zero';
+  if (value <= 5) return 'under_5';
+  if (value <= 25) return 'under_25';
+  if (value <= 100) return 'under_100';
+  if (value <= 500) return 'under_500';
+  return 'over_500';
+}
+
+function durationBucket(value) {
+  if (value < 1_000) return 'under_1s';
+  if (value < 5_000) return 'under_5s';
+  if (value < 15_000) return 'under_15s';
+  if (value < 60_000) return 'under_60s';
+  return 'over_60s';
+}
+
+const records = readJsonl(inputPath);
+const session = records.find((record) => record.type === 'session.start');
+const start = records.find((record) => record.type === 'context.compaction.transaction.started');
+const attempt = records.find((record) => record.type === 'context.compaction.summary.attempted');
+const rollback = records.find((record) => record.type === 'context.compaction.rollback.completed');
+const completed = records.find((record) => record.type === 'context.compaction.transaction.completed');
+
+if (!session || !start || !attempt || !rollback || !completed) {
+  throw new Error(`Expected session.start, transaction.started, summary.attempted, rollback.completed, and transaction.completed records in ${inputPath}`);
+}
+
+const traceSeed = `${session.session_id}:${start.transaction_id}:compaction-transaction`;
+const traceId = sha256(traceSeed).replace('sha256:', '').slice(0, 32);
+const spanId = sha256(`${traceSeed}:span`).replace('sha256:', '').slice(0, 16);
+const transactionIdHash = hashRef(start.transaction_id);
+
+const startEvent = {
+  trace_id: traceId,
+  span_id: spanId,
+  name: 'context.compaction.transaction.started',
+  time: start.time,
+  attributes: {
+    'session.id': session.session_id,
+    'gen_ai.conversation.id': session.conversation_id,
+    'agent.name': session.agent,
+    'context.compaction.transaction.id_hash': transactionIdHash,
+    'context.compaction.attempt': start.attempt,
+    'context.compaction.trigger': start.trigger,
+    'context.compaction.reason': start.reason,
+    'context.compaction.token_count.before_bucket': tokenBucket(start.context_token_count_before),
+    'context.compaction.context_window_bucket': tokenBucket(start.context_window_tokens),
+    'context.compaction.deferred_tool_registry.count_bucket': countBucket(start.deferred_tool_registry_count),
+    'context.compaction.system_reminder_queue.count_bucket': countBucket(start.pending_system_reminder_count),
+    'context.compaction.backup.id_hash': hashRef(start.backup_id),
+    'context.compaction.active_task.hash': sha256(start.raw_active_task),
+    'context.compaction.recent_tool_output.hash': sha256(start.raw_recent_tool_output),
+    'context.compaction.deferred_tools.hash': sha256(start.raw_deferred_tools),
+    'privacy.raw_prompt_recorded': false,
+    'privacy.raw_tool_output_recorded': false,
+    'privacy.raw_tool_registry_recorded': false,
+    'privacy.raw_context_recorded': false
+  }
+};
+
+const attemptEvent = {
+  trace_id: traceId,
+  span_id: spanId,
+  name: 'context.compaction.summary.attempted',
+  time: attempt.time,
+  attributes: {
+    'session.id': session.session_id,
+    'gen_ai.conversation.id': session.conversation_id,
+    'context.compaction.transaction.id_hash': transactionIdHash,
+    'context.compaction.summary.call_status': attempt.summary_call_status,
+    'context.compaction.summary.duration_bucket': durationBucket(attempt.summary_duration_ms),
+    'context.compaction.summary.candidate_available': attempt.candidate_summary_available,
+    'context.compaction.summary.error_hash': sha256(attempt.raw_error),
+    'context.compaction.summary.candidate_hash': attempt.candidate_summary_text ? sha256(attempt.candidate_summary_text) : '',
+    'privacy.raw_error_recorded': false,
+    'privacy.raw_summary_recorded': false,
+    'privacy.raw_context_recorded': false
+  }
+};
+
+const rollbackEvent = {
+  trace_id: traceId,
+  span_id: spanId,
+  name: 'context.compaction.rollback.completed',
+  time: rollback.time,
+  attributes: {
+    'session.id': session.session_id,
+    'gen_ai.conversation.id': session.conversation_id,
+    'context.compaction.transaction.id_hash': transactionIdHash,
+    'context.compaction.rollback.reason': rollback.rollback_reason,
+    'context.compaction.swap_committed': rollback.swap_committed,
+    'context.compaction.original_context_preserved': rollback.original_context_preserved,
+    'context.compaction.backup_available': rollback.backup_available,
+    'context.compaction.deferred_tool_registry_restored': rollback.deferred_tool_registry_restored,
+    'context.compaction.system_reminder_queue_restored': rollback.system_reminder_queue_restored,
+    'context.compaction.replayed_system_reminder.count_bucket': countBucket(rollback.replayed_system_reminder_count),
+    'context.compaction.post_tokens_recorded_as_success': rollback.post_tokens_recorded_as_success,
+    'context.compaction.rollback.note_hash': sha256(rollback.raw_rollback_note),
+    'privacy.raw_rollback_note_recorded': false,
+    'privacy.raw_tool_output_recorded': false,
+    'privacy.raw_context_recorded': false
+  }
+};
+
+const completedEvent = {
+  trace_id: traceId,
+  span_id: spanId,
+  name: 'context.compaction.transaction.completed',
+  time: completed.time,
+  attributes: {
+    'session.id': session.session_id,
+    'gen_ai.conversation.id': session.conversation_id,
+    'context.compaction.transaction.id_hash': transactionIdHash,
+    'context.compaction.transaction.status': completed.status,
+    'context.compaction.authoritative_state': completed.authoritative_state,
+    'context.compaction.token_count.after_bucket': tokenBucket(completed.context_token_count_after),
+    'context.compaction.deferred_tool_registry.after_count_bucket': countBucket(completed.deferred_tool_registry_count_after),
+    'context.compaction.system_reminder_queue.after_count_bucket': countBucket(completed.pending_system_reminder_count_after),
+    'context.compaction.audit_gap': completed.audit_gap,
+    'context.compaction.operator_summary.hash': sha256(completed.raw_operator_summary),
+    'privacy.raw_operator_summary_recorded': false,
+    'privacy.raw_prompt_recorded': false,
+    'privacy.raw_context_recorded': false
+  }
+};
+
+const events = [startEvent, attemptEvent, rollbackEvent, completedEvent]
+  .sort((left, right) => Date.parse(left.time) - Date.parse(right.time));
+
+writeFileSync(receiptPath, `${events.map((event) => JSON.stringify(event)).join('\n')}\n`);
+
+const trace = {
+  resourceSpans: [
+    {
+      resource: {
+        attributes: attributesToOtel({
+          'service.name': 'pluribus-compaction-transaction-receipt-demo',
+          'service.version': '0.0.0-fixture',
+          'deployment.environment.name': 'local-fixture'
+        })
+      },
+      scopeSpans: [
+        {
+          scope: {
+            name: 'pluribus.context_input_evidence.compaction_transaction_demo',
+            version: '0.0.0-fixture'
+          },
+          spans: [
+            {
+              traceId,
+              spanId,
+              parentSpanId: '',
+              name: 'agent.session.context_compaction_transaction',
+              kind: 1,
+              startTimeUnixNano: unixNano(start.time),
+              endTimeUnixNano: unixNano(completed.time),
+              attributes: attributesToOtel({
+                'session.id': session.session_id,
+                'gen_ai.conversation.id': session.conversation_id,
+                'agent.name': session.agent,
+                'workspace.hash': sha256(session.workspace),
+                'gen_ai.request.model': session.model,
+                'context.compaction.transaction.id_hash': transactionIdHash,
+                'context.compaction.transaction.status': completed.status,
+                'context.compaction.swap_committed': rollback.swap_committed,
+                'context.compaction.original_context_preserved': rollback.original_context_preserved
+              }),
+              events: events.map((event) => ({
+                name: event.name,
+                timeUnixNano: unixNano(event.time),
+                attributes: attributesToOtel(event.attributes)
+              }))
+            }
+          ]
+        }
+      ]
+    }
+  ]
+};
+
+writeFileSync(tracePath, `${JSON.stringify(trace, null, 2)}\n`);
+
+const forbiddenRawStrings = [
+  'Acme-Co',
+  'sk_live_private_compact_txn',
+  'alice@example.com',
+  '/private/work/acme',
+  'customer retry payload',
+  'internal-acme-prod-admin',
+  'Restored /private/work/acme',
+  'payment payload'
+];
+const exportedText = `${events.map((event) => JSON.stringify(event)).join('\n')}\n${JSON.stringify(trace)}`;
+const rawTextCopiedToReceipt = forbiddenRawStrings.some((value) => exportedText.includes(value));
+
+const summary = {
+  schema: 'pluribus.compactionTransactionReceipt.demo.v0',
+  eventCount: events.length,
+  status: completed.status,
+  swapCommitted: rollback.swap_committed,
+  originalContextPreserved: rollback.original_context_preserved,
+  backupAvailable: rollback.backup_available,
+  deferredToolRegistryRestored: rollback.deferred_tool_registry_restored,
+  systemReminderQueueRestored: rollback.system_reminder_queue_restored,
+  postTokensRecordedAsSuccess: rollback.post_tokens_recorded_as_success,
+  rawTextCopiedToReceipt,
+  receiptPath: 'examples/context-input-evidence/compaction-transaction-receipt.ndjson',
+  tracePath: 'examples/context-input-evidence/compaction-transaction-otel-trace.json',
+  lesson: 'Failed compaction should emit a transaction receipt that proves summary failure did not commit a context swap or replay stale tool/system-reminder state.'
+};
+
+console.log(JSON.stringify(summary, null, 2));

package/examples/context-input-evidence/sample-compaction-transaction-log.jsonl

@@ -0,0 +1,5 @@
+{"type":"session.start","time":"2026-05-26T10:57:00.000Z","session_id":"sess-compact-failure-001","conversation_id":"conv-compact-failure-001","agent":"claude-code","workspace":"/private/work/acme-checkout","model":"claude-opus-4.6"}
+{"type":"context.compaction.transaction.started","time":"2026-05-26T10:58:00.000Z","transaction_id":"compact-txn-2026-05-26-private-acme","attempt":1,"trigger":"manual_slash_compact","reason":"context_window_pressure","context_token_count_before":151400,"context_window_tokens":200000,"deferred_tool_registry_count":43,"pending_system_reminder_count":19,"backup_id":"backup-private-acme-before-compact","raw_active_task":"Fix Acme-Co checkout retry loop; never expose sk_live_private_compact_txn or customer email alice@example.com.","raw_recent_tool_output":"Read /private/work/acme/src/payments.ts returned Stripe token sk_live_private_compact_txn and customer retry payload.","raw_deferred_tools":"github,postgres,slack,internal-acme-prod-admin"}
+{"type":"context.compaction.summary.attempted","time":"2026-05-26T10:58:08.000Z","transaction_id":"compact-txn-2026-05-26-private-acme","summary_call_status":"failed_rate_limited","summary_duration_ms":8200,"candidate_summary_available":false,"raw_error":"429 rate limit while summarizing Acme-Co checkout incident with private token sk_live_private_compact_txn","candidate_summary_text":""}
+{"type":"context.compaction.rollback.completed","time":"2026-05-26T10:58:09.000Z","transaction_id":"compact-txn-2026-05-26-private-acme","rollback_reason":"summary_call_failed_before_validation","swap_committed":false,"original_context_preserved":true,"backup_available":true,"deferred_tool_registry_restored":true,"system_reminder_queue_restored":true,"replayed_system_reminder_count":0,"post_tokens_recorded_as_success":false,"raw_rollback_note":"Restored /private/work/acme session state; do not replay stale tool results or payment payload."}
+{"type":"context.compaction.transaction.completed","time":"2026-05-26T10:58:10.000Z","transaction_id":"compact-txn-2026-05-26-private-acme","status":"rolled_back","authoritative_state":"pre_compaction_context","context_token_count_after":151400,"deferred_tool_registry_count_after":43,"pending_system_reminder_count_after":19,"audit_gap":"proves transaction boundary and rollback flags, not semantic completeness of the preserved context","raw_operator_summary":"Compaction failed safely; active task still contains Acme-Co private checkout details and must not be logged."}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pluribus-context",
-  "version": "0.3.31",
+  "version": "0.3.32",
   "description": "AI context and rules sync CLI for Claude.md, Claude Code, Cursor, and Copilot instructions, with privacy-safe context receipts that prove what memory, tools, skills, compactions, and security findings crossed agent boundaries without logging raw content.",
   "type": "module",
   "homepage": "https://github.com/caioribeiroclw-pixel/pluribus#readme",

package/src/utils/version.js

@@ -1 +1 @@
-export const VERSION = '0.3.31'
+export const VERSION = '0.3.32'