@magnusekdahl/parallix 1.2.0 → 1.3.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@magnusekdahl/parallix",
-  "version": "1.2.0",
+  "version": "1.3.0",
   "description": "AI mission workflow toolkit with a px CLI — local-first, human-in-the-loop multi-agent development",
   "license": "AGPL-3.0-or-later",
   "private": false,
@@ -48,16 +48,18 @@
   ],
   "scripts": {
     "build": "tsc",
-    "prepublishOnly": "test -z \"$(find . -name '*.ts' ! -path './node_modules/*')\" || tsc",
+    "build:cjs": "tsc --rootDir . --outDir . --module CommonJS --moduleResolution Node --esModuleInterop",
+    "prepublishOnly": "npm run build:cjs",
+    "pretest": "npm run build:cjs",
     "test": "FORCE_COLOR=0 node --test test/*.test.js",
     "test:coverage": "FORCE_COLOR=0 node lib/commands/coverage-gate.js --lcov",
     "typecheck": "tsc --noEmit"
   },
   "devDependencies": {
     "@types/node": "^26.0.1",
-    "@typescript-eslint/eslint-plugin": "^7.0.0",
-    "@typescript-eslint/parser": "^7.0.0",
-    "eslint": "^8.57.0",
+    "@typescript-eslint/eslint-plugin": "^8.62.1",
+    "@typescript-eslint/parser": "^8.62.1",
+    "eslint": "^9.39.4",
     "sonarqube-scanner": "^4.0.1",
     "typescript": "^5.4.0"
   }

package/prompts/draft.md

@@ -24,6 +24,7 @@ Drafting requirements:
 - {{classificationInstructions}}
 - preserve `{{taskPath}}`: update content as needed but do not delete, rename, or move the file
 - do not edit the backlog `assignee` field; the workflow records ownership itself
+- Refinement Signals section must use net engineering lines (NEL) bucket format (`Predicted NEL bucket: Small (0–80) / Medium (81–235) / Large (235+)`) and must NOT use the old agent-percentage-usage format
 
 Bug-labeled missions (regression-test-first / "lock the bug"):
 - this section applies only when the backlog task at `{{taskPath}}` carries a `bug` label (in addition to its `ai_sdlc` or `user_value` classification). If there is no `bug` label, ignore this section entirely.

package/prompts/portfolio.md

@@ -14,7 +14,7 @@ Output: propose exactly 10 candidate missions. For each, provide:
 - Primary leverage (confidence / credibility / promotion signal)
 - Primary skill domains (BE / Web / Android / iOS / Ops / Security)
 - Estimated scope rank (1–10, 1 = largest)
-- Estimated agent % usage limit (`n/a` if not ready)
+- Predicted NEL bucket (`n/a` if not ready)
 - Selection note (`activate as-is` | `split first` | `defer` | `n/a`)
 - Main risk mitigated (skill rot / credibility gap / system weakness)
 - Duplicate check: none, or follow-up of <existing mission>

package/px.js

@@ -1,236 +1,252 @@
 #!/usr/bin/env node
-
-const fs = require('fs');
-const path = require('path');
-const fmt = require('./lib/core/fmt');
-const missionStart = require('./lib/commands/mission-start');
-const { createEvent } = require('./lib/review/review-events');
-const workflow = require('./index');
-const packageJson = require('./package.json');
-
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parseArgs = parseArgs;
+exports.shellInit = shellInit;
+exports.versionInfo = versionInfo;
+exports.formatVersionInfo = formatVersionInfo;
+exports.parseReviewEventArgs = parseReviewEventArgs;
+exports.run = run;
+const node_fs_1 = __importDefault(require("node:fs"));
+const node_path_1 = __importDefault(require("node:path"));
+const fmt = __importStar(require("./lib/core/fmt.js"));
+const missionStart = require("./lib/commands/mission-start.js");
+const review_events_js_1 = require("./lib/review/review-events.js");
+const workflow = __importStar(require("./index.js"));
+const package_json_1 = __importDefault(require("./package.json"));
 function parseArgs(argv, baseCwd = process.cwd()) {
-  const args = [...argv];
-  if (args[0] === '--version' || args[0] === '-v') {
-    return { target: path.resolve(baseCwd), command: 'version', args: [] };
-  }
-
-  const command = args.shift();
-  if (!command) {
-    throw new Error('Missing command');
-  }
-
-  return { target: path.resolve(baseCwd), command, args };
+    const args = [...argv];
+    if (args[0] === '--version' || args[0] === '-v') {
+        return { target: node_path_1.default.resolve(baseCwd), command: 'version', args: [] };
+    }
+    const command = args.shift();
+    if (!command) {
+        throw new Error('Missing command');
+    }
+    return { target: node_path_1.default.resolve(baseCwd), command, args };
 }
-
 // Emits a shell function named `px` that wraps the globally installed `px`
 // runner and switches the caller's terminal into the next mission worktree
 // when the runtime prints a transition signal. A shell function always runs in
 // the current shell, so it can `cd` the caller (an npm `bin` subprocess cannot).
 // Install with:  eval "$(px shell-init bash)"   (or zsh) in your shell rc.
 function shellInit(shell = 'bash') {
-  const normalized = String(shell || 'bash').toLowerCase();
-  if (normalized !== 'bash' && normalized !== 'zsh') {
-    throw new Error(`Unsupported shell for shell-init: ${shell} (supported: bash, zsh)`);
-  }
-  // zsh exposes pipe statuses via the lowercase 1-indexed `pipestatus` array;
-  // bash uses the uppercase 0-indexed `PIPESTATUS`.
-  const exitCapture = normalized === 'zsh'
-    ? '_px_exit=${pipestatus[1]}'
-    : '_px_exit=${PIPESTATUS[0]}';
-
-  return [
-    '# px shell integration. Add to your shell rc:',
-    `#   eval "$(px shell-init ${normalized})"`,
-    '# Defines a `px` shell function that runs the globally installed `px` and',
-    '# changes your terminal into the next mission worktree on transitions.',
-    'px() {',
-    '  local _px_log _px_exit _px_signal _px_target _px_current',
-    '  _px_log="$(mktemp)" || return 1',
-    '  command px "$@" 2>&1 | tee "$_px_log"',
-    `  ${exitCapture}`,
-    '  _px_signal="$(grep "\\[INFO\\] Next: cd " "$_px_log" | tail -n 1 | sed "s/.*\\[INFO\\] Next: cd //")"',
-    '  if [ -z "$_px_signal" ]; then',
-    '    _px_signal="$(grep "\\[INFO\\] Working directory: " "$_px_log" | tail -n 1 | sed "s/.*\\[INFO\\] Working directory: //")"',
-    '  fi',
-    '  rm -f "$_px_log"',
-    '  if [ -n "$_px_signal" ]; then',
-    '    _px_target="${_px_signal#"${_px_signal%%[![:space:]]*}"}"',
-    '    _px_target="${_px_target%"${_px_target##*[![:space:]]}"}"',
-    '    if [ -d "$_px_target" ]; then',
-    '      _px_current="$(pwd -P 2>/dev/null)"',
-    '      if [ "$_px_current" != "$(cd "$_px_target" && pwd -P)" ]; then',
-    '        cd "$_px_target" && echo "[px] Switched terminal context to: $(pwd)"',
-    '      fi',
-    '    else',
-    '      echo "[px] ERROR: target directory \'$_px_target\' not found." >&2',
-    '    fi',
-    '  fi',
-    '  return $_px_exit',
-    '}',
-    '',
-  ].join('\n');
+    const normalized = String(shell || 'bash').toLowerCase();
+    if (normalized !== 'bash' && normalized !== 'zsh') {
+        throw new Error(`Unsupported shell for shell-init: ${shell} (supported: bash, zsh)`);
+    }
+    // zsh exposes pipe statuses via the lowercase 1-indexed `pipestatus` array;
+    // bash uses the uppercase 0-indexed `PIPESTATUS`.
+    const exitCapture = normalized === 'zsh'
+        ? '_px_exit=${pipestatus[1]}'
+        : '_px_exit=${PIPESTATUS[0]}';
+    return [
+        '# px shell integration. Add to your shell rc:',
+        `#   eval "$(px shell-init ${normalized})"`,
+        '# Defines a `px` shell function that runs the globally installed `px` and',
+        '# changes your terminal into the next mission worktree on transitions.',
+        'px() {',
+        '  local _px_log _px_exit _px_signal _px_target _px_current',
+        '  _px_log="$(mktemp)" || return 1',
+        '  command px "$@" 2>&1 | tee "$_px_log"',
+        `  ${exitCapture}`,
+        '  _px_signal="$(grep "\\\\[INFO\\\\] Next: cd " "$_px_log" | tail -n 1 | sed "s/.*\\\\[INFO\\\\] Next: cd //")"',
+        '  if [ -z "$_px_signal" ]; then',
+        '    _px_signal="$(grep "\\\\[INFO\\\\] Working directory: " "$_px_log" | tail -n 1 | sed "s/.*\\\\[INFO\\\\] Working directory: //")"',
+        '  fi',
+        '  rm -f "$_px_log"',
+        '  if [ -n "$_px_signal" ]; then',
+        '    _px_target="${_px_signal#"${_px_signal%%[![:space:]]*}"}"',
+        '    _px_target="${_px_target%"${_px_target##*[![:space:]]}"}"',
+        '    if [ -d "$_px_target" ]; then',
+        '      _px_current="$(pwd -P 2>/dev/null)"',
+        '      if [ "$_px_current" != "$(cd "$_px_target" && pwd -P)" ]; then',
+        '        cd "$_px_target" && echo "[px] Switched terminal context to: $(pwd)"',
+        '      fi',
+        '    fi',
+        '  fi',
+        '  return $_px_exit',
+        '}',
+        '',
+    ].join('\n');
 }
-
 function versionInfo() {
-  return {
-    name: packageJson.name,
-    version: packageJson.version,
-    pxPath: __filename,
-    packageRoot: __dirname,
-    node: process.version,
-  };
+    return {
+        name: package_json_1.default.name,
+        version: package_json_1.default.version,
+        pxPath: __filename,
+        packageRoot: __dirname,
+        node: process.version,
+    };
 }
-
 function formatVersionInfo(info = versionInfo()) {
-  return [
-    `${info.name} ${info.version}`,
-    `px: ${info.pxPath}`,
-    `package: ${info.packageRoot}`,
-    `node: ${info.node}`,
-  ].join('\n');
+    return [
+        `${info.name} ${info.version}`,
+        `px: ${info.pxPath}`,
+        `package: ${info.packageRoot}`,
+        `node: ${info.node}`,
+    ].join('\n');
 }
-
 function parseReviewEventArgs(args) {
-  const slug = args[0];
-  if (!slug) {
-    throw new Error('Usage: review-event <slug> --type <event-type> --actor <actor> --content <text> [--timestamp <stamp>] [--skip-git]');
-  }
-
-  const parsed = {
-    slug,
-    type: null,
-    actor: null,
-    content: '',
-    timestamp: null,
-    skipGit: false,
-  };
-
-  for (let i = 1; i < args.length; i += 1) {
-    const arg = args[i];
-    if (arg === '--skip-git') {
-      parsed.skipGit = true;
-      continue;
+    const slug = args[0];
+    if (!slug) {
+        throw new Error('Usage: review-event <slug> --type <event-type> --actor <actor> --content <text> [--timestamp <stamp>] [--skip-git]');
     }
-    if (!arg.startsWith('--')) {
-      throw new Error(`Unexpected review-event argument: ${arg}`);
+    const parsed = {
+        slug,
+        type: null,
+        actor: null,
+        content: '',
+        timestamp: null,
+        skipGit: false,
+    };
+    for (let i = 1; i < args.length; i += 1) {
+        const arg = args[i];
+        if (arg === '--skip-git') {
+            parsed.skipGit = true;
+            continue;
+        }
+        if (!arg.startsWith('--')) {
+            throw new Error(`Unexpected review-event argument: ${arg}`);
+        }
+        const key = arg.slice(2);
+        const value = args[i + 1];
+        if (!value) {
+            throw new Error(`${arg} requires a value`);
+        }
+        i += 1;
+        if (key === 'type') {
+            parsed.type = value;
+        }
+        else if (key === 'actor') {
+            parsed.actor = value;
+        }
+        else if (key === 'content') {
+            parsed.content = value;
+        }
+        else if (key === 'timestamp') {
+            parsed.timestamp = value;
+        }
+        else {
+            throw new Error(`Unknown review-event option: ${arg}`);
+        }
     }
-    const key = arg.slice(2);
-    const value = args[i + 1];
-    if (!value) {
-      throw new Error(`${arg} requires a value`);
+    if (!parsed.type) {
+        throw new Error('review-event requires --type');
     }
-    i += 1;
-
-    if (key === 'type') parsed.type = value;
-    else if (key === 'actor') parsed.actor = value;
-    else if (key === 'content') parsed.content = value;
-    else if (key === 'timestamp') parsed.timestamp = value;
-    else throw new Error(`Unknown review-event option: ${arg}`);
-  }
-
-  if (!parsed.type) {
-    throw new Error('review-event requires --type');
-  }
-
-  return parsed;
+    return parsed;
 }
-
 async function run(argv = process.argv.slice(2), options = {}) {
-  const log = options.log || fmt.log.plain;
-  const error = options.error || fmt.log.plainError;
-  const baseCwd = options.baseCwd || process.cwd();
-
-  let parsed;
-  try {
-    parsed = parseArgs(argv, baseCwd);
-  } catch (err) {
-    error(fmt.status('FAIL', err.message));
-    return 1;
-  }
-
-  // shell-init prints a shell snippet and never touches a target repository, so
-  // it runs before the target-path check.
-  if (parsed.command === 'shell-init') {
+    const log = options.log || fmt.log.plain;
+    const error = options.error || fmt.log.plainError;
+    const baseCwd = options.baseCwd || process.cwd();
+    let parsed;
     try {
-      log(shellInit(parsed.args[0]));
-      return 0;
-    } catch (err) {
-      error(fmt.status('FAIL', err.message));
-      return 1;
+        parsed = parseArgs(argv, baseCwd);
     }
-  }
-
-  if (!fs.existsSync(parsed.target) || !fs.statSync(parsed.target).isDirectory()) {
-    error(fmt.status('FAIL', `Target repository path not found: ${parsed.target}`));
-    return 1;
-  }
-
-  if (parsed.command === 'version') {
-    log(formatVersionInfo());
-    return 0;
-  }
-
-  const previousCwd = process.cwd();
-  process.chdir(parsed.target);
-
-  try {
-    if (parsed.command === 'review-event') {
-      const eventArgs = parseReviewEventArgs(parsed.args);
-      const result = createEvent(
-        eventArgs.slug,
-        eventArgs.type,
-        {
-          actor: eventArgs.actor,
-          content: eventArgs.content,
-          timestamp: eventArgs.timestamp,
-        },
-        {
-          worktree: parsed.target,
-          skipGit: eventArgs.skipGit,
-          log,
-          error,
-        },
-      );
-      if (result.ok) {
-        log(fmt.status('PASS', `Review event path: ${path.relative(parsed.target, result.path)}`));
-      }
-      return result.ok ? 0 : 1;
+    catch (err) {
+        error(fmt.status('FAIL', err.message));
+        return 1;
     }
-
-    if (parsed.command === 'verify-env') {
-      const result = missionStart([], { command: 'verify-env', returnResult: true, log, error });
-      return result && result.pass ? 0 : 1;
+    // shell-init prints a shell snippet and never touches a target repository, so
+    // it runs before the target-path check.
+    if (parsed.command === 'shell-init') {
+        try {
+            log(shellInit(parsed.args[0]));
+            return 0;
+        }
+        catch (err) {
+            error(fmt.status('FAIL', err.message));
+            return 1;
+        }
+    }
+    if (!node_fs_1.default.existsSync(parsed.target) || !node_fs_1.default.statSync(parsed.target).isDirectory()) {
+        error(fmt.status('FAIL', `Target repository path not found: ${parsed.target}`));
+        return 1;
+    }
+    if (parsed.command === 'version') {
+        log(formatVersionInfo());
+        return 0;
+    }
+    const previousCwd = process.cwd();
+    process.chdir(parsed.target);
+    try {
+        if (parsed.command === 'review-event') {
+            const eventArgs = parseReviewEventArgs(parsed.args);
+            const result = (0, review_events_js_1.createEvent)(eventArgs.slug, eventArgs.type || '', {
+                actor: eventArgs.actor || '',
+                content: eventArgs.content,
+                timestamp: eventArgs.timestamp || undefined,
+            }, {
+                worktree: parsed.target,
+                skipGit: eventArgs.skipGit,
+                log,
+                error,
+            });
+            if (result.ok && result.path) {
+                log(fmt.status('PASS', `Review event path: ${node_path_1.default.relative(parsed.target, result.path)}`));
+            }
+            return result.ok ? 0 : 1;
+        }
+        if (parsed.command === 'verify-env') {
+            const result = missionStart([], { command: 'verify-env', returnResult: true, log, error });
+            return result && result.pass ? 0 : 1;
+        }
+        let exitCode = 0;
+        await workflow.main([parsed.command, ...parsed.args], {
+            cwdFn: () => parsed.target,
+            exitFn: ((code) => { exitCode = typeof code === 'number' ? code : 0; }),
+            logFn: log,
+            errorFn: error,
+        });
+        return exitCode;
+    }
+    catch (err) {
+        error(fmt.status('FAIL', err.message));
+        return 1;
+    }
+    finally {
+        process.chdir(previousCwd);
     }
-
-    let exitCode = 0;
-    await workflow.main([parsed.command, ...parsed.args], {
-      cwdFn: () => parsed.target,
-      exitFn: code => {
-        exitCode = typeof code === 'number' ? code : 0;
-      },
-      logFn: log,
-      errorFn: error,
-    });
-    return exitCode;
-  } catch (err) {
-    error(fmt.status('FAIL', err.message));
-    return 1;
-  } finally {
-    process.chdir(previousCwd);
-  }
 }
-
-if (require.main === module) {
-  run().then(code => {
-    process.exitCode = code;
-  });
+if (typeof require !== 'undefined' && require.main === module) {
+    run().then(code => {
+        process.exitCode = code;
+    });
 }
-
-module.exports = {
-  formatVersionInfo,
-  parseArgs,
-  parseReviewEventArgs,
-  run,
-  shellInit,
-  versionInfo,
-};