Skip to content

fix(release): normalise bin paths so npm stops auto-correcting on publish - #227

Merged
beyondnetPeru merged 1 commit into
developfrom
docs/gaps-component-assessment
Jul 27, 2026
Merged

fix(release): normalise bin paths so npm stops auto-correcting on publish#227
beyondnetPeru merged 1 commit into
developfrom
docs/gaps-component-assessment

Conversation

@beyondnetPeru

Copy link
Copy Markdown
Contributor

Pull Request Summary

Last defect found by rehearsal before publishing 1.2.0.

The second dry run (30271837941) was clean on everything the first one found — LICENSE ships in all four packages, repository.url no longer normalised — but still reported two auto-correction warnings from a different cause:

npm warn publish "bin[evolith-mcp]" script name was cleaned
npm warn publish "bin[evolith]" script name was cleaned
npm warn publish "bin[evolith-cli]" script name was cleaned

mcp-server and cli declared their bins as ./dist/main.js; npm strips the leading ./ on publish and warns while doing it. Declaring the normalised form is what npm pkg fix would do and changes nothing about resolution — verified after the change: cli --version prints 1.2.0 and the MCP server still starts.

Publishing through a warning means accepting that npm rewrites your manifest for you. With warnings at zero, what is declared is what is published.

Both defects fixed during this release preparation were found by rehearsal, and both would have been permanent — npm forbids unpublishing after 72 hours. That is the argument for dry_run defaulting to true, stated as evidence rather than opinion:

Rehearsal Found
Run 1 no LICENSE in any of the 4 tarballs; repository.url auto-corrected in all 8
Run 2 bin paths auto-corrected in 2

Evolith Core Quality Gates

  • Bilingual Parity: two manifests touched, no prose.
  • Validation Scripts: 01-validate-docs.mjs green (via ci-runner governance).
  • Bilingual Validation: 04-check-bilingual-parity.mjs green (via ci-runner governance).
  • Agnosticism: no dependency added.

Verification

10-validate-contract-conformance, 11-validate-product-docs and 24-check-surface-parity exit 0 · ci-runner governance 17/17 exit 0 · npm pack --dry-run reports 0 auto-correction warnings for both packages · binaries still resolve (cli --version → 1.2.0, MCP server starts).

Linked ADRs / Issues

  • Link to Issue: GT-570

Conventional Commits

  • Title and commits follow Conventional Commits.

🤖 Generated with Claude Code

…lish

The second dry run (30271837941) was clean on everything the first one found —
LICENSE ships in all four packages, repository.url no longer normalised — but
still reported two auto-correction warnings, from a different cause:

  npm warn publish "bin[evolith-mcp]" script name was cleaned
  npm warn publish "bin[evolith]" script name was cleaned
  npm warn publish "bin[evolith-cli]" script name was cleaned

`mcp-server` and `cli` declared their bins as `./dist/main.js`; npm strips the
leading `./` on publish and warns while doing it. Declaring the normalised form
is what `npm pkg fix` would do, and it changes nothing about how the binaries
resolve — verified after the change: `cli --version` prints 1.2.0 and the MCP
server still starts.

Publishing through a warning means accepting that npm rewrites your manifest for
you. With the warnings at zero, what is declared is what is published.

Both defects fixed in this release preparation were found by rehearsal, and both
would have been permanent — npm forbids unpublishing after 72 hours. That is the
argument for `dry_run` defaulting to true, restated as evidence rather than
opinion.

Verified: 10-validate-contract-conformance, 11-validate-product-docs and
24-check-surface-parity exit 0; ci-runner governance 17/17 exit 0; `npm pack
--dry-run` reports 0 auto-correction warnings for both packages.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
@beyondnetPeru
beyondnetPeru requested a review from a team as a code owner July 27, 2026 13:55
@chatgpt-codex-connector

Copy link
Copy Markdown

You have reached your Codex usage limits for code reviews. You can see your limits in the Codex usage dashboard.

@github-actions

Copy link
Copy Markdown

📊 Bilingual Coverage Impact

PR Changes

  • Paired EN/ES files modified: 0
  • New EN files needing ES translation: 0

Repository Coverage

Metric Value
Total EN files 522
Total ES files 496
Paired files 0
Coverage 0%

Good: All EN changes have ES counterparts.


Generated by GitHub Actions

@beyondnetPeru
beyondnetPeru merged commit 25c8367 into develop Jul 27, 2026
31 of 33 checks passed
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