Skip to content

Require explicit catalog refs - #726

Merged
eloylp merged 2 commits into
mainfrom
fix/725-explicit-catalog-refs
Aug 10, 2026
Merged

Require explicit catalog refs#726
eloylp merged 2 commits into
mainfrom
fix/725-explicit-catalog-refs

Conversation

@eloylp

@eloylp eloylp commented Aug 9, 2026

Copy link
Copy Markdown
Owner

Summary

  • require explicit public ids when creating new prompt, skill, and guardrail catalog rows
  • preserve no-id updates only when the same-scope/name row already exists
  • update REST, MCP, UI forms, docs, and fixtures for explicit catalog refs

Verification

  • go test ./internal/mcp
  • go test ./internal/store ./internal/daemon ./internal/mcp ./internal/workflow ./internal/selfimprovement ./internal/scheduler ./internal/webhook
  • npm test (internal/ui)
  • npm run build (internal/ui)
  • go test ./...

Closes #725

Require new prompt, skill, and guardrail catalog rows to provide an explicit public id instead of deriving one from scope and name. Preserve same-scope/name updates without an id so existing imports can keep historical refs.

Update REST, MCP, UI forms, docs, and fixtures to use explicit refs for new catalog assets.

Agents-Run: 75c58f0fd89ea71c

Agents-Agent: coder

Agents-Attribution: eyJ2IjoxLCJpbnN0YW5jZV9pZCI6InRzLWxvbmVzdGFyIiwid29ya3NwYWNlIjoiZGVmYXVsdCIsInJlcG8iOiJlbG95bHAvYWdlbnRzIiwic3Bhbl9pZCI6Ijc1YzU4ZjBmZDg5ZWE3MWMiLCJhZ2VudF9pZCI6ImFnZW50XzBmYjgyZDFmZTM0ZTQ1NDA4YmQyZmVlMTUzZjcwMDNkIiwiYWdlbnRfbmFtZSI6ImNvZGVyIiwic2lnIjoiRlc3bzdlTTFBSEdUNlFuRm5CYTJxd0h4UjVLaEtnSUFZT1B5V0Jpa29MayJ9
@eloylp eloylp added ai ready Maintainer signal: the agent fleet may work on this issue or PR ai inprogress Visible semaphore: an agent is actively working on this issue or PR labels Aug 9, 2026
@eloylp

eloylp commented Aug 9, 2026

Copy link
Copy Markdown
Owner Author

PR Review — pr-reviewer

Verdict: APPROVE

Findings

  • None.

Summary

The PR satisfies #725: new prompt/skill/guardrail create/import paths now require explicit public refs, existing same-scope/name no-id updates preserve refs, and REST/MCP/UI surfaces document and enforce the new requirement.

Verification: go test ./internal/store ./internal/daemon ./internal/mcp

@eloylp eloylp added human review ready Passed AI review, ready for human merge decision and removed ai inprogress Visible semaphore: an agent is actively working on this issue or PR labels Aug 9, 2026
@eloylp

eloylp commented Aug 10, 2026

Copy link
Copy Markdown
Owner Author

Blocking finding:

config.example.yaml still defines all prompts: entries without id, but this PR now rejects new prompt imports without explicit ids. Seeding an empty daemon with the documented example will fail on the first prompt, e.g. store import: prompt "scout-issues" requires explicit id.

Please add id: to each prompt entry in config.example.yaml, and update the short example comment near the top of that file so the shipped import template remains valid under the new contract.

@eloylp eloylp added the ai inprogress Visible semaphore: an agent is actively working on this issue or PR label Aug 10, 2026
@eloylp

eloylp commented Aug 10, 2026

Copy link
Copy Markdown
Owner Author

PR Review — pr-reviewer

Verdict: REQUEST_CHANGES

Findings

  • [blocking] config.example.yaml:9 — Issue Require explicit public refs for new intelligence catalog assets #725 requires import documentation/templates to enforce explicit public refs, and the maintainer specifically asked for id: on each prompt entry in config.example.yaml. The PR branch still shows the short example and all concrete prompts: entries without id, so importing the shipped empty-daemon template will still fail under the new validation contract.

Summary

The code direction is still sound, but the documented example config remains invalid for new prompt imports.

@eloylp eloylp added ai inprogress Visible semaphore: an agent is actively working on this issue or PR and removed human review ready Passed AI review, ready for human merge decision ai inprogress Visible semaphore: an agent is actively working on this issue or PR labels Aug 10, 2026
Agents-Run: 267df1cfb2d64810

Agents-Agent: coder

Agents-Attribution: eyJ2IjoxLCJpbnN0YW5jZV9pZCI6InRzLWxvbmVzdGFyIiwid29ya3NwYWNlIjoiZGVmYXVsdCIsInJlcG8iOiJlbG95bHAvYWdlbnRzIiwic3Bhbl9pZCI6IjI2N2RmMWNmYjJkNjQ4MTAiLCJhZ2VudF9pZCI6ImFnZW50XzBmYjgyZDFmZTM0ZTQ1NDA4YmQyZmVlMTUzZjcwMDNkIiwiYWdlbnRfbmFtZSI6ImNvZGVyIiwic2lnIjoiWkZiMmc5clR5Ml82UHZ6blA3Yl9zNk8xZmxSekFfSzFoS1I3aFVlUDgzRSJ9
@eloylp

eloylp commented Aug 10, 2026

Copy link
Copy Markdown
Owner Author

Addressed the blocking feedback by adding explicit id: values to every prompt entry in config.example.yaml and updating the short import-format snippet at the top to show the required prompt ref.

Verification: go test ./...

@eloylp eloylp added ai inprogress Visible semaphore: an agent is actively working on this issue or PR and removed ai inprogress Visible semaphore: an agent is actively working on this issue or PR labels Aug 10, 2026
@eloylp

eloylp commented Aug 10, 2026

Copy link
Copy Markdown
Owner Author

PR Review — pr-reviewer

Verdict: APPROVE

Findings

  • None.

Summary

The updated PR satisfies issue #725, including the shipped config.example.yaml import template: the short prompt example and every concrete prompt entry now include explicit stable id: values, while the create/import paths still preserve existing same-scope/name refs for compatibility.

Verification: go test ./...; GitHub check test passed on dcba3d0ed56e99c7addde2f6824d7d6f5154f530.

@eloylp eloylp added human review ready Passed AI review, ready for human merge decision and removed ai inprogress Visible semaphore: an agent is actively working on this issue or PR labels Aug 10, 2026
@eloylp
eloylp merged commit e0c34fb into main Aug 10, 2026
1 check passed
@eloylp
eloylp deleted the fix/725-explicit-catalog-refs branch August 10, 2026 12:56
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

ai ready Maintainer signal: the agent fleet may work on this issue or PR human review ready Passed AI review, ready for human merge decision

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Require explicit public refs for new intelligence catalog assets

1 participant