@autoview/cli 0.1.0

package/lib/orchestrate/utils/auditFrontendRuntime.js

@@ -0,0 +1,362 @@
+"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.auditFrontendRuntime = auditFrontendRuntime;
+const child_process_1 = require("child_process");
+const crypto_1 = require("crypto");
+const promises_1 = __importDefault(require("fs/promises"));
+const net_1 = require("net");
+const os_1 = __importDefault(require("os"));
+const path_1 = __importDefault(require("path"));
+const cacheNodeModules_1 = require("./cacheNodeModules");
+const PLAYWRIGHT_DEP = "playwright@^1.50.0";
+const NEXT_DEV_BOOT_TIMEOUT_MS = 90000;
+const PAGE_VISIT_TIMEOUT_MS = 20000;
+const PAGE_SETTLE_MS = 2500;
+/**
+ * Boot the assembled frontend under `next dev`, launch a headless Chromium via
+ * Playwright, visit every screen the product plan declared, and return the
+ * per-page console / pageerror / navigation diagnostics. Used by the
+ * orchestrator as Phase 6 (runtime audit) — the layer above `tsc --noEmit` that
+ * catches errors typecheck cannot see (`obj?.array.method(...)`
+ * undefined-access patterns, missing client-only guards, react render
+ * crashes).
+ *
+ * Operates in `NEXT_PUBLIC_API_SIMULATE=true` so the audit does not require a
+ * live backend — the SDK serves typia-random fixture data and pages exercise
+ * their real render paths. Live-backend variants can be added later by
+ * threading the host through.
+ *
+ * Throws on infrastructure failure (`npm install` crashed, port allocation
+ * failed, Chromium download blocked). Runtime errors on the pages themselves
+ * are returned as data; the whole point of this gate is to surface them.
+ */
+function auditFrontendRuntime(files, pages) {
+    return __awaiter(this, void 0, void 0, function* () {
+        const startedAt = Date.now();
+        const tempDir = yield promises_1.default.mkdtemp(path_1.default.join(os_1.default.tmpdir(), "autoview-runtime-audit-"));
+        let nextDev = null;
+        try {
+            yield writeFiles(tempDir, files);
+            const packageJson = files["package.json"];
+            const hash = packageJson !== undefined
+                ? (0, crypto_1.createHash)("sha256").update(packageJson).digest("hex").slice(0, 16)
+                : "no-package-json";
+            const cachedNodeModules = packageJson !== undefined
+                ? yield (0, cacheNodeModules_1.ensureCachedNodeModules)({
+                    cacheNamespace: "runtime-audit",
+                    hash,
+                    packageJson,
+                    extraDeps: [PLAYWRIGHT_DEP],
+                })
+                : null;
+            if (cachedNodeModules !== null) {
+                const linked = yield (0, cacheNodeModules_1.tryLinkNodeModules)(tempDir, cachedNodeModules);
+                if (!linked) {
+                    yield installDependencies(tempDir);
+                    yield installPlaywright(tempDir);
+                }
+            }
+            else {
+                yield installDependencies(tempDir);
+                yield installPlaywright(tempDir);
+            }
+            yield installChromium(tempDir);
+            const port = yield getFreePort();
+            nextDev = yield startNextDev(tempDir, port);
+            const baseUrl = `http://127.0.0.1:${port}`;
+            yield writeFile(tempDir, "scripts/.audit-runner.cjs", buildRunnerScript());
+            const stdout = yield spawnCommand("node", [
+                path_1.default.join(tempDir, "scripts", ".audit-runner.cjs"),
+                JSON.stringify(pages),
+                baseUrl,
+                String(PAGE_VISIT_TIMEOUT_MS),
+                String(PAGE_SETTLE_MS),
+            ], { cwd: tempDir });
+            const diagnostics = parseRunnerOutput(stdout);
+            const byPage = groupByPage(diagnostics);
+            return {
+                diagnostics,
+                byPage,
+                visited: [...pages],
+                markdown: renderMarkdownReport(diagnostics, byPage, pages),
+                elapsedMs: Date.now() - startedAt,
+            };
+        }
+        finally {
+            if (nextDev !== null)
+                yield killNextDev(nextDev);
+            yield promises_1.default.rm(tempDir, { recursive: true, force: true }).catch(() => { });
+        }
+    });
+}
+/* -------------------------------------------------------------------------- */
+/* fs                                                                          */
+/* -------------------------------------------------------------------------- */
+function writeFiles(root, files) {
+    return __awaiter(this, void 0, void 0, function* () {
+        for (const [relative, content] of Object.entries(files)) {
+            yield writeFile(root, relative, content);
+        }
+    });
+}
+function writeFile(root, relative, content) {
+    return __awaiter(this, void 0, void 0, function* () {
+        const full = path_1.default.join(root, relative);
+        yield promises_1.default.mkdir(path_1.default.dirname(full), { recursive: true });
+        yield promises_1.default.writeFile(full, content, "utf-8");
+    });
+}
+/* -------------------------------------------------------------------------- */
+/* install                                                                     */
+/* -------------------------------------------------------------------------- */
+function installDependencies(root) {
+    return __awaiter(this, void 0, void 0, function* () {
+        yield spawnCommand("npm", ["install", "--silent", "--no-audit", "--no-fund"], { cwd: root });
+    });
+}
+function installPlaywright(root) {
+    return __awaiter(this, void 0, void 0, function* () {
+        yield spawnCommand("npm", [
+            "install",
+            "--silent",
+            "--no-audit",
+            "--no-fund",
+            "--no-save",
+            "playwright@^1.50.0",
+        ], { cwd: root });
+    });
+}
+function installChromium(root) {
+    return __awaiter(this, void 0, void 0, function* () {
+        yield spawnCommand(path_1.default.join(root, "node_modules", ".bin", "playwright"), ["install", "chromium"], { cwd: root });
+    });
+}
+/* -------------------------------------------------------------------------- */
+/* next dev                                                                    */
+/* -------------------------------------------------------------------------- */
+function getFreePort() {
+    return new Promise((resolve, reject) => {
+        const server = (0, net_1.createServer)();
+        server.listen(0, "127.0.0.1", () => {
+            const addr = server.address();
+            if (addr === null || typeof addr === "string") {
+                server.close();
+                reject(new Error("Failed to allocate a free port"));
+                return;
+            }
+            const port = addr.port;
+            server.close(() => resolve(port));
+        });
+        server.on("error", reject);
+    });
+}
+function startNextDev(root, port) {
+    return new Promise((resolve, reject) => {
+        var _a, _b;
+        const child = (0, child_process_1.spawn)("node", [path_1.default.join(root, "node_modules", "next", "dist", "bin", "next"), "dev"], {
+            cwd: root,
+            env: Object.assign(Object.assign({}, process.env), { PORT: String(port), NEXT_PUBLIC_API_SIMULATE: "true", 
+                // Force literal Authorization header so the SDK does not crash
+                // when bootstrapAuth is a no-op in simulator mode.
+                NEXT_PUBLIC_API_TOKEN: "Bearer preview" }),
+            stdio: ["ignore", "pipe", "pipe"],
+        });
+        let buffer = "";
+        let settled = false;
+        const onData = (chunk) => {
+            var _a, _b;
+            buffer += chunk.toString("utf-8");
+            if (!settled && buffer.includes("Ready in")) {
+                settled = true;
+                (_a = child.stdout) === null || _a === void 0 ? void 0 : _a.off("data", onData);
+                (_b = child.stderr) === null || _b === void 0 ? void 0 : _b.off("data", onData);
+                resolve(child);
+            }
+        };
+        (_a = child.stdout) === null || _a === void 0 ? void 0 : _a.on("data", onData);
+        (_b = child.stderr) === null || _b === void 0 ? void 0 : _b.on("data", onData);
+        const timer = setTimeout(() => {
+            if (settled)
+                return;
+            settled = true;
+            child.kill("SIGTERM");
+            reject(new Error(`next dev did not become ready within ${NEXT_DEV_BOOT_TIMEOUT_MS}ms:\n${buffer.slice(-1000)}`));
+        }, NEXT_DEV_BOOT_TIMEOUT_MS);
+        child.on("exit", (code) => {
+            clearTimeout(timer);
+            if (settled)
+                return;
+            settled = true;
+            reject(new Error(`next dev exited with code ${code} before becoming ready:\n${buffer.slice(-1000)}`));
+        });
+    });
+}
+function killNextDev(child) {
+    return __awaiter(this, void 0, void 0, function* () {
+        if (child.exitCode !== null)
+            return;
+        child.kill("SIGTERM");
+        yield new Promise((r) => setTimeout(r, 1500));
+        if (child.exitCode === null)
+            child.kill("SIGKILL");
+    });
+}
+/* -------------------------------------------------------------------------- */
+/* runner script (executed inside the temp dir, requires installed playwright) */
+/* -------------------------------------------------------------------------- */
+function buildRunnerScript() {
+    // CommonJS so the temp dir does not need to be ESM-aware. Reads pages +
+    // baseUrl + timeouts from argv, emits a JSON array of `{ pagePath, type,
+    // message }` to stdout. Failures during navigation become `navigation`
+    // diagnostics so the caller never silently misses a broken page.
+    return `"use strict";
+const { chromium } = require("playwright");
+
+(async () => {
+  const pages = JSON.parse(process.argv[2]);
+  const baseUrl = process.argv[3];
+  const visitTimeout = parseInt(process.argv[4], 10);
+  const settleMs = parseInt(process.argv[5], 10);
+  const browser = await chromium.launch();
+  const context = await browser.newContext({
+    viewport: { width: 1280, height: 800 },
+  });
+  const diagnostics = [];
+  for (const pagePath of pages) {
+    const resolved = pagePath.replace(/\\[[^\\]]+\\]/g, "demo");
+    const url = baseUrl + (resolved.startsWith("/") ? resolved : "/" + resolved);
+    const page = await context.newPage();
+    const pageErrors = [];
+    page.on("console", (msg) => {
+      if (msg.type() === "error") {
+        pageErrors.push({ pagePath, type: "console", message: msg.text() });
+      }
+    });
+    page.on("pageerror", (err) => {
+      pageErrors.push({ pagePath, type: "pageerror", message: err.message });
+    });
+    try {
+      // \`domcontentloaded\` instead of \`networkidle\` because typia random
+      // simulator data keeps the SDK firing background requests indefinitely
+      // on data-heavy pages — \`networkidle\` then times out at 20s on a
+      // page that already rendered cleanly. DOMContentLoaded plus the
+      // explicit settle window catches the same render errors without
+      // mistaking simulator chatter for a broken page.
+      await page.goto(url, {
+        waitUntil: "domcontentloaded",
+        timeout: visitTimeout,
+      });
+      await page.waitForTimeout(settleMs);
+    } catch (err) {
+      const message = err && err.message ? err.message : String(err);
+      pageErrors.push({ pagePath, type: "navigation", message });
+    }
+    for (const d of pageErrors) diagnostics.push(d);
+    await page.close().catch(() => {});
+  }
+  await browser.close().catch(() => {});
+  process.stdout.write(JSON.stringify(diagnostics));
+})().catch((err) => {
+  process.stderr.write(err && err.stack ? err.stack : String(err));
+  process.exit(1);
+});
+`;
+}
+function parseRunnerOutput(stdout) {
+    const trimmed = stdout.trim();
+    if (trimmed.length === 0)
+        return [];
+    try {
+        const parsed = JSON.parse(trimmed);
+        if (!Array.isArray(parsed))
+            return [];
+        return parsed.filter((entry) => entry !== null &&
+            typeof entry === "object" &&
+            typeof entry.pagePath === "string" &&
+            typeof entry.message === "string" &&
+            entry.type !== undefined);
+    }
+    catch (_a) {
+        return [];
+    }
+}
+function groupByPage(diagnostics) {
+    const map = new Map();
+    for (const d of diagnostics) {
+        const bucket = map.get(d.pagePath);
+        if (bucket === undefined)
+            map.set(d.pagePath, [d]);
+        else
+            bucket.push(d);
+    }
+    return map;
+}
+function renderMarkdownReport(diagnostics, byPage, pages) {
+    if (diagnostics.length === 0) {
+        return [
+            "# Runtime audit",
+            "",
+            `Visited **${pages.length}** page(s) under \`next dev\` (simulator mode).`,
+            "No console errors, page errors, or navigation failures detected.",
+            "",
+        ].join("\n");
+    }
+    const head = [
+        "# Runtime audit",
+        "",
+        `Visited **${pages.length}** page(s) under \`next dev\` (simulator mode).`,
+        `Detected **${diagnostics.length}** diagnostic(s) across **${byPage.size}** page(s).`,
+        "",
+    ];
+    const sections = [...byPage.entries()]
+        .sort(([a], [b]) => a.localeCompare(b))
+        .map(([pagePath, items]) => {
+        const lines = items.map((d) => `- \`${d.type}\` — ${escape(d.message)}`);
+        return [`## \`${pagePath}\` (${items.length})`, "", ...lines, ""].join("\n");
+    });
+    return [...head, ...sections].join("\n");
+}
+function escape(message) {
+    return message.replace(/`/g, "\\`").replace(/\n+/g, " ").slice(0, 500);
+}
+/* -------------------------------------------------------------------------- */
+/* spawn                                                                       */
+/* -------------------------------------------------------------------------- */
+function spawnCommand(cmd, args, options) {
+    return new Promise((resolve, reject) => {
+        const child = (0, child_process_1.spawn)(cmd, args, { cwd: options.cwd, stdio: "pipe" });
+        let stdout = "";
+        let stderr = "";
+        child.stdout.on("data", (chunk) => {
+            stdout += chunk.toString("utf-8");
+        });
+        child.stderr.on("data", (chunk) => {
+            stderr += chunk.toString("utf-8");
+        });
+        child.on("error", (err) => {
+            reject(new Error(`Failed to spawn \`${cmd} ${args.join(" ")}\`: ${err.message}`));
+        });
+        child.on("close", (code) => {
+            if (code === 0) {
+                resolve(stdout);
+            }
+            else {
+                reject(new Error(`\`${cmd} ${args.slice(0, 3).join(" ")}...\` exited with code ${code}` +
+                    (stderr.length > 0 ? `:\n${stderr.slice(-1500)}` : "")));
+            }
+        });
+    });
+}
+//# sourceMappingURL=auditFrontendRuntime.js.map

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

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

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

@@ -0,0 +1,4 @@
+import { OpenApi } from "@typia/interface";
+import { IEndpointFilter } from "../../utils";
+import { IAutoViewProductPlan } from "../structures/IAutoViewProductPlan";
+export declare function buildDeterministicPlan(document: OpenApi.IDocument, actor: string, filter?: IEndpointFilter): IAutoViewProductPlan;

package/lib/orchestrate/utils/buildDeterministicPlan.js

@@ -0,0 +1,233 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildDeterministicPlan = buildDeterministicPlan;
+const utils_1 = require("../../utils");
+const renderResourcePage_1 = require("./renderResourcePage");
+/**
+ * Deterministic Product Plan — the LLM ProductPlan's replacement.
+ *
+ * The old Phase 2 asked an LLM to invent an information architecture from a
+ * commerce-baked prompt: non-reproducible, domain-locked, no CRUD completeness.
+ * This builds the exact same {@link IAutoViewProductPlan} shape the Scaffold /
+ * Render phases consume, but structurally — from {@link resourcePlan}. Same
+ * swagger always yields the same screens; every resource that exposes a
+ * capability gets its screen; nothing is invented.
+ *
+ * Actors are not modeled yet (the READ layer dropped `authorizationActor` when
+ * it went swagger-native), so every screen is assigned the single `actor`
+ * passed in. Multi-actor navigation is a follow-up that restores per-endpoint
+ * actor tagging.
+ */
+const UI_PATTERN = {
+    list: "table",
+    detail: "detail",
+    create: "form",
+    edit: "form",
+};
+/**
+ * A "top-level" screen earns a spot in the landing hub + primary nav: a list
+ * table, a catalog, or a singleton read (a bracket-less detail page like
+ * `/system`). Entity-detail / create / edit pages — which carry a `[param]` and
+ * are reached from a list — do not.
+ */
+function isTopLevel(screen) {
+    // A landing card is a TOP-LEVEL resource (chain depth 1). Depth ≥ 2 — a nested
+    // resource (`/sales/[saleId]/questions`) OR a param-less sub-view
+    // (`/sales/details`, `/channels/hierarchical`) — is reached from its parent,
+    // never the home hub. Using the structural depth, not a `[` heuristic, keeps
+    // bracket-less nested paths off the hub.
+    if (screen.depth !== undefined && screen.depth !== 1)
+        return false;
+    if (screen.path.includes("["))
+        return false;
+    return (screen.uiPattern === "table" ||
+        screen.uiPattern === "catalog" ||
+        screen.uiPattern === "detail");
+}
+/** Humanize a snake_case resource name for prose: `file_version_legal_holds`
+ *  → `file version legal holds`. Keeps it lower-case for mid-sentence use. */
+function humanizeResource(resource) {
+    return resource.replace(/_/g, " ").trim();
+}
+function purposeOf(screen) {
+    const name = humanizeResource(screen.resource);
+    switch (screen.kind) {
+        case "list":
+            return `Browse and search ${name}.`;
+        case "detail":
+            return `View one ${name} and act on it.`;
+        case "create":
+            return `Create a new ${name}.`;
+        case "edit":
+            return `Edit an existing ${name}.`;
+    }
+}
+function notesOf(screen) {
+    switch (screen.kind) {
+        case "list":
+            return screen.secondary.some((c) => c.role === "search")
+                ? "Includes search/filter; rows link to the detail screen."
+                : "Rows link to the detail screen.";
+        case "detail":
+            return "Surfaces update / delete / action endpoints as buttons.";
+        case "create":
+            return "Render a form from the request-body schema; submit creates.";
+        case "edit":
+            return "Render a form from the request-body schema, prefilled from detail.";
+    }
+}
+function accessorsOf(screen) {
+    return [
+        screen.primary.accessor.join("."),
+        ...screen.secondary.map((c) => c.endpoint.accessor.join(".")),
+    ].filter((a, i, arr) => a.length > 0 && arr.indexOf(a) === i);
+}
+function classifyListResponse(op, document) {
+    if (op === undefined || (op.responseBody === null && op.responseSchema === null))
+        return "void";
+    // Use the SAME collection detection the table renderer uses, so a response is
+    // classed browsable iff a real row collection (incl. resource-named / inline
+    // wrappers, DigitalOcean) can actually be rendered as a table.
+    if ((0, renderResourcePage_1.responseCollection)(op, document) !== null)
+        return "browsable";
+    return op.method.toLowerCase() === "get" ? "singleton-read" : "action";
+}
+function buildDeterministicPlan(document, actor, filter = {}) {
+    var _a, _b, _c;
+    const endpoints = (0, utils_1.filterEndpoints)((0, utils_1.toEndpoints)(document), filter);
+    const planned = (0, utils_1.resourcePlan)(endpoints, document);
+    const byAccessor = new Map(endpoints.map((e) => [e.accessor.join("."), e]));
+    const noiseOmissions = [];
+    const resourceScreens = [];
+    for (const s of planned) {
+        const screen = {
+            path: s.path,
+            title: s.title,
+            purpose: purposeOf(s),
+            actor,
+            endpoints: accessorsOf(s),
+            uiPattern: UI_PATTERN[s.kind],
+            notes: notesOf(s),
+            depth: s.depth,
+        };
+        // A table screen must have a browsable response, or it is noise. Downgrade
+        // singleton reads to detail views; omit voids and action verbs.
+        if (screen.uiPattern === "table") {
+            const op = byAccessor.get(s.primary.accessor.join("."));
+            const cls = classifyListResponse(op, document);
+            if (cls === "void" || cls === "action") {
+                noiseOmissions.push({
+                    target: `${(_a = op === null || op === void 0 ? void 0 : op.method.toUpperCase()) !== null && _a !== void 0 ? _a : "?"} ${(_b = op === null || op === void 0 ? void 0 : op.path) !== null && _b !== void 0 ? _b : s.path}`,
+                    reason: cls === "void"
+                        ? "No response body to display."
+                        : "Action endpoint (single object from a mutating verb) — not a browsable list.",
+                });
+                continue;
+            }
+            if (cls === "singleton-read") {
+                resourceScreens.push(Object.assign(Object.assign({}, screen), { uiPattern: "detail", purpose: `View ${humanizeResource(s.resource)}.`, notes: "Singleton read — one record, not a list." }));
+                continue;
+            }
+            // Browsable: a collection whose rows carry an image + a title reads far
+            // better as a catalog of cards than a dense table. Purely structural —
+            // the element schema decides, no domain keywords.
+            const collection = op ? (0, renderResourcePage_1.responseCollection)(op, document) : null;
+            if (collection !== null && (0, utils_1.isCatalogCollection)(collection.columns)) {
+                resourceScreens.push(Object.assign(Object.assign({}, screen), { uiPattern: "catalog", notes: "Image + title rows — rendered as a card catalog." }));
+                continue;
+            }
+        }
+        resourceScreens.push(screen);
+    }
+    // Drop write-only resources. A browse app shows data, so a resource that has
+    // no list / detail / search screen at all — only a create/update form or an
+    // RPC verb (OAuth2 `token`/`revoke`, a `metadata_query/execute_read`) — is
+    // pure nav noise: a lone form seated next to real resources in the primary
+    // nav. Omit it (auditably) so a large swagger's sidebar shows browsable
+    // resources, not every endpoint.
+    const resourceKeyOf = (p) => { var _a; return (_a = p.split("/").filter((s) => s.length > 0 && !s.startsWith("[")).at(0)) !== null && _a !== void 0 ? _a : p; };
+    const resourceHasRead = new Map();
+    for (const s of resourceScreens) {
+        const key = resourceKeyOf(s.path);
+        const isRead = s.uiPattern === "table" || s.uiPattern === "detail";
+        resourceHasRead.set(key, ((_c = resourceHasRead.get(key)) !== null && _c !== void 0 ? _c : false) || isRead);
+    }
+    const browsableScreens = resourceScreens
+        .filter((s) => resourceHasRead.get(resourceKeyOf(s.path)) === true)
+        // Alphabetical by path so a large swagger's sidebar is scannable (same
+        // resource's pages stay grouped: /x, /x/[id], /x/[id]/edit, /x/new).
+        .sort((a, b) => a.path.localeCompare(b.path));
+    for (const s of resourceScreens) {
+        if (resourceHasRead.get(resourceKeyOf(s.path)) === true)
+            continue;
+        for (const accessor of s.endpoints) {
+            const op = byAccessor.get(accessor);
+            noiseOmissions.push({
+                target: op ? `${op.method.toUpperCase()} ${op.path}` : s.path,
+                reason: "Write-only resource (no list/detail/search to browse) — omitted from the UI as nav noise.",
+            });
+        }
+    }
+    // Root landing hub. Without an explicit `/` screen the dev server shows the
+    // template's "not customized yet" placeholder; this links to each resource's
+    // list and fetches nothing of its own.
+    const home = {
+        path: "/",
+        title: "Home",
+        purpose: "Landing hub linking to each resource.",
+        actor,
+        endpoints: [],
+        uiPattern: "landing",
+        notes: "Links to each resource's list screen; no data fetch of its own.",
+    };
+    const screens = [home, ...browsableScreens];
+    // Single-actor navigation: home + every top-level screen leads the primary
+    // nav. "Top-level" = a list table or a singleton read (a bracket-less detail
+    // page like `/system`); entity-detail / create / edit pages (which carry a
+    // `[param]` or are reached from a list) go to secondary.
+    const topLevelPaths = browsableScreens
+        .filter((s) => isTopLevel(s))
+        .map((s) => s.path);
+    const secondary = browsableScreens
+        .filter((s) => !isTopLevel(s))
+        .map((s) => s.path);
+    const navigation = [
+        { actor, primary: ["/", ...topLevelPaths], secondary },
+    ];
+    // Operations the READ layer could not turn into a screen — surfaced as
+    // honest omissions instead of vanishing. Noise screens (auth/monitoring verbs)
+    // removed above are reported here too, so "omitted, not broken" stays auditable.
+    const intentionalOmissions = [
+        ...noiseOmissions,
+        ...(0, utils_1.unsupportedOperations)(document).map((u) => ({
+            target: `${u.method} ${u.path}`,
+            reason: `Unsupported content type — ${u.reason}`,
+        })),
+    ];
+    // Integrity backstop — "정확하게 읽는다" rule #1: nothing the READ layer parsed
+    // may silently vanish. Every operation must be referenced by some screen
+    // (primary or secondary) or appear in an omission. Anything left over (a
+    // second create on a resource that already had one, a deeply nested
+    // delete with no detail to host it, an auth verb that did not classify) is
+    // recorded here so coverage is total and auditable rather than lossy.
+    const referenced = new Set();
+    for (const s of browsableScreens)
+        for (const a of s.endpoints)
+            referenced.add(a);
+    const omittedPaths = new Set(intentionalOmissions.map((o) => o.target));
+    for (const e of endpoints) {
+        const accessor = e.accessor.join(".");
+        if (referenced.has(accessor))
+            continue;
+        const target = `${e.method.toUpperCase()} ${e.path}`;
+        if (omittedPaths.has(target))
+            continue;
+        intentionalOmissions.push({
+            target,
+            reason: `Not yet mapped to a screen (accessor ${accessor}) — a duplicate-role or deeply nested endpoint the deterministic plan does not surface yet.`,
+        });
+        omittedPaths.add(target);
+    }
+    return { screens, navigation, intentionalOmissions };
+}
+//# sourceMappingURL=buildDeterministicPlan.js.map

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

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

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

@@ -0,0 +1,22 @@
+import { OpenApi } from "@typia/interface";
+import { IAutoViewSdkMap } from "../structures/IAutoViewSdkMap";
+/**
+ * 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).
+ */
+export declare function buildDeterministicSdkMap(document: OpenApi.IDocument): IAutoViewSdkMap;