@voltro/cli 0.1.0

package/dist/frameworkInspectState-CX2250XB.js

@@ -0,0 +1,86 @@
+var e = new class {
+	#e = /* @__PURE__ */ new Map();
+	#t = /* @__PURE__ */ new Map();
+	#n;
+	#r = /* @__PURE__ */ new Set();
+	registerMigration(e) {
+		this.#e.has(e.definition.id) || (this.#e.set(e.definition.id, {
+			id: e.definition.id,
+			name: e.definition.name,
+			hash: e.hash,
+			status: "pending",
+			stepCount: e.definition.steps.length
+		}), this.#i());
+	}
+	recordMigrationStatus(e) {
+		for (let t of e) {
+			let e = this.#e.get(t.id);
+			e && this.#e.set(t.id, {
+				...e,
+				status: t.status,
+				...t.appliedAt ? { appliedAt: t.appliedAt.toISOString() } : {}
+			});
+		}
+		this.#i();
+	}
+	recordMigrationResult(e) {
+		let t = this.#e.get(e.migrationId);
+		t && (this.#e.set(e.migrationId, {
+			...t,
+			status: e.status === "applied" ? "applied" : e.status === "failed" ? "failed" : t.status,
+			durationMs: e.durationMs,
+			...e.error ? { lastError: {
+				stepName: e.error.stepName,
+				message: e.error.message
+			} } : {}
+		}), this.#i());
+	}
+	registerSeed(e) {
+		this.#t.has(e.definition.id) || (this.#t.set(e.definition.id, {
+			id: e.definition.id,
+			name: e.definition.name,
+			lifecycle: e.definition.lifecycle,
+			fingerprint: e.fingerprint,
+			...e.definition.cron ? { cron: e.definition.cron } : {},
+			...e.definition.watchedTables ? { watchedTables: e.definition.watchedTables } : {}
+		}), this.#i());
+	}
+	recordSeedResult(e) {
+		let t = this.#t.get(e.seedId);
+		t && (this.#t.set(e.seedId, {
+			...t,
+			lastRunStatus: e.status,
+			lastRunAt: (/* @__PURE__ */ new Date()).toISOString(),
+			lastRunDurationMs: e.durationMs,
+			lastRunRowsTouched: e.rowsTouched,
+			...e.error ? { lastError: {
+				message: e.error.message,
+				...e.error.stepName ? { stepName: e.error.stepName } : {}
+			} } : {}
+		}), this.#i());
+	}
+	recordReplication(e) {
+		this.#n = e, this.#i();
+	}
+	replicationSnapshot() {
+		return this.#n;
+	}
+	migrationsSnapshot() {
+		return [...this.#e.values()].sort((e, t) => e.id < t.id ? -1 : 1);
+	}
+	seedsSnapshot() {
+		return [...this.#t.values()].sort((e, t) => e.id < t.id ? -1 : 1);
+	}
+	onChange(e) {
+		return this.#r.add(e), () => {
+			this.#r.delete(e);
+		};
+	}
+	#i() {
+		for (let e of this.#r) try {
+			e();
+		} catch {}
+	}
+}();
+//#endregion
+export { e as t };

package/dist/index.d.ts

@@ -0,0 +1,48 @@
+export declare const CLI_NAME: "framework";
+
+export declare const COMMANDS: ReadonlyArray<CommandSpec>;
+
+export declare type CommandSpec = {
+    readonly name: string;
+    readonly summary: string;
+    readonly status: 'wired' | 'stub';
+    readonly run: (args: ReadonlyArray<string>) => Promise<number>;
+};
+
+export declare const dispatch: (argv: ReadonlyArray<string>) => Promise<number>;
+
+/**
+ * Enumerate all valid templates under TEMPLATES_ROOT. Sorted by id
+ * for stable output in `voltro list-templates`.
+ */
+export declare const listTemplates: () => Promise<ReadonlyArray<TemplateInfo>>;
+
+export declare const printUsage: () => void;
+
+export declare interface TemplateInfo extends TemplateManifest {
+    /** Absolute path to the template source directory. */
+    readonly path: string;
+}
+
+/** What a template scaffolds:
+ *  - `api`  — a long-running backend (app.config `type: 'api'`).
+ *  - `web`  — a frontend (app.config `type: 'web'`); gets a dev-server port.
+ *  - `serverless` — a standalone `*.serverless.ts` function bundle deployed
+ *    SEPARATELY via `voltro serverless` (no long-running server, no port). */
+declare type TemplateKind = 'api' | 'web' | 'serverless';
+
+declare interface TemplateManifest {
+    /** Stable id matching the directory name. */
+    readonly id: string;
+    /** What kind of app this scaffolds. Used by the cli for sanity
+     *  checks (`add-app --template api-backend` against an existing
+     *  apps/<project>/api/ rejects) + port allocation (web only). */
+    readonly kind: TemplateKind;
+    /** One-line summary printed by `voltro list-templates`. */
+    readonly summary: string;
+    /** Free-form tags surfaced by `voltro list-templates`; helpful for
+     *  filtering ("landing", "docs", "cms", "dashboard", "blank"). */
+    readonly tags?: ReadonlyArray<string>;
+}
+
+export { }

package/dist/index.js

@@ -0,0 +1,5 @@
+import { i as e, n as t, r as n, t as r } from "./commands-CfPH2Wf4.js";
+//#region src/index.ts
+var i = "framework";
+//#endregion
+export { i as CLI_NAME, r as COMMANDS, t as dispatch, e as listTemplates, n as printUsage };

package/dist/inspectState.d.ts

@@ -0,0 +1,116 @@
+import { MigrationDefinition } from '@voltro/database';
+import { SeedDefinition } from '@voltro/database';
+
+declare interface DiscoveredMigration {
+    readonly file: string;
+    readonly definition: MigrationDefinition;
+    /** Sha256 (truncated) of the source file. Stored on the migration row so
+     *  drift between a committed migration file and the deployed one is detectable. */
+    readonly hash: string;
+}
+
+declare interface DiscoveredSeed {
+    readonly file: string;
+    readonly definition: SeedDefinition;
+    readonly fingerprint: string;
+}
+
+declare class FrameworkInspectState {
+    #private;
+    registerMigration(m: DiscoveredMigration): void;
+    recordMigrationStatus(rows: ReadonlyArray<MigrationStatus>): void;
+    recordMigrationResult(result: MigrationResult): void;
+    registerSeed(s: DiscoveredSeed): void;
+    recordSeedResult(result: SeedRunResult): void;
+    recordReplication(snapshot: ReplicationSnapshot): void;
+    replicationSnapshot(): ReplicationSnapshot | undefined;
+    migrationsSnapshot(): ReadonlyArray<MigrationSnapshot>;
+    seedsSnapshot(): ReadonlyArray<SeedSnapshot>;
+    onChange(listener: () => void): () => void;
+}
+
+/** Process-global state — one runtime, one set of migrations + seeds. */
+export declare const frameworkInspectState: FrameworkInspectState;
+
+declare interface MigrationResult {
+    readonly migrationId: string;
+    readonly status: 'applied' | 'failed' | 'skipped';
+    readonly durationMs: number;
+    readonly steps: ReadonlyArray<MigrationStepResult>;
+    readonly error?: {
+        stepName: string;
+        message: string;
+        stack?: string;
+    };
+}
+
+export declare interface MigrationSnapshot {
+    readonly id: string;
+    readonly name: string;
+    readonly hash: string;
+    readonly status: 'pending' | 'applied' | 'failed' | 'reverted';
+    readonly appliedAt?: string;
+    readonly durationMs?: number;
+    readonly stepCount: number;
+    readonly lastError?: {
+        stepName: string;
+        message: string;
+    };
+}
+
+declare interface MigrationStatus {
+    readonly id: string;
+    readonly name: string;
+    readonly status: 'pending' | 'applied' | 'failed' | 'reverted';
+    readonly appliedAt: Date | null;
+    readonly hashMatches: boolean;
+}
+
+declare interface MigrationStepResult {
+    readonly stepName: string;
+    readonly status: 'applied' | 'failed';
+    readonly durationMs: number;
+    readonly error?: {
+        message: string;
+        stack?: string;
+    };
+}
+
+export declare interface ReplicationSnapshot {
+    readonly replicaCount: number;
+    readonly rywPolicy: 'off' | 'fallback' | 'wait';
+    readonly rywStore: 'memory' | 'redis';
+    readonly region: string | null;
+    readonly localityEnabled: boolean;
+}
+
+declare interface SeedRunResult {
+    readonly seedId: string;
+    readonly status: 'succeeded' | 'failed';
+    readonly durationMs: number;
+    readonly rowsTouched: number;
+    readonly error?: {
+        message: string;
+        stack?: string;
+        stepName?: string;
+    };
+}
+
+export declare interface SeedSnapshot {
+    readonly id: string;
+    readonly name: string;
+    readonly lifecycle: string;
+    readonly fingerprint: string;
+    readonly cron?: string;
+    readonly watchedTables?: ReadonlyArray<string>;
+    readonly lastRunStatus?: 'succeeded' | 'failed';
+    readonly lastRunAt?: string;
+    readonly lastRunDurationMs?: number;
+    readonly lastRunRowsTouched?: number;
+    readonly lastError?: {
+        message: string;
+        stepName?: string;
+    };
+}
+
+export { }

package/dist/inspectState.js

@@ -0,0 +1,2 @@
+import { t as e } from "./frameworkInspectState-CX2250XB.js";
+export { e as frameworkInspectState };

package/dist/startup.d.ts

@@ -0,0 +1,26 @@
+import { DataStore } from '@voltro/runtime';
+import { StartupContext } from '@voltro/runtime';
+import { StartupFn } from '@voltro/runtime';
+import { SyncLogger } from '@voltro/logger';
+
+export declare interface DiscoveredStartup {
+    readonly file: string;
+    readonly id: string;
+    readonly fn: StartupFn;
+}
+
+export declare const loadStartupFiles: (files: ReadonlyArray<string>, log: SyncLogger) => Promise<ReadonlyArray<DiscoveredStartup>>;
+
+/** Run every discovered startup. Returns a handle whose `shutdown()`
+ *  drains every registered teardown LIFO. */
+export declare const runStartups: (startups: ReadonlyArray<DiscoveredStartup>, store: DataStore, parentLog: SyncLogger) => Promise<StartupHandle>;
+
+export { StartupContext }
+
+export { StartupFn }
+
+export declare interface StartupHandle {
+    readonly shutdown: () => Promise<void>;
+}
+
+export { }

package/dist/startup.js

@@ -0,0 +1,2 @@
+import { n as e, t } from "./startupRunner-CRhuUl91.js";
+export { t as loadStartupFiles, e as runStartups };

package/dist/startupRunner-CRhuUl91.js

@@ -0,0 +1,71 @@
+import { basename as e } from "node:path";
+import { pathToFileURL as t } from "node:url";
+import { publishServerError as n } from "@voltro/protocol";
+//#region src/startupRunner.ts
+var r = (e) => e.replace(/\.startup\.tsx?$/, ""), i = async (n, i) => {
+	let a = [];
+	for (let o of n) {
+		let n;
+		try {
+			n = await import(t(o).href);
+		} catch (e) {
+			i.warn("startup: failed to import", { file: o }, e);
+			continue;
+		}
+		let s = n.default;
+		if (typeof s != "function") {
+			i.warn("startup: no default-export function", { file: o });
+			continue;
+		}
+		a.push({
+			file: o,
+			id: r(e(o)),
+			fn: s
+		});
+	}
+	return a;
+}, a = async (e, t, r) => {
+	let i = [];
+	for (let a of e) {
+		let e = r.child(`startup:${a.id}`), o = {
+			store: t,
+			log: e,
+			id: a.id,
+			onShutdown: (e) => {
+				i.push({
+					id: a.id,
+					cb: e
+				});
+			}
+		};
+		try {
+			let t = a.fn(o);
+			t instanceof Promise && await Promise.race([t.catch((t) => {
+				e.warn("startup: function rejected", {}, t), n({
+					error: t,
+					source: "startup",
+					name: a.id
+				});
+			}), new Promise((e) => setTimeout(e, 2e3))]), e.info("startup: registered");
+		} catch (t) {
+			e.warn("startup: synchronous error during boot", {}, t), n({
+				error: t,
+				source: "startup",
+				name: a.id
+			});
+		}
+	}
+	return { shutdown: async () => {
+		for (let e = i.length - 1; e >= 0; e--) {
+			let { id: t, cb: n } = i[e], a = r.child(`startup:${t}`);
+			try {
+				let e = n();
+				e instanceof Promise && await Promise.race([e, new Promise((e) => setTimeout(e, 5e3))]);
+			} catch (e) {
+				a.warn("startup: teardown threw", {}, e);
+			}
+		}
+	} };
+};
+//#endregion
+export { a as n, i as t };

package/package.json

@@ -0,0 +1,88 @@
+{
+  "name": "@voltro/cli",
+  "version": "0.1.0",
+  "description": "The `voltro` CLI — dev server, codegen, migrations, project scaffolding, agent-docs seeding, and production serve.",
+  "keywords": [
+    "voltro",
+    "typescript",
+    "framework"
+  ],
+  "license": "SEE LICENSE IN LICENSE",
+  "homepage": "https://voltro.dev",
+  "bugs": {
+    "email": "support@voltro.dev"
+  },
+  "author": {
+    "name": "Voltro UG",
+    "url": "https://voltro.dev"
+  },
+  "type": "module",
+  "bin": {
+    "voltro": "./bin/voltro.mjs"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
+    },
+    "./inspectState": {
+      "types": "./dist/inspectState.d.ts",
+      "import": "./dist/inspectState.js",
+      "default": "./dist/inspectState.js"
+    },
+    "./startup": {
+      "types": "./dist/startup.d.ts",
+      "import": "./dist/startup.js",
+      "default": "./dist/startup.js"
+    }
+  },
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "engines": {
+    "node": ">=24.0.0"
+  },
+  "dependencies": {
+    "@effect/platform-node": "^0.107.0",
+    "@effect/sql": "^0.51.1",
+    "@effect/workflow": "^0.18.2",
+    "@tailwindcss/vite": "^4.3.2",
+    "@vitejs/plugin-react": "^6.0.3",
+    "@voltro/ai": "0.1.0",
+    "@voltro/cache": "0.1.0",
+    "@voltro/data-transfer": "0.1.0",
+    "@voltro/database": "0.1.0",
+    "@voltro/env": "0.1.0",
+    "@voltro/kv": "0.1.0",
+    "@voltro/logger": "0.1.0",
+    "@voltro/plugin-auth": "0.1.0",
+    "@voltro/plugin-broadcast": "0.1.0",
+    "@voltro/plugin-mail": "0.1.0",
+    "@voltro/plugin-storage": "0.1.0",
+    "@voltro/plugin-webhooks": "0.1.0",
+    "@voltro/protocol": "0.1.0",
+    "@voltro/runtime": "0.1.0",
+    "@voltro/serverless": "0.1.0",
+    "@voltro/sql-mssql": "0.1.0",
+    "@voltro/sql-mysql": "0.1.0",
+    "@voltro/sql-postgres": "0.1.0",
+    "@voltro/sql-sqlite": "0.1.0",
+    "@voltro/sql-turso": "0.1.0",
+    "@voltro/workflow": "0.1.0",
+    "chokidar": "^5.0.0",
+    "esbuild": "^0.28.0",
+    "ioredis": "^5.11.1",
+    "pg": "^8.22.0",
+    "tsx": "^4.23.0",
+    "vite": "^8.1.4"
+  },
+  "peerDependencies": {
+    "@effect/platform": "^0.96.2",
+    "@effect/rpc": "^0.75.1",
+    "effect": "^3.21.4"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}