@xemahq/xema 0.3.0 → 0.5.0

package/README.md

@@ -46,6 +46,26 @@ lifecycle (restart, health, resource limits) to the substrate beneath it
 npm i -g @xemahq/xema
 ```
 
+## Scaffold a config — `xema init`
+
+Generate a `xema.config.yaml` tailored to your scenario. Run it with no flags for
+a short interactive wizard, or `--preset` / `--yes` for scripted use:
+
+```bash
+xema init                                  # interactive wizard
+xema init --preset local-container --yes   # full local stack in containers
+xema init --preset local-monolith          # lowest-RAM single native process
+xema init --preset byo-infra               # bring-your-own Postgres/Keycloak/object-store
+xema init --preset appliance               # Kubernetes via Helm
+#   --edition <id> picks a distribution edition (offered from xema-distributions);
+#   --web enables the host shell; --output <path>; --force to overwrite.
+```
+
+The wizard asks your scenario, the distribution **edition** (the real editions
+defined by `xema-distributions`), and — for BYO/monolith — your infra URLs. Every
+generated config is validated against the schema before it's written, so it can
+never be one `xema up` would reject.
+
 ## Launch the platform
 
 ```bash
@@ -173,6 +193,36 @@ What a biome *does* (services, skills, capabilities, agents) is wholly open —
 only the bundle *shape* is standardized, so every author builds the same way and
 any source resolves the same way.
 
+## Compose a distribution — `xema dist build`
+
+Build **your own platform**: take a base edition's first-party biomes and add
+the ones you bring (your git repos / workspace dirs). The composition is
+validated by the real distribution resolver (dependency closure + trust +
+operator rules), then written as a distribution + a launch config:
+
+```bash
+xema dist build --id acme-platform --base oss \
+  --git acme=https://github.com/acme/xema-biomes.git \
+  --source local=./my-biomes \
+  --config-out acme.config.yaml
+#   or read sources from an existing config:  --config xema.config.yaml
+#   --no-allow-third-party rejects non-first-party biomes (default: allowed)
+```
+
+It writes `~/.xema/distributions/<id>/{xema-distribution.json,distribution.lock.json}`
+(the composed recipe + resolved record) and, with `--config-out`, a
+`xema.config.yaml` (base edition + your sources). Then:
+
+```bash
+xema dev --config acme.config.yaml   # native — your biomes run from source
+xema up  --edition acme-platform     # first-party biomes by edition (your composition)
+```
+
+Your composed distribution also shows up as an edition in `xema init` and
+`xema up --edition <id>`. User biomes are `third-party` by origin and launch via
+the source registry (which resolves their source roots); building container
+images for your own biomes is a separate step.
+
 ## Author biomes & run capabilities
 
 ```bash

package/dist/cli.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"AAaA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAoCpC,wBAAgB,YAAY,IAAI,OAAO,CA0BtC;AAED,wBAAsB,IAAI,CAAC,IAAI,GAAE,aAAa,CAAC,MAAM,CAAgB,GAAG,OAAO,CAAC,IAAI,CAAC,CAMpF"}
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"AAaA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAsCpC,wBAAgB,YAAY,IAAI,OAAO,CA4BtC;AAED,wBAAsB,IAAI,CAAC,IAAI,GAAE,aAAa,CAAC,MAAM,CAAgB,GAAG,OAAO,CAAC,IAAI,CAAC,CAMpF"}

package/dist/cli.js

@@ -9,10 +9,12 @@ const commander_1 = require("commander");
 const apply_1 = require("./commands/apply");
 const biome_1 = require("./commands/biome");
 const dev_1 = require("./commands/dev");
+const dist_1 = require("./commands/dist");
 const doctor_1 = require("./commands/doctor");
 const down_1 = require("./commands/down");
 const export_1 = require("./commands/export");
 const import_1 = require("./commands/import");
+const init_1 = require("./commands/init");
 const logs_1 = require("./commands/logs");
 const objects_1 = require("./commands/objects");
 const plan_1 = require("./commands/plan");
@@ -38,11 +40,13 @@ function buildProgram() {
         .version(CLI_VERSION, '-v, --version', 'print the CLI version')
         .showHelpAfterError(true)
         .configureHelp({ sortSubcommands: true });
+    (0, init_1.registerCommand)(program);
     (0, up_1.registerCommand)(program);
     (0, down_1.registerCommand)(program);
     (0, status_1.registerCommand)(program);
     (0, logs_1.registerCommand)(program);
     (0, dev_1.registerCommand)(program);
+    (0, dist_1.registerCommand)(program);
     (0, serve_1.registerCommand)(program);
     (0, biome_1.registerCommand)(program);
     (0, plan_1.registerCommand)(program);

package/dist/cli.js.map

@@ -1 +1 @@
-{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";;AAiDA,oCA0BC;AAED,oBAMC;AAzED,qCAAuC;AACvC,yCAAiC;AAEjC,yCAAoC;AAEpC,4CAAoE;AACpE,4CAAoE;AACpE,wCAAgE;AAChE,8CAAsE;AACtE,0CAAkE;AAClE,8CAAsE;AACtE,8CAAsE;AACtE,0CAAkE;AAClE,gDAAwE;AACxE,0CAAkE;AAClE,wCAAgE;AAChE,4CAAoE;AACpE,4CAAoE;AACpE,8CAAsE;AACtE,sCAA8D;AAS9D,SAAS,cAAc;IACrB,MAAM,YAAY,GAAG,IAAA,gBAAI,EAAC,SAAS,EAAE,IAAI,EAAE,cAAc,CAAC,CAAC;IAC3D,MAAM,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,IAAA,sBAAY,EAAC,YAAY,EAAE,MAAM,CAAC,CAAyB,CAAC;IAC3F,IAAI,OAAO,OAAO,KAAK,QAAQ,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACxD,MAAM,IAAI,KAAK,CAAC,iCAAiC,YAAY,EAAE,CAAC,CAAC;IACnE,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,MAAM,WAAW,GAAG,cAAc,EAAE,CAAC;AAErC,SAAgB,YAAY;IAC1B,MAAM,OAAO,GAAG,IAAI,mBAAO,EAAE,CAAC;IAC9B,OAAO;SACJ,IAAI,CAAC,MAAM,CAAC;SACZ,WAAW,CAAC,oDAAoD,CAAC;SACjE,OAAO,CAAC,WAAW,EAAE,eAAe,EAAE,uBAAuB,CAAC;SAC9D,kBAAkB,CAAC,IAAI,CAAC;SACxB,aAAa,CAAC,EAAE,eAAe,EAAE,IAAI,EAAE,CAAC,CAAC;IAE5C,IAAA,oBAAU,EAAC,OAAO,CAAC,CAAC;IACpB,IAAA,sBAAY,EAAC,OAAO,CAAC,CAAC;IACtB,IAAA,wBAAc,EAAC,OAAO,CAAC,CAAC;IACxB,IAAA,sBAAY,EAAC,OAAO,CAAC,CAAC;IACtB,IAAA,qBAAW,EAAC,OAAO,CAAC,CAAC;IACrB,IAAA,uBAAa,EAAC,OAAO,CAAC,CAAC;IACvB,IAAA,uBAAa,EAAC,OAAO,CAAC,CAAC;IACvB,IAAA,sBAAY,EAAC,OAAO,CAAC,CAAC;IACtB,IAAA,uBAAa,EAAC,OAAO,CAAC,CAAC;IACvB,IAAA,wBAAc,EAAC,OAAO,CAAC,CAAC;IACxB,IAAA,wBAAc,EAAC,OAAO,CAAC,CAAC;IACxB,IAAA,qBAAW,EAAC,OAAO,CAAC,CAAC;IACrB,IAAA,uBAAa,EAAC,OAAO,CAAC,CAAC;IACvB,IAAA,yBAAe,EAAC,OAAO,CAAC,CAAC;IACzB,IAAA,wBAAc,EAAC,OAAO,CAAC,CAAC;IAExB,OAAO,OAAO,CAAC;AACjB,CAAC;AAEM,KAAK,UAAU,IAAI,CAAC,OAA8B,OAAO,CAAC,IAAI;IACnE,MAAM,OAAO,GAAG,YAAY,EAAE,CAAC;IAI/B,MAAM,OAAO,CAAC,UAAU,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC;AACtC,CAAC;AAID,IAAI,OAAO,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;IAC5B,KAAK,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,GAAY,EAAE,EAAE;QACjC,MAAM,OAAO,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QACjE,OAAO,CAAC,KAAK,CAAC,SAAS,OAAO,EAAE,CAAC,CAAC;QAClC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC,CAAC,CAAC;AACL,CAAC"}
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"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"}

package/dist/commands/dev.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"dev.d.ts","sourceRoot":"","sources":["../../src/commands/dev.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AA2BzC,wBAAgB,eAAe,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CA+BtD"}
+{"version":3,"file":"dev.d.ts","sourceRoot":"","sources":["../../src/commands/dev.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AA6BzC,wBAAgB,eAAe,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CA+BtD"}

package/dist/commands/dev.js

@@ -2,6 +2,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.registerCommand = registerCommand;
 const node_child_process_1 = require("node:child_process");
+const node_fs_1 = require("node:fs");
 const node_path_1 = require("node:path");
 const env_defaults_1 = require("../dev/env-defaults");
 const infra_preflight_1 = require("../dev/infra-preflight");
@@ -41,8 +42,15 @@ function registerCommand(program) {
     });
 }
 function reexecUnderWatch(services, opts) {
-    const cliEntry = (0, node_path_1.join)(__dirname, '..', 'cli.js');
-    const args = ['--watch', cliEntry, 'dev', ...services];
+    const srcEntry = (0, node_path_1.join)(__dirname, '..', '..', 'src', 'cli.ts');
+    if (!(0, node_fs_1.existsSync)(srcEntry)) {
+        (0, exit_codes_1.exitWith)(exit_codes_1.XemaCliExitCode.MissingDependency, 'xema dev --watch needs a source checkout — it boots src/cli.ts via tsx (no ' +
+            `prebuild). Source entry not found at ${srcEntry}. For an installed binary ` +
+            'run a plain `xema dev` (boots from dist, no hot-reload).');
+        return;
+    }
+    const tsxCli = resolveTsxCli();
+    const args = [tsxCli, 'watch', srcEntry, 'dev', ...services];
     if (opts.edition) {
         args.push('--edition', opts.edition);
     }
@@ -55,7 +63,7 @@ function reexecUnderWatch(services, opts) {
     if (opts.skipPreflight) {
         args.push('--skip-preflight');
     }
-    console.log('xema dev --watch — restarting on source change (Node --watch). Ctrl+C to stop.');
+    console.log('xema dev --watch — booting from src via tsx; any .ts change restarts. Ctrl+C to stop.');
     const child = (0, node_child_process_1.spawn)(process.execPath, args, {
         stdio: 'inherit',
         env: { ...process.env, [WATCH_CHILD_ENV]: '1', NODE_OPTIONS: watchNodeOptions() },
@@ -64,6 +72,16 @@ function reexecUnderWatch(services, opts) {
         process.exit(code ?? 0);
     });
 }
+function resolveTsxCli() {
+    try {
+        return require.resolve('tsx/cli');
+    }
+    catch {
+        (0, exit_codes_1.exitWith)(exit_codes_1.XemaCliExitCode.MissingDependency, 'xema dev --watch requires the `tsx` dependency, but it could not be resolved. ' +
+            'Reinstall dependencies (`pnpm install`) and retry.');
+        throw new Error('unreachable');
+    }
+}
 function watchNodeOptions() {
     const existing = process.env.NODE_OPTIONS ?? '';
     if (existing.includes('--conditions=xema-source')) {

package/dist/commands/dev.js.map

@@ -1 +1 @@
-{"version":3,"file":"dev.js","sourceRoot":"","sources":["../../src/commands/dev.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"dev.js","sourceRoot":"","sources":["../../src/commands/dev.ts"],"names":[],"mappings":";;AAuCA,0CA+BC;AAtED,2DAA2C;AAC3C,qCAAqC;AACrC,yCAAiC;AAEjC,sDAA0D;AAC1D,4DAAmF;AACnF,kDAA8D;AAC9D,qDAAoF;AACpF,sDAA0D;AA6B1D,MAAM,eAAe,GAAG,sBAAsB,CAAC;AAE/C,SAAgB,eAAe,CAAC,OAAgB;IAC9C,OAAO;SACJ,OAAO,CAAC,KAAK,CAAC;SACd,OAAO,CAAC,oDAAoD,CAAC;SAC7D,WAAW,CACV,sEAAsE;QACpE,0EAA0E;QAC1E,wEAAwE;QACxE,0DAA0D;QAC1D,uEAAuE;QACvE,oEAAoE;QACpE,+DAA+D,CAClE;SACA,QAAQ,CAAC,eAAe,EAAE,qDAAqD,CAAC;SAChF,MAAM,CAAC,gBAAgB,EAAE,qCAAqC,CAAC;SAC/D,MAAM,CAAC,OAAO,EAAE,oCAAoC,CAAC;SACrD,MAAM,CAAC,YAAY,EAAE,6DAA6D,CAAC;SACnF,MAAM,CAAC,SAAS,EAAE,oEAAoE,CAAC;SACvF,MAAM,CAAC,kBAAkB,EAAE,iEAAiE,CAAC;SAC7F,MAAM,CAAC,KAAK,EAAE,QAAqB,EAAE,IAAgB,EAAE,EAAE;QACxD,IAAI,CAAC;YACH,IAAI,IAAI,CAAC,KAAK,IAAI,OAAO,CAAC,GAAG,CAAC,eAAe,CAAC,KAAK,GAAG,EAAE,CAAC;gBACvD,gBAAgB,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;gBACjC,OAAO;YACT,CAAC;YACD,MAAM,MAAM,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;QAC/B,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,OAAO,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YACjE,IAAA,qBAAQ,EAAC,4BAAe,CAAC,YAAY,EAAE,oBAAoB,OAAO,EAAE,CAAC,CAAC;QACxE,CAAC;IACH,CAAC,CAAC,CAAC;AACP,CAAC;AAUD,SAAS,gBAAgB,CAAC,QAAqB,EAAE,IAAgB;IAC/D,MAAM,QAAQ,GAAG,IAAA,gBAAI,EAAC,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,QAAQ,CAAC,CAAC;IAC9D,IAAI,CAAC,IAAA,oBAAU,EAAC,QAAQ,CAAC,EAAE,CAAC;QAC1B,IAAA,qBAAQ,EACN,4BAAe,CAAC,iBAAiB,EACjC,6EAA6E;YAC3E,wCAAwC,QAAQ,4BAA4B;YAC5E,0DAA0D,CAC7D,CAAC;QACF,OAAO;IACT,CAAC;IACD,MAAM,MAAM,GAAG,aAAa,EAAE,CAAC;IAC/B,MAAM,IAAI,GAAG,CAAC,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,GAAG,QAAQ,CAAC,CAAC;IAC7D,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;QACjB,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC;IACvC,CAAC;IACD,IAAI,IAAI,CAAC,GAAG,EAAE,CAAC;QACb,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACrB,CAAC;IACD,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;QAClB,IAAI,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;IAC1B,CAAC;IACD,IAAI,IAAI,CAAC,aAAa,EAAE,CAAC;QACvB,IAAI,CAAC,IAAI,CAAC,kBAAkB,CAAC,CAAC;IAChC,CAAC;IACD,OAAO,CAAC,GAAG,CAAC,uFAAuF,CAAC,CAAC;IACrG,MAAM,KAAK,GAAG,IAAA,0BAAK,EAAC,OAAO,CAAC,QAAQ,EAAE,IAAI,EAAE;QAC1C,KAAK,EAAE,SAAS;QAChB,GAAG,EAAE,EAAE,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC,eAAe,CAAC,EAAE,GAAG,EAAE,YAAY,EAAE,gBAAgB,EAAE,EAAE;KAClF,CAAC,CAAC;IACH,KAAK,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,EAAE;QACxB,OAAO,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC;IAC1B,CAAC,CAAC,CAAC;AACL,CAAC;AAOD,SAAS,aAAa;IACpB,IAAI,CAAC;QACH,OAAO,OAAO,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IACpC,CAAC;IAAC,MAAM,CAAC;QACP,IAAA,qBAAQ,EACN,4BAAe,CAAC,iBAAiB,EACjC,gFAAgF;YAC9E,oDAAoD,CACvD,CAAC;QACF,MAAM,IAAI,KAAK,CAAC,aAAa,CAAC,CAAC;IACjC,CAAC;AACH,CAAC;AAGD,SAAS,gBAAgB;IACvB,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC,YAAY,IAAI,EAAE,CAAC;IAChD,IAAI,QAAQ,CAAC,QAAQ,CAAC,0BAA0B,CAAC,EAAE,CAAC;QAClD,OAAO,QAAQ,CAAC;IAClB,CAAC;IACD,OAAO,GAAG,QAAQ,2BAA2B,CAAC,IAAI,EAAE,CAAC;AACvD,CAAC;AAED,KAAK,UAAU,MAAM,CAAC,QAAqB,EAAE,IAAgB;IAC3D,MAAM,OAAO,GAAG,IAAA,kCAAmB,GAAE,CAAC;IACtC,MAAM,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IACxC,MAAM,OAAO,GAAG,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC;IAC5D,OAAO,CAAC,GAAG,CAAC,2DAA2D,CAAC,CAAC;IACzE,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC;IAC5B,OAAO,CAAC,GAAG,CAAC,oBAAoB,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,kCAAkC,CAAC,CAAC;IAC1F,OAAO,CAAC,GAAG,CAAC,oBAAoB,QAAQ,CAAC,CAAC,CAAC,uCAAuC,CAAC,CAAC,CAAC,aAAa,EAAE,CAAC,CAAC;IACtG,OAAO,CAAC,GAAG,CAAC,oBAAoB,OAAO,KAAK,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,yBAAyB,EAAE,CAAC,CAAC;IAE9G,IAAI,IAAI,CAAC,aAAa,KAAK,IAAI,EAAE,CAAC;QAChC,MAAM,MAAM,GAAG,MAAM,IAAA,mCAAiB,GAAE,CAAC;QACzC,IAAI,CAAC,MAAM,CAAC,YAAY,EAAE,CAAC;YACzB,OAAO,CAAC,KAAK,CAAC,IAAA,wCAAsB,EAAC,MAAM,CAAC,CAAC,CAAC;YAC9C,IAAA,qBAAQ,EAAC,4BAAe,CAAC,iBAAiB,CAAC,CAAC;YAC5C,OAAO;QACT,CAAC;QACD,OAAO,CAAC,GAAG,CAAC,wBAAwB,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,gCAAgC,CAAC,CAAC;IACrG,CAAC;SAAM,CAAC;QACN,OAAO,CAAC,GAAG,CAAC,6CAA6C,CAAC,CAAC;IAC7D,CAAC;IACD,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAEhB,MAAM,MAAM,GAAG,IAAA,wBAAe,EAAC;QAC7B,OAAO,EAAE,IAAI,CAAC,OAAO,IAAI,KAAK;QAC9B,GAAG,EAAE;YACH,SAAS,EAAE,kBAAS,CAAC,MAAM;YAC3B,YAAY,EAAE,QAAQ,CAAC,CAAC,CAAC,qBAAY,CAAC,QAAQ,CAAC,CAAC,CAAC,qBAAY,CAAC,WAAW;YACzE,OAAO;SACR;KACF,CAAC,CAAC;IACH,MAAM,IAAA,8BAAiB,EAAC,EAAE,MAAM,EAAE,UAAU,EAAE,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,CAAC;AACpF,CAAC"}

package/dist/commands/dist.d.ts

@@ -0,0 +1,3 @@
+import type { Command } from 'commander';
+export declare function registerCommand(program: Command): void;
+//# sourceMappingURL=dist.d.ts.map

package/dist/commands/dist.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dist.d.ts","sourceRoot":"","sources":["../../src/commands/dist.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AA4BzC,wBAAgB,eAAe,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CA6BtD"}

package/dist/commands/dist.js

@@ -0,0 +1,142 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerCommand = registerCommand;
+const node_fs_1 = require("node:fs");
+const node_os_1 = require("node:os");
+const node_path_1 = require("node:path");
+const yaml_1 = require("yaml");
+const exit_codes_1 = require("../lib/exit-codes");
+const loader_1 = require("../runtime/config/loader");
+const compose_1 = require("../runtime/distribution/compose");
+const paths_1 = require("../runtime/paths");
+const credentials_1 = require("../runtime/sources/credentials");
+const git_1 = require("../runtime/sources/kinds/git");
+const schema_1 = require("../runtime/sources/schema");
+const DEFAULT_BASE = 'oss';
+const DEFAULT_OUT_DIR = (0, node_path_1.join)((0, node_os_1.homedir)(), '.xema', 'distributions');
+function collect(value, previous) {
+    return [...previous, value];
+}
+function registerCommand(program) {
+    const dist = program.command('dist').summary('Compose a distribution (build your own platform)');
+    dist
+        .command('build')
+        .summary('Compose a distribution from a base edition + your own biomes')
+        .description('Seed a base edition (--base) with its first-party biomes, add your own ' +
+        'biomes from git/workspace sources (--git / --source, or a --config ' +
+        'sources: block), resolve + validate the whole set with the distribution ' +
+        'resolver, and write the distribution (xema-distribution.json + ' +
+        'distribution.lock.json) plus a launch xema.config.yaml.')
+        .requiredOption('--id <name>', 'Id for the composed distribution (kebab-case)')
+        .option('--base <edition>', `Base edition to extend (default: ${DEFAULT_BASE})`)
+        .option('--git <name=url>', 'Add a git biome source (repeatable)', collect, [])
+        .option('--source <name=path>', 'Add a local biome dir / workspace (repeatable)', collect, [])
+        .option('--config <path>', 'Read additional biome sources from a xema.config.yaml')
+        .option('--no-allow-third-party', 'Reject third-party (user) biomes (first-party only)')
+        .option('--out-dir <dir>', `Where to write the distribution (default: ${DEFAULT_OUT_DIR})`)
+        .option('--config-out <path>', 'Also write a launch xema.config.yaml referencing it')
+        .action((opts) => {
+        try {
+            runDistBuild(opts);
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : String(err);
+            (0, exit_codes_1.exitWith)(exit_codes_1.XemaCliExitCode.GenericError, `xema dist build failed: ${message}`);
+        }
+    });
+}
+function runDistBuild(opts) {
+    const id = opts.id;
+    if (id === undefined || !/^[a-z][a-z0-9-]*$/.test(id)) {
+        return (0, exit_codes_1.exitWith)(exit_codes_1.XemaCliExitCode.ConfigurationError, `--id must be lowercase kebab-case (got "${String(id)}").`);
+    }
+    const base = opts.base ?? DEFAULT_BASE;
+    const log = (line) => console.log(`  ${line}`);
+    const specs = [
+        ...(opts.git ?? []).map((s) => gitSpecFrom(s)),
+        ...(opts.source ?? []).map((s) => workspaceSpecFrom(s)),
+        ...sourcesFromConfig(opts.config),
+    ];
+    const credentials = new credentials_1.CredentialResolver();
+    const userSources = specs.map((spec) => resolveSourceRoot(spec, credentials, log));
+    const allowThirdParty = opts.allowThirdParty !== false;
+    console.log(`xema dist build — composing "${id}" from base "${base}"`);
+    console.log('-'.repeat(60));
+    const result = (0, compose_1.composeDistribution)({
+        id,
+        baseEdition: base,
+        userSources,
+        allowThirdParty,
+        resolvedAt: new Date().toISOString(),
+    });
+    const outDir = (0, node_path_1.resolve)(process.cwd(), opts.outDir ?? DEFAULT_OUT_DIR, id);
+    (0, node_fs_1.mkdirSync)(outDir, { recursive: true });
+    (0, node_fs_1.writeFileSync)((0, node_path_1.join)(outDir, 'xema-distribution.json'), `${JSON.stringify(result.definition, null, 2)}\n`, 'utf8');
+    (0, node_fs_1.writeFileSync)((0, node_path_1.join)(outDir, 'distribution.lock.json'), `${JSON.stringify(result.lock, null, 2)}\n`, 'utf8');
+    if (opts.configOut !== undefined) {
+        const configPath = (0, node_path_1.resolve)(process.cwd(), opts.configOut);
+        (0, node_fs_1.writeFileSync)(configPath, renderLaunchConfig(base, specs), 'utf8');
+    }
+    console.log('');
+    console.log(`✓ Composed "${id}": ${String(result.lock.biomes.length)} biome(s) ` +
+        `(${String(result.baseBiomeCount)} base + ${String(result.userBiomeCount)} user` +
+        `${result.overridden.length > 0 ? `, ${String(result.overridden.length)} overridden` : ''}).`);
+    console.log(`  distribution → ${outDir}/`);
+    if (opts.configOut !== undefined) {
+        console.log(`  launch config → ${(0, node_path_1.resolve)(process.cwd(), opts.configOut)}`);
+        console.log('');
+        console.log(`Next: xema dev --config ${opts.configOut}   (native — user biomes run from source)`);
+    }
+    else {
+        console.log('');
+        console.log(`Next: xema up --edition ${id}   (add a launch config with --config-out for your git biomes)`);
+    }
+}
+function resolveSourceRoot(spec, credentials, log) {
+    if (spec.kind === schema_1.SourceKind.Workspace) {
+        const root = spec.root !== undefined ? (0, node_path_1.resolve)(process.cwd(), spec.root) : (0, paths_1.findMonorepoRoot)();
+        if (root === null) {
+            return (0, exit_codes_1.exitWith)(exit_codes_1.XemaCliExitCode.ConfigurationError, `source "${spec.name}": no root (not in a monorepo and no path given).`);
+        }
+        return { name: spec.name, root };
+    }
+    if (spec.kind === schema_1.SourceKind.Git) {
+        log(`cloning ${spec.url}${spec.ref !== undefined ? `@${spec.ref}` : ''} …`);
+        return { name: spec.name, root: (0, git_1.checkoutGitSource)(spec, credentials, log) };
+    }
+    return (0, exit_codes_1.exitWith)(exit_codes_1.XemaCliExitCode.ConfigurationError, `source "${spec.name}" (${spec.kind}) can't seed a composition — use workspace or git ` +
+        `(npm/oci are install-time).`);
+}
+function gitSpecFrom(raw) {
+    const { name, value } = splitNameValue(raw, '--git');
+    return { name, kind: schema_1.SourceKind.Git, url: value };
+}
+function workspaceSpecFrom(raw) {
+    const { name, value } = splitNameValue(raw, '--source');
+    return { name, kind: schema_1.SourceKind.Workspace, root: value };
+}
+function splitNameValue(raw, flag) {
+    const eq = raw.indexOf('=');
+    if (eq <= 0) {
+        return (0, exit_codes_1.exitWith)(exit_codes_1.XemaCliExitCode.ConfigurationError, `${flag} expects <name>=<value>, got "${raw}".`);
+    }
+    return { name: raw.slice(0, eq).trim(), value: raw.slice(eq + 1).trim() };
+}
+function sourcesFromConfig(configPath) {
+    if (configPath === undefined) {
+        return [];
+    }
+    const loaded = (0, loader_1.loadXemaConfig)({ explicit: configPath });
+    return loaded.config.sources.filter((s) => s.kind === schema_1.SourceKind.Workspace || s.kind === schema_1.SourceKind.Git);
+}
+function renderLaunchConfig(baseEdition, sources) {
+    const config = {
+        edition: baseEdition,
+        app: { substrate: 'native' },
+        sources,
+    };
+    const header = '# xema.config.yaml — generated by `xema dist build`\n' +
+        `# Base edition "${baseEdition}" + your biome sources (launched natively from source).\n\n`;
+    return header + (0, yaml_1.stringify)(config, { aliasDuplicateObjects: false });
+}
+//# sourceMappingURL=dist.js.map

package/dist/commands/dist.js.map

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

package/dist/commands/down.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"down.d.ts","sourceRoot":"","sources":["../../src/commands/down.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAczC,wBAAgB,eAAe,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAkBtD"}
+{"version":3,"file":"down.d.ts","sourceRoot":"","sources":["../../src/commands/down.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAiBzC,wBAAgB,eAAe,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAoBtD"}

package/dist/commands/down.js

@@ -2,16 +2,20 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.registerCommand = registerCommand;
 const exit_codes_1 = require("../lib/exit-codes");
+const loader_1 = require("../runtime/config/loader");
 const schema_1 = require("../runtime/config/schema");
 const docker_cli_1 = require("../runtime/runner/docker-cli");
+const helm_cli_1 = require("../runtime/runner/helm-cli");
 function registerCommand(program) {
     program
         .command('down')
-        .summary('Stop everything xema up started (container substrate)')
-        .description('Stop + remove all launcher-owned containers (services + managed infra). ' +
-        'Non-destructive by default; --purge also deletes the named data volumes ' +
-        '(Postgres, object store, search, workspace pools, …).')
-        .option('--purge', 'Also delete persistent data volumes (DESTRUCTIVE)')
+        .summary('Stop everything xema up started (container or helm substrate)')
+        .description('Stop + remove everything the launcher started, per the configured substrate. ' +
+        'Container: remove launcher-owned containers (services + managed infra); ' +
+        '--purge also deletes named data volumes. Helm: uninstall every release in ' +
+        'the namespace (XEMA_NAMESPACE, default "xema").')
+        .option('--config <path>', 'Path to xema.config.yaml (selects the substrate)')
+        .option('--purge', 'Also delete persistent data volumes (DESTRUCTIVE; container substrate)')
         .action(async (opts) => {
         try {
             await runDown(opts);
@@ -23,6 +27,36 @@ function registerCommand(program) {
     });
 }
 async function runDown(opts) {
+    const { config } = (0, loader_1.loadXemaConfig)({ explicit: opts.config });
+    if (config.app.substrate === schema_1.Substrate.Helm) {
+        await runHelmDown(opts);
+        return;
+    }
+    await runContainerDown(opts);
+}
+async function runHelmDown(opts) {
+    const helm = new helm_cli_1.HelmCli();
+    if (!(await helm.available())) {
+        console.log('helm is not reachable — nothing to uninstall.');
+        return;
+    }
+    const releases = await helm.listReleases();
+    if (releases.length === 0) {
+        console.log(`No Helm releases found in namespace "${helm.namespace}".`);
+    }
+    else {
+        console.log(`Uninstalling ${String(releases.length)} release(s) from "${helm.namespace}"...`);
+        for (const release of releases) {
+            await helm.uninstall(release);
+            console.log(`  uninstalled ${release}`);
+        }
+    }
+    if (opts.purge) {
+        console.log('Note: --purge does not delete Kubernetes PersistentVolumeClaims. Persistent ' +
+            'data is retained; remove PVCs with `kubectl delete pvc` if intended.');
+    }
+}
+async function runContainerDown(opts) {
     const docker = new docker_cli_1.DockerCli();
     if (!(await docker.available())) {
         console.log('No container runtime reachable — nothing to stop (native services stop with `xema up`).');

package/dist/commands/down.js.map

@@ -1 +1 @@
-{"version":3,"file":"down.js","sourceRoot":"","sources":["../../src/commands/down.ts"],"names":[],"mappings":";;AAkBA,0CAkBC;AApCD,kDAA8D;AAC9D,qDAA0D;AAC1D,6DAAyD;AAgBzD,SAAgB,eAAe,CAAC,OAAgB;IAC9C,OAAO;SACJ,OAAO,CAAC,MAAM,CAAC;SACf,OAAO,CAAC,uDAAuD,CAAC;SAChE,WAAW,CACV,0EAA0E;QACxE,0EAA0E;QAC1E,uDAAuD,CAC1D;SACA,MAAM,CAAC,SAAS,EAAE,mDAAmD,CAAC;SACtE,MAAM,CAAC,KAAK,EAAE,IAAiB,EAAE,EAAE;QAClC,IAAI,CAAC;YACH,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;QACtB,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,OAAO,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YACjE,IAAA,qBAAQ,EAAC,4BAAe,CAAC,YAAY,EAAE,qBAAqB,OAAO,EAAE,CAAC,CAAC;QACzE,CAAC;IACH,CAAC,CAAC,CAAC;AACP,CAAC;AAED,KAAK,UAAU,OAAO,CAAC,IAAiB;IACtC,MAAM,MAAM,GAAG,IAAI,sBAAS,EAAE,CAAC;IAC/B,IAAI,CAAC,CAAC,MAAM,MAAM,CAAC,SAAS,EAAE,CAAC,EAAE,CAAC;QAChC,OAAO,CAAC,GAAG,CAAC,yFAAyF,CAAC,CAAC;QACvG,OAAO;IACT,CAAC;IACD,MAAM,UAAU,GAAG,MAAM,MAAM,CAAC,kBAAkB,EAAE,CAAC;IACrD,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC5B,OAAO,CAAC,GAAG,CAAC,qCAAqC,CAAC,CAAC;IACrD,CAAC;SAAM,CAAC;QACN,OAAO,CAAC,GAAG,CAAC,YAAY,MAAM,CAAC,UAAU,CAAC,MAAM,CAAC,kBAAkB,CAAC,CAAC;QACrE,KAAK,MAAM,IAAI,IAAI,UAAU,EAAE,CAAC;YAC9B,MAAM,MAAM,CAAC,QAAQ,CAAC,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC;YAC1C,OAAO,CAAC,GAAG,CAAC,aAAa,IAAI,EAAE,CAAC,CAAC;QACnC,CAAC;IACH,CAAC;IAED,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;QACf,OAAO,CAAC,GAAG,CAAC,yBAAyB,CAAC,CAAC;QACvC,KAAK,MAAM,SAAS,IAAI,MAAM,CAAC,MAAM,CAAC,uBAAc,CAAC,EAAE,CAAC;YACtD,MAAM,MAAM,GAAG,QAAQ,SAAS,OAAO,CAAC;YACxC,MAAM,MAAM,CAAC,QAAQ,CAAC,CAAC,QAAQ,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC;YAChD,OAAO,CAAC,GAAG,CAAC,oBAAoB,MAAM,EAAE,CAAC,CAAC;QAC5C,CAAC;IACH,CAAC;SAAM,CAAC;QACN,OAAO,CAAC,GAAG,CAAC,sDAAsD,CAAC,CAAC;IACtE,CAAC;AACH,CAAC"}
+{"version":3,"file":"down.js","sourceRoot":"","sources":["../../src/commands/down.ts"],"names":[],"mappings":";;AAuBA,0CAoBC;AA3CD,kDAA8D;AAC9D,qDAA0D;AAC1D,qDAAqE;AACrE,6DAAyD;AACzD,yDAAqD;AAmBrD,SAAgB,eAAe,CAAC,OAAgB;IAC9C,OAAO;SACJ,OAAO,CAAC,MAAM,CAAC;SACf,OAAO,CAAC,+DAA+D,CAAC;SACxE,WAAW,CACV,+EAA+E;QAC7E,0EAA0E;QAC1E,4EAA4E;QAC5E,iDAAiD,CACpD;SACA,MAAM,CAAC,iBAAiB,EAAE,kDAAkD,CAAC;SAC7E,MAAM,CAAC,SAAS,EAAE,wEAAwE,CAAC;SAC3F,MAAM,CAAC,KAAK,EAAE,IAAiB,EAAE,EAAE;QAClC,IAAI,CAAC;YACH,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;QACtB,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,OAAO,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YACjE,IAAA,qBAAQ,EAAC,4BAAe,CAAC,YAAY,EAAE,qBAAqB,OAAO,EAAE,CAAC,CAAC;QACzE,CAAC;IACH,CAAC,CAAC,CAAC;AACP,CAAC;AAED,KAAK,UAAU,OAAO,CAAC,IAAiB;IACtC,MAAM,EAAE,MAAM,EAAE,GAAG,IAAA,uBAAc,EAAC,EAAE,QAAQ,EAAE,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC;IAC7D,IAAI,MAAM,CAAC,GAAG,CAAC,SAAS,KAAK,kBAAS,CAAC,IAAI,EAAE,CAAC;QAC5C,MAAM,WAAW,CAAC,IAAI,CAAC,CAAC;QACxB,OAAO;IACT,CAAC;IACD,MAAM,gBAAgB,CAAC,IAAI,CAAC,CAAC;AAC/B,CAAC;AAGD,KAAK,UAAU,WAAW,CAAC,IAAiB;IAC1C,MAAM,IAAI,GAAG,IAAI,kBAAO,EAAE,CAAC;IAC3B,IAAI,CAAC,CAAC,MAAM,IAAI,CAAC,SAAS,EAAE,CAAC,EAAE,CAAC;QAC9B,OAAO,CAAC,GAAG,CAAC,+CAA+C,CAAC,CAAC;QAC7D,OAAO;IACT,CAAC;IACD,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,YAAY,EAAE,CAAC;IAC3C,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC1B,OAAO,CAAC,GAAG,CAAC,wCAAwC,IAAI,CAAC,SAAS,IAAI,CAAC,CAAC;IAC1E,CAAC;SAAM,CAAC;QACN,OAAO,CAAC,GAAG,CAAC,gBAAgB,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,qBAAqB,IAAI,CAAC,SAAS,MAAM,CAAC,CAAC;QAC9F,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;YAC/B,MAAM,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;YAC9B,OAAO,CAAC,GAAG,CAAC,iBAAiB,OAAO,EAAE,CAAC,CAAC;QAC1C,CAAC;IACH,CAAC;IACD,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;QAGf,OAAO,CAAC,GAAG,CACT,8EAA8E;YAC5E,sEAAsE,CACzE,CAAC;IACJ,CAAC;AACH,CAAC;AAGD,KAAK,UAAU,gBAAgB,CAAC,IAAiB;IAC/C,MAAM,MAAM,GAAG,IAAI,sBAAS,EAAE,CAAC;IAC/B,IAAI,CAAC,CAAC,MAAM,MAAM,CAAC,SAAS,EAAE,CAAC,EAAE,CAAC;QAChC,OAAO,CAAC,GAAG,CAAC,yFAAyF,CAAC,CAAC;QACvG,OAAO;IACT,CAAC;IACD,MAAM,UAAU,GAAG,MAAM,MAAM,CAAC,kBAAkB,EAAE,CAAC;IACrD,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC5B,OAAO,CAAC,GAAG,CAAC,qCAAqC,CAAC,CAAC;IACrD,CAAC;SAAM,CAAC;QACN,OAAO,CAAC,GAAG,CAAC,YAAY,MAAM,CAAC,UAAU,CAAC,MAAM,CAAC,kBAAkB,CAAC,CAAC;QACrE,KAAK,MAAM,IAAI,IAAI,UAAU,EAAE,CAAC;YAC9B,MAAM,MAAM,CAAC,QAAQ,CAAC,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC;YAC1C,OAAO,CAAC,GAAG,CAAC,aAAa,IAAI,EAAE,CAAC,CAAC;QACnC,CAAC;IACH,CAAC;IAED,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;QACf,OAAO,CAAC,GAAG,CAAC,yBAAyB,CAAC,CAAC;QACvC,KAAK,MAAM,SAAS,IAAI,MAAM,CAAC,MAAM,CAAC,uBAAc,CAAC,EAAE,CAAC;YACtD,MAAM,MAAM,GAAG,QAAQ,SAAS,OAAO,CAAC;YACxC,MAAM,MAAM,CAAC,QAAQ,CAAC,CAAC,QAAQ,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC;YAChD,OAAO,CAAC,GAAG,CAAC,oBAAoB,MAAM,EAAE,CAAC,CAAC;QAC5C,CAAC;IACH,CAAC;SAAM,CAAC;QACN,OAAO,CAAC,GAAG,CAAC,sDAAsD,CAAC,CAAC;IACtE,CAAC;AACH,CAAC"}

package/dist/commands/init.d.ts

@@ -0,0 +1,3 @@
+import type { Command } from 'commander';
+export declare function registerCommand(program: Command): void;
+//# sourceMappingURL=init.d.ts.map

package/dist/commands/init.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../src/commands/init.ts"],"names":[],"mappings":"AAkBA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAqBzC,wBAAgB,eAAe,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAuBtD"}

package/dist/commands/init.js

@@ -0,0 +1,192 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerCommand = registerCommand;
+const node_fs_1 = require("node:fs");
+const node_path_1 = require("node:path");
+const promises_1 = require("node:readline/promises");
+const yaml_1 = require("yaml");
+const exit_codes_1 = require("../lib/exit-codes");
+const init_presets_1 = require("../runtime/config/init-presets");
+const paths_1 = require("../runtime/paths");
+const DEFAULT_OUTPUT = 'xema.config.yaml';
+const DEFAULT_PRESET = init_presets_1.InitPreset.LocalContainer;
+function registerCommand(program) {
+    program
+        .command('init')
+        .summary('Scaffold a xema.config.yaml (interactive or --preset)')
+        .description('Create a xema.config.yaml. Run with no flags for an interactive wizard ' +
+        `over the real scenarios (${init_presets_1.INIT_PRESETS.join(', ')}), or pass --preset ` +
+        '<name> (+ --yes) to generate one non-interactively.')
+        .option('--preset <name>', `One of: ${init_presets_1.INIT_PRESETS.join(' | ')}`)
+        .option('--output <path>', `Output path (default: ${DEFAULT_OUTPUT})`)
+        .option('--edition <id>', 'Distribution edition (default: oss)')
+        .option('--web', 'Enable the web host shell (where the preset supports it)')
+        .option('--yes', 'Non-interactive: accept defaults (preset defaults to local-container)')
+        .option('--force', 'Overwrite an existing config file')
+        .action(async (opts) => {
+        try {
+            await runInit(opts);
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : String(err);
+            (0, exit_codes_1.exitWith)(exit_codes_1.XemaCliExitCode.GenericError, `xema init failed: ${message}`);
+        }
+    });
+}
+async function runInit(opts) {
+    const outputPath = (0, node_path_1.resolve)(process.cwd(), opts.output ?? DEFAULT_OUTPUT);
+    if ((0, node_fs_1.existsSync)(outputPath) && opts.force !== true) {
+        return (0, exit_codes_1.exitWith)(exit_codes_1.XemaCliExitCode.ConfigurationError, `${outputPath} already exists. Pass --force to overwrite, or --output <path> to write elsewhere.`);
+    }
+    const resolved = await resolvePresetAndInputs(opts);
+    warnIfUnknownEdition(resolved.inputs.edition);
+    const config = (0, init_presets_1.buildPresetConfig)(resolved.preset, resolved.inputs);
+    const meta = init_presets_1.PRESET_METAS[resolved.preset];
+    (0, node_fs_1.writeFileSync)(outputPath, renderConfigFile(resolved.preset, config), 'utf8');
+    console.log('');
+    console.log(`✓ Wrote ${outputPath}  (${meta.label})`);
+    console.log('');
+    console.log('Next steps:');
+    if (meta.needsExternalInfra) {
+        console.log('  1. Make sure your infra is running (or run `xema doctor --infra`).');
+        console.log(`  2. ${meta.nextStep}`);
+    }
+    else {
+        console.log(`  • ${meta.nextStep}`);
+    }
+    console.log('');
+    console.log('Tune it later: infra modes (managed | external <url> | disabled), app.substrate,');
+    console.log('app.include, and a `sources:` block for extra biome registries (see `xema doctor --sources`).');
+}
+async function resolvePresetAndInputs(opts) {
+    if (opts.preset !== undefined) {
+        const preset = (0, init_presets_1.parseInitPreset)(opts.preset);
+        if (preset === null) {
+            return (0, exit_codes_1.exitWith)(exit_codes_1.XemaCliExitCode.ConfigurationError, `Unknown --preset "${opts.preset}". Valid: ${init_presets_1.INIT_PRESETS.join(', ')}.`);
+        }
+        return { preset, inputs: inputsFromFlags(opts) };
+    }
+    if (opts.yes === true) {
+        return { preset: DEFAULT_PRESET, inputs: inputsFromFlags(opts) };
+    }
+    if (process.stdin.isTTY !== true || process.stdout.isTTY !== true) {
+        return (0, exit_codes_1.exitWith)(exit_codes_1.XemaCliExitCode.ConfigurationError, 'Not a TTY — cannot run the interactive wizard. Pass --preset <name> ' +
+            `(${init_presets_1.INIT_PRESETS.join(' | ')}) or --yes.`);
+    }
+    return runWizard(opts);
+}
+function warnIfUnknownEdition(edition) {
+    const available = (0, paths_1.listAvailableEditions)();
+    if (available.length > 0 && !available.includes(edition)) {
+        console.log(`⚠  edition "${edition}" is not among the known distributions ` +
+            `(${available.join(', ')}); \`xema up\` will fail unless its lock is provided ` +
+            `via --lock / XEMA_DISTRIBUTION_LOCK_PATH.`);
+    }
+}
+function inputsFromFlags(opts) {
+    return {
+        edition: opts.edition ?? 'oss',
+        web: opts.web === true,
+    };
+}
+async function runWizard(opts) {
+    const rl = (0, promises_1.createInterface)({ input: process.stdin, output: process.stdout });
+    try {
+        console.log('xema init — scaffold a xema.config.yaml');
+        console.log('-'.repeat(50));
+        const presets = init_presets_1.INIT_PRESETS;
+        const choice = await promptChoice(rl, 'What are you setting up?', presets.map((p) => {
+            const m = init_presets_1.PRESET_METAS[p];
+            return { label: m.label, hint: m.description };
+        }));
+        const preset = presets[choice] ?? DEFAULT_PRESET;
+        const meta = init_presets_1.PRESET_METAS[preset];
+        const edition = await promptEdition(rl, opts.edition ?? 'oss');
+        let urls = {};
+        if (meta.needsExternalInfra) {
+            console.log('');
+            console.log('External infrastructure URLs (press Enter to accept the local default):');
+            urls = await promptExternalInfra(rl, preset);
+        }
+        let web = opts.web === true;
+        if (meta.supportsWeb) {
+            web = await promptYesNo(rl, 'Start the web host shell?', false);
+        }
+        return { preset, inputs: { edition, web, ...urls } };
+    }
+    finally {
+        rl.close();
+    }
+}
+async function promptExternalInfra(rl, preset) {
+    const out = {};
+    out.postgresUrl = await promptText(rl, '  Postgres URL', init_presets_1.DEFAULT_LOCAL_URLS.postgres);
+    if (preset === init_presets_1.InitPreset.LocalMonolith) {
+        out.redisUrl = await promptText(rl, '  Redis URL', init_presets_1.DEFAULT_LOCAL_URLS.redis);
+    }
+    out.keycloakUrl = await promptText(rl, '  Keycloak URL', init_presets_1.DEFAULT_LOCAL_URLS.keycloak);
+    out.keycloakRealm = await promptText(rl, '  Keycloak realm', init_presets_1.DEFAULT_LOCAL_URLS.keycloakRealm);
+    if (preset === init_presets_1.InitPreset.ByoInfra) {
+        out.objectStoreUrl = await promptText(rl, '  Object-store URL', init_presets_1.DEFAULT_LOCAL_URLS.objectStore);
+    }
+    return out;
+}
+async function promptChoice(rl, question, items) {
+    console.log('');
+    console.log(question);
+    items.forEach((item, i) => {
+        console.log(`  ${String(i + 1)}) ${item.label}`);
+        if (item.hint !== undefined) {
+            console.log(`     ${item.hint}`);
+        }
+    });
+    for (;;) {
+        const raw = (await rl.question(`Choice [1-${String(items.length)}] (1): `)).trim();
+        if (raw.length === 0) {
+            return 0;
+        }
+        const n = Number.parseInt(raw, 10);
+        if (Number.isInteger(n) && n >= 1 && n <= items.length) {
+            return n - 1;
+        }
+        console.log(`  Please enter a number between 1 and ${String(items.length)}.`);
+    }
+}
+async function promptEdition(rl, def) {
+    const available = (0, paths_1.listAvailableEditions)();
+    if (available.length === 0) {
+        return promptText(rl, 'Distribution edition', def);
+    }
+    const ordered = available.includes(def) ? [def, ...available.filter((e) => e !== def)] : [def, ...available];
+    const idx = await promptChoice(rl, 'Distribution edition (defined by xema-distributions)', ordered.map((e) => ({ label: e })));
+    return ordered[idx] ?? def;
+}
+async function promptText(rl, question, def) {
+    const raw = (await rl.question(`${question} (${def}): `)).trim();
+    return raw.length > 0 ? raw : def;
+}
+async function promptYesNo(rl, question, def) {
+    const suffix = def ? '(Y/n)' : '(y/N)';
+    const raw = (await rl.question(`${question} ${suffix}: `)).trim().toLowerCase();
+    if (raw.length === 0) {
+        return def;
+    }
+    return raw === 'y' || raw === 'yes';
+}
+function renderConfigFile(preset, config) {
+    const meta = init_presets_1.PRESET_METAS[preset];
+    const header = [
+        '# xema.config.yaml',
+        `# Generated by \`xema init\` — preset: ${preset}`,
+        `# ${meta.description}`,
+        '#',
+        `# Next: ${meta.nextStep}`,
+        '# Infra modes: managed (launcher runs it) | external (give a url) | disabled.',
+        '# Full annotated reference + more scenarios:',
+        '#   https://github.com/xema-dev/xema-cli/tree/main/apps/xema-cli/examples',
+        '',
+        '',
+    ].join('\n');
+    return header + (0, yaml_1.stringify)(config, { aliasDuplicateObjects: false });
+}
+//# sourceMappingURL=init.js.map