Skip to content

Correct the v0.4.0 migration notes - #139

Merged
charlesgreen merged 1 commit into
mainfrom
fix/v040-migration-notes
Aug 9, 2026
Merged

charlesgreen merged 1 commit into
mainfrom
fix/v040-migration-notes

Conversation

@charlesgreen

Copy link
Copy Markdown
Contributor

The adversarial review of the rebrand (#137) confirmed three defects in the v0.4.0 CHANGELOG section, all in what it tells a migrating adopter to do:

  • It never said to delete the old caller workflow. .github/workflows/simplycubed.yml keeps firing on the same mention and label events after migration: duplicate runs with the old variables still set, a permanently failing run next to every real one once they are renamed.
  • "Regenerate the config" loses the adopter's settings. init on a repo with no .github/aixgo.yml writes a blank starter, dropping gate:, engine:, and attribution:. The right first step is renaming the old config file, which init then preserves.
  • The labelPrefix: sc escape hatch cannot work through Actions. The generated caller triggers on the literal ax:go, so a repo configured back to sc applies sc:go and silently starts nothing.

The section now gives the migration as five ordered steps, warns that the optional SIMPLYCUBED_DRY_RUN/SIMPLYCUBED_SANDBOX exports are silently ignored rather than failing (the required-value "fails loudly" claim was only true for required values), notes that in-flight sc:* issues must be finished before upgrading, and documents that the ledger starts fresh on aixgo/ledger with prior history remaining on the old branch.

Also fixes "a Aixgo Code marker" in a loop.go comment.

make check green; verify-release.sh v0.4.0 still consistent.

The migration paragraph told adopters to regenerate the config with init,
which writes a blank starter and drops the gate, engine, and attribution
settings; the right first step is renaming the old config file so init
keeps its values. It also never said to delete the old caller workflow,
which otherwise keeps firing on the same events, and it offered
labelPrefix: sc as an escape hatch that the generated caller's literal
ax:go trigger cannot honor. State each of those plainly, warn that the
optional SIMPLYCUBED_DRY_RUN/SANDBOX flags are ignored rather than failing,
note that in-flight sc:* issues must be finished before upgrading, and fix
an article in a loop.go comment.
@charlesgreen
charlesgreen merged commit 7548cd6 into main Aug 9, 2026
2 checks passed
@charlesgreen
charlesgreen deleted the fix/v040-migration-notes branch August 9, 2026 13:45
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.

1 participant