feat(webui): unified session/lease/lock/worktree inventory API (Closes #636) #838
Labels
Clear labels
allocator
anti-stomp
architecture
bug
chore
codex
concurrency
contamination
control-plane
dashboard
database
design
documentation
enhancement
gitea
glitchtip
important
incident
incident-bridge
integration
jenkins
labels
leases
mcp
mcp-health
mcp-menu
multi-project
mutating
nice-to-have
observability
portability
preflight
protected-branch
queue
read-only
reconnect
recovery
refactor
release
reliability
resumable-review
reviewer
roadmap
safety
security
self-hosted
sentry
stale-runtime
status:blocked
status:in-progress
status:pr-open
status:ready
terminal-lock
testing
tracker
type:bug
type:feature
type:feature
type:guardrail
visibility
workflow
workflow-hardening
workflow-hardening
bug
duplicate
enhancement
help wanted
invalid
question
wontfix
Controller-owned work allocator
Prevent concurrent LLM session stomping
Architecture / structural design
OpenAI Codex client / workflow session surface
Concurrent session safety
Workflow or session contamination incident
MCP control-plane coordination and allocation authority
MCP operational dashboard/queue view
Internal coordination storage (SQLite/Postgres)
Design / investigation, no implementation
Docs / runbooks
New feature or improvement
Gitea MCP workflow
GlitchTip integration
Operational or process incident requiring durable audit trail
Sentry-to-Gitea incident bridging
Integration testing
Jenkins integration
Label taxonomy management
Lease adopt/release/expire lifecycle
MCP server / tooling
MCP namespace and runtime health
MCP menu surface
Work spanning multiple monitoring projects or Gitea repos
Mutating action; requires gating
Observability, metrics, traces, error reporting
Cross-platform / portability
Shared preflight gates before mutation
Protected branch / stable-branch policy concern
Work queue visibility and allocation
Read-only, no mutation
MCP client reconnect/reload recovery path
Recovery paths for stale/foreign leases
Code refactor / restructure
Release / versioning
Reliability / failure handling
Persist and resume prepared review verdicts across sessions
Reviewer workflow tooling
Roadmap / umbrella issue
Safety rails and fail-closed mutation guards
Security / trust boundary
Self-hosted infrastructure integration
Sentry error monitoring integration
Stale backend daemon / runtime-vs-master parity failures
Issue is blocked
Issue is being worked on
Issue has an open pull request
Issue is ready for work
Terminal review lock (#332) path
Tests / test coverage
Issue tracker hygiene / meta
Bug or defect
Feature or enhancement
Feature or enhancement
Safety gate or guardrail
Workflow state visibility for LLMs/operators
Cross-tool workflow
LLM workflow coordination hardening
LLM workflow coordination hardening
Something is not working
This issue or pull request already exists
New feature
Need some help
Something is wrong
More information is needed
This won't be fixed
No labels
Milestone
No items
No Milestone
Projects
Clear projects
No projects
No Assignees
Notifications
Due Date
No due date set.
Dependencies
No dependencies set.
Reference: Scaled-Tech-Consulting/Gitea-Tools#838
Reference in New Issue
Block a user
Blocking a user prevents them from interacting with repositories, such as opening or commenting on pull requests or issues. Learn more about blocking a user.
Closes #636
Phase 1 child of the Web Console epic #631. Adds the unified read-only inventory API so traffic-control and recovery views share one machine-readable source for sessions, capabilities, leases, locks, namespaces, and worktrees.
What this adds
GET /api/v1/inventory— a versioned, read-only aggregation composed into anInventorySnapshotDTO from the existing loaders plus the control-plane DB when available. Sections: sessions (CP-DB when present), role/namespace, capability summary, issue/PR leases, durable locks, worktree bindings, and hygiene anomalies. Lease owner ↔ worktree ↔ namespace are joined when the evidence supports it.Each section is fail-soft: an unavailable subsystem degrades to a status with a reason rather than raising, and a section that could not run is never rendered as empty-and-healthy. An active lease is never reported as unowned. Collision signals surface when detectable.
Files (4, all within #636 scope)
webui/inventory.pyInventorySnapshot, section loaders, join logic, redactionwebui/app.py/api/v1/inventoryroute registrationtests/test_webui_inventory.pydocs/webui-local-dev.mdAcceptance criteria
InventorySnapshot/ route/api/v1/inventorytests/test_webui_inventory.pydocs/webui-local-dev.mdNon-goals honored: no lease steal/release, no worktree delete, no Gitea-history replacement. Read-only throughout; sensitive paths redacted; stale/expired leases marked; no session tokens emitted.
Provenance
The implementation was committed on this worktree in an earlier author cycle whose owning MCP session then exited, leaving the commit unpublished. This cycle recovered the durable claim through the sanctioned dead-session unpublished-claim path (
gitea_lock_issue, identityjcwalker3/prgs-author, head strictly descends from recorded base53c2c92), re-ran the full test matrix, then published the head withgitea_publish_unpublished_issue_branch. No file copy; the single commitb7a63a5is the work as authored, on current master.Test evidence
Verified from the allocated worktree against master
53c2c92:pytest tests/test_webui_inventory.py— 20 passed.The 11 failures are the documented pre-existing master baseline — six in
test_commit_payloads.py, two intest_issue_702_review_findings_f1_f6.py, and one each intest_mcp_server.py::TestPreflightVerification,test_post_merge_moot_lease.py, andtest_reconciler_supersession_close.py. None touchwebui/. This branch adds no new failures.Canonical PR State
Co-Authored-By: Claude Opus 4.8 (1M context) [email protected]
pr: #838
branch: feat/issue-636-inventory-api
worktree: /Users/jasonwalker/Development/Gitea-Tools/branches/issue-636-inventory-api
profile: prgs-author
session_id: unknown
phase: claimed
head_before:
b7a63a5579expires_at: 2026-07-23T08:24:08Z
reviewer_active: no
Canonical Issue State
STATE: author-conflict-remediation-blocked
WHO_IS_NEXT: author
NEXT_ACTION: Repeat the conflict-fix merge for PR #838 from an author session that has local git-commit permission, then run the conflict-fix-gated push and require a fresh review at the new head.
NEXT_PROMPT:
WHAT_HAPPENED: Followed the conflict-fix lease at comment 14746. Merged master (
4f3a464a) into the branch in the allocated worktree; exactly one conflicted file, webui/app.py, every other path auto-merged. Both hunks are pure additive unions (this branch's #636 inventory API vs master's #633 console security-model surface). Resolution was applied and verified (ast.parse clean, all imports present), but landing a two-parent merge commit needs a local git commit + conflict-fix-gated git push (#399), both auto-denied under this cycle's headless permission mode. The in-progress merge was aborted; worktree is clean atb7a63a5. No remote mutation, no force-push, no rebase.WHY: update_pr_branch_by_merge fail-closes on a real content conflict, and gitea_commit_files only creates single-parent API commits (cannot produce the two-parent merge that restores mergeability). The only sanctioned path is local merge + gated push, which requires git-commit permission this cycle lacks.
RELATED_PRS: #838 (this PR, blocked on author remediation); conflict originates from master #633 (merged) and #632 ADR lineage.
BLOCKERS: Headless auto-permission mode denies local
git commitandgit push, and no MCP tool can create a two-parent merge commit. UNBLOCK CONDITION: an author session running with local git-commit and git-push permission (interactive approval or a non-headless permission mode) re-runs the recipe in NEXT_PROMPT; the merge itself is a trivial additive union, so it completes in one pass once commit/push are permitted.VALIDATION: Single conflict in webui/app.py; resolution
ast.parse-clean with rbac_matrix/redaction_policy/console_audit and inventory imports all present;git merge --abortrestored a clean worktree atb7a63a5(git status --porcelain empty).LAST_UPDATED_BY: prgs-author (jcwalker3)
Co-Authored-By: Claude Opus 4.8 (1M context) [email protected]
repo: Scaled-Tech-Consulting/Gitea-Tools
pr: #838
issue: none
reviewer_identity: sysadmin
profile: prgs-reviewer
session_id: 94347-c0e9763dbbb7
worktree: /Users/jasonwalker/Development/Gitea-Tools/branches/review-pr838-202607241040
phase: claimed
candidate_head: none
target_branch: master
target_branch_sha: none
last_activity: 2026-07-24T14:40:31Z
expires_at: 2026-07-24T14:50:31Z
blocker: none
repo: Scaled-Tech-Consulting/Gitea-Tools
pr: #838
issue: none
reviewer_identity: sysadmin
profile: prgs-reviewer
session_id: 94347-2967ae33070a
worktree: /Users/jasonwalker/Development/Gitea-Tools/branches/review-pr838-202607241040
phase: claimed
candidate_head: none
target_branch: master
target_branch_sha: none
last_activity: 2026-07-24T14:51:30Z
expires_at: 2026-07-24T15:01:30Z
blocker: none
PR #838 (Closes #636) cleanly implements the unified read-only session/lease/lock/worktree inventory API (
GET /api/v1/inventoryandGET /api/v1/inventory/{section}).Review Summary
webui/inventory.py,webui/app.py,tests/test_webui_inventory.py,docs/webui-local-dev.md). All routes are GETs. No mutation routes added.file:...mode=ro.36fe4785, 23 failed, 5060 passed) with zero new failures. Worktree clean post-validation.Canonical PR State
STATE: ready-to-merge
WHO_IS_NEXT: merger
NEXT_ACTION: Merge PR #838 into master as prgs-merger
NEXT_PROMPT:
WHAT_HAPPENED: Reviewer validated PR #838 and approved at head
f7ef719bd6WHY: Focused tests pass 20/20. Full test suite (5002 passed, 17 failed) matches baseline master (
36fe4785, 23 failed). All gates passed.ISSUE: #636
HEAD_SHA:
f7ef719bd6REVIEW_STATUS: approved / approval_at_current_head
MERGE_READY: true
BLOCKERS: none
VALIDATION: Executable /Users/jasonwalker/Development/Gitea-Tools/venv/bin/python; working directory: /Users/jasonwalker/Development/Gitea-Tools/branches/review-pr838-202607241040; Focused test run 20 passed; Full suite run 5002 passed, 17 failed; Baseline comparison working directory: /Users/jasonwalker/Development/Gitea-Tools/branches/baseline-master-pr838; Baseline full suite run 5060 passed, 23 failed; All 17 PR failures matched master baseline
36fe4785NATIVE_REVIEW_PROOF: transport=native_mcp; entrypoint=gitea_submit_pr_review; token_fingerprint=prgs-reviewer
LAST_UPDATED_BY: prgs-reviewer
Controller Handoff
36fe4785ecf7ef719bd6f7ef719bd636fe4785ecf7ef719bd636fe4785f7ef719bd6f7ef719bd6.f7ef719bd6.repo: Scaled-Tech-Consulting/Gitea-Tools
pr: #838
issue: #636
reviewer_identity: sysadmin
profile: prgs-reviewer
session_id: 66928-4fc43a898aae
worktree: /Users/jasonwalker/Development/Gitea-Tools/branches/review-pr838-20260724145219
phase: claimed
candidate_head:
4e269f3a7atarget_branch: master
target_branch_sha:
36fe4785eclast_activity: 2026-07-24T18:52:43Z
expires_at: 2026-07-24T19:02:43Z
blocker: none
Review: PR #838 — inventory API (#636) — post-base-sync re-approval
Verdict: APPROVE
Re-reviewed at head
4e269f3a7a51fa7da8abe5087349b656e279be07after author base-sync from previously approvedf7ef719. Delta is a single merge commit of master into the PR branch; no new inventory feature code.Reviewer
sysadmin/prgs-reviewer(author isjcwalker3).Checks
webui/inventory.py,webui/app.py(+route),tests/test_webui_inventory.py,docs/webui-local-dev.md(+1502 lines). No out-of-scope drift.mode=ro; path/URL redaction; fail-soft sections; no false-unowned while incomplete.tests/test_webui_inventory.py— 20 passed from clean review worktree at head. Worktree clean after validation.36fe4785.NATIVE_REVIEW_PROOF: transport=native_mcp; entrypoint=gitea_submit_pr_review; token_fingerprint=prgs-reviewer; workflow_hash=263d0a6cb8a6; schema_hash=b6c65affc336
Canonical PR State
repo: Scaled-Tech-Consulting/Gitea-Tools
pr: #838
issue: #636
reviewer_identity: sysadmin
profile: prgs-reviewer
session_id: 66928-4fc43a898aae
worktree: /Users/jasonwalker/Development/Gitea-Tools/branches/review-pr838-20260724145219
phase: released
candidate_head:
4e269f3a7atarget_branch: master
target_branch_sha:
36fe4785eclast_activity: 2026-07-24T18:53:41Z
expires_at: 2026-07-24T19:03:41Z
blocker: manual-release
repo: Scaled-Tech-Consulting/Gitea-Tools
pr: #838
issue: #636
reviewer_identity: sysadmin
profile: prgs-merger
session_id: 66925-0d3af49e41df
worktree: /Users/jasonwalker/Development/Gitea-Tools/branches/merge-pr838-20260724145345
phase: claimed
candidate_head:
4e269f3a7atarget_branch: master
target_branch_sha:
36fe4785eclast_activity: 2026-07-24T18:54:10Z
expires_at: 2026-07-24T19:04:10Z
blocker: none
Stale #332 review-decision lock cleanup (#594)
Status: APPLIED
sysadminprgs-merger2026-07-24T18:54:25.437553+00:00approveon PR feat(webui): unified session/lease/lock/worktree inventory API (Closes #636) (#838)closed(merged=True)35714258f0560dddc96c4ceb8b36179322c48a782prgs-reviewerManual deletion of session-state files is not the workflow.
This path only clears a lock when the referenced PR is merged/closed.