Web Console: Runtime and session view (Phase 1) #641

Open
opened 2026-07-10 14:40:14 -05:00 by jcwalker3 · 1 comment
Owner

Problem statement

MVP runtime page (#430) shows MCP health/stale detection but not a full runtime and session view correlating namespaces, sessions, capabilities, worktree bindings, and contamination/stale markers for operator diagnosis.

User and operational impact

Hard to answer: which sessions are live, which namespaces are stale, which worktrees are bound, whether recovery was sanctioned.

Scope

  • View combining runtime health + inventory sessions/namespaces/worktrees.
  • Show profile/role, namespace, pid if available, lease bindings, stale flags, contamination warnings when detectable (#630).
  • Read-only; link to sanctioned recovery docs (auto-reconnect, operator restart) not pkill.

Explicit non-goals

  • No restart/kill controls (Phase 2).
  • No session takeover mutations.

Required implementation investigation

runtime_health.py, #430, #636, #634, #630, #584, #610, #631.

Proposed architecture or implementation direction

Compose health + inventory DTOs; table per namespace/session; detail drawer optional later.

Security and workflow-safety requirements

Redact secrets; do not expose tokens; contamination must not be silent.

Acceptance criteria

  1. Sessions/namespaces listed with role and stale indicators.
  2. Worktree binding shown when known.
  3. Contaminated/manual-kill markers surfaced if available.
  4. Tests with fixture runtime+inventory.
  5. Docs link sanctioned recovery paths only.

Required tests

Render tests for stale and clean sessions.

Observability and audit requirements

Read-only.

Dependencies and linkage

Canonical issue state

STATE: ready-for-author
WHO_IS_NEXT: author
NEXT_ACTION: Implement runtime/session view
NEXT_PROMPT: Author view only; PR; stop

Required final evidence

PR with view, tests, docs.

Required final response and handoff expectations

Brief PR → reviewer.

## Problem statement MVP runtime page (#430) shows MCP health/stale detection but not a full **runtime and session view** correlating namespaces, sessions, capabilities, worktree bindings, and contamination/stale markers for operator diagnosis. ## User and operational impact Hard to answer: which sessions are live, which namespaces are stale, which worktrees are bound, whether recovery was sanctioned. ## Scope * View combining runtime health + inventory sessions/namespaces/worktrees. * Show profile/role, namespace, pid if available, lease bindings, stale flags, contamination warnings when detectable (#630). * Read-only; link to sanctioned recovery docs (auto-reconnect, operator restart) not pkill. ## Explicit non-goals * No restart/kill controls (Phase 2). * No session takeover mutations. ## Required implementation investigation `runtime_health.py`, #430, #636, #634, #630, #584, #610, #631. ## Proposed architecture or implementation direction Compose health + inventory DTOs; table per namespace/session; detail drawer optional later. ## Security and workflow-safety requirements Redact secrets; do not expose tokens; contamination must not be silent. ## Acceptance criteria 1. Sessions/namespaces listed with role and stale indicators. 2. Worktree binding shown when known. 3. Contaminated/manual-kill markers surfaced if available. 4. Tests with fixture runtime+inventory. 5. Docs link sanctioned recovery paths only. ## Required tests Render tests for stale and clean sessions. ## Observability and audit requirements Read-only. ## Dependencies and linkage * Parent: #631 · Extends: #430 · Soft-depends: #636, #634 · Related: #630, #584, #610 ## Canonical issue state ```text STATE: ready-for-author WHO_IS_NEXT: author NEXT_ACTION: Implement runtime/session view NEXT_PROMPT: Author view only; PR; stop ``` ## Required final evidence PR with view, tests, docs. ## Required final response and handoff expectations Brief PR → reviewer.
Author
Owner

Canonical Issue State

STATE:
ready-for-author

WHO_IS_NEXT:
author

NEXT_ACTION:
Implement runtime and session inventory view; link #652 #653 Phase 1

NEXT_PROMPT:

AUTHOR prgs Gitea-Tools. Implement #641. Vision #652 · Roadmap #653 Phase 1 · Soft-depends #636 #634 · Extends #430 · Related #630. Lock; branches/; PR; stop. Closing ≠ vision complete.

WHAT_HAPPENED:
Linked to #652/#653. Not recreated.

WHY:
Initial batch linkage.

RELATED_ISSUES:
#652 #653 #631 #636 #634 #430 #630

RELATED_PRS:
none

BLOCKERS:
none

VALIDATION:
existing retained

LAST_UPDATED_BY:
jcwalker3 / prgs-author / author / 2026-07-10

## Canonical Issue State STATE: ready-for-author WHO_IS_NEXT: author NEXT_ACTION: Implement runtime and session inventory view; link #652 #653 Phase 1 NEXT_PROMPT: ```text AUTHOR prgs Gitea-Tools. Implement #641. Vision #652 · Roadmap #653 Phase 1 · Soft-depends #636 #634 · Extends #430 · Related #630. Lock; branches/; PR; stop. Closing ≠ vision complete. ``` WHAT_HAPPENED: Linked to #652/#653. Not recreated. WHY: Initial batch linkage. RELATED_ISSUES: #652 #653 #631 #636 #634 #430 #630 RELATED_PRS: none BLOCKERS: none VALIDATION: existing retained LAST_UPDATED_BY: jcwalker3 / prgs-author / author / 2026-07-10
Sign in to join this conversation.
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: Scaled-Tech-Consulting/Gitea-Tools#641