dinorex 1.0.1 → 1.0.2

package/README.md

@@ -20,21 +20,6 @@ npx dinorex scan
 
 ---
 
-## Setup: Your Anthropic API Key
-
-Dinorex uses Claude AI to analyze your code. You need a free Anthropic API key.
-
-1. Go to [https://console.anthropic.com](https://console.anthropic.com)
-2. Create an account and generate an API key
-3. Set it in your environment:
-
-```bash
-# Mac/Linux — add to ~/.zshrc or ~/.bashrc
-export ANTHROPIC_API_KEY=sk-ant-your-key-here
-
-# Windows (PowerShell)
-$env:ANTHROPIC_API_KEY="sk-ant-your-key-here"
-
 # Or pass it directly every time
 dinorex scan --api-key sk-ant-your-key-here
 ```

package/dist/agent.d.ts

@@ -0,0 +1,8 @@
+import type { ApiSpec, DiffResult } from "./store.js";
+import type { CollectedFiles } from "./scanner.js";
+export declare function analyzeWithAI(collected: CollectedFiles, projectName?: string): Promise<ApiSpec>;
+export declare function analyzeIncremental(existingSpec: ApiSpec, diff: DiffResult): Promise<{
+    spec: ApiSpec;
+    changed: boolean;
+}>;
+//# sourceMappingURL=agent.d.ts.map

package/dist/agent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent.d.ts","sourceRoot":"","sources":["../src/agent.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AACtD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAsGnD,wBAAsB,aAAa,CACjC,SAAS,EAAE,cAAc,EACzB,WAAW,SAAQ,GAClB,OAAO,CAAC,OAAO,CAAC,CAmClB;AAED,wBAAsB,kBAAkB,CACtC,YAAY,EAAE,OAAO,EACrB,IAAI,EAAE,UAAU,GACf,OAAO,CAAC;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE,OAAO,CAAA;CAAE,CAAC,CAmC9C"}

package/dist/agent.groq.d.ts

@@ -0,0 +1,14 @@
+/**
+ * agent.groq.ts — Free Groq/Llama3 version of the Dinorex AI agent.
+ *
+ * Get a free API key at: https://console.groq.com
+ * Set it:  export GROQ_API_KEY=gsk_your_key_here
+ */
+import type { ApiSpec, DiffResult } from "./store.js";
+import type { CollectedFiles } from "./scanner.js";
+export declare function analyzeWithAI(collected: CollectedFiles, projectName?: string): Promise<ApiSpec>;
+export declare function analyzeIncremental(existingSpec: ApiSpec, diff: DiffResult): Promise<{
+    spec: ApiSpec;
+    changed: boolean;
+}>;
+//# sourceMappingURL=agent.groq.d.ts.map

package/dist/agent.groq.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent.groq.d.ts","sourceRoot":"","sources":["../src/agent.groq.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AACtD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAuMnD,wBAAsB,aAAa,CACjC,SAAS,EAAE,cAAc,EACzB,WAAW,SAAQ,GAClB,OAAO,CAAC,OAAO,CAAC,CA6BlB;AAED,wBAAsB,kBAAkB,CACtC,YAAY,EAAE,OAAO,EACrB,IAAI,EAAE,UAAU,GACf,OAAO,CAAC;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE,OAAO,CAAA;CAAE,CAAC,CA0B9C"}

package/dist/agent.groq.js

@@ -0,0 +1,213 @@
+/**
+ * agent.groq.ts — Free Groq/Llama3 version of the Dinorex AI agent.
+ *
+ * Get a free API key at: https://console.groq.com
+ * Set it:  export GROQ_API_KEY=gsk_your_key_here
+ */
+const GROQ_API_URL = "https://api.groq.com/openai/v1/chat/completions";
+const MODEL = "llama-3.3-70b-versatile";
+const MAX_CHARS = 12000;
+const SYSTEM_FULL = `You are an expert API analyst. Analyze source code (JavaScript OR TypeScript) and extract a complete API specification.
+
+Supported frameworks — recognize ALL of these:
+- Express / Fastify / Koa: router.get('/path', handler), app.post('/path', handler)
+- NestJS decorators: @Controller('base'), @Get(':id'), @Post(), @Put(), @Patch(), @Delete(), @Body(), @Param(), @Query(), @UseGuards()
+- TypeScript DTOs, interfaces, type aliases, class properties
+- Mongoose / Sequelize / TypeORM / Prisma schemas
+- Zod / Joi / Yup schemas: extract field names and types
+- class-validator decorators: @IsString(), @IsEmail(), etc.
+
+Rules:
+- Return ONLY valid JSON. No markdown, no explanation, no code fences.
+- Infer realistic example values from model/schema field names and types.
+- Group endpoints into logical collections (e.g. "Users", "Auth", "Products").
+- Detect auth guards: @UseGuards(), authMiddleware, isAuthenticated, verifyToken, requireAuth, JwtAuthGuard → requiresAuth: true.
+- For NestJS: combine @Controller('users') prefix with method paths (@Get(':id') → /users/:id).
+- TypeScript optional fields (field?: type) → required: false.
+
+Return ONLY this JSON structure, nothing else:
+{
+  "projectName": "string",
+  "baseUrl": "http://localhost:3000",
+  "version": "1.0.0",
+  "description": "string",
+  "collections": [
+    {
+      "name": "string",
+      "description": "string",
+      "endpoints": [
+        {
+          "id": "unique-kebab-slug",
+          "method": "GET|POST|PUT|PATCH|DELETE",
+          "path": "/api/resource/:id",
+          "summary": "Short title",
+          "description": "Longer description",
+          "requiresAuth": false,
+          "pathParams": [{ "name": "id", "type": "string", "description": "...", "example": "abc123" }],
+          "queryParams": [{ "name": "page", "type": "integer", "description": "...", "example": 1 }],
+          "requestBody": {
+            "contentType": "application/json",
+            "schema": {
+              "fieldName": { "type": "string", "example": "value", "required": true, "description": "..." }
+            }
+          },
+          "responses": {
+            "200": { "description": "Success", "example": {} },
+            "400": { "description": "Bad Request" },
+            "401": { "description": "Unauthorized" },
+            "404": { "description": "Not Found" },
+            "500": { "description": "Server Error" }
+          }
+        }
+      ]
+    }
+  ]
+}`;
+const SYSTEM_INCREMENTAL = `You are an expert API analyst doing an INCREMENTAL update to an existing API spec.
+
+You understand JavaScript AND TypeScript including Express, NestJS decorators, DTOs, Zod schemas, Mongoose/TypeORM/Prisma models.
+
+You will receive:
+1. The EXISTING spec (full JSON)
+2. NEW or CHANGED source files to analyze
+
+Your job:
+- Extract endpoints from new/changed files
+- If endpoint already exists (same method + path): update it if code changed, keep it if unchanged
+- If it is NEW: add it to the correct collection (create collection if needed)
+- Remove endpoints whose source files are listed under REMOVED FILES
+- Keep all existing endpoints from unchanged files
+
+Return the COMPLETE updated spec JSON. No markdown, no explanation, ONLY JSON.`;
+async function callGroq(systemPrompt, userMessage) {
+    const apiKey = process.env.GROQ_API_KEY;
+    if (!apiKey) {
+        throw new Error("GROQ_API_KEY is not set.\nGet a free key at https://console.groq.com\nThen run: export GROQ_API_KEY=gsk_your_key_here");
+    }
+    const response = await fetch(GROQ_API_URL, {
+        method: "POST",
+        headers: {
+            "Content-Type": "application/json",
+            Authorization: `Bearer ${apiKey}`,
+        },
+        body: JSON.stringify({
+            model: MODEL,
+            temperature: 0.1,
+            max_tokens: 8000,
+            messages: [
+                { role: "system", content: systemPrompt },
+                { role: "user", content: userMessage },
+            ],
+        }),
+    });
+    if (!response.ok) {
+        const err = await response.text();
+        throw new Error(`Groq API error ${response.status}: ${err}`);
+    }
+    const data = (await response.json());
+    return data.choices?.[0]?.message?.content ?? "";
+}
+function parseJSON(raw) {
+    const cleaned = raw
+        .trim()
+        .replace(/^```json\s*/i, "")
+        .replace(/^```\s*/i, "")
+        .replace(/```\s*$/i, "")
+        .trim();
+    const start = cleaned.indexOf("{");
+    const end = cleaned.lastIndexOf("}");
+    if (start === -1 || end === -1) {
+        throw new Error(`No JSON object found in response.\n\nSnippet: ${raw.slice(0, 300)}`);
+    }
+    const jsonStr = cleaned.slice(start, end + 1);
+    try {
+        return JSON.parse(jsonStr);
+    }
+    catch (err) {
+        throw new Error(`Invalid JSON from Groq: ${err.message}\n\nSnippet: ${jsonStr.slice(0, 300)}`);
+    }
+}
+function batchFiles(files) {
+    const batches = [];
+    let current = [];
+    let size = 0;
+    for (const f of files) {
+        const len = f.content.length + f.path.length + 20;
+        if (size + len > MAX_CHARS && current.length > 0) {
+            batches.push(current);
+            current = [];
+            size = 0;
+        }
+        const truncated = { ...f, content: f.content.slice(0, MAX_CHARS) };
+        current.push(truncated);
+        size += len;
+    }
+    if (current.length > 0)
+        batches.push(current);
+    return batches;
+}
+function mergeSpecs(specs) {
+    const base = specs[0];
+    const collectionsMap = {};
+    for (const spec of specs) {
+        for (const col of spec.collections) {
+            if (!collectionsMap[col.name]) {
+                collectionsMap[col.name] = { ...col, endpoints: [] };
+            }
+            for (const ep of col.endpoints) {
+                const key = `${ep.method}:${ep.path}`;
+                const exists = collectionsMap[col.name].endpoints.some((e) => `${e.method}:${e.path}` === key);
+                if (!exists)
+                    collectionsMap[col.name].endpoints.push(ep);
+            }
+        }
+    }
+    return { ...base, collections: Object.values(collectionsMap) };
+}
+function sleep(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+export async function analyzeWithAI(collected, projectName = "API") {
+    const allFiles = [
+        ...collected.routes.map((f) => ({ ...f, kind: "ROUTE" })),
+        ...collected.controllers.map((f) => ({ ...f, kind: "CONTROLLER" })),
+        ...collected.services.map((f) => ({ ...f, kind: "SERVICE" })),
+        ...collected.models.map((f) => ({ ...f, kind: "MODEL" })),
+    ];
+    const batches = batchFiles(allFiles);
+    console.log(`\n  📦 Sending ${batches.length} batch(es) to Groq (${allFiles.length} files total)...`);
+    const partialSpecs = [];
+    for (let i = 0; i < batches.length; i++) {
+        const batch = batches[i];
+        const context = batch
+            .map((f) => `### [${f.kind}] ${f.path}\n\`\`\`\n${f.content}\n\`\`\``)
+            .join("\n\n");
+        const userMessage = `Project name: "${projectName}" (batch ${i + 1} of ${batches.length})\n\n${context}\n\nExtract all API endpoints found in these files and return ONLY the JSON spec.`;
+        const raw = await callGroq(SYSTEM_FULL, userMessage);
+        const partial = parseJSON(raw);
+        partialSpecs.push(partial);
+        if (i < batches.length - 1)
+            await sleep(1000);
+    }
+    return batches.length === 1 ? partialSpecs[0] : mergeSpecs(partialSpecs);
+}
+export async function analyzeIncremental(existingSpec, diff) {
+    const { newFiles, changedFiles, removedFiles } = diff;
+    if (!newFiles.length && !changedFiles.length && !removedFiles.length) {
+        return { spec: existingSpec, changed: false };
+    }
+    const filesToAnalyze = [...newFiles, ...changedFiles];
+    const removedContext = removedFiles.length > 0
+        ? `\n\nREMOVED FILES (delete their endpoints):\n${removedFiles.join("\n")}`
+        : "";
+    const specStr = JSON.stringify(existingSpec, null, 2);
+    const specTruncated = specStr.length > 6000 ? specStr.slice(0, 6000) + "\n... [truncated]" : specStr;
+    const changedContext = filesToAnalyze
+        .map((f) => `### ${f.path}\n\`\`\`\n${f.content.slice(0, 3000)}\n\`\`\``)
+        .join("\n\n");
+    const userMessage = `EXISTING SPEC:\n${specTruncated}\n\nNEW/CHANGED FILES:\n${changedContext}${removedContext}\n\nReturn the complete updated spec JSON only.`;
+    const raw = await callGroq(SYSTEM_INCREMENTAL, userMessage);
+    const updated = parseJSON(raw);
+    return { spec: updated, changed: true };
+}
+//# sourceMappingURL=agent.groq.js.map

package/dist/agent.groq.js.map

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

package/{src → dist}/agent.js

@@ -1,11 +1,8 @@
 import Anthropic from "@anthropic-ai/sdk";
-
 const client = new Anthropic();
-
 function buildContext(files) {
-  return files.map(f => `### ${f.path}\n\`\`\`\n${f.content}\n\`\`\``).join("\n\n");
+    return files.map((f) => `### ${f.path}\n\`\`\`\n${f.content}\n\`\`\``).join("\n\n");
 }
-
 const SYSTEM_FULL = `You are an expert API analyst. Analyze source code (JavaScript OR TypeScript) and extract a complete API specification.
 
 Supported frameworks and patterns — recognize ALL of these:
@@ -64,7 +61,6 @@ Return this exact structure:
     }
   ]
 }`;
-
 const SYSTEM_INCREMENTAL = `You are an expert API analyst doing an INCREMENTAL update to an existing API spec.
 
 You understand JavaScript AND TypeScript, including: Express, Fastify, NestJS decorators (@Controller, @Get, @Post, etc.), DTOs, Zod/Joi schemas, Mongoose/TypeORM/Prisma models, and class-validator decorators.
@@ -83,73 +79,81 @@ Your job:
 - Keep all existing endpoints from files that weren't changed
 
 Return the COMPLETE updated spec JSON (same structure as input). No markdown, no explanation, only JSON.`;
-
+function parseJSON(raw) {
+    const cleaned = raw
+        .trim()
+        .replace(/^```json\s*/i, "")
+        .replace(/^```\s*/i, "")
+        .replace(/```\s*$/i, "")
+        .trim();
+    try {
+        return JSON.parse(cleaned);
+    }
+    catch (err) {
+        throw new Error(`AI returned invalid JSON: ${err.message}\n\nSnippet: ${raw.slice(0, 300)}`);
+    }
+}
 export async function analyzeWithAI(collected, projectName = "API") {
-  const allFiles = [
-    ...collected.routes,
-    ...collected.controllers,
-    ...collected.services,
-    ...collected.models,
-  ];
-
-  const context = [
-    collected.routes.length > 0 ? "## ROUTES\n" + buildContext(collected.routes) : null,
-    collected.controllers.length > 0 ? "## CONTROLLERS\n" + buildContext(collected.controllers) : null,
-    collected.services.length > 0 ? "## SERVICES\n" + buildContext(collected.services) : null,
-    collected.models.length > 0 ? "## MODELS\n" + buildContext(collected.models) : null,
-  ].filter(Boolean).join("\n\n---\n\n");
-
-  const response = await client.messages.create({
-    model: "claude-opus-4-5",
-    max_tokens: 8000,
-    system: SYSTEM_FULL,
-    messages: [{
-      role: "user",
-      content: `Project: "${projectName}"\n\n${context}\n\nExtract all API endpoints and return the JSON spec.`
-    }],
-  });
-
-  return parseJSON(response.content[0].text);
+    const context = [
+        collected.routes.length > 0
+            ? "## ROUTES\n" + buildContext(collected.routes)
+            : null,
+        collected.controllers.length > 0
+            ? "## CONTROLLERS\n" + buildContext(collected.controllers)
+            : null,
+        collected.services.length > 0
+            ? "## SERVICES\n" + buildContext(collected.services)
+            : null,
+        collected.models.length > 0
+            ? "## MODELS\n" + buildContext(collected.models)
+            : null,
+    ]
+        .filter(Boolean)
+        .join("\n\n---\n\n");
+    const response = await client.messages.create({
+        model: "claude-opus-4-5",
+        max_tokens: 8000,
+        system: SYSTEM_FULL,
+        messages: [
+            {
+                role: "user",
+                content: `Project: "${projectName}"\n\n${context}\n\nExtract all API endpoints and return the JSON spec.`,
+            },
+        ],
+    });
+    const block = response.content[0];
+    if (block.type !== "text") {
+        throw new Error("Unexpected response type from Anthropic API");
+    }
+    return parseJSON(block.text);
 }
-
 export async function analyzeIncremental(existingSpec, diff) {
-  const { newFiles, changedFiles, removedFiles } = diff;
-
-  if (newFiles.length === 0 && changedFiles.length === 0 && removedFiles.length === 0) {
-    return { spec: existingSpec, changed: false };
-  }
-
-  const changedContext = [...newFiles, ...changedFiles]
-    .map(f => `### ${f.path}\n\`\`\`\n${f.content}\n\`\`\``)
-    .join("\n\n");
-
-  const removedContext = removedFiles.length > 0
-    ? `\n\nREMOVED FILES (delete their endpoints):\n${removedFiles.join("\n")}`
-    : "";
-
-  const response = await client.messages.create({
-    model: "claude-opus-4-5",
-    max_tokens: 8000,
-    system: SYSTEM_INCREMENTAL,
-    messages: [{
-      role: "user",
-      content: `EXISTING SPEC:\n${JSON.stringify(existingSpec, null, 2)}\n\nNEW/CHANGED FILES:\n${changedContext}${removedContext}\n\nReturn the complete updated spec.`
-    }],
-  });
-
-  const updated = parseJSON(response.content[0].text);
-  return { spec: updated, changed: true };
+    const { newFiles, changedFiles, removedFiles } = diff;
+    if (!newFiles.length && !changedFiles.length && !removedFiles.length) {
+        return { spec: existingSpec, changed: false };
+    }
+    const changedContext = [...newFiles, ...changedFiles]
+        .map((f) => `### ${f.path}\n\`\`\`\n${f.content}\n\`\`\``)
+        .join("\n\n");
+    const removedContext = removedFiles.length > 0
+        ? `\n\nREMOVED FILES (delete their endpoints):\n${removedFiles.join("\n")}`
+        : "";
+    const response = await client.messages.create({
+        model: "claude-opus-4-5",
+        max_tokens: 8000,
+        system: SYSTEM_INCREMENTAL,
+        messages: [
+            {
+                role: "user",
+                content: `EXISTING SPEC:\n${JSON.stringify(existingSpec, null, 2)}\n\nNEW/CHANGED FILES:\n${changedContext}${removedContext}\n\nReturn the complete updated spec.`,
+            },
+        ],
+    });
+    const block = response.content[0];
+    if (block.type !== "text") {
+        throw new Error("Unexpected response type from Anthropic API");
+    }
+    const updated = parseJSON(block.text);
+    return { spec: updated, changed: true };
 }
-
-function parseJSON(raw) {
-  const cleaned = raw.trim()
-    .replace(/^```json\s*/i, "")
-    .replace(/^```\s*/i, "")
-    .replace(/```\s*$/i, "")
-    .trim();
-  try {
-    return JSON.parse(cleaned);
-  } catch (err) {
-    throw new Error(`AI returned invalid JSON: ${err.message}\n\nSnippet: ${raw.slice(0, 300)}`);
-  }
-}
+//# sourceMappingURL=agent.js.map

package/dist/agent.js.map

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

package/dist/cli.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":""}

package/dist/cli.js

@@ -0,0 +1,179 @@
+#!/usr/bin/env node
+import { program } from "commander";
+import chalk from "chalk";
+import ora from "ora";
+import { readFileSync } from "fs";
+import { fileURLToPath } from "url";
+import path from "path";
+import { execSync } from "child_process";
+import { createHash } from "crypto";
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+const pkgPath = path.join(__dirname, "../package.json");
+const pkg = JSON.parse(readFileSync(pkgPath, "utf-8"));
+function banner() {
+    console.log();
+    console.log(chalk.green.bold("  🦕  DINOREX") + chalk.dim(" v" + pkg.version));
+    console.log(chalk.dim("  AI-powered API documentation — one command, full docs."));
+    console.log();
+}
+function checkApiKey(options) {
+    const isAnthropic = options.provider === "anthropic" ||
+        process.env.DINOREX_PROVIDER === "anthropic";
+    if (isAnthropic) {
+        if (options.apiKey)
+            process.env.ANTHROPIC_API_KEY = options.apiKey;
+        if (!process.env.ANTHROPIC_API_KEY) {
+            console.log(chalk.red("  ✗ ANTHROPIC_API_KEY is not set.\n"));
+            console.log(chalk.dim("  Option 1 — env var:   export ANTHROPIC_API_KEY=sk-ant-..."));
+            console.log(chalk.dim("  Option 2 — flag:      dinorex scan --provider anthropic --api-key sk-ant-..."));
+            console.log();
+            process.exit(1);
+        }
+    }
+    else {
+        if (options.apiKey)
+            process.env.GROQ_API_KEY = options.apiKey;
+        if (!process.env.GROQ_API_KEY) {
+            console.log(chalk.red("  ✗ GROQ_API_KEY is not set.\n"));
+            console.log(chalk.dim("  Get a free key at: https://console.groq.com"));
+            console.log(chalk.dim("  Then: export GROQ_API_KEY=gsk_your_key_here"));
+            console.log(chalk.dim("  Or:   dinorex scan --api-key gsk_..."));
+            console.log(chalk.dim("  To use Anthropic instead: dinorex scan --provider anthropic --api-key sk-ant-..."));
+            console.log();
+            process.exit(1);
+        }
+    }
+}
+// ── dinorex scan [dir] ────────────────────────────────────────────────────
+program
+    .name("dinorex")
+    .version(pkg.version)
+    .description("AI-powered API documentation generator");
+program
+    .command("scan [directory]")
+    .alias("init")
+    .description("Scan a project and launch the interactive docs UI")
+    .option("-p, --port <port>", "Port for the docs server", "4321")
+    .option("--no-open", "Skip auto-opening browser")
+    .option("--api-key <key>", "API key (Groq or Anthropic)")
+    .option("--provider <name>", "AI provider: groq (default) or anthropic")
+    .action(async (directory = ".", options) => {
+    banner();
+    checkApiKey(options);
+    const targetDir = path.resolve(directory);
+    const port = parseInt(options.port, 10);
+    const isAnthropic = options.provider === "anthropic" || process.env.DINOREX_PROVIDER === "anthropic";
+    const { scanProject } = await import("./scanner.js");
+    const agentFile = isAnthropic ? "./agent.js" : "./agent.groq.js";
+    const { analyzeWithAI, analyzeIncremental } = await import(agentFile);
+    const { startServer } = await import("./server.js");
+    const { loadStore, saveStore, diffScan } = await import("./store.js");
+    console.log(chalk.dim(`  📂 ${targetDir}`));
+    const providerLabel = isAnthropic ? "anthropic" : "groq (free)";
+    console.log(chalk.dim(`  🤖 Provider: ${providerLabel}\n`));
+    // ── 1. Scan ──
+    const s1 = ora({ text: "Scanning project files…", color: "green" }).start();
+    let scanResult;
+    try {
+        scanResult = await scanProject(targetDir);
+    }
+    catch (e) {
+        s1.fail(chalk.red(e.message));
+        process.exit(1);
+    }
+    const { summary, collected } = scanResult;
+    const total = Object.values(summary).reduce((a, b) => a + b, 0);
+    if (!total) {
+        s1.fail(chalk.red("No API files found. Make sure you're in an Express/Nest/Fastify project."));
+        process.exit(1);
+    }
+    s1.succeed(chalk.green("Discovered: ") +
+        chalk.white(`${summary.routes} routes  ${summary.controllers} controllers  ${summary.services} services  ${summary.models} models`));
+    // ── 2. AI analysis (full or incremental) ──
+    const stored = loadStore(targetDir);
+    const allFiles = [
+        ...collected.routes,
+        ...collected.controllers,
+        ...collected.services,
+        ...collected.models,
+    ];
+    let spec;
+    if (stored?.spec && stored?.hashes) {
+        const diff = diffScan(stored.hashes, allFiles);
+        const hasChanges = diff.newFiles.length || diff.changedFiles.length || diff.removedFiles.length;
+        if (hasChanges) {
+            const s2 = ora({
+                text: `Incremental update — ${diff.newFiles.length} new, ${diff.changedFiles.length} changed files…`,
+                color: "cyan",
+            }).start();
+            try {
+                const result = await analyzeIncremental(stored.spec, diff);
+                spec = result.spec;
+                const hashes = {};
+                for (const f of allFiles) {
+                    hashes[f.path] = { hash: createHash("md5").update(f.content).digest("hex") };
+                }
+                saveStore(targetDir, { spec, hashes, lastScan: new Date().toISOString() });
+                s2.succeed(chalk.cyan("Incremental update complete."));
+            }
+            catch (e) {
+                s2.fail(chalk.red(e.message));
+                process.exit(1);
+            }
+        }
+        else {
+            spec = stored.spec;
+            console.log(chalk.dim("  ✓ No changes since last scan — using cached spec."));
+        }
+    }
+    else {
+        const s2 = ora({ text: "Running full AI analysis (~15s)…", color: "cyan" }).start();
+        try {
+            spec = await analyzeWithAI(collected, path.basename(targetDir));
+            const hashes = {};
+            for (const f of allFiles) {
+                hashes[f.path] = { hash: createHash("md5").update(f.content).digest("hex") };
+            }
+            saveStore(targetDir, { spec, hashes, lastScan: new Date().toISOString() });
+            s2.succeed(chalk.cyan("Analysis complete — ") +
+                chalk.white(`${spec.collections.reduce((a, c) => a + c.endpoints.length, 0)} endpoints across ${spec.collections.length} collections`));
+        }
+        catch (e) {
+            s2.fail(chalk.red(e.message));
+            process.exit(1);
+        }
+    }
+    // ── 3. Start server ──
+    const s3 = ora({ text: `Starting docs server on :${port}…`, color: "yellow" }).start();
+    let srv;
+    try {
+        srv = await startServer(targetDir, { port, _cachedSpec: spec });
+    }
+    catch (e) {
+        s3.fail(chalk.red(e.message));
+        process.exit(1);
+    }
+    s3.succeed(chalk.yellow("Docs server running!"));
+    console.log();
+    console.log(chalk.green.bold(`  ✓ Dinorex docs → ${srv.url}`));
+    console.log();
+    console.log(chalk.dim("  Tip: run  dinorex scan  again anytime to pick up new endpoints."));
+    console.log(chalk.dim("  Ctrl+C to stop.\n"));
+    if (options.open !== false) {
+        try {
+            const cmd = process.platform === "darwin"
+                ? `open ${srv.url}`
+                : process.platform === "win32"
+                    ? `start ${srv.url}`
+                    : `xdg-open ${srv.url}`;
+            execSync(cmd, { stdio: "ignore" });
+        }
+        catch { }
+    }
+    process.on("SIGINT", () => {
+        console.log(chalk.dim("\n  Dinorex stopped. 🦕\n"));
+        process.exit(0);
+    });
+});
+program.parse();
+//# sourceMappingURL=cli.js.map