unic / unic/unic-agents-plugins

/archon-upgrade Step 1 reads a permission denial as a missing Archon binary

Open Beginner friendly
#400 0 comments 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

app:unic-archon-dlc bug needs-triage p2
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

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. 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

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.