Skip to content

chore: release v0.3.0 (lockstep) + sibling dep refresh#99

Merged
LanNguyenSi merged 1 commit into
masterfrom
chore/release-v0.3.0
May 27, 2026
Merged

chore: release v0.3.0 (lockstep) + sibling dep refresh#99
LanNguyenSi merged 1 commit into
masterfrom
chore/release-v0.3.0

Conversation

@LanNguyenSi
Copy link
Copy Markdown
Owner

Summary

Lockstep release of the four version-locked library packages plus a same-PR refresh of the three sibling packages whose pinned-exact deps would otherwise drift.

Package Old New Reason
@lannguyensi/grounding-wrapper 0.2.0 0.3.0 New behavior (see CHANGELOG)
@lannguyensi/evidence-ledger 0.2.0 0.3.0 Lockstep, no code change
@lannguyensi/claim-gate 0.2.0 0.3.0 Lockstep, no code change
@lannguyensi/hypothesis-tracker 0.2.0 0.3.0 Lockstep, no code change
@lannguyensi/grounding-mcp 0.3.0 0.3.1 Pinned deps refresh (+ PACKAGE_VERSION constant)
@lannguyensi/grounding-sdk 0.1.0 0.1.1 Pinned deps refresh
@lannguyensi/review-claim-gate 0.1.0 0.1.1 Pinned deps refresh

Why grounding-wrapper bumps minor

Two PRs landed today on grounding-wrapper:

The validateKeyword throws are technically a behavior change (previously-accepted inputs now throw), which warrants the MINOR bump per semver. Grep across the monorepo confirmed every existing initSession( caller uses a valid keyword; no internal regressions.

Why the siblings bump in this PR

grounding-mcp, grounding-sdk, review-claim-gate had pinned exact "0.2.0" deps on the lockstep set. Bumping lockstep alone causes npm to fetch 0.2.0 from the registry (workspace can't satisfy "0.2.0" once it's 0.3.0), producing dev-environment drift where source has 0.3.0 but installs run against 0.2.0. Per memory feedback_workspace_release_mechanics, pinned-exact cross-workspace deps force this kind of paired bump.

grounding-mcp also updates its in-source PACKAGE_VERSION constant (the cli-version test pins it to match package.json).

Lockfile

package-lock.json is regenerated. The -2214-line net delta is consolidation of pre-existing duplicate nested deps (npm normalises during clean regen), not new dep churn from this release. Spot-check confirmed all 12 workspace packages remain as workspace symlinks ("link": true) and there are zero stale 0.2.0 lockstep entries.

Test plan

  • npm run build:deps — clean
  • All 7 affected packages: 234/234 tests pass (42 grounding-wrapper, 57 evidence-ledger, 22 claim-gate, 26 hypothesis-tracker, 29 grounding-mcp, 12 grounding-sdk, 46 review-claim-gate)
  • Dogfood smoke via node REPL: happy path + 4 sad paths + Mixed-Unicode acceptance + grounding-mcp --version returns 0.3.1
  • Review subagent: APPROVE, full scope-discipline + cross-repo backward-compat check
  • No other repo under /home/lan/git/pandora/ pins 0.2.0 on these packages
  • CI green
  • Merge-approval gate (ledger fact + labels)

Post-merge tag sequence

Push tags one at a time (per memory feedback_bulk_tag_push_workflow):

git tag v0.3.0 && git push origin v0.3.0
# wait for publish-npm.yml + verify on npm
git tag grounding-mcp-v0.3.1 && git push origin grounding-mcp-v0.3.1
git tag grounding-sdk-v0.1.1 && git push origin grounding-sdk-v0.1.1
git tag review-claim-gate-v0.1.1 && git push origin review-claim-gate-v0.1.1

The three sibling tags must wait for the lockstep set to appear on npm, because their own publish workflow runs npm install and would otherwise fetch stale 0.2.0 deps.

Lockstep packages → 0.3.0:
- @lannguyensi/grounding-wrapper (new behavior, see CHANGELOG)
- @lannguyensi/evidence-ledger    (no code change)
- @lannguyensi/claim-gate         (no code change)
- @lannguyensi/hypothesis-tracker (no code change)

Sibling packages with pinned-exact deps on the lockstep set, bumped in
the same commit to keep the workspace drift-free (per memory
`feedback_workspace_release_mechanics`):
- @lannguyensi/grounding-mcp     0.3.0 → 0.3.1 (deps refresh + handshake constant)
- @lannguyensi/grounding-sdk     0.1.0 → 0.1.1 (deps refresh)
- @lannguyensi/review-claim-gate 0.1.0 → 0.1.1 (deps refresh)

grounding-mcp also updates its in-source `PACKAGE_VERSION` constant
(handshake + --version short-circuit), as the cli-version test pins it
to package.json.

CHANGELOG: [Unreleased] → [0.3.0] - 2026-05-27, expanded with the two
new grounding-wrapper entries (phase_status.complete fix from #97,
validateKeyword from #98) plus the existing idempotent-advance note.

Lockfile regen consolidates pre-existing duplicate nested deps (net
-2214 lines is cleanup, not version churn from this release).

Tag-push sequence after merge:
  1. v0.3.0                       → triggers publish-npm.yml
  2. wait for npm to show 0.3.0
  3. grounding-mcp-v0.3.1         → publish-libs.yml
  4. grounding-sdk-v0.1.1         → publish-libs.yml
  5. review-claim-gate-v0.1.1     → publish-libs.yml

Per memory `feedback_bulk_tag_push_workflow`: push tags one at a time
since bulk push silently skips trigger events.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
@LanNguyenSi LanNguyenSi added review:tests-pass merge-approval prereq review:checklist-complete merge-approval prereq review:comments-resolved merge-approval prereq review:scope-matches-task merge-approval prereq review:evidence-logged merge-approval prereq labels May 27, 2026
@LanNguyenSi LanNguyenSi merged commit 99b102d into master May 27, 2026
3 of 4 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

review:checklist-complete merge-approval prereq review:comments-resolved merge-approval prereq review:evidence-logged merge-approval prereq review:scope-matches-task merge-approval prereq review:tests-pass merge-approval prereq

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants