pstack-claude-mirror 0.9.134 → 0.9.135

package/.claude-plugin/marketplace.json

@@ -10,7 +10,7 @@
       "name": "pstack",
       "source": "./plugins/pstack",
       "description": "If you want to go fast, go deep first. pstack helps you write less, but higher quality code. rigorous agent workflows you can parallelize with confidence. Original pstack by Lauren Tan (poteto).",
-      "version": "0.9.134"
+      "version": "0.9.135"
     }
   ]
 }

package/CHANGES.md

@@ -2,6 +2,14 @@
 
 This file is the release changelog, with one `## <version> - <title>` entry per release, newest first. The Cursor-to-Claude rewrite rules live in [`tools/substitutions.json`](tools/substitutions.json), and the [sync boundary](CONTRIBUTING.md#the-sync-boundary) in `CONTRIBUTING.md` defines how a change to upstream's skill content is declared.
 
+## 0.9.135 - worktree audit reads compressed Codex rollouts
+
+`worktree-audit.mjs` now reads the `.jsonl.zst` rollouts under Codex's `sessions` and `archived_sessions`. It used to skip them, so a worktree whose latest chat sat in a compressed rollout showed no LAST_CHAT and could be reported safe. Plain `.jsonl` transcripts are read as before, and `find-transcript.mjs` lists compressed files only for a caller that passes `includeCompressed`, so the **reflect** skill's search is unchanged. @EthanYoQ found and fixed this in [#425](https://github.com/michael-denyer/pstack-claude/pull/425).
+
+The audit decodes in the process with `zlib.zstdDecompressSync` when that decoder reads every frame of a file and rejects a truncated one. It checks both once at start-up. Node 26.13.0 passes the check. Bun 1.4.4 returns the partial output of a truncated frame without an error, so the audit runs the `zstd` command there, as it does on a Node that has no Zstd decoder. Only a machine that has compressed rollouts needs a decoder.
+
+A compressed rollout that cannot be decoded, because it is corrupt or truncated or because no decoder is available, leaves LAST_CHAT unknown for every worktree. The audit warns `transcript scan failed` with the file's path, and no worktree reaches safe until the file decodes or is removed.
+
 ## 0.9.134 - Fable 5.2 on Pi, Pi 1.5.1 as the oldest supported Pi
 
 On Pi, the `anthropic` provider's `fable` role runs `claude-fable-5-2`, where it ran `claude-fable-5-1`. A session on a provider that has no table of its own uses the `anthropic` table, so its `fable` role changes too. Claude Code sessions need no change, because Claude Code 2.1.321 moved its own `fable` alias to Fable 5.2. The model first appears in Pi 1.5.1's catalog. Pi 1.5.0 does not have it. It warns `Model "claude-fable-5-2" not found for provider "anthropic". Using custom model id.` and runs that ID with the context window, pricing, and thinking settings of the provider's default model. To stay on Fable 5.1, add the line `pi models: fable=anthropic/claude-fable-5-1` to the override sheet.

package/README.md

@@ -9,10 +9,10 @@
 
 | | |
 |---|---|
-| Package version | `0.9.134` |
-| Upstream plugin version | `0.9.134` |
-| Upstream ref | `v0.9.134` |
-| Upstream commit | `a691bd30341289b9c7eae8e5b4da28a400ea2423` (2026-11-10T17:42:12Z) |
+| Package version | `0.9.135` |
+| Upstream plugin version | `0.9.135` |
+| Upstream ref | `v0.9.135` |
+| Upstream commit | `bc09365fe61c725c486ba95157fc4048bf8a0b99` (2026-11-11T00:19:58Z) |
 | Marketplace / plugin | `pstack@pstack-claude` |
 
 The package contains the upstream marketplace exactly as published (`.claude-plugin/marketplace.json` + `plugins/pstack/`) plus a small installer. No install scripts run on `npm install`.

package/UPSTREAM-README.md

@@ -47,7 +47,7 @@ Invoke a skill by typing `$` and its name, such as `$poteto-mode` or `$babysit`,
 <details>
 <summary><strong>Pi</strong></summary>
 
-Run in your terminal:
+Run in your terminal, with Pi 1.5.1 or later:
 
 ```shell
 pi install git:github.com/michael-denyer/pstack-claude

package/docs/reference.md

@@ -62,7 +62,7 @@ All runtimes share [one skills tree](../plugins/pstack/skills/). A skills-only i
 | --- | --- |
 | Claude Code | Install the marketplace plugin (Claude Code 2.1.292 or later). Skills use Claude tool names and model defaults; the plugin installs automatic routing. |
 | Codex | Install the native plugin through the repository's marketplace and trust its hook through `/hooks`. The [Codex mapping](../plugins/pstack/skills/poteto-mode/references/codex-tools.md) translates Claude tools and model names. Shared skill symlinks were also detected in a live session. |
-| Pi | Install the repository as a Pi package with `pi install`. The [Pi extension](../plugins/pstack/pi/index.ts) registers the subagent, question, and wake-up tools and `/loop`, and the [Pi mapping](../plugins/pstack/skills/poteto-mode/references/pi-tools.md) translates Claude tools and model names. The [equivalence table](pi-equivalence.md) records each Claude Code mechanism and how it was verified on Pi 1.5.1. |
+| Pi | Install the repository as a Pi package with `pi install` (Pi 1.5.1 or later). The [Pi extension](../plugins/pstack/pi/index.ts) registers the subagent, question, and wake-up tools and `/loop`, and the [Pi mapping](../plugins/pstack/skills/poteto-mode/references/pi-tools.md) translates Claude tools and model names. The [equivalence table](pi-equivalence.md) records each Claude Code mechanism and how it was verified on Pi 1.5.1. |
 | GitHub Copilot | Install the plugin through the repository's marketplace; the CLI and the GitHub Copilot app share it. The [Copilot mapping](../plugins/pstack/skills/poteto-mode/references/copilot-tools.md) translates Claude tools, paths, and model roles, and maps app-only tools to CLI fallbacks. Install, routing, agent dispatch, and first-run setup are smoke-tested on the CLI; see [GitHub Copilot](#github-copilot). |
 | Muse | Install the native plugin bundle with `muse plugins install`, then approve its hooks and agent definitions with `muse plugins approve pstack`. The [Muse mapping](../plugins/pstack/skills/poteto-mode/references/muse-tools.md) translates Claude tools, subagents, transcripts, and model roles. See [Muse](#muse). |
 | OMP | Install through the marketplace as described in the [README](../README.md#install). The [OMP mapping](../plugins/pstack/skills/poteto-mode/references/omp-tools.md) covers tools and model roles. On OMP 18.16.0, installation from a local marketplace, skill access, and the routing toggle were verified with a synthetic provider; model compliance has not been tested. |

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "pstack-claude-mirror",
-  "version": "0.9.134",
-  "description": "[Unofficial GitHub mirror] Unmodified copy of https://github.com/michael-denyer/pstack-claude @ v0.9.134 (pstack skills/plugin for OMP, Claude Code, Pi), republished on npm for networks without GitHub access. Not published by or affiliated with the upstream author. Report mirror packaging and installer bugs to the mirror repository; report plugin-content bugs upstream.",
+  "version": "0.9.135",
+  "description": "[Unofficial GitHub mirror] Unmodified copy of https://github.com/michael-denyer/pstack-claude @ v0.9.135 (pstack skills/plugin for OMP, Claude Code, Pi), republished on npm for networks without GitHub access. Not published by or affiliated with the upstream author. Report mirror packaging and installer bugs to the mirror repository; report plugin-content bugs upstream.",
   "license": "MIT",
   "homepage": "https://github.com/michael-denyer/pstack-claude",
   "repository": {
@@ -94,14 +94,14 @@
   "pstackMirror": {
     "notice": "Unofficial mirror. Content is copied unchanged from the upstream GitHub repository; only bin/, README.md, LICENSE-mirror and package.json are added by the mirror (MIT, see LICENSE-mirror). Upstream copyright and license notices are preserved unchanged.",
     "upstream": "https://github.com/michael-denyer/pstack-claude.git",
-    "upstreamVersion": "0.9.134",
+    "upstreamVersion": "0.9.135",
     "upstreamAuthor": {
       "name": "Michael Denyer",
       "url": "https://github.com/michael-denyer"
     },
-    "ref": "v0.9.134",
-    "commit": "a691bd30341289b9c7eae8e5b4da28a400ea2423",
-    "commitDate": "2026-11-10T17:42:12Z",
+    "ref": "v0.9.135",
+    "commit": "bc09365fe61c725c486ba95157fc4048bf8a0b99",
+    "commitDate": "2026-11-11T00:19:58Z",
     "marketplace": "pstack-claude",
     "plugin": "pstack"
   }

package/plugins/pstack/.antigravity-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "pstack",
-  "version": "0.9.134",
+  "version": "0.9.135",
   "description": "If you want to go fast, go deep first. pstack helps you write less, but higher quality code. rigorous agent workflows you can parallelize with confidence. Ported from cursor/plugins/pstack to Antigravity. Original pstack by Lauren Tan (poteto).",
   "author": "Michael Denyer",
   "logo": "assets/pstack-icon.png",

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

@@ -1,7 +1,7 @@
 {
   "name": "pstack",
   "displayName": "pstack (Claude Code port)",
-  "version": "0.9.134",
+  "version": "0.9.135",
   "description": "If you want to go fast, go deep first. pstack helps you write less, but higher quality code. rigorous agent workflows you can parallelize with confidence. Ported from cursor/plugins/pstack to Claude Code. Original pstack by Lauren Tan (poteto).",
   "author": {
     "name": "Michael Denyer",

package/plugins/pstack/.codex-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "pstack",
-  "version": "0.9.134",
+  "version": "0.9.135",
   "description": "If you want to go fast, go deep first. pstack helps you write less, but higher quality code. rigorous agent workflows you can parallelize with confidence. Codex port of the Claude Code plugin; skills are shared, tool names resolve via skills/poteto-mode/references/codex-tools.md. Original pstack by Lauren Tan (poteto).",
   "author": {
     "name": "Michael Denyer",

package/plugins/pstack/.github/plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "name": "pstack",
   "displayName": "pstack (GitHub Copilot port)",
-  "version": "0.9.134",
+  "version": "0.9.135",
   "description": "If you want to go fast, go deep first. pstack helps you write less, but higher quality code. rigorous agent workflows you can parallelize with confidence. Ported from cursor/plugins/pstack to GitHub Copilot CLI and app. Original pstack by Lauren Tan (poteto).",
   "author": {
     "name": "Michael Denyer",

package/plugins/pstack/.grok-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "pstack",
-  "version": "0.9.134",
+  "version": "0.9.135",
   "description": "pstack workflows and skills for Grok Build",
   "skills": [
     "./skills",

package/plugins/pstack/.muse-plugin/plugin.json

@@ -2,7 +2,7 @@
   "schemaVersion": 1,
   "name": "pstack",
   "displayName": "pstack (Muse port)",
-  "version": "0.9.134",
+  "version": "0.9.135",
   "description": "If you want to go fast, go deep first. pstack helps you write less, but higher quality code. Rigorous agent workflows you can parallelize with confidence. Muse port of the Claude Code plugin; skills are shared, tool names resolve via skills/poteto-mode/references/muse-tools.md. Original pstack by Lauren Tan (poteto).",
   "compat": {
     "source": "native",

package/plugins/pstack/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pstack",
-  "version": "0.9.134",
+  "version": "0.9.135",
   "private": true,
   "omp": {
     "extensions": ["./omp/index.mjs"]

package/plugins/pstack/skills/poteto-mode/scripts/worktree-audit.mjs

@@ -12,6 +12,10 @@
 // and archived_sessions under $CODEX_HOME, and Pi's sessions and pstack subagent
 // sessions under $PI_CODING_AGENT_DIR (defaults: ~/.claude, ~/.codex, ~/.pi/agent).
 //
+// Compressed rollouts use native Zstd when it reads complete streams. Other
+// runtimes fall back to zstd on PATH. A decode failure makes the whole chat
+// scan unknown, so no worktree can be declared safe from that scan.
+//
 // Every probe yields a Fact, { known: true, value } or { known: false }. A hold
 // bucket needs only its own fact; `safe` needs every fact known.
 import { execFileSync } from "node:child_process";
@@ -20,6 +24,7 @@ import { homedir } from "node:os";
 import { basename, dirname, join } from "node:path";
 import process from "node:process";
 import { fileURLToPath } from "node:url";
+import zlib from "node:zlib";
 
 import { candidates, rethrowUnlessRemoved } from "../../reflect/scripts/find-transcript.mjs";
 
@@ -199,11 +204,38 @@ function transcriptNeedles(spellings) {
   return [...new Set(forms)].map((form) => Buffer.from(JSON.stringify(form).slice(1, -1)));
 }
 
+// Bun 1.4.4 returns the partial output of a truncated frame without an error,
+// and nodejs/node#64592 reports the same for Node. The check also turns down a
+// decoder that stops after the first frame. It runs once, not once per transcript.
+function nativeZstdDecoder() {
+  const decode = zlib.zstdDecompressSync;
+  if (typeof decode !== "function") return undefined;
+  // A complete Zstd frame containing "a", independent of compressor availability.
+  const frame = Buffer.from("28b52ffd200109000061", "hex");
+  const joined = Buffer.concat([frame, frame]);
+  try {
+    if (decode(joined).toString() !== "aa") return undefined;
+  } catch {
+    return undefined;
+  }
+  for (const partial of [frame.subarray(0, -1), joined.subarray(0, -1)]) {
+    try {
+      decode(partial);
+      return undefined;
+    } catch { /* A complete-stream decoder must reject an unfinished frame. */ }
+  }
+  return decode;
+}
+
+const decodeZstd = nativeZstdDecoder() ?? ((input) => execFileSync("zstd", ["-d", "-c"], {
+  input, stdio: ["pipe", "pipe", "pipe"], maxBuffer: Infinity, timeout: 30_000,
+}));
+
 // `spellings` maps each worktree path to every spelling a session could use.
 export function lastChats(roots, spellings) {
   const needles = [...spellings].map(([path, forms]) => [path, transcriptNeedles(forms)]);
   const latest = new Map();
-  for (const { path: file } of roots.flatMap((root) => candidates(root, Infinity))) {
+  for (const { path: file } of roots.flatMap((root) => candidates(root, Infinity, { includeCompressed: true }))) {
     let text, mtime;
     try {
       text = readFileSync(file);
@@ -214,6 +246,15 @@ export function lastChats(roots, spellings) {
       rethrowUnlessRemoved(error);
       continue;
     }
+    if (file.endsWith(".jsonl.zst")) {
+      try {
+        text = decodeZstd(text);
+      } catch (error) {
+        // A missing fallback executable is not a transcript removed during enumeration.
+        const hint = error.code === "ENOENT" ? " Use a runtime with complete native Zstd support or install zstd." : "";
+        throw new Error(`cannot decode ${file}: ${String(error.stderr ?? "").trim() || error.message}${hint}`);
+      }
+    }
     for (const [path, forms] of needles) {
       if (mtime > (latest.get(path) ?? 0) && forms.some((needle) => mentions(text, needle))) latest.set(path, mtime);
     }

package/plugins/pstack/skills/reflect/scripts/find-transcript.mjs

@@ -38,12 +38,12 @@ export function rethrowUnlessRemoved(error) {
   if (error.code !== "ENOENT") throw error;
 }
 
-export function candidates(projectsDir, maxDepth = 2) {
+export function candidates(projectsDir, maxDepth = 2, { includeCompressed = false } = {}) {
   const files = [];
   const walk = (dir, depth) => {
     for (const entry of readdirSync(dir, { withFileTypes: true })) {
       const full = join(dir, entry.name);
-      if (entry.isFile() && entry.name.endsWith(".jsonl")) files.push(full);
+      if (entry.isFile() && (entry.name.endsWith(".jsonl") || (includeCompressed && entry.name.endsWith(".jsonl.zst")))) files.push(full);
       else if (entry.isDirectory() && depth < maxDepth) {
         try {
           walk(full, depth + 1);