@autoview/cli 0.1.0

package/src/orchestrate/orchestrateAutoViewProductPlan.ts

@@ -0,0 +1,121 @@
+import { OpenApi } from "@typia/interface";
+import {
+  AutoBeAutoViewProductPlanEvent,
+} from "../typings";
+import { v7 } from "uuid";
+
+import { IAutoViewAgentContext } from "../context/IAutoViewAgentContext";
+import { IAutoViewProductPlan } from "./structures/IAutoViewProductPlan";
+import { IAutoViewSdkMap } from "./structures/IAutoViewSdkMap";
+import { buildDeterministicPlan } from "./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.
+ */
+export async function orchestrateAutoViewProductPlan(
+  ctx: IAutoViewAgentContext,
+  props: {
+    document: OpenApi.IDocument;
+    sdkMap: IAutoViewSdkMap;
+    designTheme: string;
+    step: number;
+    filter?: { include?: string[]; exclude?: string[] };
+  },
+): Promise<{ plan: IAutoViewProductPlan; markdown: string }> {
+  // 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 = props.sdkMap.actors[0]?.name ?? "user";
+  const plan = 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, ${plan.navigation[0]?.primary.length ?? 0} on primary nav.`,
+    plan,
+  );
+
+  ctx.dispatch({
+    type: "autoViewProductPlan",
+    id: v7(),
+    created_at: new Date().toISOString(),
+    step: props.step,
+    pages: plan.screens.length,
+    intentionalOmissions: plan.intentionalOmissions.length,
+    productPlan: markdown,
+  } satisfies AutoBeAutoViewProductPlanEvent);
+
+  return { plan, markdown };
+}
+
+/* -------------------------------------------------------------------------- */
+/* markdown rendering for the event payload                                   */
+/* -------------------------------------------------------------------------- */
+
+export function renderProductPlanMarkdown(
+  summary: string,
+  plan: IAutoViewProductPlan,
+): string {
+  const lines: string[] = [
+    "# 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");
+}
+