create-max-framework 4.0.1 → 6.0.0

package/README.md

@@ -15,6 +15,7 @@ claude
 - Downloads the latest framework release from GitHub
 - Sets up the project directory with all skills, commands, object database, and Python library
 - Initializes a git repository and prints getting-started instructions
+- Checks Python 3.10+, the Python packages below and git, and warns about anything missing
 
 ## Prerequisites
 
@@ -22,6 +23,14 @@ claude
 - [Claude Code](https://docs.anthropic.com/en/docs/claude-code) (for using the framework)
 - [MAX 9](https://cycling74.com/products/max) (for opening and testing generated patches)
 - [Python 3.10+](https://www.python.org/) (for the validation and editing engine)
+- [git](https://git-scm.com/) (every patch save is committed)
+- numpy, scipy and pytest (the DSP simulation, smoke tests and the DSP pre-flight gate; validation works without them). Install them from the project directory:
+
+  ```bash
+  python3 -m pip install -r requirements-dev.txt
+  ```
+
+Run `npx create-max-framework --check-deps` to repeat the checks without installing.
 
 ## Links
 

package/bin/create-max-framework.js

@@ -2,12 +2,13 @@
 
 'use strict';
 
-const { spawn, execSync } = require('child_process');
+const { spawn, execSync, execFileSync } = require('child_process');
 const fs = require('fs');
 const path = require('path');
 const https = require('https');
 
-const VERSION = '1.0.0';
+// The release workflow stamps package.json from the tag before publishing.
+const VERSION = require('../package.json').version;
 const RELEASE_URL = 'https://github.com/taylorbrook/MAX-MSP_CC_Framework/releases/latest/download/framework.tar.gz';
 const MAX_REDIRECTS = 5;
 
@@ -22,6 +23,10 @@ if (args.includes('--version') || args.includes('-v')) {
   process.exit(0);
 }
 
+if (args.includes('--check-deps')) {
+  process.exit(checkDeps() ? 0 : 1);
+}
+
 if (args.includes('--help') || args.includes('-h') || args.length === 0) {
   printUsage();
   process.exit(args.length === 0 ? 1 : 0);
@@ -52,25 +57,21 @@ fs.mkdirSync(targetDir, { recursive: true });
 
 downloadAndExtract(RELEASE_URL, targetDir)
   .then(() => {
-    // Create patches directory and active-project config
+    // Create the patches directory. No active-project pointer is written: a fresh install has no active project until /max-new or /max-switch sets one.
     const patchesDir = path.join(targetDir, 'patches');
     if (!fs.existsSync(patchesDir)) {
       fs.mkdirSync(patchesDir, { recursive: true });
     }
-    fs.writeFileSync(
-      path.join(patchesDir, '.active-project.json'),
-      JSON.stringify({ active_project: null }, null, 2) + '\n'
-    );
 
     // Initialize git repo
     try {
       execSync('git init', { cwd: targetDir, stdio: 'ignore' });
     } catch (_) {
-      // git not available -- not critical
+      // git not available -- checkDeps() warns
     }
 
-    // Check Python version
-    checkPython();
+    // Check Python, its packages and git (warnings only)
+    checkDeps();
 
     // Success message
     console.log(`Done! Your MAX/MSP Claude Code Framework project is ready.\n`);
@@ -107,6 +108,7 @@ Create a new MAX/MSP Claude Code Framework project.
 Options:
   -h, --help      Show this help message
   -v, --version   Show version number
+  --check-deps    Only check Python 3.10+, its packages and git
 
 Examples:
   npx create-max-framework my-synth
@@ -184,21 +186,65 @@ function followRedirects(url, count, callback) {
   });
 }
 
+// Prints "<major>.<minor> <1 if >= 3.10 else 0> <comma-separated missing modules>".
+// Valid on any Python, so an old interpreter still reports its version.
+// A function, not a const: --check-deps runs before this line is reached.
+function pyProbe() {
+  return [
+    'import sys',
+    'missing = []',
+    'for m in ("numpy", "scipy", "pytest"):',
+    '    try:',
+    '        __import__(m)',
+    '    except Exception:',
+    '        missing.append(m)',
+    'print("%d.%d %d %s" % (sys.version_info[0], sys.version_info[1],',
+    '                       int(sys.version_info >= (3, 10)), ",".join(missing)))',
+  ].join('\n');
+}
+
+function onPath(cmd) {
+  try {
+    execFileSync(cmd, ['--version'], { stdio: 'ignore' });
+    return true;
+  } catch (err) {
+    return err.code !== 'ENOENT';
+  }
+}
+
 /**
- * Check for Python 3.10+ and warn if missing or too old.
+ * Check for Python 3.10+, the Python packages the DSP simulation, smoke tests
+ * and pre-flight gate need (numpy, scipy, pytest), and git (Rule #7
+ * auto-commits every save). Warns only; returns false when Python 3.10+ is
+ * missing (review IN-06).
  */
-function checkPython() {
+function checkDeps() {
+  if (!onPath('git')) {
+    console.warn('WARNING: git not found. The framework commits every patch save (Rule #7); install git.');
+  }
+  let info;
   try {
-    const pyVersion = execSync('python3 --version', { encoding: 'utf8' }).trim();
-    const match = pyVersion.match(/Python\s+(\d+)\.(\d+)/);
-    if (match) {
-      const major = parseInt(match[1], 10);
-      const minor = parseInt(match[2], 10);
-      if (major < 3 || (major === 3 && minor < 10)) {
-        console.warn(`WARNING: Python 3.10+ required. Found: ${pyVersion}`);
-      }
+    info = execFileSync('python3', ['-c', pyProbe()], {
+      encoding: 'utf8',
+      stdio: ['ignore', 'pipe', 'ignore'],
+    }).trim();
+  } catch (err) {
+    if (err.code === 'ENOENT') {
+      console.warn('WARNING: Python 3 not found. The framework requires Python 3.10+ for the validation engine.');
+    } else {
+      console.warn('WARNING: python3 did not run. The framework requires Python 3.10+ for the validation engine.');
     }
-  } catch (_) {
-    console.warn('WARNING: Python 3 not found. The framework requires Python 3.10+ for the validation engine.');
+    return false;
+  }
+  const [version, ok, missing = ''] = info.split(/\s+/);
+  let good = true;
+  if (ok !== '1') {
+    console.warn(`WARNING: Python 3.10+ required. Found Python ${version}`);
+    good = false;
+  }
+  if (missing) {
+    console.warn(`WARNING: Python packages missing: ${missing.split(',').join(', ')} (needed by the DSP simulation, smoke tests and the DSP pre-flight gate; validation works without them).`);
+    console.warn('  Install them from the project directory: python3 -m pip install -r requirements-dev.txt');
   }
+  return good;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-max-framework",
-  "version": "4.0.1",
+  "version": "6.0.0",
   "description": "Create a MAX/MSP Claude Code Framework project",
   "bin": {
     "create-max-framework": "bin/create-max-framework.js"