Skip to content

chore: declare the Node floor we actually test + clarify upgrade docs - #39

Merged
DanMat merged 1 commit into
mainfrom
chore/honest-node-floor-and-readme
Aug 2, 2026
Merged

chore: declare the Node floor we actually test + clarify upgrade docs#39
DanMat merged 1 commit into
mainfrom
chore/honest-node-floor-and-readme

Conversation

@DanMat

@DanMat DanMat commented Aug 2, 2026

Copy link
Copy Markdown
Owner

Prep for provider work — two honesty fixes flagged in the 3.3 architecture review.

Node floor

Root and mcp/ package.json declared engines.node: ">=18", but CI only runs Node 20, 22, 24. That's an untested (and now EOL) floor — and a future @packkit/provider-* package would inherit it verbatim through a peerDependencies: { "create-packkit": "^3.x" } range. Raised both to >=20 to match reality.

Left alone deliberately:

  • generated projects keep their Node 24 floor (DEFAULT_NODE);
  • react / react-dom >=18 peer ranges — that's React 18+, unrelated to Node.

README

Reordered the upgrade section to read new-projects-first: baseline-aware for 3.3+ projects, conservative fallback for older ones, plus an explicit line that --apply never overwrites your edits or resolves conflicts for you.

No code changes; 112 tests pass, lint clean.

🤖 Generated with Claude Code

Packkit's own package.json (root and mcp) declared engines node >=18, but CI
only exercises Node 20, 22, and 24 — an untested, EOL floor that any provider
package would inherit through a peerDependency range. Raise both to >=20 so the
declared floor matches what we test. (Generated projects keep their deliberate
Node 24 floor; the react/react-dom >=18 peer ranges are unrelated.)

Also reorder the README upgrade section so the flow reads new-projects-first:
baseline-aware for 3.3+ projects, conservative fallback for older ones, and an
explicit note that --apply never overwrites your edits or resolves conflicts.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
@DanMat
DanMat merged commit 3819508 into main Aug 2, 2026
5 checks passed
@DanMat
DanMat deleted the chore/honest-node-floor-and-readme branch August 2, 2026 17:37
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