Skip to content

docs(sdk): add CHANGELOG migration note for 0.0.14 → 0.0.3x (#587)#629

Open
aggre wants to merge 2 commits into
mainfrom
docs/sdk-changelog-migration-note-587
Open

docs(sdk): add CHANGELOG migration note for 0.0.14 → 0.0.3x (#587)#629
aggre wants to merge 2 commits into
mainfrom
docs/sdk-changelog-migration-note-587

Conversation

@aggre

@aggre aggre commented Jul 6, 2026

Copy link
Copy Markdown
Member

Summary

Adds packages/sdk/CHANGELOG.md — a focused migration note covering the 0.0.14 → 0.0.3x SDK transition. Fulfills promised follow-up #2 from issue #587 ("We'll add a 'what moved' note to the next release covering the 0.0.14 → 0.0.3x transition"), which had been overdue 6+ days.

Changes

  • New file: packages/sdk/CHANGELOG.md (114 lines, docs-only)
  • No code, types, or behavior changes. No other files touched.

Scope

Four real surface changes documented with before/after import snippets:

  1. Breaking — deep ./dist/* imports no longer resolve (0.0.140.0.33) due to package.json#exports encapsulation.
  2. New public surface (0.0.330.0.35) — commit (formerly internal commitNormalized) as a root export, plus the ./disclose subpath.
  3. disclose.createProof added (0.0.350.0.36), with a caveat that the 0.0.35 README advertised it before implementation.
  4. Diagnostics (0.0.36\+) — network rejections now include apiBase + apiKey status (non-breaking, message text only; fix(sdk): enrich fetch network errors with apiBase + apiKey status (#587) #601).

Plus a clearly-labeled "Tracked, not yet done" forward reference to the PrepareOutput cleanup (#587 item #3 — a type change pending a design decision).

Accuracy notes

  • The 0.0.14 baseline is attributed to the reporter's stated pre-upgrade version (issue Upgrade friction 0.0.14 → 0.0.33: deep-import removal + no offline commitment path #587), since it is not present in this repo's git history (earliest packages/sdk/package.json commit is 0.0.23 with the exports map already encapsulated).
  • Version numbers cite published npm versions, not in-repo commit-time package.json strings (which lag — e.g. the commit//disclose publish commit records 0.0.34 in-tree but shipped as 0.0.35 on npm).

Refs #587.

Fulfills promised follow-up #2 from issue #587: a 'what moved' note
covering the 0.0.14 → 0.0.3x transition. Docs-only, single new file.

Covers four real surface changes:
- Breaking: deep ./dist/* imports removed (0.0.14 → 0.0.33)
- commit + /disclose published (0.0.33 → 0.0.35)
- disclose.createProof added (0.0.35 → 0.0.36)
- Network-error diagnostics enriched (#601, 0.0.36+)

0.0.14 baseline attributed to the reporter (not in repo git history;
earliest commit is 0.0.23 with exports already encapsulated). Cites
published npm versions, not in-repo commit-time version strings.

PrepareOutput cleanup listed as 'tracked, not yet done' (design decision,
out of scope for this change).
@cursor

cursor Bot commented Jul 6, 2026

Copy link
Copy Markdown

Bugbot is not enabled for your account, so this pull request was not reviewed.

Enable Bugbot in the Cursor dashboard to get automatic reviews on future PRs.

Adds BundleAnchor struct (packed uint64+uint32), registerDocumentRoot()
function, and isRootRegistered() view to LemmaRegistry. Deployed as a
new contract address — existing registerDocument() path is untouched.

Part of the Merkle bundle anchor feature: batch N documents into one
Merkle root on-chain, reducing gas cost ~90%.

Foundry tests: 12/12 pass (8 existing + 4 new bundle tests).
@cursor

cursor Bot commented Jul 7, 2026

Copy link
Copy Markdown

Bugbot is not enabled for your account, so this pull request was not reviewed.

Enable Bugbot in the Cursor dashboard to get automatic reviews on future PRs.

@cloudflare-workers-and-pages

cloudflare-workers-and-pages Bot commented Jul 7, 2026

Copy link
Copy Markdown

Deploying web with  Cloudflare Pages  Cloudflare Pages

Latest commit: b63aa69
Status: ✅  Deploy successful!
Preview URL: https://8814dce6.web-zgj.pages.dev
Branch Preview URL: https://feature-merkle-bundle-anchor.web-zgj.pages.dev

View logs

@cloudflare-workers-and-pages

cloudflare-workers-and-pages Bot commented Jul 7, 2026

Copy link
Copy Markdown

Deploying with  Cloudflare Workers  Cloudflare Workers

The latest updates on your project. Learn more about integrating Git with Workers.

Status Name Latest Commit Updated (UTC)
✅ Deployment successful!
View logs
mcp b63aa69 Jul 07 2026, 03:14 AM

@cloudflare-workers-and-pages

Copy link
Copy Markdown

Deploying schemas with  Cloudflare Pages  Cloudflare Pages

Latest commit: b63aa69
Status: ✅  Deploy successful!
Preview URL: https://a5a94189.schemas-a8x.pages.dev
Branch Preview URL: https://feature-merkle-bundle-anchor.schemas-a8x.pages.dev

View logs

@cloudflare-workers-and-pages

Copy link
Copy Markdown

Deploying demo with  Cloudflare Pages  Cloudflare Pages

Latest commit: b63aa69
Status: ✅  Deploy successful!
Preview URL: https://9638c61b.lemma-1ri.pages.dev
Branch Preview URL: https://feature-merkle-bundle-anchor.lemma-1ri.pages.dev

View logs

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