Releases are cut locally and pushed straight to GitHub with gh - there is
no CI. The release artifacts include gitignored local build output (the
.vsix, the bundled CLI) that a clean checkout could not reproduce, so the
release is assembled on the maintainer's machine.
ghinstalled and authenticated (gh auth login).zipavailable on PATH.- A clean working tree on
main, up to date withorigin.
-
Bump
versioninpackage.json(this is the single source of truth; the tag isv<version>and the.vsix,pine-lint --version, and every artifact'smanifest.jsonall read from it). -
Add a matching section to
CHANGELOG.md:## <version> - What changed
The release body is this section (extracted from the
## <version>heading down to the next##heading; a generic note is used if none is found), followed by an auto-generated "Artifacts" section describing the uploaded files. You only write the changelog; the artifact rundown is added by the release script. -
Commit the version bump and changelog.
-
(Optional) Preview without tagging or publishing:
pnpm run release -- --dry-run
This builds and stages all artifacts under
build/release/and prints the notes it would post, but does not tag, push, or create a release. -
Cut the release:
pnpm run release
This runs the test suite, builds and packages everything, tags
v<version>, pushes the tag, and creates the GitHub release with the artifacts attached.
The release uploads four version-stamped artifacts:
| Artifact | Contents |
|---|---|
pine-tools-<version>.vsix |
The VS Code extension bundle. |
pine-lint |
The self-contained Node CLI (executable; #!/usr/bin/env node). |
pine-data-v6-<version>.zip |
pine-data/v6/*.json + the pine-manual/v6 tree + manifest.json. |
pine-manual-v6-<version>.zip |
The pine-manual/v6 tree + manifest.json. |
manifest.json records the version, tag, short git SHA, and build time.
--dry-run- build and stage artifacts, but do not tag, push, or release.--skip-tests- skip the test suite (not recommended for a real release).
pnpm run release aborts before doing anything irreversible if:
ghis not authenticated.- The working tree is dirty.
- The tag
v<version>already exists locally or onorigin. pine-manual/v6orpine-data/v6/*.jsonis missing.