Merge pull request #41 from codejunkie99/codex/tui-dashboard [skip ci]

feat: add agentic-stack dashboard TUI with trust-console parity

Author: codejunkie99

CHANGELOG.md

@@ -5,6 +5,48 @@ All notable changes to this project.
 The format follows [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 and the project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [0.15.0] — 2026-05-06
+
+Minor release. Adds a production dashboard TUI for installed agentic-stack
+projects, with the trust-console inspection surface folded into the same
+user-facing entrypoint.
+
+### Added
+- **`agentic-stack dashboard` / `dash`.** Adds a terminal dashboard for project
+  health, installed adapters, doctor checks, harness verification, memory, team
+  brain, skills, managed instances, transfer, and local data exports.
+- **Trust-console parity.** The dashboard includes a per-harness verify matrix,
+  team brain status/init, skills listing, active instance listing,
+  accepted/rejected memory review, and `memory_why()` evidence lookup.
+- **Plain renderer.** `agentic-stack dashboard --plain` and non-TTY fallback
+  produce a script-safe text dashboard for logs, agents, and tests.
+- **Interactive dashboard coverage.** Adds local tests for renderer output,
+  CLI aliases, trust-console parity sections, non-TTY fallback, up/down
+  navigation, refresh, quit, and Enter-open behavior.
+
+### Changed
+- Bare interactive `agentic-stack` / `./install.sh` opens the dashboard when an
+  existing `.agent/install.json` is present. Non-TTY shells keep printing
+  command guidance instead of launching an interactive UI.
+- README, POSIX installer help, and PowerShell installer help now document the
+  dashboard entrypoint.
+
+### Fixed
+- `test_claude_code_hook.py` now works both as a standalone validation script
+  and as a pytest-collected module by providing a real `mod` fixture.
+
+### Migration
+No migration required. Existing projects can run `agentic-stack dashboard`
+after upgrading. Re-run an adapter install only if you want the latest copied
+adapter guidance files in a project.
+
+### Release prep
+- GitHub release notes should use this changelog entry after PR #41 merges.
+- `v0.14.0` already exists on GitHub, so this production dashboard release uses
+  the next minor tag, `v0.15.0`.
+- `Formula/agentic-stack.rb` must be bumped in the usual follow-up after the
+  `v0.15.0` tag exists and the tag tarball sha256 can be computed.
+
 ## [0.13.0] — 2026-05-02
 
 Minor release. Adds an onboarding-style transfer wizard for moving a portable

README.md

@@ -25,22 +25,22 @@ metrics without training a model or sending telemetry.
   <img src="docs/diagram.svg" alt="agentic-stack architecture" width="880"/>
 </p>
 
-### New in v0.13.0 — transfer wizard
-
-Minor release. Adds an onboarding-style `agentic-stack transfer` wizard for
-moving a project brain into Codex, Cursor, Windsurf, or a terminal-only
-`AGENTS.md` setup.
-
-- **Natural-language transfer plans.** Say things like `move my memory into
-  Codex`; the wizard detects targets, memory scopes, and whether to generate a
-  curl command, apply locally, or both.
-- **Portable memory bundles.** Transfers preferences, accepted lessons,
-  skills, working memory, episodic/history logs, and candidate lessons, with
-  SHA-256 verification and secret-like content blocking.
-- **One-line import.** Generated curl/PowerShell bootstraps import the bundle
-  into another project and install the selected adapter files.
-- **Modern Windsurf rules.** Windsurf now gets `.windsurf/rules/agentic-stack.md`
-  while keeping legacy `.windsurfrules` compatibility.
+### New in v0.15.0 — dashboard TUI
+
+Minor release. Adds `agentic-stack dashboard` as the production front door for
+installed projects: one terminal screen for health, adapters, verification,
+memory, team brain, skills, instances, transfer, and local dashboard exports.
+
+- **Dashboard command.** Run `agentic-stack dashboard` or `./install.sh dashboard`
+  to open the TUI; use `dash` or `--plain` for a compact script-safe view.
+- **Trust-console parity.** The dashboard includes a per-harness verify matrix,
+  accepted/rejected memory, `memory_why()` evidence lookup, team brain
+  status/init, skills, and managed instances.
+- **Safer installed-project default.** Bare interactive `./install.sh` opens the
+  dashboard once `.agent/install.json` exists; non-TTY shells still print
+  script-safe command guidance instead of launching a TUI.
+- **Production coverage.** Renderer, CLI, parity, non-TTY fallback, and
+  interactive keypress navigation are covered by local tests.
 
 See [CHANGELOG.md](CHANGELOG.md) for the full list.
 
@@ -130,6 +130,7 @@ cd agentic-stack
 
 ```bash
 brew update && brew upgrade agentic-stack
+agentic-stack dashboard
 ```
 
 ### Clone instead?
@@ -147,6 +148,7 @@ After the first `./install.sh <adapter>`, manage your project with
 verb-style subcommands (works with both `install.sh` and `install.ps1`):
 
 ```bash
+./install.sh dashboard           # TUI dashboard: health, verify, memory, team, skills, instances
 ./install.sh add cursor          # add a second adapter (Claude Code + Cursor in same repo)
 ./install.sh status              # one-screen view: which adapters, brain stats
 ./install.sh doctor              # read-only audit; green / yellow / red per adapter
@@ -155,12 +157,15 @@ verb-style subcommands (works with both `install.sh` and `install.ps1`):
 ./install.sh remove cursor       # confirm prompt + delete; no quarantine, no undo
 ```
 
+PowerShell uses the same verbs, for example `.\install.ps1 dashboard`.
+
 Bare `./install.sh` (no arguments) opens a **multi-select wizard** on
 a fresh project — check every harness you actually use, hit enter,
 each one gets installed. The wizard auto-detects harnesses already on
 disk and pre-checks them. On a project that already has an
-`install.json`, bare `./install.sh` lists what's still installable.
-In non-TTY shells (CI), it prints usage and exits with code 2.
+`install.json`, bare interactive `./install.sh` opens the dashboard.
+In non-TTY shells (CI), it stays script-safe and prints the available
+subcommands instead of opening a TUI.
 
 Upgrading from pre-v0.9? Run `./install.sh doctor` first — it
 synthesizes `install.json` from on-disk adapter signals so the new
@@ -364,6 +369,7 @@ harness_manager/                # v0.9.0 manifest-driven Python backend
 ├── state.py                    # install.json read/write with fcntl/msvcrt locking
 ├── doctor.py                   # read-only audit + pre-v0.9 migration synthesis
 ├── remove.py                   # safe uninstall with shared-file detection + ownership handoff
+├── dashboard_tui.py            # project dashboard for health/verify/memory/team/skills/instances
 ├── post_install.py             # named built-ins (openclaw_register_workspace)
 ├── manage_tui.py               # interactive menu loop for add/remove/audit
 ├── transfer_tui.py             # onboarding-style memory transfer wizard

harness_manager/__init__.py

@@ -1,8 +1,9 @@
 """harness_manager — manifest-driven adapter installer for agentic-stack.
 
 This package is the implementation backend for `./install.sh` and `./install.ps1`.
-The user-facing surface is plain verbs: install, add, remove, doctor, status.
+The user-facing surface is plain verbs: install, add, remove, doctor, status,
+dashboard, manage, and transfer.
 The "harness_manager" name is internal only and never appears in CLI help, docs,
 or error messages users see.
 """
-__version__ = "0.13.0"
+__version__ = "0.15.0"

harness_manager/cli.py

@@ -1,6 +1,6 @@
 """Argparse dispatcher. install.sh and install.ps1 invoke this.
 
-Verbs (subcommands): add, remove, doctor, status, manage, transfer.
+Verbs (subcommands): add, remove, doctor, status, manage, dashboard, transfer.
 Anything else in first position → treated as an adapter name (existing
 `./install.sh <adapter>` UX preserved).
 """
@@ -19,7 +19,7 @@
 from . import __version__
 
 
-VERBS = {"add", "remove", "doctor", "status", "manage", "transfer"}
+VERBS = {"add", "remove", "doctor", "status", "manage", "dashboard", "dash", "transfer"}
 
 
 def _stack_root() -> Path:
@@ -247,6 +247,17 @@ def cmd_manage(target: Path) -> int:
     return manage_tui.run(target_root=target, stack_root=_stack_root())
 
 
+def cmd_dashboard(target: Path, plain: bool = False) -> int:
+    """Open the project dashboard.
+
+    `plain` is primarily for non-TTY terminals and tests. The dashboard
+    runner also falls back to plain output automatically when stdin/stdout
+    are not interactive.
+    """
+    from . import dashboard_tui
+    return dashboard_tui.run(target_root=target, stack_root=_stack_root(), plain=plain)
+
+
 def cmd_transfer(args: list[str], target: Path) -> int:
     from . import transfer_tui
     return transfer_tui.run(args, target_root=target, stack_root=_stack_root())
@@ -263,6 +274,8 @@ def cmd_bare(target: Path, wizard_flags: list[str]) -> int:
     """
     doc = state_mod.load(target)
     if doc is not None:
+        if "--yes" not in wizard_flags and sys.stdin.isatty() and sys.stdout.isatty():
+            return cmd_dashboard(target)
         installed = set(doc.get("adapters", {}).keys())
         available = set()
         root = _stack_root() / "adapters"
@@ -273,13 +286,15 @@ def cmd_bare(target: Path, wizard_flags: list[str]) -> int:
         not_installed = sorted(available - installed)
         if not not_installed:
             print(f"all available adapters already installed: {sorted(installed)}")
+            print("open dashboard: ./install.sh dashboard")
             print("run `./install.sh status` for a summary.")
             return 0
         print(f"already installed: {sorted(installed)}")
         print(f"available to add:  {not_installed}")
         print()
         print(f"to add one: ./install.sh add <name>")
-        print(f"or interactively: ./install.sh manage")
+        print(f"open dashboard: ./install.sh dashboard")
+        print(f"or adapter manager only: ./install.sh manage")
         return 0
 
     # No install.json. Pre-v0.9 migration gate: if this is a legacy
@@ -324,6 +339,7 @@ def cmd_bare(target: Path, wizard_flags: list[str]) -> int:
     print("  ./install.sh status      # quick read-only view")
     print("  ./install.sh add <name>  # install another adapter")
     print("  ./install.sh remove <name>  # remove an adapter (with confirm)")
+    print("  ./install.sh dashboard   # interactive project dashboard")
     print("  ./install.sh manage      # interactive TUI for adapter management")
     print("  ./install.sh transfer    # onboarding-style memory transfer wizard")
     return 2
@@ -456,6 +472,19 @@ def main(argv: list[str] | None = None) -> int:
         if verb == "manage":
             target = Path(rest[1]) if len(rest) >= 2 else Path.cwd()
             return cmd_manage(target)
+        if verb in ("dashboard", "dash"):
+            plain = False
+            target_args: list[str] = []
+            for arg in rest[1:]:
+                if arg == "--plain":
+                    plain = True
+                else:
+                    target_args.append(arg)
+            if len(target_args) > 1:
+                print("usage: ./install.sh dashboard [target-dir] [--plain]", file=sys.stderr)
+                return 2
+            target = Path(target_args[0]) if target_args else Path.cwd()
+            return cmd_dashboard(target, plain=plain)
         if verb == "transfer":
             return cmd_transfer(rest[1:], Path.cwd())