From 9fbd2c7ce2c9a27b4fbaf1fc5efc862d1f0068d2 Mon Sep 17 00:00:00 2001
From: Ross Gardler <250240+SorraTheOrc@users.noreply.github.com>
Date: Mon, 25 May 2026 23:17:21 +0100
Subject: [PATCH] WL-0MP0E0M5500846SL: Fix audit gaps - add piman to CLI.md,
 fix broken opencode link, close 40 duplicate children

- Added piman|pi command documentation to CLI.md (was causing validator test failures)
- Fixed broken link in docs/tutorials/04-using-the-tui.md (opencode-tui.md -> opencode-to-pi-migration.md)
- Closed 40 open child work-items that were duplicates of already-completed siblings
- All 9 epic acceptance criteria now met, all 1678 tests pass
---
 CLI.md                             | 25 +++++++++++++++++++++++++
 docs/tutorials/04-using-the-tui.md |  2 +-
 2 files changed, 26 insertions(+), 1 deletion(-)

diff --git a/CLI.md b/CLI.md
index 2e5c8dfa..1f0b998b 100644
--- a/CLI.md
+++ b/CLI.md
@@ -826,6 +826,31 @@ Example (JSON):
 wl --json init
 ```
 
+### `piman` | `pi` [options]
+
+Launch the Pi-based TUI: browse and manage work items with agent chat and action palette. This is the agent-centric TUI that replaces the legacy Opencode-based interface. All worklog operations are performed via the `wl` CLI.
+
+Options:
+
+- `--in-progress` — Show only in-progress items.
+- `--all` — Include completed/deleted items in the list.
+- `--prefix <prefix>` — Override the default prefix.
+- `--headless` — Run in headless mode for CI scripting and automated tests.
+
+Example:
+
+```sh
+wl piman
+wl pi --in-progress
+```
+
+The Pi TUI can also be installed as a Pi package:
+
+```sh
+pi install ./packages/tui
+wl-piman
+```
+
 ### `status` [options]
 
 Show Worklog system and database status (counts, configuration values).
diff --git a/docs/tutorials/04-using-the-tui.md b/docs/tutorials/04-using-the-tui.md
index 51f6591f..1b14c141 100644
--- a/docs/tutorials/04-using-the-tui.md
+++ b/docs/tutorials/04-using-the-tui.md
@@ -183,4 +183,4 @@ Press `q`, `Esc`, or `Ctrl+C` to quit the TUI. All changes made during the sessi
 
 - [Planning and Tracking an Epic](05-planning-an-epic.md) -- organize complex features
 - [TUI Reference](../../TUI.md) -- complete TUI documentation
-- [OpenCode TUI Integration](../../docs/opencode-tui.md) -- detailed OpenCode docs
+- [Pi TUI Migration Guide](../../docs/opencode-to-pi-migration.md) -- migrating from OpenCode to Pi