@autoview/cli 0.1.0

package/lib/orchestrate/orchestrateAutoViewScaffold.js

@@ -0,0 +1,586 @@
+"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.orchestrateAutoViewScaffold = orchestrateAutoViewScaffold;
+exports.renderNavTs = renderNavTs;
+const uuid_1 = require("uuid");
+const AutoViewFrontendTemplate_1 = require("../constants/AutoViewFrontendTemplate");
+/**
+ * Phase 3 of the AutoView agent — Scaffold.
+ *
+ * Deterministic. No LLM calls. Produces the file layout of a runnable Next.js +
+ * shadcn/ui project shaped for the in-house Sandbox platform:
+ *
+ * - Copies the bundled frontend pack (`internals/template/frontend/`) verbatim —
+ *   Dockerfile, configs, shadcn/ui primitives, base app shell, health route.
+ * - Adds the AutoBE-generated SDK under `src/api/**`.
+ * - Adds an SDK adapter and a mock `IConnection` so generated pages can import a
+ *   single helper instead of touching the SDK directly.
+ * - Materializes one placeholder TSX page per screen in
+ *   {@link IAutoViewProductPlan} so the project compiles without Phase 4 having
+ *   run yet; Phase 4 (Render) overwrites these in place.
+ * - Drops the Phase 1 and Phase 2 markdown into `wiki/` so the operator can audit
+ *   the agent's intent alongside the code.
+ */
+function orchestrateAutoViewScaffold(ctx, props) {
+    return __awaiter(this, void 0, void 0, function* () {
+        const files = {};
+        // 1. Bundled frontend pack — Dockerfile, configs, shadcn/ui base, app
+        // shell, health route, CLAUDE.md / PROMPT.md / SANDBOX.md.
+        for (const [key, value] of Object.entries(AutoViewFrontendTemplate_1.AutoViewFrontendTemplate)) {
+            files[key] = value;
+        }
+        // 2. SDK under `src/api/**` from the AutoBE interface compiler.
+        const compiler = yield ctx.compiler();
+        const written = yield compiler.interface.write(props.document, []);
+        for (const [key, value] of Object.entries(written)) {
+            if (key.startsWith("src/api/")) {
+                files[key] = value;
+            }
+        }
+        // 3. SDK adapter + mock connection. Generated pages import from
+        // `@/lib/api` and `@/lib/connection` instead of touching the raw SDK,
+        // so the Render phase has one stable shape to talk to.
+        files["src/lib/connection.ts"] = renderConnectionTs(props.backend);
+        files["src/lib/api.ts"] = SDK_ADAPTER_TS;
+        // BootstrapGate + root layout override. The gate runs `bootstrapAuth()`
+        // once on mount before any page-level SDK call fires, so individual
+        // pages do not need to know about auth. When the bootstrap is a
+        // no-op (simulate / no-backend variant) children render immediately.
+        // The template ships a layout.tsx that does not wire the gate;
+        // overriding it here keeps the gate change in one place.
+        files["src/components/BootstrapGate.tsx"] = BOOTSTRAP_GATE_TSX;
+        files["app/layout.tsx"] = ROOT_LAYOUT_TSX;
+        // Navigation config consumed by the AppShell sidebar — generated from the
+        // top-level resources so the chrome reflects this swagger's domain.
+        files["src/lib/nav.ts"] = renderNavTs(props.document, props.productPlan);
+        // 4. Placeholder TSX per planned screen. Keeps `tsc --noEmit` happy
+        // and Next.js routable even before Phase 4 has filled the pages in.
+        // Phase 4 (Render) overwrites these by path.
+        for (const screen of props.productPlan.screens) {
+            const filePath = screenPathToFile(screen.path);
+            if (filePath === null)
+                continue;
+            files[filePath] = renderPlaceholderPage(screen);
+        }
+        // 5. Wiki — Phase 1 + Phase 2 evidence next to the code.
+        files["wiki/sdk-map.md"] = props.sdkMapMarkdown;
+        files["wiki/product-plan.md"] = props.productPlanMarkdown;
+        ctx.dispatch({
+            type: "autoViewScaffold",
+            id: (0, uuid_1.v7)(),
+            created_at: new Date().toISOString(),
+            step: props.step,
+            files: Object.keys(files).length,
+        });
+        return files;
+    });
+}
+/* -------------------------------------------------------------------------- */
+/* path → file mapping                                                        */
+/* -------------------------------------------------------------------------- */
+/**
+ * Map a Next.js route path (`/catalog`, `/orders/[id]`) to the corresponding
+ * `app/.../page.tsx` location.
+ *
+ * Returns `null` for the bare `/` route — the bundled frontend pack already
+ * ships `app/page.tsx`, and Phase 4 overwrites it directly.
+ */
+function screenPathToFile(routePath) {
+    const trimmed = routePath.replace(/^\/+/, "").replace(/\/+$/, "");
+    if (trimmed.length === 0)
+        return "app/page.tsx";
+    return `app/${trimmed}/page.tsx`;
+}
+function renderPlaceholderPage(screen) {
+    const title = jsonString(screen.title);
+    const purpose = jsonString(screen.purpose);
+    const pattern = jsonString(screen.uiPattern);
+    const actor = jsonString(screen.actor);
+    const endpointsArrayLit = JSON.stringify(screen.endpoints);
+    return `// Placeholder generated by AutoView Phase 3 (Scaffold).
+// Phase 4 (Render) replaces this file with a real Next.js page composed of the
+// SDK endpoints listed in the product plan. Until then the page renders a
+// short summary so \`next build\` succeeds and the operator can navigate.
+
+export default function Page() {
+  const endpoints: readonly string[] = ${endpointsArrayLit};
+  return (
+    <main className="container mx-auto py-10">
+      <p className="text-xs uppercase tracking-wide text-muted-foreground">
+        AutoView placeholder · {${pattern}}
+      </p>
+      <h1 className="mt-2 text-3xl font-bold tracking-tight">{${title}}</h1>
+      <p className="mt-3 text-muted-foreground">{${purpose}}</p>
+      <p className="mt-2 text-xs text-muted-foreground">
+        Actor: <span className="font-mono">{${actor}}</span>
+      </p>
+      {endpoints.length > 0 ? (
+        <div className="mt-4 rounded-md border bg-muted/30 p-3">
+          <p className="text-xs font-medium uppercase tracking-wide text-muted-foreground">
+            Planned SDK endpoints
+          </p>
+          <ul className="mt-2 space-y-1 text-xs font-mono">
+            {endpoints.map((accessor) => (
+              <li key={accessor}>{accessor}</li>
+            ))}
+          </ul>
+        </div>
+      ) : null}
+    </main>
+  );
+}
+`;
+}
+function jsonString(text) {
+    return JSON.stringify(text);
+}
+/* -------------------------------------------------------------------------- */
+/* static helpers                                                             */
+/* -------------------------------------------------------------------------- */
+/**
+ * Render the connection module.
+ *
+ * Two shapes:
+ *
+ * - When `backend.host` is non-null (shopping fixture or any SDK whose swagger
+ *   declares `servers[]`), default to that host + `simulate: false` so pages
+ *   render real product data on first boot. The operator can flip back to mocks
+ *   via `NEXT_PUBLIC_API_SIMULATE=true`.
+ * - When `backend.host` is null (AutoBE interface phase — no live backend exists
+ *   yet), default to `simulate: true` so the dev server boots without a real
+ *   server behind it.
+ */
+function renderConnectionTs(backend) {
+    if (backend.host !== null) {
+        return `import type { IConnection } from "@nestia/fetcher";
+
+/**
+ * Connection used by every generated page.
+ *
+ * Routed through Next.js's same-origin rewrite so the browser does not
+ * have to deal with the upstream backend's CORS policy — the samchon
+ * shopping backend, for instance, only advertises \`GET,HEAD,POST\` in
+ * its \`Access-Control-Allow-Methods\` response, which blocks every
+ * PATCH / PUT / DELETE preflight a typical catalog page issues. The
+ * rewrite lives in \`next.config.mjs\` and forwards \`/_backend/*\` to
+ * the real upstream (\`http://127.0.0.1:37001\` by default, see
+ * \`scripts/start-shopping-backend.sh\`). Override the upstream via
+ * \`NEXT_PUBLIC_API_HOST\` if you want to point elsewhere.
+ *
+ * Set \`NEXT_PUBLIC_API_SIMULATE=true\` to swap to typia-random mocks
+ * (the SDK then never hits the network).
+ *
+ * The \`Authorization\` header starts empty — \`bootstrapAuth()\` populates
+ * it on first call with a guest customer token issued by the shopping
+ * backend. \`BootstrapGate\` in the root layout invokes the bootstrap
+ * once on mount, before any page-level SDK call fires, so individual
+ * page components do not need to think about auth.
+ */
+/* -------------------------------------------------------------------------- */
+/* connection scope                                                            */
+/* -------------------------------------------------------------------------- */
+
+/**
+ * Which actor's token the SDK is currently authenticated as. The browser
+ * pathname picks the scope on every navigation — see \`BootstrapGate\`. A
+ * \`null\` scope means the bootstrap has not run yet.
+ */
+export type AuthScope = null | "customer" | "citizen" | "administrator" | "seller";
+
+let activeScope: AuthScope = null;
+const scopePromises: Partial<Record<Exclude<AuthScope, null>, Promise<void>>> = {};
+
+/**
+ * Seed credentials for the samchon shopping backend. The bundled
+ * \`scripts/start-shopping-backend.sh\` always seeds the same single account,
+ * so these values are constants. \`SHOPPING_SYSTEM_PASSWORD\` defaults to
+ * \`samchon\` in the upstream \`.env\` (see seeders).
+ */
+const SEED_EMAIL = "robot@nestia.io";
+const SEED_PASSWORD = "samchon";
+const SEED_NICKNAME = "Robot";
+const SEED_CITIZEN_MOBILE = "01012345678";
+const SEED_CITIZEN_NAME = "Robot";
+const CHANNEL_CODE = "samchon";
+
+export const connection: IConnection = {
+  host:
+    typeof window !== "undefined"
+      ? \`\${window.location.origin}/_backend\`
+      : (process?.env?.NEXT_PUBLIC_API_HOST ?? ${JSON.stringify(backend.host)}),
+  headers: {
+    Authorization: process?.env?.NEXT_PUBLIC_API_TOKEN ?? "",
+  },
+  simulate:
+    typeof process !== "undefined" &&
+    process.env.NEXT_PUBLIC_API_SIMULATE === "true",
+};
+
+/**
+ * Choose which actor's session the current page needs based on the URL.
+ * Defaults to plain customer (read-only catalog browsing). Admin and seller
+ * surfaces sign in with the seed account; coupons / orders / wallet /
+ * checkout / account need a citizen (the customer plus mobile/name).
+ */
+function scopeForPathname(pathname: string | null | undefined): Exclude<AuthScope, null> {
+  if (typeof pathname !== "string") return "customer";
+  if (pathname.startsWith("/admin")) return "administrator";
+  if (pathname.startsWith("/seller")) return "seller";
+  if (
+    pathname.startsWith("/cart") ||
+    pathname.startsWith("/orders") ||
+    pathname.startsWith("/checkout") ||
+    pathname.startsWith("/wallet") ||
+    pathname.startsWith("/coupons") ||
+    pathname.startsWith("/account")
+  ) {
+    return "citizen";
+  }
+  return "customer";
+}
+
+async function requestJson<T>(
+  method: "POST" | "PUT",
+  path: string,
+  body: unknown,
+): Promise<T> {
+  const res = await fetch(\`/_backend\${path}\`, {
+    method,
+    headers: { "Content-Type": "application/json", ...auth() },
+    body: JSON.stringify(body),
+  });
+  if (!res.ok) {
+    const text = await res.text().catch(() => "");
+    throw new Error(\`\${method} \${path} → \${res.status}: \${text.slice(0, 200)}\`);
+  }
+  return (await res.json()) as T;
+}
+
+function auth(): Record<string, string> {
+  const a = connection.headers?.Authorization;
+  return typeof a === "string" && a.length > 0 ? { Authorization: a } : {};
+}
+
+function applyToken(payload: unknown): void {
+  const raw = payload as {
+    setHeaders?: { Authorization?: unknown } | null;
+    token?: { access?: unknown } | null;
+  } | null;
+  const fromSetHeaders =
+    typeof raw?.setHeaders?.Authorization === "string"
+      ? (raw.setHeaders.Authorization as string)
+      : null;
+  const fromTokenAccess =
+    typeof raw?.token?.access === "string"
+      ? \`Bearer \${raw.token.access as string}\`
+      : null;
+  const token = fromSetHeaders ?? fromTokenAccess;
+  if (token === null) {
+    throw new Error("Auth bootstrap returned 2xx but no token in the body.");
+  }
+  if (connection.headers !== undefined) {
+    connection.headers.Authorization = token;
+  }
+}
+
+async function ensureCustomer(): Promise<void> {
+  // The customer \`POST /authenticate\` is the only call that issues a
+  // new JWT — every subsequent activate/login attaches role grants to
+  // the same customer server-side and returns the updated customer
+  // object with NO \`setHeaders\` / \`token\` field. Reusing the bearer
+  // header from this call works for citizen / member / admin / seller
+  // requests after the corresponding activate or login has succeeded.
+  await requestJson("POST", "/shoppings/customers/authenticate", {
+    channel_code: CHANNEL_CODE,
+    external_user: null,
+    href: typeof window !== "undefined" ? window.location.href : "http://localhost:3000",
+    referrer: typeof document !== "undefined" ? document.referrer || null : null,
+  }).then(applyToken);
+}
+
+async function ensureCitizen(): Promise<void> {
+  await ensureCustomer();
+  // \`activate\` upgrades the current customer to a citizen by attaching
+  // mobile/name. Returns the updated customer (no \`setHeaders\` / no
+  // \`token\` field) so the customer JWT from \`ensureCustomer\` stays the
+  // auth header for citizen-scoped routes. Idempotent for the seeded
+  // account; backend rejects re-activation with 409/422 which we
+  // swallow as success.
+  try {
+    await requestJson("POST", "/shoppings/customers/authenticate/activate", {
+      mobile: SEED_CITIZEN_MOBILE,
+      name: SEED_CITIZEN_NAME,
+    });
+  } catch (e: unknown) {
+    if (e instanceof Error && /already|conflict|409|422/i.test(e.message)) {
+      return;
+    }
+    throw e;
+  }
+}
+
+async function ensureMemberLogin(): Promise<void> {
+  await ensureCustomer();
+  // \`login\` is registered as PUT on the samchon/shopping backend
+  // (\`@TypedRoute.Put("login")\`), not POST. The response has no
+  // \`setHeaders\` / no \`token\` field — the existing customer JWT now
+  // carries member privileges server-side, so no header rewrite is
+  // needed.
+  await requestJson("PUT", "/shoppings/customers/authenticate/login", {
+    email: SEED_EMAIL,
+    password: SEED_PASSWORD,
+  });
+}
+
+async function ensureAdministrator(): Promise<void> {
+  await ensureMemberLogin();
+  await requestJson("PUT", "/shoppings/admins/authenticate/login", {
+    email: SEED_EMAIL,
+    password: SEED_PASSWORD,
+  });
+}
+
+async function ensureSeller(): Promise<void> {
+  await ensureMemberLogin();
+  await requestJson("PUT", "/shoppings/sellers/authenticate/login", {
+    email: SEED_EMAIL,
+    password: SEED_PASSWORD,
+  });
+}
+
+/**
+ * Bootstrap (or rotate) the connection's auth token to the scope demanded
+ * by the current pathname.
+ *
+ * Memoized per scope: the first call per scope drives the fetch chain,
+ * concurrent callers reuse the same promise, and successful runs are
+ * cached so navigations within the same scope are instant. Failures clear
+ * the cache so the next attempt retries cleanly.
+ *
+ * When \`simulate: true\` is on, this is a no-op because the SDK never
+ * touches the network in mock mode.
+ */
+export function bootstrapAuth(pathname?: string): Promise<void> {
+  if (connection.simulate === true) {
+    activeScope = "customer";
+    return Promise.resolve();
+  }
+  const scope = scopeForPathname(pathname);
+  if (scope === activeScope && scopePromises[scope] !== undefined) {
+    return scopePromises[scope]!;
+  }
+  const promise = (async () => {
+    if (scope === "administrator") await ensureAdministrator();
+    else if (scope === "seller") await ensureSeller();
+    else if (scope === "citizen") await ensureCitizen();
+    else await ensureCustomer();
+  })()
+    .then(() => {
+      activeScope = scope;
+    })
+    .catch((err: unknown) => {
+      scopePromises[scope] = undefined;
+      throw err;
+    });
+  scopePromises[scope] = promise;
+  return promise;
+}
+`;
+    }
+    return `import type { IConnection } from "@nestia/fetcher";
+
+/**
+ * Mock connection used by every generated page.
+ *
+ * Defaults to \`simulate: true\` so the project boots usefully without a
+ * live backend — the SDK returns typia-generated mock responses for every
+ * endpoint. Set \`NEXT_PUBLIC_API_SIMULATE=false\` (and point
+ * \`NEXT_PUBLIC_API_HOST\` at the real server) to switch to live mode.
+ */
+export const connection: IConnection = {
+  host:
+    typeof process !== "undefined"
+      ? process.env.NEXT_PUBLIC_API_HOST ?? "http://127.0.0.1:37001"
+      : "http://127.0.0.1:37001",
+  headers: {
+    Authorization: process?.env?.NEXT_PUBLIC_API_TOKEN ?? "Bearer preview",
+  },
+  simulate:
+    typeof process === "undefined" ||
+    process.env.NEXT_PUBLIC_API_SIMULATE !== "false",
+};
+
+/**
+ * No-op auth bootstrap for the interface (no-backend) variant. Accepts
+ * (and ignores) the pathname so the root layout can call
+ * \`bootstrapAuth(pathname)\` unconditionally, no matter which AutoView
+ * source generated the project.
+ */
+export function bootstrapAuth(_pathname?: string): Promise<void> {
+  return Promise.resolve();
+}
+`;
+}
+const BOOTSTRAP_GATE_TSX = `"use client";
+
+import { usePathname } from "next/navigation";
+import { useEffect } from "react";
+
+import { bootstrapAuth } from "@/src/lib/connection";
+
+/**
+ * Best-effort auth bootstrap. Attempts to issue the backend's token for the
+ * current actor scope on navigation, but NEVER blocks rendering.
+ *
+ * Auth must not gate the whole app: public screens (catalogs, lists) work
+ * without a token, and protected screens surface their own 401 through their
+ * normal load/error state. An auth-required backend (shopping / ERP) or a
+ * backend that is simply down used to take the ENTIRE app down behind a
+ * "Backend not ready" wall — even the public screens. It no longer does:
+ * the bootstrap runs in the background and children render immediately.
+ */
+export default function BootstrapGate({
+  children,
+}: {
+  children: React.ReactNode;
+}) {
+  const pathname = usePathname();
+
+  useEffect(() => {
+    bootstrapAuth(pathname).catch(() => {
+      // Bootstrap failed (no seeded account, auth-required backend, or backend
+      // down). Render anyway — each page handles its own loading / error state.
+    });
+  }, [pathname]);
+
+  return <>{children}</>;
+}
+`;
+const ROOT_LAYOUT_TSX = `import type { Metadata } from "next";
+import { Archivo } from "next/font/google";
+import "./globals.css";
+
+import { AppShell } from "@/components/AppShell";
+import BootstrapGate from "@/src/components/BootstrapGate";
+import { APP_NAME } from "@/src/lib/nav";
+
+// Industrial grotesque carrying the whole UI. Wires the \`--font-sans\` variable
+// the theme reads; the gate override must keep it or headings fall back to the
+// browser's default serif.
+const archivo = Archivo({
+  subsets: ["latin"],
+  variable: "--font-sans",
+  display: "swap",
+});
+
+export const metadata: Metadata = {
+  title: APP_NAME,
+  description: "Generated by AutoView from the API's OpenAPI document.",
+};
+
+export default function RootLayout({
+  children,
+}: {
+  children: React.ReactNode;
+}) {
+  return (
+    <html lang="en" className={\`dark \${archivo.variable}\`} suppressHydrationWarning>
+      <body className="min-h-screen bg-background font-sans antialiased">
+        <BootstrapGate>
+          <AppShell>{children}</AppShell>
+        </BootstrapGate>
+      </body>
+    </html>
+  );
+}
+`;
+/**
+ * Generate `src/lib/nav.ts` — the sidebar navigation config the AppShell reads.
+ * Top-level resources (chain depth 1) become nav items, grouped into data
+ * "Resources" (list tables) and "System" (singleton reads). The app name comes
+ * from the OpenAPI document title.
+ */
+function renderNavTs(document, plan) {
+    var _a, _b, _c, _d, _e;
+    const appName = ((_b = (_a = document.info) === null || _a === void 0 ? void 0 : _a.title) !== null && _b !== void 0 ? _b : "API").trim() || "API";
+    const navScreens = plan.screens.filter((s) => (s.depth === undefined || s.depth === 1) &&
+        !s.path.includes("[") &&
+        (s.uiPattern === "table" ||
+            s.uiPattern === "catalog" ||
+            s.uiPattern === "detail"));
+    // Singleton reads go under "System"; browsable resources go under "Resources",
+    // but on a large swagger that one section is 36 flat items. Group them by the
+    // resource name's leading token so related resources collapse into a section
+    // (shield_information_barrier* → "Shield", legal_hold_* → "Legal"). A token
+    // shared by ≥2 resources becomes its own section; lone resources stay under
+    // the generic "Resources" heading. Purely cosmetic — no screen is removed.
+    const groupKey = new Map(); // href → leading token (singularized)
+    const tokenCount = new Map();
+    for (const s of navScreens) {
+        if (s.uiPattern === "detail")
+            continue;
+        const resource = (_c = s.path.replace(/^\//, "").split("/")[0]) !== null && _c !== void 0 ? _c : "";
+        const token = singularizeToken((_d = resource.split("_")[0]) !== null && _d !== void 0 ? _d : resource);
+        groupKey.set(s.path, token);
+        tokenCount.set(token, ((_e = tokenCount.get(token)) !== null && _e !== void 0 ? _e : 0) + 1);
+    }
+    const items = navScreens.map((s) => {
+        var _a, _b;
+        if (s.uiPattern === "detail") {
+            return { href: s.path, title: s.title, group: "System" };
+        }
+        const token = (_a = groupKey.get(s.path)) !== null && _a !== void 0 ? _a : "";
+        const group = ((_b = tokenCount.get(token)) !== null && _b !== void 0 ? _b : 0) >= 2 ? titleCaseToken(token) : "Resources";
+        return { href: s.path, title: s.title, group };
+    });
+    // "Resources" first, named prefix groups alphabetically, "System" last.
+    const rank = (g) => g === "Resources" ? 0 : g === "System" ? 2 : 1;
+    items.sort((a, b) => rank(a.group) - rank(b.group) ||
+        a.group.localeCompare(b.group) ||
+        a.title.localeCompare(b.title));
+    return [
+        `// Generated by AutoView — sidebar navigation derived from the top-level`,
+        `// resources of the OpenAPI document.`,
+        `export const APP_NAME = ${JSON.stringify(appName)};`,
+        ``,
+        `export interface NavItem {`,
+        `  href: string;`,
+        `  title: string;`,
+        `  group: string;`,
+        `}`,
+        ``,
+        `export const NAV: NavItem[] = ${JSON.stringify(items, null, 2)};`,
+        ``,
+    ].join("\n");
+}
+/** Crude singularization of a leading nav token (`folders` → `folder`), used
+ *  only to bucket related resources; `status`-style 2-letter stems are left
+ *  alone to avoid over-trimming. */
+function singularizeToken(token) {
+    return token.length > 3 && token.endsWith("s") ? token.slice(0, -1) : token;
+}
+/** Title-case a single token for a nav section heading (`shield` → `Shield`). */
+function titleCaseToken(token) {
+    return token.length === 0
+        ? token
+        : token.charAt(0).toUpperCase() + token.slice(1);
+}
+const SDK_ADAPTER_TS = `// AutoView SDK adapter. Pages import \`api\` from this module instead of
+// touching \`@/src/api/\` directly so the SDK surface can be replaced
+// without rewriting every page.
+
+import api from "@/src/api";
+
+export default api;
+export * from "@/src/api";
+`;
+//# sourceMappingURL=orchestrateAutoViewScaffold.js.map

package/lib/orchestrate/orchestrateAutoViewScaffold.js.map

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

package/lib/orchestrate/orchestrateAutoViewSdkStudy.d.ts

@@ -0,0 +1,26 @@
+import { OpenApi } from "@typia/interface";
+import { IAutoViewAgentContext } from "../context/IAutoViewAgentContext";
+import { IAutoViewSdkMap } from "./structures/IAutoViewSdkMap";
+/**
+ * Phase 1 of the AutoView agent — SDK Study (deterministic).
+ *
+ * Derives the SDK domain map (resources / actors / journeys) structurally from
+ * the OpenAPI document instead of asking an LLM to read the compiled SDK. This
+ * is what lets a large swagger run at all: the former LLM study put the WHOLE
+ * SDK source in one prompt (300k+ tokens on a ~200-type spec) and hit a hard
+ * context overflow before Product Plan even began. The downstream phases use
+ * only the map's structure (Product Plan reads `actors[0].name`; Render reads an
+ * actor's journeys on its rerender fallback; Scaffold/Review embed it as a wiki
+ * document), so deriving it deterministically changes nothing the user sees —
+ * except that it always works, costs no tokens, and is reproducible.
+ *
+ * Kept `async` to preserve the orchestrator's call shape.
+ */
+export declare function orchestrateAutoViewSdkStudy(ctx: IAutoViewAgentContext, props: {
+    document: OpenApi.IDocument;
+    step: number;
+}): Promise<{
+    map: IAutoViewSdkMap;
+    markdown: string;
+}>;
+export declare function renderSdkMapMarkdown(summary: string, map: IAutoViewSdkMap): string;