@formigio/fazemos-cli 0.10.54 → 0.10.55

package/dist/index.js

@@ -5640,6 +5640,94 @@ pipelines
         process.exit(1);
     }
 });
+// ── OPERATOR-RECOVERY-BUNDLE — `pl reconcile <instanceId>` ──
+// Idempotent operator-safe healing command (spec §2).
+// Re-runs the DAG resolver, detects stranded steps (queued/in_progress with
+// no live execution), gates through canLaunch, re-launches eligible ones,
+// and returns a structured JSON report (launched, skipped, stalled).
+//
+//   POST /api/pipeline-instances/:id/reconcile
+//   Auth: owner or admin only
+//
+// Distinct from pl rematerialize (P-TOOL-1): rematerialize rebases onto the
+// TEMPLATE (schema/content-side); reconcile re-launches missing EXECUTIONS on
+// the instance as-is (runtime-side only). Different jobs kept separate.
+pipelines
+    .command('reconcile')
+    .description('Idempotent operator recovery: re-runs the DAG resolver, detects stranded steps ' +
+    '(queued/in_progress with no live execution), and re-launches eligible ones. ' +
+    'Safe to run multiple times — the second call fires nothing if the first succeeded. ' +
+    'Owner/admin only. Distinct from rematerialize: this heals EXECUTIONS, not the template schema.')
+    .argument('<instanceId>', 'Pipeline instance ID')
+    .option('--json', 'Print the raw API response as JSON (machine-readable)')
+    .action(async (instanceId, opts) => {
+    try {
+        const path = `/api/pipeline-instances/${instanceId}/reconcile`;
+        const data = (await api('POST', path, {}));
+        if (opts.json) {
+            console.log(JSON.stringify(data, null, 2));
+            return;
+        }
+        // Human-readable reconcile report
+        const reconciledAt = data?.reconciled_at ? new Date(data.reconciled_at).toLocaleString() : 'unknown';
+        console.log(chalk.bold(`Reconcile — instance ${instanceId}`));
+        console.log(chalk.gray(`  Reconciled at : ${reconciledAt}`));
+        console.log(chalk.gray(`  DAG resolver  : ${data?.dag_resolver_ran ? 'ran' : 'skipped'}`));
+        console.log(chalk.gray(`  Steps verified: ${data?.steps_verified ?? 0}`));
+        console.log();
+        // Launched
+        const launched = Array.isArray(data?.launched) ? data.launched : [];
+        if (launched.length > 0) {
+            console.log(chalk.green(`  Launched (${launched.length}):`));
+            for (const s of launched) {
+                console.log(chalk.green(`    ✓ ${s.step_name} (${s.step_id}) → execution ${s.execution_id}` +
+                    (s.assigned_to ? ` [agent: ${s.assigned_to}]` : '')));
+            }
+        }
+        else {
+            console.log(chalk.gray('  Launched: (none)'));
+        }
+        // Skipped (canLaunch=false due to pause/budget/fan-out)
+        const skipped = Array.isArray(data?.skipped) ? data.skipped : [];
+        if (skipped.length > 0) {
+            console.log(chalk.yellow(`\n  Skipped — canLaunch blocked (${skipped.length}):`));
+            for (const s of skipped) {
+                console.log(chalk.yellow(`    ⚠ ${s.step_name} (${s.step_id}) [${s.reason}]: ${s.detail}`));
+            }
+        }
+        // Stalled (governance signal — queued, no execution, canLaunch=false for other reason)
+        const stalled = Array.isArray(data?.stalled) ? data.stalled : [];
+        if (stalled.length > 0) {
+            console.log(chalk.red(`\n  Stalled — governance signal (${stalled.length}):`));
+            for (const s of stalled) {
+                console.log(chalk.red(`    ✗ ${s.step_name} (${s.step_id}) [status: ${s.status}]: ${s.detail}`));
+            }
+        }
+        console.log();
+        if (launched.length === 0 && skipped.length === 0 && stalled.length === 0) {
+            console.log(chalk.green('No stranded steps found — instance is healthy.'));
+        }
+        else {
+            const summary = [];
+            if (launched.length > 0)
+                summary.push(chalk.green(`${launched.length} launched`));
+            if (skipped.length > 0)
+                summary.push(chalk.yellow(`${skipped.length} skipped`));
+            if (stalled.length > 0)
+                summary.push(chalk.red(`${stalled.length} stalled`));
+            console.log(`Summary: ${summary.join(', ')}`);
+        }
+    }
+    catch (err) {
+        // 403 owner/admin gate
+        if (err instanceof ApiError && err.status === 403) {
+            console.error(chalk.red(`Permission denied: ${err.message}`));
+            process.exit(1);
+        }
+        console.error(chalk.red(err.message));
+        process.exit(1);
+    }
+});
 pipelines
     .command('set-params')
     .description('Set instance parameters (atomic update)')