@tulipes/cli 0.1.1 → 0.2.0-rc.1

package/README.md

@@ -16,21 +16,24 @@ loader it carries.
 ```sh
 npm install -g @tulipes/cli@next
 tulipes init my-api            # minimal preset; --preset production for the full app
-cd my-api && corepack enable && yarn install && yarn dev
+cd my-api && pnpm install && pnpm dev
 ```
 
-Generated apps also list `@tulipes/cli` in `devDependencies`, so `yarn dev`,
-`yarn sync`, `yarn spec` and `yarn tulipes new module <name>` work without a
+Generated apps also list `@tulipes/cli` in `devDependencies`, so `pnpm dev`,
+`pnpm sync`, `pnpm spec` and `pnpm tulipes new module <name>` work without a
 global install and always match the app.
 
 | Command | What it does |
 |---|---|
 | `tulipes init [dir] [--minimal \| --preset minimal \| --preset production] [--no-queues] [--no-sockets]` | scaffold an application; no services. The two opt-outs apply to the production preset and leave that provider, its files, dependencies and worker process out |
-| `tulipes dev [entry]` | regenerate types, then run under tsx watch |
-| `tulipes sync` | regenerate `types/config.d.ts` and `.env.example` |
+| `tulipes dev [entry]` | regenerate types, then run the entrypoint with `node --watch` |
+| `tulipes sync` | regenerate `types/tulipes.d.ts` and `.env.example` |
 | `tulipes env:check` | validate the environment without booting |
-| `tulipes routes [--offline \| --runtime]` | list declared endpoints |
-| `tulipes spec [--offline \| --runtime] [--openapi file] [--postman file] [--url base]` | generate documents (needs `@tulipes/spec` in the app) |
+| `tulipes routes` | list declared endpoints, through inspection |
+| `tulipes spec [--openapi file] [--postman file] [--url base]` | generate documents through inspection (needs `@tulipes/spec` in the app) |
+| `tulipes agent manifest [--out file] [--role role]` | every tool the app exposes to agents, as JSON, through inspection |
+| `tulipes migrate 0.11` | rewrite an app generated on 0.10 to the 0.11 layout and contracts; every judgement it cannot make is a `TODO 0.11:` |
+| `tulipes config:import [--env APP_ENV] [--from file] [--dry-run]` | after a migration, carry the env file's values for variables that became settings into the store |
 | `tulipes new module <name> [--model\|--no-model] [--queues\|--no-queues] [--sockets\|--no-sockets]` | scaffold a module for the providers the app declares |
 | `tulipes update` | upgrade the global CLI and, inside an app, its core and CLI ranges |
 | `tulipes -v` | print the CLI version, its bundled core, and the app's core when they differ |

package/dist/agent.d.ts

@@ -0,0 +1,12 @@
+/**
+ * `tulipes agent manifest` — every tool the app exposes to agents, from
+ * the same inspection boot as `tulipes routes`: route tools from the RAIs
+ * with method, path and input schema, actions from `agent/*.agent.ts`.
+ * No service, secret or `.env` is needed. `--role` narrows it to what one
+ * role may call, which is what the HTTP transport serves that role.
+ */
+export interface AgentManifestOptions {
+    out?: string;
+    role?: string;
+}
+export declare function runAgentManifest(rootDir: string, options: AgentManifestOptions): Promise<void>;

package/dist/agent.js

@@ -0,0 +1,29 @@
+import { mkdirSync, writeFileSync } from "node:fs";
+import { dirname, resolve } from "node:path";
+import { inspectApp } from "./inspection.js";
+export async function runAgentManifest(rootDir, options) {
+    const handle = await inspectApp(rootDir);
+    try {
+        const registry = handle.ctx.agent;
+        const manifest = registry.manifest(options.role);
+        const json = `${JSON.stringify(manifest, null, 2)}\n`;
+        if (options.out) {
+            const path = resolve(options.out);
+            mkdirSync(dirname(path), { recursive: true });
+            writeFileSync(path, json);
+            console.log(`wrote ${options.out}: ${manifest.tools.length} tool(s) across ${manifest.modules.length} module(s)`);
+        }
+        else {
+            process.stdout.write(json);
+        }
+        if (registry.warnings.length > 0) {
+            console.error(`\n${registry.warnings.length} schema(s) could not be described:`);
+            for (const warning of registry.warnings)
+                console.error(`  ! ${warning}`);
+        }
+    }
+    finally {
+        await handle.shutdown();
+    }
+}
+//# sourceMappingURL=agent.js.map

package/dist/agent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent.js","sourceRoot":"","sources":["../src/agent.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AACnD,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAE7C,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAc7C,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,OAAe,EAAE,OAA6B;IACnF,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,OAAO,CAAC,CAAC;IAEzC,IAAI,CAAC;QACH,MAAM,QAAQ,GAAG,MAAM,CAAC,GAAG,CAAC,KAAM,CAAC;QACnC,MAAM,QAAQ,GAAG,QAAQ,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QACjD,MAAM,IAAI,GAAG,GAAG,IAAI,CAAC,SAAS,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC;QAEtD,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC;YAChB,MAAM,IAAI,GAAG,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;YAClC,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;YAC9C,aAAa,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;YAC1B,OAAO,CAAC,GAAG,CAAC,SAAS,OAAO,CAAC,GAAG,KAAK,QAAQ,CAAC,KAAK,CAAC,MAAM,mBAAmB,QAAQ,CAAC,OAAO,CAAC,MAAM,YAAY,CAAC,CAAC;QACpH,CAAC;aAAM,CAAC;YACN,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAC7B,CAAC;QAED,IAAI,QAAQ,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACjC,OAAO,CAAC,KAAK,CAAC,KAAK,QAAQ,CAAC,QAAQ,CAAC,MAAM,oCAAoC,CAAC,CAAC;YACjF,KAAK,MAAM,OAAO,IAAI,QAAQ,CAAC,QAAQ;gBAAE,OAAO,CAAC,KAAK,CAAC,OAAO,OAAO,EAAE,CAAC,CAAC;QAC3E,CAAC;IACH,CAAC;YAAS,CAAC;QACT,MAAM,MAAM,CAAC,QAAQ,EAAE,CAAC;IAC1B,CAAC;AACH,CAAC"}

package/dist/app-core.d.ts

@@ -23,11 +23,13 @@ export declare function importFromApp<T>(rootDir: string, specifier: string): Pr
  */
 export declare function appBoot(rootDir: string): Promise<BootFn>;
 /**
- * Registers the TypeScript loader before any app file is imported.
- *
- * The published CLI runs as plain node while an app's modules are
- * TypeScript, so without this every dynamic import of a `.ts` file fails
- * to resolve. The hook is process-wide, so it also covers imports the
- * app's own core makes afterwards. Harmless when the app is compiled.
+ * An app's modules are TypeScript and the CLI imports them as they are:
+ * Node strips the types natively (every supported Node does), so there is
+ * no loader to register. What this checks is that the node running the
+ * CLI is one of those — a node too old to strip types would fail later,
+ * on the first module file, with a syntax error that says nothing about
+ * the cause.
  */
+export declare function requireNativeTypeScript(): void;
+/** @deprecated Since 0.11 nothing is registered; kept for callers written against 0.10. */
 export declare function registerTypeScript(): Promise<void>;

package/dist/app-core.js

@@ -1,3 +1,11 @@
+var __rewriteRelativeImportExtension = (this && this.__rewriteRelativeImportExtension) || function (path, preserveJsx) {
+    if (typeof path === "string" && /^\.\.?\//.test(path)) {
+        return path.replace(/\.(tsx)$|((?:\.d)?)((?:\.[^./]+?)?)\.([cm]?)ts$/i, function (m, tsx, d, ext, cm) {
+            return tsx ? preserveJsx ? ".jsx" : ".js" : d && (!ext || !cm) ? m : (d + ext + "." + cm.toLowerCase() + "js");
+        });
+    }
+    return path;
+};
 import { createRequire } from "node:module";
 import { join } from "node:path";
 import { pathToFileURL } from "node:url";
@@ -16,7 +24,7 @@ export async function importFromApp(rootDir, specifier) {
         // whatever directory the CLI itself was installed into.
         const requireFromApp = createRequire(join(rootDir, "package.json"));
         const entry = requireFromApp.resolve(specifier);
-        return (await import(pathToFileURL(entry).href));
+        return (await import(__rewriteRelativeImportExtension(pathToFileURL(entry).href)));
     }
     catch {
         return undefined;
@@ -39,20 +47,21 @@ export async function appBoot(rootDir) {
     return module?.boot ?? bundledBoot;
 }
 /**
- * Registers the TypeScript loader before any app file is imported.
- *
- * The published CLI runs as plain node while an app's modules are
- * TypeScript, so without this every dynamic import of a `.ts` file fails
- * to resolve. The hook is process-wide, so it also covers imports the
- * app's own core makes afterwards. Harmless when the app is compiled.
+ * An app's modules are TypeScript and the CLI imports them as they are:
+ * Node strips the types natively (every supported Node does), so there is
+ * no loader to register. What this checks is that the node running the
+ * CLI is one of those — a node too old to strip types would fail later,
+ * on the first module file, with a syntax error that says nothing about
+ * the cause.
  */
-export async function registerTypeScript() {
-    try {
-        const tsx = (await import("tsx/esm/api"));
-        tsx.register?.();
-    }
-    catch {
-        // No tsx available: a compiled app still boots fine without it.
+export function requireNativeTypeScript() {
+    const features = process.features;
+    if (!features.typescript) {
+        throw new Error(`Node ${process.versions.node} cannot run TypeScript natively — Tulipes apps need Node 24 (or 22.18+)`);
     }
 }
+/** @deprecated Since 0.11 nothing is registered; kept for callers written against 0.10. */
+export async function registerTypeScript() {
+    requireNativeTypeScript();
+}
 //# sourceMappingURL=app-core.js.map

package/dist/app-core.js.map

@@ -1 +1 @@
-{"version":3,"file":"app-core.js","sourceRoot":"","sources":["../src/app-core.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAEzC,OAAO,EAAE,IAAI,IAAI,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAKzD;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CAAI,OAAe,EAAE,SAAiB;IACvE,IAAI,CAAC;QACH,sEAAsE;QACtE,wDAAwD;QACxD,MAAM,cAAc,GAAG,aAAa,CAAC,IAAI,CAAC,OAAO,EAAE,cAAc,CAAC,CAAC,CAAC;QACpE,MAAM,KAAK,GAAG,cAAc,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;QAChD,OAAO,CAAC,MAAM,MAAM,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,CAAM,CAAC;IACxD,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAC;IACnB,CAAC;AACH,CAAC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,KAAK,UAAU,OAAO,CAAC,OAAe;IAC3C,MAAM,MAAM,GAAG,MAAM,aAAa,CAAoB,OAAO,EAAE,oBAAoB,CAAC,CAAC;IACrF,OAAO,MAAM,EAAE,IAAI,IAAI,WAAW,CAAC;AACrC,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB;IACtC,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,CAAC,MAAM,MAAM,CAAC,aAAa,CAAC,CAA8B,CAAC;QACvE,GAAG,CAAC,QAAQ,EAAE,EAAE,CAAC;IACnB,CAAC;IAAC,MAAM,CAAC;QACP,gEAAgE;IAClE,CAAC;AACH,CAAC"}
+{"version":3,"file":"app-core.js","sourceRoot":"","sources":["../src/app-core.ts"],"names":[],"mappings":";;;;;;;;AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAEzC,OAAO,EAAE,IAAI,IAAI,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAKzD;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CAAI,OAAe,EAAE,SAAiB;IACvE,IAAI,CAAC;QACH,sEAAsE;QACtE,wDAAwD;QACxD,MAAM,cAAc,GAAG,aAAa,CAAC,IAAI,CAAC,OAAO,EAAE,cAAc,CAAC,CAAC,CAAC;QACpE,MAAM,KAAK,GAAG,cAAc,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;QAChD,OAAO,CAAC,MAAM,MAAM,kCAAC,aAAa,CAAC,KAAK,CAAC,CAAC,IAAI,EAAC,CAAM,CAAC;IACxD,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAC;IACnB,CAAC;AACH,CAAC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,KAAK,UAAU,OAAO,CAAC,OAAe;IAC3C,MAAM,MAAM,GAAG,MAAM,aAAa,CAAoB,OAAO,EAAE,oBAAoB,CAAC,CAAC;IACrF,OAAO,MAAM,EAAE,IAAI,IAAI,WAAW,CAAC;AACrC,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,uBAAuB;IACrC,MAAM,QAAQ,GAAG,OAAO,CAAC,QAA2C,CAAC;IACrE,IAAI,CAAC,QAAQ,CAAC,UAAU,EAAE,CAAC;QACzB,MAAM,IAAI,KAAK,CAAC,QAAQ,OAAO,CAAC,QAAQ,CAAC,IAAI,yEAAyE,CAAC,CAAC;IAC1H,CAAC;AACH,CAAC;AAED,2FAA2F;AAC3F,MAAM,CAAC,KAAK,UAAU,kBAAkB;IACtC,uBAAuB,EAAE,CAAC;AAC5B,CAAC"}

package/dist/bin.js

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
-// Published bin entry — compiled to dist/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.
+// Published bin entry — compiled to dist/bin.js. The dev workspace runs
+// this source through node's native type stripping instead; publishConfig.bin
+// swaps the compiled one in at pack time.
 import { main } from "./main.js";
 await main(process.argv.slice(2));
 //# sourceMappingURL=bin.js.map

package/dist/bin.js.map

@@ -1 +1 @@
-{"version":3,"file":"bin.js","sourceRoot":"","sources":["../src/bin.ts"],"names":[],"mappings":";AACA,wEAAwE;AACxE,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"}
+{"version":3,"file":"bin.js","sourceRoot":"","sources":["../src/bin.ts"],"names":[],"mappings":";AACA,wEAAwE;AACxE,8EAA8E;AAC9E,0CAA0C;AAC1C,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,MAAM,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC"}

package/dist/config-check.d.ts

@@ -0,0 +1,8 @@
+/**
+ * `tulipes config:check` — boot in script mode, which loads every settings
+ * namespace from the store the app declares (or core's file store) and
+ * refuses invalid stored values the way a serving process would; then
+ * print what each module runs with and exit. A deploy preflight for the
+ * settings store, the way `env:check` is one for the environment.
+ */
+export declare function runConfigCheck(rootDir: string): Promise<void>;

package/dist/config-check.js

@@ -0,0 +1,43 @@
+import { TulipesBootError } from "@tulipes/core/errors";
+import { appBoot, requireNativeTypeScript } from "./app-core.js";
+/**
+ * `tulipes config:check` — boot in script mode, which loads every settings
+ * namespace from the store the app declares (or core's file store) and
+ * refuses invalid stored values the way a serving process would; then
+ * print what each module runs with and exit. A deploy preflight for the
+ * settings store, the way `env:check` is one for the environment.
+ */
+export async function runConfigCheck(rootDir) {
+    requireNativeTypeScript();
+    const boot = await appBoot(rootDir);
+    let handle;
+    try {
+        handle = await boot({ rootDir, mode: "script", handleSignals: false });
+    }
+    catch (error) {
+        if (error instanceof TulipesBootError) {
+            console.error(error.message);
+            process.exitCode = 1;
+            return;
+        }
+        throw error;
+    }
+    try {
+        const { settings } = handle.ctx;
+        const namespaces = settings.namespaces();
+        console.log(`APP_ENV=${handle.env.appEnv} — ${namespaces.length} settings namespace(s) in ${settings.status().label}:`);
+        for (const namespace of namespaces) {
+            const description = settings.describe(namespace);
+            const { version, updated_at, updated_by } = description.stored;
+            console.log(`  ✔ ${namespace}  v${version}  ${updated_at}  by ${updated_by.label ?? updated_by.id}`);
+            for (const [field, value] of Object.entries(description.values)) {
+                const pending = description.pendingRestart.includes(field) ? "  (restart pending)" : "";
+                console.log(`      ${field} = ${JSON.stringify(value)}${pending}`);
+            }
+        }
+    }
+    finally {
+        await handle.shutdown();
+    }
+}
+//# sourceMappingURL=config-check.js.map

package/dist/config-check.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-check.js","sourceRoot":"","sources":["../src/config-check.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAExD,OAAO,EAAE,OAAO,EAAE,uBAAuB,EAAE,MAAM,eAAe,CAAC;AAEjE;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,OAAe;IAClD,uBAAuB,EAAE,CAAC;IAC1B,MAAM,IAAI,GAAG,MAAM,OAAO,CAAC,OAAO,CAAC,CAAC;IACpC,IAAI,MAAM,CAAC;IACX,IAAI,CAAC;QACH,MAAM,GAAG,MAAM,IAAI,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,aAAa,EAAE,KAAK,EAAE,CAAC,CAAC;IACzE,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;IACD,IAAI,CAAC;QACH,MAAM,EAAE,QAAQ,EAAE,GAAG,MAAM,CAAC,GAAG,CAAC;QAChC,MAAM,UAAU,GAAG,QAAQ,CAAC,UAAU,EAAE,CAAC;QACzC,OAAO,CAAC,GAAG,CAAC,WAAW,MAAM,CAAC,GAAG,CAAC,MAAM,MAAM,UAAU,CAAC,MAAM,6BAA6B,QAAQ,CAAC,MAAM,EAAE,CAAC,KAAK,GAAG,CAAC,CAAC;QACxH,KAAK,MAAM,SAAS,IAAI,UAAU,EAAE,CAAC;YACnC,MAAM,WAAW,GAAG,QAAQ,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC;YACjD,MAAM,EAAE,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,GAAG,WAAW,CAAC,MAAM,CAAC;YAC/D,OAAO,CAAC,GAAG,CAAC,OAAO,SAAS,MAAM,OAAO,KAAK,UAAU,QAAQ,UAAU,CAAC,KAAK,IAAI,UAAU,CAAC,EAAE,EAAE,CAAC,CAAC;YACrG,KAAK,MAAM,CAAC,KAAK,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,WAAW,CAAC,MAAM,CAAC,EAAE,CAAC;gBAChE,MAAM,OAAO,GAAG,WAAW,CAAC,cAAc,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,qBAAqB,CAAC,CAAC,CAAC,EAAE,CAAC;gBACxF,OAAO,CAAC,GAAG,CAAC,SAAS,KAAK,MAAM,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,GAAG,OAAO,EAAE,CAAC,CAAC;YACrE,CAAC;QACH,CAAC;IACH,CAAC;YAAS,CAAC;QACT,MAAM,MAAM,CAAC,QAAQ,EAAE,CAAC;IAC1B,CAAC;AACH,CAAC"}

package/dist/config-import.d.ts

@@ -0,0 +1,20 @@
+/**
+ * `tulipes config:import` — after `tulipes migrate 0.11`, carry the values a
+ * deployment kept in `.envs/.env.<APP_ENV>` for variables that became
+ * settings into the settings store, so the upgraded app boots with what
+ * it ran with. The mapping is `config/migration-0.11.json`, written by the
+ * migration; the values are validated by each module's schema before they
+ * are written, and written with the store's own versioning — through the
+ * file store the app uses by default, or the Mongo store it declares.
+ */
+export interface ConfigImportOptions {
+    /** APP_ENV to read and write for; default the process's APP_ENV or "development". */
+    env?: string;
+    /** An env file to read instead of `.envs/.env.<env>`. */
+    from?: string;
+    /** Print what would be written and write nothing. */
+    dryRun?: boolean;
+}
+export declare function runConfigImport(rootDir: string, options?: ConfigImportOptions): Promise<void>;
+/** `KEY=value` lines, quotes and inline comments removed — what dotenv reads, without dotenv. */
+export declare function parseEnv(text: string): Record<string, string>;

package/dist/config-import.js

@@ -0,0 +1,133 @@
+var __rewriteRelativeImportExtension = (this && this.__rewriteRelativeImportExtension) || function (path, preserveJsx) {
+    if (typeof path === "string" && /^\.\.?\//.test(path)) {
+        return path.replace(/\.(tsx)$|((?:\.d)?)((?:\.[^./]+?)?)\.([cm]?)ts$/i, function (m, tsx, d, ext, cm) {
+            return tsx ? preserveJsx ? ".jsx" : ".js" : d && (!ext || !cm) ? m : (d + ext + "." + cm.toLowerCase() + "js");
+        });
+    }
+    return path;
+};
+import { existsSync, readFileSync } from "node:fs";
+import { join, resolve } from "node:path";
+import { pathToFileURL } from "node:url";
+import { importFromApp } from "./app-core.js";
+export async function runConfigImport(rootDir, options = {}) {
+    const appEnv = options.env ?? process.env.APP_ENV ?? "development";
+    const mappingFile = join(rootDir, "config", "migration-0.11.json");
+    if (!existsSync(mappingFile)) {
+        console.error("config/migration-0.11.json not found — run `tulipes migrate 0.11` first; it records which variables became settings");
+        process.exitCode = 2;
+        return;
+    }
+    const mapping = JSON.parse(readFileSync(mappingFile, "utf8"));
+    const envFile = options.from ? resolve(options.from) : join(rootDir, ".envs", `.env.${appEnv}`);
+    const values = existsSync(envFile) ? parseEnv(readFileSync(envFile, "utf8")) : {};
+    const read = (name) => process.env[name] ?? values[name];
+    if (!existsSync(envFile))
+        console.warn(`${envFile} does not exist; only process.env is read`);
+    const core = await importFromApp(rootDir, "@tulipes/core/config");
+    if (!core) {
+        console.error("@tulipes/core is not installed in this app — pnpm install first");
+        process.exitCode = 2;
+        return;
+    }
+    const store = await openStore(rootDir, appEnv, read, core);
+    if (!store)
+        return;
+    console.log(`store: ${store.status().label}`);
+    let written = 0;
+    try {
+        for (const [namespace, fields] of Object.entries(mapping.settings)) {
+            const configFile = join(rootDir, "modules", namespace, "module.config.ts");
+            const exported = (await import(__rewriteRelativeImportExtension(pathToFileURL(configFile).href)));
+            if (!exported.default || !core.isConfigDeclaration(exported.default)) {
+                console.error(`  ${namespace}: module.config.ts does not export defineConfig({ … }); skipped`);
+                continue;
+            }
+            const patch = {};
+            const sources = [];
+            for (const [setting, { variable, type }] of Object.entries(fields)) {
+                const raw = read(variable);
+                if (raw === undefined)
+                    continue;
+                patch[setting] = coerce(raw, type);
+                sources.push(`${setting} ← ${variable}`);
+            }
+            if (sources.length === 0) {
+                console.log(`  ${namespace}: nothing set for ${Object.values(fields).map((field) => field.variable).join(", ")}; the schema defaults stay`);
+                continue;
+            }
+            const stored = await store.load(namespace);
+            const candidate = { ...stored?.values, ...patch };
+            const parsed = exported.default.schema.safeParse(candidate);
+            if (!parsed.success) {
+                console.error(`  ${namespace}: refused by the schema — ${parsed.error?.issues.map((issue) => `${issue.path.join(".")}: ${issue.message}`).join("; ")}`);
+                process.exitCode = 1;
+                continue;
+            }
+            console.log(`  ${namespace}: ${sources.join(", ")}${options.dryRun ? " (dry run)" : ""}`);
+            if (options.dryRun)
+                continue;
+            await store.save(namespace, parsed.data, stored?.version ?? 0, { id: "config:import", label: `from ${envFile}` });
+            written++;
+        }
+    }
+    finally {
+        await store.dispose?.();
+    }
+    console.log(`${written} namespace(s) written for APP_ENV=${appEnv}` + (written ? "; the variables can leave the env file now" : ""));
+}
+async function openStore(rootDir, appEnv, read, core) {
+    const pkg = JSON.parse(readFileSync(join(rootDir, "package.json"), "utf8"));
+    const declared = pkg.tulipes?.providers?.settings;
+    if (!declared)
+        return new core.FileSettingsStore(rootDir, appEnv);
+    if (!declared.startsWith("@tulipes/mongoose")) {
+        console.error(`the app declares settings provider "${declared}", which this command cannot write to — set the values through the console once the app runs`);
+        process.exitCode = 2;
+        return undefined;
+    }
+    const uri = read("MONGO_URI");
+    if (!uri) {
+        console.error("MONGO_URI is not set in the env file or the process; the Mongo settings store needs it");
+        process.exitCode = 2;
+        return undefined;
+    }
+    const mongoose = await importFromApp(rootDir, "mongoose");
+    const provider = await importFromApp(rootDir, "@tulipes/mongoose");
+    if (!mongoose || !provider) {
+        console.error("mongoose and @tulipes/mongoose must be installed in the app");
+        process.exitCode = 2;
+        return undefined;
+    }
+    const connection = mongoose.createConnection(uri, { serverSelectionTimeoutMS: 5_000 });
+    await connection.asPromise();
+    const store = new provider.MongoSettingsStore(connection);
+    const dispose = store.dispose?.bind(store);
+    store.dispose = async () => { await dispose?.(); await connection.close(); };
+    return store;
+}
+function coerce(raw, type) {
+    switch (type) {
+        case "number": return Number(raw);
+        case "boolean": return /^(1|true|yes|on)$/i.test(raw.trim());
+        default: return raw;
+    }
+}
+/** `KEY=value` lines, quotes and inline comments removed — what dotenv reads, without dotenv. */
+export function parseEnv(text) {
+    const values = {};
+    for (const line of text.split("\n")) {
+        const match = /^\s*(?:export\s+)?([A-Za-z_][A-Za-z0-9_]*)\s*=\s*(.*)$/.exec(line);
+        if (!match)
+            continue;
+        let value = match[2].trim();
+        const quoted = /^(["'])((?:(?!\1).)*)\1/.exec(value);
+        if (quoted)
+            value = quoted[2];
+        else
+            value = value.replace(/\s+#.*$/, "");
+        values[match[1]] = value;
+    }
+    return values;
+}
+//# sourceMappingURL=config-import.js.map

package/dist/config-import.js.map

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

package/dist/dev.d.ts

@@ -1,8 +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.
+ * when the dev server starts), then run the entrypoint with node itself in
+ * watch mode. Node strips the types natively, so there is no loader to
+ * resolve and nothing to transpile: what runs in development is what PM2
+ * runs in production.
  */
 export declare function runDev(rootDir: string, entry: string): Promise<void>;

package/dist/dev.js

@@ -1,20 +1,17 @@
 import { spawn } from "node:child_process";
-import { createRequire } from "node:module";
-import { dirname, join } from "node:path";
 import { runSync } from "./sync.js";
+import { requireNativeTypeScript } from "./app-core.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.
+ * when the dev server starts), then run the entrypoint with node itself in
+ * watch mode. Node strips the types natively, so there is no loader to
+ * resolve and nothing to transpile: what runs in development is what PM2
+ * runs in production.
  */
 export async function runDev(rootDir, entry) {
+    requireNativeTypeScript();
     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" });
+    const child = spawn(process.execPath, ["--watch", "--watch-preserve-output", entry], { cwd: rootDir, stdio: "inherit" });
     child.on("exit", (code) => {
         process.exitCode = code ?? 0;
     });

package/dist/dev.js.map

@@ -1 +1 @@
-{"version":3,"file":"dev.js","sourceRoot":"","sources":["../src/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"}
+{"version":3,"file":"dev.js","sourceRoot":"","sources":["../src/dev.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAE3C,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,uBAAuB,EAAE,MAAM,eAAe,CAAC;AAExD;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,MAAM,CAAC,OAAe,EAAE,KAAa;IACzD,uBAAuB,EAAE,CAAC;IAC1B,MAAM,OAAO,CAAC,OAAO,CAAC,CAAC;IAEvB,MAAM,KAAK,GAAG,KAAK,CACjB,OAAO,CAAC,QAAQ,EAChB,CAAC,SAAS,EAAE,yBAAyB,EAAE,KAAK,CAAC,EAC7C,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/init.d.ts

@@ -1,15 +1,10 @@
 /**
- * `tulipes init [dir]` — scaffold a complete application.
- *
- * Three modules ship: core (sys 0 — env contract, roles, request ids),
- * security (sys 10 — helmet, cors, logging, body parsing) and hello, a
- * worked example of EVERY module contract: config with lifecycle hooks,
- * ACL grants, routes, a controller, a helper, a model, a bootstrap task,
- * a queue with its processor, and a socket namespace.
- *
- * The generated app therefore needs mongo and redis running — models and
- * queues cannot work without them, and the boot refuses rather than
- * degrading quietly.
+ * `tulipes init [dir]` — scaffold a complete application from a template
+ * tree. The production preset is the reference application the framework
+ * is developed against, copied verbatim and transformed only in the ways
+ * `template.ts` lists; the minimal preset is a three-module API with no
+ * infrastructure. Neither is rendered from strings, so what this command
+ * writes and what the repository tests are the same files.
  */
 export type InitPreset = "minimal" | "production";
 /**