Files
planning-with-files/scripts/ledger-summary.ps1
T
OthmanAdi 3160256d2e fix: read an empty active pointer as empty and send Cursor hook output as UTF-8
Get-Content -Raw returns nothing for a zero-byte .active_plan, and the
[string] cast of that result is still $null, so resolve-plan-dir.ps1,
ledger-append.ps1, ledger-summary.ps1 and phase-status.ps1 raised on .Trim().
Run standalone the resolver still printed its answer and exited 0; called
in-process by the Cursor context helper the exception unwound it first, and
the route refused where every canonical route falls through to the newest
plan or the root plan. The pointer is now read through string interpolation,
which yields an empty string, in all shipped copies.

The Cursor PowerShell hooks set the console output encoding to UTF-8 before
printing. Under the OEM code page both Windows PowerShell 5.1 and pwsh sent
the em-dash as "-" and non-ASCII plan text as "?" or CP437 bytes.

resolve-plan-context.ps1 keeps a containment refusal silent, as inject-plan.sh
does, and the broken-pin notice uses the canonical wording, since the
PowerShell check is the canonical absolute-local-directory check.

Parity rows 07c, 27 and 28 from the v3.20.0 review are regression fixtures.
2026-09-17 23:09:26 +02:00

144 lines
5.2 KiB
PowerShell

#requires -Version 5.0
<#
.SYNOPSIS
Emit a fixed-shape, cache-stable run-ledger summary (PowerShell mirror, v3).
.DESCRIPTION
Replaces raw progress.md tail injection in autonomous mode. Output is
synthesized from the machine ledger and task_plan.md status counts only:
NO free text from disk reaches model context, and NO timestamps, so the
injected block is KV-cache stable by construction (architecture C3).
Plan-dir resolution matches resolve-plan-dir.ps1:
1. $env:PLAN_ID -> .\.planning\$PLAN_ID\
2. .\.planning\.active_plan
3. Newest .\.planning\<dir>\ by LastWriteTime
4. Legacy: project root
Output block (stable shape):
=== RUN LEDGER ===
entries: <N>
phases: <complete>/<total> complete
in_progress: <phase heading or none>
agent <name>: <last event type>
==================
#>
[CmdletBinding()]
param()
$ErrorActionPreference = "Stop"
function Resolve-PlanDir {
$planRoot = Join-Path (Get-Location) ".planning"
# A set PLAN_ID is a BINDING, not a hint (issue #237). A selector that
# names no plan directory stops resolution instead of falling through to
# .active_plan, newest-by-mtime and finally the cwd: summarizing another
# plan's ledger under a mistyped pin is the same wrong-plan harm that let
# a typo attest the wrong file.
if ($env:PLAN_ID) {
$candidate = Join-Path $planRoot $env:PLAN_ID
if (Test-Path -LiteralPath $candidate -PathType Container) { return $candidate }
return $null
}
$activePointer = Join-Path $planRoot ".active_plan"
if (Test-Path -LiteralPath $activePointer) {
$planId = "$(Get-Content -LiteralPath $activePointer -Raw -ErrorAction SilentlyContinue)".Trim()
if ($planId) {
$candidate = Join-Path $planRoot $planId
if (Test-Path -LiteralPath $candidate -PathType Container) { return $candidate }
}
}
if (Test-Path -LiteralPath $planRoot -PathType Container) {
$newest = Get-ChildItem -LiteralPath $planRoot -Directory -ErrorAction SilentlyContinue |
Where-Object { -not $_.Name.StartsWith(".") } |
Where-Object { Test-Path -LiteralPath (Join-Path $_.FullName "task_plan.md") } |
Sort-Object LastWriteTime -Descending |
Select-Object -First 1
if ($newest) { return $newest.FullName }
}
return (Get-Location).Path
}
$planDir = Resolve-PlanDir
if (-not $planDir) {
# Loud degradation, same contract as ledger-summary.sh's emit_unavailable:
# a rejected PLAN_ID binding must not report the ROOT plan's phase counts,
# because an autonomous loop reads those counts as its termination signal.
Write-Output "=== RUN LEDGER ==="
Write-Output "ledger: unavailable (explicit PLAN_ID did not resolve)"
Write-Output "=================="
exit 0
}
$planFile = Join-Path $planDir "task_plan.md"
# --- Phase counts: same patterns as check-complete.ps1 ---
$TOTAL = 0
$COMPLETE = 0
$IN_PROGRESS = 0
$inProgressHeading = "none"
if (Test-Path -LiteralPath $planFile) {
$content = Get-Content -LiteralPath $planFile -Raw
$TOTAL = ([regex]::Matches($content, "### Phase")).Count
$COMPLETE = ([regex]::Matches($content, "\*\*Status:\*\* complete")).Count
$IN_PROGRESS = ([regex]::Matches($content, "\*\*Status:\*\* in_progress")).Count
if ($COMPLETE -eq 0 -and $IN_PROGRESS -eq 0) {
$c2 = ([regex]::Matches($content, "\[complete\]")).Count
$i2 = ([regex]::Matches($content, "\[in_progress\]")).Count
if ($c2 -gt 0 -or $i2 -gt 0) {
$COMPLETE = $c2
$IN_PROGRESS = $i2
}
}
# Heading of the first phase block whose status is in_progress.
$heading = ""
foreach ($line in (Get-Content -LiteralPath $planFile)) {
if ($line -match "^### Phase") {
$heading = $line
} elseif ($line -match "\*\*Status:\*\* in_progress" -or $line -match "\[in_progress\]") {
if ($heading) {
$inProgressHeading = $heading
break
}
}
}
}
# --- Ledger stats ---
$totalEntries = 0
$ledgerFiles = Get-ChildItem -LiteralPath $planDir -Filter "ledger-*.jsonl" -File -ErrorAction SilentlyContinue
foreach ($f in $ledgerFiles) {
$lines = Get-Content -LiteralPath $f.FullName -ErrorAction SilentlyContinue
foreach ($line in $lines) {
if ($line -match '"tick"') { $totalEntries++ }
}
}
Write-Output "=== RUN LEDGER ==="
Write-Output ("entries: " + $totalEntries)
Write-Output ("phases: " + $COMPLETE + "/" + $TOTAL + " complete")
Write-Output ("in_progress: " + $inProgressHeading)
foreach ($f in $ledgerFiles) {
$agent = $f.Name -replace '^ledger-', '' -replace '\.jsonl$', ''
# @(...) forces array semantics: a single-line file returns a string from
# Get-Content and $lines[-1] would otherwise index the last character.
$lines = @(Get-Content -LiteralPath $f.FullName -ErrorAction SilentlyContinue)
$lastEvent = "none"
if ($lines.Count -gt 0) {
$lastLine = $lines[$lines.Count - 1]
$m = [regex]::Match($lastLine, '"event"\s*:\s*"([A-Za-z_]+)"')
if ($m.Success) { $lastEvent = $m.Groups[1].Value }
}
Write-Output ("agent " + $agent + ": " + $lastEvent)
}
Write-Output "=================="
exit 0