@mytegroupinc/myte-core 0.0.55 → 0.0.56

package/cli.js

@@ -231,6 +231,12 @@ function printHelp() {
     "  myte feedback move --feedback-id <id> --to-state in_progress --from-state todo --reason \"...\" [--json]",
     "  myte feedback move --feedback-ids \"<id1,id2>\" --to-state in_progress --reason \"...\" [--json]",
     "  myte feedback comment --feedback-id <id> --body \"...\" [--body-file ./comment.md] --confirm-write --approval-artifact <path> [--json]",
+    "  myte feedback tickets list --feedback-id <id> [--json]",
+    "  myte feedback tickets create --feedback-id <id> --file ./ticket.yml --confirm-write --approval-artifact <path> [--json]",
+    "  myte feedback tickets create --feedback-id <id> --file ./ticket-batch.yml --dry-run [--json]",
+    "  myte feedback tickets update --feedback-id <id> --ticket-ids \"<id1,id2>\" --status in_progress --confirm-write --approval-artifact <path> [--json]",
+    "  myte feedback tickets update --feedback-id <id> --file ./ticket-updates.yml --dry-run [--json]",
+    "  myte feedback tickets coverage --feedback-id <id> --ticket-id <id> --version-id <id> --document-id <id> --coverage-status covered --confirm-write --approval-artifact <path> [--json]",
     "  myte feedback undo --feedback-id <id> --event-id <id> --reason \"...\" [--json]",
     "  myte feedback prd-versions --feedback-id <id> [--json]",
     "  myte feedback prd-diff --feedback-id <id> --version-id <id> [--compare-to <id>] [--document-id <id>] [--json]",
@@ -311,7 +317,8 @@ function printHelp() {
     "  - Explicit assignees must be the project owner or an active assigned project collaborator",
     "  - Never put the full PRD in description. The complete PRD must live in the markdown file body",
     "  - Each item carries the full PRD markdown blob as prd_markdown/ticket_markdown",
-    "  - Backend stores that blob as the renderable PRD document source, mirrors it for PRD text search/sync, and generates a DOCX attachment",
+    "  - Backend stores that blob as the renderable PRD document source, mirrors it for PRD text search/sync, and generates a DOCX attachment",
+    "  - Successful creation returns active_prd_version_id, active_prd_version_number, and primary_document_id for immediate sub-ticket linking",
     "  - Renderer-friendly PRDs use one # title, ## sections, bullets, GitHub tables/checklists where useful, and code fences only for real code/config",
     "  - Do not wrap the whole PRD in a ```markdown fence; generic .md/.docx/.pdf/.txt uploads are normal attachments unless created as PRDs",
     "  - PRD DOCX content: the markdown body is stored verbatim",
@@ -320,10 +327,10 @@ function printHelp() {
     "  - Creates a project team comment through /api/project-assistant/project-comment",
     "  - Required: content (inline, --content, or --stdin)",
     "",
-    "update-owner contract:",
-    "  - Queues a durable owner email delivery through /api/project-assistant/update-owner",
+    "update-owner contract:",
+    "  - Queues a durable owner email delivery through /api/project-assistant/update-owner",
     "  - Required: --subject and body markdown (via --body-markdown, --body-file, positional file/text, or --stdin)",
-    "  - Resolves the owner synchronously; the existing notification worker delivers with a deterministic delivery id",
+    "  - Resolves the owner synchronously; the existing notification worker delivers with a deterministic delivery id",
     "",
     "update-client contract:",
     "  - Creates a client update draft through /api/project-assistant/client-update-drafts",
@@ -352,6 +359,9 @@ function printHelp() {
     "  - move with --feedback-ids sends one batch board move request; it supports active-state moves and authorized archive",
     "  - comment creates text-only feedback-specific comments; attachments remain web UI only for this endpoint",
     "  - project-key API/CLI cannot unarchive archived Feedback; use the web archived Feedback view",
+    "  - tickets list/create/update/coverage govern multiple engineering subtickets linked to the same PRD; create/update files accept JSON or YAML and batches are capped at 100",
+    "  - Each ticket may link at most 25 PRD documents; the backend rejects version/document links outside that exact PRD before mutation",
+    "  - tickets create/update --dry-run uses the server validation routes without mutating; live writes require revisions, idempotency and a structured approval artifact",
     "  - get/history read current feedback snapshots and audited event history through the project-key API",
     "  - prd-versions/prd-diff expose retained PRD versions and backend-generated per-document text diffs",
     "  - edit/refine with --prd-file updates a review artifact only; --document-id targets one document in a PRD document set",
@@ -361,7 +371,7 @@ function printHelp() {
     "  - apply is idempotent and does not rewrite local feedback.yml; run feedback-sync after apply to refresh local state",
     "",
     "approval artifact requirements:",
-    "  - Required: create-prd, update-team, update-owner, update-client, feedback submit/revise/comment, suggestions create/revise",
+    "  - Required: create-prd, update-team, update-owner, update-client, feedback submit/revise/comment, feedback tickets create/update/coverage, suggestions create/revise",
     "  - Not required: run-qaqc, mission status/archive, suggestions review, feedback review/move/undo/apply",
     "  - Never required: read/sync/query/validate commands, --print-context, --dry-run, and feedback local draft commands",
     "  - For required actions, prepare a .md/.markdown/.yml/.yaml/.json artifact, show it to the user, then rerun with --confirm-write --approval-artifact <path>",
@@ -383,6 +393,7 @@ function printHelp() {
     "  - move: direct audited board movement for allowed states; governed transitions remain backend-authorized",
     "  - document-add: create a governed proposal to append one linked PRD document to an existing Feedback item",
     "  - comment: create a text-only comment on one Feedback item",
+    "  - tickets: list, validate, create and revision-fence single or batch PRD subticket lifecycle changes",
     "  - undo: reverse an audited board event when conflict checks allow it",
     "  - prd-versions: list retained PRD baselines/revisions for a feedback item",
     "  - prd-diff: fetch backend-generated text diff between PRD versions",
@@ -418,6 +429,10 @@ function printHelp() {
     "  --target-contact-ids  Comma-separated client contact ObjectIds",
     "  --feedback-id <id>    Feedback ObjectId for feedback review commands",
     "  --feedback-ids <ids>  Comma-separated Feedback ObjectIds for batch feedback move",
+    "  --ticket-id <id>       Feedback PRD subticket ObjectId for single update or coverage",
+    "  --ticket-ids <ids>     Comma-separated subticket ObjectIds for one batch update",
+    "  --severity <value>     Ticket severity target: Critical, High, Medium, Low, or Info",
+    "  --coverage-status <value> Ticket PRD coverage: not_covered, partially_covered, covered, or not_applicable",
     "  --request-id <id>     Feedback review request ObjectId for submit/revise/review flows",
     "  --request-ids <ids>   Comma-separated Feedback review request ObjectIds for batch review",
     "  --event-id <id>       Feedback board event ObjectId for undo",
@@ -477,6 +492,9 @@ function printHelp() {
     "  myte feedback review --request-id 507f1f77bcf86cd799439022 --action approve --reason \"Looks correct\" --json",
     "  myte feedback move --feedback-id 507f1f77bcf86cd799439011 --to-state in_progress --reason \"Started\" --json",
     "  myte feedback comment --feedback-id 507f1f77bcf86cd799439011 --body-file ./comments/implementation.md --confirm-write --approval-artifact ./comments/implementation.md --json",
+    "  myte feedback tickets list --feedback-id 507f1f77bcf86cd799439011 --json",
+    "  myte feedback tickets create --feedback-id 507f1f77bcf86cd799439011 --file ./tickets/auth.yml --dry-run --json",
+    "  myte feedback tickets update --feedback-id 507f1f77bcf86cd799439011 --ticket-ids \"507f1f77bcf86cd799439021,507f1f77bcf86cd799439022\" --status in_progress --confirm-write --approval-artifact ./tickets/update.yml --json",
     "  myte feedback document-add --feedback-id 507f1f77bcf86cd799439011 --prd-file ./drafts/sidebar-branding.md --title \"Individual Use Sidebar Branding\" --reason \"Link governed UX addendum to the Feedback context.\"",
     "  myte feedback validate --file ./MyteCommandCenter/reviews/feedback/507f1f77bcf86cd799439011-status.yml --json",
     "  myte feedback apply --file ./MyteCommandCenter/reviews/feedback/507f1f77bcf86cd799439011-status.yml --json",
@@ -2589,6 +2607,59 @@ async function postFeedbackComment({ apiBase, key, timeoutMs, feedbackId, payloa
   return body.data || {};
 }
 
+function parseFeedbackTicketIdsArg(args) {
+  return dedupeStrings(
+    parseCsvValues(
+      args["ticket-ids"],
+      args.ticketIds,
+      args.ticket_ids,
+      args["ticket-id"],
+      args.ticketId,
+      args.ticket_id
+    )
+  );
+}
+
+async function requestFeedbackTickets({
+  apiBase,
+  key,
+  timeoutMs,
+  feedbackId,
+  endpoint = "",
+  method = "GET",
+  payload,
+  idempotencyKey,
+  clientSessionId,
+}) {
+  const fetchFn = await getFetch();
+  const suffix = endpoint ? `/${String(endpoint).replace(/^\/+/, "")}` : "";
+  const url = `${apiBase}/project-assistant/feedback/${encodeURIComponent(String(feedbackId || ""))}/tickets${suffix}`;
+  const headers = {
+    Authorization: `Bearer ${key}`,
+    ...(String(clientSessionId || "").trim() ? { "X-Client-Session-Id": String(clientSessionId).trim() } : {}),
+  };
+  if (payload !== undefined) headers["Content-Type"] = "application/json";
+  if (idempotencyKey) headers["X-Idempotency-Key"] = String(idempotencyKey).trim();
+  const { resp, body } = await fetchJsonWithTimeout(
+    fetchFn,
+    url,
+    {
+      method,
+      headers,
+      ...(payload !== undefined ? { body: JSON.stringify(payload || {}) } : {}),
+    },
+    timeoutMs
+  );
+  if (!resp.ok || body.status !== "success") {
+    const msg = body?.message || `Feedback ticket request failed (${resp.status})`;
+    const err = new Error(msg);
+    err.status = resp.status;
+    err.data = body?.data;
+    throw err;
+  }
+  return body.data || {};
+}
+
 async function fetchFeedbackPrdVersions({ apiBase, key, timeoutMs, feedbackId }) {
   const fetchFn = await getFetch();
   const url = `${apiBase}/project-assistant/feedback/${encodeURIComponent(String(feedbackId || ""))}/prd/versions`;
@@ -2807,7 +2878,7 @@ async function createMissionArchiveUpdate({ apiBase, key, timeoutMs, endpoint, p
   return body.data || {};
 }
 
-async function fetchRunQaqcBatchStatus({ apiBase, key, timeoutMs, batchId }) {
+async function fetchRunQaqcBatchStatus({ apiBase, key, timeoutMs, batchId }) {
   const fetchFn = await getFetch();
   const url = `${apiBase}/project-assistant/run-qaqc/${encodeURIComponent(String(batchId || ""))}`;
   const { resp, body } = await fetchJsonWithTimeout(
@@ -2832,15 +2903,15 @@ async function fetchRunQaqcBatchStatus({ apiBase, key, timeoutMs, batchId }) {
     if (retryAfter) err.retryAfter = retryAfter;
     throw err;
   }
-  const data = body.data || {};
-  Object.defineProperty(data, "_nextPollAfterMs", {
-    value: successfulPollDelayMs(data, resp),
-    enumerable: false,
-  });
-  return data;
+  const data = body.data || {};
+  Object.defineProperty(data, "_nextPollAfterMs", {
+    value: successfulPollDelayMs(data, resp),
+    enumerable: false,
+  });
+  return data;
 }
 
-function resolveRetryAfterMs(err, fallbackMs = 5_000) {
+function resolveRetryAfterMs(err, fallbackMs = 5_000) {
   const retryAfterRaw = firstNonEmptyString(err?.retryAfter);
   const retryAfterSeconds = Number.parseInt(String(retryAfterRaw || ""), 10);
   if (Number.isFinite(retryAfterSeconds) && retryAfterSeconds > 0) {
@@ -2850,21 +2921,21 @@ function resolveRetryAfterMs(err, fallbackMs = 5_000) {
   if (Number.isFinite(retryAfterDate)) {
     return Math.min(Math.max(0, retryAfterDate - Date.now()), 60_000);
   }
-  return fallbackMs;
-}
-
-function successfulPollDelayMs(data, response, fallbackMs = 2_000) {
-  const payloadDelay = Number(data?.next_poll_after_ms);
-  const retryAfter = response?.headers?.get?.("retry-after");
-  const headerDelay = retryAfter ? resolveRetryAfterMs({ retryAfter }, 0) : 0;
-  const advertised = Math.max(
-    Number.isFinite(payloadDelay) && payloadDelay > 0 ? payloadDelay : 0,
-    headerDelay,
-  );
-  const base = Math.min(60_000, Math.max(250, advertised || fallbackMs));
-  const jitterLimit = Math.max(0, Math.min(1_000, Number(process.env.MYTE_POLL_JITTER_MS ?? 250) || 0));
-  return Math.min(60_000, base + (jitterLimit ? Math.floor(Math.random() * (jitterLimit + 1)) : 0));
-}
+  return fallbackMs;
+}
+
+function successfulPollDelayMs(data, response, fallbackMs = 2_000) {
+  const payloadDelay = Number(data?.next_poll_after_ms);
+  const retryAfter = response?.headers?.get?.("retry-after");
+  const headerDelay = retryAfter ? resolveRetryAfterMs({ retryAfter }, 0) : 0;
+  const advertised = Math.max(
+    Number.isFinite(payloadDelay) && payloadDelay > 0 ? payloadDelay : 0,
+    headerDelay,
+  );
+  const base = Math.min(60_000, Math.max(250, advertised || fallbackMs));
+  const jitterLimit = Math.max(0, Math.min(1_000, Number(process.env.MYTE_POLL_JITTER_MS ?? 250) || 0));
+  return Math.min(60_000, base + (jitterLimit ? Math.floor(Math.random() * (jitterLimit + 1)) : 0));
+}
 
 function isTransientQueryStatusError(err) {
   return Boolean(
@@ -2883,9 +2954,22 @@ function createHttpResponseError(resp, body, url, fallbackMessage) {
   if (status === 401) {
     kind = "authentication";
     detail = "The API rejected the project key.";
-  } else if (status === 403) {
-    kind = "authorization";
-    detail = "The authenticated project identity is not allowed to perform this action.";
+  } else if (status === 403) {
+    kind = "authorization";
+    const responseCode = firstNonEmptyString(body?.data?.code, body?.code);
+    if (responseCode === "policy_consent_required") {
+      const consentPath = firstNonEmptyString(body?.data?.consent_url, body?.data?.mission_board_deeplink);
+      const requiredVersion = firstNonEmptyString(body?.data?.required_policy_version);
+      detail = [
+        firstNonEmptyString(body?.message) || "Myte Policy acceptance is required for this project.",
+        requiredVersion ? `Required policy version: ${requiredVersion}.` : "",
+        consentPath ? `Open the Myte mission board to review and accept: ${consentPath}` : "",
+      ]
+        .filter(Boolean)
+        .join(" ");
+    } else {
+      detail = "The authenticated project identity is not allowed to perform this action.";
+    }
   } else if (status === 429) {
     kind = "rate_limit";
     detail = "The API rate limit is temporarily exhausted.";
@@ -3008,7 +3092,7 @@ async function createAssistantQueryJob({
   return body.data || {};
 }
 
-async function fetchAssistantQueryJobStatus({ apiBase, key, timeoutMs, jobId, requestId }) {
+async function fetchAssistantQueryJobStatus({ apiBase, key, timeoutMs, jobId, requestId }) {
   const fetchFn = await getFetch();
   const url = `${apiBase}/project-assistant/query/${encodeURIComponent(String(jobId || ""))}`;
   const { resp, body } = await fetchJsonWithTimeout(
@@ -3027,12 +3111,12 @@ async function fetchAssistantQueryJobStatus({ apiBase, key, timeoutMs, jobId, re
   if (!resp.ok || body.status !== "success") {
     throw createHttpResponseError(resp, body, url, "The query status could not be loaded.");
   }
-  const data = body.data || {};
-  Object.defineProperty(data, "_nextPollAfterMs", {
-    value: successfulPollDelayMs(data, resp),
-    enumerable: false,
-  });
-  return data;
+  const data = body.data || {};
+  Object.defineProperty(data, "_nextPollAfterMs", {
+    value: successfulPollDelayMs(data, resp),
+    enumerable: false,
+  });
+  return data;
 }
 
 async function runRunQaqc(args) {
@@ -3092,15 +3176,15 @@ async function runRunQaqc(args) {
 
   let finalStatus = null;
   let syncSummary = null;
-  if (shouldWait && data.batch_id) {
-    const pollTimeoutMs = Math.max(timeoutMs, 900_000);
-    const startedAt = Date.now();
-    let pollDelayMs = 2_000;
-    do {
-      await sleep(pollDelayMs);
-      try {
-        finalStatus = await fetchRunQaqcBatchStatus({ apiBase, key, timeoutMs, batchId: data.batch_id });
-        pollDelayMs = Number(finalStatus?._nextPollAfterMs) || Math.min(10_000, Math.ceil(pollDelayMs * 1.25));
+  if (shouldWait && data.batch_id) {
+    const pollTimeoutMs = Math.max(timeoutMs, 900_000);
+    const startedAt = Date.now();
+    let pollDelayMs = 2_000;
+    do {
+      await sleep(pollDelayMs);
+      try {
+        finalStatus = await fetchRunQaqcBatchStatus({ apiBase, key, timeoutMs, batchId: data.batch_id });
+        pollDelayMs = Number(finalStatus?._nextPollAfterMs) || Math.min(10_000, Math.ceil(pollDelayMs * 1.25));
       } catch (err) {
         if (Number(err?.status) === 429) {
           await sleep(resolveRetryAfterMs(err));
@@ -4221,6 +4305,7 @@ function buildAgentsMyteApiMarkdown() {
     "- Mission edit/create batches use `myte suggestions create` or `myte suggestions revise`; the artifact must list each item. For mission edits include `change_type: update`, the existing `mission_id`, and the changed fields. For new missions include `change_type: create`, the proposed title, description, and acceptance details. For revisions include each `suggestion_id` and expected revision.",
     "- PRD batches use one `myte create-prd fileA.md fileB.md ...`; the artifact must list each PRD file/title/client ref. `batch_count` must match the number of PRD items.",
     "- Feedback submit/revise/comment artifacts are usually the same YAML or markdown file being submitted. If the command uses inline text or stdin, create a separate approval memo that includes the feedback id or request id and the exact content.",
+    "- Feedback ticket create/update/coverage artifacts must enumerate every ticket key/id, expected revision, PRD document link, and changed lifecycle field. Use --dry-run before the approved live batch.",
     "- Team, owner, and client update artifacts should name the audience and include the exact message body or a complete summary; client updates should include target contact ids when used.",
     "- `feedback review --request-ids`, `feedback move --feedback-ids`, `mission status --mission-ids`, `mission archive --mission-ids`, and `run-qaqc --mission-ids` are batched governed writes, but they are marked `no` below and should not receive approval artifact flags.",
     "",
@@ -4265,6 +4350,10 @@ function buildAgentsMyteApiMarkdown() {
     "| Feedback move | `myte feedback move --feedback-id <id> --to-state in_progress --reason \"...\" --json` | `POST /project-assistant/feedback/<id>/board-move` | governed write | no |",
     "| Feedback batch move | `myte feedback move --feedback-ids \"<id1,id2>\" --to-state in_progress --json` | `POST /project-assistant/feedback/batch-board-move` | governed write | no |",
     "| Feedback comment | `myte feedback comment --feedback-id <id> --body-file ./comment.md --confirm-write --approval-artifact ./comment.md --json` | `POST /project-assistant/feedback/<id>/comments` | comment write | required |",
+    "| Feedback tickets list | `myte feedback tickets list --feedback-id <id> --json` | `GET /project-assistant/feedback/<id>/tickets` | read | no |",
+    "| Feedback tickets create | `myte feedback tickets create --feedback-id <id> --file ./tickets.yml --confirm-write --approval-artifact ./tickets.yml --json` | `POST /project-assistant/feedback/<id>/tickets` or `/tickets/batch`; `--dry-run` uses `/tickets/batch/validate` | synchronous ticket write | required |",
+    "| Feedback tickets update | `myte feedback tickets update --feedback-id <id> --ticket-ids \"<id1,id2>\" --status in_progress --confirm-write --approval-artifact ./update.yml --json` | `PATCH /project-assistant/feedback/<id>/tickets/batch`; `--dry-run` uses `/tickets/batch-update/validate` | revision-fenced ticket write | required |",
+    "| Feedback ticket coverage | `myte feedback tickets coverage --feedback-id <id> --ticket-id <id> ... --confirm-write --approval-artifact ./coverage.yml --json` | `PATCH /project-assistant/feedback/<id>/tickets/<ticket_id>/prd-coverage` | revision-fenced ticket write | required |",
     "| Feedback undo | `myte feedback undo --feedback-id <id> --event-id <id> --reason \"...\" --json` | `POST /project-assistant/feedback/<id>/events/<event_id>/undo` | governed write | no |",
     "| Feedback PRD versions | `myte feedback prd-versions --feedback-id <id> --json` | `GET /project-assistant/feedback/<id>/prd/versions` | read | no |",
     "| Feedback PRD diff | `myte feedback prd-diff --feedback-id <id> --version-id <id>` | `GET /project-assistant/feedback/<id>/prd/versions/<version_id>/diff` | read | no |",
@@ -5541,14 +5630,14 @@ async function runCreatePrd(args) {
     console.error("--document-set requires one to three markdown file paths; --stdin is not supported.");
     process.exit(1);
   }
-  if (documentSetMode && (providedPaths.length < 1 || providedPaths.length > 3)) {
+  if (documentSetMode && (providedPaths.length < 1 || providedPaths.length > 3)) {
     console.error("--document-set requires between one and three markdown file paths.");
     process.exit(1);
-  }
-  if (!documentSetMode && providedPaths.length > 20) {
-    console.error("create-prd accepts at most 20 files per batch.");
-    process.exit(1);
-  }
+  }
+  if (!documentSetMode && providedPaths.length > 20) {
+    console.error("create-prd accepts at most 20 files per batch.");
+    process.exit(1);
+  }
 
   const buildCreatePrdPayload = ({ sourceText, filePath, includeClientRef = false }) => {
     const trimmedSource = String(sourceText || "").trim();
@@ -6195,12 +6284,15 @@ async function runConfig(args) {
   const apiBase = normalizeApiBase(baseRaw);
 
   let cfg;
-  try {
-    cfg = await fetchProjectConfig({ apiBase, key, timeoutMs });
-  } catch (err) {
-    console.error("Failed to fetch config:", err?.message || err);
-    process.exit(1);
-  }
+  try {
+    cfg = await fetchProjectConfig({ apiBase, key, timeoutMs });
+  } catch (err) {
+    console.error("Failed to fetch config:", err?.message || err);
+    // Let Node drain its native fetch handles instead of forcing libuv closed.
+    // Immediate process.exit() can abort on Windows after an HTTP error.
+    process.exitCode = 1;
+    return;
+  }
 
   const repoNames = Array.isArray(cfg.repo_names) ? cfg.repo_names : [];
   const repoBindings = Array.isArray(cfg.repo_bindings) ? cfg.repo_bindings : [];
@@ -7710,6 +7802,213 @@ async function runFeedbackGetOrHistory(args, mode) {
   console.log(`Snapshot: ${feedback.snapshot_hash || "n/a"}`);
 }
 
+async function runFeedbackTickets(args) {
+  const key = getProjectApiKey();
+  if (!key) {
+    console.error("Missing MYTE_API_KEY (project key) in environment/.env");
+    process.exit(1);
+  }
+  const action = String(firstNonEmptyString(args._?.[1], "list")).trim().toLowerCase().replace(/_/g, "-");
+  const feedbackId = resolveFeedbackIdArg(args);
+  if (!feedbackId) {
+    console.error("Missing --feedback-id.");
+    process.exit(1);
+  }
+  const apiBase = resolveApiBase(args);
+  const timeoutMs = resolveTimeoutMs(args);
+  const clientSessionId = firstNonEmptyString(args["client-session-id"], args.clientSessionId, args.client_session_id);
+  const dryRun = Boolean(args["dry-run"] || args.dryRun || action.startsWith("validate-"));
+
+  const call = async (requestOptions) => requestFeedbackTickets({
+    apiBase,
+    key,
+    timeoutMs,
+    feedbackId,
+    clientSessionId,
+    ...requestOptions,
+  });
+  const print = (data) => {
+    if (args.json) {
+      console.log(JSON.stringify(data, null, 2));
+      return;
+    }
+    const tickets = Array.isArray(data?.tickets) ? data.tickets : [];
+    if (tickets.length) {
+      console.log(`Tickets: ${tickets.length}`);
+      for (const ticket of tickets) {
+        console.log(`- ${ticket.ticket_id || ticket._id || "(unknown)"} r${ticket.revision ?? "?"} ${ticket.status || "unknown"} ${ticket.severity || ""} ${ticket.title || ""}`.trim());
+      }
+      return;
+    }
+    console.log(JSON.stringify(data, null, 2));
+  };
+
+  try {
+    if (action === "list") {
+      print(await call({ method: "GET" }));
+      return;
+    }
+
+    const filePath = firstNonEmptyString(args.file);
+    let rawPayload = filePath ? readStructuredPayloadFile(filePath, "Feedback ticket") : null;
+
+    if (["create", "validate-create"].includes(action)) {
+      if (!rawPayload) {
+        console.error("Missing --file with a JSON/YAML ticket payload.");
+        process.exit(1);
+      }
+      const isBatch = Array.isArray(rawPayload) || (isPlainObject(rawPayload) && Array.isArray(rawPayload.items));
+      let payload = isBatch ? normalizeItemsPayload(rawPayload, "Feedback ticket create") : { ...rawPayload };
+      if (dryRun) {
+        const validationPayload = isBatch ? payload : {
+          items: [{
+            ...payload,
+            ticket_key: firstNonEmptyString(payload.ticket_key, args["ticket-key"], `validate-${projectWritePayloadHash(payload).slice(0, 24)}`),
+          }],
+        };
+        print(await call({ endpoint: "batch/validate", method: "POST", payload: validationPayload }));
+        return;
+      }
+      const itemCount = isBatch ? payload.items.length : 1;
+      const targets = isBatch
+        ? [feedbackId, ...payload.items.map((item) => firstNonEmptyString(item?.ticket_key)).filter(Boolean)]
+        : [feedbackId];
+      payload = withWriteApproval(args, payload, {
+        artifactKind: "yaml",
+        targets,
+        batchCount: isBatch ? itemCount : null,
+      });
+      const idempotencyKey = resolveProjectMutationIdempotencyKey({
+        args,
+        operation: `feedback_ticket_${isBatch ? "batch_" : ""}create:${feedbackId}`,
+        payload,
+      });
+      print(await call({
+        endpoint: isBatch ? "batch" : "",
+        method: "POST",
+        payload,
+        idempotencyKey,
+      }));
+      return;
+    }
+
+    if (["update", "validate-update"].includes(action)) {
+      const ticketIds = parseFeedbackTicketIdsArg(args);
+      let payload;
+      if (rawPayload) {
+        payload = Array.isArray(rawPayload) ? { items: rawPayload } : { ...rawPayload };
+      } else {
+        if (!ticketIds.length) {
+          console.error("Missing --file or --ticket-ids for ticket update.");
+          process.exit(1);
+        }
+        const updates = {};
+        for (const field of ["status", "severity"]) {
+          const value = firstNonEmptyString(args[field]);
+          if (value) updates[field] = value;
+        }
+        const assignedUserId = firstNonEmptyString(args["assigned-user-id"], args.assignedUserId, args.assigned_user_id);
+        if (assignedUserId) updates.assigned_user_id = assignedUserId;
+        if (!Object.keys(updates).length) {
+          console.error("Missing ticket update fields. Use --status, --severity, --assigned-user-id, or --file.");
+          process.exit(1);
+        }
+        const current = await call({ method: "GET" });
+        const currentById = new Map((current.tickets || []).map((ticket) => [String(ticket.ticket_id || ticket._id), ticket]));
+        const missing = ticketIds.filter((ticketId) => !currentById.has(String(ticketId)));
+        if (missing.length) throw new Error(`Feedback ticket ids were not found: ${missing.join(", ")}`);
+        payload = {
+          items: ticketIds.map((ticketId) => ({
+            ticket_id: ticketId,
+            expected_revision: Number(currentById.get(String(ticketId)).revision),
+            updates,
+          })),
+        };
+      }
+      const isBatch = Array.isArray(payload.items) || Array.isArray(payload.ticket_ids);
+      if (dryRun) {
+        const validationPayload = isBatch ? payload : {
+          items: [{
+            ticket_id: firstNonEmptyString(args["ticket-id"], args.ticketId, args.ticket_id, payload.ticket_id),
+            expected_revision: payload.expected_revision,
+            updates: payload.updates || Object.fromEntries(Object.entries(payload).filter(([key]) => ["title", "summary", "severity", "status", "assigned_user_id"].includes(key))),
+          }],
+        };
+        print(await call({ endpoint: "batch-update/validate", method: "POST", payload: validationPayload }));
+        return;
+      }
+      const itemCount = isBatch ? (payload.items || payload.ticket_ids || []).length : 1;
+      const targetTicketId = firstNonEmptyString(args["ticket-id"], args.ticketId, args.ticket_id, payload.ticket_id);
+      if (!isBatch && !targetTicketId) {
+        console.error("Missing --ticket-id for a single ticket update.");
+        process.exit(1);
+      }
+      const targetIds = isBatch
+        ? (payload.items || []).map((item) => item?.ticket_id).filter(Boolean).concat(payload.ticket_ids || [])
+        : [targetTicketId];
+      payload = withWriteApproval(args, payload, {
+        artifactKind: "yaml",
+        targets: [feedbackId, ...targetIds],
+        batchCount: isBatch ? itemCount : null,
+      });
+      const idempotencyKey = resolveProjectMutationIdempotencyKey({
+        args,
+        operation: `feedback_ticket_${isBatch ? "batch_" : ""}update:${feedbackId}:${targetIds.join(",")}`,
+        payload,
+      });
+      print(await call({
+        endpoint: isBatch ? "batch" : encodeURIComponent(targetTicketId),
+        method: "PATCH",
+        payload,
+        idempotencyKey,
+      }));
+      return;
+    }
+
+    if (action === "coverage") {
+      const ticketId = firstNonEmptyString(args["ticket-id"], args.ticketId, args.ticket_id);
+      if (!ticketId) {
+        console.error("Missing --ticket-id.");
+        process.exit(1);
+      }
+      let payload = rawPayload && isPlainObject(rawPayload) ? { ...rawPayload } : {
+        version_id: firstNonEmptyString(args["version-id"], args.versionId, args.version_id),
+        document_id: firstNonEmptyString(args["document-id"], args.documentId, args.document_id),
+        coverage_status: firstNonEmptyString(args["coverage-status"], args.coverageStatus, args.coverage_status),
+      };
+      if (payload.expected_revision === undefined) {
+        const current = await call({ method: "GET" });
+        const ticket = (current.tickets || []).find((item) => String(item.ticket_id || item._id) === String(ticketId));
+        if (!ticket) throw new Error(`Feedback ticket id was not found: ${ticketId}`);
+        payload.expected_revision = Number(ticket.revision);
+      }
+      if (dryRun) {
+        console.log(JSON.stringify({ valid: true, validate_only: true, ticket_id: ticketId, payload }, null, 2));
+        return;
+      }
+      payload = withWriteApproval(args, payload, { artifactKind: "yaml", targets: [feedbackId, ticketId] });
+      const idempotencyKey = resolveProjectMutationIdempotencyKey({
+        args,
+        operation: `feedback_ticket_coverage:${feedbackId}:${ticketId}`,
+        payload,
+      });
+      print(await call({ endpoint: `${encodeURIComponent(ticketId)}/prd-coverage`, method: "PATCH", payload, idempotencyKey }));
+      return;
+    }
+
+    console.error("Unknown feedback tickets command. Use list, create, validate-create, update, validate-update, or coverage.");
+    process.exit(1);
+  } catch (err) {
+    if (args.json) {
+      console.log(JSON.stringify({ ok: false, status: err?.status || null, message: err?.message || String(err), data: err?.data || null }, null, 2));
+    } else {
+      console.error("Feedback tickets failed:", err?.message || err);
+      if (err?.data) console.error(JSON.stringify(err.data, null, 2));
+    }
+    process.exit(1);
+  }
+}
+
 async function runFeedback(args) {
   const subcommand = firstNonEmptyString(args._?.[0]) || "help";
   if (subcommand === "help") {
@@ -7764,7 +8063,11 @@ async function runFeedback(args) {
     await runFeedbackGetOrHistory(args, subcommand);
     return;
   }
-  console.error("Unknown feedback command. Use status, edit, document-add, assign, archive, submit, revise, reviews, review, move, comment, undo, prd-versions, prd-diff, get, history, validate, or apply.");
+  if (subcommand === "tickets") {
+    await runFeedbackTickets(args);
+    return;
+  }
+  console.error("Unknown feedback command. Use status, edit, document-add, assign, archive, submit, revise, reviews, review, move, comment, tickets, undo, prd-versions, prd-diff, get, history, validate, or apply.");
   process.exit(1);
 }
 
@@ -8495,7 +8798,7 @@ async function runQuery(args) {
             initialDelayMs: Math.min(2_000, pollDelayMs),
           },
         );
-        pollDelayMs = Number(finalStatus?._nextPollAfterMs) || Math.min(10_000, Math.ceil(pollDelayMs * 1.25));
+        pollDelayMs = Number(finalStatus?._nextPollAfterMs) || Math.min(10_000, Math.ceil(pollDelayMs * 1.25));
         if (["completed", "failed"].includes(String(finalStatus.status || "").trim())) {
           break;
         }
@@ -8684,8 +8987,8 @@ if (require.main === module) {
     resolveActorScope,
     main,
     scrubBootstrapValue,
-    scrubMissionOpsValue,
-    successfulPollDelayMs,
+    scrubMissionOpsValue,
+    successfulPollDelayMs,
     writeBootstrapSnapshot,
     writeFeedbackSnapshot,
     writeApprovedMissionCards,

package/lib/certification-manifest.js

@@ -11,6 +11,8 @@ const ARTIFACT_KINDS = new Set([
   "notification",
   "object",
   "query_job",
+  "feedback_ticket",
+  "ticket_batch",
 ]);
 const SENSITIVE_KEY = /(api[_-]?key|authorization|bearer|password|secret|token|credential)/i;
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mytegroupinc/myte-core",
-  "version": "0.0.55",
+  "version": "0.0.56",
   "description": "Myte CLI core implementation.",
   "type": "commonjs",
   "main": "cli.js",