@tulipes/core 0.1.0

package/dist/boot/boot.js.map

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

package/dist/boot/contracts.d.ts

@@ -0,0 +1,47 @@
+import type { Express, Router } from "express";
+import type { Environment } from "../env/environment.js";
+import type { GlobalConfig } from "../config/index.js";
+import type { Acl } from "../acl/acl.js";
+import type { ModelStore } from "../db/model-store.js";
+import type { QueueManager } from "../queues/queue-manager.js";
+import type { SocketManager } from "../sockets/socket-manager.js";
+/**
+ * The context object threaded through every module-authored function.
+ * Later-phase members only exist once their phase has run: config factories
+ * (phase 6) see neither `acl` (phase 7) nor `app` (web branch, phase 9).
+ */
+export interface Ctx {
+    Environment: Environment;
+    config: GlobalConfig;
+    acl?: Acl;
+    models?: ModelStore;
+    queues?: QueueManager;
+    sockets?: SocketManager;
+    app?: Express;
+}
+/**
+ * Default export of `module.config.ts`. Returns the module's config
+ * namespace (stored at `config.<module>`); returning nothing is a valid
+ * "this module has no config" answer.
+ *
+ * Factories run in load order against the growing global config, so a
+ * module can read the namespaces of everything it `dependsOn`.
+ */
+export type ModuleConfigFn = (ctx: Ctx) => Record<string, unknown> | void | Promise<Record<string, unknown> | void>;
+export type LifecycleHook = (ctx: Ctx) => void | Promise<void>;
+/**
+ * Optional named exports of `module.config.ts`:
+ *   onReady    — after the process is fully up (server listening / worker consuming)
+ *   onShutdown — graceful shutdown, invoked in REVERSE load order
+ */
+export interface ModuleLifecycle {
+    module: string;
+    onReady?: LifecycleHook;
+    onShutdown?: LifecycleHook;
+}
+/**
+ * Default export of `routes/*.routes.ts` (web branch only). May mount
+ * directly on `ctx.app`, or return a Router for core to `app.use()` —
+ * returning one is the recommended style.
+ */
+export type RoutesFn = (ctx: Ctx) => Router | void | Promise<Router | void>;

package/dist/boot/contracts.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=contracts.js.map

package/dist/boot/contracts.js.map

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

package/dist/boot/import-file.d.ts

@@ -0,0 +1,7 @@
+import { BootReport, type BootScope } from "../errors/boot-error.js";
+/**
+ * Dynamic-import one conventional module file, funneling failures into the
+ * boot report instead of letting a single broken file produce a bare stack
+ * trace. Returns undefined on failure so callers can keep collecting.
+ */
+export declare function importFile<T extends object = Record<string, unknown>>(filePath: string, scope: BootScope, moduleName: string, report: BootReport): Promise<T | undefined>;

package/dist/boot/import-file.js

@@ -0,0 +1,23 @@
+import { pathToFileURL } from "node:url";
+import { BootReport } from "../errors/boot-error.js";
+/**
+ * Dynamic-import one conventional module file, funneling failures into the
+ * boot report instead of letting a single broken file produce a bare stack
+ * trace. Returns undefined on failure so callers can keep collecting.
+ */
+export async function importFile(filePath, scope, moduleName, report) {
+    try {
+        // pathToFileURL: plain absolute paths are not valid ESM specifiers on
+        // every platform (Windows drive letters parse as URL schemes).
+        return (await import(pathToFileURL(filePath).href));
+    }
+    catch (error) {
+        report.add({
+            scope,
+            module: moduleName,
+            message: `failed to import ${filePath}: ${error.message}`,
+        });
+        return undefined;
+    }
+}
+//# sourceMappingURL=import-file.js.map

package/dist/boot/import-file.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"import-file.js","sourceRoot":"","sources":["../../src/boot/import-file.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAEzC,OAAO,EAAE,UAAU,EAAkB,MAAM,yBAAyB,CAAC;AAErE;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,UAAU,CAC9B,QAAgB,EAChB,KAAgB,EAChB,UAAkB,EAClB,MAAkB;IAElB,IAAI,CAAC;QACH,sEAAsE;QACtE,+DAA+D;QAC/D,OAAO,CAAC,MAAM,MAAM,CAAC,aAAa,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,CAAM,CAAC;IAC3D,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,CAAC,GAAG,CAAC;YACT,KAAK;YACL,MAAM,EAAE,UAAU;YAClB,OAAO,EAAE,oBAAoB,QAAQ,KAAM,KAAe,CAAC,OAAO,EAAE;SACrE,CAAC,CAAC;QACH,OAAO,SAAS,CAAC;IACnB,CAAC;AACH,CAAC"}

package/dist/boot/index.d.ts

@@ -0,0 +1,3 @@
+export { boot, processModes, type BootHandle, type BootOptions, type ProcessMode } from "./boot.js";
+export type { AppConfigFn } from "./app-files.js";
+export type { Ctx, LifecycleHook, ModuleConfigFn, ModuleLifecycle, RoutesFn, } from "./contracts.js";

package/dist/boot/index.js

@@ -0,0 +1,2 @@
+export { boot, processModes } from "./boot.js";
+//# sourceMappingURL=index.js.map

package/dist/boot/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/boot/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,YAAY,EAAuD,MAAM,WAAW,CAAC"}

package/dist/cli/bin.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/cli/bin.js

@@ -0,0 +1,7 @@
+#!/usr/bin/env node
+// Published bin entry — compiled to dist/cli/bin.js. The dev workspace uses
+// bin/tulipes.js (a tsx shim over the same main) instead; publishConfig.bin
+// swaps this one in at pack time.
+import { main } from "./main.js";
+await main(process.argv.slice(2));
+//# sourceMappingURL=bin.js.map

package/dist/cli/bin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bin.js","sourceRoot":"","sources":["../../src/cli/bin.ts"],"names":[],"mappings":";AACA,4EAA4E;AAC5E,4EAA4E;AAC5E,kCAAkC;AAClC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,MAAM,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC"}

package/dist/cli/dev.d.ts

@@ -0,0 +1,8 @@
+/**
+ * `tulipes dev [entry]` — sync first (generated types must never be stale
+ * when the dev server starts), then hand off to tsx in watch mode.
+ *
+ * tsx is resolved from core's own dependencies rather than trusting PATH,
+ * so the command works in any workspace layout.
+ */
+export declare function runDev(rootDir: string, entry: string): Promise<void>;

package/dist/cli/dev.js

@@ -0,0 +1,22 @@
+import { spawn } from "node:child_process";
+import { createRequire } from "node:module";
+import { dirname, join } from "node:path";
+import { runSync } from "./sync.js";
+/**
+ * `tulipes dev [entry]` — sync first (generated types must never be stale
+ * when the dev server starts), then hand off to tsx in watch mode.
+ *
+ * tsx is resolved from core's own dependencies rather than trusting PATH,
+ * so the command works in any workspace layout.
+ */
+export async function runDev(rootDir, entry) {
+    await runSync(rootDir);
+    const require = createRequire(import.meta.url);
+    const tsxPackage = require.resolve("tsx/package.json");
+    const tsxCli = join(dirname(tsxPackage), "dist", "cli.mjs");
+    const child = spawn(process.execPath, [tsxCli, "watch", "--clear-screen=false", entry], { cwd: rootDir, stdio: "inherit" });
+    child.on("exit", (code) => {
+        process.exitCode = code ?? 0;
+    });
+}
+//# sourceMappingURL=dev.js.map

package/dist/cli/dev.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dev.js","sourceRoot":"","sources":["../../src/cli/dev.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAC3C,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAE1C,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,MAAM,CAAC,OAAe,EAAE,KAAa;IACzD,MAAM,OAAO,CAAC,OAAO,CAAC,CAAC;IAEvB,MAAM,OAAO,GAAG,aAAa,CAAC,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC;IAC/C,MAAM,UAAU,GAAG,OAAO,CAAC,OAAO,CAAC,kBAAkB,CAAC,CAAC;IACvD,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,EAAE,MAAM,EAAE,SAAS,CAAC,CAAC;IAE5D,MAAM,KAAK,GAAG,KAAK,CACjB,OAAO,CAAC,QAAQ,EAChB,CAAC,MAAM,EAAE,OAAO,EAAE,sBAAsB,EAAE,KAAK,CAAC,EAChD,EAAE,GAAG,EAAE,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,CACnC,CAAC;IACF,KAAK,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,EAAE;QACxB,OAAO,CAAC,QAAQ,GAAG,IAAI,IAAI,CAAC,CAAC;IAC/B,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/cli/env-check.d.ts

@@ -0,0 +1,6 @@
+/**
+ * `tulipes env:check` — boot phases 1–3 and nothing else: validate the
+ * current environment against every module's declared contract, print the
+ * verdict, exit accordingly. Built for CI gates and deploy preflights.
+ */
+export declare function runEnvCheck(rootDir: string): Promise<void>;

package/dist/cli/env-check.js

@@ -0,0 +1,28 @@
+import { Environment } from "../env/environment.js";
+import { TulipesBootError } from "../errors/boot-error.js";
+/**
+ * `tulipes env:check` — boot phases 1–3 and nothing else: validate the
+ * current environment against every module's declared contract, print the
+ * verdict, exit accordingly. Built for CI gates and deploy preflights.
+ */
+export async function runEnvCheck(rootDir) {
+    let env;
+    try {
+        env = Environment.load({ rootDir });
+    }
+    catch (error) {
+        if (error instanceof TulipesBootError) {
+            console.error(error.message);
+            process.exitCode = 1;
+            return;
+        }
+        throw error;
+    }
+    const snapshot = env.store.snapshot(); // secrets redacted
+    const names = Object.keys(snapshot);
+    console.log(`APP_ENV=${env.appEnv} — ${names.length} variable(s) resolved:`);
+    for (const name of names) {
+        console.log(`  ✔ ${name}=${String(snapshot[name])}`);
+    }
+}
+//# sourceMappingURL=env-check.js.map

package/dist/cli/env-check.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"env-check.js","sourceRoot":"","sources":["../../src/cli/env-check.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AACpD,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAE3D;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,OAAe;IAC/C,IAAI,GAAG,CAAC;IACR,IAAI,CAAC;QACH,GAAG,GAAG,WAAW,CAAC,IAAI,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC;IACtC,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,KAAK,YAAY,gBAAgB,EAAE,CAAC;YACtC,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;YAC7B,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;YACrB,OAAO;QACT,CAAC;QACD,MAAM,KAAK,CAAC;IACd,CAAC;IAED,MAAM,QAAQ,GAAG,GAAG,CAAC,KAAK,CAAC,QAAQ,EAAE,CAAC,CAAC,mBAAmB;IAC1D,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IACpC,OAAO,CAAC,GAAG,CAAC,WAAW,GAAG,CAAC,MAAM,MAAM,KAAK,CAAC,MAAM,wBAAwB,CAAC,CAAC;IAC7E,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,OAAO,CAAC,GAAG,CAAC,OAAO,IAAI,IAAI,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC,CAAC;IACvD,CAAC;AACH,CAAC"}

package/dist/cli/main.d.ts

@@ -0,0 +1 @@
+export declare function main(argv: readonly string[]): Promise<void>;

package/dist/cli/main.js

@@ -0,0 +1,45 @@
+import { runSync } from "./sync.js";
+import { runEnvCheck } from "./env-check.js";
+import { runNewModule } from "./new-module.js";
+import { runDev } from "./dev.js";
+/**
+ * The `tulipes` CLI. Deliberately dependency-free argument handling — four
+ * commands don't justify a parser library.
+ * All commands operate on the app in the current working directory.
+ */
+const HELP = `tulipes — module-based express framework
+
+Usage:
+  tulipes sync                 regenerate types/config.d.ts and .env.example
+  tulipes env:check            validate env against every meta.variables.json (CI-friendly)
+  tulipes new module <name>    scaffold a module under ./modules
+  tulipes dev [entry]          run with tsx in watch mode (default entry: app.ts), sync first
+`;
+export async function main(argv) {
+    const [command, ...rest] = argv;
+    const rootDir = process.cwd();
+    switch (command) {
+        case "sync":
+            return runSync(rootDir);
+        case "env:check":
+            return runEnvCheck(rootDir);
+        case "new":
+            if (rest[0] !== "module" || !rest[1]) {
+                console.error('Usage: tulipes new module <name>');
+                process.exitCode = 2;
+                return;
+            }
+            return runNewModule(rootDir, rest[1]);
+        case "dev":
+            return runDev(rootDir, rest[0] ?? "app.ts");
+        case undefined:
+        case "help":
+        case "--help":
+            console.log(HELP);
+            return;
+        default:
+            console.error(`Unknown command "${command}"\n\n${HELP}`);
+            process.exitCode = 2;
+    }
+}
+//# sourceMappingURL=main.js.map

package/dist/cli/main.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"main.js","sourceRoot":"","sources":["../../src/cli/main.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAC7C,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAC/C,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAElC;;;;GAIG;AACH,MAAM,IAAI,GAAG;;;;;;;CAOZ,CAAC;AAEF,MAAM,CAAC,KAAK,UAAU,IAAI,CAAC,IAAuB;IAChD,MAAM,CAAC,OAAO,EAAE,GAAG,IAAI,CAAC,GAAG,IAAI,CAAC;IAChC,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC;IAE9B,QAAQ,OAAO,EAAE,CAAC;QAChB,KAAK,MAAM;YACT,OAAO,OAAO,CAAC,OAAO,CAAC,CAAC;QAC1B,KAAK,WAAW;YACd,OAAO,WAAW,CAAC,OAAO,CAAC,CAAC;QAC9B,KAAK,KAAK;YACR,IAAI,IAAI,CAAC,CAAC,CAAC,KAAK,QAAQ,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;gBACrC,OAAO,CAAC,KAAK,CAAC,kCAAkC,CAAC,CAAC;gBAClD,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;gBACrB,OAAO;YACT,CAAC;YACD,OAAO,YAAY,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;QACxC,KAAK,KAAK;YACR,OAAO,MAAM,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC,CAAC,IAAI,QAAQ,CAAC,CAAC;QAC9C,KAAK,SAAS,CAAC;QACf,KAAK,MAAM,CAAC;QACZ,KAAK,QAAQ;YACX,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;YAClB,OAAO;QACT;YACE,OAAO,CAAC,KAAK,CAAC,oBAAoB,OAAO,QAAQ,IAAI,EAAE,CAAC,CAAC;YACzD,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;IACzB,CAAC;AACH,CAAC"}

package/dist/cli/new-module.d.ts

@@ -0,0 +1,6 @@
+/**
+ * `tulipes new module <name>` — scaffold the full module skeleton. The scope
+ * is borrowed from an existing sibling module so the app keeps one naming
+ * convention without configuring it anywhere.
+ */
+export declare function runNewModule(rootDir: string, name: string): Promise<void>;

package/dist/cli/new-module.js

@@ -0,0 +1,84 @@
+import { existsSync, mkdirSync, readFileSync, readdirSync, writeFileSync } from "node:fs";
+import { join } from "node:path";
+/**
+ * `tulipes new module <name>` — scaffold the full module skeleton. The scope
+ * is borrowed from an existing sibling module so the app keeps one naming
+ * convention without configuring it anywhere.
+ */
+export async function runNewModule(rootDir, name) {
+    if (!/^[a-z][a-z0-9-]*$/.test(name)) {
+        console.error(`module name "${name}" is invalid — lowercase kebab-case required`);
+        process.exitCode = 2;
+        return;
+    }
+    const modulesDir = join(rootDir, "modules");
+    const dir = join(modulesDir, name);
+    if (existsSync(dir)) {
+        console.error(`modules/${name} already exists`);
+        process.exitCode = 1;
+        return;
+    }
+    const scope = detectScope(modulesDir) ?? "@app";
+    mkdirSync(join(dir, "routes"), { recursive: true });
+    write(dir, "package.json", JSON.stringify({
+        name: `${scope}/${name}`,
+        version: "0.0.0",
+        private: true,
+        type: "module",
+        tulipes: { tier: "app", priority: 100, dependsOn: [] },
+        dependencies: { "@tulipes/core": "workspace:*", express: "^5" },
+    }, null, 2) + "\n");
+    write(dir, "meta.variables.json", JSON.stringify({ variables: [] }, null, 2) + "\n");
+    write(dir, "module.config.ts", [
+        `import type { Ctx } from "@tulipes/core/boot";`,
+        ``,
+        `export default function ${camel(name)}Config(_ctx: Ctx) {`,
+        `  return {};`,
+        `}`,
+        ``,
+    ].join("\n"));
+    write(dir, join("routes", `${name}.routes.ts`), [
+        `import { Router } from "express";`,
+        `import type { Ctx } from "@tulipes/core/boot";`,
+        ``,
+        `export default function ${camel(name)}Routes(_ctx: Ctx): Router {`,
+        `  const router = Router();`,
+        ``,
+        `  router.get("/${name}/ping", (_req, res) => {`,
+        `    res.json({ module: "${name}" });`,
+        `  });`,
+        ``,
+        `  return router;`,
+        `}`,
+        ``,
+    ].join("\n"));
+    console.log(`scaffolded modules/${name} (${scope}/${name})`);
+    console.log(`next: yarn install && tulipes sync`);
+}
+function detectScope(modulesDir) {
+    let entries;
+    try {
+        entries = readdirSync(modulesDir);
+    }
+    catch {
+        return undefined;
+    }
+    for (const entry of entries) {
+        try {
+            const pkg = JSON.parse(readFileSync(join(modulesDir, entry, "package.json"), "utf8"));
+            if (pkg.name?.startsWith("@"))
+                return pkg.name.split("/")[0];
+        }
+        catch {
+            continue; // not a module folder
+        }
+    }
+    return undefined;
+}
+function write(dir, file, content) {
+    writeFileSync(join(dir, file), content);
+}
+function camel(kebab) {
+    return kebab.replace(/-([a-z])/g, (_, c) => c.toUpperCase());
+}
+//# sourceMappingURL=new-module.js.map

package/dist/cli/new-module.js.map

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

package/dist/cli/sync.d.ts

@@ -0,0 +1,12 @@
+/**
+ * `tulipes sync` — everything derivable from the meta files, derived:
+ *
+ *   types/config.d.ts  KnownVariables + GlobalConfig augmentations. Config
+ *                      namespaces are typed as each factory's RETURN TYPE via
+ *                      `typeof import(...)` — the compiler does the inference,
+ *                      codegen never executes module code.
+ *   .env.example       every variable, grouped by module and `group`.
+ *
+ * Both files are committed and marked generated.
+ */
+export declare function runSync(rootDir: string): Promise<void>;

package/dist/cli/sync.js

@@ -0,0 +1,117 @@
+import { mkdirSync, writeFileSync } from "node:fs";
+import { join, relative } from "node:path";
+import { BootReport } from "../errors/boot-error.js";
+import { discoverModuleMeta } from "../env/meta-discovery.js";
+import { discoverModules } from "../modules/discovery.js";
+import { sortModules } from "../modules/graph.js";
+import { exploreModules } from "../modules/explorer.js";
+/**
+ * `tulipes sync` — everything derivable from the meta files, derived:
+ *
+ *   types/config.d.ts  KnownVariables + GlobalConfig augmentations. Config
+ *                      namespaces are typed as each factory's RETURN TYPE via
+ *                      `typeof import(...)` — the compiler does the inference,
+ *                      codegen never executes module code.
+ *   .env.example       every variable, grouped by module and `group`.
+ *
+ * Both files are committed and marked generated.
+ */
+export async function runSync(rootDir) {
+    const report = new BootReport();
+    const modulesDir = join(rootDir, "modules");
+    const metas = discoverModuleMeta(modulesDir, report);
+    const order = sortModules(discoverModules(modulesDir, report), report);
+    report.throwIfAny("sync");
+    const metaByModule = new Map(metas.map((meta) => [meta.module, meta]));
+    // Meta discovery walks folders; align it to load order for stable output.
+    const orderedMetas = order
+        .map((module) => metaByModule.get(module.name))
+        .filter((meta) => meta !== undefined);
+    const typesDir = join(rootDir, "types");
+    mkdirSync(typesDir, { recursive: true });
+    const dtsPath = join(typesDir, "config.d.ts");
+    writeFileSync(dtsPath, renderDts(rootDir, orderedMetas, order));
+    console.log(`wrote ${relative(rootDir, dtsPath)}`);
+    const envExamplePath = join(rootDir, ".env.example");
+    writeFileSync(envExamplePath, renderEnvExample(orderedMetas));
+    console.log(`wrote ${relative(rootDir, envExamplePath)}`);
+}
+function renderDts(rootDir, metas, order) {
+    const variableLines = metas.flatMap((meta) => meta.variables.flatMap((spec) => [
+        `    /** [${meta.module}] ${spec.description} */`,
+        `    ${spec.name}: ${tsTypeOf(spec)};`,
+    ]));
+    // Only modules with a config factory get a typed namespace; the rest fall
+    // back to GlobalConfig's index signature.
+    const configLines = exploreModules(order)
+        .filter((files) => files.configFile)
+        .flatMap((files) => {
+        const specifier = "./" + relative(join(rootDir, "types"), files.configFile).replace(/\.ts$/, ".js");
+        // Optional on purpose: a namespace only exists once phase 6 has run
+        // its factory, and an empty config seed must stay assignable.
+        return [
+            `    ${files.module.name}?: Awaited<`,
+            `      ReturnType<(typeof import("${specifier}"))["default"]>`,
+            `    >;`,
+        ];
+    });
+    return [
+        "// AUTO-GENERATED by `tulipes sync` — do not edit.",
+        "",
+        'declare module "@tulipes/core/env" {',
+        "  interface KnownVariables {",
+        ...variableLines,
+        "  }",
+        "}",
+        "",
+        'declare module "@tulipes/core/config" {',
+        "  interface GlobalConfig {",
+        ...configLines,
+        "  }",
+        "}",
+        "",
+        "export {};",
+        "",
+    ].join("\n");
+}
+function tsTypeOf(spec) {
+    switch (spec.type) {
+        case "number":
+            return "number";
+        case "boolean":
+            return "boolean";
+        case "enum":
+            return spec.enum.map((value) => JSON.stringify(value)).join(" | ");
+        default: // string, url, secret
+            return "string";
+    }
+}
+function renderEnvExample(metas) {
+    const lines = [
+        "# AUTO-GENERATED by `tulipes sync` from every module's meta.variables.json.",
+        "# Copy into .envs/.env.<mode> and fill in the blanks.",
+    ];
+    for (const meta of metas) {
+        if (meta.variables.length === 0)
+            continue;
+        lines.push("", `# ━━━ ${meta.module} ━━━`);
+        // Stable grouping: order of first appearance, ungrouped vars last.
+        const groups = new Map();
+        for (const spec of meta.variables) {
+            const key = spec.group ?? "";
+            (groups.get(key) ?? groups.set(key, []).get(key)).push(spec);
+        }
+        for (const [group, specs] of [...groups.entries()].sort(([a], [b]) => Number(a === "") - Number(b === ""))) {
+            if (group)
+                lines.push("", `# ── ${group} ──`);
+            for (const spec of specs) {
+                const constraint = spec.type === "enum" ? `enum: ${spec.enum.join(" | ")}` : spec.type;
+                const requirement = spec.required ? ", REQUIRED" : "";
+                lines.push(`# ${spec.description} (${constraint}${requirement})`);
+                lines.push(`${spec.name}=${spec.default ?? ""}`);
+            }
+        }
+    }
+    return lines.join("\n") + "\n";
+}
+//# sourceMappingURL=sync.js.map

package/dist/cli/sync.js.map

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

package/dist/config/build-config.d.ts

@@ -0,0 +1,13 @@
+import { BootReport } from "../errors/boot-error.js";
+import type { ModuleFiles } from "../modules/explorer.js";
+import type { Ctx, ModuleLifecycle } from "../boot/contracts.js";
+/**
+ * Boot phase 6: run every `module.config.ts` factory in load order, merging
+ * each result into the global config under the module's short name, and
+ * collect the lifecycle hooks exported alongside them.
+ *
+ * The ctx handed to each factory carries the config built *so far* — load
+ * order is dependency order, so a module can safely read the namespaces of
+ * anything it declared in `dependsOn`.
+ */
+export declare function buildGlobalConfig(explored: readonly ModuleFiles[], ctx: Ctx, report: BootReport): Promise<ModuleLifecycle[]>;

package/dist/config/build-config.js

@@ -0,0 +1,63 @@
+import { BootReport } from "../errors/boot-error.js";
+import { importFile } from "../boot/import-file.js";
+/**
+ * Boot phase 6: run every `module.config.ts` factory in load order, merging
+ * each result into the global config under the module's short name, and
+ * collect the lifecycle hooks exported alongside them.
+ *
+ * The ctx handed to each factory carries the config built *so far* — load
+ * order is dependency order, so a module can safely read the namespaces of
+ * anything it declared in `dependsOn`.
+ */
+export async function buildGlobalConfig(explored, ctx, report) {
+    const lifecycles = [];
+    for (const { module, configFile } of explored) {
+        if (!configFile)
+            continue;
+        const exported = await importFile(configFile, "config", module.name, report);
+        if (!exported)
+            continue;
+        const lifecycle = collectLifecycle(module.name, exported, report);
+        if (lifecycle)
+            lifecycles.push(lifecycle);
+        if (typeof exported.default !== "function") {
+            report.add({
+                scope: "config",
+                module: module.name,
+                message: "module.config must default-export a function (ctx) => config",
+            });
+            continue;
+        }
+        try {
+            const result = await exported.default(ctx);
+            ctx.config[module.name] = result ?? {};
+        }
+        catch (error) {
+            report.add({
+                scope: "config",
+                module: module.name,
+                message: `config factory threw: ${error.message}`,
+            });
+        }
+    }
+    return lifecycles;
+}
+function collectLifecycle(moduleName, exported, report) {
+    const lifecycle = { module: moduleName };
+    for (const hook of ["onReady", "onShutdown"]) {
+        const value = exported[hook];
+        if (value === undefined)
+            continue;
+        if (typeof value !== "function") {
+            report.add({
+                scope: "config",
+                module: moduleName,
+                message: `exported "${hook}" must be a function`,
+            });
+            continue;
+        }
+        lifecycle[hook] = value;
+    }
+    return lifecycle.onReady || lifecycle.onShutdown ? lifecycle : undefined;
+}
+//# sourceMappingURL=build-config.js.map

package/dist/config/build-config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"build-config.js","sourceRoot":"","sources":["../../src/config/build-config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAErD,OAAO,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AAcpD;;;;;;;;GAQG;AACH,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,QAAgC,EAChC,GAAQ,EACR,MAAkB;IAElB,MAAM,UAAU,GAAsB,EAAE,CAAC;IAEzC,KAAK,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,IAAI,QAAQ,EAAE,CAAC;QAC9C,IAAI,CAAC,UAAU;YAAE,SAAS;QAE1B,MAAM,QAAQ,GAAG,MAAM,UAAU,CAC/B,UAAU,EACV,QAAQ,EACR,MAAM,CAAC,IAAI,EACX,MAAM,CACP,CAAC;QACF,IAAI,CAAC,QAAQ;YAAE,SAAS;QAExB,MAAM,SAAS,GAAG,gBAAgB,CAAC,MAAM,CAAC,IAAI,EAAE,QAAQ,EAAE,MAAM,CAAC,CAAC;QAClE,IAAI,SAAS;YAAE,UAAU,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QAE1C,IAAI,OAAO,QAAQ,CAAC,OAAO,KAAK,UAAU,EAAE,CAAC;YAC3C,MAAM,CAAC,GAAG,CAAC;gBACT,KAAK,EAAE,QAAQ;gBACf,MAAM,EAAE,MAAM,CAAC,IAAI;gBACnB,OAAO,EAAE,8DAA8D;aACxE,CAAC,CAAC;YACH,SAAS;QACX,CAAC;QAED,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAO,QAAQ,CAAC,OAA0B,CAAC,GAAG,CAAC,CAAC;YAC/D,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,MAAM,IAAI,EAAE,CAAC;QACzC,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,CAAC,GAAG,CAAC;gBACT,KAAK,EAAE,QAAQ;gBACf,MAAM,EAAE,MAAM,CAAC,IAAI;gBACnB,OAAO,EAAE,yBAA0B,KAAe,CAAC,OAAO,EAAE;aAC7D,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED,OAAO,UAAU,CAAC;AACpB,CAAC;AAED,SAAS,gBAAgB,CACvB,UAAkB,EAClB,QAA2B,EAC3B,MAAkB;IAElB,MAAM,SAAS,GAAoB,EAAE,MAAM,EAAE,UAAU,EAAE,CAAC;IAE1D,KAAK,MAAM,IAAI,IAAI,CAAC,SAAS,EAAE,YAAY,CAAU,EAAE,CAAC;QACtD,MAAM,KAAK,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC;QAC7B,IAAI,KAAK,KAAK,SAAS;YAAE,SAAS;QAClC,IAAI,OAAO,KAAK,KAAK,UAAU,EAAE,CAAC;YAChC,MAAM,CAAC,GAAG,CAAC;gBACT,KAAK,EAAE,QAAQ;gBACf,MAAM,EAAE,UAAU;gBAClB,OAAO,EAAE,aAAa,IAAI,sBAAsB;aACjD,CAAC,CAAC;YACH,SAAS;QACX,CAAC;QACD,SAAS,CAAC,IAAI,CAAC,GAAG,KAAsB,CAAC;IAC3C,CAAC;IAED,OAAO,SAAS,CAAC,OAAO,IAAI,SAAS,CAAC,UAAU,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC;AAC3E,CAAC"}

package/dist/config/index.d.ts

@@ -0,0 +1,13 @@
+export { buildGlobalConfig } from "./build-config.js";
+/**
+ * The global config: one plain object, namespaced by module short-name —
+ * whatever `modules/users/module.config.ts` returns lives at `config.users`.
+ *
+ * Augmentation target for the generated `types/config.d.ts` (`tulipes sync`):
+ * codegen adds one property per module, typed as its factory's return type.
+ * Declared in THIS module (not re-exported) because TypeScript module
+ * augmentation only merges with the module that declares the interface.
+ */
+export interface GlobalConfig {
+    [moduleName: string]: Record<string, unknown> | undefined;
+}

package/dist/config/index.js

@@ -0,0 +1,2 @@
+export { buildGlobalConfig } from "./build-config.js";
+//# sourceMappingURL=index.js.map

package/dist/config/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/config/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC"}