Repository navigation
feat: exact default pins with sync --upgrade #343
Description
Why
Pins are exact per project; the rolling window applies only to tools: "system" (ledger Branch 3 item 1).
In scope
Default pins table; version checks cached; ak sync --upgrade [name[@Version]] moves pins and shows what changes.
Out of scope
Sync rebuild (#355).
Acceptance criteria
- A new project gets the default pins
- --upgrade name@version moves one pin, forward or back
- The default Ruflo pin is chosen after a conformance run on 3.51.1, the first release whose pre-bash helper blocks (test: flag project hook helpers whose pre-bash exits 1 on [BLOCKED] #428); 3.48.0 carries the memory and daemon fixes our workarounds wait on. Any hard minimum for tools: "system" is decided here and recorded as an ADR-0041 §7 amendment
Dependencies
Blocked by: #339
Plan
- Release:
4.0.0-beta.1 - Size:
size:S· Workstream:ws:project-scope - Epic: feat: project-scope P2, tool cache and launchers (epic) #297
- Card:
P2-05in the card inventory - Sources: Design (docs(plans): project-scoped management design and its prerequisites #289) Commands; Supersession ledger (docs(plans): v4 GA master plan, supersession ledger and v5 registers #290) v1 items; upstream review 2026-10-02 (chore: triage D01, D10 and the [BLOCKED] hook exit-code finding #319, test: flag project hook helpers whose pre-bash exits 1 on [BLOCKED] #428)
Verification
node scripts/run-tests.mjs focus (new pin tests)
Activity
pacphi commentedon Oct 2, 2026
Decision, 2026-10-02 (option A on the Ruflo support floor): leave the ADR-0041 §7 rolling window unchanged for alpha.61, and settle the default pin and any hard minimum here, at beta.1.
Why it is not a one-line change: the floor is computed (the newest 6 minors, never fewer than those first published in the last 30 days). Ruflo shipped about 13 minors in a month, so it sits at 3.39.0 today. Forcing 3.48.0 now would change what
ak statuscalls unsupported. The maintainer's Mac runs ruflo 3.48.0 (it showed in the dashboard on 2026-10-02), so it would pass 3.48.0, but anyone on 3.39 to 3.47 would be flagged.What to decide here, with the evidence from the 2026-10-02 upstream review:
pre-bashhelper blocks in Claude Code (exit 2). It is hours old, so the default pin should follow a conformance run on it.tools: "system".The acceptance line for this is now in the card body.
Generated by Claude Code