@xemahq/xema 0.13.0 → 0.14.0

package/dist/commands/serve.js

@@ -1,60 +1,80 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.registerCommand = registerCommand;
+const cli_errors_1 = require("../lib/cli-errors");
 const exit_codes_1 = require("../lib/exit-codes");
+const roster_profile_1 = require("../lib/roster-profile");
 const loader_1 = require("../runtime/config/loader");
 const schema_1 = require("../runtime/config/schema");
 const foreground_1 = require("../runtime/foreground");
+const launch_1 = require("../runtime/launch");
+const launch_plan_format_1 = require("../runtime/launch-plan-format");
 function registerCommand(program) {
     program
         .command('serve')
         .summary('Boot Xema as separate processes (self-host)')
-        .description('Multi-process self-host launcher. --profile selects the substrate: ' +
+        .description('Multi-process self-host launcher. --substrate selects the substrate: ' +
         'single-instance (native host processes) or cluster (containers).')
-        .requiredOption('--profile <profile>', 'Deployment profile: single-instance | cluster | appliance')
+        .requiredOption('--substrate <substrate>', 'Deployment substrate: single-instance | cluster | appliance')
         .option('--config <path>', 'Path to xema.config.yaml')
         .option('--web', 'Also start the host-shell frontend')
         .option('--only <services>', 'Boot only these comma-separated services (+ their hard prerequisites)')
+        .option('--profile <profile>', roster_profile_1.PROFILE_OPTION_DESCRIPTION)
+        .option('--dry-run', 'Preview the resolved roster, waves, and ports — do not boot anything.')
         .action(async (opts) => {
         try {
             await runServe(opts);
         }
         catch (err) {
             const message = err instanceof Error ? err.message : String(err);
-            (0, exit_codes_1.exitWith)(exit_codes_1.XemaCliExitCode.GenericError, `xema serve failed: ${message}`);
+            (0, exit_codes_1.exitWith)((0, cli_errors_1.lifecycleExitCode)(err), `xema serve failed: ${message}`);
         }
     });
 }
 async function runServe(opts) {
-    const substrate = profileToSubstrate(opts.profile);
-    const loaded = (0, loader_1.loadXemaConfig)({ explicit: opts.config });
+    const substrate = substrateOptionToSubstrate(opts.substrate);
+    const loaded = (0, cli_errors_1.asConfigError)(() => (0, loader_1.loadXemaConfig)({ explicit: opts.config }));
     const appConfig = { ...loaded.config.app, substrate };
+    (0, roster_profile_1.assertProfileExclusiveWithSubset)(opts.profile !== undefined, opts.only !== undefined, '--only');
+    if (opts.profile !== undefined) {
+        appConfig.include = (0, roster_profile_1.profileToInclude)((0, roster_profile_1.parseRosterProfile)(opts.profile));
+    }
     if (opts.only !== undefined) {
         const services = opts.only
             .split(',')
             .map((s) => s.trim())
             .filter((s) => s.length > 0);
         if (services.length === 0) {
-            throw new Error('--only requires at least one service name.');
+            throw new cli_errors_1.CliConfigurationError('--only requires at least one service name.');
         }
         appConfig.include = services;
     }
     const config = { ...loaded.config, app: appConfig };
-    console.log(`xema serve — profile=${opts.profile} (substrate=${substrate})`);
+    const includeWeb = Boolean(opts.web) || config.app.web.enabled;
+    if (opts.dryRun === true) {
+        console.log((0, launch_plan_format_1.formatLaunchPlan)((0, launch_1.resolveLaunchPlan)({ config, includeWeb, offline: true })));
+        return;
+    }
+    console.log(`xema serve — substrate=${opts.substrate} (${substrate})`);
     console.log(`  config: ${loaded.source}`);
     console.log('');
-    await (0, foreground_1.bringUpForeground)({ config, includeWeb: Boolean(opts.web), detach: false });
+    await (0, foreground_1.bringUpForeground)({
+        config,
+        includeWeb,
+        detach: false,
+        installationIdentity: loaded.installationIdentity,
+    });
 }
-function profileToSubstrate(profile) {
-    if (profile === 'single-instance') {
+function substrateOptionToSubstrate(substrate) {
+    if (substrate === 'single-instance') {
         return schema_1.Substrate.Native;
     }
-    if (profile === 'cluster') {
+    if (substrate === 'cluster') {
         return schema_1.Substrate.Container;
     }
-    if (profile === 'appliance') {
+    if (substrate === 'appliance') {
         return schema_1.Substrate.Helm;
     }
-    throw new Error(`Unknown --profile "${profile}". Valid values: single-instance | cluster | appliance.`);
+    throw new cli_errors_1.CliConfigurationError(`Unknown --substrate "${substrate}". Valid values: single-instance | cluster | appliance.`);
 }
 //# sourceMappingURL=serve.js.map

package/dist/commands/serve.js.map

@@ -1 +1 @@
-{"version":3,"file":"serve.js","sourceRoot":"","sources":["../../src/commands/serve.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"serve.js","sourceRoot":"","sources":["../../src/commands/serve.ts"],"names":[],"mappings":";;AA2CA,0CA+BC;AA1ED,kDAI2B;AAC3B,kDAA6C;AAC7C,0DAK+B;AAC/B,qDAA0D;AAC1D,qDAAqD;AACrD,sDAA0D;AAC1D,8CAAsD;AACtD,sEAAiE;AA2BjE,SAAgB,eAAe,CAAC,OAAgB;IAC9C,OAAO;SACJ,OAAO,CAAC,OAAO,CAAC;SAChB,OAAO,CAAC,6CAA6C,CAAC;SACtD,WAAW,CACV,uEAAuE;QACrE,kEAAkE,CACrE;SACA,cAAc,CACb,yBAAyB,EACzB,6DAA6D,CAC9D;SACA,MAAM,CAAC,iBAAiB,EAAE,0BAA0B,CAAC;SACrD,MAAM,CAAC,OAAO,EAAE,oCAAoC,CAAC;SACrD,MAAM,CACL,mBAAmB,EACnB,uEAAuE,CACxE;SACA,MAAM,CAAC,qBAAqB,EAAE,2CAA0B,CAAC;SACzD,MAAM,CACL,WAAW,EACX,uEAAuE,CACxE;SACA,MAAM,CAAC,KAAK,EAAE,IAAkB,EAAE,EAAE;QACnC,IAAI,CAAC;YACH,MAAM,QAAQ,CAAC,IAAI,CAAC,CAAC;QACvB,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,IAAA,8BAAiB,EAAC,GAAG,CAAC,EAAE,sBAAsB,OAAO,EAAE,CAAC,CAAC;QACpE,CAAC;IACH,CAAC,CAAC,CAAC;AACP,CAAC;AAED,KAAK,UAAU,QAAQ,CAAC,IAAkB;IACxC,MAAM,SAAS,GAAG,0BAA0B,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IAC7D,MAAM,MAAM,GAAG,IAAA,0BAAa,EAAC,GAAG,EAAE,CAAC,IAAA,uBAAc,EAAC,EAAE,QAAQ,EAAE,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;IAC9E,MAAM,SAAS,GAAG,EAAE,GAAG,MAAM,CAAC,MAAM,CAAC,GAAG,EAAE,SAAS,EAAE,CAAC;IACtD,IAAA,iDAAgC,EAC9B,IAAI,CAAC,OAAO,KAAK,SAAS,EAC1B,IAAI,CAAC,IAAI,KAAK,SAAS,EACvB,QAAQ,CACT,CAAC;IACF,IAAI,IAAI,CAAC,OAAO,KAAK,SAAS,EAAE,CAAC;QAC/B,SAAS,CAAC,OAAO,GAAG,IAAA,iCAAgB,EAAC,IAAA,mCAAkB,EAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC;IACzE,CAAC;IACD,IAAI,IAAI,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;QAC5B,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI;aACvB,KAAK,CAAC,GAAG,CAAC;aACV,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;aACpB,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;QAC/B,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC1B,MAAM,IAAI,kCAAqB,CAC7B,4CAA4C,CAC7C,CAAC;QACJ,CAAC;QACD,SAAS,CAAC,OAAO,GAAG,QAAQ,CAAC;IAC/B,CAAC;IACD,MAAM,MAAM,GAAG,EAAE,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,EAAE,SAAS,EAAE,CAAC;IACpD,MAAM,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,OAAO,CAAC;IAE/D,IAAI,IAAI,CAAC,MAAM,KAAK,IAAI,EAAE,CAAC;QACzB,OAAO,CAAC,GAAG,CACT,IAAA,qCAAgB,EACd,IAAA,0BAAiB,EAAC,EAAE,MAAM,EAAE,UAAU,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CACzD,CACF,CAAC;QACF,OAAO;IACT,CAAC;IAED,OAAO,CAAC,GAAG,CAAC,0BAA0B,IAAI,CAAC,SAAS,KAAK,SAAS,GAAG,CAAC,CAAC;IACvE,OAAO,CAAC,GAAG,CAAC,aAAa,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC;IAC1C,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAEhB,MAAM,IAAA,8BAAiB,EAAC;QACtB,MAAM;QACN,UAAU;QACV,MAAM,EAAE,KAAK;QACb,oBAAoB,EAAE,MAAM,CAAC,oBAAoB;KAClD,CAAC,CAAC;AACL,CAAC;AAED,SAAS,0BAA0B,CAAC,SAAiB;IACnD,IAAI,SAAS,KAAK,iBAAiB,EAAE,CAAC;QACpC,OAAO,kBAAS,CAAC,MAAM,CAAC;IAC1B,CAAC;IACD,IAAI,SAAS,KAAK,SAAS,EAAE,CAAC;QAC5B,OAAO,kBAAS,CAAC,SAAS,CAAC;IAC7B,CAAC;IACD,IAAI,SAAS,KAAK,WAAW,EAAE,CAAC;QAC9B,OAAO,kBAAS,CAAC,IAAI,CAAC;IACxB,CAAC;IACD,MAAM,IAAI,kCAAqB,CAC7B,wBAAwB,SAAS,yDAAyD,CAC3F,CAAC;AACJ,CAAC"}

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

@@ -1 +1 @@
-{"version":3,"file":"shell.d.ts","sourceRoot":"","sources":["../../src/commands/shell.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAQzC,wBAAgB,eAAe,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAetD"}
+{"version":3,"file":"shell.d.ts","sourceRoot":"","sources":["../../src/commands/shell.ts"],"names":[],"mappings":"AAiBA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAyBzC,wBAAgB,eAAe,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAgBtD"}

package/dist/commands/shell.js

@@ -1,16 +1,200 @@
 "use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.registerCommand = registerCommand;
+const readline = __importStar(require("node:readline"));
+const control_plane_1 = require("../lib/control-plane");
 const exit_codes_1 = require("../lib/exit-codes");
+const capability_invoke_1 = require("../runtime/capability-invoke");
+const PROMPT = 'xema> ';
 function registerCommand(program) {
     program
         .command('shell')
-        .summary('Launch the interactive Xema shell (STUB)')
-        .description('Interactive REPL routing commands through xema-capability-router. ' +
-        'Implementation lands in Phase F.1 once shell built-ins become ' +
-        'embedded biomes.')
-        .action(() => {
-        (0, exit_codes_1.exitWith)(exit_codes_1.XemaCliExitCode.NotImplemented, 'xema shell: interactive shell coming in Phase F.1 embedded biomes.');
+        .summary('Launch the interactive Xema capability shell (REPL)')
+        .description('Interactive REPL. Each line `<capabilityRef> [inputJson]` invokes a ' +
+        'capability through xema-capability-router (same path as `xema run`). ' +
+        'Built-ins: help, exit/quit. Ctrl-D exits.')
+        .option('--environment <ref>', 'Execution environment ref', capability_invoke_1.DEFAULT_ENVIRONMENT)
+        .option('--org <id>', 'Tenant org id (default: resolved from the token)')
+        .option('--endpoint <url>', 'Platform API base URL fronting capability-router (or env XEMA_ENDPOINT)')
+        .option('--token <jwt>', 'Bearer token (or env XEMA_TOKEN)')
+        .action(async (opts) => {
+        await runShell(opts);
     });
 }
+async function runShell(opts) {
+    const target = (0, control_plane_1.resolveTarget)(opts);
+    let subject;
+    let environment;
+    try {
+        subject = (0, capability_invoke_1.resolveSubject)(target.token);
+        environment = (0, capability_invoke_1.parseEnvironment)(opts.environment);
+    }
+    catch (err) {
+        return (0, exit_codes_1.exitWith)(exit_codes_1.XemaCliExitCode.ConfigurationError, err instanceof Error ? err.message : String(err));
+    }
+    try {
+        await (0, capability_invoke_1.assertRouterReachable)(target);
+    }
+    catch (err) {
+        return (0, exit_codes_1.exitWith)(exit_codes_1.XemaCliExitCode.GenericError, err instanceof Error ? err.message : String(err));
+    }
+    const session = {
+        target,
+        subject,
+        environment,
+        ...(opts.org !== undefined ? { orgId: opts.org } : {}),
+    };
+    const rl = readline.createInterface({
+        input: process.stdin,
+        output: process.stdout,
+    });
+    const reader = createLineReader(rl);
+    const reprompt = () => {
+        if (!reader.closed()) {
+            rl.prompt();
+        }
+    };
+    console.log(`Xema shell — subject ${subject.kind}:${subject.ref}, environment ${environment}.\n` +
+        "Type a capability ref (e.g. `kb:page.read@1 {\"id\":\"x\"}`), `help`, or `exit`.");
+    rl.setPrompt(PROMPT);
+    reprompt();
+    for (;;) {
+        const line = await reader.next();
+        if (line === null) {
+            break;
+        }
+        const trimmed = line.trim();
+        if (trimmed.length === 0) {
+            reprompt();
+            continue;
+        }
+        if (trimmed === 'exit' || trimmed === 'quit') {
+            break;
+        }
+        if (trimmed === 'help') {
+            printHelp();
+            reprompt();
+            continue;
+        }
+        await dispatchLine(session, trimmed);
+        reprompt();
+    }
+    rl.close();
+    console.log('Bye.');
+    (0, exit_codes_1.exitWith)(exit_codes_1.XemaCliExitCode.Ok);
+}
+function createLineReader(rl) {
+    const buffered = [];
+    let waiting = null;
+    let isClosed = false;
+    rl.on('line', (line) => {
+        if (waiting !== null) {
+            const resolve = waiting;
+            waiting = null;
+            resolve(line);
+        }
+        else {
+            buffered.push(line);
+        }
+    });
+    rl.on('close', () => {
+        isClosed = true;
+        if (waiting !== null) {
+            const resolve = waiting;
+            waiting = null;
+            resolve(null);
+        }
+    });
+    return {
+        next: () => new Promise((resolve) => {
+            const nextLine = buffered.shift();
+            if (nextLine !== undefined) {
+                resolve(nextLine);
+            }
+            else if (isClosed) {
+                resolve(null);
+            }
+            else {
+                waiting = resolve;
+            }
+        }),
+        closed: () => isClosed,
+    };
+}
+async function dispatchLine(session, line) {
+    const firstSpace = line.search(/\s/);
+    const ref = firstSpace === -1 ? line : line.slice(0, firstSpace);
+    const rest = firstSpace === -1 ? '' : line.slice(firstSpace + 1).trim();
+    let input;
+    if (rest.length > 0) {
+        try {
+            input = (0, capability_invoke_1.parseInputObject)((0, capability_invoke_1.readInputSource)(rest));
+        }
+        catch (err) {
+            console.error(`  input error: ${err instanceof Error ? err.message : String(err)}`);
+            return;
+        }
+    }
+    try {
+        const result = await (0, capability_invoke_1.invokeCapability)(session.target, {
+            ref,
+            subject: session.subject,
+            environment: session.environment,
+            ...(input !== undefined ? { input } : {}),
+            ...(session.orgId !== undefined ? { orgId: session.orgId } : {}),
+        });
+        console.log((0, capability_invoke_1.formatInvokeResult)(result));
+    }
+    catch (err) {
+        if (err instanceof capability_invoke_1.CapabilityInvokeError) {
+            console.error(`  ${err.message}`);
+            return;
+        }
+        throw err;
+    }
+}
+function printHelp() {
+    console.log([
+        'Commands:',
+        '  <capabilityRef> [inputJson]   invoke a capability (input is inline JSON or @file.json)',
+        '  help                          show this help',
+        '  exit | quit                   leave the shell (or press Ctrl-D)',
+        '',
+        'Example:',
+        '  kb:page.read@1 {"id":"page-123"}',
+    ].join('\n'));
+}
 //# sourceMappingURL=shell.js.map

package/dist/commands/shell.js.map

@@ -1 +1 @@
-{"version":3,"file":"shell.js","sourceRoot":"","sources":["../../src/commands/shell.ts"],"names":[],"mappings":";;AAUA,0CAeC;AAzBD,kDAA8D;AAU9D,SAAgB,eAAe,CAAC,OAAgB;IAC9C,OAAO;SACJ,OAAO,CAAC,OAAO,CAAC;SAChB,OAAO,CAAC,0CAA0C,CAAC;SACnD,WAAW,CACV,oEAAoE;QAClE,gEAAgE;QAChE,kBAAkB,CACrB;SACA,MAAM,CAAC,GAAG,EAAE;QACX,IAAA,qBAAQ,EACN,4BAAe,CAAC,cAAc,EAC9B,oEAAoE,CACrE,CAAC;IACJ,CAAC,CAAC,CAAC;AACP,CAAC"}
+{"version":3,"file":"shell.js","sourceRoot":"","sources":["../../src/commands/shell.ts"],"names":[],"mappings":"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"}

package/dist/commands/source.d.ts

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

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

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

package/dist/commands/source.js

@@ -0,0 +1,120 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerCommand = registerCommand;
+const exit_codes_1 = require("../lib/exit-codes");
+const sources_config_1 = require("../runtime/config/sources-config");
+const schema_1 = require("../runtime/sources/schema");
+function registerCommand(program) {
+    const source = program
+        .command('source')
+        .summary('Add / remove / list biome sources (registries)')
+        .description('Manage the Biome Source Registry — WHERE biomes resolve from ' +
+        '(workspace | distribution | npm | oci | git). Like `helm repo add|list` ' +
+        'or `add-apt-repository`. Sources compose by precedence; a workspace ' +
+        'checkout always wins.');
+    source
+        .command('list')
+        .summary('List configured biome sources')
+        .description('List sources from the project (./xema.config.yaml) and user (~/.xema/config.yaml) config.')
+        .action(() => {
+        let printed = 0;
+        for (const [label, path] of [
+            ['project', (0, sources_config_1.localConfigFile)()],
+            ['user', sources_config_1.USER_CONFIG_FILE],
+        ]) {
+            const sources = (0, sources_config_1.readSources)(path);
+            if (sources.length === 0) {
+                continue;
+            }
+            console.log(`${label}  (${path})`);
+            for (const s of sources) {
+                console.log(`  ${s.name.padEnd(20)} ${s.kind.padEnd(13)} ${describeSource(s)}`);
+            }
+            printed += sources.length;
+        }
+        if (printed === 0) {
+            console.log('No biome sources configured. Add one with `xema source add <name> <kind> …`.');
+        }
+    });
+    source
+        .command('add <name> <kind>')
+        .summary('Add a biome source (kind: git | npm | oci | distribution | workspace)')
+        .option('--global', 'Write to ~/.xema/config.yaml (user-wide) instead of ./xema.config.yaml')
+        .option('--url <url>', 'git: repository URL (http(s), required for git)')
+        .option('--registry <host>', 'oci: registry host (required for oci)')
+        .option('--registry-url <url>', 'npm: registry URL (default: npmjs)')
+        .option('--scope <scope>', 'npm: package scope to route here (e.g. @acme-biomes)')
+        .option('--edition <id>', 'distribution: edition id (required for distribution)')
+        .option('--ref <ref>', 'git/distribution: ref, tag, or branch')
+        .option('--root <dir>', 'workspace: root directory (default: auto-detected)')
+        .option('--auth-token-env <VAR>', 'name of the env var holding the auth token (private sources)')
+        .action((name, kind, opts) => {
+        try {
+            const spec = buildSpec(name, kind, opts);
+            const target = (0, sources_config_1.sourcesConfigTarget)(opts.global === true);
+            const { path } = (0, sources_config_1.addSource)(target, spec);
+            console.log(`Added source "${name}" (${kind}) to ${path}.`);
+        }
+        catch (err) {
+            (0, exit_codes_1.exitWith)(exit_codes_1.XemaCliExitCode.ConfigurationError, `xema source add: ${err instanceof Error ? err.message : String(err)}`);
+        }
+    });
+    source
+        .command('remove <name>')
+        .alias('rm')
+        .summary('Remove a biome source by name')
+        .option('--global', 'Remove from ~/.xema/config.yaml instead of ./xema.config.yaml')
+        .action((name, opts) => {
+        try {
+            const target = (0, sources_config_1.sourcesConfigTarget)(opts.global === true);
+            const { path, removed } = (0, sources_config_1.removeSource)(target, name);
+            if (!removed) {
+                return (0, exit_codes_1.exitWith)(exit_codes_1.XemaCliExitCode.NotFound, `No source named "${name}" in ${path}.`);
+            }
+            console.log(`Removed source "${name}" from ${path}.`);
+        }
+        catch (err) {
+            (0, exit_codes_1.exitWith)(exit_codes_1.XemaCliExitCode.ConfigurationError, `xema source remove: ${err instanceof Error ? err.message : String(err)}`);
+        }
+    });
+}
+function buildSpec(name, kind, opts) {
+    const authTokenEnv = opts.authTokenEnv;
+    switch (kind) {
+        case schema_1.SourceKind.Git:
+            return { name, kind, url: opts.url, ...(opts.ref && { ref: opts.ref }), ...(authTokenEnv && { authTokenEnv }) };
+        case schema_1.SourceKind.Npm:
+            return {
+                name,
+                kind,
+                ...(opts.registryUrl && { registryUrl: opts.registryUrl }),
+                ...(opts.scope && { scope: opts.scope }),
+                ...(authTokenEnv && { authTokenEnv }),
+            };
+        case schema_1.SourceKind.Oci:
+            return { name, kind, registry: opts.registry, ...(authTokenEnv && { authTokenEnv }) };
+        case schema_1.SourceKind.Distribution:
+            return { name, kind, edition: opts.edition, ...(opts.ref && { ref: opts.ref }) };
+        case schema_1.SourceKind.Workspace:
+            return { name, kind, ...(opts.root && { root: opts.root }) };
+        default:
+            throw new Error(`unknown source kind "${kind}" — expected one of: ` +
+                `${Object.values(schema_1.SourceKind).join(', ')}`);
+    }
+}
+function describeSource(s) {
+    const auth = 'authTokenEnv' in s && s.authTokenEnv ? ` (auth: $${s.authTokenEnv})` : '';
+    switch (s.kind) {
+        case schema_1.SourceKind.Git:
+            return `${s.url}${s.ref ? `@${s.ref}` : ''}${auth}`;
+        case schema_1.SourceKind.Npm:
+            return `${s.registryUrl ?? 'npmjs'}${s.scope ? ` ${s.scope}` : ''}${auth}`;
+        case schema_1.SourceKind.Oci:
+            return `${s.registry}${auth}`;
+        case schema_1.SourceKind.Distribution:
+            return `edition=${s.edition}${s.ref ? `@${s.ref}` : ''}`;
+        case schema_1.SourceKind.Workspace:
+            return s.root ?? '(auto-detected root)';
+    }
+}
+//# sourceMappingURL=source.js.map

package/dist/commands/source.js.map

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

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

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

package/dist/commands/status.js

@@ -1,16 +1,18 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.registerCommand = registerCommand;
+const cli_errors_1 = require("../lib/cli-errors");
 const exit_codes_1 = require("../lib/exit-codes");
 const loader_1 = require("../runtime/config/loader");
 const schema_1 = require("../runtime/config/schema");
+const run_manifest_1 = require("../runtime/run-manifest");
 const docker_cli_1 = require("../runtime/runner/docker-cli");
 const helm_cli_1 = require("../runtime/runner/helm-cli");
 function registerCommand(program) {
     program
         .command('status')
         .summary('Show launcher-owned workloads and their health')
-        .description('List what xema up started (containers, or Helm releases) with status.')
+        .description('List what xema up started (native services, containers, or Helm releases) with status.')
         .option('--config <path>', 'Path to xema.config.yaml (selects the substrate)')
         .action(async (opts) => {
         try {
@@ -18,18 +20,42 @@ function registerCommand(program) {
         }
         catch (err) {
             const message = err instanceof Error ? err.message : String(err);
-            (0, exit_codes_1.exitWith)(exit_codes_1.XemaCliExitCode.GenericError, `xema status failed: ${message}`);
+            (0, exit_codes_1.exitWith)((0, cli_errors_1.lifecycleExitCode)(err), `xema status failed: ${message}`);
         }
     });
 }
 async function runStatus(opts) {
-    const { config } = (0, loader_1.loadXemaConfig)({ explicit: opts.config });
+    const { config } = (0, cli_errors_1.asConfigError)(() => (0, loader_1.loadXemaConfig)({ explicit: opts.config }));
     if (config.app.substrate === schema_1.Substrate.Helm) {
         await runHelmStatus();
         return;
     }
+    if (config.app.substrate === schema_1.Substrate.Native) {
+        runNativeStatus();
+        return;
+    }
     await runContainerStatus();
 }
+function runNativeStatus() {
+    const services = (0, run_manifest_1.readRunManifest)();
+    if (services.length === 0) {
+        console.log('No native xema services recorded. (Start them with `xema dev` / `xema up`.)');
+        return;
+    }
+    console.log('NAME\tPID\tPORT\tMODE\tSTATE');
+    for (const svc of services) {
+        console.log(`${svc.name}\t${String(svc.pid)}\t${String(svc.port)}\t${svc.mode}\t${liveness(svc)}`);
+    }
+}
+function liveness(entry) {
+    try {
+        process.kill(entry.pid, 0);
+        return 'alive';
+    }
+    catch (err) {
+        return err.code === 'EPERM' ? 'alive' : 'stale (exited)';
+    }
+}
 async function runHelmStatus() {
     const helm = new helm_cli_1.HelmCli();
     if (!(await helm.available())) {

package/dist/commands/status.js.map

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

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

@@ -1 +1 @@
-{"version":3,"file":"up.d.ts","sourceRoot":"","sources":["../../src/commands/up.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAkBzC,wBAAgB,eAAe,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CA0BtD"}
+{"version":3,"file":"up.d.ts","sourceRoot":"","sources":["../../src/commands/up.ts"],"names":[],"mappings":"AAwBA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAqBzC,wBAAgB,eAAe,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAuCtD"}