unic / unic/unic-agents-plugins

/archon-upgrade cannot produce a pre-adoption report — Step 1 compares floor, never latest

Open
#423 0 comments 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

app:unic-archon-dlc bug p2
Dominant language
JavaScript
Stars
1
Forks
0
Avg merge
16h 43m
Merged PRs (30d)
19

Description

The defect

Measured on the command's first real proof run (2026-08-25, DXP-DesignSystem, plugin 0.24.2, Archon 0.7.0; full record relayed to #373's orchestrator): Step 1 branches on installed-vs-floor. Installed 0.7.0 == floor 0.7.0 → "no release range to assess", Steps 2–4 skip, only 5 and 6 run.

So the command is structurally silent in exactly the state a Consumer asks the question from: the CLI prints "Update available: v0.7.0 → v0.9.0" and the operator wants to know what adopting would mean before adopting. The command's own header ("run it after brew upgrade archon") is self-consistent — but classify-after-adoption inverts the decision the report exists to inform. #396 fixed Steps 5–6 being unreachable at floor; this is the remaining half.

The fix shape (from the run's own workaround)

Step 1 also compares installed against the latest released tag, and when floor < latest, runs Steps 2–4 over floor→latest as the pre-adoption report. The proof run executed exactly that by hand and produced a real table (ADOPT 3 · DEFER 1 · VERIFY-ONLY 9 · BREAKS-US 1), so the range-read works — only the branch withholds it.

Acceptance criteria

  • Run at installed == floor with a newer release available: Steps 2–4 execute over floor→latest and the table is produced, pre-adoption.
  • Run at installed == floor == latest: the command still reports "nothing to assess" and runs Steps 5–6 (the #396 behaviour is preserved).
  • ADR-0035 is amended per the dated-blockquote convention.

Context

Related, same proof run: the probe-repeatability defect and the 0.9.0 MCP-inheritance BREAKS-US row (separate tickets); #422 (locate mechanism).

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

Start at the /archon-upgrade command's Step 1 branching logic and trace how it selects the installed, floor, and latest released versions. Verify that Steps 2–4 produce the floor→latest pre-adoption table when a newer release exists, while Steps 5–6 still run when installed equals the latest; then amend ADR-0035 using its dated-blockquote convention.

Written by the indexing model from the issue text.

Assessment

Tech stack
javascript
Domain
cli, documentation
Issue type
Bug
Difficulty
3/5
Estimated time
1-2 days
Activity status
Active
Clarity
Mostly clear
Newbie friendliness
68/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.