@mettlecast/domain-cli 0.2.0

package/dist/commands/dev.js

@@ -0,0 +1,27 @@
+import { resolve } from 'node:path';
+import { buildRegistry } from '../builder/build-registry.js';
+import { createApiServer } from '../server/api-server.js';
+import { cliLogger } from '../utils/logger.js';
+/**
+ * Execute the dev command: build the domain registry and start the local Fastify
+ * HTTP server. Keeps the process running. Shuts down gracefully on SIGINT/SIGTERM.
+ * @param options - DevOptions specifying domain root and optional port.
+ */
+export async function runDev(options) {
+    const domainRoot = resolve(options.domainRoot);
+    const port = options.port ?? 3000;
+    cliLogger.info({ domainRoot }, 'Building registry for dev server');
+    const { registry, warnings } = await buildRegistry(domainRoot);
+    for (const w of warnings) {
+        cliLogger.warn(w);
+    }
+    cliLogger.info({ domain: registry.domain.id, apis: registry.apis.length, port }, 'Starting local dev server');
+    const server = await createApiServer({ port, registry, domainRoot });
+    async function shutdown() {
+        cliLogger.info('Shutting down dev server');
+        await server.close();
+        process.exit(0);
+    }
+    process.on('SIGINT', () => { void shutdown(); });
+    process.on('SIGTERM', () => { void shutdown(); });
+}

package/dist/commands/doctor.d.ts

@@ -0,0 +1,48 @@
+/**
+ * Options for the doctor command.
+ * Doctor is ALWAYS strict — any FAIL causes exit code 1.
+ */
+export interface DoctorOptions {
+    /** Root directory of the project (defaults to cwd). */
+    projectRoot?: string;
+    /** Flag to run relocation of old-layout scaffold files to new layout. */
+    relocate?: boolean;
+}
+/**
+ * A single structural check result.
+ */
+export interface DoctorCheck {
+    /** Short name of the check (e.g. 'Domain configs valid'). */
+    name: string;
+    /** Status: PASS, WARN, or FAIL. */
+    status: 'PASS' | 'WARN' | 'FAIL';
+    /** Human-readable message. */
+    message: string;
+    /** Optional fix suggestion. */
+    fixHint?: string;
+    /** Reference to a W1 K-node ID. */
+    kNodeRef?: string;
+    /** Optional file where violation found. */
+    file?: string;
+    /** Optional line number (if applicable). */
+    line?: number;
+}
+/**
+ * Result of the doctor command.
+ */
+export interface DoctorReport {
+    /** Array of all checks performed. */
+    checks: DoctorCheck[];
+    /** Exit code: 0 for all PASS/WARN, 1 for any FAIL. */
+    exitCode: number;
+    /** Convenience boolean: true if exitCode === 0. */
+    pass: boolean;
+}
+/**
+ * Run all structural checks for the current TIB project.
+ * Each check runs independently; failure of one does not abort the rest.
+ *
+ * @param opts - DoctorOptions with optional projectRoot and strict mode.
+ * @returns DoctorReport with array of checks and exit code.
+ */
+export declare function runDoctor(opts?: DoctorOptions): Promise<DoctorReport>;