context-foundry 2.2.1

package/README.md

@@ -0,0 +1,75 @@
+# Context Foundry
+
+AI agent pattern-learning system that helps Claude and other AI agents improve over time.
+
+## Installation
+
+```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.
+
+## Requirements
+
+- **Node.js 16+** (for the npm wrapper)
+- **Python 3.10+** (for the engine)
+
+## Quick Start
+
+```bash
+# Launch the interactive TUI (Mission Control)
+cf
+
+# Or use the daemon for background operations
+cfd start
+cfd status
+```
+
+## Commands
+
+### `cf` - Main CLI
+
+```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
+```
+
+## Documentation
+
+- [GitHub Repository](https://github.com/context-foundry/context-foundry)
+- [Documentation](https://context-foundry.github.io)
+
+## License
+
+MIT

package/bin/cf.js

@@ -0,0 +1,153 @@
+#!/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();

package/bin/cfd.js

@@ -0,0 +1,153 @@
+#!/usr/bin/env node
+
+/**
+ * Context Foundry Daemon CLI - npm wrapper for Python engine
+ *
+ * This is a thin shim that delegates to the Python `cfd` command.
+ */
+
+const { spawn, spawnSync } = require('child_process');
+
+// ANSI colors
+const colors = {
+  red: '\x1b[31m',
+  green: '\x1b[32m',
+  yellow: '\x1b[33m',
+  cyan: '\x1b[36m',
+  reset: '\x1b[0m',
+  bold: '\x1b[1m'
+};
+
+function error(msg) {
+  console.error(`${colors.red}Error: ${msg}${colors.reset}`);
+}
+
+function log(msg, color = '') {
+  console.log(`${color}${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;
+}
+
+/**
+ * Get the path to cfd from the Python package
+ */
+function getCfdPath() {
+  // First try: check if cfd is in PATH
+  const which = spawnSync('which', ['cfd'], { encoding: 'utf-8' });
+  if (which.status === 0) {
+    return 'cfd';
+  }
+
+  // Second try: use the tools/cfd script directly if we're in the repo
+  const localCfd = require('path').join(__dirname, '../../tools/cfd');
+  try {
+    require('fs').accessSync(localCfd, require('fs').constants.X_OK);
+    return localCfd;
+  } catch (e) {
+    // Not in repo or not executable
+  }
+
+  return null;
+}
+
+/**
+ * Run the Python cfd command with all arguments passed through
+ */
+function runCfd(cfdPath, args) {
+  const cfd = spawn(cfdPath, args, {
+    stdio: 'inherit',
+    env: process.env
+  });
+
+  cfd.on('error', (err) => {
+    if (err.code === 'ENOENT') {
+      error('The `cfd` command is not found.');
+      log('\nTry running:', colors.cyan);
+      log('  pip install context-foundry', colors.bold);
+      process.exit(1);
+    }
+    throw err;
+  });
+
+  cfd.on('close', (code) => {
+    process.exit(code);
+  });
+}
+
+function showHelp() {
+  log(`
+${colors.cyan}${colors.bold}Context Foundry Daemon (cfd)${colors.reset}
+
+${colors.yellow}Usage:${colors.reset}
+  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 <job-id>   Show job logs
+  cfd --help          Full help
+
+${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 Python availability
+  const python = checkPython();
+  if (!python) {
+    error('Python 3.10+ is required but not found.');
+    process.exit(1);
+  }
+
+  // Find cfd command
+  const cfdPath = getCfdPath();
+  if (!cfdPath) {
+    log(`${colors.yellow}The 'cfd' 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.');
+      process.exit(1);
+    }
+
+    log(`${colors.green}Successfully installed!${colors.reset}\n`);
+  }
+
+  // Run cfd with all arguments
+  runCfd(cfdPath || 'cfd', args);
+}
+
+main();

package/package.json

@@ -0,0 +1,45 @@
+{
+  "name": "context-foundry",
+  "version": "2.2.1",
+  "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",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/context-foundry/context-foundry.git"
+  },
+  "bugs": {
+    "url": "https://github.com/context-foundry/context-foundry/issues"
+  },
+  "license": "MIT",
+  "author": "Context Foundry",
+  "bin": {
+    "cf": "bin/cf.js",
+    "cfd": "bin/cfd.js"
+  },
+  "scripts": {
+    "postinstall": "node ./scripts/postinstall.js",
+    "test": "node ./bin/cf.js --version"
+  },
+  "engines": {
+    "node": ">=16.0.0"
+  },
+  "os": [
+    "darwin",
+    "linux",
+    "win32"
+  ],
+  "files": [
+    "bin/",
+    "scripts/",
+    "README.md"
+  ]
+}

package/scripts/postinstall.js

@@ -0,0 +1,135 @@
+#!/usr/bin/env node
+
+/**
+ * Post-install script for context-foundry npm package
+ *
+ * This script runs after `npm install` and ensures the Python
+ * package is installed via pip.
+ */
+
+const { spawnSync } = require('child_process');
+
+// ANSI colors
+const colors = {
+  red: '\x1b[31m',
+  green: '\x1b[32m',
+  yellow: '\x1b[33m',
+  cyan: '\x1b[36m',
+  dim: '\x1b[2m',
+  reset: '\x1b[0m',
+  bold: '\x1b[1m'
+};
+
+function log(msg, color = '') {
+  console.log(`${color}${msg}${colors.reset}`);
+}
+
+function error(msg) {
+  console.error(`${colors.red}${msg}${colors.reset}`);
+}
+
+/**
+ * Find Python 3.10+ executable
+ */
+function findPython() {
+  const pythonCommands = ['python3', 'python'];
+
+  for (const cmd of pythonCommands) {
+    try {
+      const result = spawnSync(cmd, ['--version'], {
+        encoding: 'utf-8',
+        timeout: 5000
+      });
+
+      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, major, minor };
+          }
+        }
+      }
+    } catch (e) {
+      // Continue to next command
+    }
+  }
+  return null;
+}
+
+/**
+ * Check if context-foundry Python package is already installed
+ */
+function checkInstalled(pythonCmd) {
+  const result = spawnSync(pythonCmd, ['-m', 'pip', 'show', 'context-foundry'], {
+    encoding: 'utf-8',
+    timeout: 10000
+  });
+  return result.status === 0;
+}
+
+/**
+ * Install the Python package
+ */
+function installPythonPackage(pythonCmd) {
+  log('\nInstalling context-foundry Python package...', colors.cyan);
+
+  const result = spawnSync(
+    pythonCmd,
+    ['-m', 'pip', 'install', '--upgrade', 'context-foundry'],
+    {
+      stdio: 'inherit',
+      timeout: 300000 // 5 minutes
+    }
+  );
+
+  return result.status === 0;
+}
+
+function main() {
+  log(`\n${'='.repeat(50)}`, colors.dim);
+  log(`${colors.bold}Context Foundry${colors.reset} - Post-install setup`);
+  log(`${'='.repeat(50)}`, colors.dim);
+
+  // Step 1: Find Python
+  log('\nChecking Python installation...', colors.cyan);
+  const python = findPython();
+
+  if (!python) {
+    log(`\n${colors.yellow}Warning: Python 3.10+ not found.${colors.reset}`);
+    log(`\nThe npm package is installed, but you'll need Python to run it.`);
+    log(`\nInstall Python 3.10+ from:`);
+    log(`  macOS:   ${colors.cyan}brew install python@3.12${colors.reset}`);
+    log(`  Ubuntu:  ${colors.cyan}sudo apt install python3.12${colors.reset}`);
+    log(`  Windows: ${colors.cyan}https://www.python.org/downloads/${colors.reset}`);
+    log(`\nThen run: ${colors.cyan}pip install context-foundry${colors.reset}\n`);
+    // Don't fail - the bin scripts will handle this at runtime
+    return;
+  }
+
+  log(`  Found ${colors.green}Python ${python.major}.${python.minor}${colors.reset} (${python.cmd})`);
+
+  // Step 2: Check if already installed
+  if (checkInstalled(python.cmd)) {
+    log(`  ${colors.green}context-foundry already installed${colors.reset}`);
+    log(`\n${colors.green}Ready to use!${colors.reset} Run ${colors.cyan}cf${colors.reset} to get started.\n`);
+    return;
+  }
+
+  // Step 3: Install Python package
+  const installed = installPythonPackage(python.cmd);
+
+  if (installed) {
+    log(`\n${colors.green}Installation complete!${colors.reset}`);
+    log(`\nRun ${colors.cyan}cf${colors.reset} to launch Context Foundry.\n`);
+  } else {
+    error(`\nFailed to install Python package.`);
+    log(`\nTry installing manually:`);
+    log(`  ${colors.cyan}pip install context-foundry${colors.reset}\n`);
+    // Don't fail npm install - user can fix this manually
+  }
+}
+
+main();