@autoview/cli 0.1.0

package/lib/cli/main.js

@@ -0,0 +1,295 @@
+#!/usr/bin/env node
+"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 });
+const promises_1 = __importDefault(require("fs/promises"));
+const openai_1 = __importDefault(require("openai"));
+const path_1 = __importDefault(require("path"));
+const AutoViewAgent_1 = require("../AutoViewAgent");
+const generateDeterministic_1 = require("../generateDeterministic");
+const emitMcpServer_1 = require("../agent/emitMcpServer");
+const emitReport_1 = require("../agent/emitReport");
+const fromSwagger_1 = require("../fromSwagger");
+const renderPreview_1 = require("../preview/renderPreview");
+/**
+ * Tiny argv parser — supports `--key value` and `--key=value`. Avoids pulling a
+ * CLI parsing library so the package install stays lean.
+ */
+function parseArgs(argv) {
+    var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k;
+    const positional = [];
+    const flags = new Map();
+    for (let i = 0; i < argv.length; i++) {
+        const arg = argv[i];
+        if (arg.startsWith("--")) {
+            const eq = arg.indexOf("=");
+            if (eq !== -1) {
+                flags.set(arg.slice(2, eq), arg.slice(eq + 1));
+            }
+            else {
+                const key = arg.slice(2);
+                const next = argv[i + 1];
+                if (next !== undefined && !next.startsWith("--")) {
+                    flags.set(key, next);
+                    i++;
+                }
+                else {
+                    flags.set(key, "true");
+                }
+            }
+        }
+        else {
+            positional.push(arg);
+        }
+    }
+    const swaggerPath = positional[0];
+    const outDir = (_a = flags.get("out")) !== null && _a !== void 0 ? _a : "./frontend";
+    const model = (_c = (_b = flags.get("model")) !== null && _b !== void 0 ? _b : process.env.AUTOVIEW_MODEL) !== null && _c !== void 0 ? _c : "";
+    const apiKey = (_f = (_e = (_d = flags.get("api-key")) !== null && _d !== void 0 ? _d : process.env.AUTOVIEW_API_KEY) !== null && _e !== void 0 ? _e : process.env.OPENAI_API_KEY) !== null && _f !== void 0 ? _f : "";
+    const baseURL = (_g = flags.get("base-url")) !== null && _g !== void 0 ? _g : process.env.AUTOVIEW_BASE_URL;
+    const emit = flags.get("emit");
+    const designTheme = flags.get("design-theme");
+    const semaphoreRaw = flags.get("semaphore");
+    const semaphore = semaphoreRaw !== undefined ? parseInt(semaphoreRaw, 10) : undefined;
+    const backendOverride = (_h = flags.get("backend")) !== null && _h !== void 0 ? _h : process.env.AUTOVIEW_BACKEND;
+    const preview = flags.get("preview") === "true";
+    const noLlm = flags.get("no-llm") === "true";
+    const splitGlobs = (raw) => {
+        if (raw === undefined)
+            return undefined;
+        const parts = raw
+            .split(",")
+            .map((s) => s.trim())
+            .filter((s) => s.length > 0);
+        return parts.length > 0 ? parts : undefined;
+    };
+    const include = splitGlobs(flags.get("include"));
+    const exclude = splitGlobs(flags.get("exclude"));
+    if (swaggerPath === undefined) {
+        throw new Error(usage("Missing positional argument: <swagger.json>"));
+    }
+    // --preview, --emit, and --no-llm are LLM-free, so model / api-key are optional.
+    const llmFree = preview || emit !== undefined || noLlm;
+    if (!llmFree && model === "") {
+        throw new Error(usage("Missing --model (or AUTOVIEW_MODEL env). Example: --model openai/gpt-5.4"));
+    }
+    if (!llmFree && apiKey === "") {
+        throw new Error(usage("Missing --api-key (or AUTOVIEW_API_KEY / OPENAI_API_KEY env)."));
+    }
+    const runtimeAuditRaw = (_k = (_j = flags.get("runtime-audit")) !== null && _j !== void 0 ? _j : process.env.AUTOVIEW_RUNTIME_AUDIT) !== null && _k !== void 0 ? _k : "";
+    const runtimeAudit = runtimeAuditRaw === "true" ||
+        runtimeAuditRaw === "1" ||
+        runtimeAuditRaw === "yes";
+    const verify = flags.get("verify") === "true";
+    return {
+        swaggerPath,
+        outDir,
+        model,
+        apiKey,
+        baseURL,
+        designTheme,
+        semaphore: Number.isFinite(semaphore) ? semaphore : undefined,
+        backendOverride,
+        runtimeAudit,
+        verify,
+        preview,
+        emit,
+        noLlm,
+        include,
+        exclude,
+    };
+}
+function usage(extra) {
+    const head = extra !== undefined ? `${extra}\n\n` : "";
+    return (head +
+        [
+            "Usage: autoview <swagger.json> --model <name> --api-key <key> [options]",
+            "",
+            "Options:",
+            "  --out <dir>           Output directory (default: ./frontend)",
+            "  --model <name>        LLM model identifier, e.g. openai/gpt-5.4",
+            "  --api-key <key>       Vendor API key (or AUTOVIEW_API_KEY / OPENAI_API_KEY env)",
+            "  --base-url <url>      OpenAI-compatible endpoint (default: OpenAI)",
+            "  --design-theme <txt>  Optional design direction",
+            "  --semaphore <n>       Render concurrency cap (default: 8)",
+            "  --backend <url>       Live backend host for connection.ts (simulate:false).",
+            "                        Auto-extracted from swagger servers[] when omitted.",
+            '                        Pass --backend="" to force simulator mode.',
+            "  --runtime-audit       Opt into Phase 6 Playwright runtime audit (adds",
+            "                        ~10-20min; installs Playwright + Chromium).",
+            "  --verify              Verify the generated app in a real headless browser:",
+            "                        walk the user workflows (list → detail, forms) and",
+            "                        write wiki/verification.md. Installs Chromium.",
+            "  --no-llm              Generate the frontend deterministically — NO model",
+            "                        / api-key. The render is deterministic; this skips",
+            "                        the optional LLM typecheck-recovery / audit / review.",
+            "  --preview             LLM-free: parse the swagger and write preview.html",
+            "                        (endpoint tree + schemas + READ report). No --model",
+            "                        / --api-key needed. Inspect before a full run.",
+            "  --emit mcp            LLM-free: generate a runnable MCP server (agent tool",
+            "                        surface — read/write annotated, producer hints) instead",
+            "                        of the frontend. Set API_HOST to run it.",
+            "  --emit report         LLM-free: write consumability-report.md — can this API",
+            "                        be driven as a product? (navigable graph + orphan ids).",
+            "  --include <globs>     Comma-separated path globs to KEEP — slice a large",
+            '                        swagger, e.g. --include "shoppings/customers/**".',
+            "  --exclude <globs>     Comma-separated path globs to DROP after include,",
+            '                        e.g. --exclude "**/monitors/**".',
+            "",
+            "Environment fallbacks:",
+            "  AUTOVIEW_MODEL, AUTOVIEW_API_KEY (or OPENAI_API_KEY),",
+            "  AUTOVIEW_BASE_URL, AUTOVIEW_BACKEND, AUTOVIEW_RUNTIME_AUDIT",
+        ].join("\n"));
+}
+function writeAll(outDir, files) {
+    return __awaiter(this, void 0, void 0, function* () {
+        yield promises_1.default.mkdir(outDir, { recursive: true });
+        for (const [relative, content] of Object.entries(files)) {
+            const full = path_1.default.join(outDir, relative);
+            yield promises_1.default.mkdir(path_1.default.dirname(full), { recursive: true });
+            yield promises_1.default.writeFile(full, content, "utf-8");
+        }
+    });
+}
+function main() {
+    return __awaiter(this, void 0, void 0, function* () {
+        var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k;
+        const options = parseArgs(process.argv.slice(2));
+        const document = yield (0, fromSwagger_1.fromSwaggerFile)(options.swaggerPath);
+        // --preview: LLM-free READ-layer explorer. Parse, render a self-contained
+        // HTML, and stop — no model call, no generation.
+        if (options.preview) {
+            const serverUrl = (_b = (_a = (yield (0, fromSwagger_1.extractBackendFromSwaggerFile)(options.swaggerPath))) === null || _a === void 0 ? void 0 : _a.host) !== null && _b !== void 0 ? _b : null;
+            const html = (0, renderPreview_1.renderPreviewHtml)(document, {
+                title: (_d = (_c = document.info) === null || _c === void 0 ? void 0 : _c.title) !== null && _d !== void 0 ? _d : "API",
+                version: (_f = (_e = document.info) === null || _e === void 0 ? void 0 : _e.version) !== null && _f !== void 0 ? _f : "—",
+                serverUrl,
+            }, { include: options.include, exclude: options.exclude });
+            yield promises_1.default.mkdir(options.outDir, { recursive: true });
+            const out = path_1.default.join(options.outDir, "preview.html");
+            yield promises_1.default.writeFile(out, html, "utf-8");
+            // eslint-disable-next-line no-console
+            console.log(`[autoview] preview written to ${out} (LLM-free). Open it in a browser.`);
+            return;
+        }
+        // --emit mcp: LLM-free. Generate a runnable MCP server (agent tool surface)
+        // from the swagger and stop. No frontend, no model call.
+        if (options.emit === "mcp") {
+            const host = (_j = (_g = options.backendOverride) !== null && _g !== void 0 ? _g : (_h = (yield (0, fromSwagger_1.extractBackendFromSwaggerFile)(options.swaggerPath))) === null || _h === void 0 ? void 0 : _h.host) !== null && _j !== void 0 ? _j : null;
+            const files = (0, emitMcpServer_1.emitMcpServer)(document, {
+                backend: host,
+                title: (_k = document.info) === null || _k === void 0 ? void 0 : _k.title,
+            });
+            yield writeAll(options.outDir, files);
+            // eslint-disable-next-line no-console
+            console.log(`[autoview] MCP server written to ${options.outDir} (LLM-free). cd in, npm install, set API_HOST, npm start.`);
+            return;
+        }
+        // --emit report: LLM-free. Write a consumability report (can this API be
+        // driven as a product? navigable graph + orphan inputs) and stop.
+        if (options.emit === "report") {
+            const md = (0, emitReport_1.emitConsumabilityReport)(document);
+            yield promises_1.default.mkdir(options.outDir, { recursive: true });
+            const out = path_1.default.join(options.outDir, "consumability-report.md");
+            yield promises_1.default.writeFile(out, md, "utf-8");
+            // eslint-disable-next-line no-console
+            console.log(`[autoview] consumability report written to ${out} (LLM-free).`);
+            return;
+        }
+        if (options.emit !== undefined) {
+            throw new Error(usage(`Unknown --emit target "${options.emit}". Supported: mcp, report.`));
+        }
+        // Resolve backend host: explicit --backend flag wins; otherwise read the
+        // swagger's `servers[0].url` so the generated frontend defaults to
+        // `simulate:false` against the real backend. `--backend=""` is treated as
+        // "force simulator mode" — the operator can opt out without editing files.
+        const backend = yield (() => __awaiter(this, void 0, void 0, function* () {
+            if (options.backendOverride !== undefined) {
+                return options.backendOverride.length > 0
+                    ? { host: options.backendOverride }
+                    : null;
+            }
+            return (0, fromSwagger_1.extractBackendFromSwaggerFile)(options.swaggerPath);
+        }))();
+        // eslint-disable-next-line no-console
+        console.log(backend === null
+            ? `[autoview] backend: (none) — frontend will boot in simulator mode (typia-random data)`
+            : `[autoview] backend: ${backend.host} — frontend will boot in live mode (simulate:false)`);
+        // --no-llm: deterministic frontend, no model/key. Skips the agent's optional
+        // LLM polish (typecheck-recovery / runtime-audit / review).
+        if (options.noLlm) {
+            const files = yield (0, generateDeterministic_1.generateDeterministic)(document, {
+                backend: backend !== null && backend !== void 0 ? backend : { host: null },
+                filter: { include: options.include, exclude: options.exclude },
+                semaphore: options.semaphore,
+            });
+            yield writeAll(options.outDir, files);
+            // eslint-disable-next-line no-console
+            console.log(`[autoview] wrote ${Object.keys(files).length} files to ${options.outDir} (deterministic, LLM-free).`);
+            return;
+        }
+        const openai = new openai_1.default({
+            apiKey: options.apiKey,
+            baseURL: options.baseURL,
+        });
+        const vendor = {
+            model: options.model,
+            api: openai,
+        };
+        const agent = new AutoViewAgent_1.AutoViewAgent({
+            document,
+            vendor,
+            designTheme: options.designTheme,
+            semaphore: options.semaphore,
+            backend,
+            runtimeAudit: options.runtimeAudit,
+            verify: options.verify,
+            include: options.include,
+            exclude: options.exclude,
+            onEvent: (event) => {
+                const summary = (() => {
+                    switch (event.type) {
+                        case "autoViewStart":
+                            return `start (source=${event.source})`;
+                        case "autoViewSdkStudy":
+                            return `sdk-study (${event.resources} resources, ${event.actors} actors)`;
+                        case "autoViewProductPlan":
+                            return `product-plan (${event.pages} pages)`;
+                        case "autoViewScaffold":
+                            return `scaffold (${event.files} files)`;
+                        case "autoViewRenderPage":
+                            return `render ${event.completed}/${event.total} → ${event.pagePath} (${event.ok ? "ok" : "failed"})`;
+                        case "autoViewReview":
+                            return `review (${event.broken} broken, ${event.recovered} recovered)`;
+                        case "autoViewComplete":
+                            return `complete (${event.pages} pages, ${Object.keys(event.files).length} files, ${(event.elapsed / 1000).toFixed(1)}s)`;
+                    }
+                })();
+                // eslint-disable-next-line no-console
+                console.log(`[autoview] ${summary}`);
+            },
+        });
+        const { files } = yield agent.run();
+        yield writeAll(options.outDir, files);
+        // eslint-disable-next-line no-console
+        console.log(`[autoview] wrote ${Object.keys(files).length} files to ${options.outDir}`);
+    });
+}
+main().catch((err) => {
+    const message = err instanceof Error ? err.message : String(err);
+    // eslint-disable-next-line no-console
+    console.error(`\n[autoview] ${message}`);
+    process.exit(1);
+});
+//# sourceMappingURL=main.js.map

package/lib/cli/main.js.map

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

package/lib/compiler/AutoViewInterfaceCompiler.d.ts

@@ -0,0 +1,27 @@
+import { OpenApi } from "@typia/interface";
+import { IAutoBeInterfaceCompiler } from "../typings";
+/**
+ * Self-defined interface compiler — Step 3 of the AutoBE-independence track.
+ *
+ * Replaces `@autobe/compiler`'s `AutoBeCompiler`. AutoView only ever calls
+ * `compiler.interface.write(document, exclude)` to materialize the typed SDK it
+ * shows the LLM (SDK Study) and bundles into the scaffold, so only that surface
+ * is reproduced here. TypeScript only — the Java path and the realize/test
+ * listener plumbing AutoBE carries are dropped.
+ *
+ * Under the hood this is the same `@nestia/migrate` call the AutoBE compiler
+ * makes; `@nestia/migrate` is a samchon-ecosystem package, not an AutoBE one,
+ * so depending on it directly keeps the package free of `@autobe/*`. Swapping
+ * NestiaMigrate for a standard-OpenAPI SDK generator (the "Nestia tphase-out"
+ * from the design meeting) is a later iteration that happens behind this seam.
+ *
+ * Prettier beautification (AutoBE's `FilePrinter.beautify`) is intentionally
+ * skipped: it pulled in prettier + sort-imports + jsdoc plugins purely for
+ * cosmetics, and the render phase reads SDK *types*, not formatting.
+ */
+export declare class AutoViewInterfaceCompiler implements IAutoBeInterfaceCompiler {
+    write(document: OpenApi.IDocument, options: string[] | {
+        language: "typescript" | "java";
+        exclude: string[];
+    }): Promise<Record<string, string>>;
+}

package/lib/compiler/AutoViewInterfaceCompiler.js

@@ -0,0 +1,68 @@
+"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.AutoViewInterfaceCompiler = void 0;
+const migrate_1 = require("@nestia/migrate");
+const utils_1 = require("../utils");
+const normalizeForNestia_1 = require("../utils/normalizeForNestia");
+/**
+ * Self-defined interface compiler — Step 3 of the AutoBE-independence track.
+ *
+ * Replaces `@autobe/compiler`'s `AutoBeCompiler`. AutoView only ever calls
+ * `compiler.interface.write(document, exclude)` to materialize the typed SDK it
+ * shows the LLM (SDK Study) and bundles into the scaffold, so only that surface
+ * is reproduced here. TypeScript only — the Java path and the realize/test
+ * listener plumbing AutoBE carries are dropped.
+ *
+ * Under the hood this is the same `@nestia/migrate` call the AutoBE compiler
+ * makes; `@nestia/migrate` is a samchon-ecosystem package, not an AutoBE one,
+ * so depending on it directly keeps the package free of `@autobe/*`. Swapping
+ * NestiaMigrate for a standard-OpenAPI SDK generator (the "Nestia tphase-out"
+ * from the design meeting) is a later iteration that happens behind this seam.
+ *
+ * Prettier beautification (AutoBE's `FilePrinter.beautify`) is intentionally
+ * skipped: it pulled in prettier + sort-imports + jsdoc plugins purely for
+ * cosmetics, and the render phase reads SDK *types*, not formatting.
+ */
+class AutoViewInterfaceCompiler {
+    write(document, options) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const exclude = Array.isArray(options)
+                ? options
+                : options.exclude;
+            // swagger 직접 nestia — invert/transform AST 왕복 없음, query 보존.
+            // normalizeForNestia: nestia mis-handles two real-world shapes — a route
+            // whose query has >1 object param (Apideck list endpoints) is dropped, and a
+            // GET/HEAD carrying a requestBody (Notion's comments/users) yields an SDK
+            // function its own fetcher rejects. Normalizing both keeps the SDK in lockstep
+            // with the screen plan, which applies the same pass via toEndpoints.
+            const migrate = new migrate_1.NestiaMigrateApplication((0, normalizeForNestia_1.normalizeForNestia)(document));
+            const files = migrate.nest({
+                keyword: true,
+                simulate: true,
+                e2e: true,
+                author: {
+                    tag: "autoview",
+                    value: "Generated by AutoView - https://github.com/wrtnlabs/AutoView-Legacy",
+                },
+            });
+            return Object.fromEntries([
+                ...(yield utils_1.ArrayUtil.asyncMap(Object.entries(files).filter(([key]) => exclude.includes(key) === false), (_a) => __awaiter(this, [_a], void 0, function* ([key, value]) { return [key, value]; }))),
+                [
+                    "packages/api/swagger.json",
+                    JSON.stringify(migrate.getData().document(), null, 2),
+                ],
+            ]);
+        });
+    }
+}
+exports.AutoViewInterfaceCompiler = AutoViewInterfaceCompiler;
+//# sourceMappingURL=AutoViewInterfaceCompiler.js.map

package/lib/compiler/AutoViewInterfaceCompiler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"AutoViewInterfaceCompiler.js","sourceRoot":"","sources":["../../src/compiler/AutoViewInterfaceCompiler.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,6CAA2D;AAI3D,oCAAqC;AACrC,oEAAiE;AAEjE;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAa,yBAAyB;IACvB,KAAK,CAChB,QAA2B,EAC3B,OAKK;;YAEL,MAAM,OAAO,GAAa,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC;gBAC9C,CAAC,CAAC,OAAO;gBACT,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC;YACpB,4DAA4D;YAC5D,yEAAyE;YACzE,6EAA6E;YAC7E,0EAA0E;YAC1E,+EAA+E;YAC/E,qEAAqE;YACrE,MAAM,OAAO,GAA6B,IAAI,kCAAwB,CACpE,IAAA,uCAAkB,EAAC,QAAQ,CAAC,CAC7B,CAAC;YACF,MAAM,KAAK,GAA2B,OAAO,CAAC,IAAI,CAAC;gBACjD,OAAO,EAAE,IAAI;gBACb,QAAQ,EAAE,IAAI;gBACd,GAAG,EAAE,IAAI;gBACT,MAAM,EAAE;oBACN,GAAG,EAAE,UAAU;oBACf,KAAK,EAAE,qEAAqE;iBAC7E;aACF,CAAC,CAAC;YACH,OAAO,MAAM,CAAC,WAAW,CAAC;gBACxB,GAAG,CAAC,MAAM,iBAAS,CAAC,QAAQ,CAC1B,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC,KAAK,KAAK,CAAC,EACxE,KAAqB,EAAE,0CAAhB,CAAC,GAAG,EAAE,KAAK,CAAC,IAAK,OAAA,CAAC,GAAG,EAAE,KAAK,CAAU,CAAA,GAAA,CAC9C,CAAC;gBACF;oBACE,2BAA2B;oBAC3B,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC;iBACtD;aACF,CAAC,CAAC;QACL,CAAC;KAAA;CACF;AA1CD,8DA0CC"}

package/lib/constants/AutoViewFrontendTemplate.d.ts

@@ -0,0 +1 @@
+export declare const AutoViewFrontendTemplate: Record<string, string>;