pi-better-harness 0.41.2 → 0.42.0

package/README.md

@@ -22,18 +22,22 @@ Use `pi-better-harness` when you want the full working set for Pi. It manages:
 
 In `/harness-settings`, **Outcome & Todo display** (`outcome-todo-display`)
 defaults to **On**, and **Outcome & Todo hooks** (`outcome-todo`) defaults to
-**Off**. Saved outcomes and checklists display even when hooks are off; missing
-state creates no placeholder, state, or settings. Turning display off does not
-disable hooks. Saved v1 `enabled` remains the hooks authority; the new optional
-display preference defaults to true.
+**Off**. **Long-term work ledger** (`outcome-todo-ledger`) is a third independent
+control and defaults to **Off**. Saved outcomes and checklists display even when
+hooks are off; missing state creates no placeholder, state, or settings. Turning
+display off does not disable hooks. Saved v1 `enabled` remains the hooks
+authority; the optional display and ledger preferences default to their existing
+or conservative values.
 
 The compact widget has one Todo heading, with a caret after Todo and the completion
 count on the left. A matching Goal's status and existing active-time clock appear
 on the right. The outcome is one muted, truncated subtitle. The collapsed view
 shows up to five relevant rows; the expanded view shows all rows. Click to toggle.
-`/todo` shows the full objective, acceptance criteria, boundaries, and plan;
-`/todo expand` and `/todo collapse` also control the compact checklist. Todo
-commands remain available with hooks off for explicit user control.
+`/todo` reveals the compact Overview (when display is on) and returns it to automatic display;
+`/todo expand` and `/todo collapse` control which rows it shows. The full
+objective, acceptance criteria, boundaries, and plan remain available through
+`get_todo` when hooks are enabled. Todo commands remain available with hooks off
+for explicit user control.
 
 An accepted outcome can be saved without a checklist. Completing or clearing its
 Todo does not complete or remove the outcome. Write labels as short, plain actions,
@@ -45,8 +49,9 @@ existing saved labels remain unchanged until deliberately updated.
 Use `newTask: true` with a new
 outcome for unrelated work; a correction to the current task keeps its binding.
 Hooks enable `update_todo`, `get_todo`, capture, matching Goal lifecycle bridge
-writes, reminders, and automated cleanup. While hooks are enabled and the outcome is active, Harness
-includes a short reminder before each model call. Turning hooks off stops those
+writes, outcome updates, and automated cleanup. With hooks enabled, Harness records
+a hidden, persistent outcome update at the next agent start only when its content
+changes. It does not rebuild reminders before each model call. Turning hooks off stops those
 hooks without deleting saved state or starting a turn. `/goal` and skills never
 enable them.
 
@@ -54,6 +59,21 @@ Existing Plan session histories restore as Todo. Workflow task-plan files and
 revision checks stay unchanged; skills continue using their own records when the
 optional interface is off. See the [usage guide](docs/usage.md#outcome--todo).
 
+The separate **Long-term work ledger** setting enables a durable project-scoped
+record of the overall outcome, boundaries, and high-level items. It stays off by
+default; turning it off removes ledger views and hints without deleting records.
+The same `update_todo` / `get_todo` interface carries optional ledger payloads and
+selectors for create, update, attach, detach, list, and read. Updates require the
+current revision, preserve completed evidence and history, and never associate old
+work with a new session automatically. Use `/ledger attach <id>` (or an explicit
+`update_todo` ledger attach) to continue the same record; `/ledger list`,
+`/ledger switch`, and `/ledger detach` manage the reference without copying it. A
+resumed session keeps its reference, a fresh session stays unassociated, and
+bounded recovery reminders after compaction or resume are rebuilt from durable
+state. Workflow-owned rows keep their canonical stage/status rendering; the
+ledger adds context, not a second execution model. See
+[usage](docs/usage.md#associate-a-ledger-with-a-session).
+
 Subagent and background-task rows can be clicked to open their existing navigator
 details. Enter and keyboard controls remain available, and editor input stays
 passive. Harness packages do not write to Pi's status bar. Goal holds and resume

package/extensions/task-context/compact-task-header.ts

@@ -5,6 +5,8 @@ export interface CompactTaskHeader {
   subtitle?: string;
   disclosure?: string;
   runtime?: { status: string; clock?: string };
+  /** Preformatted high-level ledger counts shown in the existing Todo surface. */
+  ledger?: string;
 }
 
 export function canRenderTaskRuntime(width: number, runtime: CompactTaskHeader["runtime"]): boolean {
@@ -26,10 +28,16 @@ export function renderCompactTaskHeader(summary: string | undefined, width: numb
     ? title + " ".repeat(Math.max(2, size - visibleWidth(title) - rightWidth)) + right
     : truncateToWidth(left, size);
   const lines = [truncateToWidth(heading, size)];
+  const indent = Math.min(2, size - 1);
+  const details: string[] = [];
   if (header.subtitle) {
-    const indent = Math.min(2, size - 1);
     const text = header.subtitle.replace(/[\r\n\t]+/g, " ").replace(/ {2,}/g, " ").trim();
-    lines.push(" ".repeat(indent) + theme.fg("muted", truncateToWidth(text, size - indent)), "");
+    details.push(" ".repeat(indent) + theme.fg("muted", truncateToWidth(text, size - indent)));
   }
+  if (header.ledger) {
+    const text = header.ledger.replace(/[\r\n\t]+/g, " ").replace(/ {2,}/g, " ").trim();
+    details.push(" ".repeat(indent) + theme.fg("dim", truncateToWidth(text, size - indent)));
+  }
+  if (details.length > 0) lines.push(...details, "");
   return lines;
 }