(v1) Internal vs. Published Packages Strategy for Build-time and Runtime Code

[yamcodes]

Closes #1197

[changeset-bot]

🦋 Changeset detected

Latest commit: 57b30a5

The changes in this PR will be included in the next version bump.

This PR includes changesets to release 4 packages

Name	Type
@arkenv/nextjs	Major
@arkenv/nuxt	Major
@arkenv/vite-plugin	Major
@arkenv/bun-plugin	Major

Not sure what this means? Click here to learn what changesets are.

Click here if you're a maintainer who wants to add another changeset to this PR

[pkg-pr-new]

Open in StackBlitz

arkenv

npm i https://pkg.pr.new/arkenv@1202

@arkenv/build

npm i https://pkg.pr.new/@arkenv/build@1202

@arkenv/bun-plugin

npm i https://pkg.pr.new/@arkenv/bun-plugin@1202

@arkenv/cli

npm i https://pkg.pr.new/@arkenv/cli@1202

@arkenv/fumadocs-ui

npm i https://pkg.pr.new/@arkenv/fumadocs-ui@1202

@arkenv/nextjs

npm i https://pkg.pr.new/@arkenv/nextjs@1202

@arkenv/nuxt

npm i https://pkg.pr.new/@arkenv/nuxt@1202

@arkenv/vite-plugin

npm i https://pkg.pr.new/@arkenv/vite-plugin@1202

commit: 57b30a5

[pullfrog]

✅ No new issues found.

Reviewed changes — establishes the distribution and versioning strategy for ArkEnv v1 by moving arkenv to peer dependencies in all framework plugins, documenting 3 architecture decisions, and updating the changeset skill for standard SemVer.

• Lock arkenv and @arkenv/cli in version lockstep via changeset fixed config per ADR 0011 — ensures CLI codegen output stays compatible with core engine internals.
• Move arkenv to peerDependencies in all 4 framework plugins (@arkenv/nextjs, @arkenv/nuxt, @arkenv/vite-plugin, @arkenv/bun-plugin) — uses workspace:^ for published caret range, preventing duplicate engine instances that break ArkType structural typing.
• Add arkenv to devDependencies with workspace:* in all plugins — maintains local monorepo development while keeping consumers lean.
• Add ADR 0007 documenting the asymmetric packaging strategy — split engines into separate packages (@arkenv/core / @arkenv/standard) but keep plugins as single packages with subpath exports.
• Add ADR 0010 documenting the inlined internal packages strategy — @repo/* packages bundled at publish time via tsdown to avoid public utility packages and cascading version bumps.
• Add ADR 0011 documenting the hybrid versioning model — fixed inner circle (arkenv + @arkenv/cli), independent outer ring (framework plugins + build utilities), with workspace:* / workspace:^ / workspace:~ protocol guidance.
• Update changeset skill for v1+ standard SemVer — major for breaking changes, minor for new features, patch for fixes.
• Fix "Arkenv" → "ArkEnv" typo in historic CLI changelog entries.

  ^{｜ View workflow run ｜ Using DeepSeek Pro (free via Pullfrog for OSS) ｜ 𝕏}

[arkenv-bot]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Review	Updated (Asia/Almaty)
arkenv	Ready	Preview, Comment	Jun 23 2026, 11:32 PM (Asia/Almaty)

[pullfrog]

ℹ️ The ADR rewrite is clean but left a few stale references to the old hybrid model in the Context and Consequences sections — see inline comments.

Reviewed changes — renames ADR 0011 from "Hybrid Versioning Strategy" to "Independent Versioning Strategy" and removes the fixed lockstep between arkenv and @arkenv/cli from the changeset config.

• Drop fixed version lockstep between arkenv and @arkenv/cli in .changeset/config.json — the CLI is now treated as an independent package that versions on its own schedule.
• Rewrite ADR 0011 Decision section to fully independent versioning — removes the "Inner Circle (Fixed / Locked)" section, adds @arkenv/cli to the independent outer ring, and explains the CLI doesn't depend on deep arkenv internals.

  ^{｜ Fix all ➔ ｜ Fix 👍s ➔ ｜ View workflow run ｜ Using DeepSeek Pro (free via Pullfrog for OSS) ｜ 𝕏}

[yamcodes]

Addressed all review comments:

• Clarified that arkenv and @arkenv/cli are already versioned independently.
• Explained that peerDependency for arkenv is strictly required across all framework plugins and integrations to prevent singleton skew.
• Confirmed that the Arkenv casing is already correct.
• Clarified that the ADR does not contradict the existence of @arkenv/build.

[pullfrog]

ℹ️ No critical issues — one minor suggestion inline.

Reviewed changes — switches peer dependencies from workspace:^ to the hardcoded ^1.0.0 range (Wide Peer strategy) across all 4 framework plugins and updates ADR 0007 documentation to match.

• Switch peer deps to hardcoded ^1.0.0 in @arkenv/nextjs, @arkenv/nuxt, @arkenv/vite-plugin, and @arkenv/bun-plugin — solves the Artificial Floor problem where workspace:^ would pin published plugins to the monorepo's current arkenv version.
• Update ADR 0007 table and rationale to document the Wide Peer strategy — explains why hardcoding the minimum version decouples plugin releases from core engine version churn.

  ^{｜ Fix all ➔ ｜ Fix 👍s ➔ ｜ View workflow run ｜ Using DeepSeek Pro (free via Pullfrog for OSS) ｜ 𝕏}

[pullfrog]

✅ No new issues found.

Reviewed changes — merges the v1 base branch into the feature branch, bringing in upstream changes from other PRs that have landed on v1 since the branch was last synced.

• Merged v1 branch — brings in upstream renames (createEnv → arkenv), version bumps to 1.0.0-alpha.1 across packages, changelog entries, coercion model unification, documentation updates, and agent context file updates. All merge cleanly with no conflicts against this PR's changes.
• Removed stale changesets — .changeset/init-v1.md, pre.json, rename-create-env-to-arkenv.md, and unify-coercion.md were cleaned up by the upstream v1 branch.

  ^{｜ View workflow run ｜ Using DeepSeek Pro (free via Pullfrog for OSS) ｜ 𝕏}

[pullfrog]

✅ All prior feedback addressed — no new issues found.

Reviewed changes — one commit addressing the open review thread from the prior Pullfrog review.

• Fixed changeset version range — .changeset/epg3nspi.md updated from ^1.0.0-alpha.1 to ^1.0.0 to match the actual peerDependencies range in all 4 plugin package.json files.
• Fixed AutoTypeTable path — options.mdx updated from create-env.ts to arkenv.ts to match the upstream file rename.

  ^{｜ View workflow run ｜ Using DeepSeek Pro (free via Pullfrog for OSS) ｜ 𝕏}