pi-smart-compact 7.10.0 → 7.11.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/CHANGELOG.md CHANGED
@@ -1,5 +1,10 @@
1
1
  # Changelog
2
2
 
3
+ ## [7.11.0] - 2026-05-19
4
+
5
+ ### Changed
6
+ - **README compatibility guidance** — Added a prominent note documenting conflict-prone extension behavior around compaction hooks, session/branch history, message and tool metadata, tool output rewriting, compaction boundaries, and session log storage. Also clarified that `pi-smart-compact` is recommended alongside `pi-toolkit` for complementary context hygiene and verified compaction.
7
+
3
8
  ## [7.10.0] - 2026-05-19
4
9
 
5
10
  ### Added
package/README.md CHANGED
@@ -37,6 +37,25 @@ The extension stages a short-lived pending summary in memory, then hands it back
37
37
 
38
38
  ---
39
39
 
40
+ ## Compatibility note
41
+
42
+ `pi-smart-compact` sits close to Pi's compaction path: it registers `session_before_compact`, reads the active branch and session log, stages a pending summary, and may call Pi's native compaction flow from `/smart-compact`.
43
+
44
+ Because of that, use extra care with extensions that also manipulate:
45
+
46
+ - **compaction hooks** — especially extensions that return a custom result from `session_before_compact`
47
+ - **session / branch history** — rewriting, pruning, reordering, or replacing entries before compaction
48
+ - **message identity** — removing entry IDs, tool-call IDs, or tool-result metadata used to align log entries
49
+ - **tool output content** — truncating or rewriting `toolResult` messages before extraction
50
+ - **compaction boundaries** — moving the keep/discard split or splitting `toolCall` / `toolResult` pairs
51
+ - **session log storage** — replacing or deleting Pi's `.jsonl` logs under `~/.pi/agent/sessions`
52
+
53
+ It is intentionally compatible with, and recommended alongside, [`pi-toolkit`](https://github.com/ersintarhan/pi-toolkit): pi-toolkit handles everyday context hygiene such as anchors, pivots, status lines, and old tool-output trimming; `pi-smart-compact` handles high-pressure verified compaction. The integration protects recent pi-toolkit anchors and can recover original tool outputs from the session log when older tool results were trimmed.
54
+
55
+ If you use another automatic compaction or context-rewriting extension, prefer enabling only one `session_before_compact` owner unless the hook order and returned values are explicitly coordinated.
56
+
57
+ ---
58
+
40
59
  ## Why it exists
41
60
 
42
61
  Default compaction often loses the parts that matter most during coding work:
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "pi-smart-compact",
3
- "version": "7.10.0",
3
+ "version": "7.11.0",
4
4
  "description": "EESV smart compaction extension for Pi Coding Agent — deterministic extraction, exploration, synthesis, verification with redundancy pruning, project fingerprinting, and damage detection.",
5
5
  "license": "MIT",
6
6
  "main": "./dist/index.js",