ag-cortex 0.1.1 → 0.1.2

package/README.md

@@ -1,5 +1,7 @@
 # Antigravity Cortex
 
+[**Documentation**](https://i3ringit.github.io/antigravity-cortex/) | [**Repository**](https://github.com/i3ringit/antigravity-cortex)
+
 The central "brain" and standard library for Antigravity-powered agents. This package distributes shared **Skills**, **Workflows**, and **Rules** that are injected into project workspaces to ensure consistent, high-quality engineering.
 
 ## Architecture
@@ -20,10 +22,16 @@ To add Antigravity Cortex to your project:
 npm install -D ag-cortex
 
 # 2. Initialize the brain
-# This copies the assets to your .agent/ directory and creates a tracking manifest.
+# This copies assets to .agent/, creates a manifest, and automatically installs required browser binaries.
 npx ag-cortex install
 ```
 
+> [!NOTE]
+> **Linux Users**: If you encounter errors about missing shared libraries, you likely need to install system dependencies. Run:
+> ```bash
+> sudo npx agent-browser install --with-deps
+> ```
+
 ## Usage
 
 ### Updating Assets

package/lib/core.js

@@ -1,6 +1,6 @@
 const fs = require('fs-extra');
 const path = require('path');
-const { execSync } = require('child_process');
+const { spawn } = require('child_process');
 
 // Paths
 const PKG_ROOT = path.resolve(__dirname, '..');
@@ -37,6 +37,21 @@ async function walk(dir, baseDir = dir) {
     return results;
 }
 
+
+/**
+ * Helper to run commands asynchronously using spawn, avoiding event loop blocking.
+ */
+async function spawnCommand(command, args, options = {}) {
+    return new Promise((resolve, reject) => {
+        const proc = spawn(command, args, { stdio: 'inherit', ...options });
+        proc.on('close', code => {
+            if (code === 0) resolve();
+            else reject(new Error(`Command '${command} ${args.join(' ')}' failed with code ${code}`));
+        });
+        proc.on('error', reject);
+    });
+}
+
 async function install() {
     const chalk = (await import('chalk')).default;
     console.log(chalk.blue(`📦 Installing Cortex assets to ${TARGET_AGENT_DIR}...`));
@@ -91,20 +106,39 @@ async function install() {
 
     try {
         if (isLinux) {
-            console.log(chalk.yellow(`   🐧 Linux detected: Attempting to install system dependencies...`));
-            console.log(chalk.gray(`      (If this fails, you may need to run with sudo)`));
-            execSync('npx agent-browser install --with-deps', { stdio: 'inherit', cwd: TARGET_ROOT });
+            console.log(chalk.yellow(`   🐧 Linux detected.`));
+            console.log(chalk.yellow(`   ⚠️  To ensure all system dependencies are met for headless browsing, you should run:`));
+            console.log(chalk.bold(`       sudo npx agent-browser install --with-deps`));
+            console.log(chalk.gray(`      (Proceeding with basic installation to avoid sudo prompt...)`));
+            const npx = process.platform === 'win32' ? 'npx.cmd' : 'npx';
+            await spawnCommand(npx, ['agent-browser', 'install'], { cwd: TARGET_ROOT });
         } else {
-            execSync('npx agent-browser install', { stdio: 'inherit', cwd: TARGET_ROOT });
+            const npx = process.platform === 'win32' ? 'npx.cmd' : 'npx';
+            await spawnCommand(npx, ['agent-browser', 'install'], { cwd: TARGET_ROOT });
         }
-        console.log(chalk.green(`   ✅ Agent Browser installed.`));
+
+        console.log(chalk.blue(`   🌐 Ensuring correct Playwright browsers are installed...`));
+        let pwVersion = 'latest';
+        try {
+            const pwCorePkg = require('playwright-core/package.json');
+            pwVersion = pwCorePkg.version;
+            console.log(chalk.gray(`      Detected runtime: playwright-core v${pwVersion}`));
+        } catch (e) {
+            console.warn(chalk.yellow(`      Could not resolve playwright-core version, defaulting to 'latest'.`));
+        }
+
+        const npx = process.platform === 'win32' ? 'npx.cmd' : 'npx';
+        await spawnCommand(npx, ['--yes', `playwright@${pwVersion}`, 'install', 'chromium', 'chromium-headless-shell'], { cwd: TARGET_ROOT });
+
+        console.log(chalk.green(`   ✅ Agent Browser setup complete.`));
     } catch (e) {
         if (isLinux) {
             console.warn(chalk.yellow(`   ⚠️  Automatic setup failed. You likely need sudo for system dependencies.`));
             console.warn(chalk.bold(`       Please run: sudo npx agent-browser install --with-deps`));
         } else {
-            console.warn(chalk.yellow(`   ⚠️  Agent Browser setup had issues. Try running: npx agent-browser install --with-deps`));
+            console.warn(chalk.yellow(`   ⚠️  Agent Browser setup had issues.`));
         }
+        console.warn(chalk.bold(`       Also ensure browsers are installed: npx playwright install chromium`));
     }
 }
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ag-cortex",
-  "version": "0.1.1",
+  "version": "0.1.2",
   "description": "Antigravity Cortex - Agentic Workflow Distribution. The central brain and standard library for Antigravity-powered agents.",
   "bin": {
     "ag-cortex": "./bin/ag-cortex.js"
@@ -20,6 +20,14 @@
     "workflows",
     "skills"
   ],
+  "homepage": "https://i3ringit.github.io/antigravity-cortex/",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/i3ringit/antigravity-cortex.git"
+  },
+  "bugs": {
+    "url": "https://github.com/i3ringit/antigravity-cortex/issues"
+  },
   "author": "Marcos del Cristo",
   "license": "MIT",
   "dependencies": {