@archora/forge-cli 1.2.1 → 1.3.0

package/LICENSE

@@ -0,0 +1,121 @@
+Archora Forge Proprietary Source-Available License (Paid-Use-Only)
+
+Copyright (c) 2026 Aleksandr Kotov (the "Licensor"). All rights reserved.
+
+The source code and any other materials made available in this repository
+(collectively, the "Software") are proprietary and confidential to the
+Licensor. They are published in source-available form for the sole purpose
+of allowing prospective licensees to inspect and evaluate the Software
+before purchasing a commercial license.
+
+This Software is NOT open source. The publication of this repository on a
+public hosting platform does NOT constitute a grant of any open-source or
+free-software license, and does NOT grant any rights beyond those expressly
+stated below.
+
+1. Limited Permission Granted Without a Paid License
+
+   Without entering into a separate written commercial license with the
+   Licensor, you are permitted to do ONLY the following with the Software:
+
+   (a) view and read the source code via the hosting platform on which
+       it is published;
+   (b) clone or download a copy strictly for the purpose of personally
+       evaluating whether to obtain a paid commercial license, for a
+       reasonable evaluation period not exceeding thirty (30) days; and
+   (c) discuss the Software publicly (e.g. cite, link, or quote short
+       excerpts for commentary, criticism, news reporting, teaching,
+       scholarship, or research) consistent with applicable fair use
+       or fair dealing law.
+
+   No other rights are granted. In particular, and without limitation,
+   the following are NOT permitted without a separate paid commercial
+   license signed by the Licensor:
+
+   - any use of the Software, in whole or in part, in any project,
+     product, service, library, internal tool, script, pipeline,
+     build, CI job, or deliverable, whether commercial or
+     non-commercial, paid or unpaid, personal or organizational,
+     for-profit or not-for-profit, including hobby and educational
+     projects;
+   - execution of the Software for any purpose other than short-term
+     evaluation by you personally as described in clause 1(b);
+   - copying, modifying, merging, publishing, sublicensing,
+     distributing, selling, hosting, or offering the Software (or any
+     derivative work) as a service to any third party;
+   - using code generated by the Software in any project for which
+     you do not hold a valid commercial license to the Software;
+   - removing or altering any copyright, trademark, license, or
+     attribution notices contained in the Software or in code it
+     generates;
+   - using the Software, its source code, or its outputs to train,
+     fine-tune, evaluate, benchmark, or otherwise develop
+     machine-learning or artificial-intelligence models, datasets, or
+     systems;
+   - reverse-engineering the Software for any purpose other than
+     evaluation as described in clause 1(b), to the extent such
+     restriction is permitted by applicable law.
+
+2. No Implied License
+
+   No license is granted by implication, estoppel, exhaustion, course of
+   dealing, or otherwise. Public availability of this repository does
+   not change this.
+
+3. Commercial License Required
+
+   To use the Software for any purpose beyond the limited evaluation
+   described in Section 1, you must first obtain a paid commercial
+   license from the Licensor. Pricing and terms are available on
+   request — see COMMERCIAL-LICENSE.md.
+
+4. Trademarks
+
+   "Archora" and "Archora Forge" and any associated names, logos, and
+   brands are trademarks of the Licensor. No trademark rights are
+   granted by this license. Forks, modifications, or derivative works
+   (where permitted under a separate commercial license) may not use
+   these marks without the Licensor's prior written consent.
+
+5. Term and Termination
+
+   Your permission under Section 1 terminates automatically and
+   immediately upon any breach of this license, or upon written notice
+   from the Licensor. Upon termination you must delete all copies of
+   the Software in your possession or control, except for archival
+   copies you are required by law to retain.
+
+6. No Warranty
+
+   THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+   EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+   MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, TITLE, AND
+   NON-INFRINGEMENT.
+
+7. Limitation of Liability
+
+   TO THE MAXIMUM EXTENT PERMITTED BY APPLICABLE LAW, IN NO EVENT SHALL
+   THE LICENSOR BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,
+   EXEMPLARY, OR CONSEQUENTIAL DAMAGES ARISING OUT OF OR IN CONNECTION
+   WITH THE SOFTWARE OR THIS LICENSE, EVEN IF ADVISED OF THE POSSIBILITY
+   OF SUCH DAMAGES.
+
+8. Governing Law
+
+   This license shall be governed by and construed in accordance with
+   the laws applicable at the Licensor's place of residence, without
+   regard to its conflict-of-laws principles.
+
+9. Prior Versions
+
+   Versions of the Software previously distributed under a different
+   license (including, without limitation, the MIT License) remain
+   governed by the license under which they were originally
+   distributed, with respect to the specific commits to which that
+   prior license applied. From the effective date of this license,
+   subsequent commits and releases are governed exclusively by these
+   terms.
+
+For commercial licensing inquiries, contact:
+  Email:    akotov@archora.dev
+  Telegram: @akotofff

package/dist/index.js

@@ -30,7 +30,7 @@ var ForgeError = class extends Error {
     this.details = details;
   }
 };
-var forgeCoreVersion = "1.2.1";
+var forgeCoreVersion = "1.3.0";
 var forgeGeneratedMarker = "// @archora-forge-generated";
 var forgeGeneratedMetadataMarker = "// @archora-forge-meta";
 async function writeGeneratedFiles(files, options) {
@@ -3350,6 +3350,9 @@ function renderReadiness(readiness) {
     <div class="card">
       <h2>Pilot Readiness</h2>
       <p>Status: <strong>${escapeHtml(readiness.status ?? "n/a")}</strong></p>
+      ${readiness.gate ? `<p>Gate: <strong>${escapeHtml(readiness.gate.result ?? "n/a")}</strong></p>
+      <p>Recommended CI mode: <strong>${escapeHtml(readiness.gate.recommendedCiMode ?? "n/a")}</strong></p>
+      <p>${escapeHtml(readiness.gate.reason ?? "")}</p>` : ""}
       <p>${escapeHtml(readiness.decision ?? "")}</p>
     </div>
     <div class="card">
@@ -3364,6 +3367,10 @@ function renderReadiness(readiness) {
       <h2>Warnings</h2>
       ${renderSimpleList(readiness.warnings ?? [], "No warnings.")}
     </div>
+    ${readiness.reviewerChecklist ? `<div class="card">
+      <h2>Reviewer Checklist</h2>
+      ${renderSimpleList(readiness.reviewerChecklist, "No reviewer checklist.")}
+    </div>` : ""}
   </section>`;
 }
 function renderSimpleList(items, empty) {
@@ -4056,12 +4063,33 @@ function createAuditReadiness(input) {
     ...input.diagnostics.length > 0 ? ["Use fix suggestions to decide which OpenAPI changes are required before purchase."] : [],
     ...input.ok ? ["Use this audit package as the paid pilot evidence bundle."] : []
   ];
+  const status = blockers.length > 0 ? "blocked" : warnings.length > 0 ? "needs-attention" : "ready";
+  const gate = status === "ready" ? {
+    result: "pass",
+    recommendedCiMode: "block",
+    reason: "Generated resource layer is ready for a blocking CI gate under the current policy."
+  } : status === "needs-attention" ? {
+    result: "warn",
+    recommendedCiMode: "comment",
+    reason: "Continue evaluation, but require explicit owner review before blocking merges."
+  } : {
+    result: "fail",
+    recommendedCiMode: "block",
+    reason: "Do not widen rollout until blockers are fixed or explicitly accepted."
+  };
   return {
-    status: blockers.length > 0 ? "blocked" : warnings.length > 0 ? "needs-attention" : "ready",
+    status,
+    gate,
     decision: input.ok ? "Generated resource layer is ready for local adoption review." : "Generated resource layer needs fixes or explicit risk acceptance before purchase.",
     blockers,
     warnings,
     nextActions: nextActions.length > 0 ? nextActions : ["No action required."],
+    reviewerChecklist: [
+      "Open `index.html` and confirm detected resources match the frontend mental model.",
+      "Open `report.md` and review blockers, warnings, scorecard and fix suggestions.",
+      "Open `typecheck.md` and confirm generated TypeScript passed or every failure is triaged.",
+      "Compare generated files with the existing API layer before committing rollout scope."
+    ],
     summary: {
       healthScore: input.healthScore,
       resources: input.resources,
@@ -4093,6 +4121,16 @@ function createAuditMarkdown(payload) {
 
 Status: ${payload.ok ? "passed" : "failed"}
 
+## Executive Review
+
+Readiness: ${payload.readiness.status}
+
+Gate: ${payload.readiness.gate.result}
+
+Recommended CI mode: ${payload.readiness.gate.recommendedCiMode}
+
+Gate reason: ${payload.readiness.gate.reason}
+
 Decision: ${payload.readiness.decision}
 
 Health score: ${payload.healthScore}
@@ -4111,6 +4149,10 @@ ${Object.entries(payload.scorecard).map(([key, value]) => `- ${key}: ${value}`).
 
 ${payload.fixSuggestions.length > 0 ? payload.fixSuggestions.map((item) => `- ${item.code} (${item.count}): ${item.suggestion}`).join("\n") : "- No fix suggestions."}
 
+## Reviewer Checklist
+
+${payload.readiness.reviewerChecklist.map((item) => `- ${item}`).join("\n")}
+
 ## Artifacts
 
 ${payload.audit.artifacts.map((artifact) => `- ${artifact}`).join("\n")}
@@ -4345,6 +4387,13 @@ function createMarkdownReport(payload) {
 
 Readiness: ${payload.readiness.status}
 
+${payload.readiness.gate ? `Gate: ${payload.readiness.gate.result}
+
+Recommended CI mode: ${payload.readiness.gate.recommendedCiMode}
+
+Gate reason: ${payload.readiness.gate.reason}
+` : ""}
+
 Decision: ${payload.readiness.decision}
 
 Blockers:
@@ -4430,6 +4479,19 @@ function createReadinessSummary(input) {
     ...input.summary.healthScore < 90 ? [`Health score is ${input.summary.healthScore}, below the recommended pilot threshold of 90.`] : []
   ];
   const status = blockers.length > 0 ? "blocked" : warnings.length > 0 ? "needs-attention" : "ready";
+  const gate = status === "ready" ? {
+    result: "pass",
+    recommendedCiMode: "block",
+    reason: "Keep the blocking check enabled; no report findings require human acceptance."
+  } : status === "needs-attention" ? {
+    result: "warn",
+    recommendedCiMode: "comment",
+    reason: "Use comment-only mode until warnings are triaged or accepted."
+  } : {
+    result: "fail",
+    recommendedCiMode: "block",
+    reason: "Block merge or require explicit acceptance before pilot handoff."
+  };
   const nextActions = status === "ready" ? ["Use the report as the pilot readiness artifact and keep `archora-forge check` in CI."] : [
     ...input.drift.length > 0 ? ["Run `archora-forge generate` and commit the generated output, or review intentional drift before the pilot handoff."] : [],
     ...input.diagnostics.length > 0 ? ["Review diagnostics and decide which schema fixes are required for the pilot scope."] : [],
@@ -4437,6 +4499,7 @@ function createReadinessSummary(input) {
   ];
   return {
     status,
+    gate,
     decision: status === "ready" ? "Schema is ready for a pilot readiness handoff under the current check policy." : status === "needs-attention" ? "Schema can continue through pilot review, but findings should be triaged first." : "Schema is not ready for pilot handoff until blockers are resolved or explicitly accepted.",
     blockers,
     warnings,
@@ -4462,17 +4525,18 @@ function evaluateFailedChecks(input) {
 // src/commands/ci.command.ts
 import { access as access3 } from "fs/promises";
 function registerCiCommand(cli) {
-  cli.command("ci <action> <provider>", "Create CI workflow templates for Forge impact review").option("--force", "Overwrite an existing workflow file").option("--output <path>", "Write workflow to a custom path").option("--mode <mode>", "Workflow mode: impact or pilot").option("--schema <path>", "OpenAPI schema path inside the repository").option("--base <ref>", "Git base ref for previous schema").action(async (action, provider, options) => {
+  cli.command("ci <action> <provider>", "Create CI workflow templates for Forge impact review").option("--force", "Overwrite an existing workflow file").option("--output <path>", "Write workflow to a custom path").option("--mode <mode>", "Workflow mode: impact or pilot").option("--gate <mode>", "Merge gate mode: block or comment").option("--schema <path>", "OpenAPI schema path inside the repository").option("--base <ref>", "Git base ref for previous schema").action(async (action, provider, options) => {
     if (action !== "init") throw new Error(`Unknown CI action "${action}". Use init.`);
     if (provider !== "github") throw new Error(`Unsupported CI provider "${provider}". Use github.`);
     const mode = normalizeMode(options.mode);
+    const gate = normalizeGate(options.gate);
     const path = options.output ?? ".github/workflows/archora-forge-impact.yml";
     if (await fileExists2(path) && !options.force) {
       logger.warn(`${path} already exists`);
       logger.line("Use --force to overwrite it.");
       return;
     }
-    await writeReportFile(path, createGithubImpactWorkflow({ mode, schema: options.schema ?? "openapi.yaml", base: options.base ?? "origin/main" }));
+    await writeReportFile(path, createGithubImpactWorkflow({ mode, gate, schema: options.schema ?? "openapi.yaml", base: options.base ?? "origin/main" }));
     logger.success(`Created ${path}`);
     logger.line("Next: review OPENAPI_SCHEMA and OPENAPI_BASE_REF for your repository.");
   });
@@ -4485,6 +4549,11 @@ function normalizeMode(value) {
   if (value === "impact" || value === "pilot") return value;
   throw new Error("Invalid CI mode. Use impact or pilot.");
 }
+function normalizeGate(value) {
+  if (!value) return "block";
+  if (value === "block" || value === "comment") return value;
+  throw new Error("Invalid CI gate mode. Use block or comment.");
+}
 function createGithubImpactWorkflow(options) {
   const runStep = options.mode === "pilot" ? `          pnpm exec archora-forge pilot "$OPENAPI_SCHEMA" --base "$OPENAPI_BASE_REF" \\
             --repo . \\
@@ -4496,6 +4565,12 @@ function createGithubImpactWorkflow(options) {
             --pr-comment-file forge-impact-pr.md`;
   const artifactPath = options.mode === "pilot" ? `            forge-pilot/**` : `            forge-impact.md
             forge-impact-pr.md`;
+  const blockStep = options.gate === "block" ? `
+      - name: Block merge on blocked API impact
+        if: steps.forge.outcome == 'failure'
+        run: |
+          echo "Archora Forge reported blocked API impact. Review the PR comment and uploaded artifacts."
+          exit 1` : "";
   return `name: archora-forge-impact
 
 on:
@@ -4512,6 +4587,7 @@ permissions:
 env:
   OPENAPI_SCHEMA: ${options.schema}
   OPENAPI_BASE_REF: ${options.base}
+  FORGE_GATE_MODE: ${options.gate}
 
 jobs:
   ${options.mode}:
@@ -4533,6 +4609,8 @@ jobs:
       - run: pnpm install --frozen-lockfile
 
       - name: Run Forge impact
+        id: forge
+        continue-on-error: true
         run: |
 ${runStep}
 
@@ -4548,6 +4626,7 @@ ${artifactPath}
         with:
           file-path: forge-impact-pr.md
           comment-tag: archora-forge-impact
+${blockStep}
 `;
 }
 
@@ -4640,14 +4719,48 @@ function formatPullRequestComment(payload) {
   return [
     "## Frontend API Impact",
     "",
+    `Merge decision: ${formatMergeDecision(payload.decision.status)}`,
+    `Merge risk: ${payload.decision.mergeRisk}`,
+    `Reason: ${payload.decision.reason}`,
+    "",
     payload.prSummary,
     "",
+    "## Next Actions",
+    "",
+    ...formatNextActionLines(payload),
+    "",
     "## Source Usage",
     "",
     ...formatSourceUsageLines(payload.sourceUsages ?? []),
     ""
   ].join("\n");
 }
+function formatMergeDecision(status) {
+  if (status === "blocked") return "block";
+  if (status === "review") return "review";
+  return "pass";
+}
+function formatNextActionLines(payload) {
+  if (payload.decision.status === "blocked") {
+    return [
+      "- Do not merge until the breaking frontend contract changes are handled.",
+      "- Update impacted source usages before regenerating committed Forge output.",
+      "- Re-run `archora-forge impact` after the OpenAPI or frontend changes are updated."
+    ];
+  }
+  if (payload.decision.status === "review") {
+    return [
+      "- Review warnings with the frontend owner before merge.",
+      "- Regenerate Forge output in the branch if the contract change is accepted.",
+      "- Keep the PR comment attached to the API change for reviewer context."
+    ];
+  }
+  return [
+    "- Merge can continue from the API impact perspective.",
+    "- Regenerate Forge output when the schema change is accepted.",
+    "- Keep `archora-forge check` in CI to catch drift after regeneration."
+  ];
+}
 function formatSourceUsageLines(usages) {
   if (usages.length === 0) return ["No impacted source usages found."];
   return usages.slice(0, 50).map((usage) => `- \`${usage.path}:${usage.lines.join(",")}\`: ${usage.matches.join(", ")}`);
@@ -4832,11 +4945,15 @@ function registerDemoCommand(cli) {
         skipTypecheck: true
       });
       await writeReportFile(join8(reportDir, "go-no-go.md"), createDemoGoNoGo(impact, audit.payload.ok));
+      await Promise.all([
+        writeReportFile(join8(reportDir, "check.html"), createDemoCheckHtml(impact, audit.payload.ok)),
+        writeReportFile(join8(reportDir, "README.md"), createDemoHandoff())
+      ]);
       logger.title();
       logger.line(`Demo package: ${outDir}`);
       logger.line(`Decision: ${impact.decision.status === "blocked" ? "no-go" : "review"}`);
       logger.line(`Impact report: ${join8(reportDir, "impact.md")}`);
-      process.exitCode = impact.decision.status === "blocked" ? 1 : 0;
+      process.exitCode = 0;
     } catch (error) {
       logger.error(error instanceof Error ? error.message : String(error));
       process.exitCode = 2;
@@ -4867,6 +4984,69 @@ function createDemoGoNoGo(impact, auditOk) {
     ""
   ].join("\n");
 }
+function createDemoCheckHtml(impact, auditOk) {
+  const failedChecks = [
+    ...impact.decision.status === "blocked" ? ["api-impact-blocked"] : [],
+    ...!auditOk ? ["audit-readiness-failed"] : []
+  ];
+  const status = failedChecks.length === 0 ? "ready" : "blocked";
+  return createHtmlReport("Archora Forge Check", {
+    ok: failedChecks.length === 0,
+    schema: impact.newSchema,
+    healthScore: auditOk ? 100 : 80,
+    generatedFiles: impact.affectedFiles.length,
+    failedChecks,
+    readiness: {
+      status,
+      gate: status === "blocked" ? {
+        result: "fail",
+        recommendedCiMode: "block",
+        reason: "Demo impact contains blocking frontend API changes."
+      } : {
+        result: "pass",
+        recommendedCiMode: "block",
+        reason: "Demo package has no blocking checks under the current policy."
+      },
+      decision: status === "blocked" ? "Do not merge until breaking frontend contract changes are handled." : "The demo package can continue through review.",
+      blockers: failedChecks.length > 0 ? failedChecks.map((check) => `Failed check: ${check}.`) : [],
+      warnings: impact.summary.warnings > 0 ? [`Impact report contains ${impact.summary.warnings} warnings.`] : [],
+      nextActions: status === "blocked" ? ["Open `impact-pr.md` first.", "Review impacted source usages.", "Open `audit/index.html` for generated output readiness."] : ["Attach this report to the PR or pilot handoff."],
+      reviewerChecklist: [
+        "Confirm `impact-pr.md` gives a clear merge decision.",
+        "Confirm affected generated files map to real frontend ownership.",
+        "Confirm `audit/index.html` matches the expected resource model."
+      ]
+    },
+    summary: impact.summary,
+    decision: impact.decision,
+    affectedResources: impact.affectedResources,
+    affectedFiles: impact.affectedFiles,
+    sourceUsages: impact.sourceUsages,
+    migrationHints: impact.migrationHints
+  });
+}
+function createDemoHandoff() {
+  return [
+    "# Forge Demo Package",
+    "",
+    "Open `impact-pr.md` first. It is the pull-request comment a reviewer should see before merge.",
+    "",
+    "Then review:",
+    "",
+    "- Open `impact.md` for the full frontend API impact report.",
+    "- Open `check.html` for the reviewer-friendly readiness summary.",
+    "- Open `audit/index.html` for generated output readiness and audit evidence.",
+    "- Open `go-no-go.md` for the short adoption decision.",
+    "",
+    "To run the same package on a real repo:",
+    "",
+    "```sh",
+    "archora-forge pilot ./openapi.yaml --base origin/main --repo . --out forge-pilot",
+    "archora-forge ci init github --schema ./openapi.yaml --base origin/main --gate comment",
+    "```",
+    ""
+  ].join("\n");
+}
 var demoOldSchema = `openapi: 3.0.3
 info: { title: Forge Demo API, version: 1.0.0 }
 paths:
@@ -5573,7 +5753,10 @@ function registerPilotCommand(cli) {
         schemaHeader: options.schemaHeader
       });
       const decision = createGoNoGo({ impact, auditOk: audit.payload.ok, auditDecision: audit.payload.readiness.decision });
-      await writeReportFile(join9(outDir, "go-no-go.md"), decision.markdown);
+      await Promise.all([
+        writeReportFile(join9(outDir, "go-no-go.md"), decision.markdown),
+        writeReportFile(join9(outDir, "pilot-report.md"), createPilotReport({ impact, status: decision.status, auditOk: audit.payload.ok, auditDecision: audit.payload.readiness.decision }))
+      ]);
       logger.title();
       logger.line(`Pilot package: ${outDir}`);
       logger.line(`Decision: ${decision.status}`);
@@ -5649,6 +5832,61 @@ function createGoNoGo(input) {
   ];
   return { status, markdown: lines.join("\n") };
 }
+function createPilotReport(input) {
+  return [
+    "# Archora Forge Pilot Report",
+    "",
+    "## Decision",
+    "",
+    `Decision: ${input.status}`,
+    `Impact: ${input.impact.decision.status}`,
+    `Merge risk: ${input.impact.decision.mergeRisk}`,
+    `Audit: ${input.auditOk ? "passed" : "failed"}`,
+    "",
+    "## Artifact Links",
+    "",
+    "- `impact-pr.md` - PR comment for reviewers.",
+    "- `impact.md` - full frontend API impact report.",
+    "- `impact.json` - machine-readable impact payload.",
+    "- `audit/index.html` - generated output audit and readiness report.",
+    "- `audit/report.md` - Markdown audit handoff.",
+    "- `go-no-go.md` - short adoption decision.",
+    "",
+    "## Impact Summary",
+    "",
+    `- Old schema: ${input.impact.oldSchema}`,
+    `- New schema: ${input.impact.newSchema}`,
+    ...input.impact.base ? [`- Base ref: ${input.impact.base}`] : [],
+    `- Breaking changes: ${input.impact.summary.breaking}`,
+    `- Warnings: ${input.impact.summary.warnings}`,
+    `- Non-breaking changes: ${input.impact.summary.nonBreaking}`,
+    `- Source usage matches: ${input.impact.sourceUsages?.length ?? 0}`,
+    "",
+    "## Affected Surface",
+    "",
+    `- Resources: ${formatInlineList(input.impact.affectedResources)}`,
+    `- Generated files: ${formatInlineList(input.impact.affectedFiles)}`,
+    `- Operation IDs: ${formatInlineList(input.impact.impactedSurface.operationIds)}`,
+    `- Client methods: ${formatInlineList(input.impact.impactedSurface.clientMethods)}`,
+    `- Query hooks: ${formatInlineList(input.impact.impactedSurface.queryHooks)}`,
+    "",
+    "## Reviewer Checklist",
+    "",
+    "- Confirm `impact-pr.md` gives a clear merge decision.",
+    "- Confirm `impact.md` names the breaking changes and affected generated files.",
+    "- Confirm `audit/index.html` matches the frontend resource model.",
+    "- Confirm `audit/typecheck.md` passed or every failure is triaged.",
+    "- Confirm `go-no-go.md` matches the team decision before purchase or rollout.",
+    "",
+    "## Next Review Step",
+    "",
+    input.status === "go" ? "Add the generated GitHub workflow, run the first PR with Forge comments enabled, then decide whether to commit generated output." : input.status === "conditional-go" ? "Review warnings with the frontend owner before committing generated output or widening scope." : "Do not roll out Forge on this schema until blockers are fixed or explicitly accepted by the frontend owner.",
+    ""
+  ].join("\n");
+}
+function formatInlineList(values) {
+  return values && values.length > 0 ? values.map((value) => `\`${value}\``).join(", ") : "none";
+}
 
 // src/commands/inspect.command.ts
 function registerInspectCommand(cli) {

package/package.json

@@ -1,51 +1,51 @@
-{
-  "name": "@archora/forge-cli",
-  "version": "1.2.1",
-  "description": "CLI for generating typed frontend resource contracts from OpenAPI contracts.",
-  "license": "SEE LICENSE IN LICENSE",
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/archora-dev/archora-forge.git"
-  },
-  "bugs": {
-    "url": "https://github.com/archora-dev/archora-forge/issues"
-  },
-  "homepage": "https://github.com/archora-dev/archora-forge#readme",
-  "type": "module",
-  "main": "./dist/index.js",
-  "types": "./dist/index.d.ts",
-  "bin": {
-    "archora-forge": "dist/index.js"
-  },
-  "exports": {
-    ".": {
-      "types": "./dist/index.d.ts",
-      "import": "./dist/index.js"
-    }
-  },
-  "files": [
-    "dist"
-  ],
-  "publishConfig": {
-    "access": "public"
-  },
-  "scripts": {
-    "build": "tsup",
-    "dev": "tsup --watch",
-    "typecheck": "tsc --noEmit"
-  },
-  "dependencies": {
-    "cac": "^6.7.14",
-    "jiti": "^2.7.0",
-    "picocolors": "^1.1.1",
-    "prettier": "^3.5.3",
-    "yaml": "^2.8.4"
-  },
-  "devDependencies": {
-    "@archora/forge-config": "workspace:*",
-    "@archora/forge-core": "workspace:*",
-    "@types/node": "^22.15.17",
-    "tsup": "^8.4.0",
-    "typescript": "^5.8.3"
-  }
-}
+{
+  "name": "@archora/forge-cli",
+  "version": "1.3.0",
+  "description": "CLI for generating typed frontend resource contracts from OpenAPI contracts.",
+  "license": "SEE LICENSE IN LICENSE",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/archora-dev/archora-forge.git"
+  },
+  "bugs": {
+    "url": "https://github.com/archora-dev/archora-forge/issues"
+  },
+  "homepage": "https://github.com/archora-dev/archora-forge#readme",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "bin": {
+    "archora-forge": "dist/index.js"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "cac": "^6.7.14",
+    "jiti": "^2.7.0",
+    "picocolors": "^1.1.1",
+    "prettier": "^3.5.3",
+    "yaml": "^2.8.4"
+  },
+  "devDependencies": {
+    "@types/node": "^22.15.17",
+    "tsup": "^8.4.0",
+    "typescript": "^5.8.3",
+    "@archora/forge-config": "1.3.0",
+    "@archora/forge-core": "1.3.0"
+  },
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "typecheck": "tsc --noEmit"
+  }
+}