bounded-loops 0.2.0 → 0.3.0

package/README.md

@@ -8,8 +8,9 @@ The engine itself is a **Python 3.11+** package. This wrapper lets you run it wi
 one command:
 
 ```bash
-npx bounded-loops list
-npx bounded-loops run loops/bug-fix-red-green --yes
+npx bounded-loops new --list
+npx bounded-loops new pytest-basic my-loop
+npx bounded-loops run my-loop --yes
 ```
 
 On first run it detects Python 3.11+, installs the `bounded-loops` Python package
@@ -20,10 +21,14 @@ Prefer the native install if you already have Python:
 
 ```bash
 pip install bounded-loops
-bl list
+bl new --list
+bl new pytest-basic my-loop
+bl run my-loop --yes
 ```
 
-Full documentation, the 63 runnable loops, the nine bounds, and the architecture
+Full documentation, the 68 loop folders (64 keyless), the nine bounds, and the architecture
 docs live in the [main repository](https://github.com/qualixar/bounded-loops).
+Clone the repository when you want `bl list` to browse the full shipped loop
+catalog.
 
 Apache-2.0.

package/bin/bounded-loops.js

@@ -10,6 +10,7 @@
 // Node — Python 3.11+ must be available on your PATH.
 
 const { spawnSync } = require('child_process');
+const { version: npmVersion } = require('../package.json');
 
 const args = process.argv.slice(2);
 
@@ -40,21 +41,30 @@ if (!python) {
   process.exit(1);
 }
 
-// Already installed? Run it.
-const installed = spawnSync(python, ['-c', 'import bounded_loops'], { stdio: 'ignore' });
-if (installed.status === 0) {
+// Run only when the Python engine exactly matches this npm release. Merely
+// importing bounded_loops is insufficient: an older global install would make
+// `npx bounded-loops@0.3.0` silently execute 0.2.x.
+const installed = spawnSync(
+  python,
+  [
+    '-c',
+    'from importlib.metadata import version; print(version("bounded-loops"))',
+  ],
+  { encoding: 'utf8' }
+);
+if (installed.status === 0 && installed.stdout.trim() === npmVersion) {
   runCli(python);
 }
 
-// First run: bootstrap the Python engine via pip, then run.
-console.error('bounded-loops: installing the Python engine (first run)…');
+// First run or version mismatch: install the exact matching Python engine.
+console.error(`bounded-loops: installing Python engine ${npmVersion}…`);
 const install = spawnSync(
   python,
-  ['-m', 'pip', 'install', '--quiet', 'bounded-loops'],
+  ['-m', 'pip', 'install', '--quiet', `bounded-loops==${npmVersion}`],
   { stdio: 'inherit' }
 );
 if (install.status !== 0) {
-  console.error('Auto-install failed. Install it manually: pip install bounded-loops');
+  console.error(`Auto-install failed. Install it manually: pip install bounded-loops==${npmVersion}`);
   process.exit(1);
 }
 runCli(python);

package/package.json

@@ -1,10 +1,13 @@
 {
   "name": "bounded-loops",
-  "version": "0.2.0",
-  "description": "npx launcher for bounded-loops — runnable, bounded AI-agent loops. The engine is a Python 3.11+ package; this wrapper detects Python, installs it on first run, and runs it.",
+  "version": "0.3.0",
+  "description": "npx launcher for bounded-loops: 68 loop folders, 64 keyless, with independent gates and nine enforced bounds. Requires Python 3.11+.",
   "bin": {
     "bounded-loops": "bin/bounded-loops.js"
   },
+  "scripts": {
+    "test": "node --test test/*.test.js"
+  },
   "files": [
     "bin/",
     "README.md"