@frontera-sdk/cli 1.52.31 → 1.52.32

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@frontera-sdk/cli",
-  "version": "1.52.31",
+  "version": "1.52.32",
   "description": "The frontera CLI — scaffold, pull, save and deploy Frontera apps and automations.",
   "keywords": [
     "frontera",
@@ -40,14 +40,14 @@
   "dependencies": {
     "@anthropic-ai/claude-agent-sdk": "^0.3.251",
     "@faker-js/faker": "10.6.0",
-    "@frontera-sdk/core": "1.52.31",
-    "@frontera-sdk/functions": "1.52.31",
+    "@frontera-sdk/core": "1.52.32",
+    "@frontera-sdk/functions": "1.52.32",
     "ai": "^6.0.116",
     "gray-matter": "^4.0.3",
     "yaml": "^2.9.0"
   },
   "devDependencies": {
-    "@frontera-sdk/forge-contracts": "1.52.31",
+    "@frontera-sdk/forge-contracts": "1.52.32",
     "@types/bun": "^1.3.14",
     "typescript": "^5.9.3"
   }

package/src/exit.ts

@@ -174,9 +174,37 @@ function refusalDetail(details: unknown): string | undefined {
   return undefined
 }
 
+/**
+ * Hints for one blocker of a `RELEASE_BLOCKED` publish. That code covers every
+ * reason a release cannot go out, so only a blocker this CLI knows earns advice.
+ */
+const BLOCKER_HINTS: Record<string, string> = {
+  // A repeat of a publish that already landed ends here too, and retrying it
+  // changes nothing: the release is already live.
+  NO_UNPUBLISHED_CHANGES: 'nothing to publish — run `frontera blueprint status` to confirm the active release',
+}
+
+/**
+ * The blocker codes of a `RELEASE_BLOCKED` body. An `AppError`'s details sit
+ * under `details` in the response body; a bare body is read as well.
+ */
+function releaseBlockerCodes(details: unknown): string[] {
+  if (typeof details !== 'object' || details === null) return []
+  const body = details as { blockers?: unknown; details?: unknown }
+  const nested = typeof body.details === 'object' && body.details !== null
+    ? (body.details as { blockers?: unknown }).blockers
+    : undefined
+  const blockers = Array.isArray(body.blockers) ? body.blockers : nested
+  if (!Array.isArray(blockers)) return []
+  return blockers
+    .map((blocker) => (typeof blocker === 'object' && blocker !== null ? (blocker as { code?: unknown }).code : undefined))
+    .filter((code): code is string => typeof code === 'string')
+}
+
 /**
  * The best hint available for a service error: the refusal-specific one when
- * the body names a refusal this CLI knows, the per-code one otherwise.
+ * the body names a refusal or a release blocker this CLI knows, the per-code
+ * one otherwise.
  *
  * An unrecognised `detail` falls through to the code's hint rather than to
  * nothing, on the same reasoning `exitCodeFor` records: the service can add a
@@ -188,6 +216,10 @@ function hintFor(code: string, details: unknown): string | undefined {
     const specific = REFUSAL_HINTS[detail]
     if (specific) return specific
   }
+  if (code === 'RELEASE_BLOCKED') {
+    const blockerHint = releaseBlockerCodes(details).map((blocker) => BLOCKER_HINTS[blocker]).find(Boolean)
+    if (blockerHint) return blockerHint
+  }
   return SERVICE_HINTS[code]
 }