@mytegroupinc/myte-core 0.0.54 → 0.0.56

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

@@ -8,6 +8,7 @@ const { spawnSync } = require("node:child_process");
 
 const CLI_PATH = path.resolve(__dirname, "..", "cli.js");
 const DEFAULT_BASE_URL = "https://api.myte.dev/api";
+const PACKAGE_VERSION = require("../package.json").version;
 
 function parseArgs(argv) {
   const args = { _: [] };
@@ -285,7 +286,7 @@ class Harness {
     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.packageVersion = String(args["package-version"] || PACKAGE_VERSION);
     this.batchSize = Math.max(1, Math.min(10, Number(args["batch-size"] || 10)));
     this.includeQaqcRun = args["include-qaqc-run"] === true;
     this.workspace = path.resolve(
@@ -433,7 +434,7 @@ class Harness {
         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 first = this.cli(["suggestions", "create", "--file", createOne, "--confirm-write", "--approval-artifact", createOne, "--no-sync", "--json"], { actorScope: actor });
     const suggestionId = pickSuggestionId(first);
     assertCondition(suggestionId, "Update suggestion create did not return suggestion_id.");
     this.openSuggestions.add(suggestionId);
@@ -446,7 +447,7 @@ class Harness {
         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 second = this.cli(["suggestions", "create", "--file", createTwo, "--confirm-write", "--approval-artifact", createTwo, "--no-sync", "--json"], { actorScope: actor });
     const appendedId = pickSuggestionId(second);
     assertCondition(appendedId === suggestionId, `Expected append to same suggestion ${suggestionId}, got ${appendedId || "(none)"}.`);
 
@@ -457,7 +458,7 @@ class Harness {
         change_set: { technical_requirements: ["Harness proposed requirement. This should be rejected."] },
       }],
     });
-    const revised = this.cli(["suggestions", "revise", "--file", revise, "--no-sync", "--json"], { actorScope: actor });
+    const revised = this.cli(["suggestions", "revise", "--file", revise, "--confirm-write", "--approval-artifact", 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", {
@@ -473,7 +474,7 @@ class Harness {
         change_set: { labels: ["harness-proposed-update"] },
       }],
     });
-    const revisedAgain = this.cli(["suggestions", "revise", "--file", reviseAfterRequest, "--no-sync", "--json"], { actorScope: actor });
+    const revisedAgain = this.cli(["suggestions", "revise", "--file", reviseAfterRequest, "--confirm-write", "--approval-artifact", 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", {
@@ -504,7 +505,7 @@ class Harness {
         },
       }],
     });
-    const created = this.cli(["suggestions", "create", "--file", createFile, "--no-sync", "--json"], { actorScope: actor });
+    const created = this.cli(["suggestions", "create", "--file", createFile, "--confirm-write", "--approval-artifact", createFile, "--no-sync", "--json"], { actorScope: actor });
     const suggestionId = pickSuggestionId(created);
     assertCondition(suggestionId, "Create suggestion did not return suggestion_id.");
     this.openSuggestions.add(suggestionId);
@@ -522,7 +523,7 @@ class Harness {
         change_set: { description: "Harness revised proposal. This should still be rejected." },
       }],
     });
-    const revised = this.cli(["suggestions", "revise", "--file", reviseFile, "--no-sync", "--json"], { actorScope: actor });
+    const revised = this.cli(["suggestions", "revise", "--file", reviseFile, "--confirm-write", "--approval-artifact", 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", {
@@ -579,7 +580,7 @@ class Harness {
         },
       }],
     });
-    const created = this.cli(["suggestions", "create", "--file", createFile, "--no-sync", "--json"], { actorScope: actor, timeoutMs: 180000 });
+    const created = this.cli(["suggestions", "create", "--file", createFile, "--confirm-write", "--approval-artifact", 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);
@@ -633,7 +634,7 @@ class Harness {
           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 });
+      const pending = this.cli(["suggestions", "create", "--file", pendingFile, "--confirm-write", "--approval-artifact", 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);

package/scripts/project-assistant-live-full-harness.js

@@ -0,0 +1,208 @@
+#!/usr/bin/env node
+"use strict";
+
+const fs = require("node:fs");
+const os = require("node:os");
+const path = require("node:path");
+const { randomUUID } = require("node:crypto");
+const { spawn, spawnSync } = require("node:child_process");
+
+const ROOT = path.resolve(__dirname, "..");
+const CLI = path.join(ROOT, "cli.js");
+const DEFAULT_BASE_URL = "https://api.myte.dev/api";
+const GAAHFIELD_PROJECT_ALIASES = new Set(["gaahfield", "gaahfield marketplace"]);
+const ROUTES = [
+  "POST /query", "GET /query/<job_id>", "GET /config", "GET /bootstrap",
+  "GET /qaqc-sync", "POST /run-qaqc", "GET /run-qaqc/<batch_id>",
+  "POST /mission-status-update", "POST /mission-archive", "GET /feedback-sync",
+  "GET /feedback/<feedback_id>", "POST /feedback/<feedback_id>/refinement/validate",
+  "POST /feedback/<feedback_id>/refinement/requests",
+  "POST /feedback-review-requests/<request_id>/revise",
+  "POST /feedback/<feedback_id>/refinement/apply",
+  "GET /feedback/<feedback_id>/refinement/history", "GET /feedback-review-requests",
+  "GET /feedback-review-requests/<request_id>",
+  "POST /feedback-review-requests/<request_id>/review",
+  "POST /feedback-review-requests/batch-review",
+  "POST /feedback-review-requests/<request_id>/request-changes",
+  "POST /feedback-review-requests/<request_id>/cancel",
+  "POST /feedback/<feedback_id>/board-move", "POST /feedback/batch-board-move",
+  "POST /feedback/<feedback_id>/comments", "GET /feedback/<feedback_id>/events",
+  "GET /feedback/<feedback_id>/tickets", "POST /feedback/<feedback_id>/tickets",
+  "POST /feedback/<feedback_id>/tickets/batch", "POST /feedback/<feedback_id>/tickets/batch/validate",
+  "PATCH /feedback/<feedback_id>/tickets/<ticket_id>", "PATCH /feedback/<feedback_id>/tickets/batch",
+  "POST /feedback/<feedback_id>/tickets/batch-update/validate",
+  "PATCH /feedback/<feedback_id>/tickets/<ticket_id>/prd-coverage",
+  "POST /feedback/<feedback_id>/events/<event_id>/undo",
+  "GET /feedback/<feedback_id>/prd/versions",
+  "GET /feedback/<feedback_id>/prd/versions/<version_id>/diff",
+  "POST /project-comment", "POST /update-owner", "POST /client-update-drafts",
+  "POST /create-prd", "POST /create-prds", "GET /suggestions", "POST /suggestions",
+  "POST /suggestions/revise", "POST /suggestions/review",
+];
+
+const COVERAGE = {
+  read: ROUTES.filter((route) => route.startsWith("GET ") || route.startsWith("POST /query")),
+  mission: ROUTES.filter((route) => /mission|qaqc|suggestion/.test(route)),
+  feedback: ROUTES.filter((route) => /feedback|create-prd/.test(route)),
+  communications: ROUTES.filter((route) => /project-comment|update-owner|client-update/.test(route)),
+};
+
+function parseArgs(argv) {
+  const args = {};
+  for (let index = 0; index < argv.length; index += 1) {
+    const token = argv[index];
+    if (!token.startsWith("--")) continue;
+    const next = argv[index + 1];
+    if (!next || next.startsWith("--")) args[token.slice(2)] = true;
+    else { args[token.slice(2)] = next; index += 1; }
+  }
+  return args;
+}
+
+function normalizeProjectTitle(value) {
+  return String(value || "").trim().toLowerCase().replace(/\s+/g, " ");
+}
+
+function isGaahFieldProject(value) {
+  return GAAHFIELD_PROJECT_ALIASES.has(normalizeProjectTitle(value));
+}
+
+function routeCoverage() {
+  const accounted = new Set(Object.values(COVERAGE).flat());
+  const missing = ROUTES.filter((route) => !accounted.has(route));
+  if (ROUTES.length !== 46 || new Set(ROUTES).size !== 46 || missing.length) {
+    throw new Error(`Route manifest is incomplete: ${missing.join(", ") || "count/duplicate mismatch"}`);
+  }
+  return { implemented_project_key_routes: 46, accounted_routes: accounted.size, missing };
+}
+
+function runNode(script, args, cwd) {
+  const result = spawnSync(process.execPath, [script, ...args], {
+    cwd, env: process.env, encoding: "utf8", stdio: ["ignore", "pipe", "pipe"], timeout: 1_800_000,
+  });
+  let output = null;
+  try { output = JSON.parse(String(result.stdout || "").trim() || "null"); } catch {}
+  return {
+    command: path.basename(script), ok: result.status === 0,
+    exit_code: result.status, output,
+    error: result.status === 0 ? null : String(result.stderr || result.stdout || "failed").trim().slice(0, 2000),
+  };
+}
+
+function runCli(args, cwd) {
+  return runNode(CLI, args, cwd);
+}
+
+function runNodeAsync(script, args, cwd) {
+  return new Promise((resolve) => {
+    const child = spawn(process.execPath, [script, ...args], { cwd, env: process.env, stdio: ["ignore", "pipe", "pipe"] });
+    let stdout = "";
+    let stderr = "";
+    child.stdout.on("data", (chunk) => { stdout += chunk; });
+    child.stderr.on("data", (chunk) => { stderr += chunk; });
+    child.on("close", (code) => {
+      let output = null;
+      try { output = JSON.parse(stdout.trim() || "null"); } catch {}
+      resolve({ ok: code === 0, exit_code: code, output, error: code === 0 ? null : (stderr || stdout).trim().slice(0, 2000) });
+    });
+  });
+}
+
+function isIdempotencyInProgress(result) {
+  return !result?.ok && /idempotency key is still in progress/i.test(String(result?.error || ""));
+}
+
+async function settleIdempotentReplay(script, args, cwd, initialResult) {
+  let result = initialResult;
+  for (let attempt = 0; attempt < 6 && isIdempotencyInProgress(result); attempt += 1) {
+    await new Promise((resolve) => setTimeout(resolve, Math.min(250 * (2 ** attempt), 2000)));
+    result = await runNodeAsync(script, args, cwd);
+  }
+  return result;
+}
+
+async function assertExpectedProject(baseUrl, expectedProject) {
+  const key = process.env.MYTE_API_KEY || process.env.MYTE_PROJECT_API_KEY;
+  if (!key) throw new Error("Missing MYTE_API_KEY or MYTE_PROJECT_API_KEY.");
+  const response = await fetch(`${String(baseUrl).replace(/\/+$/, "")}/project-assistant/bootstrap`, {
+    headers: { Authorization: `Bearer ${key}` },
+  });
+  const body = await response.json();
+  const title = String(body?.data?.project?.title || "").trim();
+  if (!response.ok || body?.status !== "success") throw new Error("Project bootstrap preflight failed.");
+  if (!isGaahFieldProject(expectedProject) || !isGaahFieldProject(title)) {
+    throw new Error(`Live target mismatch: expected ${expectedProject}, received ${title || "unknown"}.`);
+  }
+  return { project_id: body.data.project.id, title };
+}
+
+async function main() {
+  const args = parseArgs(process.argv.slice(2));
+  const coverage = routeCoverage();
+  if (!args["confirm-live"]) {
+    console.log(JSON.stringify({
+      ok: true, dry_run: true, network_requests: 0, live_mutations: 0, coverage,
+      stages: ["read", "mission", "feedback", "communications", "concurrent-idempotency", "exact-id-cleanup"],
+      required_live_flags: ["--confirm-live", "--expected-project GaahField", "--include-communications"],
+      owner_email_requires: "--include-owner-email",
+    }, null, 2));
+    return;
+  }
+  const expectedProject = String(args["expected-project"] || "").trim();
+  if (!isGaahFieldProject(expectedProject)) throw new Error("Live certification is pinned to --expected-project GaahField.");
+  if (!args["include-communications"]) throw new Error("Full live certification requires --include-communications.");
+  const baseUrl = String(args["base-url"] || process.env.MYTE_API_BASE || DEFAULT_BASE_URL).replace(/\/+$/, "");
+  const project = await assertExpectedProject(baseUrl, expectedProject);
+  const runId = String(args["run-id"] || randomUUID());
+  const workspace = path.resolve(args.workspace || fs.mkdtempSync(path.join(os.tmpdir(), `myte-full-${runId}-`)));
+  fs.mkdirSync(workspace, { recursive: true });
+  const common = ["--base-url", baseUrl, "--run-id", runId];
+  const results = [];
+  results.push(runNode(path.join(__dirname, "project-assistant-read-certification.js"), ["--confirm-read", "--include-query", ...common], workspace));
+  results.push(runNode(path.join(__dirname, "mission-live-full-harness.js"), ["--confirm-live", ...common], workspace));
+  results.push(runNode(path.join(__dirname, "feedback-live-full-harness.js"), ["--confirm-live", ...common], workspace));
+
+  const team = path.join(workspace, `team-${runId}.md`);
+  const client = path.join(workspace, `client-${runId}.md`);
+  fs.writeFileSync(team, `Project Assistant certification ${runId}: team update route verified.\n`, "utf8");
+  fs.writeFileSync(client, `Project Assistant certification ${runId}: client draft route verified; do not send.\n`, "utf8");
+  const teamArgs = ["update-team", `Certification ${runId}`, "--confirm-write", "--approval-artifact", team, "--idempotency-key", `cert-team-${runId}`, "--json", "--base-url", baseUrl];
+  const concurrentTeamInitial = await Promise.all(Array.from({ length: 10 }, () => runNodeAsync(CLI, teamArgs, workspace)));
+  const transientInProgress = concurrentTeamInitial.filter(isIdempotencyInProgress).length;
+  const concurrentTeam = [];
+  for (const result of concurrentTeamInitial) {
+    concurrentTeam.push(await settleIdempotentReplay(CLI, teamArgs, workspace, result));
+  }
+  const teamFingerprints = new Set(
+    concurrentTeam.filter((item) => item.ok).map((item) => JSON.stringify(item.output?.data || item.output || null)),
+  );
+  results.push({
+    command: "concurrent-idempotency:update-team",
+    ok: concurrentTeam.every((item) => item.ok) && teamFingerprints.size === 1,
+    attempts: concurrentTeam.length,
+    transient_in_progress: transientInProgress,
+    unique_outcomes: teamFingerprints.size,
+    error: concurrentTeam.find((item) => !item.ok)?.error || (teamFingerprints.size === 1 ? null : "Concurrent replays returned different mutation outcomes."),
+  });
+  results.push(runCli(["update-client", "--subject", `Certification ${runId}`, "--body-file", client, "--confirm-write", "--approval-artifact", client, "--idempotency-key", `cert-client-${runId}`, "--json", "--base-url", baseUrl], workspace));
+  if (args["include-owner-email"]) {
+    const owner = path.join(workspace, `owner-${runId}.md`);
+    fs.writeFileSync(owner, `Project Assistant certification ${runId}: owner delivery route verified.\n`, "utf8");
+    results.push(runCli(["update-owner", "--subject", `Certification ${runId}`, "--body-file", owner, "--confirm-write", "--approval-artifact", owner, "--idempotency-key", `cert-owner-${runId}`, "--json", "--base-url", baseUrl], workspace));
+  }
+  const failed = results.filter((result) => !result.ok);
+  const report = { ok: failed.length === 0, run_id: runId, project, coverage, workspace, results, failed_count: failed.length };
+  const reportPath = path.join(workspace, `project-assistant-certification-${runId}.json`);
+  fs.writeFileSync(reportPath, JSON.stringify(report, null, 2), "utf8");
+  console.log(JSON.stringify({ ...report, report_path: reportPath }, null, 2));
+  if (failed.length) process.exitCode = 1;
+}
+
+if (require.main === module) {
+  main().catch((error) => {
+    console.error(JSON.stringify({ ok: false, message: error?.message || String(error) }, null, 2));
+    process.exit(1);
+  });
+} else {
+  module.exports = { COVERAGE, DEFAULT_BASE_URL, ROUTES, isGaahFieldProject, isIdempotencyInProgress, routeCoverage };
+}