Skip to content

Cut the first release: tag, publish and the releases-page entry #336

Description

@sameera

Cut the first release of the one-package distribution: tag the version, publish it to the public registry, and create the releases-page entry from the changelog section — one semantic version named by all three.

Meta

Why it was deferred

Everything the release needs is built and proven: the manifest declares both binaries, the payload is a stated set with a committed fingerprint, the parity gate checks what is released, the changelog carries the 0.1.0 entry, and pack-release.spec.ts proves npm pack plus a real global install runs both binaries from outside the checkout.

What is missing is not release machinery — it is that decision record #334 invariant 15 forbids cutting the tail while a shipped component body reaches a toolkit capability by an in-repository script path. Those paths exist in no installed package, so a release cut today would put bodies on the registry that cannot work, and the changelog's own claim that a stage runs without a checkout would be false on the first release. pnpm nexus:release-gate enforces this and names twelve such references today, across nxs.epic.md, nxs.setup.md and nxs-epic-resolve/SKILL.md.

Revisit trigger

Epic #250 merged and pnpm nexus:release-gate exiting zero. Then follow docs/delivery/release-procedure.md from step 4.

Acceptance criteria

  • pnpm nexus:release-gate exits zero before anything is tagged.
  • One git tag, one version on the public registry and one GitHub release entry all name the same semantic version as VERSION, the published manifest and the newest changelog entry.
  • The releases-page entry body is the changelog section for that version.
  • Both binaries run from a directory that is not a checkout, installed from the registry rather than from a local pack.

Metadata

Metadata

Assignees

No one assigned

    Labels

    backlogepicEpic (created by nxs-gh-create-epic)

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions