@axiomify/cli 6.0.0-rc.2 → 6.1.0

package/README.md

@@ -1,5 +1,11 @@
 # @axiomify/cli
 
+
+[![npm version](https://img.shields.io/npm/v/@axiomify/cli.svg)](https://npmjs.com/package//@axiomify/cli)
+[![codecov](https://codecov.io/github/otopman/axiomify/graph/badge.svg)](https://codecov.io/github/otopman/axiomify)
+[![OpenSSF Scorecard](https://api.securityscorecards.dev/projects/github.com/OTopman/axiomify/badge)](https://securityscorecards.dev/viewer/?uri=github.com/OTopman/axiomify)
+[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](https://opensource.org/licenses/MIT)
+
 The official CLI for the Axiomify framework — scaffold projects, run the
 dev server, build production bundles, inspect routes, generate OpenAPI
 specs, and audit production readiness.
@@ -26,11 +32,12 @@ the same major as your `@axiomify/*` runtime packages.
 | `axiomify openapi [entry]` | Generate the OpenAPI 3.0.3 spec |
 | `axiomify check [entry]` | Static production-readiness audit |
 | `axiomify doctor` | Diagnose the host environment |
+| `axiomify sdk <subcommand>` | Manage, generate, build, validate, and diff SDKs |
 
 `[entry]` defaults to `src/index.ts` everywhere it's accepted.
 
 For the full reference (flags, exit codes, CI examples), see
-[`docs/packages/cli.md`](../../docs/packages/cli.md).
+[`./docs/packages/cli.md`](https://github.com/OTopman/axiomify/blob/main/docs/packages/cli.md).
 
 ## `axiomify init`
 
@@ -138,6 +145,30 @@ alignment, uWS bindings load successfully, recent build artefact, port
 Run on a fresh clone or new CI runner before chasing test failures that
 turn out to be Node-version mismatches.
 
+## `axiomify sdk`
+
+Subcommands for compiling type-safe client SDKs from specs:
+
+```bash
+# Generate SDKs for TS, Python, and Go:
+axiomify sdk generate spec.json --target typescript python go -o ./sdks
+
+# Deep structural diff for breaking changes:
+axiomify sdk diff old-spec.json new-spec.json
+
+# Get client migration guidance:
+axiomify sdk migrate old-spec.json new-spec.json
+
+# Run generation hot-reloads on file change:
+axiomify sdk watch spec.json --target typescript python
+
+# Run local toolchain diagnostics:
+axiomify sdk doctor
+
+# Run compiler and emitter throughput benchmarks:
+axiomify sdk benchmark
+```
+
 ## CI example
 
 ```yaml
@@ -146,6 +177,8 @@ turn out to be Node-version mismatches.
 - run: npx axiomify build
 - run: npx axiomify openapi -o ./openapi.json --spec-version "$GITHUB_SHA"
 - run: npx axiomify routes --json > routes.json   # surface snapshot
+- run: npx axiomify sdk validate ./openapi.json   # schema verification
+- run: npx axiomify sdk diff old-spec.json ./openapi.json # check breaking changes
 ```
 
 Diff `routes.json` between commits to detect accidental API changes

package/dist/{dist-PKSGYMK7.mjs → dist-SYWHGZLI.mjs}

@@ -33,7 +33,7 @@ var OpenApiGenerator = class {
   options;
   generate() {
     const spec = {
-      openapi: "3.0.3",
+      openapi: "3.1.0",
       info: this.options.info,
       paths: {}
     };
@@ -44,39 +44,27 @@ var OpenApiGenerator = class {
       const method = route.method.toLowerCase();
       const paths = spec.paths;
       if (!paths[openApiPath]) paths[openApiPath] = {};
-      const op = route.openapi ?? void 0;
+      const s = route.schema ?? {};
       const operation = {
-        // OAS §4.7.10.2 — summary. Default to `${method} ${path}` so the
-        // docs UI always has a human-readable title even without user input.
-        summary: op?.summary ?? `${route.method} ${route.path}`,
-        // OAS §4.7.10.5 — operationId. Client codegen tools
-        // (openapi-typescript, openapi-generator) use this to name the
-        // generated function. When the user doesn't supply one we
-        // synthesise a stable name from method+path:
-        //   GET /users/:id → "getUsersById"
-        //   POST /users    → "postUsers"
-        // Determinism matters here — codegen output should not drift
-        // between releases unless method+path actually change.
-        operationId: op?.operationId ?? this.synthesiseOperationId(route.method, route.path),
+        // OAS §4.8.10.2 — summary. Defaults to `${method} ${path}`.
+        summary: s.summary ?? `${route.method} ${route.path}`,
+        // OAS §4.8.10.5 — operationId for client codegen tools.
+        // Auto-synthesised from method+path when omitted:
+        //   GET /users/:id → "getUsersById"   POST /users → "postUsers"
+        operationId: s.operationId ?? this.synthesiseOperationId(route.method, route.path),
         parameters: this.extractParameters(route),
         responses: this.extractResponses(route)
       };
-      const legacySchema = route.schema ?? {};
-      const description = op?.description ?? legacySchema.description;
-      const tags = op?.tags ?? legacySchema.tags;
-      const security = op?.security ?? legacySchema.security;
-      if (description) operation.description = description;
-      if (tags) operation.tags = tags;
-      if (security !== void 0) operation.security = security;
-      if (op?.deprecated) operation.deprecated = true;
-      if (op?.externalDocs) operation.externalDocs = op.externalDocs;
-      if (op?.servers) operation.servers = op.servers;
-      if (op?.callbacks) operation.callbacks = op.callbacks;
+      if (s.description) operation.description = s.description;
+      if (s.tags) operation.tags = s.tags;
+      if (s.security !== void 0) operation.security = s.security;
+      if (s.deprecated) operation.deprecated = true;
+      if (s.externalDocs) operation.externalDocs = s.externalDocs;
+      if (s.servers) operation.servers = s.servers;
+      if (s.callbacks) operation.callbacks = s.callbacks;
       const body = this.extractBody(route);
       if (body) {
-        if (op?.requestBodyDescription) {
-          body.description = op.requestBodyDescription;
-        }
+        if (s.requestBodyDescription) body.description = s.requestBodyDescription;
         operation.requestBody = body;
       }
       paths[openApiPath][method] = operation;
@@ -170,8 +158,7 @@ var OpenApiGenerator = class {
     return { required: true, content: { [contentType]: { schema: finalSchema } } };
   }
   extractResponses(route) {
-    const op = route.openapi;
-    const descriptions = op?.responseDescriptions ?? {};
+    const descriptions = route.schema?.responseDescriptions ?? {};
     const defaultResponse = {
       "200": {
         description: descriptions["200"] ?? "Successful response",