Skip to content

chore(release): prepare 0.40.0-beta.5 - #636

Merged
mohanagy merged 2 commits into
nextfrom
agent/release-0.40.0-beta.5
Aug 2, 2026
Merged

chore(release): prepare 0.40.0-beta.5#636
mohanagy merged 2 commits into
nextfrom
agent/release-0.40.0-beta.5

Conversation

@mohanagy

@mohanagy mohanagy commented Aug 2, 2026

Copy link
Copy Markdown
Owner

Outcome

Prepare exactly @lubab/madar@0.40.0-beta.5 for npm dist-tag next from protected next, solely so the owner can manually test it before formal #631 qualification.

Owner authorization receipts:

Exact scope

  • Base: 9703a7090fd3ef3600b4ab4e298b12f0faa05a1e
  • Base tree: 5db67cbe19a9479409192558ea40b0ac8e3add78
  • Head: d424ab795cdb68be53dc81656b28e4a6582389b5
  • Head tree: 58afc08c8fcfe58e2ac99d430a0c9c78b032b76b
  • Target: protected next
  • Package metadata changes only the version from beta.4 to beta.5; dependencies are unchanged.
  • No src/**, graph/index/query behavior, CLI, MCP behavior, retrieval budgets, or TypeScript configuration changed.

The release workflow now runs from the exact protected-next package-version merge through npm Trusted Publishing. It fails closed unless the live next tip and protection match, the beta.5 git tag is absent, and the GitHub Releases API returns exactly authenticated HTTP 404. It publishes only npm next and re-verifies immutable identity, provenance, signatures, next=0.40.0-beta.5, and unchanged latest=0.32.0.

This PR creates no git tag or GitHub Release, does not dispatch or publish MCP Registry metadata, does not publish stable/latest, and never targets main. The checked-in Registry manifest is version-aligned only because registry:validate requires it; external Registry publication remains separate and forbidden.

Exact package receipt

Generated with Node 22.22.3 and npm 12.0.1:

  • files: 102
  • packed bytes: 155157
  • unpacked bytes: 653565
  • shasum: d637297412ec5b868586ba59142fbefdcfc0d5e0
  • integrity: sha512-HorzqtIvp2v5xMaYVGDzPDYtFBMaEVBkGXHBdTSVwC1DkQgmZaFuTU1Ff+7YByWN9FTQaVLTJsV7zKhEgSKxXw==
  • tarball SHA-256: 6e20a4edc6fb10ed3853f69e599676a723d2d771078810693f3cd13fc6e032dc

Verification

  • focused release/governance tests: 31/31
  • full coverage suite: 83 files / 899 tests
  • baseline: 5/5
  • typecheck, production build, evaluation build: pass
  • release hygiene and Registry validation: pass
  • frozen [P0][Retrieval]: Plan obligations and return strict answer-ready workflow dossiers #630 benchmark and CI eval regression: pass
  • serial packed checkout/artifact parity and isolation: pass
  • npm audit: zero vulnerabilities
  • registry signatures/attestations audit: pass
  • fresh tarball install: madar --version prints 0.40.0-beta.5
  • live authenticated no-tag/no-GitHub-Release probe: pass
  • independent exact-head review: no P0/P1 blocker on release/security, governance/package, and no-production-change axes

Qualification boundary

This package is a manual-test candidate, not a #631 result. It makes no comparator, no-fallback, token, latency, cost, activation, retention, or external-user claim. #631 and #629 remain open.

Summary by CodeRabbit

  • Release

    • Updated the package to version 0.40.0-beta.5.
    • Beta publication now targets npm’s next channel for manual testing.
    • This beta does not create Git tags or GitHub Releases.
  • Documentation

    • Updated release notes, roadmap, changelog, README, registry metadata, and governance documentation for beta.5.
    • Documented completed retrieval and execution improvements, with further qualification work still pending.
  • Validation

    • Added checks to prevent unintended release artifacts and verify publication integrity.

@coderabbitai

coderabbitai Bot commented Aug 2, 2026

Copy link
Copy Markdown

Review Change Stack

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info
⚙️ Run configuration

Configuration used: Path: .coderabbit.yaml

Review profile: CHILL

Plan: Pro Plus

Run ID: dab9e118-e62f-4a2a-ae06-7a75191ebeaa

📥 Commits

Reviewing files that changed from the base of the PR and between d424ab7 and 6ece8a6.

📒 Files selected for processing (3)
  • docs/core-reset/scorecard.md
  • docs/roadmap.md
  • tests/unit/core-reset-governance.test.ts
🚧 Files skipped from review as they are similar to previous changes (2)
  • docs/core-reset/scorecard.md
  • docs/roadmap.md

📝 Walkthrough

Walkthrough

The PR changes beta.5 publication from tag-triggered release creation to protected next-branch publication. It adds forbidden-artifact verification, updates package and governance metadata, and extends release workflow tests.

Changes

Beta.5 release flow

Layer / File(s) Summary
Forbidden artifact verification
.github/scripts/verify-forbidden-release-artifacts.mjs
Adds fail-closed checks for absent Git tags and GitHub Releases, with self-test coverage.
Protected publication workflow
.github/workflows/release.yml
Publishes beta.5 from protected next pushes with npm next tagging, provenance, integrity checks, and no tag or GitHub Release creation.
Release records and package metadata
CHANGELOG.md, README.md, docs/claims-and-evidence.md, docs/release.md, docs/mcp-registry/server.json, package.json, package-lock.json, sbom.cdx.json
Updates beta.5 version data, release instructions, changelog content, package metadata, and publication restrictions.
Core Reset governance state
docs/core-reset/*, docs/designs/2026-07-19-core-reset.md, docs/roadmap.md
Records obligation-driven retrieval as complete, no-fallback qualification as in progress, and beta.5 as a restricted manual-test candidate.
Release and governance validation
tests/unit/core-reset-governance.test.ts, tests/unit/release-docs.test.ts, tests/unit/release-hygiene.test.ts
Updates governance expectations and validates protected-branch publication, forbidden-artifact checks, package integrity, provenance, and signature auditing.

Estimated code review effort: 4 (Complex) | ~45 minutes

Sequence Diagram(s)

sequenceDiagram
  participant NextPush
  participant ReleaseWorkflow
  participant ArtifactVerifier
  participant Npm
  NextPush->>ReleaseWorkflow: push package.json change to next
  ReleaseWorkflow->>ArtifactVerifier: verify v0.40.0-beta.5 is absent
  ArtifactVerifier-->>ReleaseWorkflow: Git tag and GitHub Release absent
  ReleaseWorkflow->>Npm: publish with next tag and provenance
  ReleaseWorkflow->>ArtifactVerifier: verify artifacts and package integrity
Loading

Possibly related issues

  • mohanagy/madar#631 — The PR authorizes beta.5 manual qualification and updates governance for the same no-fallback qualification work.

Possibly related PRs

  • mohanagy/madar#628 — Both PRs update beta release gating, artifact verification, and release hygiene.
  • mohanagy/madar#635 — Both PRs update obligation-driven retrieval governance, tests, and beta package metadata.
  • mohanagy/madar#461 — Both PRs modify prerelease publication and release-hygiene checks.

Suggested labels: roadmap, type:docs, core-reset

🚥 Pre-merge checks | ✅ 3 | ❌ 2

❌ Failed checks (2 warnings)

Check name Status Explanation Resolution
Description check ⚠️ Warning The description is detailed but does not follow the required template or provide the required Core Reset contract and checklist sections. Add the required Summary, Testing, Core Reset contract, Reset scope checks, Checklist, and Related issues sections with completed values and checkboxes.
Docstring Coverage ⚠️ Warning Docstring coverage is 0.00% which is insufficient. The required threshold is 80.00%. Write docstrings for the functions missing them to satisfy the coverage threshold.
✅ Passed checks (3 passed)
Check name Status Explanation
Title check ✅ Passed The title clearly and concisely identifies preparation of release version 0.40.0-beta.5.
Linked Issues check ✅ Passed Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check ✅ Passed Check skipped because no linked issues were found for this pull request.
✨ Finishing Touches 💡 1
📝 Generate docstrings 💡
  • Create stacked PR
  • Commit on current branch
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch agent/release-0.40.0-beta.5

Comment @coderabbitai help to get the list of available commands.

@mohanagy

mohanagy commented Aug 2, 2026

Copy link
Copy Markdown
Owner Author

Independent exact-head review receipt

Subject head: d424ab795cdb68be53dc81656b28e4a6582389b5
Subject tree: 58afc08c8fcfe58e2ac99d430a0c9c78b032b76b
Base: protected next at 9703a7090fd3ef3600b4ab4e298b12f0faa05a1e

Three independent read-only review axes pass with no P0/P1 blocker:

  1. release workflow / trusted-publishing / forbidden side effects;
  2. package identity / governance truthfulness / authorization scope;
  3. zero production, dependency, graph/index/query, CLI, MCP, or TypeScript-configuration change.

Pre-commit review caught and the final head fixes: a stale top-level package receipt, fail-open tag/Release probes, stale SBOM identity, an inconsistent source-delta base, and npm-init working-directory leakage. The corrected exact head has fail-closed probes, a fresh SBOM, exact source/package receipts, isolated temporary install verification, and version-only package metadata.

Exact package: 102 files / 155157 packed / 653565 unpacked; shasum d637297412ec5b868586ba59142fbefdcfc0d5e0; tarball SHA-256 6e20a4edc6fb10ed3853f69e599676a723d2d771078810693f3cd13fc6e032dc.

CI, CodeRabbit, and unresolved-thread gates remain pending and will be recorded separately before merge.

@coderabbitai coderabbitai Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actionable comments posted: 1

🤖 Prompt for all review comments with AI agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

Inline comments:
In `@docs/core-reset/scorecard.md`:
- Line 48: Update docs/core-reset/scorecard.md lines 48-48 to replace active
beta.5 testing language with wording that publication and owner testing are
authorized but pending the protected-next release merge; update docs/roadmap.md
lines 184-186 to state that `#631` remains in progress while npm publication and
owner manual testing are pending that merge.
🪄 Autofix (Beta)

Fix all unresolved CodeRabbit comments on this PR:

  • Push a commit to this branch (recommended)
  • Create a new PR with the fixes

ℹ️ Review info
⚙️ Run configuration

Configuration used: Path: .coderabbit.yaml

Review profile: CHILL

Plan: Pro Plus

Run ID: 262292d6-15da-45f0-92c9-27f957f970a6

📥 Commits

Reviewing files that changed from the base of the PR and between 9703a70 and d424ab7.

📒 Files selected for processing (17)
  • .github/scripts/verify-forbidden-release-artifacts.mjs
  • .github/workflows/release.yml
  • CHANGELOG.md
  • README.md
  • docs/claims-and-evidence.md
  • docs/core-reset/removal-manifest.yml
  • docs/core-reset/scorecard.md
  • docs/designs/2026-07-19-core-reset.md
  • docs/mcp-registry/server.json
  • docs/release.md
  • docs/roadmap.md
  • package-lock.json
  • package.json
  • sbom.cdx.json
  • tests/unit/core-reset-governance.test.ts
  • tests/unit/release-docs.test.ts
  • tests/unit/release-hygiene.test.ts

Comment thread docs/core-reset/scorecard.md Outdated
@mohanagy

mohanagy commented Aug 2, 2026

Copy link
Copy Markdown
Owner Author

Corrective exact-head independent review receipt

Subject head: 6ece8a638625b5deaf49cbf88572ac4d52896470
Subject tree: 9d3d90fe7feb3e55042c4f38ac8925abca6e83d1
Base: protected next at 9703a7090fd3ef3600b4ab4e298b12f0faa05a1e

Three independent read-only review axes pass with no P0/P1 blocker:

  1. the CodeRabbit data-integrity finding is fully corrected in both governance documents and every matching assertion;
  2. the correction changes exactly two governance documents plus their assertion test (+6/-6), with no production, package, workflow, dependency, SBOM, README, Registry, CLI, MCP, graph/index/query, or semantic change;
  3. the trusted npm-next publication path and fail-closed no-tag/no-GitHub-Release safeguards remain byte-identical.

Focused governance/release tests pass 31/31; release hygiene and Registry validation pass. The npm artifact remains exact and byte-identical: 102 files / 155,157 packed / 653,565 unpacked; shasum d637297412ec5b868586ba59142fbefdcfc0d5e0; tarball SHA-256 6e20a4edc6fb10ed3853f69e599676a723d2d771078810693f3cd13fc6e032dc.

CI completion, CodeRabbit, protected-base freshness, and zero unresolved threads remain separate final merge gates.

@mohanagy

mohanagy commented Aug 2, 2026

Copy link
Copy Markdown
Owner Author

Final protected-next merge-gate receipt

Exact head: 6ece8a638625b5deaf49cbf88572ac4d52896470
Exact tree: 9d3d90fe7feb3e55042c4f38ac8925abca6e83d1
Protected base immediately before merge: next at 9703a7090fd3ef3600b4ab4e298b12f0faa05a1e
Target: next (never main)

All required exact-head gates pass in CI run 30733781821:

CodeRabbit is SUCCESS on the exact head. Its one actionable truthfulness thread was fixed in 6ece8a6, replied to, and is resolved/outdated; its generic docstring-coverage walkthrough warning is non-blocking. Three independent exact-head read-only review axes found no P0/P1 blocker. GraphQL reports 1 total historical review thread and 0 unresolved. GitHub reports MERGEABLE / CLEAN.

The npm artifact remains exact: 102 files / 155,157 packed / 653,565 unpacked; shasum d637297412ec5b868586ba59142fbefdcfc0d5e0; tarball SHA-256 6e20a4edc6fb10ed3853f69e599676a723d2d771078810693f3cd13fc6e032dc. Immediately before merge, npm is still next=0.40.0-beta.4, latest=0.32.0, beta.5 is absent, and authenticated GitHub probes confirm no beta.5 tag or GitHub Release.

Authorized post-merge side effect: publish exactly @lubab/madar@0.40.0-beta.5 under npm next through trusted publishing. Stable/latest, GitHub Release, Registry publication, git tag, and main remain forbidden.

@mohanagy
mohanagy merged commit 81045cc into next Aug 2, 2026
7 checks passed
@mohanagy

mohanagy commented Aug 2, 2026

Copy link
Copy Markdown
Owner Author

Publication completion receipt

Protected squash merge: 81045cc08f1df797ecb86748c9bce09db62aeebd
Merge tree: 9d3d90fe7feb3e55042c4f38ac8925abca6e83d1 (identical to reviewed head tree)
Sole parent: audited protected next base 9703a7090fd3ef3600b4ab4e298b12f0faa05a1e
Trusted-publishing run: https://github.com/mohanagy/madar/actions/runs/30734176943 — SUCCESS

Published exactly @lubab/madar@0.40.0-beta.5 under npm next. npm latest remains 0.32.0. Registry values match the sealed candidate: 102 files / 155,157 packed / 653,565 unpacked; shasum d637297412ec5b868586ba59142fbefdcfc0d5e0; integrity sha512-HorzqtIvp2v5xMaYVGDzPDYtFBMaEVBkGXHBdTSVwC1DkQgmZaFuTU1Ff+7YByWN9FTQaVLTJsV7zKhEgSKxXw==; downloaded tarball SHA-256 6e20a4edc6fb10ed3853f69e599676a723d2d771078810693f3cd13fc6e032dc; SLSA provenance attestation present.

An independent clean temporary install returned madar --version = 0.40.0-beta.5; npm audit signatures verified 3 registry signatures and 1 attestation. Authenticated fail-closed checks confirm no v0.40.0-beta.5 git tag and no GitHub Release. The MCP Registry workflow did not run; its latest run remains the July 28 manual dispatch 30388557700. main remains unchanged at 647c2912e9ff000b5d92cae3fc61395d9e556062.

This publication enables owner manual testing only. It does not qualify or close #631 and makes no stable, comparative, or external-validation claim.

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