@magnusekdahl/parallix 1.2.0 → 1.3.0

package/lib/commands/checkpoint.js

@@ -1,78 +1,102 @@
-const { git, run, getCurrentBranch } = require('../core/git');
-const { findMissionDir, findMissionArea, inferSlug } = require('../core/mission-utils');
-const fmt = require('../core/fmt');
-const { formatVerificationCommand, runVerificationGate } = require('../core/verification');
-
+"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;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+// @ts-nocheck
+const git_js_1 = require("../core/git.js");
+const mission_utils_js_1 = require("../core/mission-utils.js");
+const fmt = __importStar(require("../core/fmt.js"));
+const verification_js_1 = require("../core/verification.js");
 /** @param {string[]} args */
 function checkpoint(args) {
-  /** @param {string} a */
-  const flags = args.filter(a => a.startsWith('--'));
-  /** @param {string} a */
-  const params = args.filter(a => !a.startsWith('--'));
-  
-  let [explicitSlug, cpName, nextAction] = params;
-
-  // Shift if slug is inferred
-  let slug = inferSlug(explicitSlug);
-  if (slug && explicitSlug !== slug) {
-    // Slug was inferred, so explicitSlug is actually cpName
-    nextAction = cpName;
-    cpName = explicitSlug;
-  }
-
-  if (!slug || !cpName || !nextAction) {
-    fmt.log.fail('Usage: node parallix checkpoint [<slug>] <cp-name> "<next-action>" [--no-gate]');
-    process.exit(1);
-  }
-
-  const missionDir = findMissionDir(slug);
-  if (!missionDir) {
-    fmt.log.fail(`Mission directory not found for slug: ${fmt.slug(slug)}`);
-    process.exit(1);
-  }
-
-  const area = findMissionArea(missionDir);
-  const skipGate = flags.includes('--no-gate');
-
-  fmt.log.info(`Running checkpoint for mission: ${fmt.slug(slug)}, checkpoint: ${fmt.bold(cpName)}`);
-
-  // Step 1: Verify
-  if (skipGate) {
-    fmt.log.warn('Step 1: Skipping verification gate (--no-gate)');
-  } else {
-    fmt.log.info(`Step 1: Running verification gate for area: ${fmt.bold(area)}...`);
-    const verifyResult = runVerificationGate(area, { rootDir: process.cwd(), stdio: 'inherit', runFn: run });
-    if (verifyResult.status !== 0) {
-      fmt.log.fail(`Verification gate failed for area: ${fmt.bold(area)}. Fix errors and retry ${fmt.command(formatVerificationCommand(area))} or use --no-gate.`);
-      process.exit(1);
+    /** @param {string} a */
+    const flags = args.filter(a => a.startsWith('--'));
+    /** @param {string} a */
+    const params = args.filter(a => !a.startsWith('--'));
+    let [explicitSlug, cpName, nextAction] = params;
+    // Shift if slug is inferred
+    let slug = (0, mission_utils_js_1.inferSlug)(explicitSlug);
+    if (slug && explicitSlug !== slug) {
+        // Slug was inferred, so explicitSlug is actually cpName
+        nextAction = cpName;
+        cpName = explicitSlug;
+    }
+    if (!slug || !cpName || !nextAction) {
+        fmt.log.fail('Usage: node parallix checkpoint [<slug>] <cp-name> "<next-action>" [--no-gate]');
+        process.exit(1);
+    }
+    const missionDir = (0, mission_utils_js_1.findMissionDir)(slug);
+    if (!missionDir) {
+        fmt.log.fail(`Mission directory not found for slug: ${fmt.slug(slug)}`);
+        process.exit(1);
+    }
+    const area = (0, mission_utils_js_1.findMissionArea)(missionDir);
+    const skipGate = flags.includes('--no-gate');
+    fmt.log.info(`Running checkpoint for mission: ${fmt.slug(slug)}, checkpoint: ${fmt.bold(cpName)}`);
+    // Step 1: Verify
+    if (skipGate) {
+        fmt.log.warn('Step 1: Skipping verification gate (--no-gate)');
+    }
+    else {
+        fmt.log.info(`Step 1: Running verification gate for area: ${fmt.bold(area)}...`);
+        const verifyResult = (0, verification_js_1.runVerificationGate)(area, { rootDir: process.cwd(), stdio: 'inherit', runFn: git_js_1.run });
+        if (verifyResult.status !== 0) {
+            fmt.log.fail(`Verification gate failed for area: ${fmt.bold(area)}. Fix errors and retry ${fmt.command((0, verification_js_1.formatVerificationCommand)(area))} or use --no-gate.`);
+            process.exit(1);
+        }
+        fmt.log.pass(`Verification gate passed for area: ${fmt.bold(area)}`);
+    }
+    // Step 2: Stage
+    fmt.log.info('Step 2: Staging all tracked changes...');
+    (0, git_js_1.git)(['add', '-A']);
+    // Step 3: Commit
+    fmt.log.info('Step 3: Committing checkpoint...');
+    const commitMsg = `checkpoint(${slug}): ${cpName}`;
+    const commitBody = `Next action: ${nextAction}`;
+    const commitResult = (0, git_js_1.git)(['commit', '-m', commitMsg, '-m', commitBody]);
+    if (commitResult.status !== 0) {
+        fmt.log.fail('Commit failed.');
+        process.exit(1);
+    }
+    // Step 4: Push
+    const branch = (0, git_js_1.getCurrentBranch)();
+    fmt.log.info(`Step 4: Pushing to origin/${fmt.branch(branch)}...`);
+    const pushResult = (0, git_js_1.git)(['push', 'origin', branch]);
+    if (pushResult.status !== 0) {
+        fmt.log.fail('Push failed.');
+        process.exit(1);
     }
-    fmt.log.pass(`Verification gate passed for area: ${fmt.bold(area)}`);
-  }
-
-  // Step 2: Stage
-  fmt.log.info('Step 2: Staging all tracked changes...');
-  git(['add', '-A']);
-
-  // Step 3: Commit
-  fmt.log.info('Step 3: Committing checkpoint...');
-  const commitMsg = `checkpoint(${slug}): ${cpName}`;
-  const commitBody = `Next action: ${nextAction}`;
-  const commitResult = git(['commit', '-m', commitMsg, '-m', commitBody]);
-  if (commitResult.status !== 0) {
-    fmt.log.fail('Commit failed.');
-    process.exit(1);
-  }
-
-  // Step 4: Push
-  const branch = getCurrentBranch();
-  fmt.log.info(`Step 4: Pushing to origin/${fmt.branch(branch)}...`);
-  const pushResult = git(['push', 'origin', branch]);
-  if (pushResult.status !== 0) {
-    fmt.log.fail('Push failed.');
-    process.exit(1);
-  }
-
-  fmt.log.pass('Checkpoint complete and pushed.');
+    fmt.log.pass('Checkpoint complete and pushed.');
 }
-
-module.exports = checkpoint;
+exports.default = checkpoint;

package/lib/commands/checkpoint.ts

@@ -0,0 +1,79 @@
+// @ts-nocheck
+import { git, run, getCurrentBranch } from '../core/git.js';
+import { findMissionDir, findMissionArea, inferSlug } from '../core/mission-utils.js';
+import * as fmt from '../core/fmt.js';
+import { formatVerificationCommand, runVerificationGate } from '../core/verification.js';
+
+/** @param {string[]} args */
+function checkpoint(args) {
+  /** @param {string} a */
+  const flags = args.filter(a => a.startsWith('--'));
+  /** @param {string} a */
+  const params = args.filter(a => !a.startsWith('--'));
+
+  let [explicitSlug, cpName, nextAction] = params;
+
+  // Shift if slug is inferred
+  let slug = inferSlug(explicitSlug);
+  if (slug && explicitSlug !== slug) {
+    // Slug was inferred, so explicitSlug is actually cpName
+    nextAction = cpName;
+    cpName = explicitSlug;
+  }
+
+  if (!slug || !cpName || !nextAction) {
+    fmt.log.fail('Usage: node parallix checkpoint [<slug>] <cp-name> "<next-action>" [--no-gate]');
+    process.exit(1);
+  }
+
+  const missionDir = findMissionDir(slug);
+  if (!missionDir) {
+    fmt.log.fail(`Mission directory not found for slug: ${fmt.slug(slug)}`);
+    process.exit(1);
+  }
+
+  const area = findMissionArea(missionDir);
+  const skipGate = flags.includes('--no-gate');
+
+  fmt.log.info(`Running checkpoint for mission: ${fmt.slug(slug)}, checkpoint: ${fmt.bold(cpName)}`);
+
+  // Step 1: Verify
+  if (skipGate) {
+    fmt.log.warn('Step 1: Skipping verification gate (--no-gate)');
+  } else {
+    fmt.log.info(`Step 1: Running verification gate for area: ${fmt.bold(area)}...`);
+    const verifyResult = runVerificationGate(area, { rootDir: process.cwd(), stdio: 'inherit', runFn: run });
+    if (verifyResult.status !== 0) {
+      fmt.log.fail(`Verification gate failed for area: ${fmt.bold(area)}. Fix errors and retry ${fmt.command(formatVerificationCommand(area))} or use --no-gate.`);
+      process.exit(1);
+    }
+    fmt.log.pass(`Verification gate passed for area: ${fmt.bold(area)}`);
+  }
+
+  // Step 2: Stage
+  fmt.log.info('Step 2: Staging all tracked changes...');
+  git(['add', '-A']);
+
+  // Step 3: Commit
+  fmt.log.info('Step 3: Committing checkpoint...');
+  const commitMsg = `checkpoint(${slug}): ${cpName}`;
+  const commitBody = `Next action: ${nextAction}`;
+  const commitResult = git(['commit', '-m', commitMsg, '-m', commitBody]);
+  if (commitResult.status !== 0) {
+    fmt.log.fail('Commit failed.');
+    process.exit(1);
+  }
+
+  // Step 4: Push
+  const branch = getCurrentBranch();
+  fmt.log.info(`Step 4: Pushing to origin/${fmt.branch(branch)}...`);
+  const pushResult = git(['push', 'origin', branch]);
+  if (pushResult.status !== 0) {
+    fmt.log.fail('Push failed.');
+    process.exit(1);
+  }
+
+  fmt.log.pass('Checkpoint complete and pushed.');
+}
+
+export default checkpoint;

package/lib/commands/config.js

@@ -1,41 +1,71 @@
 #!/usr/bin/env node
-
-const fmt = require('../core/fmt');
-const { loadEffectiveConfig, loadWorkflowConfig, validateWorkflowConfig } = require('../core/product-config');
-
+"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;
+    };
+})();
+const fmt = __importStar(require("../core/fmt.js"));
+const product_config_js_1 = require("../core/product-config.js");
 // `node parallix config` — read-only. Prints the effective configuration:
 // code-owned defaults merged with the optional workflow.config.json override.
 // This replaces the deleted workflow.config.json.example as the way to discover
 // the configurable surface, with no copy-paste footgun and no second source of
 // truth to drift from (task-1233 Scope Amendment).
-/** @param {string[]} _args @param {{logFn?: Function, errorFn?: Function, exitFn?: Function, rootDir?: string}} opts */
 async function config(_args = [], opts = {}) {
-  void _args; // intentionally unused — part of public API signature
-  const logFn = opts.logFn || fmt.log.plain;
-  const errorFn = opts.errorFn || fmt.log.plainError;
-  const exitFn = opts.exitFn || /** @type{(code: number) => void} */ ((code) => { process.exitCode = code; });
-  const rootDir = opts.rootDir || process.cwd();
-
-  const loaded = loadWorkflowConfig(rootDir);
-  if (!loaded.found) {
-    logFn(fmt.status('INFO', 'No workflow.config.json found — showing built-in defaults.'));
-  } else if (loaded.parseError) {
-    errorFn(fmt.status('FAIL', `workflow.config.json is invalid JSON (${/** @type{Error} */(loaded.parseError).message}); showing fallback built-in defaults.`));
-    logFn(JSON.stringify(loadEffectiveConfig(rootDir), null, 2));
-    exitFn(1);
-    return;
-  } else {
-    const issues = validateWorkflowConfig(loaded.config);
-    if (issues.length > 0) {
-      errorFn(fmt.status('FAIL', `workflow.config.json is structurally invalid: ${issues.join('; ')}; showing fallback built-in defaults.`));
-      logFn(JSON.stringify(loadEffectiveConfig(rootDir), null, 2));
-      exitFn(1);
-      return;
+    void _args; // intentionally unused — part of public API signature
+    const logFn = opts.logFn || fmt.log.plain;
+    const errorFn = opts.errorFn || fmt.log.plainError;
+    const exitFn = opts.exitFn || ((code) => { process.exitCode = code; });
+    const rootDir = opts.rootDir || process.cwd();
+    const loaded = (0, product_config_js_1.loadWorkflowConfig)(rootDir);
+    if (!loaded.found) {
+        logFn(fmt.status('INFO', 'No workflow.config.json found — showing built-in defaults.'));
+    }
+    else if (loaded.parseError) {
+        errorFn(fmt.status('FAIL', `workflow.config.json is invalid JSON (${ /** @type{Error} */(loaded.parseError).message}); showing fallback built-in defaults.`));
+        logFn(JSON.stringify((0, product_config_js_1.loadEffectiveConfig)(rootDir), null, 2));
+        exitFn(1);
+        return;
+    }
+    else {
+        const issues = (0, product_config_js_1.validateWorkflowConfig)(loaded.config);
+        if (issues.length > 0) {
+            errorFn(fmt.status('FAIL', `workflow.config.json is structurally invalid: ${issues.join('; ')}; showing fallback built-in defaults.`));
+            logFn(JSON.stringify((0, product_config_js_1.loadEffectiveConfig)(rootDir), null, 2));
+            exitFn(1);
+            return;
+        }
+        logFn(fmt.status('INFO', `Effective config (built-in defaults + ${loaded.configPath}):`));
     }
-    logFn(fmt.status('INFO', `Effective config (built-in defaults + ${loaded.configPath}):`));
-  }
-
-  logFn(JSON.stringify(loadEffectiveConfig(rootDir), null, 2));
+    logFn(JSON.stringify((0, product_config_js_1.loadEffectiveConfig)(rootDir), null, 2));
 }
-
 module.exports = config;

package/lib/commands/config.ts

@@ -0,0 +1,47 @@
+#!/usr/bin/env node
+
+import * as fmt from '../core/fmt.js';
+import { loadEffectiveConfig, loadWorkflowConfig, validateWorkflowConfig } from '../core/product-config.js';
+
+interface ConfigOptions {
+  logFn?: (msg: string) => void;
+  errorFn?: (msg: string) => void;
+  exitFn?: (code: number) => void;
+  rootDir?: string;
+}
+
+// `node parallix config` — read-only. Prints the effective configuration:
+// code-owned defaults merged with the optional workflow.config.json override.
+// This replaces the deleted workflow.config.json.example as the way to discover
+// the configurable surface, with no copy-paste footgun and no second source of
+// truth to drift from (task-1233 Scope Amendment).
+async function config(_args: string[] = [], opts: ConfigOptions = {}) {
+  void _args; // intentionally unused — part of public API signature
+  const logFn = opts.logFn || fmt.log.plain;
+  const errorFn = opts.errorFn || fmt.log.plainError;
+  const exitFn = opts.exitFn || ((code: number) => { process.exitCode = code; });
+  const rootDir = opts.rootDir || process.cwd();
+
+  const loaded = loadWorkflowConfig(rootDir);
+  if (!loaded.found) {
+    logFn(fmt.status('INFO', 'No workflow.config.json found — showing built-in defaults.'));
+  } else if (loaded.parseError) {
+    errorFn(fmt.status('FAIL', `workflow.config.json is invalid JSON (${/** @type{Error} */(loaded.parseError).message}); showing fallback built-in defaults.`));
+    logFn(JSON.stringify(loadEffectiveConfig(rootDir), null, 2));
+    exitFn(1);
+    return;
+  } else {
+    const issues = validateWorkflowConfig(loaded.config);
+    if (issues.length > 0) {
+      errorFn(fmt.status('FAIL', `workflow.config.json is structurally invalid: ${issues.join('; ')}; showing fallback built-in defaults.`));
+      logFn(JSON.stringify(loadEffectiveConfig(rootDir), null, 2));
+      exitFn(1);
+      return;
+    }
+    logFn(fmt.status('INFO', `Effective config (built-in defaults + ${loaded.configPath}):`));
+  }
+
+  logFn(JSON.stringify(loadEffectiveConfig(rootDir), null, 2));
+}
+
+export = config;