@mantajs/cli 0.2.0-beta.0

package/dist/bootstrap/phases/init-infra.js

@@ -0,0 +1,193 @@
+// Phase 1: Initialize infrastructure — resolve preset, adapters, logger, DB, builder.
+import { DbProgressChannel, DrizzlePgAdapter, DrizzleWorkflowStorage, DrizzleWorkflowStore, } from '@mantajs/adapter-database-pg';
+import { createApp, InMemoryCacheAdapter, InMemoryEventBusAdapter, InMemoryFileAdapter, InMemoryLockingAdapter, InMemoryProgressChannel, MantaError, } from '@mantajs/core';
+import { resolveAdapters, resolvePreset } from '../../config/resolve-adapters';
+import { ADAPTER_FACTORIES, ConsoleLoggerAdapter } from '../bootstrap-app';
+import { ensureFrameworkSchema } from '../bootstrap-helpers';
+/**
+ * Structural check: returns a Drizzle client when `db` is a known Postgres-compatible
+ * adapter (DrizzlePgAdapter or NeonDrizzleAdapter), else null. Uses a dynamic import
+ * for the Neon adapter so `@mantajs/cli` stays free of a hard dep on it (matches the
+ * pattern in bootstrap-app.ts::ADAPTER_FACTORIES).
+ *
+ * The returned client is typed as PostgresJsDatabase — Neon HTTP returns a
+ * NeonHttpDatabase at runtime, but `connection.ts` already casts it to
+ * PostgresJsDatabase because both drivers expose the same Drizzle ORM surface
+ * (insert/select/update/transaction).
+ */
+async function resolveDrizzleClient(db) {
+    if (db instanceof DrizzlePgAdapter) {
+        return db.getClient();
+    }
+    try {
+        const { NeonDrizzleAdapter } = await import('@mantajs/adapter-database-neon');
+        if (db instanceof NeonDrizzleAdapter) {
+            return db.getClient();
+        }
+    }
+    catch {
+        // Package not installed — db cannot be a Neon adapter, fall through.
+    }
+    return null;
+}
+export async function initializeInfra(ctx, _appRef) {
+    const { config, mode, verbose } = ctx;
+    // [1] Resolve preset and adapters
+    const preset = resolvePreset(config);
+    const resolvedAdapters = resolveAdapters(config, preset);
+    // [2] Initialize logger
+    const loggerEntry = resolvedAdapters.find((a) => a.port === 'ILoggerPort');
+    const loggerOpts = { level: verbose ? 'debug' : 'info', pretty: mode === 'dev', ...loggerEntry?.options };
+    const loggerFactory = ADAPTER_FACTORIES[loggerEntry?.adapter ?? '@mantajs/adapter-logger-pino'];
+    const logger = (loggerFactory ? await loggerFactory(loggerOpts) : new ConsoleLoggerAdapter(loggerOpts));
+    ctx.logger = logger;
+    // [3] Initialize database
+    logger.info('Connecting to database...');
+    const dbEntry = resolvedAdapters.find((a) => a.port === 'IDatabasePort');
+    const dbFactory = dbEntry ? ADAPTER_FACTORIES[dbEntry.adapter] : undefined;
+    const db = (dbFactory ? await dbFactory(dbEntry.options) : new DrizzlePgAdapter());
+    ctx.db = db;
+    await db.initialize({
+        url: config.database.url,
+        pool: config.database?.pool,
+    });
+    const healthy = await db.healthCheck();
+    if (healthy) {
+        logger.info('Database connected');
+    }
+    else {
+        logger.error('Database initialized but readiness probe failed; continuing boot and reporting /health/ready as not_ready');
+    }
+    // [4] Framework schema — versioned migration, safe on every boot (serverless
+    //     cold starts serialize on a Postgres advisory lock, and a version gate
+    //     skips DDL when already applied).
+    //
+    //     Hardened against serverless weirdness: a migration failure here
+    //     (timeout, pooler quirk, transient DB error) must NOT crash the whole
+    //     app — other endpoints would go dark for cold-start reasons unrelated
+    //     to their own concerns. Log loudly and continue; the migration retries
+    //     on the next cold start, and framework-dependent endpoints surface the
+    //     real problem on their first hit.
+    if (healthy) {
+        try {
+            await ensureFrameworkSchema(db.getPool(), logger);
+        }
+        catch (err) {
+            logger.error(`[manta-schema] framework migration failed; continuing boot — ${err.message}`);
+        }
+    }
+    else {
+        logger.warn('[manta-schema] skipped framework migration because database readiness failed');
+    }
+    // [5] Collect infra adapters, then build app via MantaAppBuilder
+    const infraMap = new Map();
+    infraMap.set('ILoggerPort', logger);
+    infraMap.set('IDatabasePort', db);
+    // Register WorkflowStorage when any Postgres-compatible DB adapter is active
+    // (DrizzlePgAdapter OR NeonDrizzleAdapter). Without this, WorkflowManager falls
+    // back to MemoryStorage — checkpoints die between serverless invocations,
+    // breaking retry/resume across HTTP requests.
+    const drizzleClient = await resolveDrizzleClient(db);
+    if (drizzleClient) {
+        infraMap.set('IWorkflowStoragePort', new DrizzleWorkflowStorage(drizzleClient));
+        infraMap.set('IWorkflowStorePort', new DrizzleWorkflowStore(drizzleClient));
+    }
+    ctx.infraMap = infraMap;
+    // Register remaining adapters (sorted: IJobSchedulerPort last)
+    const sortedAdapters = [...resolvedAdapters].sort((a, b) => {
+        if (a.port === 'IJobSchedulerPort')
+            return 1;
+        if (b.port === 'IJobSchedulerPort')
+            return -1;
+        return 0;
+    });
+    for (const entry of sortedAdapters) {
+        if (['ILoggerPort', 'IDatabasePort', 'IHttpPort'].includes(entry.port))
+            continue;
+        const factory = ADAPTER_FACTORIES[entry.adapter];
+        if (!factory) {
+            throw new MantaError('UNKNOWN_MODULES', `No factory for adapter "${entry.adapter}" (port: ${entry.port}). Is the package installed?`);
+        }
+        const instance = await factory(entry.options, infraMap);
+        infraMap.set(entry.port, instance);
+        logger.info(`  ${entry.port} → ${entry.adapter}`);
+    }
+    // [5a] Auto-select the workflow progress channel (WORKFLOW_PROGRESS.md §9.2).
+    // Preference: UpstashProgressChannel > DbProgressChannel > InMemoryProgressChannel.
+    // Detection is structural (instanceof) — users never configure this explicitly.
+    await selectProgressChannel(infraMap, logger);
+    // [5b] Create the repository factory
+    const { DrizzleRepositoryFactory } = await import('@mantajs/adapter-database-pg');
+    const repoFactory = db
+        ? (infraMap.get('IRepositoryFactory') ?? new DrizzleRepositoryFactory({ db }))
+        : new (await import('@mantajs/core')).InMemoryRepositoryFactory();
+    infraMap.set('IRepositoryFactory', repoFactory);
+    ctx.repoFactory = repoFactory;
+    // Build the MantaApp using the builder
+    const builder = createApp({
+        infra: {
+            eventBus: (infraMap.get('IEventBusPort') ?? new InMemoryEventBusAdapter()),
+            logger,
+            cache: (infraMap.get('ICachePort') ?? new InMemoryCacheAdapter()),
+            locking: (infraMap.get('ILockingPort') ?? new InMemoryLockingAdapter()),
+            file: (infraMap.get('IFilePort') ?? new InMemoryFileAdapter()),
+            notification: infraMap.get('INotificationPort'),
+            db: db.getClient(),
+        },
+    });
+    ctx.builder = builder;
+    // Register extra infra keys
+    builder.registerInfra('IDatabasePort', db);
+    builder.registerInfra('pgPool', db.getPool());
+    for (const [key, value] of infraMap) {
+        if (!['ILoggerPort', 'IDatabasePort', 'db', 'IEventBusPort', 'ICachePort', 'ILockingPort', 'IFilePort'].includes(key)) {
+            builder.registerInfra(key, value);
+        }
+    }
+}
+/**
+ * Auto-select the progress channel adapter based on already-registered infra.
+ * Called after ICachePort and IDatabasePort are in `infraMap`.
+ *
+ * - If an Upstash cache adapter is present → UpstashProgressChannel (sub-ms, default).
+ * - Else if a Postgres DB is present → DbProgressChannel (throttled 500ms fallback).
+ * - Else → InMemoryProgressChannel (test containers).
+ */
+async function selectProgressChannel(infraMap, logger) {
+    const cache = infraMap.get('ICachePort');
+    const db = infraMap.get('IDatabasePort');
+    // Structural detection for the Upstash cache adapter. We import dynamically
+    // so the cli stays free of a hard dependency on @mantajs/adapter-cache-upstash
+    // (same pattern as ADAPTER_FACTORIES in bootstrap-app.ts). If the package
+    // isn't installed, `cache` cannot be an Upstash adapter anyway.
+    let isUpstashCache = false;
+    let UpstashProgressChannelCtor;
+    if (cache) {
+        try {
+            const mod = await import('@mantajs/adapter-cache-upstash');
+            isUpstashCache = cache instanceof mod.UpstashCacheAdapter;
+            UpstashProgressChannelCtor = mod.UpstashProgressChannel;
+        }
+        catch {
+            // Package not installed — cache cannot be Upstash, fall through.
+        }
+    }
+    let channel;
+    const drizzleClient = await resolveDrizzleClient(db);
+    if (isUpstashCache && UpstashProgressChannelCtor) {
+        // UpstashProgressChannel falls back to the same env vars the cache uses,
+        // so sharing credentials "just works" without surgery on the cache adapter.
+        channel = new UpstashProgressChannelCtor({}, { logger });
+        logger.debug('Progress channel: Upstash (via cache adapter)');
+    }
+    else if (drizzleClient) {
+        channel = new DbProgressChannel(drizzleClient, { logger });
+        logger.debug('Progress channel: Postgres fallback (throttled)');
+    }
+    else {
+        channel = new InMemoryProgressChannel();
+        logger.debug('Using in-memory progress channel (no upstash cache or pg database available)');
+    }
+    infraMap.set('IProgressChannelPort', channel);
+}
+//# sourceMappingURL=init-infra.js.map

package/dist/bootstrap/phases/init-infra.js.map

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

package/dist/bootstrap/phases/seed-dev-users.d.ts

@@ -0,0 +1,3 @@
+import type { AppRef, BootstrapContext } from '../bootstrap-context';
+export declare function seedDevUsers(ctx: BootstrapContext, _appRef: AppRef): Promise<void>;
+//# sourceMappingURL=seed-dev-users.d.ts.map

package/dist/bootstrap/phases/seed-dev-users.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"seed-dev-users.d.ts","sourceRoot":"","sources":["../../../src/bootstrap/phases/seed-dev-users.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,MAAM,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAA;AAepE,wBAAsB,YAAY,CAAC,GAAG,EAAE,gBAAgB,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAiFxF"}

package/dist/bootstrap/phases/seed-dev-users.js

@@ -0,0 +1,93 @@
+// Phase 5e: Seed initial admin user.
+//
+// If MANTA_ADMIN_EMAIL + MANTA_ADMIN_PASSWORD are set, create the user
+// in auth_identities, provider_identities, AND the admin user table.
+// Idempotent: fills any missing table while skipping what already exists.
+// Like Medusa's USER_INITIAL_EMAIL / USER_INITIAL_PASSWORD.
+import { randomBytes, scryptSync } from 'node:crypto';
+import { entityToTableKey } from '../bootstrap-helpers';
+function hashPassword(password) {
+    const salt = randomBytes(16).toString('hex');
+    const hash = scryptSync(password, salt, 64).toString('hex');
+    return `${salt}:${hash}`;
+}
+function uuid() {
+    return randomBytes(16)
+        .toString('hex')
+        .replace(/(.{8})(.{4})(.{4})(.{4})(.{12})/, '$1-$2-$3-$4-$5');
+}
+export async function seedDevUsers(ctx, _appRef) {
+    const email = process.env.MANTA_ADMIN_EMAIL;
+    const password = process.env.MANTA_ADMIN_PASSWORD;
+    if (!email || !password)
+        return;
+    const { logger, db, userDefinitions } = ctx;
+    if (!db) {
+        logger.warn('[seed] MANTA_ADMIN_EMAIL set but no database — cannot seed');
+        return;
+    }
+    // Resolve the admin user table name from the first userDefinition (e.g. 'Admin' → 'admins')
+    const adminDef = userDefinitions?.find((u) => u.contextName === 'admin');
+    const adminTableName = adminDef?.def?.model?.name ? entityToTableKey(adminDef.def.model.name) : 'admins';
+    logger.info(`[seed] Initial user: ${email} (table: ${adminTableName})`);
+    // --- 1. provider_identities ---
+    let hasAuth = false;
+    try {
+        const rows = await db.raw("SELECT id FROM provider_identities WHERE entity_id = $1 AND provider = 'emailpass' LIMIT 1", [email]);
+        if (rows.length > 0) {
+            hasAuth = true;
+            logger.info('[seed] provider_identity exists — OK');
+        }
+    }
+    catch (err) {
+        logger.error(`[seed] Cannot query provider_identities: ${err.message}`);
+        return;
+    }
+    if (!hasAuth) {
+        const authIdentityId = uuid();
+        try {
+            await db.raw('INSERT INTO auth_identities (id, app_metadata) VALUES ($1, $2)', [
+                authIdentityId,
+                '{"user_type":"admin"}',
+            ]);
+            logger.info(`[seed] auth_identity created: ${authIdentityId}`);
+        }
+        catch (err) {
+            logger.error(`[seed] Cannot insert auth_identity: ${err.message}`);
+            return;
+        }
+        const providerId = uuid();
+        const hashedPassword = hashPassword(password);
+        try {
+            await db.raw(`INSERT INTO provider_identities (id, entity_id, provider, auth_identity_id, user_metadata, provider_metadata)
+         VALUES ($1, $2, 'emailpass', $3, $4, $5)`, [providerId, email, authIdentityId, JSON.stringify({ email }), JSON.stringify({ password: hashedPassword })]);
+            logger.info(`[seed] provider_identity created: ${providerId}`);
+        }
+        catch (err) {
+            logger.error(`[seed] Cannot insert provider_identity: ${err.message}`);
+            return;
+        }
+    }
+    // --- 2. User table — ALWAYS ensure the row exists ---
+    try {
+        const userRows = await db.raw(`SELECT id FROM ${adminTableName} WHERE email = $1 LIMIT 1`, [email]);
+        if (userRows.length > 0) {
+            logger.info(`[seed] ${adminTableName} row exists — OK`);
+        }
+        else {
+            const userId = uuid();
+            await db.raw(`INSERT INTO ${adminTableName} (id, email, first_name, last_name) VALUES ($1, $2, $3, $4)`, [
+                userId,
+                email,
+                'Admin',
+                'User',
+            ]);
+            logger.info(`[seed] ${adminTableName} row created: ${userId}`);
+        }
+    }
+    catch (err) {
+        logger.error(`[seed] Cannot create ${adminTableName} row: ${err.message}`);
+    }
+    logger.info(`[seed] Done — login with ${email}`);
+}
+//# sourceMappingURL=seed-dev-users.js.map

package/dist/bootstrap/phases/seed-dev-users.js.map

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

package/dist/bootstrap/phases/wire/auth-helpers.d.ts

@@ -0,0 +1,12 @@
+import type { AuthContext } from '@mantajs/core';
+import type { BootstrapContext } from '../../bootstrap-context';
+/**
+ * Parse a `Bearer <token>` authorization header and verify it through the
+ * bootstrap's AuthModuleService. Returns the verified AuthContext or `null`
+ * if the header is absent or the token fails verification.
+ *
+ * Mirrors the original inline blocks verbatim: no header → null, bad token →
+ * null (error swallowed), no exceptions propagated to the caller.
+ */
+export declare function parseBearer(ctx: BootstrapContext, req: Request): Promise<AuthContext | null>;
+//# sourceMappingURL=auth-helpers.d.ts.map

package/dist/bootstrap/phases/wire/auth-helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth-helpers.d.ts","sourceRoot":"","sources":["../../../../src/bootstrap/phases/wire/auth-helpers.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAA;AAChD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAA;AAE/D;;;;;;;GAOG;AACH,wBAAsB,WAAW,CAAC,GAAG,EAAE,gBAAgB,EAAE,GAAG,EAAE,OAAO,GAAG,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC,CAUlG"}

package/dist/bootstrap/phases/wire/auth-helpers.js

@@ -0,0 +1,25 @@
+// Shared auth helpers for wire-phase route handlers.
+// Extracted from the duplicated Bearer-token parsing blocks in cqrs-routes
+// and query-endpoints (previously marked [13e], [13f], [13g]).
+/**
+ * Parse a `Bearer <token>` authorization header and verify it through the
+ * bootstrap's AuthModuleService. Returns the verified AuthContext or `null`
+ * if the header is absent or the token fails verification.
+ *
+ * Mirrors the original inline blocks verbatim: no header → null, bad token →
+ * null (error swallowed), no exceptions propagated to the caller.
+ */
+export async function parseBearer(ctx, req) {
+    const authHeader = req.headers.get('authorization');
+    const token = authHeader?.startsWith('Bearer ') ? authHeader.slice(7) : null;
+    if (!token)
+        return null;
+    try {
+        const payload = await ctx.authService.verifyToken(token, ctx.jwtSecret);
+        return payload;
+    }
+    catch {
+        return null;
+    }
+}
+//# sourceMappingURL=auth-helpers.js.map

package/dist/bootstrap/phases/wire/auth-helpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth-helpers.js","sourceRoot":"","sources":["../../../../src/bootstrap/phases/wire/auth-helpers.ts"],"names":[],"mappings":"AAAA,qDAAqD;AACrD,2EAA2E;AAC3E,+DAA+D;AAK/D;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,GAAqB,EAAE,GAAY;IACnE,MAAM,UAAU,GAAG,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,eAAe,CAAC,CAAA;IACnD,MAAM,KAAK,GAAG,UAAU,EAAE,UAAU,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAA;IAC5E,IAAI,CAAC,KAAK;QAAE,OAAO,IAAI,CAAA;IACvB,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,MAAM,GAAG,CAAC,WAAW,CAAC,WAAW,CAAC,KAAK,EAAE,GAAG,CAAC,SAAS,CAAC,CAAA;QACvE,OAAO,OAAiC,CAAA;IAC1C,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAA;IACb,CAAC;AACH,CAAC"}

package/dist/bootstrap/phases/wire/contexts/context-registry.d.ts

@@ -0,0 +1,4 @@
+import { ContextRegistry } from '@mantajs/core';
+import type { AppRef, BootstrapContext } from '../../../bootstrap-context';
+export declare function buildContextRegistry(ctx: BootstrapContext, _appRef: AppRef): Promise<ContextRegistry>;
+//# sourceMappingURL=context-registry.d.ts.map

package/dist/bootstrap/phases/wire/contexts/context-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-registry.d.ts","sourceRoot":"","sources":["../../../../../src/bootstrap/phases/wire/contexts/context-registry.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,eAAe,EAAoB,MAAM,eAAe,CAAA;AACjE,OAAO,KAAK,EAAE,MAAM,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAA;AAE1E,wBAAsB,oBAAoB,CAAC,GAAG,EAAE,gBAAgB,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC,CAsH3G"}

package/dist/bootstrap/phases/wire/contexts/context-registry.js

@@ -0,0 +1,96 @@
+// [13d] Load contexts (src/contexts/*.ts).
+import { ContextRegistry, isCommandAllowed } from '@mantajs/core';
+export async function buildContextRegistry(ctx, _appRef) {
+    const { logger, resources, doImport, entityRegistry, entityCommandRegistry, explicitCommandNames, commandGraphDefs, userDefinitions, moduleScopedCommandNames, cmdRegistry, } = ctx;
+    // [13d] Load contexts (src/contexts/*.ts)
+    const contextRegistry = new ContextRegistry();
+    const moduleNames = [
+        ...resources.modules.map((m) => m.name),
+        ...Array.from(entityRegistry.keys()).map((k) => k.toLowerCase()),
+    ];
+    const commandNames = cmdRegistry ? cmdRegistry.list().map((e) => e.name) : [];
+    // Helper: resolve entity commands visible for a context based on its command graph
+    const isEntityCmdAllowed = isCommandAllowed;
+    const resolveEntityCommandsForContext = (ctxName) => {
+        const graphDef = commandGraphDefs.get(ctxName);
+        if (!graphDef)
+            return [];
+        const visibleEntityCmds = [];
+        for (const [cmdName, entityCmd] of entityCommandRegistry.entries()) {
+            if (explicitCommandNames.has(cmdName))
+                continue;
+            if (isEntityCmdAllowed(graphDef, entityCmd.__module, entityCmd.__operation)) {
+                visibleEntityCmds.push(cmdName);
+            }
+        }
+        return visibleEntityCmds;
+    };
+    if (resources.contexts.length > 0) {
+        // V1 path: explicit defineContext files
+        for (const ctxInfo of resources.contexts) {
+            try {
+                const imported = await doImport(ctxInfo.path);
+                // biome-ignore lint/suspicious/noExplicitAny: context definition shape varies
+                const def = imported.default;
+                if (def?.name && def?.basePath && def?.actors) {
+                    const entityCmds = resolveEntityCommandsForContext(def.name);
+                    if (entityCmds.length > 0) {
+                        def.commands = [...(def.commands ?? []), ...entityCmds];
+                    }
+                    contextRegistry.register(def, moduleNames, [...commandNames, ...entityCmds]);
+                    logger.info(`  Context: ${def.name} (${def.basePath}) [V1 explicit]${entityCmds.length > 0 ? ` +${entityCmds.length} entity commands` : ''}`);
+                }
+            }
+            catch (err) {
+                logger.warn(`Failed to load context '${ctxInfo.id}': ${err instanceof Error ? err.message : String(err)}`);
+            }
+        }
+    }
+    else if (resources.users.length > 0 ||
+        resources.queries.length > 0 ||
+        resources.commands.some((c) => c.context)) {
+        // V2 path: derive contexts from filesystem structure
+        const derivedContexts = new Set();
+        for (const cmd of resources.commands) {
+            if (cmd.context)
+                derivedContexts.add(cmd.context);
+        }
+        for (const q of resources.queries) {
+            derivedContexts.add(q.context);
+        }
+        for (const u of userDefinitions) {
+            derivedContexts.add(u.contextName);
+        }
+        const commandGraphIds = new Set();
+        for (const cmd of resources.commands) {
+            if (cmd.context && commandGraphDefs.has(cmd.context) && cmd.id === 'graph') {
+                commandGraphIds.add(`${cmd.context}:${cmd.id}`);
+            }
+        }
+        const kebabToCamel = (s) => s.replace(/-([a-z])/g, (_, c) => c.toUpperCase());
+        for (const ctxName of derivedContexts) {
+            const ctxCommands = resources.commands
+                .filter((c) => c.context === ctxName && !commandGraphIds.has(`${c.context}:${c.id}`))
+                .map((c) => kebabToCamel(c.id));
+            const flatCommands = resources.commands.filter((c) => !c.context).map((c) => kebabToCamel(c.id));
+            const entityCmds = resolveEntityCommandsForContext(ctxName);
+            const allCtxCommands = [...ctxCommands, ...flatCommands, ...entityCmds, ...moduleScopedCommandNames];
+            const hasUser = userDefinitions.some((u) => u.contextName === ctxName);
+            const actors = hasUser ? [ctxName] : [];
+            contextRegistry.register({
+                name: ctxName,
+                basePath: `/api/${ctxName}`,
+                actors,
+                modules: Object.fromEntries(moduleNames.map((m) => [m, { expose: '*' }])),
+                commands: allCtxCommands,
+            }, moduleNames, [...commandNames, ...entityCmds]);
+            logger.info(`  Context: ${ctxName} (/api/${ctxName}) [V2 filesystem-derived]${entityCmds.length > 0 ? ` +${entityCmds.length} entity commands` : ''}`);
+        }
+    }
+    else {
+        contextRegistry.registerDefault(moduleNames, commandNames);
+        logger.info('  Context: admin (implicit, /api/admin)');
+    }
+    return contextRegistry;
+}
+//# sourceMappingURL=context-registry.js.map

package/dist/bootstrap/phases/wire/contexts/context-registry.js.map

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

package/dist/bootstrap/phases/wire/contexts/cqrs-routes.d.ts

@@ -0,0 +1,3 @@
+import type { AppRef, BootstrapContext } from '../../../bootstrap-context';
+export declare function cqrsRoutes(ctx: BootstrapContext, appRef: AppRef): Promise<void>;
+//# sourceMappingURL=cqrs-routes.d.ts.map

package/dist/bootstrap/phases/wire/contexts/cqrs-routes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cqrs-routes.d.ts","sourceRoot":"","sources":["../../../../../src/bootstrap/phases/wire/contexts/cqrs-routes.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,MAAM,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAA;AAI1E,wBAAsB,UAAU,CAAC,GAAG,EAAE,gBAAgB,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAgKrF"}

package/dist/bootstrap/phases/wire/contexts/cqrs-routes.js

@@ -0,0 +1,138 @@
+// [13e] Register context-aware CQRS endpoints.
+import { getRequestBody } from '../../../../server-bootstrap';
+import { parseBearer } from '../auth-helpers';
+import { handleQueryRequest } from '../wire-adapter';
+export async function cqrsRoutes(ctx, appRef) {
+    const { logger, adapter, contextRegistry } = ctx;
+    // [13e] Register context-aware CQRS endpoints
+    for (const ctx2 of contextRegistry.list()) {
+        // POST {basePath}/command/:name — filtered by context
+        adapter.registerRoute('POST', `${ctx2.basePath}/command/:name`, async (req) => {
+            try {
+                const url = new URL(req.url, 'http://localhost');
+                const segments = url.pathname.split('/');
+                const nameIdx = segments.indexOf('command') + 1;
+                const name = segments[nameIdx];
+                const camelName = name.replace(/-([a-z])/g, (_, c) => c.toUpperCase());
+                if (!ctx2.commands.has(name) && !ctx2.commands.has(camelName)) {
+                    return Response.json({ type: 'NOT_FOUND', message: `Command "${name}" not found in context "${ctx2.name}"` }, { status: 404 });
+                }
+                const cmds = appRef.current.commands;
+                const callable = cmds[name] ?? cmds[camelName];
+                if (!callable) {
+                    return Response.json({ type: 'NOT_FOUND', message: `Command "${name}" not found` }, { status: 404 });
+                }
+                const body = await getRequestBody(req);
+                const cmdAuth = await parseBearer(ctx, req);
+                const reqHeaders = {};
+                req.headers.forEach((v, k) => {
+                    reqHeaders[k] = v;
+                });
+                const result = await callable(body, { auth: cmdAuth, headers: reqHeaders });
+                // Running-envelope detection: the command callable may return
+                // { runId, status: 'running' } when the workflow lost the 300ms race
+                // in wire-commands.ts. Surface this with HTTP 202 so clients know
+                // to start polling /api/admin/_workflow/:id. See WORKFLOW_PROGRESS.md
+                // §6.1 and §6.5.
+                if (result &&
+                    typeof result === 'object' &&
+                    result.status === 'running' &&
+                    typeof result.runId === 'string') {
+                    const runId = result.runId;
+                    return Response.json({ data: { runId, status: 'running', href: `/api/admin/_workflow/${runId}` } }, { status: 202 });
+                }
+                return Response.json({ data: result });
+            }
+            catch (err) {
+                if (err.name === 'ZodError') {
+                    return Response.json({ type: 'INVALID_DATA', message: 'Validation failed', details: err.issues }, { status: 400 });
+                }
+                const message = err.message;
+                logger.error(`[command] ${message}`);
+                return Response.json({ type: 'UNEXPECTED_STATE', message }, { status: 500 });
+            }
+        });
+        // POST {basePath}/query/:entity — filtered by context
+        adapter.registerRoute('POST', `${ctx2.basePath}/query/:entity`, async (req) => {
+            try {
+                const url = new URL(req.url, 'http://localhost');
+                const segments = url.pathname.split('/');
+                const entityIdx = segments.indexOf('query') + 1;
+                const entity = segments[entityIdx];
+                if (!entity) {
+                    return Response.json({ type: 'INVALID_DATA', message: 'entity is required in URL' }, { status: 400 });
+                }
+                const entityNormalized = entity.toLowerCase();
+                if (!ctx2.modules.has(entity) && !ctx2.modules.has(entityNormalized)) {
+                    return Response.json({ type: 'NOT_FOUND', message: `Entity "${entity}" not available in context "${ctx2.name}"` }, { status: 404 });
+                }
+                let service = null;
+                const modules = appRef.current.modules;
+                try {
+                    service = appRef.current.resolve(`${entity}ModuleService`);
+                }
+                catch {
+                    service = modules[entity] ?? modules[entityNormalized] ?? null;
+                }
+                if (!service) {
+                    return Response.json({ type: 'NOT_FOUND', message: `Entity "${entity}" not found` }, { status: 404 });
+                }
+                const body = await getRequestBody(req);
+                const qs = (() => {
+                    try {
+                        return appRef.current.resolve('queryService');
+                    }
+                    catch {
+                        return null;
+                    }
+                })();
+                if (qs && typeof qs.graphAndCount === 'function') {
+                    const { fields, filters, limit, offset, order, q, id } = body;
+                    if (id) {
+                        return handleQueryRequest(service, entity, body, {
+                            contextName: ctx2.name,
+                            exposedModules: new Set(ctx2.modules.keys()),
+                            logger,
+                        });
+                    }
+                    const sortObj = order && typeof order === 'string'
+                        ? { [order.startsWith('-') ? order.slice(1) : order]: order.startsWith('-') ? 'desc' : 'asc' }
+                        : undefined;
+                    const [data, count] = await qs.graphAndCount({
+                        entity,
+                        fields: fields,
+                        filters: filters,
+                        sort: sortObj,
+                        pagination: { limit: limit ?? 15, offset: offset ?? 0 },
+                        q: q,
+                    });
+                    return Response.json({ data, count });
+                }
+                return handleQueryRequest(service, entity, body, {
+                    contextName: ctx2.name,
+                    exposedModules: new Set(ctx2.modules.keys()),
+                    logger,
+                });
+            }
+            catch (err) {
+                return Response.json({ type: 'UNEXPECTED_STATE', message: err.message }, { status: 500 });
+            }
+        });
+        // GET {basePath}/tools — AI tool discovery (filtered by context)
+        if (ctx2.ai.enabled) {
+            adapter.registerRoute('GET', `${ctx2.basePath}/tools`, async () => {
+                try {
+                    const registry = appRef.current.resolve('commandRegistry');
+                    const aiCommands = ctx2.ai.commands;
+                    const filtered = registry.toToolSchemas().filter((t) => aiCommands.includes(t.name));
+                    return Response.json({ tools: filtered });
+                }
+                catch {
+                    return Response.json({ tools: [] });
+                }
+            });
+        }
+        logger.info(`[context] ${ctx2.name}: ${ctx2.basePath} (actors: ${ctx2.actors.join(', ')}, modules: ${[...ctx2.modules.keys()].join(', ')})`);
+    }
+}
+//# sourceMappingURL=cqrs-routes.js.map