docs: add ArkEnv Release Candidate checklist by yamcodes · Pull Request #1848 · yamcodes/arkenv

yamcodes · 2026-09-12T06:47:04Z

Summary

Adds an actionable maintainer Release Candidate checklist on v1 so Yam can check boxes against real files, open PRs, and Discussions before cutting 1.0.0-rc.n.

Documentation only - no channel flip, publish, or RELEASE_TAG change.

What changed

New docs/RC_CHECKLIST.md with verified “already done” items (milestone clear, no Typia in works-with, migration guide, CLI import guard, ROADMAP_EXTRAS done flags, alpha still active) plus sections A–F matching the RC plan
Cross-links from docs/LAUNCH_RUNBOOK.md (GA stays GA), docs/CONTRIBUTING.md, docs/README.md, and a pointer on ROADMAP_EXTRAS in apps/www/lib/roadmap/config.ts
Follow-up: docs AI-slop / voice pass tracked as Not-GA known gap (not an RC gate); ArkType ecosystem snippet called out as soft blocker for announce / day-of latest → rc only

Tip corrections baked in

Milestone v1: 0 open / 98 closed
Open PRs into v1: docs: overhaul TanStack Start guide #1819, docs(blog): add TanStack Start post, author GitHub avatars, and twoslash popover fixes #1807 (draft); fix: Formalize Vite startup validation guarantee and document the plugin contract #1840 already merged
Product dist-tag path documented: keep @rc and also point latest at 1.0.0-rc.n for bare npx arkenv init

Test plan

Relative paths in the checklist resolve to existing files (including URL-encoded (home) path)
Bidirectional LAUNCH_RUNBOOK ↔ RC_CHECKLIST links present
No em/en dashes in docs/RC_CHECKLIST.md
Maintainer review of Not-GA gaps / Discussions park decisions (execute at cut time)

Document an actionable RC maintainer checklist next to the GA launch runbook, with cross-links from LAUNCH_RUNBOOK, CONTRIBUTING, docs index, and ROADMAP_EXTRAS so alpha → rc work stays file-specific and does not replace GA 1.0.0 steps. Co-authored-by: Yam Borodetsky <hi@yam.codes>

changeset-bot · 2026-09-12T06:47:07Z

⚠️ No Changeset found

Latest commit: 267e5bc

Merging this PR will not cause a version bump for any packages. If these changes should not result in a new version, you're good to go. If these changes should result in a version bump, you need to add a changeset.

This PR includes no changesets

When changesets are added to this PR, you'll see the packages that this PR includes changesets for and the associated semver types

Click here to learn what changesets are, and how to add one.

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

URL-encode parentheses in the homepage path link so markdown resolves, and replace the Discussions number-range en dash with plain "through". Co-authored-by: Yam Borodetsky <hi@yam.codes>

Track the docs AI-slop / voice rewrite as a Not-GA known gap (not an RC gate), and call out the ArkType ecosystem import snippet as a soft blocker only for announce / day-of latest → rc. Co-authored-by: Yam Borodetsky <hi@yam.codes>

Replace the GFM \`> [!NOTE]\` alert with a plain blockquote so \`pnpm run fix:mdx\` can parse the file, and accept mdxlint formatting for the checklist. Co-authored-by: Yam Borodetsky <hi@yam.codes>

pullfrog

ℹ️ No critical issues — the checklist matches the current tip, but the hardcoded-alpha sweep misses two files.

Reviewed changes

Added docs/RC_CHECKLIST.md — maintainer checklist for the first 1.0.0-rc.n cut: an "already done" snapshot plus sections A–F (freeze, channel flip, publish/smoke, import guard, site cutover, Discussions) and an explicit "not RC gates" list.
Cross-linked the checklist from docs/LAUNCH_RUNBOOK.md (RC RELEASE_TAG line now defers to §B), docs/CONTRIBUTING.md, and docs/README.md.
Roadmap config note — apps/www/lib/roadmap/config.ts JSDoc now distinguishes RC sequencing from GA launch-day ops.

I verified the in-repo claims against the tip: ROADMAP_EXTRAS done flags, .changeset/pre.json (alpha), release.ts fallback, the package table names/versions, the referenced files, the runbook section numbers, and the current open PRs into v1. All hold. The cited milestone closed count has drifted (98 → 110) but is explicitly a dated snapshot with a re-verify instruction, so no action needed.

ℹ️ Nitpicks

docs/RC_CHECKLIST.md:318 — ROADMAP_EXTRA should be ROADMAP_EXTRAS, matching the exported constant referenced everywhere else in the file.

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

pullfrog · 2026-09-13T06:57:22Z

+  - lead still says packages ship as `1.0.0-alpha.x` under the
+    `alpha` npm tag; update for RC
+- [ ] [`apps/www/content/docs/reference/agent-plugin.mdx`](../apps/www/content/docs/reference/agent-plugin.mdx)
+  - `@arkenv/agent-plugin@alpha` in MCP-only host copy / JSON


The hardcoded-alpha sweep is missing two files that will still advertise the alpha tag after the RC flip. packages/agent-plugin/README.md is published on npm, so its MCP section is the most visible of the two.

Suggested change

- `@arkenv/agent-plugin@alpha` in MCP-only host copy / JSON

- `@arkenv/agent-plugin@alpha` in MCP-only host copy / JSON

- [ ] [`packages/agent-plugin/README.md`](../packages/agent-plugin/README.md)

- MCP server section still shows `npx -y @arkenv/agent-plugin@alpha`

- [ ] [`apps/www/content/docs/frameworks/tanstack-start.mdx`](../apps/www/content/docs/frameworks/tanstack-start.mdx)

- `:::info[Pinning alphas]` callout still says "pin exact `@arkenv/*` alpha versions"

Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>

yamcodes · 2026-09-13T09:06:26Z

@pullfrog fixed, review

pullfrog · 2026-09-13T09:06:31Z

No new review warranted: the only change since the prior review is the one-word typo fix ROADMAP_EXTRA → ROADMAP_EXTRAS in docs/RC_CHECKLIST.md:318, which is correct and complete. Note the earlier inline thread is still open — the hardcoded-alpha sweep does not list packages/agent-plugin/README.md (npx -y @arkenv/agent-plugin@alpha) or the :::info[Pinning alphas] callout in apps/www/content/docs/frameworks/tanstack-start.mdx; both still advertise alpha.

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

Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>

github-actions Bot added docs Adds or changes documentation, or acts as documentation in and of itself www Improvements or additions to arkenv.js.org labels Sep 12, 2026

cursoragent and others added 4 commits September 12, 2026 06:47

docs: fix RC checklist path link and en dash

64941da

URL-encode parentheses in the homepage path link so markdown resolves, and replace the Discussions number-range en dash with plain "through". Co-authored-by: Yam Borodetsky <hi@yam.codes>

docs: make RC checklist MDX-lint safe

39da7fa

Replace the GFM \`> [!NOTE]\` alert with a plain blockquote so \`pnpm run fix:mdx\` can parse the file, and accept mdxlint formatting for the checklist. Co-authored-by: Yam Borodetsky <hi@yam.codes>

[autofix.ci] apply automated fixes

b4cd5ef

yamcodes marked this pull request as ready for review September 13, 2026 06:35

pullfrog Bot reviewed Sep 13, 2026

View reviewed changes

docs: fix roadmap extras reference

0ae8140

Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>

docs: include remaining alpha references

267e5bc

Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>

yamcodes merged commit 8e970d9 into v1 Sep 13, 2026
16 of 18 checks passed

yamcodes deleted the cursor/rc-checklist-c312 branch September 13, 2026 13:23

Navigation Menu

docs: add ArkEnv Release Candidate checklist - #1848

docs: add ArkEnv Release Candidate checklist#1848
yamcodes merged 7 commits into
v1from
cursor/rc-checklist-c312

yamcodes commented Sep 12, 2026 •

edited by cursor Bot

Loading

Uh oh!

changeset-bot Bot commented Sep 12, 2026 •

edited

Loading

Uh oh!

pullfrog Bot left a comment

Uh oh!

pullfrog Bot Sep 13, 2026

Uh oh!

yamcodes commented Sep 13, 2026

Uh oh!

pullfrog Bot commented Sep 13, 2026 •

edited

Loading

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

-  - `@arkenv/agent-plugin@alpha` in MCP-only host copy / JSON
+  - `@arkenv/agent-plugin@alpha` in MCP-only host copy / JSON
+- [ ] [`packages/agent-plugin/README.md`](../packages/agent-plugin/README.md)
+  - MCP server section still shows `npx -y @arkenv/agent-plugin@alpha`
+- [ ] [`apps/www/content/docs/frameworks/tanstack-start.mdx`](../apps/www/content/docs/frameworks/tanstack-start.mdx)
+  - `:::info[Pinning alphas]` callout still says "pin exact `@arkenv/*` alpha versions"

Conversation

yamcodes commented Sep 12, 2026 • edited by cursor Bot Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Summary

What changed

Tip corrections baked in

Test plan

Uh oh!

changeset-bot Bot commented Sep 12, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

⚠️ No Changeset found

Uh oh!

pullfrog Bot left a comment

Choose a reason for hiding this comment

ℹ️ Nitpicks

Uh oh!

pullfrog Bot Sep 13, 2026

Choose a reason for hiding this comment

Uh oh!

yamcodes commented Sep 13, 2026

Uh oh!

pullfrog Bot commented Sep 13, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

yamcodes commented Sep 12, 2026 •

edited by cursor Bot

Loading

changeset-bot Bot commented Sep 12, 2026 •

edited

Loading

pullfrog Bot commented Sep 13, 2026 •

edited

Loading