@autoview/cli 0.1.0

package/lib/orchestrate/utils/buildDeterministicSdkMap.js

@@ -0,0 +1,154 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildDeterministicSdkMap = buildDeterministicSdkMap;
+const classifyEndpoints_1 = require("../../utils/classifyEndpoints");
+const toEndpoints_1 = require("../../utils/toEndpoints");
+/**
+ * Deterministic SDK domain map — the LLM-free replacement for the Phase-1 SDK
+ * Study, and the fix for "a large swagger overflows the model's context".
+ *
+ * The original SDK Study compiled the WHOLE SDK source and asked the model to
+ * infer resources / actors / journeys. On a 200-type swagger that prompt is
+ * 300k+ tokens — a hard context overflow. But the downstream phases barely use
+ * the map's prose: the Product Plan is already deterministic and reads only
+ * `actors[0].name`; Scaffold/Review embed the map as a wiki document; Render
+ * reads an actor's journeys only on the LLM rerender fallback. So the map can be
+ * derived structurally — same swagger, same map, zero tokens — without changing
+ * what reaches the user.
+ *
+ * - resources: the top-level CRUD groups from {@link classifyEndpoints}.
+ * - actors:    role segments found in the accessors (`customers`, `sellers`,
+ *   `admins`), normalized; falls back to a single `user`.
+ * - journeys:  a short structural summary per actor (never empty — the SDK-map
+ *   invariant requires ≥1 per actor).
+ */
+function buildDeterministicSdkMap(document) {
+    const endpoints = (0, toEndpoints_1.toEndpoints)(document);
+    const groups = (0, classifyEndpoints_1.classifyEndpoints)(endpoints, document);
+    const actors = deriveActors(endpoints);
+    const actorNames = actors.map((a) => a.name);
+    // Top-level resources only (depth 1). Nested groups (`sales/questions`) fold
+    // into their parent for the domain map; the Product Plan still renders their
+    // screens from the full classification.
+    const resources = groups
+        .filter((g) => g.depth === 1 && g.resource !== "root")
+        .map((g) => {
+        var _a;
+        const sample = (_a = g.endpoints[0]) === null || _a === void 0 ? void 0 : _a.endpoint;
+        const namespace = sample !== undefined && sample.accessor.length > 1
+            ? sample.accessor.slice(0, -1).join(".")
+            : g.resource;
+        return {
+            name: g.resource,
+            namespace,
+            purpose: purposeOf(g.resource, g.roles),
+            actorsInvolved: actorNames,
+            notes: notesOf(g.roles),
+        };
+    });
+    return {
+        resources,
+        actors,
+        notableConstraints: deriveConstraints(endpoints),
+    };
+}
+/* -------------------------------------------------------------------------- */
+/* actors                                                                     */
+/* -------------------------------------------------------------------------- */
+/**
+ * Accessor segments that name an actor role, mapped to their canonical
+ * singular display name. Real swaggers expose an actor as a namespace segment
+ * (`shoppings.customers.sales`, `shoppings.sellers.sales`); we read the role
+ * straight off the accessor instead of guessing from the domain.
+ */
+const ROLE_SEGMENTS = {
+    customer: "customer",
+    customers: "customer",
+    seller: "seller",
+    sellers: "seller",
+    admin: "administrator",
+    admins: "administrator",
+    administrator: "administrator",
+    administrators: "administrator",
+    member: "member",
+    members: "member",
+    buyer: "buyer",
+    buyers: "buyer",
+    manager: "manager",
+    managers: "manager",
+    guest: "guest",
+    guests: "guest",
+};
+function deriveActors(endpoints) {
+    const names = [];
+    const seen = new Set();
+    for (const e of endpoints) {
+        for (const seg of e.accessor) {
+            const canon = ROLE_SEGMENTS[seg.toLowerCase()];
+            if (canon !== undefined && !seen.has(canon)) {
+                seen.add(canon);
+                names.push(canon);
+            }
+        }
+    }
+    const finalNames = names.length > 0 ? names : ["user"];
+    // Lead with the end-user actor: the Product Plan assigns every screen to
+    // `actors[0]`, so a customer-facing label reads more naturally on the nav than
+    // an admin one. Purely cosmetic — the screen set is identical either way.
+    const ordered = [...finalNames].sort((a, b) => actorRank(a) - actorRank(b));
+    return ordered.map((name) => ({
+        name,
+        journeys: [`Sign in as ${name} → navigate the resources they can access.`],
+    }));
+}
+/** End-users first, privileged roles last; unknowns keep their found order. */
+const ACTOR_PRIORITY = [
+    "customer",
+    "buyer",
+    "member",
+    "user",
+    "guest",
+    "seller",
+    "manager",
+    "administrator",
+];
+function actorRank(name) {
+    const i = ACTOR_PRIORITY.indexOf(name);
+    return i === -1 ? ACTOR_PRIORITY.length : i;
+}
+/* -------------------------------------------------------------------------- */
+/* resource prose (deterministic)                                             */
+/* -------------------------------------------------------------------------- */
+function purposeOf(resource, roles) {
+    const verbs = [];
+    if (roles.has("list") || roles.has("search"))
+        verbs.push("browse");
+    if (roles.has("detail"))
+        verbs.push("view");
+    if (roles.has("create"))
+        verbs.push("create");
+    if (roles.has("update"))
+        verbs.push("update");
+    if (roles.has("delete"))
+        verbs.push("remove");
+    if (roles.has("action"))
+        verbs.push("act on");
+    const verb = verbs.length > 0 ? verbs.join(", ") : "work with";
+    return `Lets a user ${verb} ${resource}.`;
+}
+function notesOf(roles) {
+    return roles.has("search")
+        ? "Supports search/filter/pagination via query parameters."
+        : "";
+}
+function deriveConstraints(endpoints) {
+    const constraints = [];
+    if (endpoints.some((e) => e.query !== null)) {
+        constraints.push("Some list endpoints accept query parameters for search/filter/pagination.");
+    }
+    if (endpoints.some((e) => e.method.toLowerCase() === "delete")) {
+        constraints.push("Delete endpoints are present — confirm before destructive actions.");
+    }
+    return constraints;
+}
+//# sourceMappingURL=buildDeterministicSdkMap.js.map

package/lib/orchestrate/utils/buildDeterministicSdkMap.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"buildDeterministicSdkMap.js","sourceRoot":"","sources":["../../../src/orchestrate/utils/buildDeterministicSdkMap.ts"],"names":[],"mappings":"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"}

package/lib/orchestrate/utils/cacheNodeModules.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Per-package.json cache directory holding an installed `node_modules`. Sits
+ * under `$XDG_CACHE_HOME` when set, else `~/.cache`, partitioned by
+ * `(cacheNamespace, hash)` so callers with different dependency sets — and
+ * different downstream consumers (typecheck vs runtime audit) — never collide
+ * on the same cache key.
+ *
+ * Returns the absolute path to the populated `node_modules` directory on
+ * success, or `null` when the cache could not be set up (no writable cache
+ * root, the install crashed, etc.). Callers fall back to a plain in-place
+ * install in that case so the behavior degrades gracefully.
+ *
+ * `extraDeps` lets a caller add packages on top of the bare frontend dependency
+ * set without renaming the cache namespace: the runtime-audit cache uses
+ * `["playwright@^1.50.0"]` so the cached `node_modules` already contains
+ * Playwright the next time the agent runs an audit, on top of the same
+ * React/Next/shadcn tree as the typecheck cache.
+ */
+export declare function ensureCachedNodeModules(args: {
+    cacheNamespace: string;
+    hash: string;
+    packageJson: string;
+    extraDeps?: readonly string[];
+}): Promise<string | null>;
+/**
+ * Create a symlink from `<workingDir>/node_modules` → `<cachedNodeModules>`.
+ * Returns `false` when the symlink could not be created (Windows without admin,
+ * filesystem refuses links, etc.) so the caller falls back to a plain in-place
+ * install.
+ */
+export declare function tryLinkNodeModules(workingDir: string, cachedNodeModules: string): Promise<boolean>;

package/lib/orchestrate/utils/cacheNodeModules.js

@@ -0,0 +1,134 @@
+"use strict";
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ensureCachedNodeModules = ensureCachedNodeModules;
+exports.tryLinkNodeModules = tryLinkNodeModules;
+const child_process_1 = require("child_process");
+const promises_1 = __importDefault(require("fs/promises"));
+const os_1 = __importDefault(require("os"));
+const path_1 = __importDefault(require("path"));
+/**
+ * Per-package.json cache directory holding an installed `node_modules`. Sits
+ * under `$XDG_CACHE_HOME` when set, else `~/.cache`, partitioned by
+ * `(cacheNamespace, hash)` so callers with different dependency sets — and
+ * different downstream consumers (typecheck vs runtime audit) — never collide
+ * on the same cache key.
+ *
+ * Returns the absolute path to the populated `node_modules` directory on
+ * success, or `null` when the cache could not be set up (no writable cache
+ * root, the install crashed, etc.). Callers fall back to a plain in-place
+ * install in that case so the behavior degrades gracefully.
+ *
+ * `extraDeps` lets a caller add packages on top of the bare frontend dependency
+ * set without renaming the cache namespace: the runtime-audit cache uses
+ * `["playwright@^1.50.0"]` so the cached `node_modules` already contains
+ * Playwright the next time the agent runs an audit, on top of the same
+ * React/Next/shadcn tree as the typecheck cache.
+ */
+function ensureCachedNodeModules(args) {
+    return __awaiter(this, void 0, void 0, function* () {
+        var _a;
+        if (args.hash === "no-package-json")
+            return null;
+        const cacheRoot = path_1.default.join((_a = process.env.XDG_CACHE_HOME) !== null && _a !== void 0 ? _a : path_1.default.join(os_1.default.homedir(), ".cache"), `autoview-${args.cacheNamespace}`, args.hash);
+        const nodeModules = path_1.default.join(cacheRoot, "node_modules");
+        try {
+            // `node_modules/.package-lock.json` is the canonical "install completed"
+            // sentinel npm writes at the end of `npm install`. Its presence means
+            // the previous run finished cleanly and the cache is reusable.
+            yield promises_1.default.access(path_1.default.join(nodeModules, ".package-lock.json"));
+            return nodeModules;
+        }
+        catch (_b) {
+            // Cache miss: populate it. Use a sibling temp dir + rename so a
+            // concurrent agent run cannot observe a half-written node_modules.
+            const installer = yield promises_1.default.mkdtemp(path_1.default.join(os_1.default.tmpdir(), `autoview-${args.cacheNamespace}-cache-${args.hash}-`));
+            try {
+                yield promises_1.default.writeFile(path_1.default.join(installer, "package.json"), args.packageJson, "utf-8");
+                yield runNpm(installer, [
+                    "install",
+                    "--silent",
+                    "--no-audit",
+                    "--no-fund",
+                ]);
+                if (args.extraDeps !== undefined && args.extraDeps.length > 0) {
+                    yield runNpm(installer, [
+                        "install",
+                        "--silent",
+                        "--no-audit",
+                        "--no-fund",
+                        "--no-save",
+                        ...args.extraDeps,
+                    ]);
+                }
+                yield promises_1.default.mkdir(cacheRoot, { recursive: true });
+                // Atomically move node_modules into place. If something is already
+                // there (concurrent run won the race), rm-then-rename overwrites it
+                // — both are valid installs of the same package.json.
+                yield promises_1.default.rm(nodeModules, { recursive: true, force: true });
+                yield promises_1.default.rename(path_1.default.join(installer, "node_modules"), nodeModules);
+            }
+            catch (_c) {
+                yield promises_1.default.rm(installer, { recursive: true, force: true }).catch(() => { });
+                return null;
+            }
+            yield promises_1.default.rm(installer, { recursive: true, force: true }).catch(() => { });
+            try {
+                yield promises_1.default.access(path_1.default.join(nodeModules, ".package-lock.json"));
+                return nodeModules;
+            }
+            catch (_d) {
+                return null;
+            }
+        }
+    });
+}
+/**
+ * Create a symlink from `<workingDir>/node_modules` → `<cachedNodeModules>`.
+ * Returns `false` when the symlink could not be created (Windows without admin,
+ * filesystem refuses links, etc.) so the caller falls back to a plain in-place
+ * install.
+ */
+function tryLinkNodeModules(workingDir, cachedNodeModules) {
+    return __awaiter(this, void 0, void 0, function* () {
+        const target = path_1.default.join(workingDir, "node_modules");
+        try {
+            yield promises_1.default.symlink(cachedNodeModules, target, "dir");
+            return true;
+        }
+        catch (_a) {
+            return false;
+        }
+    });
+}
+function runNpm(cwd, args) {
+    return new Promise((resolve, reject) => {
+        const child = (0, child_process_1.spawn)("npm", args, { cwd, stdio: "pipe" });
+        let stderr = "";
+        child.stderr.on("data", (chunk) => {
+            stderr += chunk.toString("utf-8");
+        });
+        child.on("error", (err) => {
+            reject(new Error(`Failed to spawn \`npm ${args.join(" ")}\`: ${err.message}`));
+        });
+        child.on("close", (code) => {
+            if (code === 0)
+                resolve();
+            else
+                reject(new Error(`\`npm ${args.slice(0, 3).join(" ")}...\` exited with code ${code}` +
+                    (stderr.length > 0 ? `:\n${stderr.slice(-1500)}` : "")));
+        });
+    });
+}
+//# sourceMappingURL=cacheNodeModules.js.map

package/lib/orchestrate/utils/cacheNodeModules.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cacheNodeModules.js","sourceRoot":"","sources":["../../../src/orchestrate/utils/cacheNodeModules.ts"],"names":[],"mappings":"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"}

package/lib/orchestrate/utils/describeEndpointPropsShape.d.ts

@@ -0,0 +1,37 @@
+import { OpenApi } from "@typia/interface";
+import { IAutoViewEndpoint } from "../../utils";
+/**
+ * Derive the Nestia `(connection, props)` call shape for a single AutoBE
+ * operation as a one-line TypeScript signature string. Used by the Render phase
+ * to spoon-feed the LLM the exact `props` object shape it has to pass —
+ * otherwise the model routinely flattens body fields into the top level of
+ * `props`, which makes the simulator return a masked 400 and the page renders
+ * the empty state.
+ *
+ * Examples (matching the live shopping SDK):
+ *
+ * - `at` on `/sales/:id` → `{ id: string }`
+ * - `index` on `/sales` (PATCH) → `{ body: IShoppingSale.IRequest }`
+ * - `create` on `/sales/:saleId/reviews` → `{ saleId: string; body:
+ *   IShoppingSaleReview.ICreate }`
+ *
+ * Pure. Does not mutate the operation.
+ */
+export declare function describeEndpointPropsShape(op: IAutoViewEndpoint): string;
+/**
+ * Inspect the document's component schemas and return a brief, machine-friendly
+ * line describing the operation's request body — what type it is, which fields
+ * are required, and a sample literal the LLM can copy verbatim into the page
+ * when no domain-specific filter applies.
+ *
+ * Returns an empty string when the operation has no request body, or when the
+ * referenced schema cannot be resolved (the prompt is then unchanged for that
+ * endpoint, no harm done).
+ *
+ * Format:
+ *
+ *     body: IShoppingSale.IRequest — required: [page, limit]; example: { "page": 1, "limit": 24 }
+ *
+ * Pure. Does not mutate the document.
+ */
+export declare function describeRequestBodyHint(op: IAutoViewEndpoint, doc: OpenApi.IDocument): string;

package/lib/orchestrate/utils/describeEndpointPropsShape.js

@@ -0,0 +1,192 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.describeEndpointPropsShape = describeEndpointPropsShape;
+exports.describeRequestBodyHint = describeRequestBodyHint;
+/**
+ * Derive the Nestia `(connection, props)` call shape for a single AutoBE
+ * operation as a one-line TypeScript signature string. Used by the Render phase
+ * to spoon-feed the LLM the exact `props` object shape it has to pass —
+ * otherwise the model routinely flattens body fields into the top level of
+ * `props`, which makes the simulator return a masked 400 and the page renders
+ * the empty state.
+ *
+ * Examples (matching the live shopping SDK):
+ *
+ * - `at` on `/sales/:id` → `{ id: string }`
+ * - `index` on `/sales` (PATCH) → `{ body: IShoppingSale.IRequest }`
+ * - `create` on `/sales/:saleId/reviews` → `{ saleId: string; body:
+ *   IShoppingSaleReview.ICreate }`
+ *
+ * Pure. Does not mutate the operation.
+ */
+function describeEndpointPropsShape(op) {
+    const fields = [];
+    for (const param of op.parameters) {
+        fields.push(`${param.name}: ${renderParamType(param.schema)}`);
+    }
+    // Query endpoints carry their query object under `props.query`. Omitting it
+    // here is exactly why the Render LLM passed `undefined` as props for
+    // findByStatus / login and broke typecheck — the props shape never told it a
+    // query existed.
+    if (op.query != null) {
+        fields.push(`query: ${renderQueryShape(op.query)}`);
+    }
+    if (op.requestBody !== null) {
+        fields.push(`body: ${op.requestBody.typeName}`);
+    }
+    if (fields.length === 0)
+        return "{}";
+    return `{ ${fields.join("; ")} }`;
+}
+/** Render a query schema: a named component (nestia emits `*.GetQuery`) or an
+ *  inline object. The Render phase imports the named SDK type either way. */
+function renderQueryShape(query) {
+    var _a;
+    if ("$ref" in query && typeof query.$ref === "string") {
+        return query.$ref.split("/").pop();
+    }
+    if ("properties" in query && query.properties) {
+        const required = new Set((_a = query.required) !== null && _a !== void 0 ? _a : []);
+        const fields = Object.entries(query.properties).map(([name, prop]) => {
+            const optional = required.has(name) ? "" : "?";
+            const type = "type" in prop ? String(prop.type) : "unknown";
+            return `${name}${optional}: ${type}`;
+        });
+        return fields.length > 0 ? `{ ${fields.join("; ")} }` : "{}";
+    }
+    return "Record<string, unknown>";
+}
+/**
+ * Inspect the document's component schemas and return a brief, machine-friendly
+ * line describing the operation's request body — what type it is, which fields
+ * are required, and a sample literal the LLM can copy verbatim into the page
+ * when no domain-specific filter applies.
+ *
+ * Returns an empty string when the operation has no request body, or when the
+ * referenced schema cannot be resolved (the prompt is then unchanged for that
+ * endpoint, no harm done).
+ *
+ * Format:
+ *
+ *     body: IShoppingSale.IRequest — required: [page, limit]; example: { "page": 1, "limit": 24 }
+ *
+ * Pure. Does not mutate the document.
+ */
+function describeRequestBodyHint(op, doc) {
+    var _a, _b;
+    if (op.requestBody === null)
+        return "";
+    const schema = ((_b = (_a = doc.components) === null || _a === void 0 ? void 0 : _a.schemas) !== null && _b !== void 0 ? _b : {})[op.requestBody.typeName];
+    if (schema === undefined)
+        return `body: ${op.requestBody.typeName}`;
+    const required = collectRequired(schema, doc);
+    const example = sampleLiteral(schema, doc, required);
+    const requiredPart = required.length > 0
+        ? ` — required: [${required.join(", ")}]`
+        : " — (no required fields)";
+    const examplePart = example !== null ? `; example: ${example}` : "";
+    return `body: ${op.requestBody.typeName}${requiredPart}${examplePart}`;
+}
+function renderParamType(schema) {
+    if (!("type" in schema))
+        return "string";
+    switch (schema.type) {
+        case "integer":
+        case "number":
+            return "number";
+        case "boolean":
+            return "boolean";
+        default:
+            return "string";
+    }
+}
+/**
+ * Pull the `required[]` list out of an object schema, resolving a single level
+ * of `$ref` indirection when the type name points at a nested component.
+ * Returns an empty array for non-object schemas so callers can uniformly print
+ * "(no required fields)".
+ */
+function collectRequired(schema, doc) {
+    var _a;
+    const resolved = resolveSchema(schema, doc);
+    if (resolved === null)
+        return [];
+    if (!("type" in resolved) || resolved.type !== "object")
+        return [];
+    return (_a = resolved.required) !== null && _a !== void 0 ? _a : [];
+}
+/**
+ * Best-effort literal that satisfies the schema's required fields. Used to give
+ * the LLM a concrete `{ "body": ... }` starting point instead of a bare type
+ * name. We do not try to be exhaustive — just enough to clear the typia
+ * validation gate (page/limit numbers, empty arrays for collections, null for
+ * nullable refs, etc.).
+ */
+function sampleLiteral(schema, doc, required) {
+    var _a;
+    const resolved = resolveSchema(schema, doc);
+    if (resolved === null)
+        return null;
+    if (!("type" in resolved) || resolved.type !== "object")
+        return null;
+    const obj = resolved;
+    const entries = [];
+    for (const field of required) {
+        const childSchema = ((_a = obj.properties) !== null && _a !== void 0 ? _a : {})[field];
+        if (childSchema === undefined)
+            continue;
+        entries.push(`${JSON.stringify(field)}: ${sampleValue(childSchema, doc, field)}`);
+    }
+    return `{ ${entries.join(", ")} }`;
+}
+function sampleValue(schema, doc, fieldHint) {
+    var _a;
+    const resolved = (_a = resolveSchema(schema, doc)) !== null && _a !== void 0 ? _a : schema;
+    if ("const" in resolved) {
+        return JSON.stringify(resolved.const);
+    }
+    if ("oneOf" in resolved) {
+        const branches = resolved.oneOf;
+        if (branches.length > 0)
+            return sampleValue(branches[0], doc, fieldHint);
+        return "null";
+    }
+    if (!("type" in resolved))
+        return "null";
+    switch (resolved.type) {
+        case "boolean":
+            return "false";
+        case "integer":
+        case "number":
+            if (fieldHint === "page" || fieldHint === "current")
+                return "1";
+            if (fieldHint === "limit")
+                return "24";
+            return "0";
+        case "string":
+            return '""';
+        case "array":
+            return "[]";
+        case "object":
+            return "{}";
+        case "null":
+            return "null";
+    }
+    return "null";
+}
+/**
+ * Follow a single layer of `$ref` indirection so callers can ask for an object
+ * schema by type name (the request-body `typeName`) and receive the resolved
+ * component back. Returns `null` when the ref does not point at a known
+ * component.
+ */
+function resolveSchema(schema, doc) {
+    var _a, _b;
+    if ("$ref" in schema && typeof schema.$ref === "string") {
+        const name = schema.$ref.replace(/^#\/components\/schemas\//, "");
+        const target = ((_b = (_a = doc.components) === null || _a === void 0 ? void 0 : _a.schemas) !== null && _b !== void 0 ? _b : {})[name];
+        return (target !== null && target !== void 0 ? target : null);
+    }
+    return schema;
+}
+//# sourceMappingURL=describeEndpointPropsShape.js.map

package/lib/orchestrate/utils/describeEndpointPropsShape.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"describeEndpointPropsShape.js","sourceRoot":"","sources":["../../../src/orchestrate/utils/describeEndpointPropsShape.ts"],"names":[],"mappings":"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"}

package/lib/orchestrate/utils/describeEndpointRequestBodyShape.d.ts

@@ -0,0 +1,22 @@
+import { OpenApi } from "@typia/interface";
+import { IAutoViewEndpoint } from "../../utils";
+/**
+ * Render the request body type of a single AutoBE operation as a readable,
+ * multi-line TypeScript-shaped string — mirror of
+ * {@link describeEndpointResponseShape} for the input side.
+ *
+ * The existing one-line {@link describeRequestBodyHint} surfaces the typeName,
+ * required keys, and a sample literal, but stops short of expanding nested
+ * arrays-of-union-literals (sort grammars) or other deeply-typed request DTOs —
+ * which is enough for the LLM to fall back on its priors and emit `sort: {
+ * field: ..., direction: ... }[]` against an `ITrashRequest.sort` whose real
+ * shape is `("created_at.asc" | "created_at.desc" | ...)[]`. Pre-rendering the
+ * full shape on the way in kills that whole class of defect at zero LLM cost,
+ * just like the response path does.
+ *
+ * Returns `null` when the operation has no request body so callers can skip the
+ * line entirely rather than emitting `body: void`.
+ *
+ * Pure. Does not mutate the document.
+ */
+export declare function describeEndpointRequestBodyShape(op: IAutoViewEndpoint, doc: OpenApi.IDocument): string | null;

package/lib/orchestrate/utils/describeEndpointRequestBodyShape.js

@@ -0,0 +1,29 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.describeEndpointRequestBodyShape = describeEndpointRequestBodyShape;
+const renderJsonSchema_1 = require("./renderJsonSchema");
+/**
+ * Render the request body type of a single AutoBE operation as a readable,
+ * multi-line TypeScript-shaped string — mirror of
+ * {@link describeEndpointResponseShape} for the input side.
+ *
+ * The existing one-line {@link describeRequestBodyHint} surfaces the typeName,
+ * required keys, and a sample literal, but stops short of expanding nested
+ * arrays-of-union-literals (sort grammars) or other deeply-typed request DTOs —
+ * which is enough for the LLM to fall back on its priors and emit `sort: {
+ * field: ..., direction: ... }[]` against an `ITrashRequest.sort` whose real
+ * shape is `("created_at.asc" | "created_at.desc" | ...)[]`. Pre-rendering the
+ * full shape on the way in kills that whole class of defect at zero LLM cost,
+ * just like the response path does.
+ *
+ * Returns `null` when the operation has no request body so callers can skip the
+ * line entirely rather than emitting `body: void`.
+ *
+ * Pure. Does not mutate the document.
+ */
+function describeEndpointRequestBodyShape(op, doc) {
+    if (op.requestBody === null)
+        return null;
+    return (0, renderJsonSchema_1.renderNamedSchema)(op.requestBody.typeName, doc);
+}
+//# sourceMappingURL=describeEndpointRequestBodyShape.js.map

package/lib/orchestrate/utils/describeEndpointRequestBodyShape.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"describeEndpointRequestBodyShape.js","sourceRoot":"","sources":["../../../src/orchestrate/utils/describeEndpointRequestBodyShape.ts"],"names":[],"mappings":";;AAwBA,4EAMC;AA3BD,yDAAuD;AAEvD;;;;;;;;;;;;;;;;;;GAkBG;AACH,SAAgB,gCAAgC,CAC9C,EAAqB,EACrB,GAAsB;IAEtB,IAAI,EAAE,CAAC,WAAW,KAAK,IAAI;QAAE,OAAO,IAAI,CAAC;IACzC,OAAO,IAAA,oCAAiB,EAAC,EAAE,CAAC,WAAW,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC;AACzD,CAAC"}

package/lib/orchestrate/utils/describeEndpointResponseShape.d.ts

@@ -0,0 +1,19 @@
+import { OpenApi } from "@typia/interface";
+import { IAutoViewEndpoint } from "../../utils";
+/**
+ * Render the response body type of a single AutoBE operation as a readable,
+ * multi-line TypeScript-shaped string. Used by the Render phase to spoon-feed
+ * the LLM the exact field names + nesting of every endpoint's return value —
+ * otherwise the model invents plausible-sounding properties (e.g. `auth.member`
+ * on `IAuthorized` when the real shape is `{ id, created_at, token }`), which
+ * then fails TypeScript when the user runs `npm run typecheck` against the
+ * generated frontend.
+ *
+ * Returns `void` when the operation has no response body, so callers can
+ * pass-through to `Promise<void>` in the rendered signature. Delegates the
+ * actual schema walk to {@link renderJsonSchema} so request and response
+ * descriptions stay shape-compatible.
+ *
+ * Pure. Does not mutate the document.
+ */
+export declare function describeEndpointResponseShape(op: IAutoViewEndpoint, doc: OpenApi.IDocument): string;