Skip to content

feat: release 1.0.0 with a rewritten README and pinnable release versions - #60

Merged
liam-machine merged 1 commit into
mainfrom
ship/v1-0-0
Sep 12, 2026
Merged

liam-machine merged 1 commit into
mainfrom
ship/v1-0-0

Conversation

@liam-machine

Copy link
Copy Markdown
Owner

Summary

  • Declares 1.0.0. Schema v5 has been stable since 0.6.x and fifty-three releases have shipped without a breaking on-disk change. The version number now reflects that.
  • Makes a non-patch release possible. scripts/release.mjs next-version only ever patch-bumped, so 1.0.0 was unreachable without publishing by hand. It now honours an explicit version in the changelog's ## Unreleased heading (## Unreleased — 1.0.0) and releases exactly that. The pin may only move the version forward, so a pin at or below anything already published is ignored in favour of the patch bump.
  • Rewrites the README. Opens with what the extension is, shows the two-file design in one diagram, states the reasons to use it as outcomes, and documents the logical-only setup for people not using dbt.
  • Fixes the README images. They came from a separate assets repo last updated in April, so GitHub and the Marketplace overview still showed the pre-rebrand icon while the extension shipped the Ember Alloy one. Both now point at media/ on main. The README-only images are excluded from the .vsix, since packaging rewrites those links to absolute URLs and a bundled copy is never read.

Test plan

  • npm run compile — clean on both tsconfigs
  • npm run test — 1403 tests, 60 files, all passing (31 in release.test.ts, 9 of them new)
  • npx @vscode/vsce package succeeds; vsce ls lists 12 files (limit 60)
  • Packaged README rewrites the relative image to an absolute github.com URL, so the Marketplace renders it
  • release.mjs next-version against a simulated marketplace payload prints 1.0.0, logging changelog pins v1.0.0; releasing that instead of v0.6.54
  • After merge: deploy publishes v1.0.0, pushes the bump commit, and creates the v1.0.0 tag and GitHub Release with the .vsix attached

🤖 Generated with Claude Code

https://claude.ai/code/session_014ywafwDpxdWWBt26Q1keiP

…ions

The file format has been stable at schema v5 since 0.6.x and fifty-three
releases have shipped without a breaking change on disk, so the version
number should say so.

Two things stood between here and 1.0.0:

- The deploy workflow always computed the next version as a patch bump,
  which made any minor or major release unreachable without publishing by
  hand. next-version now honours an explicit version written into the
  changelog's Unreleased heading, where the notes it describes already
  live. The pin may only move the version forward, so it cannot undo the
  "never fails with version already exists" guarantee the rest of that
  function exists to provide.

- The README led with a slogan and never said plainly what the extension
  is. It now opens with the idea, shows the whole design in one diagram,
  states the reasons to use it as outcomes, and documents the logical-only
  setup for people who do not use dbt. Its images move off the stale
  external assets repo onto this one, so the icon on GitHub and the
  Marketplace can no longer disagree with the one that ships in the
  package.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_014ywafwDpxdWWBt26Q1keiP
@liam-machine
liam-machine merged commit a0c9b15 into main Sep 12, 2026
3 checks passed
@liam-machine
liam-machine deleted the ship/v1-0-0 branch September 12, 2026 06:44
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