Skip to content

fix(discovery): skip bracketed argument-hint instead of failing the command - #204

Open
rudycelekli wants to merge 1 commit into
uber:mainfrom
rudycelekli:fix/discovery-argument-hint-brackets
Open

rudycelekli wants to merge 1 commit into
uber:mainfrom
rudycelekli:fix/discovery-argument-hint-brackets

Conversation

@rudycelekli

@rudycelekli rudycelekli commented Oct 19, 2026 •

Copy link
Copy Markdown

What type of PR is this? (check all applicable)

  • Refactor
  • Feature
  • Bug Fix
  • Optimization
  • Documentation Update

Related issue: N/A (found by reading the code; reproduced on main at 6b33dff)

What changed?
Return _SKIP for a [-led value of a non-list key before parsing (the items were already discarded for non-list keys).

Why?
Extractor/formats/frontmatter.py:155-158 sends any [-led value to _flow_items, even for non-list keys. argument-hint: [pr-number] [priority] [assignee] (the form in Claude Code's slash-command docs) raises Unrepresentable("nested collection in flow list"); surfaces._declaration only catches NoFrontmatter, so the command becomes an ExtractError and is missing from the inventory.

How did you test it?

  • Reproduction: uv run --python 3.11 pytest -q adr_discovery/tests_unit/test_frontmatter_tolerance.py -> main: 2 failed, 21 passed; branch: 23 passed.
  • Test suite: Discovery pytest -q 562 passed; ruff check . clean.

Potential risks
The change only affects the input described above; other paths go through the same code as before, and the component's existing tests pass.

…ommand

Claude Code documents slash-command hints as
`argument-hint: [pr-number] [priority] [assignee]`. The frontmatter
reader sent every `[`-led value to the flow-list parser, which raised
Unrepresentable on the second `[`, so the whole command file became an
ExtractError and dropped out of the inventory. Non-list keys never use
the flow items (a single `[message]` was already skipped), so skip them
before parsing.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@CLAassistant

Copy link
Copy Markdown

CLA assistant check
Thank you for your submission! We really appreciate it. Like many open source projects, we ask that you sign our Contributor License Agreement before we can accept your contribution.
You have signed the CLA already but the status is still pending? Let us recheck it.

This branch has not been deployed

No deployments
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants