@mytegroupinc/myte-core 0.0.28 → 0.0.29

package/scripts/mission-live-full-harness.js

@@ -1,832 +1,832 @@
-#!/usr/bin/env node
-"use strict";
-
-const fs = require("node:fs");
-const os = require("node:os");
-const path = require("node:path");
-const { spawnSync } = require("node:child_process");
-
-const CLI_PATH = path.resolve(__dirname, "..", "cli.js");
-const DEFAULT_BASE_URL = "https://api.myte.dev/api";
-
-function parseArgs(argv) {
-  const args = { _: [] };
-  for (let index = 0; index < argv.length; index += 1) {
-    const token = argv[index];
-    if (!token.startsWith("--")) {
-      args._.push(token);
-      continue;
-    }
-    const key = token.slice(2);
-    const next = argv[index + 1];
-    if (!next || next.startsWith("--")) {
-      args[key] = true;
-      continue;
-    }
-    args[key] = next;
-    index += 1;
-  }
-  return args;
-}
-
-function loadEnvFromNearest(startDir) {
-  let cur = startDir;
-  for (let index = 0; index < 8; index += 1) {
-    const filePath = path.join(cur, ".env");
-    if (fs.existsSync(filePath)) {
-      for (const line of fs.readFileSync(filePath, "utf8").split(/\r?\n/)) {
-        const trimmed = String(line || "").trim();
-        if (!trimmed || trimmed.startsWith("#")) continue;
-        const splitAt = trimmed.indexOf("=");
-        if (splitAt <= 0) continue;
-        const key = trimmed.slice(0, splitAt).trim();
-        let value = trimmed.slice(splitAt + 1).trim();
-        if ((value.startsWith('"') && value.endsWith('"')) || (value.startsWith("'") && value.endsWith("'"))) {
-          value = value.slice(1, -1);
-        }
-        if (key && process.env[key] === undefined) process.env[key] = value;
-      }
-      return filePath;
-    }
-    const parent = path.dirname(cur);
-    if (parent === cur) break;
-    cur = parent;
-  }
-  return null;
-}
-
-function nowId() {
-  return new Date().toISOString().replace(/[^0-9A-Za-z]+/g, "-").replace(/^-|-$/g, "");
-}
-
-function ensureDir(dirPath) {
-  fs.mkdirSync(dirPath, { recursive: true });
-}
-
-function writeJson(dirPath, name, payload) {
-  ensureDir(dirPath);
-  const filePath = path.join(dirPath, name);
-  fs.writeFileSync(filePath, JSON.stringify(payload, null, 2), "utf8");
-  return filePath;
-}
-
-function normalizeBaseUrl(value) {
-  const raw = String(value || DEFAULT_BASE_URL).replace(/\/+$/, "");
-  return raw.endsWith("/api") ? raw : `${raw}/api`;
-}
-
-function getProjectKey() {
-  return process.env.MYTE_API_KEY || process.env.MYTE_PROJECT_API_KEY || "";
-}
-
-function stableScenarioList(raw, confirmLive) {
-  if (raw) {
-    return String(raw)
-      .split(",")
-      .map((item) => item.trim())
-      .filter(Boolean);
-  }
-  if (!confirmLive) return ["preflight", "contracts"];
-  return [
-    "preflight",
-    "contracts",
-    "suggestion_update_loop",
-    "create_reject_loop",
-    "archive_route_probe",
-    "approved_lifecycle",
-    "batch_limits",
-    "batch_mutation",
-    "qaqc",
-  ];
-}
-
-function commandForPlatform(command) {
-  if (process.platform !== "win32") return command;
-  if (command.endsWith(".cmd") || command.endsWith(".exe")) return command;
-  return `${command}.cmd`;
-}
-
-function cliInvocation(args, cliMode, packageVersion) {
-  if (cliMode === "global") return { command: commandForPlatform("myte"), args };
-  if (cliMode === "npx") return { command: commandForPlatform("npx"), args: ["--yes", `myte@${packageVersion}`, ...args] };
-  return { command: process.execPath, args: [CLI_PATH, ...args] };
-}
-
-function commandText(invocation) {
-  return [invocation.command, ...invocation.args].join(" ");
-}
-
-function runCli(cliArgs, options = {}) {
-  const {
-    workspace,
-    baseUrl,
-    actorScope,
-    expectFailure = false,
-    parseJson = true,
-    cliMode = "local",
-    packageVersion = "latest",
-    timeoutMs = 120000,
-  } = options;
-  const finalArgs = [...cliArgs];
-  if (actorScope) finalArgs.push("--actor-scope", actorScope);
-  if (baseUrl) finalArgs.push("--base-url", baseUrl);
-  const invocation = cliInvocation(finalArgs, cliMode, packageVersion);
-  const result = spawnSync(invocation.command, invocation.args, {
-    cwd: workspace || process.cwd(),
-    env: process.env,
-    encoding: "utf8",
-    shell: process.platform === "win32" && /\.(cmd|bat)$/i.test(invocation.command),
-    stdio: ["ignore", "pipe", "pipe"],
-    timeout: timeoutMs,
-  });
-  const stdout = String(result.stdout || "").trim();
-  const stderr = String(result.stderr || "").trim();
-  const ok = result.status === 0;
-  const processError = result.error ? String(result.error.message || result.error) : "";
-  if (expectFailure) {
-    if (ok) {
-      throw new Error(`Expected command to fail but it succeeded: ${commandText(invocation)}`);
-    }
-    return { ok: false, status: result.status, stdout, stderr, error: processError };
-  }
-  if (!ok) {
-    throw new Error([`Command failed: ${commandText(invocation)}`, processError || stderr || stdout || "(no output)"].join("\n"));
-  }
-  if (!parseJson) return { ok: true, stdout, stderr };
-  try {
-    return stdout ? JSON.parse(stdout) : {};
-  } catch (error) {
-    throw new Error(`Expected JSON from ${commandText(invocation)}:\n${stdout}`);
-  }
-}
-
-async function apiJson({ method = "GET", baseUrl, route, key, body, query, idempotencyKey }) {
-  const url = new URL(`${baseUrl}${route}`);
-  for (const [queryKey, queryValue] of Object.entries(query || {})) {
-    if (queryValue !== undefined && queryValue !== null && String(queryValue).trim() !== "") {
-      url.searchParams.set(queryKey, String(queryValue));
-    }
-  }
-  const headers = { Authorization: `Bearer ${key}` };
-  if (body !== undefined) headers["Content-Type"] = "application/json";
-  if (idempotencyKey) headers["X-Idempotency-Key"] = String(idempotencyKey);
-  const response = await fetch(url.toString(), {
-    method,
-    headers,
-    body: body === undefined ? undefined : JSON.stringify(body),
-  });
-  let payload = {};
-  try {
-    payload = await response.json();
-  } catch (_) {
-    payload = {};
-  }
-  return {
-    ok: response.ok && payload.status === "success",
-    statusCode: response.status,
-    message: payload.message || "",
-    data: payload.data || {},
-  };
-}
-
-function missionPublicId(mission) {
-  return String(mission?.mission_id || mission?.public_id || mission?.id || "").trim();
-}
-
-function missionTitle(mission) {
-  return String(mission?.title || "").trim();
-}
-
-function activeMissions(bootstrap) {
-  return (Array.isArray(bootstrap?.missions) ? bootstrap.missions : [])
-    .filter((mission) => missionPublicId(mission))
-    .filter((mission) => String(mission.status || "").toLowerCase() !== "archived")
-    .filter((mission) => mission.is_archived !== true);
-}
-
-function chooseStableMission(bootstrap) {
-  const missions = activeMissions(bootstrap);
-  return missions.find((mission) => !/^Disposable mission harness/i.test(missionTitle(mission))) || missions[0] || null;
-}
-
-function hasRunnableQaqcCases(mission) {
-  if (String(mission?.status || "").toLowerCase() === "done") return false;
-  const testCases = mission?.test_cases || {};
-  const success = Array.isArray(testCases.success) ? testCases.success : [];
-  const failure = Array.isArray(testCases.failure) ? testCases.failure : [];
-  return success.length > 0 || failure.length > 0;
-}
-
-function chooseQaqcMission(bootstrap) {
-  const missions = activeMissions(bootstrap).filter(hasRunnableQaqcCases);
-  return missions.find((mission) => !/^Disposable mission harness/i.test(missionTitle(mission))) || missions[0] || null;
-}
-
-function pickSuggestionId(output) {
-  for (const item of output.items || []) {
-    const suggestionId = item?.suggestion?.suggestion_id || item?.suggestion_id;
-    if (suggestionId) return String(suggestionId);
-  }
-  return "";
-}
-
-function pickAppliedMissionId(output) {
-  for (const item of output.items || []) {
-    const missionId = item?.applied_mission?.mission_id || item?.mission_id || item?.suggestion?.mission_id;
-    if (missionId) return String(missionId);
-  }
-  return "";
-}
-
-function threadRefs(snapshot) {
-  const refs = [];
-  for (const source of [snapshot?.queue, snapshot?.threads, snapshot?.suggestions]) {
-    if (!Array.isArray(source)) continue;
-    for (const item of source) {
-      refs.push({
-        suggestion_id: String(item?.suggestion_id || item?.id || "").trim(),
-        mission_id: String(item?.mission_id || "").trim(),
-        change_type: String(item?.change_type || "").trim(),
-        status: String(item?.status || item?.thread_status || "").trim(),
-      });
-    }
-  }
-  return refs.filter((item) => item.suggestion_id || item.mission_id);
-}
-
-function queueRefs(snapshot) {
-  return threadRefs({ queue: snapshot?.queue || [] });
-}
-
-function hasMissionInBootstrap(bootstrap, missionId) {
-  const target = String(missionId || "").toUpperCase();
-  return activeMissions(bootstrap).some((mission) => missionPublicId(mission).toUpperCase() === target);
-}
-
-function assertCondition(condition, message) {
-  if (!condition) throw new Error(message);
-}
-
-function safeResult(details = {}) {
-  return JSON.parse(JSON.stringify(details, (_key, value) => {
-    if (typeof value !== "string") return value;
-    if (value.includes("@")) return "[redacted]";
-    return value.length > 180 ? `${value.slice(0, 180)}...` : value;
-  }));
-}
-
-class Harness {
-  constructor(args) {
-    loadEnvFromNearest(process.cwd());
-    this.args = args;
-    this.confirmLive = args["confirm-live"] === true;
-    this.keepGoing = args["keep-going"] === true;
-    this.baseUrl = normalizeBaseUrl(args["base-url"] || process.env.MYTE_API_BASE_URL || DEFAULT_BASE_URL);
-    this.key = getProjectKey();
-    this.actorBase = String(args["actor-scope"] || `mission-live-full-${nowId()}`);
-    this.cliMode = String(args.cli || "local").toLowerCase();
-    this.packageVersion = String(args["package-version"] || "0.0.28");
-    this.batchSize = Math.max(1, Math.min(10, Number(args["batch-size"] || 10)));
-    this.includeQaqcRun = args["include-qaqc-run"] === true;
-    this.workspace = path.resolve(
-      args.workspace || fs.mkdtempSync(path.join(os.tmpdir(), "myte-mission-full-harness-")),
-    );
-    this.payloadDir = path.join(this.workspace, "payloads");
-    this.reportPath = path.resolve(args["report-file"] || path.join(this.workspace, "mission-live-full-report.json"));
-    this.scenarios = stableScenarioList(args.scenarios, this.confirmLive);
-    this.createdMissions = new Set();
-    this.openSuggestions = new Set();
-    this.archiveRouteAvailable = null;
-    this.report = {
-      status: "running",
-      generated_at: new Date().toISOString(),
-      base_url: this.baseUrl,
-      cli_mode: this.cliMode,
-      package_version: this.packageVersion,
-      workspace: this.workspace,
-      scenarios: [],
-      created_mission_ids: [],
-      open_suggestion_ids: [],
-      notes: [],
-    };
-  }
-
-  requireKey() {
-    if (!this.key) throw new Error("Missing MYTE_API_KEY or MYTE_PROJECT_API_KEY.");
-  }
-
-  requireLive(name) {
-    if (!this.confirmLive) {
-      throw new Error(`${name} requires --confirm-live because it mutates live project data.`);
-    }
-  }
-
-  cli(args, options = {}) {
-    return runCli(args, {
-      workspace: this.workspace,
-      baseUrl: this.baseUrl,
-      cliMode: this.cliMode,
-      packageVersion: this.packageVersion,
-      ...options,
-    });
-  }
-
-  cliWithActor(args, suffix, options = {}) {
-    return this.cli(args, {
-      actorScope: `${this.actorBase}-${suffix}`,
-      ...options,
-    });
-  }
-
-  async api(route, options = {}) {
-    return apiJson({
-      baseUrl: this.baseUrl,
-      key: this.key,
-      route,
-      ...options,
-    });
-  }
-
-  async bootstrap() {
-    const response = await this.api("/project-assistant/bootstrap");
-    if (!response.ok) throw new Error(`Bootstrap API failed (${response.statusCode}): ${response.message}`);
-    return response.data;
-  }
-
-  async suggestions(actorScope) {
-    const response = await this.api("/project-assistant/suggestions", {
-      query: actorScope ? { actor_scope: actorScope } : {},
-    });
-    if (!response.ok) throw new Error(`Suggestions API failed (${response.statusCode}): ${response.message}`);
-    return response.data;
-  }
-
-  async probeArchiveRoute() {
-    const response = await this.api("/project-assistant/mission-archive", {
-      method: "POST",
-      idempotencyKey: `mission-live-full-route-probe-${nowId()}`,
-      body: {
-        mission_ids: ["__NOT_A_REAL_MISSION__"],
-        reason: "mission live full harness route probe",
-      },
-    });
-    this.archiveRouteAvailable = response.statusCode === 200;
-    if (!this.archiveRouteAvailable) {
-      throw new Error(`Archive route is not live (${response.statusCode}): ${response.message || "no message"}`);
-    }
-    return {
-      status_code: response.statusCode,
-      rejected_count: response.data?.rejected_count,
-      updated_count: response.data?.updated_count,
-    };
-  }
-
-  async scenarioPreflight() {
-    this.requireKey();
-    const config = this.cli(["config", "--json"]);
-    const bootstrap = this.cli(["bootstrap", "--json"]);
-    const sync = this.cliWithActor(["suggestions", "sync", "--json"], "preflight");
-    return {
-      project_id: config.project_id || bootstrap.project_id || null,
-      repo_count: Array.isArray(config.repo_names) ? config.repo_names.length : 0,
-      active_mission_count: bootstrap.counts?.missions || 0,
-      suggestion_threads: sync.thread_count || 0,
-      actionable_threads: sync.actionable_count || 0,
-    };
-  }
-
-  async scenarioContracts() {
-    const invalidCreate = writeJson(this.payloadDir, "invalid-create-change-type.json", {
-      items: [{ change_type: "add-mission", change_description: "invalid", change_set: { title: "Invalid" } }],
-    });
-    const invalidRevise = writeJson(this.payloadDir, "invalid-revise-change-type.json", {
-      items: [{ suggestion_id: "000000000000000000000000", change_type: "create", change_set: { title: "Invalid" } }],
-    });
-    const badMissionIds = Array.from({ length: 101 }, (_, index) => `ZZ${String(index).padStart(3, "0")}`).join(",");
-    const tooManyQaqcIds = Array.from({ length: 11 }, (_, index) => `ZZ${String(index).padStart(3, "0")}`).join(",");
-
-    const checks = [];
-    checks.push(this.cli(["suggestions", "create", "--file", invalidCreate, "--json"], { expectFailure: true, parseJson: false }));
-    checks.push(this.cli(["suggestions", "revise", "--file", invalidRevise, "--json"], { expectFailure: true, parseJson: false }));
-    checks.push(this.cli(["mission", "status", "--mission-ids", "M001", "--status", "archived", "--json"], { expectFailure: true, parseJson: false }));
-    checks.push(this.cli(["mission", "restore", "--mission-ids", "M001", "--status", "todo", "--json"], { expectFailure: true, parseJson: false }));
-    checks.push(this.cli(["mission", "delete", "--mission-ids", "M001", "--json"], { expectFailure: true, parseJson: false }));
-    checks.push(this.cli(["mission", "archive", "--mission-ids", "M001", "--reason", "dry run", "--dry-run", "--json"]));
-    checks.push(this.cli(["mission", "status", "--mission-ids", badMissionIds, "--status", "todo", "--json"], { expectFailure: true, parseJson: false, timeoutMs: 180000 }));
-    checks.push(this.cli(["run-qaqc", "--mission-ids", tooManyQaqcIds, "--json"], { expectFailure: true, parseJson: false, timeoutMs: 180000 }));
-    return { checks: checks.length };
-  }
-
-  async scenarioSuggestionUpdateLoop() {
-    this.requireLive("suggestion_update_loop");
-    const actor = `${this.actorBase}-update-loop`;
-    const bootstrap = await this.bootstrap();
-    const mission = chooseStableMission(bootstrap);
-    assertCondition(mission, "No active mission available for update suggestion loop.");
-    const missionId = missionPublicId(mission);
-
-    const createOne = writeJson(this.payloadDir, "update-loop-create-1.json", {
-      items: [{
-        change_type: "update",
-        mission_id: missionId,
-        change_description: "Harness proposed non-applied update",
-        change_set: { description: "Harness proposed description. This should be rejected during cleanup." },
-      }],
-    });
-    const first = this.cli(["suggestions", "create", "--file", createOne, "--no-sync", "--json"], { actorScope: actor });
-    const suggestionId = pickSuggestionId(first);
-    assertCondition(suggestionId, "Update suggestion create did not return suggestion_id.");
-    this.openSuggestions.add(suggestionId);
-
-    const createTwo = writeJson(this.payloadDir, "update-loop-create-2.json", {
-      items: [{
-        change_type: "update",
-        mission_id: missionId,
-        change_description: "Harness append to existing pending update thread",
-        change_set: { acceptance_criteria: ["Harness proposed acceptance criterion. This should be rejected."] },
-      }],
-    });
-    const second = this.cli(["suggestions", "create", "--file", createTwo, "--no-sync", "--json"], { actorScope: actor });
-    const appendedId = pickSuggestionId(second);
-    assertCondition(appendedId === suggestionId, `Expected append to same suggestion ${suggestionId}, got ${appendedId || "(none)"}.`);
-
-    const revise = writeJson(this.payloadDir, "update-loop-revise.json", {
-      items: [{
-        suggestion_id: suggestionId,
-        change_description: "Harness revision after append",
-        change_set: { technical_requirements: ["Harness proposed requirement. This should be rejected."] },
-      }],
-    });
-    const revised = this.cli(["suggestions", "revise", "--file", revise, "--no-sync", "--json"], { actorScope: actor });
-    assertCondition((revised.revised_count || 0) >= 1, "Update suggestion revise did not revise the thread.");
-
-    const requestChanges = writeJson(this.payloadDir, "update-loop-request-changes.json", {
-      items: [{ suggestion_id: suggestionId, action: "request_changes", review_action: "request_changes", review_note: "Harness request changes check." }],
-    });
-    const requested = this.cli(["suggestions", "review", "--file", requestChanges, "--no-sync", "--json"], { actorScope: actor });
-    assertCondition((requested.processed_count || 0) >= 1, "Update suggestion request_changes did not process.");
-
-    const reviseAfterRequest = writeJson(this.payloadDir, "update-loop-revise-after-request.json", {
-      items: [{
-        suggestion_id: suggestionId,
-        change_description: "Harness revision after request_changes",
-        change_set: { labels: ["harness-proposed-update"] },
-      }],
-    });
-    const revisedAgain = this.cli(["suggestions", "revise", "--file", reviseAfterRequest, "--no-sync", "--json"], { actorScope: actor });
-    assertCondition((revisedAgain.revised_count || 0) >= 1, "Update suggestion revise after request_changes did not process.");
-
-    const reject = writeJson(this.payloadDir, "update-loop-reject.json", {
-      items: [{ suggestion_id: suggestionId, action: "reject", review_action: "reject", review_note: "Harness cleanup reject." }],
-    });
-    const rejected = this.cli(["suggestions", "review", "--file", reject, "--json"], { actorScope: actor });
-    assertCondition((rejected.processed_count || 0) >= 1, "Update suggestion reject cleanup did not process.");
-    this.openSuggestions.delete(suggestionId);
-
-    return { mission_id: missionId, suggestion_id: suggestionId, append_verified: true };
-  }
-
-  async scenarioCreateRejectLoop() {
-    this.requireLive("create_reject_loop");
-    const actor = `${this.actorBase}-create-reject`;
-    const title = `Harness rejected mission ${nowId()}`;
-    const before = await this.bootstrap();
-
-    const createFile = writeJson(this.payloadDir, "create-reject-create.json", {
-      items: [{
-        change_type: "create",
-        change_description: "Harness new mission proposal that will be rejected",
-        change_set: {
-          title,
-          description: "Harness proposal that should never become an active mission.",
-          acceptance_criteria: ["The rejected proposal does not create a mission card."],
-          labels: ["harness", "reject-path"],
-        },
-      }],
-    });
-    const created = this.cli(["suggestions", "create", "--file", createFile, "--no-sync", "--json"], { actorScope: actor });
-    const suggestionId = pickSuggestionId(created);
-    assertCondition(suggestionId, "Create suggestion did not return suggestion_id.");
-    this.openSuggestions.add(suggestionId);
-
-    const afterCreate = await this.bootstrap();
-    assertCondition(
-      activeMissions(afterCreate).length === activeMissions(before).length,
-      "New mission proposal created an active mission before approval.",
-    );
-
-    const reviseFile = writeJson(this.payloadDir, "create-reject-revise.json", {
-      items: [{
-        suggestion_id: suggestionId,
-        change_description: "Harness revision for rejected create thread",
-        change_set: { description: "Harness revised proposal. This should still be rejected." },
-      }],
-    });
-    const revised = this.cli(["suggestions", "revise", "--file", reviseFile, "--no-sync", "--json"], { actorScope: actor });
-    assertCondition((revised.revised_count || 0) >= 1, "Create suggestion revise did not process.");
-
-    const requestChanges = writeJson(this.payloadDir, "create-reject-request-changes.json", {
-      items: [{ suggestion_id: suggestionId, action: "request_changes", review_action: "request_changes", review_note: "Harness request changes check." }],
-    });
-    const requested = this.cli(["suggestions", "review", "--file", requestChanges, "--no-sync", "--json"], { actorScope: actor });
-    assertCondition((requested.processed_count || 0) >= 1, "Create suggestion request_changes did not process.");
-
-    const reject = writeJson(this.payloadDir, "create-reject-reject.json", {
-      items: [{ suggestion_id: suggestionId, action: "reject", review_action: "reject", review_note: "Harness cleanup reject." }],
-    });
-    const rejected = this.cli(["suggestions", "review", "--file", reject, "--json"], { actorScope: actor });
-    assertCondition((rejected.processed_count || 0) >= 1, "Create suggestion reject cleanup did not process.");
-    this.openSuggestions.delete(suggestionId);
-
-    const afterReject = await this.bootstrap();
-    assertCondition(
-      activeMissions(afterReject).every((mission) => missionTitle(mission) !== title),
-      "Rejected create suggestion appeared as an active mission.",
-    );
-    return { suggestion_id: suggestionId, active_mission_created: false };
-  }
-
-  async archiveMissions(missionIds, reason) {
-    if (!missionIds.length) return null;
-    return this.cli(["mission", "archive", "--mission-ids", missionIds.join(","), "--reason", reason, "--json"], {
-      timeoutMs: 180000,
-    });
-  }
-
-  async rejectSuggestion(suggestionId, actor, note) {
-    const rejectFile = writeJson(this.payloadDir, `reject-${suggestionId}.json`, {
-      items: [{ suggestion_id: suggestionId, action: "reject", review_action: "reject", review_note: note || "Harness cleanup reject." }],
-    });
-    return this.cli(["suggestions", "review", "--file", rejectFile, "--json"], { actorScope: actor, timeoutMs: 180000 });
-  }
-
-  async createApprovedMission(actor, index = 1) {
-    const title = `Harness approved mission ${nowId()} ${index}`;
-    const description = "Disposable mission created by the reusable live mission harness.";
-    const createFile = writeJson(this.payloadDir, `approved-create-${index}.json`, {
-      items: [{
-        change_type: "create",
-        change_description: "Harness approved disposable mission creation",
-        change_set: {
-          title,
-          description,
-          acceptance_criteria: [
-            "Mission can be created through suggestion approval.",
-            "Mission can be mutated through project-key mission commands.",
-            "Mission can be archived without hard delete.",
-          ],
-          labels: ["harness", "approved-disposable"],
-        },
-      }],
-    });
-    const created = this.cli(["suggestions", "create", "--file", createFile, "--no-sync", "--json"], { actorScope: actor, timeoutMs: 180000 });
-    const suggestionId = pickSuggestionId(created);
-    assertCondition(suggestionId, "Approved mission create did not return suggestion_id.");
-    this.openSuggestions.add(suggestionId);
-    const reviewFile = writeJson(this.payloadDir, `approved-review-${index}.json`, {
-      items: [{
-        suggestion_id: suggestionId,
-        action: "approve",
-        review_action: "approve",
-        final_change_set: {
-          title,
-          description,
-          acceptance_criteria: [
-            "Mission can be created through suggestion approval.",
-            "Mission can be mutated through project-key mission commands.",
-            "Mission can be archived without hard delete.",
-          ],
-          labels: ["harness", "approved-disposable"],
-        },
-      }],
-    });
-    const reviewed = this.cli(["suggestions", "review", "--file", reviewFile, "--json"], { actorScope: actor, timeoutMs: 180000 });
-    const missionId = pickAppliedMissionId(reviewed);
-    assertCondition(missionId, "Approved mission review did not return applied mission id.");
-    this.createdMissions.add(missionId);
-    this.openSuggestions.delete(suggestionId);
-    return { mission_id: missionId, suggestion_id: suggestionId, title };
-  }
-
-  async scenarioApprovedLifecycle() {
-    this.requireLive("approved_lifecycle");
-    if (this.archiveRouteAvailable !== true) await this.probeArchiveRoute();
-    const actor = `${this.actorBase}-approved-lifecycle`;
-    const created = await this.createApprovedMission(actor, 1);
-    let pendingSuggestionId = "";
-    try {
-      const activeAfterCreate = await this.bootstrap();
-      assertCondition(hasMissionInBootstrap(activeAfterCreate, created.mission_id), "Approved mission is missing from active bootstrap state.");
-
-      for (const status of ["in_progress", "done", "todo"]) {
-        const result = this.cli(["mission", "status", "--mission-ids", created.mission_id, "--status", status, "--json"], { timeoutMs: 180000 });
-        assertCondition((result.matched_count || 0) >= 1, `Mission status ${status} did not match the disposable mission.`);
-      }
-      const noop = this.cli(["mission", "status", "--mission-ids", created.mission_id, "--status", "todo", "--json"], { timeoutMs: 180000 });
-      assertCondition((noop.unchanged_count || 0) >= 1 || (noop.matched_count || 0) >= 1, "Idempotent mission status no-op did not report a stable match.");
-
-      const pendingFile = writeJson(this.payloadDir, "approved-lifecycle-pending-update.json", {
-        items: [{
-          change_type: "update",
-          mission_id: created.mission_id,
-          change_description: "Harness pending suggestion across archive",
-          change_set: { description: "Harness pending suggestion should be hidden from actionable queue while archived." },
-        }],
-      });
-      const pending = this.cli(["suggestions", "create", "--file", pendingFile, "--no-sync", "--json"], { actorScope: actor, timeoutMs: 180000 });
-      pendingSuggestionId = pickSuggestionId(pending);
-      assertCondition(pendingSuggestionId, "Pending update suggestion for approved mission was not created.");
-      this.openSuggestions.add(pendingSuggestionId);
-
-      const archived = await this.archiveMissions([created.mission_id], "Harness archive active mission with pending suggestion");
-      assertCondition((archived.updated_count || 0) + (archived.unchanged_count || 0) >= 1, "Archive did not update or confirm the disposable mission.");
-
-      const afterArchive = await this.bootstrap();
-      assertCondition(!hasMissionInBootstrap(afterArchive, created.mission_id), "Archived mission is still present in active bootstrap state.");
-      const archivedSuggestions = await this.suggestions(actor);
-      const archivedQueueRefs = queueRefs(archivedSuggestions).filter((item) => item.mission_id.toUpperCase() === created.mission_id.toUpperCase());
-      assertCondition(archivedQueueRefs.length === 0, "Archived mission still appears in actionable suggestion queue.");
-      const archivedThreadRefs = threadRefs(archivedSuggestions).filter((item) => item.suggestion_id === pendingSuggestionId);
-      assertCondition(archivedThreadRefs.length >= 1, "Archived mission pending suggestion was not preserved in thread history.");
-
-      await this.rejectSuggestion(pendingSuggestionId, actor, "Harness cleanup reject after archived-thread preservation check.");
-      this.openSuggestions.delete(pendingSuggestionId);
-      return {
-        mission_id: created.mission_id,
-        create_suggestion_id: created.suggestion_id,
-        pending_suggestion_id: pendingSuggestionId,
-        archive_hides_active: true,
-        archive_preserves_thread_history: true,
-      };
-    } catch (error) {
-      if (pendingSuggestionId) {
-        try {
-          await this.rejectSuggestion(pendingSuggestionId, actor, "Harness failure cleanup reject.");
-          this.openSuggestions.delete(pendingSuggestionId);
-        } catch (_) {}
-      }
-      try {
-        await this.archiveMissions([created.mission_id], "Harness failure cleanup archive.");
-      } catch (_) {}
-      throw error;
-    }
-  }
-
-  async scenarioBatchLimits() {
-    const statusIds = Array.from({ length: 101 }, (_, index) => `ZZ${String(index).padStart(3, "0")}`).join(",");
-    const qaqcIds = Array.from({ length: 11 }, (_, index) => `ZZ${String(index).padStart(3, "0")}`).join(",");
-    const archiveProbe = await this.api("/project-assistant/mission-archive", {
-      method: "POST",
-      idempotencyKey: `mission-live-full-archive-limit-${nowId()}`,
-      body: {
-        mission_ids: Array.from({ length: 101 }, (_, index) => `ZZ${String(index).padStart(3, "0")}`),
-        reason: "Harness limit check",
-      },
-    });
-    const checks = [
-      this.cli(["mission", "status", "--mission-ids", statusIds, "--status", "todo", "--json"], { expectFailure: true, parseJson: false, timeoutMs: 180000 }),
-      this.cli(["run-qaqc", "--mission-ids", qaqcIds, "--json"], { expectFailure: true, parseJson: false, timeoutMs: 180000 }),
-    ];
-    assertCondition(
-      archiveProbe.statusCode === 400 || archiveProbe.statusCode === 404,
-      `Expected archive limit check to return 400 when route is live or 404 when route is absent, got ${archiveProbe.statusCode}.`,
-    );
-    return {
-      checks: checks.length + 1,
-      mission_status_limit: 100,
-      run_qaqc_limit: 10,
-      archive_limit: archiveProbe.statusCode === 400 ? 100 : "route_not_live",
-    };
-  }
-
-  async scenarioBatchMutation() {
-    this.requireLive("batch_mutation");
-    if (this.archiveRouteAvailable !== true) await this.probeArchiveRoute();
-    const actor = `${this.actorBase}-batch`;
-    const created = [];
-    try {
-      for (let index = 1; index <= this.batchSize; index += 1) {
-        created.push(await this.createApprovedMission(actor, index));
-      }
-      const missionIds = created.map((item) => item.mission_id);
-      for (const status of ["in_progress", "done", "todo"]) {
-        const result = this.cli(["mission", "status", "--mission-ids", missionIds.join(","), "--status", status, "--json"], { timeoutMs: 240000 });
-        assertCondition((result.matched_count || 0) === missionIds.length, `Batch status ${status} matched ${result.matched_count || 0}/${missionIds.length}.`);
-      }
-      const archived = await this.archiveMissions(missionIds, "Harness batch cleanup archive");
-      assertCondition((archived.updated_count || 0) + (archived.unchanged_count || 0) === missionIds.length, "Batch archive did not cover every disposable mission.");
-      return { mission_count: missionIds.length, mission_ids: missionIds };
-    } catch (error) {
-      try {
-        await this.archiveMissions(created.map((item) => item.mission_id), "Harness batch failure cleanup archive");
-      } catch (_) {}
-      throw error;
-    }
-  }
-
-  async scenarioQaqc() {
-    const sync = this.cli(["sync-qaqc", "--json"], { timeoutMs: 180000 });
-    const result = {
-      sync_mission_count: sync.counts?.missions || sync.missions_count || 0,
-      run_executed: false,
-    };
-    if (!this.includeQaqcRun) {
-      result.skipped_run_reason = "Pass --include-qaqc-run to queue a live QAQC batch.";
-      return result;
-    }
-    this.requireLive("qaqc run");
-    const bootstrap = await this.bootstrap();
-    const mission = chooseQaqcMission(bootstrap);
-    assertCondition(mission, "No active non-Done mission with test cases is available for QAQC run.");
-    const missionId = missionPublicId(mission);
-    const run = this.cli(["run-qaqc", "--mission-ids", missionId, "--wait", "--sync", "--json"], { timeoutMs: 600000 });
-    result.run_executed = true;
-    result.mission_id = missionId;
-    result.batch_id = run.batch_id || null;
-    result.status = run.status || null;
-    result.accepted_count = run.accepted_count || 0;
-    assertCondition(result.accepted_count > 0, `QAQC run did not accept ${missionId}; status=${result.status || "unknown"}.`);
-    return result;
-  }
-
-  scenarioMap() {
-    return {
-      preflight: () => this.scenarioPreflight(),
-      contracts: () => this.scenarioContracts(),
-      suggestion_update_loop: () => this.scenarioSuggestionUpdateLoop(),
-      create_reject_loop: () => this.scenarioCreateRejectLoop(),
-      archive_route_probe: () => this.probeArchiveRoute(),
-      approved_lifecycle: () => this.scenarioApprovedLifecycle(),
-      batch_limits: () => this.scenarioBatchLimits(),
-      batch_mutation: () => this.scenarioBatchMutation(),
-      qaqc: () => this.scenarioQaqc(),
-    };
-  }
-
-  async runScenario(name) {
-    const startedAt = new Date().toISOString();
-    const entry = { name, status: "running", started_at: startedAt };
-    this.report.scenarios.push(entry);
-    const map = this.scenarioMap();
-    if (!map[name]) throw new Error(`Unknown scenario: ${name}`);
-    try {
-      const details = await map[name]();
-      entry.status = "passed";
-      entry.completed_at = new Date().toISOString();
-      entry.details = safeResult(details || {});
-      console.log(`[pass] ${name}`);
-    } catch (error) {
-      entry.status = "failed";
-      entry.completed_at = new Date().toISOString();
-      entry.error = String(error?.message || error);
-      console.error(`[fail] ${name}: ${entry.error}`);
-      if (!this.keepGoing) throw error;
-    } finally {
-      this.writeReport();
-    }
-  }
-
-  writeReport() {
-    this.report.created_mission_ids = Array.from(this.createdMissions).sort();
-    this.report.open_suggestion_ids = Array.from(this.openSuggestions).sort();
-    if (!this.report.completed_at) {
-      this.report.status = this.report.scenarios.some((item) => item.status === "failed") ? "failed" : "running";
-    }
-    ensureDir(path.dirname(this.reportPath));
-    fs.writeFileSync(this.reportPath, JSON.stringify(this.report, null, 2), "utf8");
-  }
-
-  async run() {
-    this.requireKey();
-    ensureDir(this.workspace);
-    ensureDir(this.payloadDir);
-    console.log(`Workspace: ${this.workspace}`);
-    console.log(`Report: ${this.reportPath}`);
-    console.log(`Scenarios: ${this.scenarios.join(", ")}`);
-    if (!this.confirmLive) {
-      console.log("Live mutations disabled. Pass --confirm-live to run mutating scenarios.");
-    }
-    for (const scenario of this.scenarios) {
-      await this.runScenario(scenario);
-    }
-    const failed = this.report.scenarios.filter((item) => item.status === "failed");
-    this.report.status = failed.length ? "failed" : "passed";
-    this.report.completed_at = new Date().toISOString();
-    this.writeReport();
-    console.log(JSON.stringify({
-      status: this.report.status,
-      report_file: this.reportPath,
-      passed: this.report.scenarios.filter((item) => item.status === "passed").length,
-      failed: failed.length,
-      created_mission_ids: this.report.created_mission_ids,
-      open_suggestion_ids: this.report.open_suggestion_ids,
-    }, null, 2));
-    if (failed.length && this.args["no-fail-exit"] !== true) process.exitCode = 1;
-  }
-}
-
-const args = parseArgs(process.argv.slice(2));
-new Harness(args).run().catch((error) => {
-  console.error(error?.message || error);
-  process.exit(1);
-});
+#!/usr/bin/env node
+"use strict";
+
+const fs = require("node:fs");
+const os = require("node:os");
+const path = require("node:path");
+const { spawnSync } = require("node:child_process");
+
+const CLI_PATH = path.resolve(__dirname, "..", "cli.js");
+const DEFAULT_BASE_URL = "https://api.myte.dev/api";
+
+function parseArgs(argv) {
+  const args = { _: [] };
+  for (let index = 0; index < argv.length; index += 1) {
+    const token = argv[index];
+    if (!token.startsWith("--")) {
+      args._.push(token);
+      continue;
+    }
+    const key = token.slice(2);
+    const next = argv[index + 1];
+    if (!next || next.startsWith("--")) {
+      args[key] = true;
+      continue;
+    }
+    args[key] = next;
+    index += 1;
+  }
+  return args;
+}
+
+function loadEnvFromNearest(startDir) {
+  let cur = startDir;
+  for (let index = 0; index < 8; index += 1) {
+    const filePath = path.join(cur, ".env");
+    if (fs.existsSync(filePath)) {
+      for (const line of fs.readFileSync(filePath, "utf8").split(/\r?\n/)) {
+        const trimmed = String(line || "").trim();
+        if (!trimmed || trimmed.startsWith("#")) continue;
+        const splitAt = trimmed.indexOf("=");
+        if (splitAt <= 0) continue;
+        const key = trimmed.slice(0, splitAt).trim();
+        let value = trimmed.slice(splitAt + 1).trim();
+        if ((value.startsWith('"') && value.endsWith('"')) || (value.startsWith("'") && value.endsWith("'"))) {
+          value = value.slice(1, -1);
+        }
+        if (key && process.env[key] === undefined) process.env[key] = value;
+      }
+      return filePath;
+    }
+    const parent = path.dirname(cur);
+    if (parent === cur) break;
+    cur = parent;
+  }
+  return null;
+}
+
+function nowId() {
+  return new Date().toISOString().replace(/[^0-9A-Za-z]+/g, "-").replace(/^-|-$/g, "");
+}
+
+function ensureDir(dirPath) {
+  fs.mkdirSync(dirPath, { recursive: true });
+}
+
+function writeJson(dirPath, name, payload) {
+  ensureDir(dirPath);
+  const filePath = path.join(dirPath, name);
+  fs.writeFileSync(filePath, JSON.stringify(payload, null, 2), "utf8");
+  return filePath;
+}
+
+function normalizeBaseUrl(value) {
+  const raw = String(value || DEFAULT_BASE_URL).replace(/\/+$/, "");
+  return raw.endsWith("/api") ? raw : `${raw}/api`;
+}
+
+function getProjectKey() {
+  return process.env.MYTE_API_KEY || process.env.MYTE_PROJECT_API_KEY || "";
+}
+
+function stableScenarioList(raw, confirmLive) {
+  if (raw) {
+    return String(raw)
+      .split(",")
+      .map((item) => item.trim())
+      .filter(Boolean);
+  }
+  if (!confirmLive) return ["preflight", "contracts"];
+  return [
+    "preflight",
+    "contracts",
+    "suggestion_update_loop",
+    "create_reject_loop",
+    "archive_route_probe",
+    "approved_lifecycle",
+    "batch_limits",
+    "batch_mutation",
+    "qaqc",
+  ];
+}
+
+function commandForPlatform(command) {
+  if (process.platform !== "win32") return command;
+  if (command.endsWith(".cmd") || command.endsWith(".exe")) return command;
+  return `${command}.cmd`;
+}
+
+function cliInvocation(args, cliMode, packageVersion) {
+  if (cliMode === "global") return { command: commandForPlatform("myte"), args };
+  if (cliMode === "npx") return { command: commandForPlatform("npx"), args: ["--yes", `myte@${packageVersion}`, ...args] };
+  return { command: process.execPath, args: [CLI_PATH, ...args] };
+}
+
+function commandText(invocation) {
+  return [invocation.command, ...invocation.args].join(" ");
+}
+
+function runCli(cliArgs, options = {}) {
+  const {
+    workspace,
+    baseUrl,
+    actorScope,
+    expectFailure = false,
+    parseJson = true,
+    cliMode = "local",
+    packageVersion = "latest",
+    timeoutMs = 120000,
+  } = options;
+  const finalArgs = [...cliArgs];
+  if (actorScope) finalArgs.push("--actor-scope", actorScope);
+  if (baseUrl) finalArgs.push("--base-url", baseUrl);
+  const invocation = cliInvocation(finalArgs, cliMode, packageVersion);
+  const result = spawnSync(invocation.command, invocation.args, {
+    cwd: workspace || process.cwd(),
+    env: process.env,
+    encoding: "utf8",
+    shell: process.platform === "win32" && /\.(cmd|bat)$/i.test(invocation.command),
+    stdio: ["ignore", "pipe", "pipe"],
+    timeout: timeoutMs,
+  });
+  const stdout = String(result.stdout || "").trim();
+  const stderr = String(result.stderr || "").trim();
+  const ok = result.status === 0;
+  const processError = result.error ? String(result.error.message || result.error) : "";
+  if (expectFailure) {
+    if (ok) {
+      throw new Error(`Expected command to fail but it succeeded: ${commandText(invocation)}`);
+    }
+    return { ok: false, status: result.status, stdout, stderr, error: processError };
+  }
+  if (!ok) {
+    throw new Error([`Command failed: ${commandText(invocation)}`, processError || stderr || stdout || "(no output)"].join("\n"));
+  }
+  if (!parseJson) return { ok: true, stdout, stderr };
+  try {
+    return stdout ? JSON.parse(stdout) : {};
+  } catch (error) {
+    throw new Error(`Expected JSON from ${commandText(invocation)}:\n${stdout}`);
+  }
+}
+
+async function apiJson({ method = "GET", baseUrl, route, key, body, query, idempotencyKey }) {
+  const url = new URL(`${baseUrl}${route}`);
+  for (const [queryKey, queryValue] of Object.entries(query || {})) {
+    if (queryValue !== undefined && queryValue !== null && String(queryValue).trim() !== "") {
+      url.searchParams.set(queryKey, String(queryValue));
+    }
+  }
+  const headers = { Authorization: `Bearer ${key}` };
+  if (body !== undefined) headers["Content-Type"] = "application/json";
+  if (idempotencyKey) headers["X-Idempotency-Key"] = String(idempotencyKey);
+  const response = await fetch(url.toString(), {
+    method,
+    headers,
+    body: body === undefined ? undefined : JSON.stringify(body),
+  });
+  let payload = {};
+  try {
+    payload = await response.json();
+  } catch (_) {
+    payload = {};
+  }
+  return {
+    ok: response.ok && payload.status === "success",
+    statusCode: response.status,
+    message: payload.message || "",
+    data: payload.data || {},
+  };
+}
+
+function missionPublicId(mission) {
+  return String(mission?.mission_id || mission?.public_id || mission?.id || "").trim();
+}
+
+function missionTitle(mission) {
+  return String(mission?.title || "").trim();
+}
+
+function activeMissions(bootstrap) {
+  return (Array.isArray(bootstrap?.missions) ? bootstrap.missions : [])
+    .filter((mission) => missionPublicId(mission))
+    .filter((mission) => String(mission.status || "").toLowerCase() !== "archived")
+    .filter((mission) => mission.is_archived !== true);
+}
+
+function chooseStableMission(bootstrap) {
+  const missions = activeMissions(bootstrap);
+  return missions.find((mission) => !/^Disposable mission harness/i.test(missionTitle(mission))) || missions[0] || null;
+}
+
+function hasRunnableQaqcCases(mission) {
+  if (String(mission?.status || "").toLowerCase() === "done") return false;
+  const testCases = mission?.test_cases || {};
+  const success = Array.isArray(testCases.success) ? testCases.success : [];
+  const failure = Array.isArray(testCases.failure) ? testCases.failure : [];
+  return success.length > 0 || failure.length > 0;
+}
+
+function chooseQaqcMission(bootstrap) {
+  const missions = activeMissions(bootstrap).filter(hasRunnableQaqcCases);
+  return missions.find((mission) => !/^Disposable mission harness/i.test(missionTitle(mission))) || missions[0] || null;
+}
+
+function pickSuggestionId(output) {
+  for (const item of output.items || []) {
+    const suggestionId = item?.suggestion?.suggestion_id || item?.suggestion_id;
+    if (suggestionId) return String(suggestionId);
+  }
+  return "";
+}
+
+function pickAppliedMissionId(output) {
+  for (const item of output.items || []) {
+    const missionId = item?.applied_mission?.mission_id || item?.mission_id || item?.suggestion?.mission_id;
+    if (missionId) return String(missionId);
+  }
+  return "";
+}
+
+function threadRefs(snapshot) {
+  const refs = [];
+  for (const source of [snapshot?.queue, snapshot?.threads, snapshot?.suggestions]) {
+    if (!Array.isArray(source)) continue;
+    for (const item of source) {
+      refs.push({
+        suggestion_id: String(item?.suggestion_id || item?.id || "").trim(),
+        mission_id: String(item?.mission_id || "").trim(),
+        change_type: String(item?.change_type || "").trim(),
+        status: String(item?.status || item?.thread_status || "").trim(),
+      });
+    }
+  }
+  return refs.filter((item) => item.suggestion_id || item.mission_id);
+}
+
+function queueRefs(snapshot) {
+  return threadRefs({ queue: snapshot?.queue || [] });
+}
+
+function hasMissionInBootstrap(bootstrap, missionId) {
+  const target = String(missionId || "").toUpperCase();
+  return activeMissions(bootstrap).some((mission) => missionPublicId(mission).toUpperCase() === target);
+}
+
+function assertCondition(condition, message) {
+  if (!condition) throw new Error(message);
+}
+
+function safeResult(details = {}) {
+  return JSON.parse(JSON.stringify(details, (_key, value) => {
+    if (typeof value !== "string") return value;
+    if (value.includes("@")) return "[redacted]";
+    return value.length > 180 ? `${value.slice(0, 180)}...` : value;
+  }));
+}
+
+class Harness {
+  constructor(args) {
+    loadEnvFromNearest(process.cwd());
+    this.args = args;
+    this.confirmLive = args["confirm-live"] === true;
+    this.keepGoing = args["keep-going"] === true;
+    this.baseUrl = normalizeBaseUrl(args["base-url"] || process.env.MYTE_API_BASE_URL || DEFAULT_BASE_URL);
+    this.key = getProjectKey();
+    this.actorBase = String(args["actor-scope"] || `mission-live-full-${nowId()}`);
+    this.cliMode = String(args.cli || "local").toLowerCase();
+    this.packageVersion = String(args["package-version"] || "0.0.28");
+    this.batchSize = Math.max(1, Math.min(10, Number(args["batch-size"] || 10)));
+    this.includeQaqcRun = args["include-qaqc-run"] === true;
+    this.workspace = path.resolve(
+      args.workspace || fs.mkdtempSync(path.join(os.tmpdir(), "myte-mission-full-harness-")),
+    );
+    this.payloadDir = path.join(this.workspace, "payloads");
+    this.reportPath = path.resolve(args["report-file"] || path.join(this.workspace, "mission-live-full-report.json"));
+    this.scenarios = stableScenarioList(args.scenarios, this.confirmLive);
+    this.createdMissions = new Set();
+    this.openSuggestions = new Set();
+    this.archiveRouteAvailable = null;
+    this.report = {
+      status: "running",
+      generated_at: new Date().toISOString(),
+      base_url: this.baseUrl,
+      cli_mode: this.cliMode,
+      package_version: this.packageVersion,
+      workspace: this.workspace,
+      scenarios: [],
+      created_mission_ids: [],
+      open_suggestion_ids: [],
+      notes: [],
+    };
+  }
+
+  requireKey() {
+    if (!this.key) throw new Error("Missing MYTE_API_KEY or MYTE_PROJECT_API_KEY.");
+  }
+
+  requireLive(name) {
+    if (!this.confirmLive) {
+      throw new Error(`${name} requires --confirm-live because it mutates live project data.`);
+    }
+  }
+
+  cli(args, options = {}) {
+    return runCli(args, {
+      workspace: this.workspace,
+      baseUrl: this.baseUrl,
+      cliMode: this.cliMode,
+      packageVersion: this.packageVersion,
+      ...options,
+    });
+  }
+
+  cliWithActor(args, suffix, options = {}) {
+    return this.cli(args, {
+      actorScope: `${this.actorBase}-${suffix}`,
+      ...options,
+    });
+  }
+
+  async api(route, options = {}) {
+    return apiJson({
+      baseUrl: this.baseUrl,
+      key: this.key,
+      route,
+      ...options,
+    });
+  }
+
+  async bootstrap() {
+    const response = await this.api("/project-assistant/bootstrap");
+    if (!response.ok) throw new Error(`Bootstrap API failed (${response.statusCode}): ${response.message}`);
+    return response.data;
+  }
+
+  async suggestions(actorScope) {
+    const response = await this.api("/project-assistant/suggestions", {
+      query: actorScope ? { actor_scope: actorScope } : {},
+    });
+    if (!response.ok) throw new Error(`Suggestions API failed (${response.statusCode}): ${response.message}`);
+    return response.data;
+  }
+
+  async probeArchiveRoute() {
+    const response = await this.api("/project-assistant/mission-archive", {
+      method: "POST",
+      idempotencyKey: `mission-live-full-route-probe-${nowId()}`,
+      body: {
+        mission_ids: ["__NOT_A_REAL_MISSION__"],
+        reason: "mission live full harness route probe",
+      },
+    });
+    this.archiveRouteAvailable = response.statusCode === 200;
+    if (!this.archiveRouteAvailable) {
+      throw new Error(`Archive route is not live (${response.statusCode}): ${response.message || "no message"}`);
+    }
+    return {
+      status_code: response.statusCode,
+      rejected_count: response.data?.rejected_count,
+      updated_count: response.data?.updated_count,
+    };
+  }
+
+  async scenarioPreflight() {
+    this.requireKey();
+    const config = this.cli(["config", "--json"]);
+    const bootstrap = this.cli(["bootstrap", "--json"]);
+    const sync = this.cliWithActor(["suggestions", "sync", "--json"], "preflight");
+    return {
+      project_id: config.project_id || bootstrap.project_id || null,
+      repo_count: Array.isArray(config.repo_names) ? config.repo_names.length : 0,
+      active_mission_count: bootstrap.counts?.missions || 0,
+      suggestion_threads: sync.thread_count || 0,
+      actionable_threads: sync.actionable_count || 0,
+    };
+  }
+
+  async scenarioContracts() {
+    const invalidCreate = writeJson(this.payloadDir, "invalid-create-change-type.json", {
+      items: [{ change_type: "add-mission", change_description: "invalid", change_set: { title: "Invalid" } }],
+    });
+    const invalidRevise = writeJson(this.payloadDir, "invalid-revise-change-type.json", {
+      items: [{ suggestion_id: "000000000000000000000000", change_type: "create", change_set: { title: "Invalid" } }],
+    });
+    const badMissionIds = Array.from({ length: 101 }, (_, index) => `ZZ${String(index).padStart(3, "0")}`).join(",");
+    const tooManyQaqcIds = Array.from({ length: 11 }, (_, index) => `ZZ${String(index).padStart(3, "0")}`).join(",");
+
+    const checks = [];
+    checks.push(this.cli(["suggestions", "create", "--file", invalidCreate, "--json"], { expectFailure: true, parseJson: false }));
+    checks.push(this.cli(["suggestions", "revise", "--file", invalidRevise, "--json"], { expectFailure: true, parseJson: false }));
+    checks.push(this.cli(["mission", "status", "--mission-ids", "M001", "--status", "archived", "--json"], { expectFailure: true, parseJson: false }));
+    checks.push(this.cli(["mission", "restore", "--mission-ids", "M001", "--status", "todo", "--json"], { expectFailure: true, parseJson: false }));
+    checks.push(this.cli(["mission", "delete", "--mission-ids", "M001", "--json"], { expectFailure: true, parseJson: false }));
+    checks.push(this.cli(["mission", "archive", "--mission-ids", "M001", "--reason", "dry run", "--dry-run", "--json"]));
+    checks.push(this.cli(["mission", "status", "--mission-ids", badMissionIds, "--status", "todo", "--json"], { expectFailure: true, parseJson: false, timeoutMs: 180000 }));
+    checks.push(this.cli(["run-qaqc", "--mission-ids", tooManyQaqcIds, "--json"], { expectFailure: true, parseJson: false, timeoutMs: 180000 }));
+    return { checks: checks.length };
+  }
+
+  async scenarioSuggestionUpdateLoop() {
+    this.requireLive("suggestion_update_loop");
+    const actor = `${this.actorBase}-update-loop`;
+    const bootstrap = await this.bootstrap();
+    const mission = chooseStableMission(bootstrap);
+    assertCondition(mission, "No active mission available for update suggestion loop.");
+    const missionId = missionPublicId(mission);
+
+    const createOne = writeJson(this.payloadDir, "update-loop-create-1.json", {
+      items: [{
+        change_type: "update",
+        mission_id: missionId,
+        change_description: "Harness proposed non-applied update",
+        change_set: { description: "Harness proposed description. This should be rejected during cleanup." },
+      }],
+    });
+    const first = this.cli(["suggestions", "create", "--file", createOne, "--no-sync", "--json"], { actorScope: actor });
+    const suggestionId = pickSuggestionId(first);
+    assertCondition(suggestionId, "Update suggestion create did not return suggestion_id.");
+    this.openSuggestions.add(suggestionId);
+
+    const createTwo = writeJson(this.payloadDir, "update-loop-create-2.json", {
+      items: [{
+        change_type: "update",
+        mission_id: missionId,
+        change_description: "Harness append to existing pending update thread",
+        change_set: { acceptance_criteria: ["Harness proposed acceptance criterion. This should be rejected."] },
+      }],
+    });
+    const second = this.cli(["suggestions", "create", "--file", createTwo, "--no-sync", "--json"], { actorScope: actor });
+    const appendedId = pickSuggestionId(second);
+    assertCondition(appendedId === suggestionId, `Expected append to same suggestion ${suggestionId}, got ${appendedId || "(none)"}.`);
+
+    const revise = writeJson(this.payloadDir, "update-loop-revise.json", {
+      items: [{
+        suggestion_id: suggestionId,
+        change_description: "Harness revision after append",
+        change_set: { technical_requirements: ["Harness proposed requirement. This should be rejected."] },
+      }],
+    });
+    const revised = this.cli(["suggestions", "revise", "--file", revise, "--no-sync", "--json"], { actorScope: actor });
+    assertCondition((revised.revised_count || 0) >= 1, "Update suggestion revise did not revise the thread.");
+
+    const requestChanges = writeJson(this.payloadDir, "update-loop-request-changes.json", {
+      items: [{ suggestion_id: suggestionId, action: "request_changes", review_action: "request_changes", review_note: "Harness request changes check." }],
+    });
+    const requested = this.cli(["suggestions", "review", "--file", requestChanges, "--no-sync", "--json"], { actorScope: actor });
+    assertCondition((requested.processed_count || 0) >= 1, "Update suggestion request_changes did not process.");
+
+    const reviseAfterRequest = writeJson(this.payloadDir, "update-loop-revise-after-request.json", {
+      items: [{
+        suggestion_id: suggestionId,
+        change_description: "Harness revision after request_changes",
+        change_set: { labels: ["harness-proposed-update"] },
+      }],
+    });
+    const revisedAgain = this.cli(["suggestions", "revise", "--file", reviseAfterRequest, "--no-sync", "--json"], { actorScope: actor });
+    assertCondition((revisedAgain.revised_count || 0) >= 1, "Update suggestion revise after request_changes did not process.");
+
+    const reject = writeJson(this.payloadDir, "update-loop-reject.json", {
+      items: [{ suggestion_id: suggestionId, action: "reject", review_action: "reject", review_note: "Harness cleanup reject." }],
+    });
+    const rejected = this.cli(["suggestions", "review", "--file", reject, "--json"], { actorScope: actor });
+    assertCondition((rejected.processed_count || 0) >= 1, "Update suggestion reject cleanup did not process.");
+    this.openSuggestions.delete(suggestionId);
+
+    return { mission_id: missionId, suggestion_id: suggestionId, append_verified: true };
+  }
+
+  async scenarioCreateRejectLoop() {
+    this.requireLive("create_reject_loop");
+    const actor = `${this.actorBase}-create-reject`;
+    const title = `Harness rejected mission ${nowId()}`;
+    const before = await this.bootstrap();
+
+    const createFile = writeJson(this.payloadDir, "create-reject-create.json", {
+      items: [{
+        change_type: "create",
+        change_description: "Harness new mission proposal that will be rejected",
+        change_set: {
+          title,
+          description: "Harness proposal that should never become an active mission.",
+          acceptance_criteria: ["The rejected proposal does not create a mission card."],
+          labels: ["harness", "reject-path"],
+        },
+      }],
+    });
+    const created = this.cli(["suggestions", "create", "--file", createFile, "--no-sync", "--json"], { actorScope: actor });
+    const suggestionId = pickSuggestionId(created);
+    assertCondition(suggestionId, "Create suggestion did not return suggestion_id.");
+    this.openSuggestions.add(suggestionId);
+
+    const afterCreate = await this.bootstrap();
+    assertCondition(
+      activeMissions(afterCreate).length === activeMissions(before).length,
+      "New mission proposal created an active mission before approval.",
+    );
+
+    const reviseFile = writeJson(this.payloadDir, "create-reject-revise.json", {
+      items: [{
+        suggestion_id: suggestionId,
+        change_description: "Harness revision for rejected create thread",
+        change_set: { description: "Harness revised proposal. This should still be rejected." },
+      }],
+    });
+    const revised = this.cli(["suggestions", "revise", "--file", reviseFile, "--no-sync", "--json"], { actorScope: actor });
+    assertCondition((revised.revised_count || 0) >= 1, "Create suggestion revise did not process.");
+
+    const requestChanges = writeJson(this.payloadDir, "create-reject-request-changes.json", {
+      items: [{ suggestion_id: suggestionId, action: "request_changes", review_action: "request_changes", review_note: "Harness request changes check." }],
+    });
+    const requested = this.cli(["suggestions", "review", "--file", requestChanges, "--no-sync", "--json"], { actorScope: actor });
+    assertCondition((requested.processed_count || 0) >= 1, "Create suggestion request_changes did not process.");
+
+    const reject = writeJson(this.payloadDir, "create-reject-reject.json", {
+      items: [{ suggestion_id: suggestionId, action: "reject", review_action: "reject", review_note: "Harness cleanup reject." }],
+    });
+    const rejected = this.cli(["suggestions", "review", "--file", reject, "--json"], { actorScope: actor });
+    assertCondition((rejected.processed_count || 0) >= 1, "Create suggestion reject cleanup did not process.");
+    this.openSuggestions.delete(suggestionId);
+
+    const afterReject = await this.bootstrap();
+    assertCondition(
+      activeMissions(afterReject).every((mission) => missionTitle(mission) !== title),
+      "Rejected create suggestion appeared as an active mission.",
+    );
+    return { suggestion_id: suggestionId, active_mission_created: false };
+  }
+
+  async archiveMissions(missionIds, reason) {
+    if (!missionIds.length) return null;
+    return this.cli(["mission", "archive", "--mission-ids", missionIds.join(","), "--reason", reason, "--json"], {
+      timeoutMs: 180000,
+    });
+  }
+
+  async rejectSuggestion(suggestionId, actor, note) {
+    const rejectFile = writeJson(this.payloadDir, `reject-${suggestionId}.json`, {
+      items: [{ suggestion_id: suggestionId, action: "reject", review_action: "reject", review_note: note || "Harness cleanup reject." }],
+    });
+    return this.cli(["suggestions", "review", "--file", rejectFile, "--json"], { actorScope: actor, timeoutMs: 180000 });
+  }
+
+  async createApprovedMission(actor, index = 1) {
+    const title = `Harness approved mission ${nowId()} ${index}`;
+    const description = "Disposable mission created by the reusable live mission harness.";
+    const createFile = writeJson(this.payloadDir, `approved-create-${index}.json`, {
+      items: [{
+        change_type: "create",
+        change_description: "Harness approved disposable mission creation",
+        change_set: {
+          title,
+          description,
+          acceptance_criteria: [
+            "Mission can be created through suggestion approval.",
+            "Mission can be mutated through project-key mission commands.",
+            "Mission can be archived without hard delete.",
+          ],
+          labels: ["harness", "approved-disposable"],
+        },
+      }],
+    });
+    const created = this.cli(["suggestions", "create", "--file", createFile, "--no-sync", "--json"], { actorScope: actor, timeoutMs: 180000 });
+    const suggestionId = pickSuggestionId(created);
+    assertCondition(suggestionId, "Approved mission create did not return suggestion_id.");
+    this.openSuggestions.add(suggestionId);
+    const reviewFile = writeJson(this.payloadDir, `approved-review-${index}.json`, {
+      items: [{
+        suggestion_id: suggestionId,
+        action: "approve",
+        review_action: "approve",
+        final_change_set: {
+          title,
+          description,
+          acceptance_criteria: [
+            "Mission can be created through suggestion approval.",
+            "Mission can be mutated through project-key mission commands.",
+            "Mission can be archived without hard delete.",
+          ],
+          labels: ["harness", "approved-disposable"],
+        },
+      }],
+    });
+    const reviewed = this.cli(["suggestions", "review", "--file", reviewFile, "--json"], { actorScope: actor, timeoutMs: 180000 });
+    const missionId = pickAppliedMissionId(reviewed);
+    assertCondition(missionId, "Approved mission review did not return applied mission id.");
+    this.createdMissions.add(missionId);
+    this.openSuggestions.delete(suggestionId);
+    return { mission_id: missionId, suggestion_id: suggestionId, title };
+  }
+
+  async scenarioApprovedLifecycle() {
+    this.requireLive("approved_lifecycle");
+    if (this.archiveRouteAvailable !== true) await this.probeArchiveRoute();
+    const actor = `${this.actorBase}-approved-lifecycle`;
+    const created = await this.createApprovedMission(actor, 1);
+    let pendingSuggestionId = "";
+    try {
+      const activeAfterCreate = await this.bootstrap();
+      assertCondition(hasMissionInBootstrap(activeAfterCreate, created.mission_id), "Approved mission is missing from active bootstrap state.");
+
+      for (const status of ["in_progress", "done", "todo"]) {
+        const result = this.cli(["mission", "status", "--mission-ids", created.mission_id, "--status", status, "--json"], { timeoutMs: 180000 });
+        assertCondition((result.matched_count || 0) >= 1, `Mission status ${status} did not match the disposable mission.`);
+      }
+      const noop = this.cli(["mission", "status", "--mission-ids", created.mission_id, "--status", "todo", "--json"], { timeoutMs: 180000 });
+      assertCondition((noop.unchanged_count || 0) >= 1 || (noop.matched_count || 0) >= 1, "Idempotent mission status no-op did not report a stable match.");
+
+      const pendingFile = writeJson(this.payloadDir, "approved-lifecycle-pending-update.json", {
+        items: [{
+          change_type: "update",
+          mission_id: created.mission_id,
+          change_description: "Harness pending suggestion across archive",
+          change_set: { description: "Harness pending suggestion should be hidden from actionable queue while archived." },
+        }],
+      });
+      const pending = this.cli(["suggestions", "create", "--file", pendingFile, "--no-sync", "--json"], { actorScope: actor, timeoutMs: 180000 });
+      pendingSuggestionId = pickSuggestionId(pending);
+      assertCondition(pendingSuggestionId, "Pending update suggestion for approved mission was not created.");
+      this.openSuggestions.add(pendingSuggestionId);
+
+      const archived = await this.archiveMissions([created.mission_id], "Harness archive active mission with pending suggestion");
+      assertCondition((archived.updated_count || 0) + (archived.unchanged_count || 0) >= 1, "Archive did not update or confirm the disposable mission.");
+
+      const afterArchive = await this.bootstrap();
+      assertCondition(!hasMissionInBootstrap(afterArchive, created.mission_id), "Archived mission is still present in active bootstrap state.");
+      const archivedSuggestions = await this.suggestions(actor);
+      const archivedQueueRefs = queueRefs(archivedSuggestions).filter((item) => item.mission_id.toUpperCase() === created.mission_id.toUpperCase());
+      assertCondition(archivedQueueRefs.length === 0, "Archived mission still appears in actionable suggestion queue.");
+      const archivedThreadRefs = threadRefs(archivedSuggestions).filter((item) => item.suggestion_id === pendingSuggestionId);
+      assertCondition(archivedThreadRefs.length >= 1, "Archived mission pending suggestion was not preserved in thread history.");
+
+      await this.rejectSuggestion(pendingSuggestionId, actor, "Harness cleanup reject after archived-thread preservation check.");
+      this.openSuggestions.delete(pendingSuggestionId);
+      return {
+        mission_id: created.mission_id,
+        create_suggestion_id: created.suggestion_id,
+        pending_suggestion_id: pendingSuggestionId,
+        archive_hides_active: true,
+        archive_preserves_thread_history: true,
+      };
+    } catch (error) {
+      if (pendingSuggestionId) {
+        try {
+          await this.rejectSuggestion(pendingSuggestionId, actor, "Harness failure cleanup reject.");
+          this.openSuggestions.delete(pendingSuggestionId);
+        } catch (_) {}
+      }
+      try {
+        await this.archiveMissions([created.mission_id], "Harness failure cleanup archive.");
+      } catch (_) {}
+      throw error;
+    }
+  }
+
+  async scenarioBatchLimits() {
+    const statusIds = Array.from({ length: 101 }, (_, index) => `ZZ${String(index).padStart(3, "0")}`).join(",");
+    const qaqcIds = Array.from({ length: 11 }, (_, index) => `ZZ${String(index).padStart(3, "0")}`).join(",");
+    const archiveProbe = await this.api("/project-assistant/mission-archive", {
+      method: "POST",
+      idempotencyKey: `mission-live-full-archive-limit-${nowId()}`,
+      body: {
+        mission_ids: Array.from({ length: 101 }, (_, index) => `ZZ${String(index).padStart(3, "0")}`),
+        reason: "Harness limit check",
+      },
+    });
+    const checks = [
+      this.cli(["mission", "status", "--mission-ids", statusIds, "--status", "todo", "--json"], { expectFailure: true, parseJson: false, timeoutMs: 180000 }),
+      this.cli(["run-qaqc", "--mission-ids", qaqcIds, "--json"], { expectFailure: true, parseJson: false, timeoutMs: 180000 }),
+    ];
+    assertCondition(
+      archiveProbe.statusCode === 400 || archiveProbe.statusCode === 404,
+      `Expected archive limit check to return 400 when route is live or 404 when route is absent, got ${archiveProbe.statusCode}.`,
+    );
+    return {
+      checks: checks.length + 1,
+      mission_status_limit: 100,
+      run_qaqc_limit: 10,
+      archive_limit: archiveProbe.statusCode === 400 ? 100 : "route_not_live",
+    };
+  }
+
+  async scenarioBatchMutation() {
+    this.requireLive("batch_mutation");
+    if (this.archiveRouteAvailable !== true) await this.probeArchiveRoute();
+    const actor = `${this.actorBase}-batch`;
+    const created = [];
+    try {
+      for (let index = 1; index <= this.batchSize; index += 1) {
+        created.push(await this.createApprovedMission(actor, index));
+      }
+      const missionIds = created.map((item) => item.mission_id);
+      for (const status of ["in_progress", "done", "todo"]) {
+        const result = this.cli(["mission", "status", "--mission-ids", missionIds.join(","), "--status", status, "--json"], { timeoutMs: 240000 });
+        assertCondition((result.matched_count || 0) === missionIds.length, `Batch status ${status} matched ${result.matched_count || 0}/${missionIds.length}.`);
+      }
+      const archived = await this.archiveMissions(missionIds, "Harness batch cleanup archive");
+      assertCondition((archived.updated_count || 0) + (archived.unchanged_count || 0) === missionIds.length, "Batch archive did not cover every disposable mission.");
+      return { mission_count: missionIds.length, mission_ids: missionIds };
+    } catch (error) {
+      try {
+        await this.archiveMissions(created.map((item) => item.mission_id), "Harness batch failure cleanup archive");
+      } catch (_) {}
+      throw error;
+    }
+  }
+
+  async scenarioQaqc() {
+    const sync = this.cli(["sync-qaqc", "--json"], { timeoutMs: 180000 });
+    const result = {
+      sync_mission_count: sync.counts?.missions || sync.missions_count || 0,
+      run_executed: false,
+    };
+    if (!this.includeQaqcRun) {
+      result.skipped_run_reason = "Pass --include-qaqc-run to queue a live QAQC batch.";
+      return result;
+    }
+    this.requireLive("qaqc run");
+    const bootstrap = await this.bootstrap();
+    const mission = chooseQaqcMission(bootstrap);
+    assertCondition(mission, "No active non-Done mission with test cases is available for QAQC run.");
+    const missionId = missionPublicId(mission);
+    const run = this.cli(["run-qaqc", "--mission-ids", missionId, "--wait", "--sync", "--json"], { timeoutMs: 600000 });
+    result.run_executed = true;
+    result.mission_id = missionId;
+    result.batch_id = run.batch_id || null;
+    result.status = run.status || null;
+    result.accepted_count = run.accepted_count || 0;
+    assertCondition(result.accepted_count > 0, `QAQC run did not accept ${missionId}; status=${result.status || "unknown"}.`);
+    return result;
+  }
+
+  scenarioMap() {
+    return {
+      preflight: () => this.scenarioPreflight(),
+      contracts: () => this.scenarioContracts(),
+      suggestion_update_loop: () => this.scenarioSuggestionUpdateLoop(),
+      create_reject_loop: () => this.scenarioCreateRejectLoop(),
+      archive_route_probe: () => this.probeArchiveRoute(),
+      approved_lifecycle: () => this.scenarioApprovedLifecycle(),
+      batch_limits: () => this.scenarioBatchLimits(),
+      batch_mutation: () => this.scenarioBatchMutation(),
+      qaqc: () => this.scenarioQaqc(),
+    };
+  }
+
+  async runScenario(name) {
+    const startedAt = new Date().toISOString();
+    const entry = { name, status: "running", started_at: startedAt };
+    this.report.scenarios.push(entry);
+    const map = this.scenarioMap();
+    if (!map[name]) throw new Error(`Unknown scenario: ${name}`);
+    try {
+      const details = await map[name]();
+      entry.status = "passed";
+      entry.completed_at = new Date().toISOString();
+      entry.details = safeResult(details || {});
+      console.log(`[pass] ${name}`);
+    } catch (error) {
+      entry.status = "failed";
+      entry.completed_at = new Date().toISOString();
+      entry.error = String(error?.message || error);
+      console.error(`[fail] ${name}: ${entry.error}`);
+      if (!this.keepGoing) throw error;
+    } finally {
+      this.writeReport();
+    }
+  }
+
+  writeReport() {
+    this.report.created_mission_ids = Array.from(this.createdMissions).sort();
+    this.report.open_suggestion_ids = Array.from(this.openSuggestions).sort();
+    if (!this.report.completed_at) {
+      this.report.status = this.report.scenarios.some((item) => item.status === "failed") ? "failed" : "running";
+    }
+    ensureDir(path.dirname(this.reportPath));
+    fs.writeFileSync(this.reportPath, JSON.stringify(this.report, null, 2), "utf8");
+  }
+
+  async run() {
+    this.requireKey();
+    ensureDir(this.workspace);
+    ensureDir(this.payloadDir);
+    console.log(`Workspace: ${this.workspace}`);
+    console.log(`Report: ${this.reportPath}`);
+    console.log(`Scenarios: ${this.scenarios.join(", ")}`);
+    if (!this.confirmLive) {
+      console.log("Live mutations disabled. Pass --confirm-live to run mutating scenarios.");
+    }
+    for (const scenario of this.scenarios) {
+      await this.runScenario(scenario);
+    }
+    const failed = this.report.scenarios.filter((item) => item.status === "failed");
+    this.report.status = failed.length ? "failed" : "passed";
+    this.report.completed_at = new Date().toISOString();
+    this.writeReport();
+    console.log(JSON.stringify({
+      status: this.report.status,
+      report_file: this.reportPath,
+      passed: this.report.scenarios.filter((item) => item.status === "passed").length,
+      failed: failed.length,
+      created_mission_ids: this.report.created_mission_ids,
+      open_suggestion_ids: this.report.open_suggestion_ids,
+    }, null, 2));
+    if (failed.length && this.args["no-fail-exit"] !== true) process.exitCode = 1;
+  }
+}
+
+const args = parseArgs(process.argv.slice(2));
+new Harness(args).run().catch((error) => {
+  console.error(error?.message || error);
+  process.exit(1);
+});