@velajs/cli 0.3.1 → 1.0.0

package/package.json

@@ -1,11 +1,27 @@
 {
   "name": "@velajs/cli",
-  "version": "0.3.1",
+  "version": "1.0.0",
   "description": "CLI for Vela apps — seeding and project tasks (Node-side; not bundled into the edge Worker)",
-  "type": "module",
+  "keywords": [
+    "cli",
+    "cloudflare-workers",
+    "edge",
+    "seeder",
+    "vela"
+  ],
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/velajs/cli.git"
+  },
   "bin": {
     "vela": "./dist/index.js"
   },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "type": "module",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
   "exports": {
@@ -18,44 +34,45 @@
       "import": "./dist/config.js"
     }
   },
-  "files": [
-    "dist",
-    "README.md"
-  ],
-  "engines": {
-    "node": ">=20"
-  },
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.29.0",
     "clipanion": "^4.0.0-rc.4",
     "zod": "^3.25.76"
   },
-  "peerDependencies": {
-    "@velajs/vela": ">=1.15.0"
-  },
   "devDependencies": {
+    "@arethetypeswrong/cli": "^0.18.5",
+    "@changesets/cli": "^2.31.0",
     "@swc/core": "^1.15.43",
-    "@types/node": "^22.0.0",
-    "@velajs/vela": "^1.15.0",
-    "typescript": "^6.0.3",
+    "@types/node": "^24.13.3",
+    "@velajs/vela": "^1.21.0",
+    "oxfmt": "^0.58.0",
+    "oxlint": "^1.73.0",
+    "publint": "^0.3.21",
+    "tsdown": "^0.22.4",
+    "typescript": "^7.0.2",
     "unplugin-swc": "^1.5.9",
-    "vitest": "^4.1.9"
+    "vitest": "^4.1.10"
   },
-  "keywords": [
-    "vela",
-    "cli",
-    "seeder",
-    "edge",
-    "cloudflare-workers"
-  ],
-  "license": "MIT",
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/velajs/cli.git"
+  "peerDependencies": {
+    "@velajs/vela": ">=1.21.0 <2"
+  },
+  "engines": {
+    "node": ">=24"
   },
   "scripts": {
-    "build": "rm -rf dist && tsc",
+    "build": "tsdown",
     "typecheck": "tsc --noEmit",
-    "test": "vitest run"
+    "test": "vitest run",
+    "lint": "oxlint .",
+    "format": "oxfmt .",
+    "format:check": "oxfmt --check .",
+    "publint": "publint",
+    "attw": "attw --pack . --profile esm-only",
+    "changeset": "changeset",
+    "version-packages": "changeset version",
+    "release:preflight": "npm view @velajs/vela@1.21.0 version",
+    "release:check": "node scripts/check-release-lock.mjs && pnpm verify && pnpm audit --audit-level=high",
+    "release": "pnpm release:preflight && pnpm release:check && changeset publish",
+    "verify": "pnpm lint && pnpm format:check && pnpm build && pnpm typecheck && pnpm test && pnpm publint && pnpm attw"
   }
 }

package/dist/commands/introspect.commands.d.ts

@@ -1,40 +0,0 @@
-import type { VelaApplication } from '@velajs/vela';
-import { Command } from 'clipanion';
-/** Shared shell: load config → createApp → run → best-effort dispose. */
-declare abstract class AppCommand extends Command {
-    config: string | undefined;
-    json: boolean;
-    protected abstract run(app: VelaApplication): Promise<number>;
-    execute(): Promise<number>;
-    protected print(text: string): void;
-}
-/** `vela route list` — the app's HTTP route table. */
-export declare class RouteListCommand extends AppCommand {
-    static paths: string[][];
-    static usage: import("clipanion").Usage;
-    protected run(app: VelaApplication): Promise<number>;
-}
-/** `vela module graph` — the loaded module graph. */
-export declare class ModuleGraphCommand extends AppCommand {
-    static paths: string[][];
-    static usage: import("clipanion").Usage;
-    protected run(app: VelaApplication): Promise<number>;
-}
-/** `vela entrypoint list` — declared entrypoint kinds and their entries. */
-export declare class EntrypointListCommand extends AppCommand {
-    static paths: string[][];
-    static usage: import("clipanion").Usage;
-    protected run(app: VelaApplication): Promise<number>;
-}
-/** `vela openapi dump` — emit the OpenAPI document. */
-export declare class OpenApiDumpCommand extends Command {
-    static paths: string[][];
-    static usage: import("clipanion").Usage;
-    config: string | undefined;
-    out: string | undefined;
-    title: string | undefined;
-    apiVersion: string | undefined;
-    globalPrefix: string | undefined;
-    execute(): Promise<number>;
-}
-export {};

package/dist/commands/introspect.commands.js

@@ -1,165 +0,0 @@
-import { writeFile } from 'node:fs/promises';
-import { createOpenApiDocument } from '@velajs/vela';
-import { Command, Option } from 'clipanion';
-import { loadConfig } from '../config.js';
-import { renderTable } from '../format.js';
-import { collectEntrypoints, collectModules, collectRoutes, renderModuleTree } from '../introspect.js';
-/** Shared shell: load config → createApp → run → best-effort dispose. */
-class AppCommand extends Command {
-    config = Option.String('--config', { description: 'Path to the vela config file.' });
-    json = Option.Boolean('--json', false, { description: 'Emit machine-readable JSON.' });
-    async execute() {
-        const velaConfig = await loadConfig(process.cwd(), this.config);
-        const app = await velaConfig.createApp();
-        try {
-            return await this.run(app);
-        }
-        finally {
-            const dispose = app.dispose;
-            if (typeof dispose === 'function') {
-                try {
-                    await dispose.call(app);
-                }
-                catch (error) {
-                    this.context.stderr.write(`Warning: teardown failed: ${String(error)}\n`);
-                }
-            }
-        }
-    }
-    print(text) {
-        this.context.stdout.write(`${text}\n`);
-    }
-}
-/** `vela route list` — the app's HTTP route table. */
-export class RouteListCommand extends AppCommand {
-    static paths = [['route', 'list']];
-    static usage = Command.Usage({
-        category: 'Introspection',
-        description: 'List the HTTP routes of the Vela app.',
-        details: 'Framework-composed controller routes (method, full path, controller#handler) plus ' +
-            'everything else mounted on the router (CRUD/contributed routes, doc UIs) labeled (mounted).',
-        examples: [['List routes', 'vela route list'], ['As JSON', 'vela route list --json']],
-    });
-    async run(app) {
-        const rows = collectRoutes(app);
-        if (rows === null) {
-            this.print('This app builds no HTTP routes — nothing to list.');
-            return 0;
-        }
-        if (this.json) {
-            this.print(JSON.stringify(rows, null, 2));
-            return 0;
-        }
-        for (const line of renderTable(['METHOD', 'PATH', 'HANDLER'], rows.map((r) => [r.method, r.path, r.handler]))) {
-            this.print(line);
-        }
-        return 0;
-    }
-}
-/** `vela module graph` — the loaded module graph. */
-export class ModuleGraphCommand extends AppCommand {
-    static paths = [['module', 'graph']];
-    static usage = Command.Usage({
-        category: 'Introspection',
-        description: 'Print the module graph of the Vela app.',
-        details: 'Module instances with their imports (indented tree), global/lazy flags, and provider ' +
-            'counts. --json emits the raw descriptions (providers, exports, imports per module).',
-        examples: [['Print the graph', 'vela module graph'], ['As JSON', 'vela module graph --json']],
-    });
-    async run(app) {
-        const modules = collectModules(app);
-        if (this.json) {
-            this.print(JSON.stringify(modules, null, 2));
-            return 0;
-        }
-        for (const line of renderModuleTree(modules))
-            this.print(line);
-        return 0;
-    }
-}
-/** `vela entrypoint list` — declared entrypoint kinds and their entries. */
-export class EntrypointListCommand extends AppCommand {
-    static paths = [['entrypoint', 'list']];
-    static usage = Command.Usage({
-        category: 'Introspection',
-        description: 'List entrypoint kinds and entries (websocket, queue, cron, …).',
-        details: 'Every declared kind — including kinds with zero entries — with the contributing ' +
-            'class (and method for method-level kinds) and its metadata.',
-        examples: [['List entrypoints', 'vela entrypoint list']],
-    });
-    async run(app) {
-        const rows = collectEntrypoints(app);
-        if (this.json) {
-            this.print(JSON.stringify(rows, null, 2));
-            return 0;
-        }
-        for (const line of renderTable(['KIND', 'TARGET', 'META'], rows.map((r) => [r.kind, r.target, r.meta]))) {
-            this.print(line);
-        }
-        return 0;
-    }
-}
-/** `vela openapi dump` — emit the OpenAPI document. */
-export class OpenApiDumpCommand extends Command {
-    static paths = [['openapi', 'dump']];
-    static usage = Command.Usage({
-        category: 'Introspection',
-        description: 'Emit the OpenAPI document for the Vela app.',
-        details: "Requires `rootModule` in vela.config (createOpenApiDocument works from the module " +
-            "class). The app's global prefix is applied automatically; --global-prefix overrides.",
-        examples: [
-            ['Print to stdout', 'vela openapi dump'],
-            ['Write to a file', 'vela openapi dump --out openapi.json'],
-        ],
-    });
-    config = Option.String('--config', { description: 'Path to the vela config file.' });
-    out = Option.String('--out', { description: 'Write the document to this file instead of stdout.' });
-    title = Option.String('--title', { description: 'info.title override.' });
-    apiVersion = Option.String('--api-version', { description: 'info.version override.' });
-    globalPrefix = Option.String('--global-prefix', {
-        description: "Path prefix override (defaults to the app's global prefix).",
-    });
-    async execute() {
-        const velaConfig = await loadConfig(process.cwd(), this.config);
-        if (!velaConfig.rootModule) {
-            this.context.stderr.write("openapi dump needs the root module. Add it to your vela.config:\n\n" +
-                '  export default defineVelaConfig({\n' +
-                '    rootModule: AppModule,\n' +
-                '    async createApp() { ... },\n' +
-                '  });\n');
-            return 1;
-        }
-        const app = await velaConfig.createApp();
-        try {
-            const info = {};
-            if (this.title)
-                info.title = this.title;
-            if (this.apiVersion)
-                info.version = this.apiVersion;
-            const document = createOpenApiDocument(velaConfig.rootModule, {
-                globalPrefix: this.globalPrefix ?? app.getGlobalPrefix(),
-                ...(Object.keys(info).length > 0 ? { info } : {}),
-            });
-            const text = JSON.stringify(document, null, 2);
-            if (this.out) {
-                await writeFile(this.out, `${text}\n`, 'utf8');
-                this.context.stdout.write(`Wrote ${this.out}\n`);
-            }
-            else {
-                this.context.stdout.write(`${text}\n`);
-            }
-            return 0;
-        }
-        finally {
-            const dispose = app.dispose;
-            if (typeof dispose === 'function') {
-                try {
-                    await dispose.call(app);
-                }
-                catch (error) {
-                    this.context.stderr.write(`Warning: teardown failed: ${String(error)}\n`);
-                }
-            }
-        }
-    }
-}

package/dist/commands/mcp.command.d.ts

@@ -1,17 +0,0 @@
-import { Command } from 'clipanion';
-/**
- * `vela mcp serve` — an MCP stdio server exposing the same READ-ONLY
- * introspection as the `route`/`module`/`entrypoint`/`openapi` commands, so an
- * AI agent can query a Vela app's shape over the Model Context Protocol.
- *
- * Deliberately does NOT extend `AppCommand`: that base disposes the app in its
- * `finally` the moment `run()` returns, but an MCP server must stay alive until
- * the transport closes. stdout is reserved for JSON-RPC framing; every human
- * message goes to stderr.
- */
-export declare class McpServeCommand extends Command {
-    static paths: string[][];
-    static usage: import("clipanion").Usage;
-    config: string | undefined;
-    execute(): Promise<number>;
-}

package/dist/commands/mcp.command.js

@@ -1,166 +0,0 @@
-import { readFile } from 'node:fs/promises';
-import { dirname, join } from 'node:path';
-import { fileURLToPath } from 'node:url';
-import { createOpenApiDocument } from '@velajs/vela';
-import { Command, Option } from 'clipanion';
-import { z } from 'zod';
-import { loadConfig } from '../config.js';
-import { collectEntrypoints, collectModules, collectRoutes, renderModuleTree } from '../introspect.js';
-const OPENAPI_URI = 'vela://openapi';
-/** A single JSON text block — the shape every tool/resource result uses. */
-function jsonText(data) {
-    return { content: [{ type: 'text', text: JSON.stringify(data, null, 2) }] };
-}
-/** An MCP tool error result (JSON-RPC stays 2.0; the failure is in-band). */
-function toolError(message) {
-    return { isError: true, content: [{ type: 'text', text: message }] };
-}
-/** Name + version for the MCP server handshake, read from the CLI's own package.json. */
-async function readCliIdentity() {
-    const here = dirname(fileURLToPath(import.meta.url));
-    const pkgPath = join(here, '..', '..', 'package.json');
-    const pkg = JSON.parse(await readFile(pkgPath, 'utf8'));
-    return { name: pkg.name ?? '@velajs/cli', version: pkg.version ?? '0.0.0' };
-}
-/**
- * String-label lookup for a DI token across the module graph. Reads only the
- * serializable descriptions (`collectModules`) — never resolves the token or
- * constructs anything. Reports which modules provide/export it and their scope
- * flags, plus whether the string names a module itself.
- */
-function describeToken(app, token) {
-    const modules = collectModules(app);
-    const providedBy = modules
-        .filter((m) => m.providers.includes(token))
-        .map((m) => ({ moduleId: m.moduleId, isGlobal: m.isGlobal, lazy: m.lazy, exported: m.exports.includes(token) }));
-    const matchesModule = modules.find((m) => m.moduleId === token);
-    return {
-        token,
-        found: providedBy.length > 0 || matchesModule !== undefined,
-        providedBy,
-        module: matchesModule
-            ? { moduleId: matchesModule.moduleId, isGlobal: matchesModule.isGlobal, lazy: matchesModule.lazy }
-            : null,
-    };
-}
-/**
- * `vela mcp serve` — an MCP stdio server exposing the same READ-ONLY
- * introspection as the `route`/`module`/`entrypoint`/`openapi` commands, so an
- * AI agent can query a Vela app's shape over the Model Context Protocol.
- *
- * Deliberately does NOT extend `AppCommand`: that base disposes the app in its
- * `finally` the moment `run()` returns, but an MCP server must stay alive until
- * the transport closes. stdout is reserved for JSON-RPC framing; every human
- * message goes to stderr.
- */
-export class McpServeCommand extends Command {
-    static paths = [['mcp', 'serve']];
-    static usage = Command.Usage({
-        category: 'Introspection',
-        description: 'Serve Vela introspection as MCP tools over stdio (for AI agents).',
-        details: 'Builds the app from vela.config and runs a Model Context Protocol stdio server. Exposes ' +
-            'read-only tools (route_list, module_graph, entrypoint_list, openapi_dump, token_describe) ' +
-            'and — when the config declares a rootModule — a `vela://openapi` resource. stdout carries ' +
-            'only JSON-RPC; all logging goes to stderr. The server runs until the client disconnects.',
-        examples: [
-            ['Serve over stdio', 'vela mcp serve'],
-            ['Use a specific config', 'vela mcp serve --config ./config/vela.config.js'],
-        ],
-    });
-    config = Option.String('--config', { description: 'Path to the vela config file.' });
-    async execute() {
-        const { McpServer } = await import('@modelcontextprotocol/sdk/server/mcp.js');
-        const { StdioServerTransport } = await import('@modelcontextprotocol/sdk/server/stdio.js');
-        const log = (message) => {
-            this.context.stderr.write(`${message}\n`);
-        };
-        const velaConfig = await loadConfig(process.cwd(), this.config);
-        const app = await velaConfig.createApp();
-        const rootModule = velaConfig.rootModule;
-        try {
-            const identity = await readCliIdentity();
-            const server = new McpServer(identity);
-            server.registerTool('route_list', {
-                description: 'The app\'s HTTP route table: framework-composed controller routes (method, full ' +
-                    'path, Controller#handler) plus everything else mounted on the router, labeled ' +
-                    '(mounted). Empty when the app builds no HTTP routes.',
-                inputSchema: {},
-            }, () => jsonText(collectRoutes(app) ?? []));
-            server.registerTool('module_graph', {
-                description: 'The loaded module graph as serializable descriptions (providers, exports, imports, ' +
-                    'global/lazy flags). Pass tree=true to also get the rendered import tree lines.',
-                inputSchema: { tree: z.boolean().optional() },
-            }, ({ tree }) => {
-                const modules = collectModules(app);
-                return jsonText(tree ? { modules, tree: renderModuleTree(modules) } : modules);
-            });
-            server.registerTool('entrypoint_list', {
-                description: 'Every declared entrypoint kind (websocket, queue, cron, …) with its entries and ' +
-                    'metadata — including kinds with zero entries. Lazy modules stay unmaterialized.',
-                inputSchema: {},
-            }, () => jsonText(collectEntrypoints(app)));
-            server.registerTool('openapi_dump', {
-                description: 'The OpenAPI 3.1 document for the app. Requires a rootModule in vela.config. ' +
-                    'globalPrefix/title/apiVersion override the defaults (the app global prefix and ' +
-                    'the module-derived info).',
-                inputSchema: {
-                    globalPrefix: z.string().optional(),
-                    title: z.string().optional(),
-                    apiVersion: z.string().optional(),
-                },
-            }, ({ globalPrefix, title, apiVersion }) => {
-                if (!rootModule) {
-                    return toolError('openapi_dump needs the root module. Add `rootModule: AppModule` to your vela.config.');
-                }
-                const info = {};
-                if (title)
-                    info.title = title;
-                if (apiVersion)
-                    info.version = apiVersion;
-                const document = createOpenApiDocument(rootModule, {
-                    globalPrefix: globalPrefix ?? app.getGlobalPrefix(),
-                    ...(Object.keys(info).length > 0 ? { info } : {}),
-                });
-                return jsonText(document);
-            });
-            server.registerTool('token_describe', {
-                description: 'Look a DI token STRING LABEL up across the module graph: which modules provide/export ' +
-                    'it and their scope flags, plus whether the string names a module. Read-only string ' +
-                    'match — does not resolve or construct the token.',
-                inputSchema: { token: z.string() },
-            }, ({ token }) => jsonText(describeToken(app, token)));
-            if (rootModule) {
-                server.registerResource('openapi', OPENAPI_URI, { description: 'The OpenAPI 3.1 document for the app.', mimeType: 'application/json' }, () => ({
-                    contents: [
-                        {
-                            uri: OPENAPI_URI,
-                            mimeType: 'application/json',
-                            text: JSON.stringify(createOpenApiDocument(rootModule, { globalPrefix: app.getGlobalPrefix() }), null, 2),
-                        },
-                    ],
-                }));
-            }
-            const transport = new StdioServerTransport();
-            const closed = new Promise((resolvePromise) => {
-                transport.onclose = resolvePromise;
-            });
-            await server.connect(transport);
-            log(`vela mcp serve — ready (5 tools${rootModule ? ' + vela://openapi resource' : ''}). ` +
-                'Awaiting client on stdio; stdout is JSON-RPC only.');
-            // Keep the process alive until the client disconnects; only then dispose.
-            await closed;
-            return 0;
-        }
-        finally {
-            const dispose = app.dispose;
-            if (typeof dispose === 'function') {
-                try {
-                    await dispose.call(app);
-                }
-                catch (error) {
-                    this.context.stderr.write(`Warning: teardown failed: ${String(error)}\n`);
-                }
-            }
-        }
-    }
-}

package/dist/commands/seed.command.d.ts

@@ -1,9 +0,0 @@
-import { Command } from 'clipanion';
-/** `vela db seed` — build the app from vela.config and run its seeders. */
-export declare class SeedCommand extends Command {
-    static paths: string[][];
-    static usage: import("clipanion").Usage;
-    config: string | undefined;
-    continueOnError: boolean;
-    execute(): Promise<number>;
-}

package/dist/commands/seed.command.js

@@ -1,40 +0,0 @@
-import { runSeeders } from '@velajs/vela/seeder';
-import { Command, Option } from 'clipanion';
-import { loadConfig } from '../config.js';
-import { formatSeedResults } from '../format.js';
-/** `vela db seed` — build the app from vela.config and run its seeders. */
-export class SeedCommand extends Command {
-    static paths = [['db', 'seed']];
-    static usage = Command.Usage({
-        category: 'Database',
-        description: 'Run database seeders for the Vela app.',
-        details: 'Loads vela.config.{js,mjs,ts}, builds the app, and runs all @Seeder() classes in order.',
-        examples: [
-            ['Run all seeders', 'vela db seed'],
-            ['Use a specific config', 'vela db seed --config ./config/vela.config.js'],
-        ],
-    });
-    config = Option.String('--config', { description: 'Path to the vela config file.' });
-    continueOnError = Option.Boolean('--continue-on-error', false, {
-        description: 'Run all seeders even if one fails.',
-    });
-    async execute() {
-        const { createApp } = await loadConfig(process.cwd(), this.config);
-        const app = await createApp();
-        this.context.stdout.write('Running seeders…\n');
-        const results = await runSeeders(app, { stopOnError: !this.continueOnError });
-        const code = formatSeedResults(results, (message) => this.context.stdout.write(`${message}\n`));
-        // Best-effort teardown (VelaApplication.dispose exists on recent versions).
-        // Must not clobber the computed exit code if a shutdown hook throws.
-        const dispose = app.dispose;
-        if (typeof dispose === 'function') {
-            try {
-                await dispose.call(app);
-            }
-            catch (error) {
-                this.context.stderr.write(`Warning: teardown failed after seeding: ${String(error)}\n`);
-            }
-        }
-        return code;
-    }
-}

package/dist/format.d.ts

@@ -1,8 +0,0 @@
-import type { SeederResult } from '@velajs/vela/seeder';
-/**
- * Render seeder results to a logger and return a process exit code
- * (0 = all ran, 1 = at least one failed). Pure — no I/O beyond the logger.
- */
-export declare function formatSeedResults(results: SeederResult[], log?: (message: string) => void): number;
-/** Aligned plain-text table. Pure; returns lines. */
-export declare function renderTable(headers: string[], rows: string[][]): string[];

package/dist/format.js

@@ -1,32 +0,0 @@
-/**
- * Render seeder results to a logger and return a process exit code
- * (0 = all ran, 1 = at least one failed). Pure — no I/O beyond the logger.
- */
-export function formatSeedResults(results, log = (m) => console.log(m)) {
-    if (results.length === 0) {
-        log('No seeders found.');
-        return 0;
-    }
-    let failed = 0;
-    for (const result of results) {
-        if (result.ok) {
-            log(`  ✓ ${result.name}`);
-        }
-        else {
-            failed++;
-            log(`  ✗ ${result.name}${result.error ? `: ${errorMessage(result.error)}` : ''}`);
-        }
-    }
-    const total = results.length;
-    log(`\n${total - failed}/${total} seeders ran successfully.`);
-    return failed > 0 ? 1 : 0;
-}
-function errorMessage(error) {
-    return error instanceof Error ? error.message : String(error);
-}
-/** Aligned plain-text table. Pure; returns lines. */
-export function renderTable(headers, rows) {
-    const widths = headers.map((h, i) => Math.max(h.length, ...rows.map((r) => (r[i] ?? '').length)));
-    const line = (cells) => cells.map((c, i) => (c ?? '').padEnd(widths[i])).join('  ').trimEnd();
-    return [line(headers), line(widths.map((w) => '-'.repeat(w))), ...rows.map(line)];
-}

package/dist/introspect.d.ts

@@ -1,32 +0,0 @@
-import type { VelaApplication } from '@velajs/vela';
-import type { ModuleDescription } from '@velajs/vela';
-/** One row of `vela route list`. */
-export interface RouteRow {
-    method: string;
-    path: string;
-    /** `Controller#handler`, or `(mounted)` for routes vela did not compose
-     * itself (RouteContributor/CRUD, OpenAPI UI mounts, manual Hono routes). */
-    handler: string;
-    source: 'controller' | 'mounted';
-}
-/**
- * The app's route table: `describeRoutes()` rows (framework-composed truth)
- * plus everything else present on the Hono router, deduped and labeled
- * `(mounted)`. Returns null when the app never built HTTP routes.
- */
-export declare function collectRoutes(app: VelaApplication): RouteRow[] | null;
-/** `vela module graph` tree lines (or raw descriptions for --json). */
-export declare function collectModules(app: VelaApplication): ModuleDescription[];
-export declare function renderModuleTree(modules: ModuleDescription[]): string[];
-/** One row of `vela entrypoint list`. */
-export interface EntrypointRow {
-    kind: string;
-    target: string;
-    meta: string;
-}
-/**
- * Every DECLARED entrypoint kind (from the global kind store — includes kinds
- * with zero entries) joined with the app's entries. Metadata-only entries of
- * lazy modules list fine; nothing materializes.
- */
-export declare function collectEntrypoints(app: VelaApplication): EntrypointRow[];