From 4e2102fcf4fa365e8a07ffbfd9847e6382ea9708 Mon Sep 17 00:00:00 2001 From: haelyra <49814733+haelyra@users.noreply.github.com> Date: Sat, 15 Aug 2026 15:07:31 -0400 Subject: [PATCH] docs(antigravity): clarify npm 2.2 release boundary --- docs/ANTIGRAVITY-GUIDE.md | 8 ++++++++ tests/docs/antigravity-guide.test.js | 15 +++++++++++++++ 2 files changed, 23 insertions(+) diff --git a/docs/ANTIGRAVITY-GUIDE.md b/docs/ANTIGRAVITY-GUIDE.md index 1ac612634..b2ca2e874 100644 --- a/docs/ANTIGRAVITY-GUIDE.md +++ b/docs/ANTIGRAVITY-GUIDE.md @@ -8,6 +8,14 @@ Native Antigravity 2.0 installation requires ECC 2.2.0 or newer. ECC 2.1.0 uses the legacy `.agent/` adapter and does not provide the native layout described below. +> [!IMPORTANT] +> **Temporary release status:** npm latest is currently `ecc-universal@2.1.0`. +> ECC 2.2.0 has not been published to npm yet. Until it is published, use a +> current source checkout of `main` for native `.agents` support or wait for the +> release. + + + ## Quick start ```bash diff --git a/tests/docs/antigravity-guide.test.js b/tests/docs/antigravity-guide.test.js index ce96e64b1..e9cc413fe 100644 --- a/tests/docs/antigravity-guide.test.js +++ b/tests/docs/antigravity-guide.test.js @@ -33,6 +33,21 @@ test('guide requires an installer with native Antigravity 2.0 support', () => { ); }); +test('guide states the temporary npm release boundary', () => { + assert.ok( + guide.includes('npm latest is currently `ecc-universal@2.1.0`'), + 'Guide should identify the package version users receive from npm today' + ); + assert.ok( + guide.includes('ECC 2.2.0 has not been published to npm yet'), + 'Guide should not imply that native Antigravity support is already published' + ); + assert.ok( + guide.includes('remove this release-status paragraph only after `ecc-universal@2.2.0` is published and registry readback succeeds'), + 'Guide should retain a removal condition for the temporary release warning' + ); +}); + test('guide keeps the target project as the working directory', () => { assert.ok( guide.includes('Run every command below from the project you want to configure'),