context-foundry 2.5.4 → 3.0.8

package/README.md

@@ -1,75 +1,46 @@
-# Context Foundry
+# Foundry
 
-AI agent pattern-learning system that helps Claude and other AI agents improve over time.
+Autonomous build loop that plans, builds, reviews, and learns -- forever.
 
-## Installation
+This is the npm installer for Foundry. It downloads the correct pre-built binary for your platform from [GitHub Releases](https://github.com/context-foundry/context-foundry/releases).
+
+## Install
 
 ```bash
 npm install -g context-foundry
 ```
 
-This installs the `cf` command globally. The npm package is a thin wrapper that automatically installs and delegates to the Python engine via pip.
+This installs the `foundry` command globally.
 
 ## Requirements
 
-- **Node.js 16+** (for the npm wrapper)
-- **Python 3.10+** (for the engine)
+- [Claude Code CLI](https://docs.anthropic.com/en/docs/claude-code) must be installed and authenticated
 
-## Quick Start
+## Usage
 
 ```bash
-# Launch the interactive TUI (Mission Control)
-cf
-
-# Or use the daemon for background operations
-cfd start
-cfd status
-```
+# Point at any project with a TASKS.md
+foundry --dir /path/to/project
 
-## Commands
+# Interactive studio mode
+foundry --dir /path/to/project studio
 
-### `cf` - Main CLI
+# Headless mode (CI/logs)
+foundry --dir /path/to/project run --no-tui
 
-```bash
-cf              # Launch Mission Control TUI
-cf --version    # Show version
-cf --help       # Show help
-```
-
-### `cfd` - Daemon CLI
-
-```bash
-cfd start       # Start the daemon
-cfd stop        # Stop the daemon
-cfd status      # Get daemon status
-cfd submit      # Submit a job
-cfd list        # List jobs
-cfd logs <id>   # Show job logs
-```
-
-## How It Works
-
-The npm package is a **distribution shim** that:
-
-1. Checks for Python 3.10+
-2. Installs the Python `context-foundry` package via pip (if needed)
-3. Delegates all commands to the Python CLI
-
-This approach lets JavaScript/TypeScript developers install via their familiar `npm install` workflow while keeping the core logic in Python.
-
-## Alternative Installation
-
-If you prefer, install directly via pip:
-
-```bash
-pip install context-foundry
+# Self-update to latest release
+foundry update
 ```
 
-## Documentation
+## Supported Platforms
 
-- [GitHub Repository](https://github.com/context-foundry/context-foundry)
-- [Documentation](https://context-foundry.github.io)
+| Platform | Architecture |
+|----------|-------------|
+| macOS | Apple Silicon (arm64) |
+| macOS | Intel (x64) |
+| Linux | x64 |
+| Windows | x64 |
 
-## License
+## More Info
 
-MIT
+See the full documentation at [github.com/context-foundry/context-foundry](https://github.com/context-foundry/context-foundry).

package/bin/foundry

@@ -0,0 +1,19 @@
+#!/usr/bin/env node
+
+const path = require("path");
+const { execFileSync } = require("child_process");
+const os = require("os");
+
+const nativeName = os.platform() === "win32" ? "foundry-native.exe" : "foundry-native";
+const binaryPath = path.join(__dirname, nativeName);
+
+try {
+  execFileSync(binaryPath, process.argv.slice(2), { stdio: "inherit" });
+} catch (err) {
+  if (err.status !== undefined) {
+    process.exit(err.status);
+  }
+  console.error(`Failed to run foundry: ${err.message}`);
+  console.error("Try reinstalling: npm install -g context-foundry");
+  process.exit(1);
+}

package/install.js

@@ -0,0 +1,185 @@
+#!/usr/bin/env node
+
+// Downloads the correct Foundry binary from GitHub Releases during npm install.
+
+const https = require("https");
+const fs = require("fs");
+const path = require("path");
+const { execSync } = require("child_process");
+const os = require("os");
+const zlib = require("zlib");
+
+const REPO = "context-foundry/context-foundry";
+
+function getTarget() {
+  const platform = os.platform();
+  const arch = os.arch();
+
+  if (platform === "darwin" && arch === "arm64") return "mac-apple-silicon";
+  if (platform === "darwin" && arch === "x64") return "mac-intel";
+  if (platform === "linux" && arch === "x64") return "linux";
+  if (platform === "win32" && arch === "x64") return "windows";
+
+  throw new Error(`Unsupported platform: ${platform}-${arch}`);
+}
+
+function fetchLatestVersion() {
+  return new Promise((resolve, reject) => {
+    https.get(
+      `https://api.github.com/repos/${REPO}/releases/latest`,
+      { headers: { "User-Agent": "context-foundry-npm" } },
+      (res) => {
+        const chunks = [];
+        res.on("data", (chunk) => chunks.push(chunk));
+        res.on("end", () => {
+          try {
+            const data = JSON.parse(Buffer.concat(chunks).toString());
+            resolve(data.tag_name);
+          } catch (e) {
+            reject(new Error("Failed to parse GitHub API response"));
+          }
+        });
+        res.on("error", reject);
+      }
+    ).on("error", reject);
+  });
+}
+
+function getBinaryName() {
+  return os.platform() === "win32" ? "foundry.exe" : "foundry";
+}
+
+function getArchiveExt() {
+  return os.platform() === "win32" ? "zip" : "tar.gz";
+}
+
+function fetch(url) {
+  return new Promise((resolve, reject) => {
+    https
+      .get(url, { headers: { "User-Agent": "context-foundry-npm" } }, (res) => {
+        if (res.statusCode >= 300 && res.statusCode < 400 && res.headers.location) {
+          return fetch(res.headers.location).then(resolve, reject);
+        }
+        if (res.statusCode !== 200) {
+          return reject(new Error(`HTTP ${res.statusCode} for ${url}`));
+        }
+        const chunks = [];
+        res.on("data", (chunk) => chunks.push(chunk));
+        res.on("end", () => resolve(Buffer.concat(chunks)));
+        res.on("error", reject);
+      })
+      .on("error", reject);
+  });
+}
+
+async function extractTarGz(buffer, destDir, binaryName) {
+  const tmpFile = path.join(os.tmpdir(), `foundry-${Date.now()}.tar.gz`);
+  fs.writeFileSync(tmpFile, buffer);
+  execSync(`tar xzf "${tmpFile}" -C "${destDir}"`, { stdio: "ignore" });
+  fs.unlinkSync(tmpFile);
+
+  const extracted = path.join(destDir, binaryName);
+  if (!fs.existsSync(extracted)) {
+    // Some archives nest in a directory
+    const entries = fs.readdirSync(destDir);
+    for (const entry of entries) {
+      const nested = path.join(destDir, entry, binaryName);
+      if (fs.existsSync(nested)) {
+        fs.renameSync(nested, extracted);
+        break;
+      }
+    }
+  }
+  return extracted;
+}
+
+async function extractZip(buffer, destDir, binaryName) {
+  const tmpFile = path.join(os.tmpdir(), `foundry-${Date.now()}.zip`);
+  fs.writeFileSync(tmpFile, buffer);
+
+  if (os.platform() === "win32") {
+    execSync(
+      `powershell -Command "Expand-Archive -Path '${tmpFile}' -DestinationPath '${destDir}' -Force"`,
+      { stdio: "ignore" }
+    );
+  } else {
+    execSync(`unzip -o "${tmpFile}" -d "${destDir}"`, { stdio: "ignore" });
+  }
+  fs.unlinkSync(tmpFile);
+
+  const extracted = path.join(destDir, binaryName);
+  if (!fs.existsSync(extracted)) {
+    const entries = fs.readdirSync(destDir);
+    for (const entry of entries) {
+      const nested = path.join(destDir, entry, binaryName);
+      if (fs.existsSync(nested)) {
+        fs.renameSync(nested, extracted);
+        break;
+      }
+    }
+  }
+  return extracted;
+}
+
+async function main() {
+  const target = getTarget();
+  const binaryName = getBinaryName();
+  const ext = getArchiveExt();
+  const version = await fetchLatestVersion();
+  const archiveName = `foundry-${target}.${ext}`;
+  const url = `https://github.com/${REPO}/releases/download/${version}/${archiveName}`;
+
+  const binDir = path.join(__dirname, "bin");
+  const nativeName = os.platform() === "win32" ? "foundry-native.exe" : "foundry-native";
+  const destPath = path.join(binDir, nativeName);
+
+  // Skip if binary already exists and is the right version
+  if (fs.existsSync(destPath)) {
+    try {
+      const existing = execSync(`"${destPath}" --version`, { encoding: "utf8" }).trim();
+      if (existing.includes(version.replace("v", ""))) {
+        console.log(`foundry ${version} already installed.`);
+        return;
+      }
+    } catch {
+      // Version check failed, re-download
+    }
+  }
+
+  console.log(`Downloading foundry ${version} for ${target}...`);
+
+  const buffer = await fetch(url);
+  const tmpDir = fs.mkdtempSync(path.join(os.tmpdir(), "foundry-"));
+
+  if (ext === "tar.gz") {
+    await extractTarGz(buffer, tmpDir, binaryName);
+  } else {
+    await extractZip(buffer, tmpDir, binaryName);
+  }
+
+  const extractedBinary = path.join(tmpDir, binaryName);
+  if (!fs.existsSync(extractedBinary)) {
+    throw new Error(`Binary not found after extraction in ${tmpDir}`);
+  }
+
+  if (!fs.existsSync(binDir)) {
+    fs.mkdirSync(binDir, { recursive: true });
+  }
+
+  fs.copyFileSync(extractedBinary, destPath);
+
+  if (os.platform() !== "win32") {
+    fs.chmodSync(destPath, 0o755);
+  }
+
+  // Clean up
+  fs.rmSync(tmpDir, { recursive: true, force: true });
+
+  console.log(`foundry ${version} installed successfully.`);
+}
+
+main().catch((err) => {
+  console.error(`Failed to install foundry: ${err.message}`);
+  console.error("You can install manually from: https://github.com/context-foundry/context-foundry/releases");
+  process.exit(1);
+});

package/package.json

@@ -1,49 +1,48 @@
 {
   "name": "context-foundry",
-  "version": "2.5.4",
-  "description": "AI agent pattern-learning system - npm wrapper for the Python engine",
-  "keywords": [
-    "ai",
-    "agents",
-    "claude",
-    "mcp",
-    "patterns",
-    "automation",
-    "context-foundry"
-  ],
-  "homepage": "https://github.com/context-foundry/context-foundry",
+  "version": "3.0.8",
+  "description": "Autonomous build loop that plans, builds, reviews, and learns. npm wrapper that installs the Foundry binary.",
+  "author": "Context Foundry",
+  "license": "MIT",
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/context-foundry/context-foundry.git"
+    "url": "https://github.com/context-foundry/context-foundry"
   },
+  "homepage": "https://github.com/context-foundry/context-foundry",
   "bugs": {
     "url": "https://github.com/context-foundry/context-foundry/issues"
   },
-  "license": "MIT",
-  "author": "Context Foundry",
+  "keywords": [
+    "ai",
+    "agents",
+    "claude",
+    "automation",
+    "build-loop",
+    "foundry",
+    "context-foundry",
+    "tui"
+  ],
   "bin": {
-    "cf": "bin/cf.js",
-    "cfd": "bin/cfd.js"
+    "foundry": "bin/foundry"
   },
   "scripts": {
-    "postinstall": "node ./scripts/postinstall.js",
-    "test": "node ./bin/cf.js --version"
-  },
-  "engines": {
-    "node": ">=16.0.0"
+    "postinstall": "node install.js"
   },
   "os": [
     "darwin",
     "linux",
     "win32"
   ],
+  "cpu": [
+    "x64",
+    "arm64"
+  ],
+  "engines": {
+    "node": ">=16"
+  },
   "files": [
     "bin/",
-    "scripts/",
-    "README.md",
-    "Dockerfile",
-    "docker-compose.yml",
-    "nginx.conf",
-    "cf.html"
+    "install.js",
+    "README.md"
   ]
 }

package/Dockerfile

@@ -1,17 +0,0 @@
-# Context Foundry Dashboard (Web UI only)
-# The daemon runs on the host - this just serves the monitoring UI
-FROM nginx:alpine
-
-# Copy dashboard HTML
-COPY cf.html /usr/share/nginx/html/index.html
-COPY cf.html /usr/share/nginx/html/cf.html
-
-# Copy nginx config
-COPY nginx.conf /etc/nginx/conf.d/default.conf
-
-# Expose dashboard port
-EXPOSE 8421
-
-# Health check
-HEALTHCHECK --interval=30s --timeout=5s --retries=3 \
-    CMD wget -q --spider http://localhost:8421/ || exit 1

package/bin/cf.js

@@ -1,153 +0,0 @@
-#!/usr/bin/env node
-
-/**
- * Context Foundry CLI - npm wrapper for Python engine
- *
- * This is a thin shim that delegates to the Python `cf` command.
- * The Python package is installed via pip during npm postinstall.
- */
-
-const { spawn, spawnSync } = require('child_process');
-const path = require('path');
-
-// ANSI colors
-const colors = {
-  red: '\x1b[31m',
-  green: '\x1b[32m',
-  yellow: '\x1b[33m',
-  blue: '\x1b[34m',
-  cyan: '\x1b[36m',
-  reset: '\x1b[0m',
-  bold: '\x1b[1m'
-};
-
-function log(msg, color = '') {
-  console.log(`${color}${msg}${colors.reset}`);
-}
-
-function error(msg) {
-  console.error(`${colors.red}Error: ${msg}${colors.reset}`);
-}
-
-/**
- * Check if Python 3.10+ is available
- */
-function checkPython() {
-  const pythonCommands = ['python3', 'python'];
-
-  for (const cmd of pythonCommands) {
-    try {
-      const result = spawnSync(cmd, ['--version'], { encoding: 'utf-8' });
-      if (result.status === 0) {
-        const version = result.stdout.trim() || result.stderr.trim();
-        const match = version.match(/Python (\d+)\.(\d+)/);
-        if (match) {
-          const major = parseInt(match[1], 10);
-          const minor = parseInt(match[2], 10);
-          if (major === 3 && minor >= 10) {
-            return { cmd, version: `${major}.${minor}` };
-          }
-        }
-      }
-    } catch (e) {
-      // Continue to next command
-    }
-  }
-  return null;
-}
-
-/**
- * Check if the cf command is available in PATH
- */
-function checkCfInstalled() {
-  const result = spawnSync('which', ['cf'], { encoding: 'utf-8' });
-  return result.status === 0;
-}
-
-/**
- * Run the Python cf command with all arguments passed through
- */
-function runCf(args) {
-  const cf = spawn('cf', args, {
-    stdio: 'inherit',
-    env: process.env
-  });
-
-  cf.on('error', (err) => {
-    if (err.code === 'ENOENT') {
-      error('The `cf` command is not found in your PATH.');
-      log('\nThis usually means the Python package is not installed.', colors.yellow);
-      log('Try running:', colors.cyan);
-      log('  pip install context-foundry', colors.bold);
-      log('\nOr reinstall this npm package:', colors.cyan);
-      log('  npm install -g context-foundry', colors.bold);
-      process.exit(1);
-    }
-    throw err;
-  });
-
-  cf.on('close', (code) => {
-    process.exit(code);
-  });
-}
-
-/**
- * Show help with installation instructions
- */
-function showHelp() {
-  log(`
-${colors.cyan}${colors.bold}Context Foundry${colors.reset} - AI Agent Pattern Learning System
-
-${colors.yellow}Usage:${colors.reset}
-  cf              Launch Mission Control TUI
-  cf --version    Show version
-  cf --help       Show this help
-
-${colors.yellow}Quick Start:${colors.reset}
-  1. Run ${colors.cyan}cf${colors.reset} to launch the interactive TUI
-  2. Or use the daemon: ${colors.cyan}cfd start${colors.reset}
-
-${colors.yellow}More Info:${colors.reset}
-  https://github.com/context-foundry/context-foundry
-`);
-}
-
-// Main entry point
-function main() {
-  const args = process.argv.slice(2);
-
-  // Check if Python is available
-  const python = checkPython();
-  if (!python) {
-    error('Python 3.10+ is required but not found.');
-    log('\nPlease install Python 3.10 or later:', colors.yellow);
-    log('  macOS:  brew install python@3.12', colors.cyan);
-    log('  Ubuntu: sudo apt install python3.12', colors.cyan);
-    log('  Windows: https://www.python.org/downloads/', colors.cyan);
-    process.exit(1);
-  }
-
-  // Check if cf is installed
-  if (!checkCfInstalled()) {
-    log(`${colors.yellow}The Python 'cf' command is not installed.${colors.reset}`);
-    log(`Installing context-foundry via pip...`);
-
-    const pip = spawnSync(python.cmd, ['-m', 'pip', 'install', 'context-foundry'], {
-      stdio: 'inherit'
-    });
-
-    if (pip.status !== 0) {
-      error('Failed to install context-foundry via pip.');
-      log('\nTry installing manually:', colors.yellow);
-      log('  pip install context-foundry', colors.cyan);
-      process.exit(1);
-    }
-
-    log(`${colors.green}Successfully installed context-foundry!${colors.reset}\n`);
-  }
-
-  // Pass all args to the Python cf command
-  runCf(args);
-}
-
-main();