The agent harness performance optimization system. Skills, instincts, memory, security, and research-first development for Claude Code, Codex, Opencode, Cursor and beyond.
docs(antigravity): clarify project-root installation
haelyra21accf17263a
diff --git a/ECC b/ECCdeleted file mode 160000index c9de8f5b2..000000000--- a/ECC+++ /dev/null@@ -1 +0,0 @@-Subproject commit c9de8f5b2b3a225bca9befa2b7700aa5e3a4d1b8diff --git a/docs/ANTIGRAVITY-GUIDE.md b/docs/ANTIGRAVITY-GUIDE.mdindex 1a8d25dab..1ac612634 100644--- a/docs/ANTIGRAVITY-GUIDE.md+++ b/docs/ANTIGRAVITY-GUIDE.md@@ -4,16 +4,31 @@ Google Antigravity 2.0 discovers workspace customizations from the project-local`.agents/` directory. ECC's Antigravity target installs native rules, workflows,skills, and custom agents into that directory.+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.+## Quick start```bash+# Run every command below from the project you want to configure.+# Keep the ECC source checkout separate and use its absolute path.+ECC_ROOT="/absolute/path/to/ECC"+# Install the minimal profile-# Run this from your project root directory-/path/to/ECC/install.sh --profile minimal --target antigravity+"$ECC_ROOT/install.sh" --profile minimal --target antigravity# Compatibility syntax: common rules plus only these language packs-# Run this from your project root directory-/path/to/ECC/install.sh --target antigravity typescript python go+"$ECC_ROOT/install.sh" --target antigravity typescript python go+```++PowerShell uses the same project-root working-directory contract:++```powershell+$EccRoot = "C:\absolute\path\to\ECC"++& "$EccRoot\install.ps1" --profile minimal --target antigravity+& "$EccRoot\install.ps1" --target antigravity typescript python go```Start a new Antigravity conversation after installing so the agent receives the@@ -57,13 +72,24 @@ your-project/## Verify the installation+macOS and Linux:+```bash-node scripts/list-installed.js --target antigravity-node scripts/doctor.js --target antigravity+node "$ECC_ROOT/scripts/list-installed.js" --target antigravity+node "$ECC_ROOT/scripts/doctor.js" --target antigravityrg --files .agents/skills -g 'SKILL.md'rg --files .agents/agents -g '*.md'```+PowerShell:++```powershell+node "$EccRoot\scripts\list-installed.js" --target antigravity+node "$EccRoot\scripts\doctor.js" --target antigravity+Get-ChildItem .agents\skills -Recurse -Filter SKILL.md+Get-ChildItem .agents\agents -Recurse -Filter *.md+```+In Antigravity, open **Settings > Customizations**, confirm that workspaceskills appear, start a new conversation, and request one by its exact name.@@ -80,10 +106,20 @@ owned by the valid legacy state. Modified and unmanaged files remain inPreview lifecycle operations before applying them when desired:+macOS and Linux:+```bash-node scripts/doctor.js --target antigravity-node scripts/repair.js --target antigravity --dry-run-node scripts/uninstall.js --target antigravity --dry-run+node "$ECC_ROOT/scripts/doctor.js" --target antigravity+node "$ECC_ROOT/scripts/repair.js" --target antigravity --dry-run+node "$ECC_ROOT/scripts/uninstall.js" --target antigravity --dry-run+```++PowerShell:++```powershell+node "$EccRoot\scripts\doctor.js" --target antigravity+node "$EccRoot\scripts\repair.js" --target antigravity --dry-run+node "$EccRoot\scripts\uninstall.js" --target antigravity --dry-run```## Troubleshootingdiff --git a/tests/docs/antigravity-guide.test.js b/tests/docs/antigravity-guide.test.jsnew file mode 100644index 000000000..ce96e64b1--- /dev/null+++ b/tests/docs/antigravity-guide.test.js@@ -0,0 +1,85 @@+'use strict';++const assert = require('assert');+const fs = require('fs');+const path = require('path');++const repoRoot = path.resolve(__dirname, '..', '..');+const guidePath = path.join(repoRoot, 'docs', 'ANTIGRAVITY-GUIDE.md');++let passed = 0;+let failed = 0;++function test(name, fn) {+ try {+ fn();+ console.log(` ✓ ${name}`);+ passed++;+ } catch (error) {+ console.log(` ✗ ${name}`);+ console.log(` Error: ${error.message}`);+ failed++;+ }+}++console.log('\n=== Testing Antigravity guide commands ===\n');++const guide = fs.readFileSync(guidePath, 'utf8');++test('guide requires an installer with native Antigravity 2.0 support', () => {+ assert.ok(+ guide.includes('ECC 2.2.0 or newer'),+ 'Guide should state the minimum ECC version that installs into .agents'+ );+});++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'),+ 'Guide should make the project-root working-directory contract explicit'+ );+ assert.ok(+ guide.includes('ECC_ROOT="/absolute/path/to/ECC"'),+ 'Guide should define an absolute ECC source path separately from the target project'+ );+ assert.ok(+ guide.includes('$EccRoot = "C:\\absolute\\path\\to\\ECC"'),+ 'Guide should define the equivalent absolute source path for PowerShell users'+ );+});++test('guide installs through dependency-bootstrapping wrappers', () => {+ assert.ok(guide.includes('"$ECC_ROOT/install.sh" --profile minimal --target antigravity'));+ assert.ok(guide.includes('& "$EccRoot\\install.ps1" --profile minimal --target antigravity'));+ assert.ok(+ !guide.includes('node "$ECC_ROOT/scripts/install-apply.js"'),+ 'Fresh source installs should not bypass the wrapper dependency bootstrap'+ );+});++test('guide invokes every post-install lifecycle script through the absolute ECC source path', () => {+ for (const script of ['list-installed.js', 'doctor.js', 'repair.js', 'uninstall.js']) {+ assert.ok(+ guide.includes(`node "$ECC_ROOT/scripts/${script}"`),+ `Guide should invoke ${script} through ECC_ROOT`+ );+ assert.ok(+ guide.includes(`node "$EccRoot\\scripts\\${script}"`),+ `Guide should invoke ${script} through EccRoot in PowerShell`+ );+ }++ assert.ok(!guide.includes('./install.sh'), 'Guide should not target the current project through a relative ECC installer path');+ assert.ok(!/node scripts\/(?:list-installed|doctor|repair|uninstall)\.js/.test(guide));+});++test('repository has no accidental nested ECC gitlink', () => {+ assert.ok(+ !fs.existsSync(path.join(repoRoot, 'ECC')),+ 'The documentation PR should not add an ECC gitlink without .gitmodules metadata'+ );+});++console.log(`\nPassed: ${passed}`);+console.log(`Failed: ${failed}`);+process.exit(failed > 0 ? 1 : 0);diff --git a/tests/scripts/install-ps1.test.js b/tests/scripts/install-ps1.test.jsindex 52c8558d6..2dff49a79 100644--- a/tests/scripts/install-ps1.test.js+++ b/tests/scripts/install-ps1.test.js@@ -91,19 +91,20 @@ function runTests() {if (!powerShellCommand) {console.log(' - skipped delegation test; PowerShell is not available in PATH');- } else if (test('delegates to the Node installer and preserves dry-run output', () => {+ } else if (test('delegates to the Antigravity installer while preserving the project cwd', () => {const homeDir = createTempDir('install-ps1-home-');const projectDir = createTempDir('install-ps1-project-');try {- const result = run(powerShellCommand, ['--target', 'cursor', '--dry-run', 'typescript'], {+ const result = run(powerShellCommand, ['--target', 'antigravity', '--dry-run', 'typescript'], {cwd: projectDir,homeDir,});assert.strictEqual(result.code, 0, result.stderr);assert.ok(result.stdout.includes('Dry-run install plan'));- assert.ok(!fs.existsSync(path.join(projectDir, '.cursor', 'hooks.json')));+ assert.ok(result.stdout.includes(path.join(projectDir, '.agents')));+ assert.ok(!fs.existsSync(path.join(projectDir, '.agents')));} finally {cleanup(homeDir);cleanup(projectDir);diff --git a/tests/scripts/install-sh.test.js b/tests/scripts/install-sh.test.jsindex b53f98bb8..d9a4d2d3d 100644--- a/tests/scripts/install-sh.test.js+++ b/tests/scripts/install-sh.test.js@@ -22,10 +22,11 @@ function run(args = [], options = {}) {const env = {...process.env,HOME: options.homeDir || process.env.HOME,+ ...(options.env || {}),};try {- const stdout = execFileSync('bash', [SCRIPT, ...args], {+ const stdout = execFileSync('bash', [options.scriptPath || SCRIPT, ...args], {cwd: options.cwd,env,encoding: 'utf8',@@ -86,6 +87,49 @@ function runTests() {}})) passed++; else failed++;+ if (test('absolute wrapper bootstraps a fresh source while preserving the target project cwd', () => {+ const sourceDir = createTempDir('install-sh-source-');+ const projectDir = createTempDir('install-sh-target-');+ const binDir = path.join(sourceDir, 'test-bin');+ const scriptsDir = path.join(sourceDir, 'scripts');+ const npmCwdPath = path.join(sourceDir, 'npm-cwd.txt');+ const fixtureScript = path.join(sourceDir, 'install.sh');++ try {+ fs.mkdirSync(binDir, { recursive: true });+ fs.mkdirSync(scriptsDir, { recursive: true });+ fs.copyFileSync(SCRIPT, fixtureScript);+ fs.writeFileSync(+ path.join(binDir, 'npm'),+ `#!/usr/bin/env bash\nset -euo pipefail\nmkdir -p "$PWD/node_modules"\nprintf '%s\\n' "$PWD" > "$ECC_TEST_NPM_CWD"\n`,+ { mode: 0o755 }+ );+ fs.writeFileSync(+ path.join(scriptsDir, 'install-apply.js'),+ 'console.log(JSON.stringify({ cwd: process.cwd(), args: process.argv.slice(2) }));\n'+ );++ const result = run(['--target', 'antigravity', '--dry-run', 'typescript'], {+ cwd: projectDir,+ scriptPath: fixtureScript,+ env: {+ ECC_TEST_NPM_CWD: npmCwdPath,+ PATH: `${binDir}${path.delimiter}${process.env.PATH}`,+ },+ });++ assert.strictEqual(result.code, 0, result.stderr);+ const payload = JSON.parse(result.stdout.trim().split('\n').at(-1));+ assert.strictEqual(payload.cwd, fs.realpathSync(projectDir));+ assert.deepStrictEqual(payload.args, ['--target', 'antigravity', '--dry-run', 'typescript']);+ assert.strictEqual(fs.readFileSync(npmCwdPath, 'utf8').trim(), sourceDir);+ assert.ok(fs.existsSync(path.join(sourceDir, 'node_modules')));+ } finally {+ cleanup(sourceDir);+ cleanup(projectDir);+ }+ })) passed++; else failed++;+if (test('exposes the corrected Claude target help text', () => {const result = run(['--help']);assert.strictEqual(result.code, 0, result.stderr);