ag-cortex 0.1.0 → 0.1.2

package/.agent/rules/00-constitution.md

@@ -1,3 +1,7 @@
+---
+trigger: always_on
+---
+
 # Antigravity Codex
 
 This is the central "brain" for Antigravity-powered agents. It defines the core primitives—Skills, Workflows, and Rules—and how they should be used to maintain a high standard of engineering.
@@ -13,13 +17,12 @@ This is the central "brain" for Antigravity-powered agents. It defines the core
 ## Repository Structure
 
 ```
-antigravity-cortex/
+[Project Root]/
 ├── .agent/
 │   ├── rules/          # Context & Identity (e.g., specific engineering personas)
 │   ├── skills/         # Capabilities (formerly plugins)
-│   ├── workflows/      # Step-by-step procedures (formerly plans/workflows)
-│   └── templates/      # Templates for plans and documents
-└── README.md
+│   └── workflows/      # Step-by-step procedures (formerly plans/workflows)
+└── ...
 ```
 
 ## Philosophy: Compounding Engineering

package/.agent/rules/90-general-best-practices.md

@@ -0,0 +1,27 @@
+# General Engineering Standards
+
+These are the baseline operating procedures for this project. They are designed to keep velocity high and technical debt low.
+
+## 1. Documentation
+Code is read more often than it is written.
+- **Update Docs with Code**: Never ship a feature without updating the relevant documentation (README, API docs, or inline comments).
+- **Why > What**: Comments should explain *why* a complex decision was made, not just *what* the code does.
+
+## 2. Testing
+Unverified code is broken code.
+- **Verification First**: Before marking a task as "Done", verify it.
+- **Reproducible**: If you fix a bug, try to add a test case or a reproduction script to prevent regression.
+
+## 3. Commit Conventions
+Keep history clean and searchable.
+- `feat: ...` for new features
+- `fix: ...` for bug fixes
+- `refactor: ...` for code structure changes
+- `docs: ...` for documentation updates
+- `chore: ...` for maintenance tasks
+
+## 4. Workflows
+Leverage the agents to scale your output.
+- Use `/plan` before starting complex features.
+- Use `/review` to catch issues early.
+- Use `/compound` to save knowledge for the next developer.

package/.agent/workflows/work.md

@@ -82,7 +82,7 @@ This command takes a work document (plan, specification, or todo file) and execu
    - The plan should reference similar code - read those files first
    - Match naming conventions exactly
    - Reuse existing components where possible
-   - Follow project coding standards (see CLAUDE.md)
+   - Follow project coding standards (see .agent/rules/)
    - When in doubt, grep for similar implementations
 
 3. **Test Continuously**
@@ -117,7 +117,7 @@ This command takes a work document (plan, specification, or todo file) and execu
    # Run full test suite
    bin/rails test
 
-   # Run linting (per CLAUDE.md)
+   # Run linting (per .agent/rules/)
    # Use linting-agent before pushing to origin
    ```
 

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}...`));
@@ -62,7 +77,18 @@ async function install() {
         const destPath = path.join(TARGET_AGENT_DIR, file);
 
         await fs.ensureDir(path.dirname(destPath));
-        await fs.copy(srcPath, destPath, { overwrite: true });
+
+        // Force removal of existing symlinks to replace with real files
+        try {
+            const destStat = await fs.lstat(destPath);
+            if (destStat.isSymbolicLink()) {
+                await fs.remove(destPath);
+            }
+        } catch (e) {
+            // Ignore ENOENT
+        }
+
+        await fs.copy(srcPath, destPath, { overwrite: true, dereference: true });
     }
     console.log(chalk.green(`   ✅ Installed ${sourceFiles.length} files.`));
 
@@ -80,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.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'.`));
         }
-        console.log(chalk.green(`   ✅ Agent Browser installed.`));
+
+        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.0",
+  "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": {
@@ -28,4 +36,4 @@
     "commander": "^11.0.0",
     "fs-extra": "^11.0.0"
   }
-}
+}

package/.agent/rules/project-rules.md

@@ -1,49 +0,0 @@
-# Cortex Lab Project Rules
-
-This file documents the project's rules, conventions, and workflows. It was migrated from `CLAUDE.md`.
-
-## Commands
-
-- **`/release-docs`**: Run the release-docs command to update all documentation pages.
-- **`/review`**: Run the review command to perform exhaustive code reviews.
-- **`/test-browser`**: Run browser tests using Playwright.
-- **`/xcode-test`**: Run iOS tests using Xcode simulator.
-
-## Project Structure
-
-```
-cortex/
-├── .agent/
-│   ├── rules/          # Project rules and conventions
-│   ├── skills/         # Specialized agent skills
-│   └── workflows/      # Automated workflows
-├── docs/               # Documentation site (HTML/CSS)
-├── plugins/            # Plugin source code
-└── ...
-```
-
-## Documentation
-
-The documentation site is at `/docs` in the repository root.
-
-### Keeping Docs Up-to-Date
-
-After ANY change to agents, commands, skills, or MCP servers, update documentation.
-
-## Commit Conventions
-
-Follow these patterns for commit messages:
-
-- `Add [agent/command name]` - Adding new functionality
-- `Remove [agent/command name]` - Removing functionality
-- `Update [file] to [what changed]` - Updating existing files
-- `Fix [issue]` - Bug fixes
-- `Simplify [component] to [improvement]` - Refactoring
-
-## Key Learnings
-
-### 2024-11-22: Added gemini-imagegen skill and fixed component counts
-Always count actual files before updating descriptions.
-
-### 2024-10-09: Simplified marketplace.json to match official spec
-Stick to the official spec. Custom fields may confuse users.