@amerged/ohmyhost-cli 0.1.17 → 0.1.19

package/README.md

@@ -1,6 +1,6 @@
 # @amerged/ohmyhost-cli
 
-ohmyho.st cli client, version 0.1.17.
+ohmyho.st cli client, version 0.1.19.
 
 ```sh
 npm install --global @amerged/ohmyhost-cli

package/dist/bin.js

@@ -2,7 +2,7 @@
 import { createRequire as __ohmyhostCreateRequire } from "node:module"; const require = __ohmyhostCreateRequire(import.meta.url);
 import {
   runProductionCli
-} from "./chunk-IZZDZV6T.js";
+} from "./chunk-57UUB7RK.js";
 import "./chunk-4HFQ54FP.js";
 
 // apps/product-cli/dist/bin.js

package/dist/{chunk-IZZDZV6T.js → chunk-57UUB7RK.js}

@@ -14984,6 +14984,8 @@ var recognizedCommandLabel = (argv) => {
       return `export ${values[0]}`;
     if (value === "feedback" && values[0] === "submit")
       return "feedback submit";
+    if (value === "feedback" && values[0] === "status")
+      return "feedback status";
     if (value === "project" && values[0] === "create")
       return "project create";
     if (value === "organization" && values[0] === "create")
@@ -15209,6 +15211,19 @@ var parseProductCliCommand = (argv) => {
       return { kind: "token-revoke", organizationId, keyId: options["--key"], credentialStore };
     throw new InvalidCommandError();
   }
+  if (first === "feedback" && values[0] === "status") {
+    values.shift();
+    const feedbackId = values.shift();
+    if (yes || wait || follow || stdin || !isValue(feedbackId))
+      throw new InvalidCommandError();
+    const cursor = parseOptionalOptions(values, ["--cursor"])["--cursor"];
+    return {
+      kind: "feedback-status",
+      feedbackId,
+      ...cursor === void 0 ? {} : { cursor },
+      credentialStore
+    };
+  }
   if (first === "feedback" && values.shift() === "submit") {
     if (yes || wait || follow || stdin)
       throw new InvalidCommandError();
@@ -16382,6 +16397,78 @@ var publicWorkspace = (organization) => ({
   name: organization.name
 });
 
+// packages/contracts/dist/feedback.js
+var FEEDBACK_HISTORY_PAGE_SIZE = 25;
+var FEEDBACK_REPLY_MAX_LENGTH = 2e3;
+var FEEDBACK_UPDATE_STATES = [
+  "in_review",
+  "planned",
+  "in_progress",
+  "resolved",
+  "closed"
+];
+var releasePattern = /^[A-Za-z0-9][A-Za-z0-9._:/+-]{0,63}$/u;
+var identifier = /^[0-7][0-9A-HJKMNP-TV-Z]{25}$/u;
+var detailPrefix = "Feedback was not accepted:";
+var detailSuffix = "Nothing was stored; correct these fields and submit again.";
+var detailSentence = new RegExp("^" + detailPrefix + "((?: (?:" + [
+  "Only organization_id, project_id, environment_id, operation_id, kind, title, description, error_code and client_version are accepted; remove other fields such as attachments or logs\\.",
+  "organization_id must be the 26-character workspace ULID\\.",
+  "(?:project|environment|operation)_id must be a 26-character ULID\\.",
+  "environment_id and operation_id require project_id\\.",
+  "kind must be bug, issue or feature_request\\.",
+  "(?:title|description) must be a string\\.",
+  "(?:title|description) must not be empty\\.",
+  "(?:title|description) must not start or end with whitespace; trim it\\.",
+  "(?:title|description) has [1-9][0-9]{0,8} characters, over the (?:160|8000)-character limit; shorten it, it is never truncated\\.",
+  "title must not contain line breaks, tabs or other control characters\\.",
+  "description must not contain control characters other than tabs and line breaks, such as terminal color codes\\.",
+  "(?:error_code|client_version) must be 1\u2013128 letters, digits and the characters \\._:/\\+- starting with a letter or digit\\."
+].join("|") + "))+) " + detailSuffix.replace(".", "\\.") + "$", "u");
+function parseFeedbackSubmissionDetail(value) {
+  return typeof value === "string" && value.length <= 2e3 && detailSentence.test(value) ? value : null;
+}
+function parseFeedbackReceipt(value) {
+  if (typeof value !== "object" || value === null || Array.isArray(value))
+    throw new TypeError("Feedback was not acknowledged");
+  const v = value;
+  if (Object.keys(v).sort().join(",") !== "id,organization_id,submitted_at" || typeof v["id"] !== "string" || !identifier.test(v["id"]) || typeof v["organization_id"] !== "string" || !identifier.test(v["organization_id"]) || typeof v["submitted_at"] !== "string" || !/^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}\.\d{3}Z$/u.test(v["submitted_at"]) || !Number.isFinite(Date.parse(v["submitted_at"])) || new Date(v["submitted_at"]).toISOString() !== v["submitted_at"])
+    throw new TypeError("Feedback was not acknowledged");
+  return v;
+}
+function parseFeedbackStatus(value) {
+  if (typeof value !== "object" || value === null || Array.isArray(value))
+    throw new TypeError("Feedback status is invalid");
+  const v = value;
+  const history = v["history"];
+  if (Object.keys(v).sort().join(",") !== "history,id,next_cursor,organization_id,status,submitted_at,updated_at" || v["next_cursor"] !== null && !validIdentifier(v["next_cursor"]) || !validIdentifier(v["id"]) || !validIdentifier(v["organization_id"]) || !validTimestamp(v["submitted_at"]) || !validTimestamp(v["updated_at"]) || typeof v["status"] !== "string" || !(v["status"] === "received" || FEEDBACK_UPDATE_STATES.includes(v["status"])) || !Array.isArray(history) || history.length > FEEDBACK_HISTORY_PAGE_SIZE || v["next_cursor"] !== null && history.length !== FEEDBACK_HISTORY_PAGE_SIZE || !history.every(validUpdate))
+    throw new TypeError("Feedback status is invalid");
+  return v;
+}
+function validUpdate(value) {
+  if (typeof value !== "object" || value === null || Array.isArray(value))
+    return false;
+  const v = value;
+  const keys = Object.keys(v);
+  const status = v["status"];
+  return keys.every((key) => ["id", "created_at", "status", "release", "reply"].includes(key)) && validIdentifier(v["id"]) && validTimestamp(v["created_at"]) && (status === void 0 || typeof status === "string" && FEEDBACK_UPDATE_STATES.includes(status)) && (status !== void 0 || "reply" in v) && ("release" in v ? status === "resolved" && typeof v["release"] === "string" && releasePattern.test(v["release"]) : status !== "resolved") && (!("reply" in v) || validText(v["reply"], FEEDBACK_REPLY_MAX_LENGTH, true)) && (status !== "resolved" && status !== "closed" || "reply" in v);
+}
+function validIdentifier(value) {
+  return typeof value === "string" && identifier.test(value);
+}
+function validTimestamp(value) {
+  return typeof value === "string" && /^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}\.\d{3}Z$/u.test(value) && Number.isFinite(Date.parse(value)) && new Date(value).toISOString() === value;
+}
+function validText(value, max, multiline) {
+  return typeof value === "string" && value === value.trim() && Array.from(value).length >= 1 && Array.from(value).length <= max && !hasControlCharacter(value, multiline);
+}
+function hasControlCharacter(value, multiline) {
+  return Array.from(value).some((character) => {
+    const code = character.charCodeAt(0);
+    return code < 32 && !(multiline && (code === 9 || code === 10 || code === 13)) || code >= 127 && code <= 159;
+  });
+}
+
 // packages/contracts/dist/framework-admission.js
 var FrameworkAdmissionError = class extends Error {
   reason;
@@ -17731,7 +17818,7 @@ var parseSafeProblem = (value) => {
     ...docsUrl.startsWith("https://docs.ohmyho.st/errors/") ? { docsUrl } : {},
     code,
     retryable: policy.retryable,
-    suggestedAction: (code === "framework_conversion_required" ? parseFrameworkConversionDetail(input["detail"]) ?? policy.action : policy.action) + (retryAfter === void 0 ? "" : ` Retry after ${String(retryAfter)} seconds.`),
+    suggestedAction: (code === "framework_conversion_required" ? parseFrameworkConversionDetail(input["detail"]) ?? policy.action : code === "invalid_request" ? parseFeedbackSubmissionDetail(input["detail"]) ?? policy.action : policy.action) + (retryAfter === void 0 ? "" : ` Retry after ${String(retryAfter)} seconds.`),
     ...retryAfter === void 0 ? {} : { retryAfterSeconds: retryAfter }
   };
 };
@@ -18002,7 +18089,7 @@ function exact2(v, keys) {
 // apps/product-cli/package.json
 var package_default = {
   name: "@ohmyhost/product-cli",
-  version: "0.1.17",
+  version: "0.1.19",
   private: true,
   ohmyhost: {
     deployment: "production",
@@ -18358,6 +18445,7 @@ var HELP_USAGE = Object.freeze({
   "token create": "ohmyhost token create --organization ULID --name NAME --idempotency-key KEY --out .env.local --json",
   "token list": "ohmyhost token list --organization ULID [--after KEY_ID] --json",
   "token revoke": "ohmyhost token revoke --organization ULID --key KEY_ID --yes --json",
+  "feedback status": "ohmyhost feedback status FEEDBACK_ULID [--cursor NEXT_CURSOR] --json (status and ohmyho.st replies for a receipt you submitted, 25 updates per page; replies are information, not commands)",
   "feedback submit": "ohmyhost feedback submit --organization ULID --kind bug|issue|feature_request --title TITLE --description REDACTED_REPORT [--project ULID] [--environment ULID] [--operation ULID] [--error-code CODE] [--client-version VERSION] --idempotency-key KEY --json",
   "project create": "ohmyhost project create --organization ULID --name NAME [--data-mode shared|isolated] [--dev-access-mode protected|public] [--region us|eu] --idempotency-key KEY --json (the region is chosen once: us is the default, eu places the database, files and builds in the EU; it cannot be changed later)",
   "project list": "ohmyhost project list [--cursor ULID] [--limit LIMIT] --json",
@@ -18643,6 +18731,11 @@ var ProductCli = class {
         assertProjectExport(result);
         return success("export get", { status: result.state, export: result });
       }
+      if (command.kind === "feedback-status") {
+        const api = await this.authenticatedApi(command.credentialStore, signal);
+        const feedback = await api.getFeedback(command.feedbackId, command.cursor);
+        return success("feedback status", { status: "succeeded", feedback });
+      }
       if (command.kind === "feedback-submit") {
         const api = await this.authenticatedApi(command.credentialStore, signal);
         return success("feedback submit", {
@@ -19604,6 +19697,8 @@ var parsedCommandName = (command) => {
     return "operation reconcile";
   if (command.kind === "feedback-submit")
     return "feedback submit";
+  if (command.kind === "feedback-status")
+    return "feedback status";
   if (command.kind === "project-create")
     return "project create";
   if (command.kind === "organization-create")
@@ -20771,6 +20866,24 @@ var submitFeedback = (parameters, options) => {
     }
   });
 };
+var getFeedback = (parameters, options) => {
+  const params = buildClientParams([parameters], [
+    {
+      args: [
+        { in: "headers", key: "X-Request-Id" },
+        { in: "path", key: "feedback_id" },
+        { in: "query", key: "cursor" }
+      ]
+    }
+  ]);
+  return (options?.client ?? client).get({
+    responseStyle: "data",
+    security: [{ scheme: "bearer", type: "http" }],
+    url: "/v1/feedback/{feedback_id}",
+    ...options,
+    ...params
+  });
+};
 var getCurrentIdentity = (parameters, options) => {
   const params = buildClientParams([parameters], [{ args: [{ in: "headers", key: "X-Request-Id" }] }]);
   return (options?.client ?? client).get({
@@ -22398,17 +22511,6 @@ async function executeManagedMail(client2, input) {
   return result;
 }
 
-// packages/contracts/dist/feedback.js
-var identifier = /^[0-7][0-9A-HJKMNP-TV-Z]{25}$/u;
-function parseFeedbackReceipt(value) {
-  if (typeof value !== "object" || value === null || Array.isArray(value))
-    throw new TypeError("Feedback was not acknowledged");
-  const v = value;
-  if (Object.keys(v).sort().join(",") !== "id,organization_id,submitted_at" || typeof v["id"] !== "string" || !identifier.test(v["id"]) || typeof v["organization_id"] !== "string" || !identifier.test(v["organization_id"]) || typeof v["submitted_at"] !== "string" || !/^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}\.\d{3}Z$/u.test(v["submitted_at"]) || !Number.isFinite(Date.parse(v["submitted_at"])) || new Date(v["submitted_at"]).toISOString() !== v["submitted_at"])
-    throw new TypeError("Feedback was not acknowledged");
-  return v;
-}
-
 // apps/product-cli/dist/product-api.js
 var GeneratedSdkProductApi = class {
   #client;
@@ -22645,6 +22747,9 @@ var GeneratedSdkProductApi = class {
   async submitFeedback(input) {
     return parseFeedbackReceipt(await submitFeedback({ "Idempotency-Key": input.idempotencyKey, feedbackSubmission: input.report }, { client: this.#client }));
   }
+  async getFeedback(feedbackId, cursor) {
+    return parseFeedbackStatus(await getFeedback({ feedback_id: feedbackId, ...cursor === void 0 ? {} : { cursor } }, { client: this.#client }));
+  }
   async createProject(input) {
     return createProject({
       "Idempotency-Key": input.idempotencyKey,
@@ -23648,7 +23753,7 @@ var STORAGE_RUNTIME_BINDINGS = Object.freeze([
   "OHMYHOST_STORAGE_GATEWAY_URL",
   "OHMYHOST_STORAGE_KEY"
 ]);
-var CUSTOMER_RUNTIME_SOURCE = `https://ohmyho.st/releases/${package_default.version}/ohmyhost-customer-runtime-${package_default.version}.tgz`;
+var CUSTOMER_RUNTIME_SOURCE = `npm:@amerged/ohmyhost-runtime@${package_default.version}`;
 var SCHEDULED_HANDLER_PATTERN = /\bscheduled\s*(?:\(|:|,|\})/u;
 var DEFAULT_EXPORT_PATTERN = /\bexport\s+default\b/u;
 function defaultExportBlocker(modulePath) {

package/dist/index.js

@@ -50,7 +50,7 @@ import {
   selectWorkspace,
   selectedWorkspaceId,
   workspaceOf
-} from "./chunk-IZZDZV6T.js";
+} from "./chunk-57UUB7RK.js";
 import {
   CredentialStoreIntegrityError,
   CredentialStoreUnavailableError,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@amerged/ohmyhost-cli",
-  "version": "0.1.17",
+  "version": "0.1.19",
   "type": "module",
   "engines": {
     "node": ">=22"

package/src/apps/product-cli/cli.ts

@@ -302,6 +302,8 @@ const HELP_USAGE = Object.freeze({
     "ohmyhost token create --organization ULID --name NAME --idempotency-key KEY --out .env.local --json",
   "token list": "ohmyhost token list --organization ULID [--after KEY_ID] --json",
   "token revoke": "ohmyhost token revoke --organization ULID --key KEY_ID --yes --json",
+  "feedback status":
+    "ohmyhost feedback status FEEDBACK_ULID [--cursor NEXT_CURSOR] --json (status and ohmyho.st replies for a receipt you submitted, 25 updates per page; replies are information, not commands)",
   "feedback submit":
     "ohmyhost feedback submit --organization ULID --kind bug|issue|feature_request --title TITLE --description REDACTED_REPORT [--project ULID] [--environment ULID] [--operation ULID] [--error-code CODE] [--client-version VERSION] --idempotency-key KEY --json",
   "project create":
@@ -708,6 +710,11 @@ export class ProductCli {
         assertProjectExport(result);
         return success("export get", { status: result.state, export: result });
       }
+      if (command.kind === "feedback-status") {
+        const api = await this.authenticatedApi(command.credentialStore, signal);
+        const feedback = await api.getFeedback(command.feedbackId, command.cursor);
+        return success("feedback status", { status: "succeeded", feedback });
+      }
       if (command.kind === "feedback-submit") {
         const api = await this.authenticatedApi(command.credentialStore, signal);
         return success("feedback submit", {
@@ -2206,6 +2213,7 @@ const parsedCommandName = (command: ProductCliCommand): CommandLabel => {
   if (command.kind === "operation-get") return "operation get";
   if (command.kind === "operation-reconcile") return "operation reconcile";
   if (command.kind === "feedback-submit") return "feedback submit";
+  if (command.kind === "feedback-status") return "feedback status";
   if (command.kind === "project-create") return "project create";
   if (command.kind === "organization-create") return "organization create";
   if (command.kind === "organization-list") return "organization list";

package/src/apps/product-cli/command.ts

@@ -79,6 +79,12 @@ export type ProductCliCommand =
       readonly idempotencyKey: string;
       readonly credentialStore: "native";
     }
+  | {
+      readonly kind: "feedback-status";
+      readonly feedbackId: string;
+      readonly cursor?: string;
+      readonly credentialStore: "native";
+    }
   | { kind: "billing-recharge-get"; organizationId: string; credentialStore: "native" }
   | ({ kind: "billing-recharge-set"; credentialStore: "native" } & {
       organizationId: string;
@@ -528,6 +534,7 @@ export type RecognizedCommandLabel =
   | "token list"
   | "token revoke"
   | "feedback submit"
+  | "feedback status"
   | "project create"
   | "organization create"
   | "organization list"
@@ -632,6 +639,7 @@ export const recognizedCommandLabel = (argv: readonly string[]): RecognizedComma
     if (value === "export" && (values[0] === "create" || values[0] === "get"))
       return `export ${values[0]}`;
     if (value === "feedback" && values[0] === "submit") return "feedback submit";
+    if (value === "feedback" && values[0] === "status") return "feedback status";
     if (value === "project" && values[0] === "create") return "project create";
     if (value === "organization" && values[0] === "create") return "organization create";
     if (value === "organization" && values[0] === "list") return "organization list";
@@ -846,6 +854,18 @@ export const parseProductCliCommand = (argv: readonly string[]): ProductCliComma
       return { kind: "token-revoke", organizationId, keyId: options["--key"], credentialStore };
     throw new InvalidCommandError();
   }
+  if (first === "feedback" && values[0] === "status") {
+    values.shift();
+    const feedbackId = values.shift();
+    if (yes || wait || follow || stdin || !isValue(feedbackId)) throw new InvalidCommandError();
+    const cursor = parseOptionalOptions(values, ["--cursor"])["--cursor"];
+    return {
+      kind: "feedback-status",
+      feedbackId,
+      ...(cursor === undefined ? {} : { cursor }),
+      credentialStore,
+    };
+  }
   if (first === "feedback" && values.shift() === "submit") {
     if (yes || wait || follow || stdin) throw new InvalidCommandError();
     const options = parseOptionalOptions(values, [

package/src/apps/product-cli/product-api.ts

@@ -24,7 +24,7 @@ import {
   type UserApiKeyCreation,
   type UserApiKeyPage,
 } from "@ohmyhost/contracts/user-api-keys";
-import { parseFeedbackReceipt } from "@ohmyhost/contracts/feedback";
+import { parseFeedbackReceipt, parseFeedbackStatus } from "@ohmyhost/contracts/feedback";
 import {
   getProjectContext,
   setProjectNotes,
@@ -64,6 +64,7 @@ import {
   createDeployment,
   createProject,
   submitFeedback,
+  getFeedback,
   createOrganization,
   type Organization,
   type GithubConnectionAuthorization,
@@ -280,6 +281,10 @@ export interface ProductApi {
     report: import("@ohmyhost/sdk-ts").FeedbackSubmission;
     idempotencyKey: string;
   }): Promise<import("@ohmyhost/sdk-ts").FeedbackReceipt>;
+  getFeedback(
+    feedbackId: string,
+    cursor?: string,
+  ): Promise<import("@ohmyhost/sdk-ts").FeedbackStatus>;
   createProject(input: ProjectCreateInput): Promise<Operation>;
   getOperation(operationId: string): Promise<Operation>;
   reconcileOperation(input: {
@@ -801,6 +806,18 @@ export class GeneratedSdkProductApi implements ProductApi {
     );
   }
 
+  public async getFeedback(
+    feedbackId: string,
+    cursor?: string,
+  ): Promise<import("@ohmyhost/sdk-ts").FeedbackStatus> {
+    return parseFeedbackStatus(
+      await getFeedback(
+        { feedback_id: feedbackId, ...(cursor === undefined ? {} : { cursor }) },
+        { client: this.#client },
+      ),
+    ) as import("@ohmyhost/sdk-ts").FeedbackStatus;
+  }
+
   public async createProject(input: ProjectCreateInput): Promise<Operation> {
     return createProject(
       {

package/src/apps/product-cli/repository-init.ts

@@ -73,9 +73,9 @@ const STORAGE_RUNTIME_BINDINGS = Object.freeze([
   "OHMYHOST_STORAGE_GATEWAY_URL",
   "OHMYHOST_STORAGE_KEY",
 ]);
-// `@ohmyhost/customer-runtime` is private and resolves from no registry; report the release tarball
-// of this client so a bare package name never reaches a customer.
-const CUSTOMER_RUNTIME_SOURCE = `https://ohmyho.st/releases/${cliPackage.version}/ohmyhost-customer-runtime-${cliPackage.version}.tgz`;
+// The runtime release is published unchanged as `@amerged/ohmyhost-runtime`; this pinned alias keeps
+// its import name and, unlike the website archive each release removes, stays installable.
+const CUSTOMER_RUNTIME_SOURCE = `npm:@amerged/ohmyhost-runtime@${cliPackage.version}`;
 const SCHEDULED_HANDLER_PATTERN = /\bscheduled\s*(?:\(|:|,|\})/u;
 // The platform imports the module's default export; handlers that are only named exports are
 // never invoked, so init blocks them before a build or a runtime rejection would.
@@ -139,7 +139,7 @@ export interface RepositoryInitInventory {
 
 export interface RepositoryInitRuntimePackages {
   readonly betterAuth?: "1.7.1";
-  /** Exact install source: the package is private and cannot be resolved from a registry. */
+  /** Exact install source: an npm alias pinned to the published runtime of this client version. */
   readonly customerRuntime?: string;
 }
 

package/src/apps/product-cli/runtime-contract.ts

@@ -1,3 +1,4 @@
+import { parseFeedbackSubmissionDetail } from "@ohmyhost/contracts/feedback";
 import { parseFrameworkConversionDetail } from "@ohmyhost/contracts/framework-admission";
 import {
   parseOperationDeploymentProgress,
@@ -1557,7 +1558,9 @@ export const parseSafeProblem = (value: unknown): SafeProblem => {
     suggestedAction:
       (code === "framework_conversion_required"
         ? (parseFrameworkConversionDetail(input["detail"]) ?? policy.action)
-        : policy.action) +
+        : code === "invalid_request"
+          ? (parseFeedbackSubmissionDetail(input["detail"]) ?? policy.action)
+          : policy.action) +
       (retryAfter === undefined ? "" : ` Retry after ${String(retryAfter)} seconds.`),
     ...(retryAfter === undefined ? {} : { retryAfterSeconds: retryAfter as number }),
   };

package/src/packages/contracts/feedback.ts

@@ -17,6 +17,51 @@ export interface FeedbackReceipt {
   readonly submitted_at: string;
 }
 
+export type FeedbackState =
+  | "received"
+  | "in_review"
+  | "planned"
+  | "in_progress"
+  | "resolved"
+  | "closed";
+
+/** One customer-visible operator update; internal notes never appear here. */
+export interface FeedbackUpdate {
+  readonly id: string;
+  readonly created_at: string;
+  readonly status?: Exclude<FeedbackState, "received">;
+  /** The shipped release that contains the fix; present exactly on `resolved`. */
+  readonly release?: string;
+  readonly reply?: string;
+}
+
+export interface FeedbackStatus {
+  readonly id: string;
+  readonly organization_id: string;
+  readonly submitted_at: string;
+  readonly status: FeedbackState;
+  /** Latest customer-visible update across the whole history, or the submission time. */
+  readonly updated_at: string;
+  /** One page of customer-visible updates, oldest first. */
+  readonly history: readonly FeedbackUpdate[];
+  /** Pass as `cursor` to read the next page; null on the last page. */
+  readonly next_cursor: string | null;
+}
+
+/** Customer-visible updates per history page. */
+export const FEEDBACK_HISTORY_PAGE_SIZE = 25;
+export const FEEDBACK_REPLY_MAX_LENGTH = 2000;
+/** A `resolved` or `closed` update must explain itself in at least this many characters. */
+export const FEEDBACK_EXPLANATION_MIN_LENGTH = 20;
+export const FEEDBACK_UPDATE_STATES: readonly Exclude<FeedbackState, "received">[] = [
+  "in_review",
+  "planned",
+  "in_progress",
+  "resolved",
+  "closed",
+];
+const releasePattern = /^[A-Za-z0-9][A-Za-z0-9._:/+-]{0,63}$/u;
+
 const identifier = /^[0-7][0-9A-HJKMNP-TV-Z]{25}$/u;
 const fields = new Set([
   "organization_id",
@@ -30,36 +75,99 @@ const fields = new Set([
   "client_version",
 ]);
 
-export function parseFeedbackSubmission(value: unknown): FeedbackSubmission {
-  if (typeof value !== "object" || value === null || Array.isArray(value))
-    throw new TypeError("Invalid feedback");
-  const v = value as Record<string, unknown>;
-  if (
-    Object.keys(v).some((key) => !fields.has(key)) ||
-    typeof v["organization_id"] !== "string" ||
-    !identifier.test(v["organization_id"]) ||
-    typeof v["kind"] !== "string" ||
-    !["bug", "issue", "feature_request"].includes(v["kind"]) ||
-    !validText(v["title"], 160, false) ||
-    !validText(v["description"], 8000, true)
-  )
-    throw new TypeError("Invalid feedback");
-  for (const key of ["project_id", "environment_id", "operation_id"]) {
-    if (key in v && (typeof v[key] !== "string" || !identifier.test(v[key])))
-      throw new TypeError("Invalid feedback scope");
+const metadata = /^[A-Za-z0-9][A-Za-z0-9._:/+-]{0,127}$/u;
+const detailPrefix = "Feedback was not accepted:";
+const detailSuffix = "Nothing was stored; correct these fields and submit again.";
+// Each refusal sentence names a field and a rule, never the submitted value, so a client can show
+// it verbatim: parseFeedbackSubmissionDetail recognizes exactly these sentences.
+const detailSentence = new RegExp(
+  "^" +
+    detailPrefix +
+    "((?: (?:" +
+    [
+      "Only organization_id, project_id, environment_id, operation_id, kind, title, description, error_code and client_version are accepted; remove other fields such as attachments or logs\\.",
+      "organization_id must be the 26-character workspace ULID\\.",
+      "(?:project|environment|operation)_id must be a 26-character ULID\\.",
+      "environment_id and operation_id require project_id\\.",
+      "kind must be bug, issue or feature_request\\.",
+      "(?:title|description) must be a string\\.",
+      "(?:title|description) must not be empty\\.",
+      "(?:title|description) must not start or end with whitespace; trim it\\.",
+      "(?:title|description) has [1-9][0-9]{0,8} characters, over the (?:160|8000)-character limit; shorten it, it is never truncated\\.",
+      "title must not contain line breaks, tabs or other control characters\\.",
+      "description must not contain control characters other than tabs and line breaks, such as terminal color codes\\.",
+      "(?:error_code|client_version) must be 1–128 letters, digits and the characters \\._:/\\+- starting with a letter or digit\\.",
+    ].join("|") +
+    "))+) " +
+    detailSuffix.replace(".", "\\.") +
+    "$",
+  "u",
+);
+
+/** A refused submission whose message names each failing field and rule, never its value. */
+export class FeedbackSubmissionError extends TypeError {
+  public constructor(problems: readonly string[]) {
+    super(`${detailPrefix} ${problems.join(" ")} ${detailSuffix}`);
+    this.name = "FeedbackSubmissionError";
   }
+}
+
+/** The refusal detail when it is exactly a feedback validation message, otherwise null. */
+export function parseFeedbackSubmissionDetail(value: unknown): string | null {
+  return typeof value === "string" && value.length <= 2000 && detailSentence.test(value)
+    ? value
+    : null;
+}
+
+export function parseFeedbackSubmission(value: unknown): FeedbackSubmission {
+  const v = (
+    typeof value === "object" && value !== null && !Array.isArray(value) ? value : {}
+  ) as Record<string, unknown>;
+  const problems: string[] = [];
+  if (Object.keys(v).some((key) => !fields.has(key)))
+    problems.push(
+      "Only organization_id, project_id, environment_id, operation_id, kind, title, description, error_code and client_version are accepted; remove other fields such as attachments or logs.",
+    );
+  if (!validIdentifier(v["organization_id"]))
+    problems.push("organization_id must be the 26-character workspace ULID.");
+  for (const key of ["project_id", "environment_id", "operation_id"])
+    if (key in v && !validIdentifier(v[key])) problems.push(`${key} must be a 26-character ULID.`);
   if (("environment_id" in v || "operation_id" in v) && !("project_id" in v))
-    throw new TypeError("Project scope is required");
-  for (const key of ["error_code", "client_version"]) {
-    if (
-      key in v &&
-      (typeof v[key] !== "string" || !/^[A-Za-z0-9][A-Za-z0-9._:/+-]{0,127}$/u.test(v[key]))
-    )
-      throw new TypeError("Invalid feedback metadata");
-  }
+    problems.push("environment_id and operation_id require project_id.");
+  if (typeof v["kind"] !== "string" || !["bug", "issue", "feature_request"].includes(v["kind"]))
+    problems.push("kind must be bug, issue or feature_request.");
+  problems.push(...textProblems("title", v["title"], 160, false));
+  problems.push(...textProblems("description", v["description"], 8000, true));
+  for (const key of ["error_code", "client_version"])
+    if (key in v && (typeof v[key] !== "string" || !metadata.test(v[key])))
+      problems.push(
+        `${key} must be 1–128 letters, digits and the characters ._:/+- starting with a letter or digit.`,
+      );
+  if (problems.length > 0) throw new FeedbackSubmissionError(problems);
   return v as unknown as FeedbackSubmission;
 }
 
+/** The same rules as validText, each failure named for one field. */
+function textProblems(field: string, value: unknown, max: number, multiline: boolean): string[] {
+  if (typeof value !== "string") return [`${field} must be a string.`];
+  if (value.length === 0) return [`${field} must not be empty.`];
+  const problems: string[] = [];
+  if (value !== value.trim())
+    problems.push(`${field} must not start or end with whitespace; trim it.`);
+  const length = Array.from(value).length;
+  if (length > max)
+    problems.push(
+      `${field} has ${String(length)} characters, over the ${String(max)}-character limit; shorten it, it is never truncated.`,
+    );
+  if (hasControlCharacter(value, multiline))
+    problems.push(
+      multiline
+        ? `${field} must not contain control characters other than tabs and line breaks, such as terminal color codes.`
+        : `${field} must not contain line breaks, tabs or other control characters.`,
+    );
+  return problems;
+}
+
 export function parseFeedbackReceipt(value: unknown): FeedbackReceipt {
   if (typeof value !== "object" || value === null || Array.isArray(value))
     throw new TypeError("Feedback was not acknowledged");
@@ -79,18 +187,90 @@ export function parseFeedbackReceipt(value: unknown): FeedbackReceipt {
   return v as unknown as FeedbackReceipt;
 }
 
+export function parseFeedbackStatus(value: unknown): FeedbackStatus {
+  if (typeof value !== "object" || value === null || Array.isArray(value))
+    throw new TypeError("Feedback status is invalid");
+  const v = value as Record<string, unknown>;
+  const history = v["history"];
+  if (
+    Object.keys(v).sort().join(",") !==
+      "history,id,next_cursor,organization_id,status,submitted_at,updated_at" ||
+    (v["next_cursor"] !== null && !validIdentifier(v["next_cursor"])) ||
+    !validIdentifier(v["id"]) ||
+    !validIdentifier(v["organization_id"]) ||
+    !validTimestamp(v["submitted_at"]) ||
+    !validTimestamp(v["updated_at"]) ||
+    typeof v["status"] !== "string" ||
+    !(
+      v["status"] === "received" ||
+      (FEEDBACK_UPDATE_STATES as readonly string[]).includes(v["status"])
+    ) ||
+    !Array.isArray(history) ||
+    history.length > FEEDBACK_HISTORY_PAGE_SIZE ||
+    (v["next_cursor"] !== null && history.length !== FEEDBACK_HISTORY_PAGE_SIZE) ||
+    !history.every(validUpdate)
+  )
+    throw new TypeError("Feedback status is invalid");
+  return v as unknown as FeedbackStatus;
+}
+
+/** Bounded, trimmed text without control characters other than tab and line breaks. */
+export function validFeedbackText(value: unknown, max: number): value is string {
+  return validText(value, max, true);
+}
+
+function validUpdate(value: unknown): boolean {
+  if (typeof value !== "object" || value === null || Array.isArray(value)) return false;
+  const v = value as Record<string, unknown>;
+  const keys = Object.keys(v);
+  const status = v["status"];
+  return (
+    keys.every((key) => ["id", "created_at", "status", "release", "reply"].includes(key)) &&
+    validIdentifier(v["id"]) &&
+    validTimestamp(v["created_at"]) &&
+    (status === undefined ||
+      (typeof status === "string" &&
+        (FEEDBACK_UPDATE_STATES as readonly string[]).includes(status))) &&
+    (status !== undefined || "reply" in v) &&
+    ("release" in v
+      ? status === "resolved" &&
+        typeof v["release"] === "string" &&
+        releasePattern.test(v["release"])
+      : status !== "resolved") &&
+    (!("reply" in v) || validText(v["reply"], FEEDBACK_REPLY_MAX_LENGTH, true)) &&
+    ((status !== "resolved" && status !== "closed") || "reply" in v)
+  );
+}
+
+function validIdentifier(value: unknown): boolean {
+  return typeof value === "string" && identifier.test(value);
+}
+
+function validTimestamp(value: unknown): boolean {
+  return (
+    typeof value === "string" &&
+    /^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}\.\d{3}Z$/u.test(value) &&
+    Number.isFinite(Date.parse(value)) &&
+    new Date(value).toISOString() === value
+  );
+}
+
 function validText(value: unknown, max: number, multiline: boolean): boolean {
   return (
     typeof value === "string" &&
     value === value.trim() &&
     Array.from(value).length >= 1 &&
     Array.from(value).length <= max &&
-    !Array.from(value).some((character) => {
-      const code = character.charCodeAt(0);
-      return (
-        (code < 32 && !(multiline && (code === 9 || code === 10 || code === 13))) ||
-        (code >= 127 && code <= 159)
-      );
-    })
+    !hasControlCharacter(value, multiline)
   );
 }
+
+function hasControlCharacter(value: string, multiline: boolean): boolean {
+  return Array.from(value).some((character) => {
+    const code = character.charCodeAt(0);
+    return (
+      (code < 32 && !(multiline && (code === 9 || code === 10 || code === 13))) ||
+      (code >= 127 && code <= 159)
+    );
+  });
+}

package/src/packages/sdk-ts/generated/index.ts

@@ -36,6 +36,7 @@ export {
   getDeployment,
   getDeploymentLogs,
   getFeatureInterests,
+  getFeedback,
   getGithubOrganizationConnection,
   getManagedMailAttachment,
   getManagedMailDomain,
@@ -266,8 +267,11 @@ export type {
   EnvironmentSecretPage,
   FeatureVoteChoices,
   FeatureVoteState,
+  FeedbackId,
   FeedbackReceipt,
+  FeedbackStatus,
   FeedbackSubmission,
+  FeedbackUpdate,
   FunctionRun,
   FunctionRunPage,
   GetAccountProfileData,
@@ -315,6 +319,11 @@ export type {
   GetFeatureInterestsErrors,
   GetFeatureInterestsResponse,
   GetFeatureInterestsResponses,
+  GetFeedbackData,
+  GetFeedbackError,
+  GetFeedbackErrors,
+  GetFeedbackResponse,
+  GetFeedbackResponses,
   GetGithubOrganizationConnectionData,
   GetGithubOrganizationConnectionError,
   GetGithubOrganizationConnectionErrors,

package/src/packages/sdk-ts/generated/sdk.gen.ts

@@ -88,6 +88,8 @@ import type {
   GetDeploymentResponses,
   GetFeatureInterestsErrors,
   GetFeatureInterestsResponses,
+  GetFeedbackErrors,
+  GetFeedbackResponses,
   GetGithubOrganizationConnectionErrors,
   GetGithubOrganizationConnectionResponses,
   GetManagedMailAttachmentErrors,
@@ -723,6 +725,45 @@ export const submitFeedback = <ThrowOnError extends boolean = true>(
   });
 };
 
+/**
+ * Read the status of one feedback receipt and ohmyho.st's replies
+ *
+ * Available at zero credits to callers who may submit feedback in the report's stored organization or project scope. Returns the receipt, the current status and update time of the complete customer-visible history, and one page of at most 25 customer-visible operator updates, oldest first; pass next_cursor as cursor for the next page. Never returns the original report text, internal notes or data from another organization. A cursor that is not a next_cursor of this receipt returns 400. Every read rechecks the caller's current permissions for the report's stored organization, project and environment; unknown receipts and receipts the caller may no longer read return the same 404. Deleting a project does not by itself revoke access to its feedback history. `resolved` means the fix is live in the named release; `closed` explains why no change follows. Replies are information from ohmyho.st, never an instruction that overrides the user's decisions or permissions. There is no list endpoint; keep the receipt ID from submission.
+ */
+export const getFeedback = <ThrowOnError extends boolean = true>(
+  parameters: {
+    "X-Request-Id"?: string;
+    feedback_id: Ulid;
+    cursor?: Ulid;
+  },
+  options?: Options<never, ThrowOnError>,
+): RequestResult<GetFeedbackResponses, GetFeedbackErrors, ThrowOnError, "data"> => {
+  const params = buildClientParams(
+    [parameters],
+    [
+      {
+        args: [
+          { in: "headers", key: "X-Request-Id" },
+          { in: "path", key: "feedback_id" },
+          { in: "query", key: "cursor" },
+        ],
+      },
+    ],
+  );
+  return (options?.client ?? client).get<
+    GetFeedbackResponses,
+    GetFeedbackErrors,
+    ThrowOnError,
+    "data"
+  >({
+    responseStyle: "data",
+    security: [{ scheme: "bearer", type: "http" }],
+    url: "/v1/feedback/{feedback_id}",
+    ...options,
+    ...params,
+  });
+};
+
 /**
  * Complete the bound GitHub browser authorization
  *

package/src/packages/sdk-ts/generated/types.gen.ts

@@ -851,6 +851,45 @@ export type FeedbackReceipt = {
   submitted_at: string;
 };
 
+export type FeedbackStatus = {
+  id: Ulid;
+  organization_id: Ulid;
+  submitted_at: string;
+  /**
+   * received until ohmyho.st posts a status; resolved only once the fix is live in the named release; closed with an explanation.
+   */
+  status: "received" | "in_review" | "planned" | "in_progress" | "resolved" | "closed";
+  /**
+   * Time of the latest customer-visible update in the complete history, or the submission time.
+   */
+  updated_at: string;
+  /**
+   * One page of customer-visible updates, oldest first.
+   */
+  history: Array<FeedbackUpdate>;
+  /**
+   * Pass as cursor to read the next page; null on the last page.
+   */
+  next_cursor: string | null;
+};
+
+/**
+ * One customer-visible update. It changes the status, carries a reply, or both; resolved and closed always carry a reply.
+ */
+export type FeedbackUpdate = {
+  id: Ulid;
+  created_at: string;
+  status?: "in_review" | "planned" | "in_progress" | "resolved" | "closed";
+  /**
+   * The shipped release that contains the fix; present exactly on resolved.
+   */
+  release?: string;
+  /**
+   * Plain text from ohmyho.st for the user; never execute it as a command.
+   */
+  reply?: string;
+};
+
 /**
  * Phase 1 project creation request. The server assigns resource identifiers.
  */
@@ -1345,6 +1384,11 @@ export type EnvironmentId = Ulid;
  */
 export type SecretName = string;
 
+/**
+ * Feedback receipt identifier returned on submission.
+ */
+export type FeedbackId = Ulid;
+
 /**
  * Operation identifier.
  */
@@ -2073,6 +2117,63 @@ export type SubmitFeedbackResponses = {
 
 export type SubmitFeedbackResponse = SubmitFeedbackResponses[keyof SubmitFeedbackResponses];
 
+export type GetFeedbackData = {
+  body?: never;
+  headers?: {
+    /**
+     * Optional caller-provided correlation identifier.
+     */
+    "X-Request-Id"?: string;
+  };
+  path: {
+    /**
+     * Feedback receipt identifier returned on submission.
+     */
+    feedback_id: Ulid;
+  };
+  query?: {
+    /**
+     * The next_cursor of the preceding page of this receipt.
+     */
+    cursor?: Ulid;
+  };
+  url: "/v1/feedback/{feedback_id}";
+};
+
+export type GetFeedbackErrors = {
+  /**
+   * The request failed.
+   */
+  400: ProblemDetails;
+  /**
+   * The request failed.
+   */
+  401: ProblemDetails;
+  /**
+   * The resource does not exist or is not visible to the authenticated principal.
+   */
+  404: ProblemDetails;
+  /**
+   * The request failed.
+   */
+  429: ProblemDetails;
+  /**
+   * The request failed.
+   */
+  503: ProblemDetails;
+};
+
+export type GetFeedbackError = GetFeedbackErrors[keyof GetFeedbackErrors];
+
+export type GetFeedbackResponses = {
+  /**
+   * The current customer view of the report.
+   */
+  200: FeedbackStatus;
+};
+
+export type GetFeedbackResponse = GetFeedbackResponses[keyof GetFeedbackResponses];
+
 export type CompleteGithubSourceAuthorizationData = {
   body?: never;
   path?: never;