@mettlecast/domain-cli 0.2.22 → 0.2.23

package/dist/commands/init.js

@@ -0,0 +1,62 @@
+/**
+ * init — bootstrap a freshly scaffolded project so it is ready for
+ * local development and CI.  Runs npm install, builds the CLI, and
+ * runs a baseline doctor check.
+ *
+ * Usage: npx mc-domain-module init
+ */
+import { execSync } from 'node:child_process';
+import { existsSync } from 'node:fs';
+import { join } from 'node:path';
+import { cliLogger } from '../utils/logger.js';
+import { runDoctor } from './doctor.js';
+export async function runInit(options = {}) {
+    const projectRoot = options.projectRoot ?? process.cwd();
+    const skipInstall = options.skipInstallIfExists !== false;
+    // ── 1. npm install ──────────────────────────────────────────────────
+    const nodeModulesDir = join(projectRoot, 'node_modules');
+    if (skipInstall && existsSync(nodeModulesDir)) {
+        cliLogger.info('node_modules exists — skipping npm install');
+    }
+    else {
+        cliLogger.info('Running npm install...');
+        execSync('npm install --legacy-peer-deps', {
+            cwd: projectRoot,
+            stdio: 'inherit',
+        });
+    }
+    // ── 2. Build the CLI ────────────────────────────────────────────────
+    const cliDir = join(projectRoot, 'packages', 'domain-cli');
+    if (existsSync(cliDir)) {
+        cliLogger.info('Installing domain-cli dependencies...');
+        execSync('npm install --legacy-peer-deps', {
+            cwd: cliDir,
+            stdio: 'inherit',
+        });
+        cliLogger.info('Building domain-cli...');
+        execSync('npm run build', {
+            cwd: cliDir,
+            stdio: 'inherit',
+        });
+    }
+    // ── 3. Baseline doctor ──────────────────────────────────────────────
+    cliLogger.info('Running doctor (baseline)...');
+    const report = await runDoctor({ projectRoot, strict: true });
+    const passes = report.checks.filter(c => c.status === 'PASS').length;
+    const fails = report.checks.filter(c => c.status === 'FAIL').length;
+    const warns = report.checks.filter(c => c.status === 'WARN').length;
+    // eslint-disable-next-line no-console
+    console.log(`\nDoctor baseline: ${passes} PASS, ${fails} FAIL, ${warns} WARN`);
+    if (report.exitCode !== 0) {
+        // eslint-disable-next-line no-console
+        console.log('\nDoctor found issues — this is expected on a fresh scaffold.\n' +
+            'Run `npx mc-domain-module doctor` for details.\n');
+    }
+    else {
+        // eslint-disable-next-line no-console
+        console.log('\nProject is ready!');
+    }
+}
+export async function runInitCli(opts = {}) {
+    await runInit(opts);
+}

package/dist/commands/reseed-page.js

@@ -3,6 +3,7 @@ import { join, resolve, dirname } from 'node:path';
 import { execSync } from 'node:child_process';
 import { createGunzip } from 'node:zlib';
 import { Readable } from 'node:stream';
+import ky from 'ky';
 import { cliLogger } from '../utils/logger.js';
 import { fetchVersionsJson, fetchModulesJson, fetchModuleTarball, } from '../utils/s3-fetch.js';
 import { readManifest } from '../utils/manifest.js';
@@ -73,21 +74,19 @@ function detectGitRemote(projectDir) {
 }
 async function createGitHubPR(owner, repo, token, branch, title, body, labels) {
     const url = `https://api.github.com/repos/${owner}/${repo}/pulls`;
-    const res = await fetch(url, {
-        method: 'POST',
+    const res = await ky.post(url, {
         headers: {
             Authorization: `Bearer ${token}`,
             Accept: 'application/vnd.github+json',
-            'Content-Type': 'application/json',
             'X-GitHub-Api-Version': '2022-11-28',
         },
-        body: JSON.stringify({
+        json: {
             title,
             body,
             head: branch,
             base: 'develop',
-            labels,
-        }),
+            ...(labels && labels.length > 0 && { labels }),
+        },
     });
     if (!res.ok) {
         const err = await res.text();

package/dist/commands/upgrade.d.ts

@@ -1,5 +1,7 @@
 export interface UpgradeOptions {
     dryRun: boolean;
+    /** Read-only variant: compute diffs, print a CI-parseable summary, exit 0 (no drift) or 1 (drift detected). Never writes files. */
+    check: boolean;
     projectDir: string;
     githubToken?: string;
     frontendComponents?: boolean;

package/dist/commands/upgrade.js

@@ -3,6 +3,7 @@ import { Readable } from 'node:stream';
 import { unlink } from 'node:fs/promises';
 import { join, resolve } from 'node:path';
 import { execSync } from 'node:child_process';
+import ky from 'ky';
 import { cliLogger } from '../utils/logger.js';
 import { fetchVersionsJson, fetchModulesJson, fetchModuleTarball, fetchScaffoldFile, } from '../utils/s3-fetch.js';
 import { computeChecksumString } from '../utils/checksum.js';
@@ -117,21 +118,19 @@ function detectGitRemote(projectDir) {
 }
 async function createGitHubPR(owner, repo, token, branch, title, body, labels) {
     const url = `https://api.github.com/repos/${owner}/${repo}/pulls`;
-    const res = await fetch(url, {
-        method: 'POST',
+    const res = await ky.post(url, {
         headers: {
             Authorization: `Bearer ${token}`,
             Accept: 'application/vnd.github+json',
-            'Content-Type': 'application/json',
             'X-GitHub-Api-Version': '2022-11-28',
         },
-        body: JSON.stringify({
+        json: {
             title,
             body,
             head: branch,
             base: 'develop',
             ...(labels && labels.length > 0 && { labels }),
-        }),
+        },
     });
     if (!res.ok) {
         const err = await res.text();
@@ -252,7 +251,8 @@ function buildFrontendComponentsPrBody(currentVersion, targetVersion, results, c
 }
 export async function runUpgrade(packageSpec, opts) {
     const projectDir = resolve(opts.projectDir ?? process.cwd());
-    console.log(`\nTIB Upgrade${opts.dryRun ? ' (dry run)' : ''}\n`);
+    const actionLabel = opts.check ? 'check' : opts.dryRun ? 'dry run' : 'upgrade';
+    console.log(`\nTIB Upgrade (${actionLabel})\n`);
     console.log(`Project: ${projectDir}\n`);
     // 1. Read manifest + scaffold-config
     const manifest = await readManifest(projectDir);
@@ -420,6 +420,28 @@ export async function runUpgrade(packageSpec, opts) {
             console.log(`  ${r.path} — new version written to ${r.path}.tib-upgrade`);
         }
     }
+    if (opts.check) {
+        // Read-only CI gate — report drift and exit.
+        const totalChanged = added.length + updated.length + deleted.length;
+        if (totalChanged === 0 && conflicts.length === 0) {
+            console.log('\n✓ No drift — project is up to date with scaffold.\n');
+            process.exitCode = 0;
+        }
+        else {
+            console.log(`\n✗ Drift detected: ${totalChanged} file(s) changed, ${conflicts.length} conflict(s).`);
+            if (added.length > 0)
+                console.log(`  Added   : ${added.map((r) => r.path).join(', ')}`);
+            if (updated.length > 0)
+                console.log(`  Updated : ${updated.map((r) => r.path).join(', ')}`);
+            if (deleted.length > 0)
+                console.log(`  Deleted : ${deleted.map((r) => r.path).join(', ')}`);
+            if (conflicts.length > 0)
+                console.log(`  Conflicts: ${conflicts.map((r) => r.path).join(', ')}`);
+            console.log('\nRun `npx mc-domain-module upgrade` to apply changes.\n');
+            process.exitCode = 1;
+        }
+        return;
+    }
     if (opts.dryRun) {
         console.log('\nDry run complete — no files were written.\n');
         return;

package/dist/commands/why.d.ts

@@ -0,0 +1,47 @@
+/**
+ * Command to explain the project's current scaffold state and any available upgrades.
+ * Reads .mc/manifest.json for the current scaffold version + enabled module list,
+ * fetches the latest version from S3, and prints a diff to stdout.
+ */
+/**
+ * Options for the why command.
+ */
+export interface WhyOptions {
+    /** Project root directory. Defaults to process.cwd(). */
+    projectRoot?: string;
+    /** Override S3 bucket used to fetch versions.json. Defaults to the public TIB bucket. */
+    scaffoldBucket?: string;
+    /** Output raw JSON instead of a human-readable report. */
+    json?: boolean;
+}
+/**
+ * Report describing the project's current scaffold state and any pending upgrade.
+ */
+export interface WhyReport {
+    /** Scaffold version recorded in .mc/manifest.json (or "unknown" if no manifest). */
+    currentVersion: string;
+    /** Module IDs currently enabled in the project. */
+    enabledModules: string[];
+    /** Latest version published to the scaffold S3 bucket. */
+    latestVersion: string;
+    /** True when the current pinned version is older than the latest. */
+    upgradeAvailable: boolean;
+    /** Number of releases between current and latest (-1 if versions cannot be compared). */
+    versionsBehind: number;
+    /** All known scaffold versions (most recent first). */
+    allVersions: string[];
+}
+/**
+ * Execute the why command: gather local + remote scaffold state, return a report.
+ * @param options - WhyOptions with optional projectRoot and scaffoldBucket.
+ * @returns A WhyReport describing current vs. latest state.
+ */
+export declare function runWhy(options?: WhyOptions): Promise<WhyReport>;
+/**
+ * Format a WhyReport as a multi-line human-readable string.
+ */
+export declare function formatWhyReport(report: WhyReport): string;
+/**
+ * CLI entry point: print a human-readable (or JSON) report and return the report.
+ */
+export declare function runWhyCli(options?: WhyOptions): Promise<WhyReport>;

package/dist/commands/why.js

@@ -0,0 +1,129 @@
+/**
+ * Command to explain the project's current scaffold state and any available upgrades.
+ * Reads .mc/manifest.json for the current scaffold version + enabled module list,
+ * fetches the latest version from S3, and prints a diff to stdout.
+ */
+import { readFile } from 'node:fs/promises';
+import { join } from 'node:path';
+import { fetchVersionsJson } from '../utils/s3-fetch.js';
+import { cliLogger } from '../utils/logger.js';
+const DEFAULT_BUCKET = 'mc-scaffold';
+const MANIFEST_PATH_SEGMENTS = ['.mc', 'manifest.json'];
+/**
+ * Read the project's current scaffold state from .mc/manifest.json.
+ * Returns sensible defaults when the manifest is missing or unreadable.
+ */
+async function readManifestState(projectRoot) {
+    const manifestPath = join(projectRoot, ...MANIFEST_PATH_SEGMENTS);
+    try {
+        const content = await readFile(manifestPath, 'utf-8');
+        const parsed = JSON.parse(content);
+        const scaffoldVersion = typeof parsed.scaffoldVersion === 'string' ? parsed.scaffoldVersion : 'unknown';
+        const enabledModules = Array.isArray(parsed.enabledModules)
+            ? parsed.enabledModules.filter((m) => typeof m === 'string')
+            : [];
+        return { scaffoldVersion, enabledModules };
+    }
+    catch (err) {
+        if (err.code === 'ENOENT') {
+            return { scaffoldVersion: 'unknown', enabledModules: [] };
+        }
+        throw err;
+    }
+}
+/**
+ * Compute the number of releases between two version strings, using the order
+ * returned by versions.json (most recent first). Returns -1 when either version
+ * is not present in the list.
+ */
+function computeVersionsBehind(current, latest, all) {
+    if (current === 'unknown')
+        return -1;
+    const latestIdx = all.indexOf(latest);
+    const currentIdx = all.indexOf(current);
+    if (latestIdx === -1 || currentIdx === -1)
+        return -1;
+    return Math.max(0, currentIdx - latestIdx);
+}
+/**
+ * Execute the why command: gather local + remote scaffold state, return a report.
+ * @param options - WhyOptions with optional projectRoot and scaffoldBucket.
+ * @returns A WhyReport describing current vs. latest state.
+ */
+export async function runWhy(options = {}) {
+    const projectRoot = options.projectRoot ?? process.cwd();
+    const bucket = options.scaffoldBucket ?? DEFAULT_BUCKET;
+    const { scaffoldVersion, enabledModules } = await readManifestState(projectRoot);
+    cliLogger.debug({ scaffoldVersion, enabledModules }, 'why: read local manifest');
+    const versionsJson = await fetchVersionsJson(bucket);
+    const latestVersion = versionsJson.latest;
+    const allVersions = versionsJson.versions;
+    const upgradeAvailable = latestVersion !== scaffoldVersion;
+    const versionsBehind = computeVersionsBehind(scaffoldVersion, latestVersion, allVersions);
+    return {
+        currentVersion: scaffoldVersion,
+        enabledModules,
+        latestVersion,
+        upgradeAvailable,
+        versionsBehind,
+        allVersions,
+    };
+}
+/**
+ * Format a WhyReport as a multi-line human-readable string.
+ */
+export function formatWhyReport(report) {
+    const lines = [];
+    lines.push('=== Scaffold State ===');
+    lines.push(`Current version : ${report.currentVersion}`);
+    lines.push(`Latest version  : ${report.latestVersion}`);
+    if (report.upgradeAvailable) {
+        if (report.versionsBehind > 0) {
+            lines.push(`Upgrade available: yes (${report.versionsBehind} release(s) behind)`);
+        }
+        else {
+            lines.push('Upgrade available: yes');
+        }
+    }
+    else {
+        lines.push('Upgrade available: no — you are on the latest version');
+    }
+    lines.push('');
+    lines.push(`Enabled modules  : ${report.enabledModules.length === 0 ? '(none)' : ''}`);
+    for (const m of report.enabledModules) {
+        lines.push(`  - ${m}`);
+    }
+    lines.push('');
+    lines.push('Pending upgrade diff:');
+    if (!report.upgradeAvailable) {
+        lines.push('  (none)');
+    }
+    else {
+        const idx = report.allVersions.indexOf(report.currentVersion);
+        if (idx <= 0) {
+            lines.push(`  (full jump: ${report.currentVersion} → ${report.latestVersion})`);
+        }
+        else {
+            const newer = report.allVersions.slice(0, idx);
+            for (const v of newer) {
+                lines.push(`  ${v}  (newer than ${report.currentVersion})`);
+            }
+        }
+    }
+    return lines.join('\n') + '\n';
+}
+/**
+ * CLI entry point: print a human-readable (or JSON) report and return the report.
+ */
+export async function runWhyCli(options = {}) {
+    const report = await runWhy(options);
+    if (options.json) {
+        // eslint-disable-next-line no-console
+        console.log(JSON.stringify(report, null, 2));
+    }
+    else {
+        // eslint-disable-next-line no-console
+        process.stdout.write(formatWhyReport(report));
+    }
+    return report;
+}

package/dist/templates/api-skeleton.d.ts

@@ -11,8 +11,12 @@
 export declare function apiSkeletonTemplate(domainId: string, apiId: string, tenancy: string): string;
 /**
  * Generates a fixture JSON skeleton for API testing.
+ * The fixture embeds the input schema's default shape as the example payload
+ * in the event body so that the test driver can deserialize it directly.
  * @param domainId - Domain ID in kebab-case.
  * @param apiId - API ID in kebab-case.
+ * @param exampleBody - JSON-stringified example payload matching the input
+ *   schema's default shape. Defaults to '{}'.
  * @returns JSON string with mock event and context for testing.
  */
-export declare function apiFixtureSkeleton(domainId: string, apiId: string): string;
+export declare function apiFixtureSkeleton(domainId: string, apiId: string, exampleBody?: string): string;

package/dist/templates/api-skeleton.js

@@ -18,8 +18,24 @@ function camelCase(s) {
  */
 export function apiSkeletonTemplate(domainId, apiId, tenancy) {
     const tenantPath = tenancy === 'required' ? '/v1/tenants/{tenantId}' : '/v1';
+    const outputType = `${camelCase(domainId)}${camelCase(apiId)}Output`;
     return `import { z } from 'zod';
 import { defineApi } from '@mettlecast/domain-runtime';
+import { createKyClient, initOtel } from '@mettlecast/domain-runtime';
+import type { Result, AppError } from '@mettlecast/domain-runtime';
+import { ok, err, notFound } from '@mettlecast/domain-runtime';
+
+// Initialise OpenTelemetry tracing for the process.  Idempotent —
+// safe to call at module scope.  Sets up OTLP export (when
+// OTEL_EXPORTER_OTLP_ENDPOINT is set) or console-export for
+// local dev.  Auto-instruments outbound HTTP calls via ky.
+initOtel();
+
+// Shared HTTP client with retry on 503/429.  Replace this with
+// your own client if you need custom headers or auth.
+const http = createKyClient();
+
+const outputSchema = z.object({ ok: z.boolean() }).default({ ok: true });
 
 export const ${camelCase(apiId)} = defineApi({
   id: '${apiId}',
@@ -29,10 +45,12 @@ export const ${camelCase(apiId)} = defineApi({
   versions: {
     v1: {
       status: 'stable',
-      input: z.object({}).optional(),
-      output: z.object({ ok: z.boolean() }),
-      handler: async (_input, _ctx) => {
-        return { ok: true };
+      input: z.object({}).default({}),
+      output: outputSchema,
+      handler: async (_input, _ctx): Promise<Result<z.infer<typeof outputSchema>, AppError>> => {
+        // Replace this with your handler logic.
+        // Return ok(value) on success, err({ ... }) on failure.
+        return ok({ ok: true });
       },
     },
   },
@@ -45,11 +63,15 @@ export const ${camelCase(apiId)} = defineApi({
 }
 /**
  * Generates a fixture JSON skeleton for API testing.
+ * The fixture embeds the input schema's default shape as the example payload
+ * in the event body so that the test driver can deserialize it directly.
  * @param domainId - Domain ID in kebab-case.
  * @param apiId - API ID in kebab-case.
+ * @param exampleBody - JSON-stringified example payload matching the input
+ *   schema's default shape. Defaults to '{}'.
  * @returns JSON string with mock event and context for testing.
  */
-export function apiFixtureSkeleton(domainId, apiId) {
+export function apiFixtureSkeleton(domainId, apiId, exampleBody = '{}') {
     return JSON.stringify({
         description: `Fixture for ${domainId}.${apiId}`,
         event: {
@@ -68,7 +90,7 @@ export function apiFixtureSkeleton(domainId, apiId) {
             },
             pathParameters: {},
             headers: { 'content-type': 'application/json', 'accept-version': '1' },
-            body: null,
+            body: exampleBody,
         },
     }, null, 2) + '\n';
 }

package/dist/templates/patterns/api/create-with-event.d.ts

@@ -3,3 +3,8 @@
  * Produces: POST handler + publishes a domain event after mutation.
  */
 export declare function createWithEventTemplate(domain: string, id: string, tenancy: string): string;
+/**
+ * Example body string used as the event body in the add-api fixture for the
+ * create-with-event pattern. Mirrors the default shape of the input schema.
+ */
+export declare const createWithEventExampleBody: string;

package/dist/templates/patterns/api/create-with-event.js

@@ -10,17 +10,25 @@ export function createWithEventTemplate(domain, id, tenancy) {
     const tenantPath = tenancy === 'required' ? '/v1/tenants/{tenantId}' : '/v1';
     return `import { z } from 'zod';
 import { defineApi } from '@mettlecast/domain-runtime';
+import { createKyClient, initOtel } from '@mettlecast/domain-runtime';
+import type { Result, AppError } from '@mettlecast/domain-runtime';
+import { ok, err, notFound } from '@mettlecast/domain-runtime';
+
+initOtel();
 
 // ── Zod schemas ──────────────────────────────────────────────
 
 const ${varName}Input = z.object({
   name: z.string().min(1),
   payload: z.record(z.unknown()).optional(),
-});
+}).default({ name: 'Example' });
 
 const ${varName}Output = z.object({
   id: z.string().uuid(),
   status: z.enum(['created', 'pending']),
+}).default({
+  id: '00000000-0000-0000-0000-000000000000',
+  status: 'created',
 });
 
 // ── API definition ───────────────────────────────────────────
@@ -63,3 +71,8 @@ export const ${varName} = defineApi({
 });
 `;
 }
+/**
+ * Example body string used as the event body in the add-api fixture for the
+ * create-with-event pattern. Mirrors the default shape of the input schema.
+ */
+export const createWithEventExampleBody = JSON.stringify({ name: 'Example' });

package/dist/templates/patterns/api/idempotent-mutation.d.ts

@@ -3,3 +3,8 @@
  * Produces: PUT with idempotency key middleware.
  */
 export declare function idempotentMutationTemplate(domain: string, id: string, tenancy: string): string;
+/**
+ * Example body string used as the event body in the add-api fixture for the
+ * idempotent-mutation pattern. Mirrors the default shape of the input schema.
+ */
+export declare const idempotentMutationExampleBody: string;

package/dist/templates/patterns/api/idempotent-mutation.js

@@ -10,18 +10,30 @@ export function idempotentMutationTemplate(domain, id, tenancy) {
     const tenantPath = tenancy === 'required' ? '/v1/tenants/{tenantId}' : '/v1';
     return `import { z } from 'zod';
 import { defineApi } from '@mettlecast/domain-runtime';
+import { createKyClient, initOtel } from '@mettlecast/domain-runtime';
+import type { Result, AppError } from '@mettlecast/domain-runtime';
+import { ok, err, notFound } from '@mettlecast/domain-runtime';
+
+initOtel();
 
 // ── Zod schemas ──────────────────────────────────────────────
 
 const ${varName}Input = z.object({
   id: z.string().uuid(),
   payload: z.record(z.unknown()),
+}).default({
+  id: '00000000-0000-0000-0000-000000000000',
+  payload: {},
 });
 
 const ${varName}Output = z.object({
   id: z.string().uuid(),
   status: z.enum(['applied', 'already-processed']),
   idempotencyKey: z.string(),
+}).default({
+  id: '00000000-0000-0000-0000-000000000000',
+  status: 'applied',
+  idempotencyKey: '00000000-0000-0000-0000-000000000000',
 });
 
 // ── API definition ───────────────────────────────────────────
@@ -74,3 +86,11 @@ export const ${varName} = defineApi({
 });
 `;
 }
+/**
+ * Example body string used as the event body in the add-api fixture for the
+ * idempotent-mutation pattern. Mirrors the default shape of the input schema.
+ */
+export const idempotentMutationExampleBody = JSON.stringify({
+    id: '00000000-0000-0000-0000-000000000000',
+    payload: {},
+});

package/dist/templates/patterns/api/paginated-list.d.ts

@@ -3,3 +3,8 @@
  * Produces: GET with cursor/limit, pagination contract, EMF metrics.
  */
 export declare function paginatedListTemplate(domain: string, id: string, tenancy: string): string;
+/**
+ * Example body string used as the event body in the add-api fixture for the
+ * paginated-list pattern. Mirrors the default shape of the input schema.
+ */
+export declare const paginatedListExampleBody = "{}";

package/dist/templates/patterns/api/paginated-list.js

@@ -10,6 +10,11 @@ export function paginatedListTemplate(domain, id, tenancy) {
     const tenantPath = tenancy === 'required' ? '/v1/tenants/{tenantId}' : '/v1';
     return `import { z } from 'zod';
 import { defineApi } from '@mettlecast/domain-runtime';
+import { createKyClient, initOtel } from '@mettlecast/domain-runtime';
+import type { Result, AppError } from '@mettlecast/domain-runtime';
+import { ok, err, notFound } from '@mettlecast/domain-runtime';
+
+initOtel();
 
 // ── Pagination contract ──────────────────────────────────────
 
@@ -22,13 +27,13 @@ const PageInput = z.object({
     .max(100)
     .default(20),
   filter: z.string().optional(),
-});
+}).default({});
 
 const PageOutput = z.object({
   items: z.array(z.object({ id: z.string().uuid() })),
   nextCursor: z.string().optional(),
   total: z.number().int().optional(),
-});
+}).default({ items: [], nextCursor: undefined, total: undefined });
 
 // ── API definition ───────────────────────────────────────────
 
@@ -61,3 +66,8 @@ export const ${varName} = defineApi({
 });
 `;
 }
+/**
+ * Example body string used as the event body in the add-api fixture for the
+ * paginated-list pattern. Mirrors the default shape of the input schema.
+ */
+export const paginatedListExampleBody = '{}';

package/dist/templates/patterns/api/simple-crud.d.ts

@@ -4,3 +4,8 @@
  */
 export declare function simpleCrudTemplate(domain: string, id: string, tenancy: string): string;
 export declare function simpleCrudListTemplate(domain: string, id: string, tenancy: string): string;
+/**
+ * Example body string used as the event body in the add-api fixture for the
+ * simple-crud pattern. Mirrors the default shape of the input schema.
+ */
+export declare const simpleCrudExampleBody = "{}";

package/dist/templates/patterns/api/simple-crud.js

@@ -10,23 +10,32 @@ export function simpleCrudTemplate(domain, id, tenancy) {
     const tenantPath = tenancy === 'required' ? '/v1/tenants/{tenantId}' : '/v1';
     return `import { z } from 'zod';
 import { defineApi } from '@mettlecast/domain-runtime';
+import { createKyClient, initOtel } from '@mettlecast/domain-runtime';
+import type { Result, AppError } from '@mettlecast/domain-runtime';
+import { ok, err, notFound } from '@mettlecast/domain-runtime';
+
+initOtel();
 
 // ── Zod schemas ──────────────────────────────────────────────
 
 const ${varName}Input = z.object({
   id: z.string().uuid().optional(),
-});
+}).default({});
 
 const ${varName}Output = z.object({
   id: z.string().uuid(),
   createdAt: z.string().datetime(),
   updatedAt: z.string().datetime(),
+}).default({
+  id: '00000000-0000-0000-0000-000000000000',
+  createdAt: '2026-01-01T00:00:00.000Z',
+  updatedAt: '2026-01-01T00:00:00.000Z',
 });
 
 const ${varName}ListOutput = z.object({
   items: z.array(${varName}Output),
   nextCursor: z.string().optional(),
-});
+}).default({ items: [], nextCursor: undefined });
 
 // ── API definition ───────────────────────────────────────────
 
@@ -62,18 +71,22 @@ import { defineApi } from '@mettlecast/domain-runtime';
 const ${varName}ListInput = z.object({
   cursor: z.string().optional(),
   limit: z.number().int().min(1).max(100).default(20),
-});
+}).default({});
 
 const ${varName}Output = z.object({
   id: z.string().uuid(),
   createdAt: z.string().datetime(),
   updatedAt: z.string().datetime(),
+}).default({
+  id: '00000000-0000-0000-0000-000000000000',
+  createdAt: '2026-01-01T00:00:00.000Z',
+  updatedAt: '2026-01-01T00:00:00.000Z',
 });
 
 const ${varName}ListOutput = z.object({
   items: z.array(${varName}Output),
   nextCursor: z.string().optional(),
-});
+}).default({ items: [], nextCursor: undefined });
 
 export const ${varName}List = defineApi({
   id: '${id}-list',
@@ -93,3 +106,8 @@ export const ${varName}List = defineApi({
 });
 `;
 }
+/**
+ * Example body string used as the event body in the add-api fixture for the
+ * simple-crud pattern. Mirrors the default shape of the input schema.
+ */
+export const simpleCrudExampleBody = '{}';