portable-agent-layer 0.54.1 → 0.54.3

package/assets/statusline.ps1

@@ -9,6 +9,27 @@ $USED_RAW = $data.context_window.used_percentage
 $USED = if ($USED_RAW -ne $null) { [int]$USED_RAW } else { 0 }
 $REM_RAW = $data.context_window.remaining_percentage
 $REM = if ($REM_RAW -ne $null) { [int]$REM_RAW } else { 0 }
+$TOTAL_INPUT = $data.context_window.total_input_tokens
+$WINDOW_SIZE = $data.context_window.context_window_size
+
+# Honor CLAUDE_CODE_AUTO_COMPACT_WINDOW: Claude's used_percentage is measured
+# against the full model window, but auto-compact triggers at this token cap -
+# so recompute usage against the effective (capped) window when it is set.
+# Gated on CLAUDECODE (injected only by Claude Code) - the cap is a user shell
+# export that would otherwise leak into Cursor, which does not auto-compact.
+$autoCompact = $env:CLAUDE_CODE_AUTO_COMPACT_WINDOW
+if ($env:CLAUDECODE -and $autoCompact -and ($autoCompact -as [int]) -gt 0) {
+  $effectiveWindow = [int]$autoCompact
+  if (($WINDOW_SIZE -ne $null) -and ($effectiveWindow -gt [int]$WINDOW_SIZE)) { $effectiveWindow = [int]$WINDOW_SIZE }
+  $usedTokens = $null
+  if ($TOTAL_INPUT -ne $null) { $usedTokens = [int]$TOTAL_INPUT }
+  elseif (($WINDOW_SIZE -ne $null) -and ($USED_RAW -ne $null)) { $usedTokens = [int]([int]$USED_RAW * [int]$WINDOW_SIZE / 100) }
+  if ($usedTokens -ne $null) {
+    $USED = [int]($usedTokens * 100 / $effectiveWindow)
+    if ($USED -gt 100) { $USED = 100 }
+    $REM = 100 - $USED
+  }
+}
 $COST_RAW = $data.cost.total_cost_usd
 $COST = if ($COST_RAW -ne $null) { [double]$COST_RAW } else { 0 }
 $CWD = if ($data.workspace.current_dir) { $data.workspace.current_dir } else { "~" }

package/assets/statusline.sh

@@ -15,6 +15,8 @@ USED_RAW=$(echo "$input" | jq -r '.context_window.used_percentage // empty')
 REM_RAW=$(echo "$input" | jq -r '.context_window.remaining_percentage // empty')
 USED=$( [ -n "$USED_RAW" ] && echo "${USED_RAW%.*}" || echo 0 )
 REMAINING=$( [ -n "$REM_RAW" ] && echo "${REM_RAW%.*}" || echo 0 )
+TOTAL_INPUT=$(echo "$input" | jq -r '.context_window.total_input_tokens // empty')
+WINDOW_SIZE=$(echo "$input" | jq -r '.context_window.context_window_size // empty')
 CWD=$(echo "$input" | jq -r '.workspace.current_dir // .cwd // "~"')
 REPO=$(echo "$input" | jq -r '.workspace.repo.name // ""')
 
@@ -24,6 +26,27 @@ if [ -z "$USED_RAW" ] && [ -z "$REM_RAW" ]; then
   REMAINING=100
 fi
 
+# Honor CLAUDE_CODE_AUTO_COMPACT_WINDOW: Claude's used_percentage is measured
+# against the full model window, but auto-compact triggers at this token cap —
+# so recompute usage against the effective (capped) window when it is set.
+# Gated on CLAUDECODE (injected only by Claude Code) — the cap is a user shell
+# export that would otherwise leak into Cursor, which does not auto-compact.
+if [ -n "$CLAUDECODE" ] && [ -n "$CLAUDE_CODE_AUTO_COMPACT_WINDOW" ] && [ "$CLAUDE_CODE_AUTO_COMPACT_WINDOW" -gt 0 ] 2>/dev/null; then
+  EFFECTIVE_WINDOW=$CLAUDE_CODE_AUTO_COMPACT_WINDOW
+  if [ -n "$WINDOW_SIZE" ] && [ "$EFFECTIVE_WINDOW" -gt "$WINDOW_SIZE" ] 2>/dev/null; then
+    EFFECTIVE_WINDOW=$WINDOW_SIZE
+  fi
+  USED_TOKENS="$TOTAL_INPUT"
+  if [ -z "$USED_TOKENS" ] && [ -n "$WINDOW_SIZE" ] && [ -n "$USED_RAW" ]; then
+    USED_TOKENS=$(( ${USED_RAW%.*} * WINDOW_SIZE / 100 ))
+  fi
+  if [ -n "$USED_TOKENS" ]; then
+    USED=$(( USED_TOKENS * 100 / EFFECTIVE_WINDOW ))
+    [ "$USED" -gt 100 ] && USED=100
+    REMAINING=$(( 100 - USED ))
+  fi
+fi
+
 # Git branch — payload first, then git in cwd
 BRANCH=$(echo "$input" | jq -r '.worktree.branch // .worktree.name // ""')
 if [ -z "$BRANCH" ] || [ "$BRANCH" = "null" ]; then

package/assets/templates/PAL/STEERING_RULES.md

@@ -49,3 +49,8 @@ Correct: Memory says user dislikes verbose summaries → you keep the summary to
 **Don't trust, verify.** When adding a test or asserting a change works, prove it by making it fail first. A test that passes without ever being broken demonstrates nothing — it may be testing the wrong thing or nothing at all. Break it intentionally, confirm it fails for the right reason, then restore it.
 Bad: Add a test, see it green, move on. The test may pass vacuously.
 Correct: Add the test → run it green → break the code it covers → confirm it goes red → restore → now it's a real test.
+
+**Functions, not comments.** Encode intent in small, well-named, self-contained functions instead of explanatory comments. Comments cost tokens, drift from the code they describe, and can lie; a name is enforced by the call site. When tempted to write a comment explaining *why* a block does what it does, extract that block into a function whose name carries the why. The ONLY acceptable comment is a fact about an external system that code genuinely cannot encode — an SDK/protocol/service quirk (EventBridge, S3, a required HTTP header) — and even those should be rare and live at a single file location, not scattered.
+Bad: `// Mark scheduled BEFORE creating the schedule so a failed write can't orphan it` above an inline update + create + rollback block.
+Correct: `getOwnedPostState()` → `setPostState("scheduled")` → `registerSchedule()` → on failure `setPostState(previous)`. The ordering and rollback ARE the explanation.
+Exception: `// X-Restli-Protocol-Version: 2.0.0 — without it LinkedIn replies in Rest.li 1.0 shape` — an external contract the code can't express.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "portable-agent-layer",
-  "version": "0.54.1",
+  "version": "0.54.3",
   "description": "PAL — Portable Agent Layer: persistent personal context for AI coding assistants",
   "type": "module",
   "bin": {