UAT: agents project context inspect missing spec-required UKO graph structure, active strategies, and indexed resources display #3518

Open
opened 2026-04-05 18:48:27 +00:00 by freemo · 1 comment
Owner

Metadata

  • Branch: fix/inspect-uko-graph-strategies-resources
  • Commit Message: fix(cli): add UKO graph structure, active strategies, and indexed resources to context inspect output
  • Milestone: None (backlog)
  • Parent Epic: #396

Background and Context

The agents project context inspect CLI command (src/cleveragents/cli/commands/project_context.pycontext_inspect()) is a debugging tool for understanding the context the ACMS assembles for a project. The spec defines it as showing: "the UKO graph structure, active strategies, indexed resources, context budget usage, and the most recent fusion result."

Currently the command shows tier metrics, budget limits, fragment counts, actor visibility, and per-phase context analysis — but is missing several spec-required display sections related to the UKO graph and ACMS pipeline state.

Backlog note: This issue was discovered during autonomous operation
on milestone v3.4.0. It does not block milestone completion and has been
placed in the backlog for human review and future milestone assignment.

Current Behavior

Running agents project context inspect <project_name> displays:

  • Tier metrics (hot/warm/cold fragment counts and hit/miss rates)
  • Tier budget limits
  • Project fragment counts by tier
  • Actor visibility (fragments per role)
  • Per-phase context analysis (fragment/resource/byte/token counts)

It does not show:

  • UKO graph structure or node counts by type
  • Which context strategies are active/enabled for the project/view
  • Which resources have been indexed into the UKO graph
  • The most recent fusion result (last assembled AssembledContext)

Steps to reproduce:

  1. Run agents project context inspect <project_name>
  2. Observe that UKO graph structure, active strategies, and indexed resources are absent from the output

Expected Behavior

Per the specification, the inspect command should display all of the following:

  1. UKO graph structure — the UKO subgraph rooted at focus nodes (or a summary of the full indexed graph), including node counts by type
  2. Active strategies — which context strategies are enabled for this project/view (from the project's ACMS config)
  3. Indexed resources — which resources have been indexed into the UKO graph (from the resource registry)
  4. Context budget usage — current token usage vs. budget (partially present; verify completeness)
  5. Most recent fusion result — the last assembled context payload (AssembledContext) if available from a context cache/store

Subtasks

  • Audit context_inspect() in src/cleveragents/cli/commands/project_context.py against the spec's required display sections
  • Query the UKO graph backend for indexed node counts by type and add a "UKO Graph Structure" section to the output
  • Read the project's ACMS config to surface enabled/active strategies and add an "Active Strategies" section
  • Query the resource registry for indexed resources and add an "Indexed Resources" section
  • Retrieve the most recent AssembledContext from the context cache/store (if available) and display a "Most Recent Fusion Result" summary
  • Verify "Context Budget Usage" section is complete (current token usage vs. budget)
  • Tests (Behave): Add scenarios covering each new display section in inspect output
  • Tests (Robot): Add integration test verifying inspect output includes all spec-required sections
  • Verify coverage >= 97% via nox -s coverage_report
  • Run nox (all default sessions), fix any errors

Definition of Done

This issue is complete when:

  • All subtasks above are completed and checked off.
  • A Git commit is created where the first line of the commit message matches the Commit Message in Metadata exactly, followed by a blank line, then additional lines providing relevant details about the implementation.
  • The commit is pushed to the remote on the branch matching the Branch in Metadata exactly.
  • The commit is submitted as a pull request to master, reviewed, and merged before this issue is marked done.
  • All nox stages pass
  • Coverage >= 97%

Automated by CleverAgents Bot
Supervisor: UAT Testing | Agent: ca-new-issue-creator

## Metadata - **Branch**: `fix/inspect-uko-graph-strategies-resources` - **Commit Message**: `fix(cli): add UKO graph structure, active strategies, and indexed resources to context inspect output` - **Milestone**: None (backlog) - **Parent Epic**: #396 ## Background and Context The `agents project context inspect` CLI command (`src/cleveragents/cli/commands/project_context.py` — `context_inspect()`) is a debugging tool for understanding the context the ACMS assembles for a project. The spec defines it as showing: "the UKO graph structure, active strategies, indexed resources, context budget usage, and the most recent fusion result." Currently the command shows tier metrics, budget limits, fragment counts, actor visibility, and per-phase context analysis — but is missing several spec-required display sections related to the UKO graph and ACMS pipeline state. > **Backlog note:** This issue was discovered during autonomous operation > on milestone v3.4.0. It does not block milestone completion and has been > placed in the backlog for human review and future milestone assignment. ## Current Behavior Running `agents project context inspect <project_name>` displays: - Tier metrics (hot/warm/cold fragment counts and hit/miss rates) - Tier budget limits - Project fragment counts by tier - Actor visibility (fragments per role) - Per-phase context analysis (fragment/resource/byte/token counts) It does **not** show: - UKO graph structure or node counts by type - Which context strategies are active/enabled for the project/view - Which resources have been indexed into the UKO graph - The most recent fusion result (last assembled `AssembledContext`) **Steps to reproduce:** 1. Run `agents project context inspect <project_name>` 2. Observe that UKO graph structure, active strategies, and indexed resources are absent from the output ## Expected Behavior Per the specification, the `inspect` command should display all of the following: 1. **UKO graph structure** — the UKO subgraph rooted at focus nodes (or a summary of the full indexed graph), including node counts by type 2. **Active strategies** — which context strategies are enabled for this project/view (from the project's ACMS config) 3. **Indexed resources** — which resources have been indexed into the UKO graph (from the resource registry) 4. **Context budget usage** — current token usage vs. budget (partially present; verify completeness) 5. **Most recent fusion result** — the last assembled context payload (`AssembledContext`) if available from a context cache/store ## Subtasks - [ ] Audit `context_inspect()` in `src/cleveragents/cli/commands/project_context.py` against the spec's required display sections - [ ] Query the UKO graph backend for indexed node counts by type and add a "UKO Graph Structure" section to the output - [ ] Read the project's ACMS config to surface enabled/active strategies and add an "Active Strategies" section - [ ] Query the resource registry for indexed resources and add an "Indexed Resources" section - [ ] Retrieve the most recent `AssembledContext` from the context cache/store (if available) and display a "Most Recent Fusion Result" summary - [ ] Verify "Context Budget Usage" section is complete (current token usage vs. budget) - [ ] Tests (Behave): Add scenarios covering each new display section in `inspect` output - [ ] Tests (Robot): Add integration test verifying `inspect` output includes all spec-required sections - [ ] Verify coverage >= 97% via `nox -s coverage_report` - [ ] Run `nox` (all default sessions), fix any errors ## Definition of Done This issue is complete when: - All subtasks above are completed and checked off. - A Git commit is created where the **first line** of the commit message matches the Commit Message in Metadata exactly, followed by a blank line, then additional lines providing relevant details about the implementation. - The commit is pushed to the remote on the branch matching the **Branch** in Metadata exactly. - The commit is submitted as a **pull request** to `master`, reviewed, and **merged** before this issue is marked done. - All nox stages pass - Coverage >= 97% --- **Automated by CleverAgents Bot** Supervisor: UAT Testing | Agent: ca-new-issue-creator
freemo added this to the v3.7.0 milestone 2026-04-05 20:07:08 +00:00
Author
Owner

Issue triaged by project owner:

  • State: Verified
  • Priority: Low — agents project context inspect is missing UKO graph structure, active strategies, and indexed resources display sections. The command shows partial information.
  • Milestone: v3.7.0
  • Story Points: 3 — M — Requires querying UKO graph backend, reading ACMS config, querying resource registry, and retrieving cached fusion results. Multiple data sources to integrate.
  • MoSCoW: Could Have — The inspect command is a debugging tool. It works partially; the missing sections are useful but not essential for core functionality.
  • Parent Epic: #396 (dependency link already exists)

Automated by CleverAgents Bot
Supervisor: Project Owner | Agent: ca-project-owner

Issue triaged by project owner: - **State**: Verified - **Priority**: Low — `agents project context inspect` is missing UKO graph structure, active strategies, and indexed resources display sections. The command shows partial information. - **Milestone**: v3.7.0 - **Story Points**: 3 — M — Requires querying UKO graph backend, reading ACMS config, querying resource registry, and retrieving cached fusion results. Multiple data sources to integrate. - **MoSCoW**: Could Have — The inspect command is a debugging tool. It works partially; the missing sections are useful but not essential for core functionality. - **Parent Epic**: #396 (dependency link already exists) --- **Automated by CleverAgents Bot** Supervisor: Project Owner | Agent: ca-project-owner
Sign in to join this conversation.
No milestone
No project
No assignees
1 participant
Notifications
Due date
The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Blocks
#396 Epic: ACMS Context Pipeline
cleveragents/cleveragents-core
Reference
cleveragents/cleveragents-core#3518
No description provided.