@signalridge/pi-workflows 1.8.0 → 1.10.0

package/CHANGELOG.md

@@ -1,5 +1,20 @@
 # Changelog
 
+## 1.10.0
+### Minor Changes
+
+- a4dc1de: Expose optional session/branch-owned status navigation to the existing workflow navigator and add compact run-authoritative footer counts without changing execution or widget behavior.
+
+## 1.9.0
+### Minor Changes
+
+- 2c7f8f1: Add live, keyboard-controllable workflow inspection with stable run selection, phase and call drill-down, bounded result views, and state-aware pause/resume/stop controls. Retain authoritative observed progress separately from durable journal facts, and preserve named nested-workflow resolution when resuming from controls or provider recovery.
+
+### Patch Changes
+
+- Updated dependencies [2c7f8f1]
+  - @signalridge/pi-subagents-protocol@1.6.0
+
 ## 1.8.0
 ### Minor Changes
 

package/README.md

@@ -241,6 +241,18 @@ workflow, and the review skill before accepting a topology or recovery change.
   `session_start` (Pi cannot unregister commands, so registration happens there
   rather than at factory time, and existing commands are never overwritten).
 
+### Live command center
+
+`/workflows` opens a live, explicitly focused navigator; `/workflows watch <runId>` opens that run directly. Outside TUI, watch reports a snapshot rather than occupying an uncancellable wait. Escape closes observation without stopping execution.
+
+Select a run, then a phase/task/call or its final result. Details have an independently scrollable viewport, while legal controls and help remain pinned. Navigation follows stable identities across updates, removal and resize. Use the displayed selection keybindings, Tab for controls, `p` to pause and `r` to resume. Stop is non-resumable and requires the displayed explicit confirmation; repeating a legacy-terminal key must not confirm it. A pending cleanup is not completion: the inspector keeps uncertainty visible and can recheck owned cleanup.
+
+Phase entry, task attempts and call attribution come from fenced runtime observations. Declared phases never prove completion, and restored journal-only facts do not invent historical labels or entered phases. Exact phase identities distinguish labels whose bounded display copies look the same. Logical calls, replayed calls and physical dispatches are separate counters. Presentation snapshots are detached and bounded; they contain no prompts or conversation histories.
+
+A selected root agent call can open its retained conversation through the subagent owner's optional exact-attempt UI endpoint. Unknown or reused old attempts are not redirected to a newer child. Workflow controls remain here; steering, child stop, sessions, model policy and foreground handoff remain in `pi-subagents`. The optional UI protocol does not change the required managed v4 handshake.
+
+The passive progress panel uses a terminal-height row budget, prioritizes live calls and reports overflow rather than growing as runs × calls. Names/results are sanitized only in display copies; journals and stored source remain unchanged. Fullscreen, regular terminal, RPC and print paths retain their distinct public API boundaries.
+
 ### Background result notifications
 
 Completed background runs are buffered in branch-local pending-delivery markers
@@ -342,7 +354,7 @@ generic reminder stripping is used. Regression tests exercise the real SDK,
 faux provider, and native user-message component, not a physical terminal or a
 live model service.
 
-Navigator/result metadata is sanitized only in display copies through `pi-ui`;
+Navigator, command-notification and result metadata is sanitized only in display copies through `pi-ui`;
 stored results and journals stay original. Detail screens keep actions reachable
 in a row-bounded viewport; PgUp/PgDn scroll the detail independently of ↑↓ actions.
 
@@ -532,3 +544,21 @@ used it.
 - **Schema validation is client-side.** The managed request does not assume a structured-output tool; the runtime asks for JSON, parses, validates (including `additionalProperties`), and repairs across bounded attempts.
 
 State is persisted as `pi.appendEntry("pi-workflows:journal", ...)` custom entries (schema v4), including frozen invocation args, resolved tier identity, terminal result previews, script revisions, named nested-workflow result boundaries, and durable removals. Interrupted/provider-limited runs replay from the journal; pre-schema-v4 journals are quarantined rather than replayed. Foreground `AbortSignal`s stop owned children through explicit owner-scoped stop/quiescence, and dispose/branch replacement reject stale waiters. Navigation preflight vetoes while agents or workflows are active or cleaning up, without interrupting them. An accepted tree commit fences old callbacks in either extension load order and restores only the committed branch; preflight itself is not a commit point.
+
+## Status navigation
+
+With a compatible status selector, **Ctrl+Alt+S**, choose **Workflow runs**, then
+**Enter** opens this package's existing workflow navigator. `/workflows` and its
+watch/detail paths remain unchanged. Querying this optional TUI-only endpoint
+never opens a screen, starts/resumes a run, or sends a model/user message. Each
+selection belongs to one live session/branch surface; navigation and reload
+retire it rather than redirecting an old selection to another owner. Only
+bounded identifiers and labels cross this presentation wire, not execution
+controls, source, logs, or callbacks.
+
+The compact `pi-workflows` footer reports `A` active runs (pending, running,
+pausing, stopping) and `P` paused/interrupted runs. With only retained terminal
+runs it reports `C` completed, `F` failed, and `S` stopped counts; an empty run
+list clears it. Counts reflect run status, never inferred child completion.
+This uses the existing progress refresh cadence without adding another widget
+or taking focus.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@signalridge/pi-workflows",
-  "version": "1.8.0",
+  "version": "1.10.0",
   "description": "Deterministic JavaScript orchestration workflows backed by pi-subagents managed spawning.",
   "type": "module",
   "license": "MIT",
@@ -21,7 +21,7 @@
     "@sinclair/typebox": "*"
   },
   "dependencies": {
-    "@signalridge/pi-subagents-protocol": "^1.5.1",
+    "@signalridge/pi-subagents-protocol": "^1.6.0",
     "@signalridge/pi-ui": "^1.4.0",
     "acorn": "^8.16.0"
   },

package/skills/workflow-authoring/SKILL.md

@@ -2,7 +2,7 @@
 name: workflow-authoring
 description: Design, write, review, and debug Pi JavaScript workflows that coordinate multiple subagents. Use when a request needs named dependencies, bounded fan-out, per-item pipelines, quality gates, saved or nested workflows, pause/resume, or workflow progress; do not use it merely to run an existing named workflow.
 metadata:
-  version: "1.8.0"
+  version: "1.10.0"
 ---
 
 # Workflow authoring

package/skills/workflow-authoring/references/capabilities.md

@@ -2,7 +2,7 @@
 # Workflow capability index
 
 Contract format: `2.0.0`<br>
-Contract content / skill / extension: `1.8.0`
+Contract content / skill / extension: `1.10.0`
 
 This compact generated index covers supported runtime globals and workflow-tool inputs. For constraints, compatibility behavior, internal boundaries, and dynamic-reference ownership, follow the [exhaustive generated facts](capability-details.md).
 

package/skills/workflow-authoring/references/capability-details.md

@@ -2,7 +2,7 @@
 # Exhaustive workflow capability facts
 
 Contract format: `2.0.0`<br>
-Contract content / skill / extension: `1.8.0`
+Contract content / skill / extension: `1.10.0`
 
 Every exact fact below is projected from the installed extension's capability contract. Explanatory judgment belongs in the hand-written references next to this file.
 

package/skills/workflow-patterns/SKILL.md

@@ -2,7 +2,7 @@
 name: workflow-patterns
 description: Choose and run one of Pi's built-in multi-agent workflows for research, adversarial review, code review, multi-perspective analysis, or codebase auditing. Use when the request matches a named pattern; use workflow-authoring instead for a new script or custom topology.
 metadata:
-  version: "1.8.0"
+  version: "1.10.0"
 ---
 
 # Built-in workflow patterns

package/skills/workflow-review/SKILL.md

@@ -2,7 +2,7 @@
 name: workflow-review
 description: Audit an existing Pi JavaScript workflow for topology, prompt/data flow, limits, failure handling, cancellation, resume safety, and publication compatibility. Use when reviewing or debugging a workflow script or saved run; do not use to run a standard named workflow.
 metadata:
-  version: "1.8.0"
+  version: "1.10.0"
 ---
 
 # Workflow review