@autoview/cli 0.1.0

package/lib/orchestrate/orchestrateAutoViewProductPlan.js

@@ -0,0 +1,109 @@
+"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.orchestrateAutoViewProductPlan = orchestrateAutoViewProductPlan;
+exports.renderProductPlanMarkdown = renderProductPlanMarkdown;
+const uuid_1 = require("uuid");
+const buildDeterministicPlan_1 = require("./utils/buildDeterministicPlan");
+/**
+ * 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.
+ */
+function orchestrateAutoViewProductPlan(ctx, props) {
+    return __awaiter(this, void 0, void 0, function* () {
+        var _a, _b, _c, _d;
+        // Deterministic plan — no LLM. The screen set is derived structurally from
+        // the swagger's CRUD shape (see buildDeterministicPlan). Same swagger →
+        // same screens, every run. The sdkMap is still produced by Phase 1 for the
+        // Render phase's domain context, but the IA no longer depends on LLM whim.
+        const actor = (_b = (_a = props.sdkMap.actors[0]) === null || _a === void 0 ? void 0 : _a.name) !== null && _b !== void 0 ? _b : "user";
+        const plan = (0, buildDeterministicPlan_1.buildDeterministicPlan)(props.document, actor, props.filter);
+        if (plan.screens.length === 0) {
+            throw new Error("AutoView Product Plan: the swagger produced no list/detail/create/update screens to render.");
+        }
+        const markdown = renderProductPlanMarkdown(`Deterministic CRUD plan — ${plan.screens.length} screens, ${(_d = (_c = plan.navigation[0]) === null || _c === void 0 ? void 0 : _c.primary.length) !== null && _d !== void 0 ? _d : 0} on primary nav.`, plan);
+        ctx.dispatch({
+            type: "autoViewProductPlan",
+            id: (0, uuid_1.v7)(),
+            created_at: new Date().toISOString(),
+            step: props.step,
+            pages: plan.screens.length,
+            intentionalOmissions: plan.intentionalOmissions.length,
+            productPlan: markdown,
+        });
+        return { plan, markdown };
+    });
+}
+/* -------------------------------------------------------------------------- */
+/* markdown rendering for the event payload                                   */
+/* -------------------------------------------------------------------------- */
+function renderProductPlanMarkdown(summary, plan) {
+    const lines = [
+        "# Product Plan",
+        "",
+        summary.trim(),
+        "",
+        `**Screens**: ${plan.screens.length} · **Intentional omissions**: ${plan.intentionalOmissions.length}`,
+        "",
+        "## Navigation",
+        "",
+    ];
+    for (const nav of plan.navigation) {
+        lines.push(`### ${nav.actor}`, "");
+        if (nav.primary.length > 0) {
+            lines.push("**Primary**");
+            for (const p of nav.primary)
+                lines.push(`- ${p}`);
+            lines.push("");
+        }
+        if (nav.secondary.length > 0) {
+            lines.push("**Secondary**");
+            for (const p of nav.secondary)
+                lines.push(`- ${p}`);
+            lines.push("");
+        }
+    }
+    lines.push("## Screens", "");
+    for (const screen of plan.screens) {
+        lines.push(`### \`${screen.path}\` — ${screen.title}`, "");
+        lines.push(`- **Actor**: ${screen.actor}`);
+        lines.push(`- **Pattern**: ${screen.uiPattern}`);
+        lines.push(`- **Purpose**: ${screen.purpose}`);
+        lines.push(`- **Endpoints**: ${screen.endpoints.join(", ")}`);
+        if (screen.notes.trim().length > 0) {
+            lines.push(`- **Notes**: ${screen.notes}`);
+        }
+        lines.push("");
+    }
+    if (plan.intentionalOmissions.length > 0) {
+        lines.push("## Intentional omissions", "");
+        for (const o of plan.intentionalOmissions) {
+            lines.push(`- **${o.target}** — ${o.reason}`);
+        }
+    }
+    return lines.join("\n");
+}
+//# sourceMappingURL=orchestrateAutoViewProductPlan.js.map

package/lib/orchestrate/orchestrateAutoViewProductPlan.js.map

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

package/lib/orchestrate/orchestrateAutoViewRender.d.ts

@@ -0,0 +1,133 @@
+import { OpenApi } from "@typia/interface";
+import { IAutoViewAgentContext } from "../context/IAutoViewAgentContext";
+import { IAutoViewProductPlan } from "./structures/IAutoViewProductPlan";
+import { IAutoViewSdkMap } from "./structures/IAutoViewSdkMap";
+/**
+ * Phase 4 of the AutoView agent — Render.
+ *
+ * Generates one TSX page per screen in {@link IAutoViewProductPlan} via parallel
+ * LLM calls. Each call returns the complete page source; the orchestrator runs
+ * it through TypeScript's parser and, on syntax failure, re-invokes the model
+ * with the diagnostic. Pages that still fail after {@link MAX_PARSE_RETRIES}
+ * retries are replaced with an inline error placeholder so the wider project
+ * keeps compiling.
+ *
+ * Returns a `path → content` patch keyed by the screen file path
+ * (`app/.../page.tsx`) that the orchestrator merges into the scaffold output
+ * before the `autoViewComplete` event.
+ */
+export interface IAutoViewRenderOutput {
+    /** `app/.../page.tsx` → TSX source for every rendered screen. */
+    files: Record<string, string>;
+    /** Per-screen render metadata, consumed by the Review phase. */
+    screens: IAutoViewRenderOutput.IScreenReport[];
+}
+export declare namespace IAutoViewRenderOutput {
+    interface IScreenReport {
+        pagePath: string;
+        uiPattern: string;
+        actor: string;
+        rationale: string;
+        attempts: number;
+        ok: boolean;
+        /**
+         * Parser diagnostic when `ok === false`. Empty string when the page
+         * rendered cleanly.
+         */
+        diagnostic: string;
+    }
+}
+export declare function orchestrateAutoViewRender(ctx: IAutoViewAgentContext, props: {
+    document: OpenApi.IDocument;
+    sdkMap: IAutoViewSdkMap;
+    productPlan: IAutoViewProductPlan;
+    designTheme: string;
+    step: number;
+}): Promise<IAutoViewRenderOutput>;
+/**
+ * Re-render a single screen after the typecheck phase reported diagnostics on
+ * its file. Reuses the parser-driven retry loop inside the per-screen render —
+ * the first attempt uses {@link buildTypecheckRetryHistories} (which surfaces
+ * the diagnostics + previous TSX), and any subsequent retries fall back to
+ * {@link buildRetryHistories} so the model still benefits from the deterministic
+ * `??`/`||` auto-fix and the syntax retry budget.
+ *
+ * Returns `null` when the model could not produce parser-valid TSX after the
+ * full retry budget; the caller should leave the existing (broken) file in
+ * place and report the failure so the operator still gets some output.
+ */
+export declare function rerenderScreenForTypecheck(ctx: IAutoViewAgentContext, args: {
+    screen: IAutoViewProductPlan.IScreen;
+    document: OpenApi.IDocument;
+    sdkMap: IAutoViewSdkMap;
+    designTheme: string;
+    promptCacheKey: string;
+    allScreenPaths: readonly string[];
+    previousTsx: string;
+    typecheckErrors: ITypecheckErrorLine[];
+}): Promise<{
+    tsx: string;
+    ok: boolean;
+    diagnostic: string;
+} | null>;
+/**
+ * Tsc diagnostic line carried into the typecheck retry prompt. Mirrors the
+ * shape {@link FrontendTypecheckSession} produces but only the fields the prompt
+ * actually needs, so the orchestrator can adapt other compilers in the future
+ * without touching this history builder.
+ */
+export interface ITypecheckErrorLine {
+    line: number;
+    column: number;
+    code: string;
+    message: string;
+}
+/**
+ * Runtime diagnostic carried into the audit retry prompt. Subset of
+ * `IRuntimeAuditDiagnostic` from `auditFrontendRuntime` — the prompt only needs
+ * the type label and the message.
+ */
+export interface IRuntimeErrorLine {
+    type: "console" | "pageerror" | "navigation";
+    message: string;
+}
+/**
+ * Re-render a single screen after the Phase 6 runtime audit reported broken
+ * navigation / console / pageerror diagnostics on its page. Identical
+ * retry-loop shape to {@link rerenderScreenForTypecheck}: the first attempt uses
+ * {@link buildRuntimeRetryHistories} (which surfaces the live runtime errors +
+ * previous TSX) and any subsequent retries fall back to
+ * {@link buildRetryHistories} so the parser-driven safety net still applies.
+ *
+ * Returns `null` when the model could not produce parser-valid TSX after the
+ * full retry budget; the caller should leave the existing (broken) file in
+ * place.
+ */
+export declare function rerenderScreenForRuntime(ctx: IAutoViewAgentContext, args: {
+    screen: IAutoViewProductPlan.IScreen;
+    document: OpenApi.IDocument;
+    sdkMap: IAutoViewSdkMap;
+    designTheme: string;
+    promptCacheKey: string;
+    allScreenPaths: readonly string[];
+    previousTsx: string;
+    runtimeErrors: IRuntimeErrorLine[];
+}): Promise<{
+    tsx: string;
+    ok: boolean;
+    diagnostic: string;
+} | null>;
+/**
+ * Map a planner-emitted screen path (`/`, `/cart`, `/todos/[id]/edit`) to the
+ * Next.js app-router file the scaffold writes for it. Exposed so the
+ * typecheck-driven retry loop can look up which screen owns a given broken file
+ * and re-render it directly.
+ */
+export declare function screenPathToFile(routePath: string): string;
+/**
+ * Inverse of {@link screenPathToFile}. Returns `null` when the path does not
+ * match the `app/.../page.tsx` shape the scaffold writes — e.g. for shared
+ * components or wiki files, which are not screen-owned and therefore cannot be
+ * fixed by re-rendering a single screen.
+ */
+export declare function fileToScreenPath(filePath: string): string | null;