@autoview/cli 0.1.0

package/lib/index.js

@@ -0,0 +1,41 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.loadShoppingFixture = exports.auditFrontendRuntime = exports.validateFrontendTypecheck = exports.hashFrontendDependencies = exports.renderNamedSchema = exports.renderJsonSchema = exports.describeEndpointResponseShape = exports.describeEndpointRequestBodyShape = exports.describeRequestBodyHint = exports.describeEndpointPropsShape = exports.AutoViewFrontendTemplate = void 0;
+__exportStar(require("./AutoViewAgent"), exports);
+__exportStar(require("./context/IAutoViewAgentContext"), exports);
+__exportStar(require("./fromSwagger"), exports);
+__exportStar(require("./orchestrate/orchestrateAutoView"), exports);
+var AutoViewFrontendTemplate_1 = require("./constants/AutoViewFrontendTemplate");
+Object.defineProperty(exports, "AutoViewFrontendTemplate", { enumerable: true, get: function () { return AutoViewFrontendTemplate_1.AutoViewFrontendTemplate; } });
+var describeEndpointPropsShape_1 = require("./orchestrate/utils/describeEndpointPropsShape");
+Object.defineProperty(exports, "describeEndpointPropsShape", { enumerable: true, get: function () { return describeEndpointPropsShape_1.describeEndpointPropsShape; } });
+Object.defineProperty(exports, "describeRequestBodyHint", { enumerable: true, get: function () { return describeEndpointPropsShape_1.describeRequestBodyHint; } });
+var describeEndpointRequestBodyShape_1 = require("./orchestrate/utils/describeEndpointRequestBodyShape");
+Object.defineProperty(exports, "describeEndpointRequestBodyShape", { enumerable: true, get: function () { return describeEndpointRequestBodyShape_1.describeEndpointRequestBodyShape; } });
+var describeEndpointResponseShape_1 = require("./orchestrate/utils/describeEndpointResponseShape");
+Object.defineProperty(exports, "describeEndpointResponseShape", { enumerable: true, get: function () { return describeEndpointResponseShape_1.describeEndpointResponseShape; } });
+var renderJsonSchema_1 = require("./orchestrate/utils/renderJsonSchema");
+Object.defineProperty(exports, "renderJsonSchema", { enumerable: true, get: function () { return renderJsonSchema_1.renderJsonSchema; } });
+Object.defineProperty(exports, "renderNamedSchema", { enumerable: true, get: function () { return renderJsonSchema_1.renderNamedSchema; } });
+var validateFrontendTypecheck_1 = require("./orchestrate/utils/validateFrontendTypecheck");
+Object.defineProperty(exports, "hashFrontendDependencies", { enumerable: true, get: function () { return validateFrontendTypecheck_1.hashFrontendDependencies; } });
+Object.defineProperty(exports, "validateFrontendTypecheck", { enumerable: true, get: function () { return validateFrontendTypecheck_1.validateFrontendTypecheck; } });
+var auditFrontendRuntime_1 = require("./orchestrate/utils/auditFrontendRuntime");
+Object.defineProperty(exports, "auditFrontendRuntime", { enumerable: true, get: function () { return auditFrontendRuntime_1.auditFrontendRuntime; } });
+var loadShoppingFixture_1 = require("./orchestrate/utils/loadShoppingFixture");
+Object.defineProperty(exports, "loadShoppingFixture", { enumerable: true, get: function () { return loadShoppingFixture_1.loadShoppingFixture; } });
+//# sourceMappingURL=index.js.map

package/lib/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;AAAA,kDAAgC;AAChC,kEAAgD;AAChD,gDAA8B;AAC9B,oEAAkD;AAClD,iFAAgF;AAAvE,oIAAA,wBAAwB,OAAA;AACjC,6FAGwD;AAFtD,wIAAA,0BAA0B,OAAA;AAC1B,qIAAA,uBAAuB,OAAA;AAEzB,yGAAwG;AAA/F,oJAAA,gCAAgC,OAAA;AACzC,mGAAkG;AAAzF,8IAAA,6BAA6B,OAAA;AACtC,yEAG8C;AAF5C,oHAAA,gBAAgB,OAAA;AAChB,qHAAA,iBAAiB,OAAA;AAEnB,2FAGuD;AAFrD,qIAAA,wBAAwB,OAAA;AACxB,sIAAA,yBAAyB,OAAA;AAM3B,iFAAgF;AAAvE,4HAAA,oBAAoB,OAAA;AAK7B,+EAA8E;AAArE,0HAAA,mBAAmB,OAAA"}

package/lib/orchestrate/orchestrateAutoView.d.ts

@@ -0,0 +1,17 @@
+import { IAutoBeRunAutoViewOptions } from "../typings";
+import { IAutoViewAgentContext } from "../context/IAutoViewAgentContext";
+/**
+ * Top-level AutoView orchestrator.
+ *
+ * Walks through the five phases — SDK Study, Product Plan, Scaffold, Render,
+ * Review — emitting one event per phase plus per-page progress during Render.
+ * The final `autoViewComplete` event carries the assembled frontend project as
+ * a flat `path → content` map ready for Sandbox deploy.
+ *
+ * All five phases (SDK Study → Product Plan → Scaffold → Render → UI Review)
+ * are implemented. Visual screenshot capture is intentionally out of scope for
+ * the agent itself — the operator runs Playwright against the Sandbox deploy —
+ * but the Review phase still produces the `wiki/sdk-feedback.md` audit so the
+ * SDK-quality signal lands in the archive.
+ */
+export declare function orchestrateAutoView(ctx: IAutoViewAgentContext, options?: IAutoBeRunAutoViewOptions): Promise<void>;

package/lib/orchestrate/orchestrateAutoView.js

@@ -0,0 +1,491 @@
+"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());
+    });
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.orchestrateAutoView = orchestrateAutoView;
+const uuid_1 = require("uuid");
+const orchestrateAutoViewProductPlan_1 = require("./orchestrateAutoViewProductPlan");
+const orchestrateAutoViewRender_1 = require("./orchestrateAutoViewRender");
+const orchestrateAutoViewRenderDeterministic_1 = require("./orchestrateAutoViewRenderDeterministic");
+const orchestrateAutoViewReview_1 = require("./orchestrateAutoViewReview");
+const orchestrateAutoViewScaffold_1 = require("./orchestrateAutoViewScaffold");
+const orchestrateAutoViewSdkStudy_1 = require("./orchestrateAutoViewSdkStudy");
+const auditFrontendRuntime_1 = require("./utils/auditFrontendRuntime");
+const executeCachedBatch_1 = require("./utils/executeCachedBatch");
+const loadShoppingFixture_1 = require("./utils/loadShoppingFixture");
+const normalizeProductPlanPaths_1 = require("./utils/normalizeProductPlanPaths");
+const validateFrontendTypecheck_1 = require("./utils/validateFrontendTypecheck");
+const workflows_1 = require("../verify/workflows");
+const runWorkflows_1 = require("../verify/runWorkflows");
+const sliceDocument_1 = require("../utils/sliceDocument");
+/**
+ * Top-level AutoView orchestrator.
+ *
+ * Walks through the five phases — SDK Study, Product Plan, Scaffold, Render,
+ * Review — emitting one event per phase plus per-page progress during Render.
+ * The final `autoViewComplete` event carries the assembled frontend project as
+ * a flat `path → content` map ready for Sandbox deploy.
+ *
+ * All five phases (SDK Study → Product Plan → Scaffold → Render → UI Review)
+ * are implemented. Visual screenshot capture is intentionally out of scope for
+ * the agent itself — the operator runs Playwright against the Sandbox deploy —
+ * but the Review phase still produces the `wiki/sdk-feedback.md` audit so the
+ * SDK-quality signal lands in the archive.
+ */
+function orchestrateAutoView(ctx_1) {
+    return __awaiter(this, arguments, void 0, function* (ctx, options = {}) {
+        var _a, _b, _c;
+        const source = (_a = options.source) !== null && _a !== void 0 ? _a : "interface";
+        const designTheme = ((_b = options.designTheme) !== null && _b !== void 0 ? _b : "").trim();
+        const { document: fullDocument, step, reason, backend, } = resolveSource(ctx, source, {
+            backend: (_c = options.backend) !== null && _c !== void 0 ? _c : null,
+        });
+        // Apply `--include` / `--exclude` at the DOCUMENT level, not just the screen
+        // list: slicing the paths AND pruning component schemas to their transitive
+        // closure is what lets a large swagger (Box, Stripe) actually run — otherwise
+        // SDK Study compiles all ~180 schemas and overflows the model's context.
+        const document = (0, sliceDocument_1.sliceDocument)(fullDocument, {
+            include: options.include,
+            exclude: options.exclude,
+        });
+        const startedAt = Date.now();
+        ctx.dispatch({
+            type: "autoViewStart",
+            id: (0, uuid_1.v7)(),
+            created_at: new Date().toISOString(),
+            source,
+            step,
+            designTheme,
+            reason,
+        });
+        // Phase 1 — SDK Study.
+        const { map: sdkMap, markdown: sdkMapMarkdown } = yield (0, orchestrateAutoViewSdkStudy_1.orchestrateAutoViewSdkStudy)(ctx, { document, step });
+        // Phase 2 — Product Plan.
+        const { plan: rawProductPlan, markdown: productPlanMarkdown } = yield (0, orchestrateAutoViewProductPlan_1.orchestrateAutoViewProductPlan)(ctx, {
+            document,
+            sdkMap,
+            designTheme,
+            step,
+            filter: { include: options.include, exclude: options.exclude },
+        });
+        // Next.js refuses to start when sibling routes under the same parent
+        // disagree on the dynamic-segment name (e.g. `/sales/[id]` vs.
+        // `/sales/[saleId]`). The planner cannot always avoid that — run the
+        // plan through a deterministic normalizer before the scaffold step
+        // bakes the paths into the file tree.
+        const productPlan = (0, normalizeProductPlanPaths_1.normalizeProductPlanPaths)(rawProductPlan);
+        // Phase 3 — Scaffold (deterministic).
+        const scaffolded = yield (0, orchestrateAutoViewScaffold_1.orchestrateAutoViewScaffold)(ctx, {
+            document,
+            sdkMap,
+            sdkMapMarkdown,
+            productPlan,
+            productPlanMarkdown,
+            step,
+            backend,
+        });
+        // Phase 4 — Render (deterministic). Emits one thin `page.tsx` per screen
+        // that wires the typed SDK call to a universal `Resource*` component, with
+        // column / field metadata baked from the swagger schema. No LLM, no
+        // parser-retry roulette: every screen gets a page and every property of its
+        // row / response / request type becomes a column / row / input. The rendered
+        // pages overwrite the scaffold placeholders in place.
+        const render = yield (0, orchestrateAutoViewRenderDeterministic_1.orchestrateAutoViewRenderDeterministic)(ctx, {
+            document,
+            productPlan,
+            step,
+        });
+        for (const [key, value] of Object.entries(render.files)) {
+            scaffolded[key] = value;
+        }
+        // Phase 4.5 — deterministic `tsc --noEmit` against the assembled tree,
+        // plus a typecheck-driven retry pass for screens whose pages failed
+        // the gate. The per-screen parser check inside Render only catches
+        // grammar failures; type errors against the SDK (the model inventing
+        // properties on response types, wrong-casing fields, sending a second
+        // argument to a parameterless endpoint, etc.) escape every render
+        // attempt unless we actually compile the project the way the user
+        // will. Materializing into a temp dir + `npm install` + `tsc` is
+        // expensive (~30s on first run) but the typecheck session reuses the
+        // installed node_modules across retry rounds, so subsequent
+        // typecheck runs cost only the actual compile time.
+        const { typecheck, recovered } = yield runTypecheckPhase(ctx, {
+            scaffolded,
+            document,
+            sdkMap,
+            productPlan,
+            designTheme,
+        });
+        scaffolded["wiki/typecheck.md"] = typecheck.markdown;
+        // Phase 6 — runtime audit (opt-in). After typecheck closes the static
+        // gate, boot `next dev` against the assembled tree, walk every screen
+        // with a headless Chromium, capture console / pageerror / navigation
+        // diagnostics, and re-render broken pages with the live errors in the
+        // prompt. The retry pass closes the class of bugs `tsc --noEmit`
+        // cannot see — `obj?.array.method(...)` undefined-access patterns,
+        // react render crashes against simulator data, hydration mismatches.
+        // Skipped when `options.runtimeAudit !== true` because the gate
+        // installs Playwright + Chromium (~150MB) and boots `next dev` twice
+        // per run, adding ~10–20 minutes to the agent's wall clock.
+        let runtimeAudit = null;
+        let runtimeRecovered = 0;
+        if (options.runtimeAudit === true) {
+            const result = yield runRuntimeAuditPhase(ctx, {
+                scaffolded,
+                document,
+                sdkMap,
+                productPlan,
+                designTheme,
+            });
+            runtimeAudit = result.audit;
+            runtimeRecovered = result.recovered;
+            scaffolded["wiki/runtime-audit.md"] = runtimeAudit.markdown;
+        }
+        // Phase 7 — workflow verification (opt-in). Derive the user workflows from
+        // the plan and drive them in a real headless browser, asserting each step's
+        // positive outcome (data rendered, navigation moved). Writes
+        // `wiki/verification.md` — the evidence that the generated app actually works
+        // for a user, not just that it compiles. Skipped unless `options.verify`
+        // because it installs Chromium and boots `next dev`.
+        if (options.verify === true) {
+            try {
+                const workflows = (0, workflows_1.deriveWorkflows)(productPlan);
+                const verification = yield (0, runWorkflows_1.runWorkflows)(scaffolded, workflows);
+                scaffolded["wiki/verification.md"] = verification.markdown;
+            }
+            catch (err) {
+                const message = err instanceof Error ? err.message : String(err);
+                scaffolded["wiki/verification.md"] = [
+                    "# Workflow verification",
+                    "",
+                    "Verification could not run against the assembled project:",
+                    "",
+                    "```",
+                    message,
+                    "```",
+                ].join("\n");
+            }
+        }
+        // Phase 5 — UI Review. Code-and-spec audit; produces the
+        // operator-facing `wiki/sdk-feedback.md` document. Visual
+        // verification is left to the Sandbox deploy step.
+        const review = yield (0, orchestrateAutoViewReview_1.orchestrateAutoViewReview)(ctx, {
+            document,
+            sdkMap,
+            productPlan,
+            render,
+            typecheck,
+            recovered: recovered + runtimeRecovered,
+            step,
+        });
+        scaffolded["wiki/sdk-feedback.md"] = review.markdown;
+        ctx.dispatch({
+            type: "autoViewComplete",
+            id: (0, uuid_1.v7)(),
+            created_at: new Date().toISOString(),
+            step,
+            source,
+            elapsed: Date.now() - startedAt,
+            pages: productPlan.screens.length,
+            files: scaffolded,
+        });
+    });
+}
+function resolveSource(ctx, source, overrides) {
+    var _a, _b;
+    if (source === "shopping") {
+        // Stable reference SDK derived from `@samchon/shopping-api`. Lets
+        // the AutoView pipeline run end-to-end without waiting for the
+        // live AutoBE interface phase to complete, which is the whole
+        // reason the bundled fixture exists.
+        //
+        // Default the backend at `http://127.0.0.1:37001` instead of the
+        // swagger's `servers[0].url` (the public host is not reachable from
+        // most networks). The frontend pack ships
+        // `scripts/start-shopping-backend.sh`, which clones
+        // `samchon/shopping` and boots its NestJS server on that port — so
+        // the demo runs end-to-end against the real backend with seeded
+        // product data instead of typia-random gibberish.
+        const fixture = (0, loadShoppingFixture_1.loadShoppingFixture)();
+        return {
+            document: fixture.document,
+            step: 0,
+            reason: "User triggered AutoView against the bundled @samchon/shopping-api reference.",
+            backend: (_a = overrides.backend) !== null && _a !== void 0 ? _a : { host: "http://127.0.0.1:37001" },
+        };
+    }
+    const interfaceHistory = ctx.state().interface;
+    if (interfaceHistory === null) {
+        throw new Error("AutoView requires the interface phase to be complete first. " +
+            'Run with source: "shopping" to use the bundled reference instead.');
+    }
+    return {
+        document: interfaceHistory.document,
+        step: interfaceHistory.step,
+        reason: "User triggered AutoView against the AutoBE interface output.",
+        // Honor the caller's backend hint (CLI extracts it from swagger
+        // `servers[]`, or accepts a `--backend <url>` flag). When none was
+        // given the scaffold falls back to simulate-only mode — only useful
+        // for swaggers that genuinely have no backend (AutoBE's interface
+        // phase before the operator wires their own server).
+        backend: (_b = overrides.backend) !== null && _b !== void 0 ? _b : { host: null },
+    };
+}
+/**
+ * Maximum number of full typecheck+rerender rounds. Initial render counts as
+ * round 0, so this many additional rounds may follow it.
+ */
+const MAX_TYPECHECK_RETRY_ROUNDS = 2;
+/**
+ * Phase 4.5 in full: open a typecheck session against the assembled file map,
+ * iterate "typecheck → re-render broken screens → typecheck" up to
+ * {@link MAX_TYPECHECK_RETRY_ROUNDS} rounds, and return the final result. The
+ * scaffolded map is mutated in place — each successful re-render overwrites the
+ * broken file so the assembled output reflects the final state seen by the
+ * typecheck gate.
+ *
+ * Returns the last typecheck result + `recovered` count (screens that the loop
+ * fixed) so the Review event can report both honestly. On infra failure (npm
+ * install crash, etc.) returns a marker typecheck result and a recovered count
+ * of zero — the operator still gets the file map.
+ */
+function runTypecheckPhase(ctx, args) {
+    return __awaiter(this, void 0, void 0, function* () {
+        let session;
+        try {
+            session = yield validateFrontendTypecheck_1.FrontendTypecheckSession.open(args.scaffolded);
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : String(err);
+            return {
+                typecheck: {
+                    diagnostics: new Map(),
+                    totalErrors: 0,
+                    markdown: [
+                        "# Typecheck report",
+                        "",
+                        "`tsc --noEmit` could not be run against the assembled project:",
+                        "",
+                        "```",
+                        message,
+                        "```",
+                        "",
+                        "Re-run the project locally with `npm install && npm run typecheck` to validate.",
+                    ].join("\n"),
+                    elapsedMs: 0,
+                },
+                recovered: 0,
+            };
+        }
+        try {
+            let typecheck = yield session.typecheck();
+            let recovered = 0;
+            const allScreenPaths = args.productPlan.screens.map((s) => s.path);
+            const semaphoreCap = typeof ctx.vendor.semaphore === "number"
+                ? ctx.vendor.semaphore
+                : ctx.vendor.semaphore !== undefined
+                    ? ctx.vendor.semaphore.max()
+                    : 8;
+            for (let round = 0; round < MAX_TYPECHECK_RETRY_ROUNDS && typecheck.totalErrors > 0; round++) {
+                // Build the set of (screen, previousTsx, errors) tuples for every
+                // broken file that maps back to a known screen. Non-screen files
+                // (scaffold components, generated SDK, wiki) are not fixable by
+                // re-rendering a single screen — they are left to fail loudly.
+                const tasks = [];
+                for (const [filePath, diagnostics] of typecheck.diagnostics) {
+                    const screenPath = (0, orchestrateAutoViewRender_1.fileToScreenPath)(filePath);
+                    if (screenPath === null)
+                        continue;
+                    const screen = args.productPlan.screens.find((s) => s.path === screenPath);
+                    if (screen === undefined)
+                        continue;
+                    const previousTsx = args.scaffolded[filePath];
+                    if (previousTsx === undefined)
+                        continue;
+                    tasks.push({
+                        screen,
+                        filePath,
+                        previousTsx,
+                        errors: diagnostics.map((d) => ({
+                            line: d.line,
+                            column: d.column,
+                            code: d.code,
+                            message: d.message,
+                        })),
+                    });
+                }
+                if (tasks.length === 0)
+                    break;
+                const fixed = new Set();
+                yield (0, executeCachedBatch_1.executeCachedBatch)(semaphoreCap, tasks.map((task) => (promptCacheKey) => __awaiter(this, void 0, void 0, function* () {
+                    const result = yield (0, orchestrateAutoViewRender_1.rerenderScreenForTypecheck)(ctx, {
+                        screen: task.screen,
+                        document: args.document,
+                        sdkMap: args.sdkMap,
+                        designTheme: args.designTheme,
+                        promptCacheKey,
+                        allScreenPaths,
+                        previousTsx: task.previousTsx,
+                        typecheckErrors: task.errors,
+                    });
+                    if (result === null || !result.ok)
+                        return;
+                    args.scaffolded[task.filePath] = result.tsx;
+                    yield session.writeFile(task.filePath, result.tsx);
+                    fixed.add(task.filePath);
+                })));
+                if (fixed.size === 0)
+                    break;
+                const next = yield session.typecheck();
+                const errorsBefore = new Set(typecheck.diagnostics.keys());
+                const errorsAfter = new Set(next.diagnostics.keys());
+                for (const filePath of fixed) {
+                    if (errorsBefore.has(filePath) && !errorsAfter.has(filePath)) {
+                        recovered++;
+                    }
+                }
+                typecheck = next;
+            }
+            return { typecheck, recovered };
+        }
+        finally {
+            yield session.dispose();
+        }
+    });
+}
+/**
+ * Phase 6 in full: open a runtime audit session (npm install + playwright +
+ * chromium + `next dev`), capture per-page console / pageerror / navigation
+ * diagnostics, re-render the broken pages with the diagnostics in the prompt,
+ * and audit one more time. The orchestrator mutates `scaffolded` in place so
+ * the next phase sees the corrected output.
+ *
+ * Returns the final audit + `recovered` count (pages that the loop fixed) so
+ * the Review event can report runtime quality alongside the typecheck quality.
+ * On infra failure (Playwright install crashed, next dev never became ready,
+ * Chromium download blocked) returns a marker audit body and a recovered count
+ * of zero — the operator still gets the file map.
+ */
+function runRuntimeAuditPhase(ctx, args) {
+    return __awaiter(this, void 0, void 0, function* () {
+        const pages = args.productPlan.screens.map((s) => s.path);
+        let firstAudit;
+        try {
+            firstAudit = yield (0, auditFrontendRuntime_1.auditFrontendRuntime)(args.scaffolded, pages);
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : String(err);
+            return {
+                audit: {
+                    diagnostics: [],
+                    byPage: new Map(),
+                    visited: pages,
+                    markdown: [
+                        "# Runtime audit",
+                        "",
+                        "Playwright runtime audit could not be run against the assembled project:",
+                        "",
+                        "```",
+                        message,
+                        "```",
+                        "",
+                        "Re-run the project locally with `npm install && npm run dev` and visit pages by hand to validate.",
+                    ].join("\n"),
+                    elapsedMs: 0,
+                },
+                recovered: 0,
+            };
+        }
+        if (firstAudit.byPage.size === 0) {
+            return { audit: firstAudit, recovered: 0 };
+        }
+        const tasks = [];
+        for (const [pagePath, diagnostics] of firstAudit.byPage) {
+            const screen = args.productPlan.screens.find((s) => s.path === pagePath);
+            if (screen === undefined)
+                continue;
+            const filePath = (0, orchestrateAutoViewRender_1.screenPathToFile)(screen.path);
+            const previousTsx = args.scaffolded[filePath];
+            if (previousTsx === undefined)
+                continue;
+            tasks.push({
+                screen,
+                filePath,
+                previousTsx,
+                runtimeErrors: diagnostics.map((d) => ({
+                    type: d.type,
+                    message: d.message,
+                })),
+            });
+        }
+        if (tasks.length === 0)
+            return { audit: firstAudit, recovered: 0 };
+        const allScreenPaths = args.productPlan.screens.map((s) => s.path);
+        const semaphoreCap = typeof ctx.vendor.semaphore === "number"
+            ? ctx.vendor.semaphore
+            : ctx.vendor.semaphore !== undefined
+                ? ctx.vendor.semaphore.max()
+                : 8;
+        const fixed = new Set();
+        yield (0, executeCachedBatch_1.executeCachedBatch)(semaphoreCap, tasks.map((task) => (promptCacheKey) => __awaiter(this, void 0, void 0, function* () {
+            const result = yield (0, orchestrateAutoViewRender_1.rerenderScreenForRuntime)(ctx, {
+                screen: task.screen,
+                document: args.document,
+                sdkMap: args.sdkMap,
+                designTheme: args.designTheme,
+                promptCacheKey,
+                allScreenPaths,
+                previousTsx: task.previousTsx,
+                runtimeErrors: task.runtimeErrors,
+            });
+            if (result === null || !result.ok)
+                return;
+            args.scaffolded[task.filePath] = result.tsx;
+            fixed.add(task.screen.path);
+        })));
+        if (fixed.size === 0)
+            return { audit: firstAudit, recovered: 0 };
+        // Re-audit to measure recovery. Only one retry round to keep the gate
+        // bounded; further rounds rarely help once a page survived the prompt
+        // rewrite with the diagnostics in hand.
+        let secondAudit;
+        try {
+            secondAudit = yield (0, auditFrontendRuntime_1.auditFrontendRuntime)(args.scaffolded, pages);
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : String(err);
+            secondAudit = {
+                diagnostics: [],
+                byPage: new Map(),
+                visited: pages,
+                markdown: [
+                    "# Runtime audit (post-retry)",
+                    "",
+                    "Second-round Playwright audit could not be run:",
+                    "",
+                    "```",
+                    message,
+                    "```",
+                    "",
+                    "First-round results above are the last known runtime state.",
+                ].join("\n"),
+                elapsedMs: 0,
+            };
+        }
+        let recovered = 0;
+        for (const pagePath of fixed) {
+            if (firstAudit.byPage.has(pagePath) && !secondAudit.byPage.has(pagePath)) {
+                recovered++;
+            }
+        }
+        return { audit: secondAudit, recovered };
+    });
+}
+//# sourceMappingURL=orchestrateAutoView.js.map

package/lib/orchestrate/orchestrateAutoView.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"orchestrateAutoView.js","sourceRoot":"","sources":["../../src/orchestrate/orchestrateAutoView.ts"],"names":[],"mappings":";;;;;;;;;;;AAiDA,kDA8KC;AAzND,+BAA0B;AAG1B,qFAAkF;AAClF,2EAKqC;AACrC,qGAAkG;AAClG,2EAAwE;AACxE,+EAA4E;AAC5E,+EAA4E;AAC5E,uEAGsC;AACtC,mEAAgE;AAChE,qEAAkE;AAClE,iFAA8E;AAC9E,iFAG2C;AAC3C,mDAAsD;AACtD,yDAAsD;AACtD,0DAAuD;AAEvD;;;;;;;;;;;;;GAaG;AACH,SAAsB,mBAAmB;yDACvC,GAA0B,EAC1B,UAAqC,EAAE;;QAEvC,MAAM,MAAM,GAAG,MAAA,OAAO,CAAC,MAAM,mCAAI,WAAW,CAAC;QAC7C,MAAM,WAAW,GAAG,CAAC,MAAA,OAAO,CAAC,WAAW,mCAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;QACvD,MAAM,EACJ,QAAQ,EAAE,YAAY,EACtB,IAAI,EACJ,MAAM,EACN,OAAO,GACR,GAAG,aAAa,CAAC,GAAG,EAAE,MAAM,EAAE;YAC7B,OAAO,EAAE,MAAA,OAAO,CAAC,OAAO,mCAAI,IAAI;SACjC,CAAC,CAAC;QACH,6EAA6E;QAC7E,4EAA4E;QAC5E,8EAA8E;QAC9E,yEAAyE;QACzE,MAAM,QAAQ,GAAG,IAAA,6BAAa,EAAC,YAAY,EAAE;YAC3C,OAAO,EAAE,OAAO,CAAC,OAAO;YACxB,OAAO,EAAE,OAAO,CAAC,OAAO;SACzB,CAAC,CAAC;QACH,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QAE7B,GAAG,CAAC,QAAQ,CAAC;YACX,IAAI,EAAE,eAAe;YACrB,EAAE,EAAE,IAAA,SAAE,GAAE;YACR,UAAU,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;YACpC,MAAM;YACN,IAAI;YACJ,WAAW;YACX,MAAM;SAC4B,CAAC,CAAC;QAEtC,uBAAuB;QACvB,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,cAAc,EAAE,GAC7C,MAAM,IAAA,yDAA2B,EAAC,GAAG,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC;QAE7D,0BAA0B;QAC1B,MAAM,EAAE,IAAI,EAAE,cAAc,EAAE,QAAQ,EAAE,mBAAmB,EAAE,GAC3D,MAAM,IAAA,+DAA8B,EAAC,GAAG,EAAE;YACxC,QAAQ;YACR,MAAM;YACN,WAAW;YACX,IAAI;YACJ,MAAM,EAAE,EAAE,OAAO,EAAE,OAAO,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,CAAC,OAAO,EAAE;SAC/D,CAAC,CAAC;QACL,qEAAqE;QACrE,+DAA+D;QAC/D,qEAAqE;QACrE,mEAAmE;QACnE,sCAAsC;QACtC,MAAM,WAAW,GAAG,IAAA,qDAAyB,EAAC,cAAc,CAAC,CAAC;QAE9D,sCAAsC;QACtC,MAAM,UAAU,GAAG,MAAM,IAAA,yDAA2B,EAAC,GAAG,EAAE;YACxD,QAAQ;YACR,MAAM;YACN,cAAc;YACd,WAAW;YACX,mBAAmB;YACnB,IAAI;YACJ,OAAO;SACR,CAAC,CAAC;QAEH,yEAAyE;QACzE,2EAA2E;QAC3E,oEAAoE;QACpE,4EAA4E;QAC5E,6EAA6E;QAC7E,sDAAsD;QACtD,MAAM,MAAM,GAAG,MAAM,IAAA,+EAAsC,EAAC,GAAG,EAAE;YAC/D,QAAQ;YACR,WAAW;YACX,IAAI;SACL,CAAC,CAAC;QACH,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC;YACxD,UAAU,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;QAC1B,CAAC;QAED,uEAAuE;QACvE,oEAAoE;QACpE,mEAAmE;QACnE,qEAAqE;QACrE,sEAAsE;QACtE,kEAAkE;QAClE,kEAAkE;QAClE,iEAAiE;QACjE,qEAAqE;QACrE,4DAA4D;QAC5D,oDAAoD;QACpD,MAAM,EAAE,SAAS,EAAE,SAAS,EAAE,GAAG,MAAM,iBAAiB,CAAC,GAAG,EAAE;YAC5D,UAAU;YACV,QAAQ;YACR,MAAM;YACN,WAAW;YACX,WAAW;SACZ,CAAC,CAAC;QACH,UAAU,CAAC,mBAAmB,CAAC,GAAG,SAAS,CAAC,QAAQ,CAAC;QAErD,sEAAsE;QACtE,sEAAsE;QACtE,qEAAqE;QACrE,sEAAsE;QACtE,iEAAiE;QACjE,mEAAmE;QACnE,qEAAqE;QACrE,gEAAgE;QAChE,qEAAqE;QACrE,4DAA4D;QAC5D,IAAI,YAAY,GAAuC,IAAI,CAAC;QAC5D,IAAI,gBAAgB,GAAG,CAAC,CAAC;QACzB,IAAI,OAAO,CAAC,YAAY,KAAK,IAAI,EAAE,CAAC;YAClC,MAAM,MAAM,GAAG,MAAM,oBAAoB,CAAC,GAAG,EAAE;gBAC7C,UAAU;gBACV,QAAQ;gBACR,MAAM;gBACN,WAAW;gBACX,WAAW;aACZ,CAAC,CAAC;YACH,YAAY,GAAG,MAAM,CAAC,KAAK,CAAC;YAC5B,gBAAgB,GAAG,MAAM,CAAC,SAAS,CAAC;YACpC,UAAU,CAAC,uBAAuB,CAAC,GAAG,YAAY,CAAC,QAAQ,CAAC;QAC9D,CAAC;QAED,2EAA2E;QAC3E,4EAA4E;QAC5E,6DAA6D;QAC7D,8EAA8E;QAC9E,yEAAyE;QACzE,qDAAqD;QACrD,IAAI,OAAO,CAAC,MAAM,KAAK,IAAI,EAAE,CAAC;YAC5B,IAAI,CAAC;gBACH,MAAM,SAAS,GAAG,IAAA,2BAAe,EAAC,WAAW,CAAC,CAAC;gBAC/C,MAAM,YAAY,GAAG,MAAM,IAAA,2BAAY,EAAC,UAAU,EAAE,SAAS,CAAC,CAAC;gBAC/D,UAAU,CAAC,sBAAsB,CAAC,GAAG,YAAY,CAAC,QAAQ,CAAC;YAC7D,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,MAAM,OAAO,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;gBACjE,UAAU,CAAC,sBAAsB,CAAC,GAAG;oBACnC,yBAAyB;oBACzB,EAAE;oBACF,2DAA2D;oBAC3D,EAAE;oBACF,KAAK;oBACL,OAAO;oBACP,KAAK;iBACN,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACf,CAAC;QACH,CAAC;QAED,yDAAyD;QACzD,0DAA0D;QAC1D,mDAAmD;QACnD,MAAM,MAAM,GAAG,MAAM,IAAA,qDAAyB,EAAC,GAAG,EAAE;YAClD,QAAQ;YACR,MAAM;YACN,WAAW;YACX,MAAM;YACN,SAAS;YACT,SAAS,EAAE,SAAS,GAAG,gBAAgB;YACvC,IAAI;SACL,CAAC,CAAC;QACH,UAAU,CAAC,sBAAsB,CAAC,GAAG,MAAM,CAAC,QAAQ,CAAC;QAErD,GAAG,CAAC,QAAQ,CAAC;YACX,IAAI,EAAE,kBAAkB;YACxB,EAAE,EAAE,IAAA,SAAE,GAAE;YACR,UAAU,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;YACpC,IAAI;YACJ,MAAM;YACN,OAAO,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS;YAC/B,KAAK,EAAE,WAAW,CAAC,OAAO,CAAC,MAAM;YACjC,KAAK,EAAE,UAAU;SACoB,CAAC,CAAC;IAC3C,CAAC;CAAA;AAeD,SAAS,aAAa,CACpB,GAA0B,EAC1B,MAAgC,EAChC,SAA+C;;IAE/C,IAAI,MAAM,KAAK,UAAU,EAAE,CAAC;QAC1B,kEAAkE;QAClE,+DAA+D;QAC/D,8DAA8D;QAC9D,qCAAqC;QACrC,EAAE;QACF,iEAAiE;QACjE,oEAAoE;QACpE,0CAA0C;QAC1C,oDAAoD;QACpD,mEAAmE;QACnE,gEAAgE;QAChE,kDAAkD;QAClD,MAAM,OAAO,GAAG,IAAA,yCAAmB,GAAE,CAAC;QACtC,OAAO;YACL,QAAQ,EAAE,OAAO,CAAC,QAAQ;YAC1B,IAAI,EAAE,CAAC;YACP,MAAM,EACJ,8EAA8E;YAChF,OAAO,EAAE,MAAA,SAAS,CAAC,OAAO,mCAAI,EAAE,IAAI,EAAE,wBAAwB,EAAE;SACjE,CAAC;IACJ,CAAC;IACD,MAAM,gBAAgB,GAAG,GAAG,CAAC,KAAK,EAAE,CAAC,SAAS,CAAC;IAC/C,IAAI,gBAAgB,KAAK,IAAI,EAAE,CAAC;QAC9B,MAAM,IAAI,KAAK,CACb,8DAA8D;YAC5D,mEAAmE,CACtE,CAAC;IACJ,CAAC;IACD,OAAO;QACL,QAAQ,EAAE,gBAAgB,CAAC,QAAQ;QACnC,IAAI,EAAE,gBAAgB,CAAC,IAAI;QAC3B,MAAM,EAAE,8DAA8D;QACtE,gEAAgE;QAChE,mEAAmE;QACnE,oEAAoE;QACpE,kEAAkE;QAClE,qDAAqD;QACrD,OAAO,EAAE,MAAA,SAAS,CAAC,OAAO,mCAAI,EAAE,IAAI,EAAE,IAAI,EAAE;KAC7C,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,MAAM,0BAA0B,GAAG,CAAC,CAAC;AAErC;;;;;;;;;;;;GAYG;AACH,SAAe,iBAAiB,CAC9B,GAA0B,EAC1B,IAUC;;QAKD,IAAI,OAAiC,CAAC;QACtC,IAAI,CAAC;YACH,OAAO,GAAG,MAAM,oDAAwB,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QACjE,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,OAAO,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YACjE,OAAO;gBACL,SAAS,EAAE;oBACT,WAAW,EAAE,IAAI,GAAG,EAAE;oBACtB,WAAW,EAAE,CAAC;oBACd,QAAQ,EAAE;wBACR,oBAAoB;wBACpB,EAAE;wBACF,gEAAgE;wBAChE,EAAE;wBACF,KAAK;wBACL,OAAO;wBACP,KAAK;wBACL,EAAE;wBACF,iFAAiF;qBAClF,CAAC,IAAI,CAAC,IAAI,CAAC;oBACZ,SAAS,EAAE,CAAC;iBACb;gBACD,SAAS,EAAE,CAAC;aACb,CAAC;QACJ,CAAC;QAED,IAAI,CAAC;YACH,IAAI,SAAS,GAAG,MAAM,OAAO,CAAC,SAAS,EAAE,CAAC;YAC1C,IAAI,SAAS,GAAG,CAAC,CAAC;YAClB,MAAM,cAAc,GAAG,IAAI,CAAC,WAAW,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;YACnE,MAAM,YAAY,GAChB,OAAO,GAAG,CAAC,MAAM,CAAC,SAAS,KAAK,QAAQ;gBACtC,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,SAAS;gBACtB,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,SAAS,KAAK,SAAS;oBAClC,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,SAAS,CAAC,GAAG,EAAE;oBAC5B,CAAC,CAAC,CAAC,CAAC;YAEV,KACE,IAAI,KAAK,GAAG,CAAC,EACb,KAAK,GAAG,0BAA0B,IAAI,SAAS,CAAC,WAAW,GAAG,CAAC,EAC/D,KAAK,EAAE,EACP,CAAC;gBACD,kEAAkE;gBAClE,iEAAiE;gBACjE,gEAAgE;gBAChE,+DAA+D;gBAC/D,MAAM,KAAK,GAUL,EAAE,CAAC;gBACT,KAAK,MAAM,CAAC,QAAQ,EAAE,WAAW,CAAC,IAAI,SAAS,CAAC,WAAW,EAAE,CAAC;oBAC5D,MAAM,UAAU,GAAG,IAAA,4CAAgB,EAAC,QAAQ,CAAC,CAAC;oBAC9C,IAAI,UAAU,KAAK,IAAI;wBAAE,SAAS;oBAClC,MAAM,MAAM,GAAG,IAAI,CAAC,WAAW,CAAC,OAAO,CAAC,IAAI,CAC1C,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,UAAU,CAC7B,CAAC;oBACF,IAAI,MAAM,KAAK,SAAS;wBAAE,SAAS;oBACnC,MAAM,WAAW,GAAG,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC;oBAC9C,IAAI,WAAW,KAAK,SAAS;wBAAE,SAAS;oBACxC,KAAK,CAAC,IAAI,CAAC;wBACT,MAAM;wBACN,QAAQ;wBACR,WAAW;wBACX,MAAM,EAAE,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;4BAC9B,IAAI,EAAE,CAAC,CAAC,IAAI;4BACZ,MAAM,EAAE,CAAC,CAAC,MAAM;4BAChB,IAAI,EAAE,CAAC,CAAC,IAAI;4BACZ,OAAO,EAAE,CAAC,CAAC,OAAO;yBACnB,CAAC,CAAC;qBACJ,CAAC,CAAC;gBACL,CAAC;gBACD,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;oBAAE,MAAM;gBAE9B,MAAM,KAAK,GAAG,IAAI,GAAG,EAAU,CAAC;gBAChC,MAAM,IAAA,uCAAkB,EACtB,YAAY,EACZ,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAO,cAAc,EAAE,EAAE;oBAC3C,MAAM,MAAM,GAAG,MAAM,IAAA,sDAA0B,EAAC,GAAG,EAAE;wBACnD,MAAM,EAAE,IAAI,CAAC,MAAM;wBACnB,QAAQ,EAAE,IAAI,CAAC,QAAQ;wBACvB,MAAM,EAAE,IAAI,CAAC,MAAM;wBACnB,WAAW,EAAE,IAAI,CAAC,WAAW;wBAC7B,cAAc;wBACd,cAAc;wBACd,WAAW,EAAE,IAAI,CAAC,WAAW;wBAC7B,eAAe,EAAE,IAAI,CAAC,MAAM;qBAC7B,CAAC,CAAC;oBACH,IAAI,MAAM,KAAK,IAAI,IAAI,CAAC,MAAM,CAAC,EAAE;wBAAE,OAAO;oBAC1C,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,MAAM,CAAC,GAAG,CAAC;oBAC5C,MAAM,OAAO,CAAC,SAAS,CAAC,IAAI,CAAC,QAAQ,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC;oBACnD,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;gBAC3B,CAAC,CAAA,CAAC,CACH,CAAC;gBAEF,IAAI,KAAK,CAAC,IAAI,KAAK,CAAC;oBAAE,MAAM;gBAC5B,MAAM,IAAI,GAAG,MAAM,OAAO,CAAC,SAAS,EAAE,CAAC;gBACvC,MAAM,YAAY,GAAG,IAAI,GAAG,CAAC,SAAS,CAAC,WAAW,CAAC,IAAI,EAAE,CAAC,CAAC;gBAC3D,MAAM,WAAW,GAAG,IAAI,GAAG,CAAC,IAAI,CAAC,WAAW,CAAC,IAAI,EAAE,CAAC,CAAC;gBACrD,KAAK,MAAM,QAAQ,IAAI,KAAK,EAAE,CAAC;oBAC7B,IAAI,YAAY,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAC;wBAC7D,SAAS,EAAE,CAAC;oBACd,CAAC;gBACH,CAAC;gBACD,SAAS,GAAG,IAAI,CAAC;YACnB,CAAC;YAED,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,CAAC;QAClC,CAAC;gBAAS,CAAC;YACT,MAAM,OAAO,CAAC,OAAO,EAAE,CAAC;QAC1B,CAAC;IACH,CAAC;CAAA;AAED;;;;;;;;;;;;GAYG;AACH,SAAe,oBAAoB,CACjC,GAA0B,EAC1B,IAQC;;QAED,MAAM,KAAK,GAAG,IAAI,CAAC,WAAW,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;QAC1D,IAAI,UAAuC,CAAC;QAC5C,IAAI,CAAC;YACH,UAAU,GAAG,MAAM,IAAA,2CAAoB,EAAC,IAAI,CAAC,UAAU,EAAE,KAAK,CAAC,CAAC;QAClE,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,OAAO,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YACjE,OAAO;gBACL,KAAK,EAAE;oBACL,WAAW,EAAE,EAAE;oBACf,MAAM,EAAE,IAAI,GAAG,EAAE;oBACjB,OAAO,EAAE,KAAK;oBACd,QAAQ,EAAE;wBACR,iBAAiB;wBACjB,EAAE;wBACF,0EAA0E;wBAC1E,EAAE;wBACF,KAAK;wBACL,OAAO;wBACP,KAAK;wBACL,EAAE;wBACF,mGAAmG;qBACpG,CAAC,IAAI,CAAC,IAAI,CAAC;oBACZ,SAAS,EAAE,CAAC;iBACb;gBACD,SAAS,EAAE,CAAC;aACb,CAAC;QACJ,CAAC;QACD,IAAI,UAAU,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,EAAE,CAAC;YACjC,OAAO,EAAE,KAAK,EAAE,UAAU,EAAE,SAAS,EAAE,CAAC,EAAE,CAAC;QAC7C,CAAC;QAcD,MAAM,KAAK,GAAmB,EAAE,CAAC;QACjC,KAAK,MAAM,CAAC,QAAQ,EAAE,WAAW,CAAC,IAAI,UAAU,CAAC,MAAM,EAAE,CAAC;YACxD,MAAM,MAAM,GAAG,IAAI,CAAC,WAAW,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC;YACzE,IAAI,MAAM,KAAK,SAAS;gBAAE,SAAS;YACnC,MAAM,QAAQ,GAAG,IAAA,4CAAgB,EAAC,MAAM,CAAC,IAAI,CAAC,CAAC;YAC/C,MAAM,WAAW,GAAG,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC;YAC9C,IAAI,WAAW,KAAK,SAAS;gBAAE,SAAS;YACxC,KAAK,CAAC,IAAI,CAAC;gBACT,MAAM;gBACN,QAAQ;gBACR,WAAW;gBACX,aAAa,EAAE,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;oBACrC,IAAI,EAAE,CAAC,CAAC,IAAI;oBACZ,OAAO,EAAE,CAAC,CAAC,OAAO;iBACnB,CAAC,CAAC;aACJ,CAAC,CAAC;QACL,CAAC;QACD,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,EAAE,KAAK,EAAE,UAAU,EAAE,SAAS,EAAE,CAAC,EAAE,CAAC;QAEnE,MAAM,cAAc,GAAG,IAAI,CAAC,WAAW,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;QACnE,MAAM,YAAY,GAChB,OAAO,GAAG,CAAC,MAAM,CAAC,SAAS,KAAK,QAAQ;YACtC,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,SAAS;YACtB,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,SAAS,KAAK,SAAS;gBAClC,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,SAAS,CAAC,GAAG,EAAE;gBAC5B,CAAC,CAAC,CAAC,CAAC;QAEV,MAAM,KAAK,GAAG,IAAI,GAAG,EAAU,CAAC;QAChC,MAAM,IAAA,uCAAkB,EACtB,YAAY,EACZ,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAO,cAAc,EAAE,EAAE;YAC3C,MAAM,MAAM,GAAG,MAAM,IAAA,oDAAwB,EAAC,GAAG,EAAE;gBACjD,MAAM,EAAE,IAAI,CAAC,MAAM;gBACnB,QAAQ,EAAE,IAAI,CAAC,QAAQ;gBACvB,MAAM,EAAE,IAAI,CAAC,MAAM;gBACnB,WAAW,EAAE,IAAI,CAAC,WAAW;gBAC7B,cAAc;gBACd,cAAc;gBACd,WAAW,EAAE,IAAI,CAAC,WAAW;gBAC7B,aAAa,EAAE,IAAI,CAAC,aAAa;aAClC,CAAC,CAAC;YACH,IAAI,MAAM,KAAK,IAAI,IAAI,CAAC,MAAM,CAAC,EAAE;gBAAE,OAAO;YAC1C,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,MAAM,CAAC,GAAG,CAAC;YAC5C,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QAC9B,CAAC,CAAA,CAAC,CACH,CAAC;QACF,IAAI,KAAK,CAAC,IAAI,KAAK,CAAC;YAAE,OAAO,EAAE,KAAK,EAAE,UAAU,EAAE,SAAS,EAAE,CAAC,EAAE,CAAC;QAEjE,sEAAsE;QACtE,sEAAsE;QACtE,wCAAwC;QACxC,IAAI,WAAwC,CAAC;QAC7C,IAAI,CAAC;YACH,WAAW,GAAG,MAAM,IAAA,2CAAoB,EAAC,IAAI,CAAC,UAAU,EAAE,KAAK,CAAC,CAAC;QACnE,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,OAAO,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YACjE,WAAW,GAAG;gBACZ,WAAW,EAAE,EAAE;gBACf,MAAM,EAAE,IAAI,GAAG,EAAE;gBACjB,OAAO,EAAE,KAAK;gBACd,QAAQ,EAAE;oBACR,8BAA8B;oBAC9B,EAAE;oBACF,iDAAiD;oBACjD,EAAE;oBACF,KAAK;oBACL,OAAO;oBACP,KAAK;oBACL,EAAE;oBACF,6DAA6D;iBAC9D,CAAC,IAAI,CAAC,IAAI,CAAC;gBACZ,SAAS,EAAE,CAAC;aACb,CAAC;QACJ,CAAC;QACD,IAAI,SAAS,GAAG,CAAC,CAAC;QAClB,KAAK,MAAM,QAAQ,IAAI,KAAK,EAAE,CAAC;YAC7B,IAAI,UAAU,CAAC,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAC;gBACzE,SAAS,EAAE,CAAC;YACd,CAAC;QACH,CAAC;QACD,OAAO,EAAE,KAAK,EAAE,WAAW,EAAE,SAAS,EAAE,CAAC;IAC3C,CAAC;CAAA"}

package/lib/orchestrate/orchestrateAutoViewProductPlan.d.ts

@@ -0,0 +1,37 @@
+import { OpenApi } from "@typia/interface";
+import { IAutoViewAgentContext } from "../context/IAutoViewAgentContext";
+import { IAutoViewProductPlan } from "./structures/IAutoViewProductPlan";
+import { IAutoViewSdkMap } from "./structures/IAutoViewSdkMap";
+/**
+ * Phase 2 of the AutoView agent — Product Plan.
+ *
+ * Receives the SDK domain map from Phase 1 plus the optional design theme, asks
+ * the LLM to turn it into a frontend product (screens, navigation per actor,
+ * intentional omissions), and validates the plan against the real SDK before
+ * letting the run proceed.
+ *
+ * Validation invariants (deterministic, no LLM judgment):
+ *
+ * - At least one screen.
+ * - Every screen's `actor` is declared in the SDK map.
+ * - Every screen's `endpoints[]` entries match a real accessor path in the
+ *   OpenAPI document (no inventions).
+ * - Every actor with at least one resource in the SDK map has at least one screen
+ *   (no actors silently dropped).
+ * - Navigation entries reference actors that exist in the plan and only point at
+ *   screen paths the plan declared.
+ */
+export declare function orchestrateAutoViewProductPlan(ctx: IAutoViewAgentContext, props: {
+    document: OpenApi.IDocument;
+    sdkMap: IAutoViewSdkMap;
+    designTheme: string;
+    step: number;
+    filter?: {
+        include?: string[];
+        exclude?: string[];
+    };
+}): Promise<{
+    plan: IAutoViewProductPlan;
+    markdown: string;
+}>;
+export declare function renderProductPlanMarkdown(summary: string, plan: IAutoViewProductPlan): string;