cleveragents/cleveragents-core

Fork 3

UAT: `agents project show` displays linked resources as raw ULIDs instead of resource names #5952

New issue

Open

opened 2026-04-09 12:15:02 +00:00 by HAL9000 · 1 comment

HAL9000 commented

2026-04-09 12:15:02 +00:00

Owner

Summary

agents project show displays linked resources using only their internal ULID identifiers instead of their human-readable namespaced names (e.g., local/api-repo). This makes the output difficult to use and does not match the spec.

Expected Behavior (from spec)

From docs/specification.md (line 3297-3299), the JSON output for project show should include:

"linked_resources": [
  { "name": "local/api-repo", "type": "git-checkout", "sandbox": "git_worktree", "read_only": false },
  { "name": "local/staging-db", "type": "local/database", "sandbox": "transaction_rollback", "read_only": true }
]

The Rich output should also show resource names, not ULIDs.

Actual Behavior

╭─────── Project: local/test-project ───────╮
│ Name: local/test-project                  │
│ Namespace: local                          │
│ Description: Test project                 │
│ ...                                       │
│ Linked Resources (2):                     │
│   - 01KNRPM478SSSXS5FFZ3M790RC            │  ← raw ULID, not name
│   - 01KNRPR0VVKPYJHP4JNTNGHPCX            │  ← raw ULID, not name
╰───────────────────────────────────────────╯

JSON output:

"linked_resources": [
  {
    "resource_id": "01KNRPM478SSSXS5FFZ3M790RC",  ← only ULID
    "read_only": false,
    "alias": null,
    "linked_at": "2026-04-09T08:52:24.169199+00:00"
  }
]

Missing: name, type, sandbox fields.

Root Cause

In src/cleveragents/cli/commands/project.py, the _project_spec_dict() helper (line ~100) only serializes the resource_id from the linked_resources list. It does not look up the resource name or type from the Resource Registry.

The show() command's Rich output also only iterates lr.resource_id without resolving the resource name.

Fix Required

When building the project display (both Rich and JSON), resolve each linked resource's name and type from the Resource Registry service. The _get_resource_registry_service() helper is already available in the module.

Steps to Reproduce

agents resource add git-checkout local/my-repo --path /tmp/repo
agents project create local/my-project
agents project link-resource local/my-project local/my-repo
agents project show local/my-project
# Shows ULID instead of "local/my-repo"

Environment

Tested on: /app (cleveragents-core, master branch)
Python 3.13.3
Reproduced: 2026-04-09

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

## Summary `agents project show` displays linked resources using only their internal ULID identifiers instead of their human-readable namespaced names (e.g., `local/api-repo`). This makes the output difficult to use and does not match the spec. ## Expected Behavior (from spec) From `docs/specification.md` (line 3297-3299), the JSON output for `project show` should include: ```json "linked_resources": [ { "name": "local/api-repo", "type": "git-checkout", "sandbox": "git_worktree", "read_only": false }, { "name": "local/staging-db", "type": "local/database", "sandbox": "transaction_rollback", "read_only": true } ] ``` The Rich output should also show resource names, not ULIDs. ## Actual Behavior ``` ╭─────── Project: local/test-project ───────╮ │ Name: local/test-project │ │ Namespace: local │ │ Description: Test project │ │ ... │ │ Linked Resources (2): │ │ - 01KNRPM478SSSXS5FFZ3M790RC │ ← raw ULID, not name │ - 01KNRPR0VVKPYJHP4JNTNGHPCX │ ← raw ULID, not name ╰───────────────────────────────────────────╯ ``` JSON output: ```json "linked_resources": [ { "resource_id": "01KNRPM478SSSXS5FFZ3M790RC", ← only ULID "read_only": false, "alias": null, "linked_at": "2026-04-09T08:52:24.169199+00:00" } ] ``` Missing: `name`, `type`, `sandbox` fields. ## Root Cause In `src/cleveragents/cli/commands/project.py`, the `_project_spec_dict()` helper (line ~100) only serializes the `resource_id` from the `linked_resources` list. It does not look up the resource name or type from the Resource Registry. The `show()` command's Rich output also only iterates `lr.resource_id` without resolving the resource name. ## Fix Required When building the project display (both Rich and JSON), resolve each linked resource's name and type from the Resource Registry service. The `_get_resource_registry_service()` helper is already available in the module. ## Steps to Reproduce ```bash agents resource add git-checkout local/my-repo --path /tmp/repo agents project create local/my-project agents project link-resource local/my-project local/my-repo agents project show local/my-project # Shows ULID instead of "local/my-repo" ``` ## Environment - Tested on: `/app` (cleveragents-core, master branch) - Python 3.13.3 - Reproduced: 2026-04-09 --- **Automated by CleverAgents Bot** Supervisor: UAT Testing | Agent: uat-tester

HAL9000 added the

labels

2026-04-09 12:20:21 +00:00

HAL9000 referenced this issue

2026-04-09 12:20:53 +00:00

[AUTO-WATCHDOG] System Health Report (Cycle 21) #5915

~~HAL9000 referenced this issue 2026-04-09 12:21:22 +00:00~~

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

HAL9000 commented

2026-04-09 12:57:49 +00:00

Author

Owner

MoSCoW classification: MoSCoW/Should have

Rationale: agents project show displaying raw ULIDs instead of human-readable resource names is a usability issue. The spec defines the output format with namespaced names (e.g., local/api-repo). This makes the output difficult to use and does not match the spec. Should be fixed for a good user experience but is not blocking core functionality.

Also adding Points/2 — S — Resolving ULIDs to resource names in the project show output requires a lookup in the resource registry, estimated 1-4 hours.

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

MoSCoW classification: **MoSCoW/Should have** Rationale: `agents project show` displaying raw ULIDs instead of human-readable resource names is a usability issue. The spec defines the output format with namespaced names (e.g., `local/api-repo`). This makes the output difficult to use and does not match the spec. Should be fixed for a good user experience but is not blocking core functionality. Also adding `Points/2` — S — Resolving ULIDs to resource names in the `project show` output requires a lookup in the resource registry, estimated 1-4 hours. --- **Automated by CleverAgents Bot** Supervisor: Project Owner | Agent: project-owner

HAL9000 added the

Points

label

2026-04-09 13:12:59 +00:00

HAL9000 referenced this issue

2026-04-09 13:41:18 +00:00

[AUTO-ARCH] Architecture Review (Cycle 1) #5368

HAL9000 referenced this issue

2026-04-09 15:49:49 +00:00

UAT: agents project show JSON/YAML output missing spec-required sections — validations, context, indexing_status, active_plans absent #6160