From 06ffdb97a5dfdaf0a74054409d0ef96f12b2d750 Mon Sep 17 00:00:00 2001 From: Yam C Borodetsky Date: Wed, 2 Sep 2026 20:23:10 +0500 Subject: [PATCH 1/3] docs(roadmap): mark v0 alpha banner and CLI postinstall guard as done - Marks 'v0-alpha-banner' and 'cli-postinstall-guard' as done in ROADMAP_EXTRAS. - Updates LAUNCH_RUNBOOK.md checking off the v0 alpha banner. --- apps/www/lib/roadmap/config.ts | 4 ++-- docs/LAUNCH_RUNBOOK.md | 2 +- 2 files changed, 3 insertions(+), 3 deletions(-) diff --git a/apps/www/lib/roadmap/config.ts b/apps/www/lib/roadmap/config.ts index 65cfe42da..a334522f4 100644 --- a/apps/www/lib/roadmap/config.ts +++ b/apps/www/lib/roadmap/config.ts @@ -44,7 +44,7 @@ export const ROADMAP_EXTRAS: readonly RoadmapExtra[] = [ { id: "v0-alpha-banner", title: "v0 site Alpha banner", - done: false, + done: true, topic: "Docs", }, { @@ -62,7 +62,7 @@ export const ROADMAP_EXTRAS: readonly RoadmapExtra[] = [ { id: "cli-postinstall-guard", title: "Add CLI postinstall guard for v0 upgrades", - done: false, + done: true, topic: "CLI", }, { diff --git a/docs/LAUNCH_RUNBOOK.md b/docs/LAUNCH_RUNBOOK.md index a990a50e9..d1c3b9ac6 100644 --- a/docs/LAUNCH_RUNBOOK.md +++ b/docs/LAUNCH_RUNBOOK.md @@ -11,7 +11,7 @@ This runbook outlines the operational, DNS, npm registry, and deployment steps r - Deploy a frozen snapshot of the `dev` (v0) documentation branch to Vercel/Cloudflare Pages. - Assign domain: `v0.arkenv.js.org`. - Verify that old links, guides, and v0 API references resolve correctly. -- [ ] **Alpha Banner on Live v0 Site (`dev` branch)**: +- [x] **Alpha Banner on Live v0 Site (`dev` branch)**: - Add announcement banner to `arkenv.js.org` (pointing to `https://arkenv-v1.vercel.app` and migration guide) during the final testing window. - [ ] **README and Production Links**: - Update all alpha links (`arkenv-v1.vercel.app`) in READMEs and docs to `arkenv.js.org`. From 97a576c9dce8dee4310f37b25fc71d627d0e12df Mon Sep 17 00:00:00 2001 From: Yam C Borodetsky Date: Wed, 2 Sep 2026 21:01:02 +0500 Subject: [PATCH 2/3] docs(roadmap): retitle CLI guard item to import guard Renames 'Add CLI postinstall guard for v0 upgrades' to 'Add CLI import guard for v0 upgrades' to match the actual shipped mechanism, and aligns Step 2.4 in LAUNCH_RUNBOOK.md. --- apps/www/lib/roadmap/config.ts | 2 +- docs/LAUNCH_RUNBOOK.md | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/apps/www/lib/roadmap/config.ts b/apps/www/lib/roadmap/config.ts index a334522f4..0506225a5 100644 --- a/apps/www/lib/roadmap/config.ts +++ b/apps/www/lib/roadmap/config.ts @@ -61,7 +61,7 @@ export const ROADMAP_EXTRAS: readonly RoadmapExtra[] = [ }, { id: "cli-postinstall-guard", - title: "Add CLI postinstall guard for v0 upgrades", + title: "Add CLI import guard for v0 upgrades", done: true, topic: "CLI", }, diff --git a/docs/LAUNCH_RUNBOOK.md b/docs/LAUNCH_RUNBOOK.md index d1c3b9ac6..16ce72235 100644 --- a/docs/LAUNCH_RUNBOOK.md +++ b/docs/LAUNCH_RUNBOOK.md @@ -56,7 +56,7 @@ Execute npm deprecation for the old v0 CLI package name: npm deprecate @arkenv/cli "This package was renamed to 'arkenv' in v1. Please update your dependencies: 'npm i -D arkenv' and use '@arkenv/core' for runtime validation." ``` -### Step 2.4: Validate CLI Postinstall & Import Guards +### Step 2.4: Validate CLI Import Guard - Verify that `npm install arkenv` / `import arkenv from "arkenv"` throws the clear runtime error guiding users to `@arkenv/core`. - Test running `npx arkenv init` in a fresh project to ensure it executes without errors. From c70fc40463f867a2828766e78970fbc2322c13c6 Mon Sep 17 00:00:00 2001 From: Yam C Borodetsky Date: Wed, 2 Sep 2026 22:18:42 +0500 Subject: [PATCH 3/3] docs(runbook): clarify import guard error phrasing in step 2.4 Aligns verification bullet to clarify that importing or requiring arkenv throws the runtime error, rather than npm install. --- docs/LAUNCH_RUNBOOK.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/LAUNCH_RUNBOOK.md b/docs/LAUNCH_RUNBOOK.md index 16ce72235..5feb70f89 100644 --- a/docs/LAUNCH_RUNBOOK.md +++ b/docs/LAUNCH_RUNBOOK.md @@ -58,7 +58,7 @@ npm deprecate @arkenv/cli "This package was renamed to 'arkenv' in v1. Please up ### Step 2.4: Validate CLI Import Guard -- Verify that `npm install arkenv` / `import arkenv from "arkenv"` throws the clear runtime error guiding users to `@arkenv/core`. +- Verify that importing or requiring `arkenv` as a library (`import arkenv from "arkenv"` / `require("arkenv")`) throws the clear runtime error guiding users to `@arkenv/core`. - Test running `npx arkenv init` in a fresh project to ensure it executes without errors. ---