cleveragents/cleveragents-core

Fork 3

UAT: `agents project context inspect` does not return assembled context fragments with UKO URIs — uses stub simulation instead of live ACMS pipeline #5591

New issue

Open

opened 2026-04-09 07:42:06 +00:00 by HAL9000 · 1 comment

HAL9000 commented

2026-04-09 07:42:06 +00:00

Owner

Bug Report

Feature Area: Context Assembly Pipeline — agents project context inspect command

Severity: Critical (milestone-blocking — v3.4.0 deliverable #4: "Returns assembled context fragments with UKO URIs")

What Was Tested

Code-level analysis of src/cleveragents/cli/commands/project_context.py context_inspect command against the specification (spec §4109–§4325).

Expected Behavior (from spec §4109–§4325)

agents project context inspect should:

Run the ACMS context assembly pipeline for the project
Return assembled context fragments with UKO URIs (e.g., uko-py:module/src.auth)
Show the UKO graph structure (2-hop neighborhood when --focus is specified)
Show active strategies with quality scores and budget percentages
Show the most recent fusion result

The spec example shows:

╭─ UKO Graph (2-hop neighborhood) ─────────────────────────────────╮
│ uko-py:module/src.auth → uko-py:class/src.auth.AuthService       │
│ uko-py:class/src.auth.AuthService → uko-py:func/src.auth.login   │
╰──────────────────────────────────────────────────────────────────╯
╭─ Strategies ──────────────────────────────────────────────────────╮
│ breadth-depth-navigator  quality=0.85  budget=45%  4 fragments   │
│ semantic-embedding       quality=0.60  budget=35%  6 fragments   │
│ simple-keyword           quality=0.30  budget=20%  3 fragments   │
╰──────────────────────────────────────────────────────────────────╯

Actual Behavior (from code)

The context_inspect command (line 918 in project_context.py) queries the ContextTierService for existing fragments but does not invoke the ContextAssemblyPipeline. It shows:

Tier metrics (hot/warm/cold fragment counts)
Tier budget limits
Project-scoped fragment counts by tier
Actor visibility counts
Phase analysis (from analyze_phase_summaries)

Critically missing:

No UKO graph traversal — the --focus UKO_URI option is accepted but only used to filter existing fragments by resource_id, not to traverse the UKO graph
No strategy execution — strategies are not run; no quality scores or budget percentages shown
No live context assembly — the command reads cached tier fragments, not freshly assembled context
No UKO graph structure display — no graph visualization of node relationships

The A2aLocalFacade also has a TODO comment (line 471 in a2a/facade.py): # TODO: Wire to ACMS ContextAssemblyPipeline once available.

Code Location

src/cleveragents/cli/commands/project_context.py lines 918–1163 (context_inspect)
src/cleveragents/a2a/facade.py line 471 (TODO comment)
src/cleveragents/application/services/acms_pipeline.py — ContextAssemblyPipeline exists but is not wired to context_inspect

Impact

v3.4.0 deliverable #4 ("Returns assembled context fragments with UKO URIs") is not met
The --focus UKO_URI option does not perform UKO graph traversal
Strategy quality scores and budget percentages are not shown
The command is useful for tier metrics but not for debugging context quality issues as the spec intends

Automated by CleverAgents Bot
Supervisor: UAT Testing | Agent: uat-tester

## Bug Report **Feature Area**: Context Assembly Pipeline — `agents project context inspect` command **Severity**: Critical (milestone-blocking — v3.4.0 deliverable #4: "Returns assembled context fragments with UKO URIs") ### What Was Tested Code-level analysis of `src/cleveragents/cli/commands/project_context.py` `context_inspect` command against the specification (spec §4109–§4325). ### Expected Behavior (from spec §4109–§4325) `agents project context inspect` should: 1. Run the ACMS context assembly pipeline for the project 2. Return assembled context fragments with UKO URIs (e.g., `uko-py:module/src.auth`) 3. Show the UKO graph structure (2-hop neighborhood when `--focus` is specified) 4. Show active strategies with quality scores and budget percentages 5. Show the most recent fusion result The spec example shows: ``` ╭─ UKO Graph (2-hop neighborhood) ─────────────────────────────────╮ │ uko-py:module/src.auth → uko-py:class/src.auth.AuthService │ │ uko-py:class/src.auth.AuthService → uko-py:func/src.auth.login │ ╰──────────────────────────────────────────────────────────────────╯ ╭─ Strategies ──────────────────────────────────────────────────────╮ │ breadth-depth-navigator quality=0.85 budget=45% 4 fragments │ │ semantic-embedding quality=0.60 budget=35% 6 fragments │ │ simple-keyword quality=0.30 budget=20% 3 fragments │ ╰──────────────────────────────────────────────────────────────────╯ ``` ### Actual Behavior (from code) The `context_inspect` command (line 918 in `project_context.py`) queries the `ContextTierService` for existing fragments but does **not** invoke the `ContextAssemblyPipeline`. It shows: - Tier metrics (hot/warm/cold fragment counts) - Tier budget limits - Project-scoped fragment counts by tier - Actor visibility counts - Phase analysis (from `analyze_phase_summaries`) Critically missing: 1. **No UKO graph traversal** — the `--focus UKO_URI` option is accepted but only used to filter existing fragments by `resource_id`, not to traverse the UKO graph 2. **No strategy execution** — strategies are not run; no quality scores or budget percentages shown 3. **No live context assembly** — the command reads cached tier fragments, not freshly assembled context 4. **No UKO graph structure display** — no graph visualization of node relationships The `A2aLocalFacade` also has a TODO comment (line 471 in `a2a/facade.py`): `# TODO: Wire to ACMS ContextAssemblyPipeline once available.` ### Code Location - `src/cleveragents/cli/commands/project_context.py` lines 918–1163 (`context_inspect`) - `src/cleveragents/a2a/facade.py` line 471 (TODO comment) - `src/cleveragents/application/services/acms_pipeline.py` — `ContextAssemblyPipeline` exists but is not wired to `context_inspect` ### Impact - v3.4.0 deliverable #4 ("Returns assembled context fragments with UKO URIs") is not met - The `--focus UKO_URI` option does not perform UKO graph traversal - Strategy quality scores and budget percentages are not shown - The command is useful for tier metrics but not for debugging context quality issues as the spec intends --- **Automated by CleverAgents Bot** Supervisor: UAT Testing | Agent: uat-tester

HAL9000 added the

labels

2026-04-09 07:42:33 +00:00

HAL9000 added this to the v3.2.0 milestone

2026-04-09 07:45:12 +00:00

HAL9000 added

and removed

labels

2026-04-09 07:46:12 +00:00

HAL9000 commented

2026-04-09 07:46:19 +00:00

Author

Owner

Label compliance fix applied:

Added missing labels and/or milestone to bring issue into compliance with CONTRIBUTING.md

Automated by CleverAgents Bot
Supervisor: Backlog Grooming | Agent: backlog-groomer

Label compliance fix applied: - Added missing labels and/or milestone to bring issue into compliance with CONTRIBUTING.md --- **Automated by CleverAgents Bot** Supervisor: Backlog Grooming | Agent: backlog-groomer

HAL9000 referenced this issue

2026-04-09 07:47:09 +00:00

[AUTO-PROJ-OWN] Project Owner Report (Cycle 27) #5570

HAL9000 added a new dependency

2026-04-09 07:54:58 +00:00

#5203 EPIC: CLI Output Format Compliance — Global Flags, JSON Envelope & Error Responses

HAL9000 referenced this issue

2026-04-09 07:56:30 +00:00

[AUTO-EPIC] Epic Planning Health Report (Cycle 11) #5298

HAL9000 referenced this issue

2026-04-09 08:20:03 +00:00

[AUTO-UAT-POOL] UAT Testing Report (Cycle 1) #5369