dev-harness-cli 1.1.0 → 2.1.0

package/cli/commands/checkpoint.mjs

@@ -9,7 +9,7 @@
  * save named recovery points (e.g. "before-refactor") that appear
  * in `rollback list` and can be used with `rollback to/branch`.
  *
- * Usage: harness-dev checkpoint create <label>
+ * Usage: dev-harness checkpoint create <label>
  */
 import { die, CliError, EXIT } from '../lib/errors.mjs';
 import { execGit, getGitRoot, gitTagExists, createGitTag } from '../lib/git.mjs';
@@ -21,7 +21,7 @@ export default async function checkpointCommand(args) {
   const label = args.positionals[0];
 
   if (sub !== 'create' || !label) {
-    die(new CliError('Usage: harness-dev checkpoint create <label> [--force]', EXIT.USAGE_ERROR), json);
+    die(new CliError('Usage: dev-harness checkpoint create <label> [--force]', EXIT.USAGE_ERROR), json);
     return;
   }
 

package/cli/commands/config.mjs

@@ -4,16 +4,16 @@
  * Uses state.mjs for dot-notation read/write with persistence.
  *
  * Usage:
- *   harness-dev config list              — list all parameters with descriptions
- *   harness-dev config get [key]         — get a value or all config
- *   harness-dev config set <key> <value> — set a value
+ *   dev-harness config list              — list all parameters with descriptions
+ *   dev-harness config get [key]         — get a value or all config
+ *   dev-harness config set <key> <value> — set a value
  *
  * Examples:
- *   harness-dev config list
- *   harness-dev config list --json
- *   harness-dev config get gates.enabled
- *   harness-dev config set gates.enabled true
- *   harness-dev config set maxRetries 5
+ *   dev-harness config list
+ *   dev-harness config list --json
+ *   dev-harness config get gates.enabled
+ *   dev-harness config set gates.enabled true
+ *   dev-harness config set maxRetries 5
  */
 import { resolve } from 'node:path';
 import { die, CliError, EXIT } from '../lib/errors.mjs';
@@ -29,7 +29,7 @@ export default async function configCommand(args) {
 
   if (!sub || (sub !== 'get' && sub !== 'set' && sub !== 'list')) {
     die(new CliError(
-      'Usage: harness-dev config list | config get [key] | config set <key> <value>',
+      'Usage: dev-harness config list | config get [key] | config set <key> <value>',
       EXIT.USAGE_ERROR,
     ), json);
     return;
@@ -75,7 +75,7 @@ export default async function configCommand(args) {
     // Human output — grouped table
     process.stdout.write('═══ Harness Configuration ═══\n\n');
     if (!ok) {
-      process.stdout.write('  No harness/config.json found. Run: harness-dev init\n\n');
+      process.stdout.write('  No harness/config.json found. Run: dev-harness init\n\n');
       return;
     }
 
@@ -102,7 +102,7 @@ export default async function configCommand(args) {
       process.stdout.write('\n');
     }
 
-    process.stdout.write('Edit with: harness-dev config set <key> <value>\n');
+    process.stdout.write('Edit with: dev-harness config set <key> <value>\n');
     process.stdout.write('Full docs: docs/CONFIGURATION.md\n');
     return;
   }
@@ -141,7 +141,7 @@ export default async function configCommand(args) {
   if (sub === 'set') {
     if (pos.length < 2) {
       die(new CliError(
-        'Usage: harness-dev config set <key> <value>\n' +
+        'Usage: dev-harness config set <key> <value>\n' +
         '  String values: config set mode copilot\n' +
         '  Boolean values: config set gates.enabled true\n' +
         '  Numeric values: config set maxRetries 5',

package/cli/commands/contract.mjs

@@ -4,10 +4,10 @@
  * Manages the generator-evaluator agreement loop.
  *
  * Usage:
- *   harness-dev contract propose [--scope "msg"] [--exclusions "msg"]
- *   harness-dev contract review [--agreed|--needs-revision]
- *   harness-dev contract status
- *   harness-dev contract escalate [--reason "msg"]
+ *   dev-harness contract propose [--scope "msg"] [--exclusions "msg"]
+ *   dev-harness contract review [--agreed|--needs-revision]
+ *   dev-harness contract status
+ *   dev-harness contract escalate [--reason "msg"]
  */
 import { resolve } from 'node:path';
 import { die, CliError, EXIT } from '../lib/errors.mjs';
@@ -22,7 +22,7 @@ export default async function contractCommand(args) {
   const sub = args.subcommand;
 
   if (!sub || !SUBCOMMANDS.includes(sub)) {
-    die(new CliError(`Usage: harness-dev contract ${SUBCOMMANDS.join('|')}`, EXIT.USAGE_ERROR), json);
+    die(new CliError(`Usage: dev-harness contract ${SUBCOMMANDS.join('|')}`, EXIT.USAGE_ERROR), json);
     return;
   }
 
@@ -34,7 +34,7 @@ export default async function contractCommand(args) {
 
     if (!scope) {
       die(new CliError(
-        'Usage: harness-dev contract propose --scope "I will build X" [--exclusions "W"] [--criteria "test1|test2"]',
+        'Usage: dev-harness contract propose --scope "I will build X" [--exclusions "W"] [--criteria "test1|test2"]',
         EXIT.USAGE_ERROR,
       ), json);
       return;
@@ -53,7 +53,7 @@ export default async function contractCommand(args) {
     }
 
     if (result.ok) {
-      process.stdout.write('✓ Contract proposed. Run: harness-dev contract review\n');
+      process.stdout.write('✓ Contract proposed. Run: dev-harness contract review\n');
     } else {
       process.stderr.write(`✗ ${result.error}\n`);
     }
@@ -68,7 +68,7 @@ export default async function contractCommand(args) {
 
     if (!agreed && !needsRevision) {
       die(new CliError(
-        'Usage: harness-dev contract review --agreed [--notes "msg"]  OR  --needs-revision [--notes "msg"]',
+        'Usage: dev-harness contract review --agreed [--notes "msg"]  OR  --needs-revision [--notes "msg"]',
         EXIT.USAGE_ERROR,
       ), json);
       return;
@@ -116,7 +116,7 @@ export default async function contractCommand(args) {
         rounds,
         message: status
           ? `Contract ${status} (round ${rounds}/5)`
-          : 'No sprint-contract.md found. Run: harness-dev contract propose',
+          : 'No sprint-contract.md found. Run: dev-harness contract propose',
       }) + '\n');
       return;
     }
@@ -124,7 +124,7 @@ export default async function contractCommand(args) {
     if (status) {
       process.stdout.write(`Contract status: ${status} (round ${rounds}/5)\n`);
     } else {
-      process.stdout.write('No sprint-contract.md found. Run: harness-dev contract propose\n');
+      process.stdout.write('No sprint-contract.md found. Run: dev-harness contract propose\n');
     }
     return;
   }

package/cli/commands/detect-tool.mjs

@@ -12,7 +12,7 @@
  * Also reads harness-config.json agentTool field if present.
  *
  * Usage:
- *   harness-dev detect-tool [--target <dir>] [--json]
+ *   dev-harness detect-tool [--target <dir>] [--json]
  */
 import { existsSync } from 'node:fs';
 import { resolve } from 'node:path';
@@ -80,7 +80,7 @@ export default async function detectToolCommand(args) {
     status: 'ok',
     message: detected.length > 0
       ? `Detected ${detected.length} agent tool(s): ${detected.join(', ')}`
-      : 'No agent tools detected. Run: harness-dev init',
+      : 'No agent tools detected. Run: dev-harness init',
     available: detected,
     configured: configuredTool,
     recommended,
@@ -104,7 +104,7 @@ export default async function detectToolCommand(args) {
     }
   } else {
     emitHuman(`  No agent tools detected.\n`);
-    emitHuman(`  Run: harness-dev init to scaffold a project.\n`);
+    emitHuman(`  Run: dev-harness init to scaffold a project.\n`);
   }
   if (hasAgentsMd) {
     emitHuman(`\n  AGENTS.md present — tools that read it natively are available.\n`);

package/cli/commands/init.mjs

@@ -6,7 +6,7 @@
  * init.sh, progress.md, sprint-contract.md) plus project files (feature_list.json,
  * feature-list.schema.json, session-handoff.md, etc.), git init, .gitignore.
  *
- * Usage: harness-dev init [--stack <name>] [--target <dir>] [--agent-tool <name>] [--force] [--no-git] [--json]
+ * Usage: dev-harness init [--stack <name>] [--target <dir>] [--agent-tool <name>] [--force] [--no-git] [--json]
  */
 import { resolve, join } from 'node:path';
 import {

package/cli/commands/learn.mjs

@@ -2,8 +2,8 @@
  * learn — Append a lesson to progress.md.
  *
  * Usage:
- *   harness-dev learn "Lesson text here"
- *   harness-dev learn "Lesson text" --json
+ *   dev-harness learn "Lesson text here"
+ *   dev-harness learn "Lesson text" --json
  */
 import { CliError, EXIT, die } from '../lib/errors.mjs';
 import { appendLesson } from '../lib/progress.mjs';
@@ -17,7 +17,7 @@ export default async function learnCommand(args) {
   if (!message) {
     die(
       new CliError(
-        'Lesson message required.\n  Example: harness-dev learn "Token refresh gotcha — accepts access_token in body"',
+        'Lesson message required.\n  Example: dev-harness learn "Token refresh gotcha — accepts access_token in body"',
         EXIT.USAGE_ERROR,
       ),
       json,

package/cli/commands/pause.mjs

@@ -4,7 +4,7 @@
  * Sets config.paused = true. The outer loop checks this
  * before starting a new phase in autopilot mode.
  *
- * Usage: harness-dev pause [--json]
+ * Usage: dev-harness pause [--json]
  */
 import { set } from '../lib/state.mjs';
 import { parseCommandArgs } from '../lib/command-helpers.mjs';

package/cli/commands/phase.mjs

@@ -5,8 +5,8 @@
  * then triggers the outer loop for autopilot advancement.
  *
  * Usage:
- *   harness-dev phase <name>
- *   harness-dev phase <name> --json
+ *   dev-harness phase <name>
+ *   dev-harness phase <name> --json
  */
 import { CliError, EXIT, die } from '../lib/errors.mjs';
 import { transitionPhase, getPhaseOrder, loadConfig } from '../lib/state.mjs';
@@ -51,7 +51,7 @@ export default async function phaseCommand(args) {
   const { config: preConfig, ok: preOk } = loadConfig(targetDir);
   const preMode = preOk ? (preConfig.mode ?? 'copilot') : 'copilot';
   if (preOk && preConfig.paused && preMode === 'autopilot') {
-    const msg = 'Pipeline is paused. Run: harness-dev resume';
+    const msg = 'Pipeline is paused. Run: dev-harness resume';
     if (json) {
       process.stdout.write(JSON.stringify({
         command: 'phase',
@@ -140,11 +140,11 @@ export default async function phaseCommand(args) {
       if (pipelineResult.status === 'complete') {
         process.stdout.write(`\n✓ Pipeline complete. All phases done.\n`);
       } else if (pipelineResult.status === 'instruction') {
-        process.stdout.write(`\nNext: harness-dev phase ${pipelineResult.nextPhase}\n`);
+        process.stdout.write(`\nNext: dev-harness phase ${pipelineResult.nextPhase}\n`);
       }
     } else if (nextPhase) {
       // Copilot: print next step
-      process.stdout.write(`Next: harness-dev phase ${nextPhase}\n`);
+      process.stdout.write(`Next: dev-harness phase ${nextPhase}\n`);
       // Auto-prompt: controlled by two independent flags:
       //   autoPrompt=true  → show the prompt
       //   confirmGates=true → require y/n answer before continuing
@@ -158,7 +158,7 @@ export default async function phaseCommand(args) {
               process.stdout.write(`\n✓ Pipeline complete. All phases done.\n`);
             }
           } else if (answer === false) {
-            process.stdout.write(`  Staying in ${phase.toUpperCase()}. Run: harness-dev phase ${nextPhase} when ready.\n`);
+            process.stdout.write(`  Staying in ${phase.toUpperCase()}. Run: dev-harness phase ${nextPhase} when ready.\n`);
           }
           // null = no TTY, skipped
         } else {

package/cli/commands/resume.mjs

@@ -3,7 +3,7 @@
  *
  * Sets config.paused = false. Allows autopilot to continue.
  *
- * Usage: harness-dev resume [--json]
+ * Usage: dev-harness resume [--json]
  */
 import { set } from '../lib/state.mjs';
 import { parseCommandArgs } from '../lib/command-helpers.mjs';
@@ -19,14 +19,14 @@ export default async function resumeCommand(args) {
       command: 'resume',
       status: result.ok ? 'ok' : 'error',
       message: result.ok
-        ? 'Pipeline resumed. Run: harness-dev phase <name> to continue.'
+        ? 'Pipeline resumed. Run: dev-harness phase <name> to continue.'
         : (result.error || 'Failed to resume'),
     });
     return;
   }
 
   if (result.ok) {
-    emitHuman('✓ Pipeline resumed. Run: harness-dev phase <name> to continue.\n');
+    emitHuman('✓ Pipeline resumed. Run: dev-harness phase <name> to continue.\n');
   } else {
     emitHumanError(`✗ ${result.error}\n`);
   }

package/cli/commands/rollback.mjs

@@ -13,7 +13,7 @@
  *   manual/<label>   — User-created manual checkpoints
  *   recovery/*       — Recovery branches (for informational display)
  *
- * Usage: harness-dev rollback <subcommand> [checkpoint]
+ * Usage: dev-harness rollback <subcommand> [checkpoint]
  */
 import { die, CliError, EXIT } from '../lib/errors.mjs';
 import { execGit, getGitRoot } from '../lib/git.mjs';
@@ -67,12 +67,12 @@ export default async function rollbackCommand(args) {
   const sub = args.subcommand;
 
   if (!sub || !SUBCOMMANDS.includes(sub)) {
-    die(new CliError(`Usage: harness-dev rollback ${SUBCOMMANDS.join('|')}`, EXIT.USAGE_ERROR), json);
+    die(new CliError(`Usage: dev-harness rollback ${SUBCOMMANDS.join('|')}`, EXIT.USAGE_ERROR), json);
     return;
   }
 
   if (sub !== 'list' && args.positionals.length < 1) {
-    die(new CliError(`Usage: harness-dev rollback ${sub} <checkpoint>`, EXIT.USAGE_ERROR), json);
+    die(new CliError(`Usage: dev-harness rollback ${sub} <checkpoint>`, EXIT.USAGE_ERROR), json);
     return;
   }
 
@@ -118,7 +118,7 @@ export default async function rollbackCommand(args) {
     } else {
       if (checkpoints.length === 0 && recoveryBranches.length === 0) {
         process.stdout.write('No checkpoints found. Phase tags (phase/*) and iteration tags (iter/*) are created automatically when auto-tagging is enabled.\n');
-        process.stdout.write('Manual checkpoints: harness-dev checkpoint create <label>\n');
+        process.stdout.write('Manual checkpoints: dev-harness checkpoint create <label>\n');
       } else {
         if (checkpoints.length > 0) {
           process.stdout.write('Checkpoints:\n');
@@ -146,7 +146,7 @@ export default async function rollbackCommand(args) {
     // Verify the tag exists
     const tagCheck = execGit(`git rev-parse --verify "${checkpoint}^{commit}"`, gitRoot);
     if (!tagCheck.ok) {
-      const msg = `Checkpoint "${checkpoint}" not found. Run: harness-dev rollback list`;
+      const msg = `Checkpoint "${checkpoint}" not found. Run: dev-harness rollback list`;
       if (json) {
         process.stdout.write(JSON.stringify({ command: 'rollback', subcommand: 'to', checkpoint, status: 'error', message: msg }) + '\n');
       } else {
@@ -205,7 +205,7 @@ export default async function rollbackCommand(args) {
     // Verify the tag exists
     const tagCheck = execGit(`git rev-parse --verify "${checkpoint}^{commit}"`, gitRoot);
     if (!tagCheck.ok) {
-      const msg = `Checkpoint "${checkpoint}" not found. Run: harness-dev rollback list`;
+      const msg = `Checkpoint "${checkpoint}" not found. Run: dev-harness rollback list`;
       if (json) {
         process.stdout.write(JSON.stringify({ command: 'rollback', subcommand: 'branch', checkpoint, status: 'error', message: msg }) + '\n');
       } else {

package/cli/commands/set-mode.mjs

@@ -1,10 +1,10 @@
 /**
  * set-mode — Switch between copilot and autopilot.
  *
- * Usage: harness-dev set-mode <mode>
- *   harness-dev set-mode autopilot
- *   harness-dev set-mode copilot
- *   harness-dev set-mode autopilot --json
+ * Usage: dev-harness set-mode <mode>
+ *   dev-harness set-mode autopilot
+ *   dev-harness set-mode copilot
+ *   dev-harness set-mode autopilot --json
  */
 import { die, CliError, EXIT } from '../lib/errors.mjs';
 import { set, loadConfig, getPhaseOrder } from '../lib/state.mjs';
@@ -19,7 +19,7 @@ export default async function setModeCommand(args) {
   if (!mode || !valid.includes(mode)) {
     die(
       new CliError(
-        `Mode required. Valid: ${valid.join(', ')}.\n  Example: harness-dev set-mode autopilot`,
+        `Mode required. Valid: ${valid.join(', ')}.\n  Example: dev-harness set-mode autopilot`,
         EXIT.USAGE_ERROR,
       ),
       json,

package/cli/commands/status.mjs

@@ -4,7 +4,7 @@
  * Reads harness-config.json via state.mjs for live project state,
  * plus runs stack detection and gate checks for current status.
  *
- * Usage: harness-dev status [--json] [--target <dir>]
+ * Usage: dev-harness status [--json] [--target <dir>]
  */
 import { resolve, basename } from 'node:path';
 import { detectStack } from '../lib/detect-stack.mjs';
@@ -61,7 +61,7 @@ export default async function statusCommand(args) {
       status: 'ok',
       message: configOk
         ? `Phase: ${phase || 'not started'}, Stack: ${stack.label}`
-        : 'No harness/config.json found — run harness-dev init',
+        : 'No harness/config.json found — run dev-harness init',
       project: basename(targetDir),
       stack: stack.name,
       stackLabel: stack.label,
@@ -150,19 +150,19 @@ function gateStatusLabel(status, passing, total) {
 
 function determineNextAction(targetDir, configOk, config, phase, gateStatus) {
   if (!configOk) {
-    return 'Run: harness-dev init';
+    return 'Run: dev-harness init';
   }
   if (!phase) {
-    return 'Run: harness-dev phase define to start';
+    return 'Run: dev-harness phase define to start';
   }
   if (gateStatus === 'fail') {
-    return 'Run: harness-dev validate to re-check';
+    return 'Run: dev-harness validate to re-check';
   }
   // Determine next phase
   const order = ['define', 'plan', 'build', 'verify', 'review', 'ship'];
   const idx = order.indexOf(phase);
   if (idx >= 0 && idx < order.length - 1) {
-    return `Run: harness-dev phase ${order[idx + 1]}`;
+    return `Run: dev-harness phase ${order[idx + 1]}`;
   }
-  return `Run: harness-dev validate`;
+  return `Run: dev-harness validate`;
 }

package/cli/commands/validate.mjs

@@ -5,15 +5,15 @@
  * Otherwise runs phase-specific checks and reports results.
  *
  * Usage:
- *   harness-dev validate              — check current phase
- *   harness-dev validate --json       — machine-readable output
- *   harness-dev validate --phase X    — check specific phase
+ *   dev-harness validate              — check current phase
+ *   dev-harness validate --json       — machine-readable output
+ *   dev-harness validate --phase X    — check specific phase
  *
  * Examples:
- *   harness-dev validate
+ *   dev-harness validate
  *   # → BUILD Gate: PASS — 3/3 checks pass
  *
- *   harness-dev validate --json
+ *   dev-harness validate --json
  *   # → {"phase":"build","checks":[...],"overall":false,"failures":["lint"]}
  */
 import { resolve } from 'node:path';
@@ -53,7 +53,7 @@ export default async function validateCommand(args) {
       if (task) { out.task = task; }
       process.stdout.write(JSON.stringify(out) + '\n');
     } else {
-      process.stdout.write('Gates disabled. Enable with: harness-dev config set gates.enabled true\n');
+      process.stdout.write('Gates disabled. Enable with: dev-harness config set gates.enabled true\n');
     }
     return;
   }
@@ -62,7 +62,7 @@ export default async function validateCommand(args) {
   if (!phase) {
     die(
       new CliError(
-        'No phase found in config. Run: harness-dev init or harness-dev phase <name>',
+        'No phase found in config. Run: dev-harness init or dev-harness phase <name>',
         EXIT.VALIDATION_FAILURE,
       ),
       json,

package/cli/commands/worktree.mjs

@@ -8,7 +8,7 @@
  *   prune           — git worktree prune (remove orphaned metadata)
  *   remove <name>   — git worktree remove + optionally delete branch
  *
- * Usage: harness-dev worktree <subcommand> [name] [options]
+ * Usage: dev-harness worktree <subcommand> [name] [options]
  */
 import { existsSync } from 'node:fs';
 import { resolve, dirname } from 'node:path';
@@ -25,13 +25,13 @@ export default async function worktreeCommand(args) {
   const sub = args.subcommand;
 
   if (!sub || !SUBCOMMANDS.includes(sub)) {
-    die(new CliError(`Usage: harness-dev worktree ${SUBCOMMANDS.join('|')}`, EXIT.USAGE_ERROR), json);
+    die(new CliError(`Usage: dev-harness worktree ${SUBCOMMANDS.join('|')}`, EXIT.USAGE_ERROR), json);
     return;
   }
 
   const gitRoot = getGitRoot(targetDir);
   if (!gitRoot) {
-    const msg = 'Not inside a git repository. Run: git init first or harness-dev init';
+    const msg = 'Not inside a git repository. Run: git init first or dev-harness init';
     if (json) {
       process.stdout.write(JSON.stringify({ command: 'worktree', subcommand: sub, status: 'error', message: msg }) + '\n');
     } else {
@@ -44,7 +44,7 @@ export default async function worktreeCommand(args) {
   if (sub === 'create') {
     const name = args.positionals[0];
     if (!name) {
-      die(new CliError('Usage: harness-dev worktree create <name>', EXIT.USAGE_ERROR), json);
+      die(new CliError('Usage: dev-harness worktree create <name>', EXIT.USAGE_ERROR), json);
       return;
     }
 
@@ -88,7 +88,7 @@ export default async function worktreeCommand(args) {
 
     // Scaffold harness in the new worktree — run full init with parent's detected stack
     const stack = detectStack(worktreePath).name;
-    const harnessDevPath = new URL('../harness-dev.mjs', import.meta.url).pathname;
+    const harnessDevPath = new URL('../dev-harness.mjs', import.meta.url).pathname;
     const initResult = execGit(
       `node "${harnessDevPath}" init --stack "${stack}" --force --no-git --json`,
       worktreePath,
@@ -232,7 +232,7 @@ export default async function worktreeCommand(args) {
   if (sub === 'remove') {
     const name = args.positionals[0];
     if (!name) {
-      die(new CliError('Usage: harness-dev worktree remove <name>', EXIT.USAGE_ERROR), json);
+      die(new CliError('Usage: dev-harness worktree remove <name>', EXIT.USAGE_ERROR), json);
       return;
     }
 

package/cli/{harness-dev.mjs → dev-harness.mjs}

@@ -1,6 +1,6 @@
 #!/usr/bin/env node
 /**
- * harness-dev — Agent-agnostic development harness CLI.
+ * dev-harness — Agent-agnostic development harness CLI.
  *
  * Entry point. Parses args, routes to command handler,
  * formats output (human or JSON), handles errors.
@@ -68,7 +68,7 @@ async function main() {
   const loader = COMMANDS[args.command];
   if (!loader) {
     throw new CliError(
-      `Unknown command "${args.command}". See harness-dev --help`,
+      `Unknown command "${args.command}". See dev-harness --help`,
       EXIT.USAGE_ERROR
     );
   }

package/cli/lib/config-registry.mjs

@@ -3,7 +3,7 @@
  *
  * Single source of truth for parameter descriptions, types, allowed values,
  * and defaults. Used by:
- *   - `harness-dev config list` — interactive parameter listing
+ *   - `dev-harness config list` — interactive parameter listing
  *   - docs/CONFIGURATION.md — generated documentation
  *   - config command — validation of set values
  *
@@ -198,7 +198,7 @@ export const CONFIG_PARAMS = [
     group: 'Runtime State',
     label: 'Current Phase',
     type: 'string',
-    description: 'Current pipeline phase. Managed by harness-dev phase — do not edit.',
+    description: 'Current pipeline phase. Managed by dev-harness phase — do not edit.',
     default: null,
     editable: false,
   },

package/cli/lib/constants.mjs

@@ -8,8 +8,11 @@
  *   import { GATE_TIMEOUT, COVERAGE_TIMEOUT, MAX_NEGOTIATION_ROUNDS } from './constants.mjs';
  */
 
-/** Default max retries per phase before escalating to human. */
-export const DEFAULT_MAX_RETRIES = 3;
+/** Default max retries per task before escalating to human.
+ *  Retry scope is per-task (not per-phase) — each task gets its own retry budget.
+ *  Configurable via: dev-harness config set maxRetries <N>
+ */
+export const DEFAULT_MAX_RETRIES = 10;
 
 /** Timeout (ms) for standard git/shell commands. */
 export const COMMAND_TIMEOUT = 30000;
@@ -28,3 +31,17 @@ export const STACK_SCAN_DEPTH = 2;
 
 /** File mode for executable scripts (init.sh). */
 export const EXECUTABLE_MODE = 0o755;
+
+// ── Supervisor / Orchestrator constants ─────────────────────────────────────
+
+/** Default max API retry attempts before pausing pipeline. */
+export const API_MAX_RETRIES = 5;
+
+/** Base backoff delay in ms for API retries (exponential: 60s, 120s, 240s, ...). */
+export const API_BACKOFF_MS = 60000;
+
+/** Supervisor heartbeat interval in ms. */
+export const SUPERVISOR_INTERVAL_MS = 60000;
+
+/** Max heartbeat staleness before stall detection (5 min). */
+export const SUPERVISOR_MAX_STALLS = 3;

package/cli/lib/contract.mjs

@@ -168,7 +168,7 @@ ${existingStatus || `## Agreement Status
 export function reviewContract(targetDir, decision, notes) {
   const path = CONTRACT_PATH(targetDir);
   if (!existsSync(path)) {
-    return { ok: false, error: 'No sprint-contract.md found. Run: harness-dev contract propose first', escalated: false };
+    return { ok: false, error: 'No sprint-contract.md found. Run: dev-harness contract propose first', escalated: false };
   }
 
   try {
@@ -276,7 +276,7 @@ export function validateContract(targetDir) {
     return {
       name: 'contract-agreed',
       pass: false,
-      detail: 'Sprint contract not yet proposed. Run: harness-dev contract propose',
+      detail: 'Sprint contract not yet proposed. Run: dev-harness contract propose',
     };
   }
 
@@ -301,6 +301,6 @@ export function validateContract(targetDir) {
   return {
     name: 'contract-agreed',
     pass: false,
-    detail: `Sprint contract ${noun} (round ${rounds}/${MAX_NEGOTIATION_ROUNDS}). Run: harness-dev contract review`,
+    detail: `Sprint contract ${noun} (round ${rounds}/${MAX_NEGOTIATION_ROUNDS}). Run: dev-harness contract review`,
   };
 }

package/cli/lib/gates.mjs

@@ -5,7 +5,7 @@
  * that return { name, pass, detail }.
  *
  * Phase gates are disabled by default (gates.enabled: false).
- * Run via: harness-dev validate
+ * Run via: dev-harness validate
  *
  * Usage:
  *   import { runChecks, getPhase } from './gates.mjs';