unic / unic/unic-agents-plugins
/archon-upgrade Step 1 reads a permission denial as a missing Archon binary
Nobody has claimed this yet.
- Dominant language
- JavaScript
- Stars
- 1
- Forks
- 0
- Avg merge
- 16h 43m
- Merged PRs (30d)
- 19
Description
What happened
Found 2026-08-20 during #381's Consumer close-out run (DXP-DesignSystem, plugin 0.23.0, WI 42952). A claude -p run starts in a restrictive permission mode; the shell denied archon --version, and /unic-archon-dlc:archon-upgrade Step 1 reported "Archon is unusable at all" — the verdict for a missing binary, when the binary was present and the command merely refused.
Not a silent failure — the command took its documented branch and reported honestly. But that branch reads "the command is not found, or fails for any other reason", so a permission denial is indistinguishable from a broken install, and the operator gets a confident wrong diagnosis.
Acceptance criterion
Step 1's cannot-run branch tells the operator to check for a permission denial before believing the missing-binary verdict — one line, in the command's own prose. Checked by reading commands/archon-upgrade.md.
Context
The workaround is recorded in the Consumer (DXP-DesignSystem/docs/agents/unic-archon-dlc.md); the fix belongs here. Evidence chain on #381's close-out report (orchestrator session, 2026-08-20 15:54).
Contributor guide
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
Research direction
Open commands/archon-upgrade.md and read Step 1's cannot-run branch. Update that branch's prose to tell the operator to check for a permission denial before concluding that the Archon binary is missing; completion is verified by reading the updated command text.
Written by the indexing model from the issue text.
Assessment
- Domain
- cli, documentation
- Issue type
- Documentation
- Difficulty
- 1/5
- Estimated time
- Under an hour
- Activity status
- Quiet
- Clarity
- Clearly specified
- Newbie friendliness
- 85/100