@unispechq/unispec-platform 0.1.0

package/README.md

@@ -0,0 +1,225 @@
+# UniSpec Platform
+
+**CLI and local orchestrator for the UniSpec ecosystem**
+
+This repository contains the official UniSpec CLI and the foundation for a local orchestrator.
+It builds on top of:
+
+- `unispec-spec` — the UniSpec format definition (schemas, examples, reference docs)
+- `@unispechq/unispec-core` — the Core Engine (loader, validator, normalizer, diff, converters)
+
+UniSpec is a modern, multi-protocol API specification format designed to unify:
+
+- REST
+- GraphQL
+- WebSocket
+- (future) event-driven APIs
+
+---
+
+## Repository Status
+
+This repository is in early development.
+Current focus:
+
+- Provide a stable CLI surface for `validate`, `normalize`, `diff`, `convert`
+- Lay groundwork for `dev` (local orchestrator)
+- Prepare integration points for the future `unispec-registry` (publish/read)
+
+---
+
+## Repository Structure
+
+```text
+unispec-platform/
+├─ src/
+│  ├─ cli.ts              # CLI entrypoint
+│  ├─ commands/           # Command registration (validate/normalize/diff/convert/dev)
+│  ├─ io/                 # File IO + output helpers
+│  └─ config/             # Config loading (future dev/orchestrator mode)
+├─ windsurfrules.yml      # WindSurf rules (stored without dotfile)
+├─ package.json
+├─ tsconfig.json
+└─ README.md
+```
+
+## CLI Commands
+
+Global flags:
+
+- `-q, --quiet` — suppress non-essential output
+- `--verbose` — enable diagnostic output (stderr)
+- `--json-errors` — output errors as JSON (stderr)
+
+### `unispec validate [file]`
+Validates a UniSpec document against the official JSON Schemas.
+
+Options:
+
+- `--stdin` — read spec from stdin (or pass `-` as file)
+
+### `unispec normalize [file]`
+Normalizes a UniSpec document into deterministic canonical form.
+
+Options:
+
+- `--stdin` — read spec from stdin (or pass `-` as file)
+- `--format <format>` — `json|yaml`
+- `--output <file>` — write output to file (use `-` for stdout)
+
+### `unispec diff <oldFile> <newFile>`
+Computes a structural diff between two UniSpec documents.
+
+Options:
+
+- `--format <format>` — `json|yaml`
+- `--output <file>` — write output to file (use `-` for stdout)
+
+### `unispec convert [file] --to <target>`
+Converts UniSpec into other representations.
+
+Targets:
+
+- `openapi` — outputs OpenAPI 3.1 JSON/YAML
+- `graphql-sdl` — outputs GraphQL SDL
+- `ws-model` — outputs a dashboard-friendly WebSocket model
+
+Options:
+
+- `--stdin` — read spec from stdin (or pass `-` as file)
+- `--format <format>` — `json|yaml` (for JSON-like targets)
+- `--output <file>` — write output to file (use `-` for stdout)
+
+### `unispec dev`
+Local orchestrator mode.
+
+Options:
+
+- `--config <path>` — path to config file (default: `unispec.config.json|yaml|yml`)
+- `--host <host>` — bind host (default: `127.0.0.1`)
+- `--port <port>` — bind port (default: `4141`)
+- `--watch` — watch config/spec files and refresh aggregated snapshot
+
+Planned responsibilities:
+
+- Watch local specs and/or connected services
+- Aggregate multiple UniSpec documents (microservices mode)
+- Serve a local dashboard and endpoints (e.g. `/unispec.json` for aggregated view)
+- Provide a single workflow to validate/normalize/diff before publishing to Registry
+
+---
+
+## Dev server (local orchestrator)
+
+`unispec dev` starts a local HTTP API that aggregates multiple UniSpec documents.
+
+Default bind:
+
+- Host: `127.0.0.1`
+- Port: `4141`
+
+Endpoints:
+
+- `GET /health` -> `OK`
+- `GET /unispec.json` -> aggregated JSON
+
+Aggregation format (A):
+
+```json
+{
+  "version": 1,
+  "generatedAt": "2025-12-28T12:00:00.000Z",
+  "services": [
+    {
+      "name": "users",
+      "specPath": "./services/users/unispec.yaml",
+      "valid": true,
+      "spec": {}
+    }
+  ]
+}
+```
+
+If at least one service is invalid, `/unispec.json` responds with status `422` and includes per-service errors.
+
+### Example
+
+Create `unispec.config.json` (see `unispec.config.example.json`):
+
+```bash
+cp unispec.config.example.json unispec.config.json
+```
+
+Start the server:
+
+```bash
+npm run dev -- dev --verbose
+```
+
+Run using the bundled examples:
+
+```bash
+npm run dev -- dev -- --config example/unispec.config.json --verbose
+```
+
+Then open:
+
+- `http://127.0.0.1:4141/health`
+- `http://127.0.0.1:4141/unispec.json`
+
+---
+
+## Development
+
+### Requirements
+
+- Node.js >= 18
+
+### Install
+
+```bash
+npm install
+```
+
+### Run CLI in dev mode
+
+```bash
+npm run dev -- --help
+```
+
+### Build
+
+```bash
+npm run build
+```
+
+### Run built CLI
+
+```bash
+npm run start -- --help
+```
+
+---
+
+## Related Repositories
+
+| Repository | Purpose |
+|---|---|
+| `unispec-spec` | UniSpec format definition (schemas, examples) |
+| `unispec-core` | Core Engine (loader/validator/normalizer/diff/converters) |
+| `unispec-js-adapters` | Framework integrations (Express/NestJS/etc.) |
+| `unispec-registry` | (Future) publishing/reading specs and version history |
+
+---
+
+## Contributing
+
+Contributions are welcome.
+
+Please read `windsurfrules.yml` before making changes.
+
+---
+
+## License
+
+MIT

package/dist/cli.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":""}

package/dist/cli.js

@@ -0,0 +1,36 @@
+#!/usr/bin/env node
+import { Command } from "commander";
+import { registerConvertCommand, registerDevCommand, registerDiffCommand, registerNormalizeCommand, registerValidateCommand, } from "./commands/index.js";
+function errorToJson(err, includeStack) {
+    const message = err instanceof Error ? err.message : String(err);
+    const code = err instanceof Error && "code" in err ? String(err.code) : undefined;
+    const stack = includeStack && err instanceof Error ? err.stack : undefined;
+    return { error: { message, ...(code ? { code } : {}), ...(stack ? { stack } : {}) } };
+}
+const program = new Command();
+program
+    .name("unispec")
+    .description("UniSpec CLI and local orchestrator")
+    .version("0.1.0")
+    .option("-q, --quiet", "Suppress non-essential output")
+    .option("--verbose", "Enable verbose diagnostic output (stderr)")
+    .option("--json-errors", "Output errors as JSON to stderr");
+registerValidateCommand(program);
+registerNormalizeCommand(program);
+registerDiffCommand(program);
+registerConvertCommand(program);
+registerDevCommand(program);
+program.parseAsync(process.argv).catch((err) => {
+    const opts = program.opts();
+    const verbose = opts.verbose ?? false;
+    const jsonErrors = opts["jsonErrors"] ?? opts["json-errors"] ?? false;
+    if (jsonErrors) {
+        process.stderr.write(`${JSON.stringify(errorToJson(err, verbose), null, 2)}\n`);
+    }
+    else {
+        const message = err instanceof Error ? err.message : String(err);
+        process.stderr.write(`Error: ${message}\n`);
+    }
+    process.exitCode = 1;
+});
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AAEA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EACL,sBAAsB,EACtB,kBAAkB,EAClB,mBAAmB,EACnB,wBAAwB,EACxB,uBAAuB,GACxB,MAAM,qBAAqB,CAAC;AAE7B,SAAS,WAAW,CAAC,GAAY,EAAE,YAAqB;IACtD,MAAM,OAAO,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IACjE,MAAM,IAAI,GAAG,GAAG,YAAY,KAAK,IAAI,MAAM,IAAI,GAAG,CAAC,CAAC,CAAC,MAAM,CAAE,GAAW,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IAC3F,MAAM,KAAK,GAAG,YAAY,IAAI,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC;IAC3E,OAAO,EAAE,KAAK,EAAE,EAAE,OAAO,EAAE,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;AACxF,CAAC;AAED,MAAM,OAAO,GAAG,IAAI,OAAO,EAAE,CAAC;AAE9B,OAAO;KACJ,IAAI,CAAC,SAAS,CAAC;KACf,WAAW,CAAC,oCAAoC,CAAC;KACjD,OAAO,CAAC,OAAO,CAAC;KAChB,MAAM,CAAC,aAAa,EAAE,+BAA+B,CAAC;KACtD,MAAM,CAAC,WAAW,EAAE,2CAA2C,CAAC;KAChE,MAAM,CAAC,eAAe,EAAE,iCAAiC,CAAC,CAAC;AAE9D,uBAAuB,CAAC,OAAO,CAAC,CAAC;AACjC,wBAAwB,CAAC,OAAO,CAAC,CAAC;AAClC,mBAAmB,CAAC,OAAO,CAAC,CAAC;AAC7B,sBAAsB,CAAC,OAAO,CAAC,CAAC;AAChC,kBAAkB,CAAC,OAAO,CAAC,CAAC;AAE5B,OAAO,CAAC,UAAU,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,CAAC,GAAY,EAAE,EAAE;IACtD,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,EAAiD,CAAC;IAC3E,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,IAAI,KAAK,CAAC;IACtC,MAAM,UAAU,GAAI,IAAY,CAAC,YAAY,CAAC,IAAK,IAAY,CAAC,aAAa,CAAC,IAAI,KAAK,CAAC;IAExF,IAAI,UAAU,EAAE,CAAC;QACf,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,WAAW,CAAC,GAAG,EAAE,OAAO,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC;IAClF,CAAC;SAAM,CAAC;QACN,MAAM,OAAO,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QACjE,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,UAAU,OAAO,IAAI,CAAC,CAAC;IAC9C,CAAC;IACD,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;AACvB,CAAC,CAAC,CAAC"}

package/dist/commands/convert.d.ts

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"convert.d.ts","sourceRoot":"","sources":["../../src/commands/convert.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAczC,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CA2D7D"}

package/dist/commands/convert.js

@@ -0,0 +1,55 @@
+import { loadUniSpec, toGraphQLSDL, toOpenAPI, toWebSocketModel } from "@unispechq/unispec-core";
+import { readSpecInput } from "../io/readSpecInput.js";
+import { writeText } from "../io/writeFileOrStdout.js";
+import { stringifyOutput } from "../io/writeOutput.js";
+export function registerConvertCommand(program) {
+    program
+        .command("convert")
+        .description("Convert UniSpec document to another format")
+        .argument("[file]", "Path to UniSpec file (.json/.yaml) or '-' for stdin")
+        .option("--stdin", "Read spec from stdin")
+        .requiredOption("--to <target>", "Target: openapi|graphql-sdl|ws-model")
+        .option("--format <format>", "Output format for JSON-like targets: json|yaml", "json")
+        .option("--output <file>", "Write output to file (default: stdout). Use '-' for stdout")
+        .action(async function (file, options) {
+        const parentOpts = this.parent?.opts?.();
+        const verbose = parentOpts?.verbose ?? false;
+        if (verbose) {
+            const source = options.stdin || file === "-" ? "stdin" : String(file ?? "");
+            process.stderr.write(`Reading spec from ${source}\\n`);
+            process.stderr.write(`Conversion target: ${String(options.to)}\\n`);
+        }
+        const raw = await readSpecInput({ filePath: file, stdin: options.stdin });
+        const doc = await loadUniSpec(raw);
+        const target = String(options.to);
+        if (target === "openapi") {
+            const out = toOpenAPI(doc);
+            await writeText(options.output, stringifyOutput(out, options.format));
+            if (verbose) {
+                const dest = options.output && options.output !== "-" ? options.output : "stdout";
+                process.stderr.write(`Wrote OpenAPI output to ${dest}\\n`);
+            }
+            return;
+        }
+        if (target === "graphql-sdl") {
+            const out = toGraphQLSDL(doc);
+            await writeText(options.output, out.sdl.endsWith("\n") ? out.sdl : `${out.sdl}\n`);
+            if (verbose) {
+                const dest = options.output && options.output !== "-" ? options.output : "stdout";
+                process.stderr.write(`Wrote GraphQL SDL output to ${dest}\\n`);
+            }
+            return;
+        }
+        if (target === "ws-model") {
+            const out = toWebSocketModel(doc);
+            await writeText(options.output, stringifyOutput(out, options.format));
+            if (verbose) {
+                const dest = options.output && options.output !== "-" ? options.output : "stdout";
+                process.stderr.write(`Wrote WebSocket model output to ${dest}\\n`);
+            }
+            return;
+        }
+        throw new Error(`Unknown conversion target: ${target}`);
+    });
+}
+//# sourceMappingURL=convert.js.map

package/dist/commands/convert.js.map

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

package/dist/commands/dev.d.ts

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"dev.d.ts","sourceRoot":"","sources":["../../src/commands/dev.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAUzC,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CA+GzD"}

package/dist/commands/dev.js

@@ -0,0 +1,108 @@
+import { watch } from "node:fs";
+import { resolve } from "node:path";
+import { loadConfig } from "../config/loadConfig.js";
+import { findConfigPath } from "../config/loadConfig.js";
+import { aggregateFromConfig } from "../dev/aggregate.js";
+import { startDevServer } from "../dev/server.js";
+export function registerDevCommand(program) {
+    program
+        .command("dev")
+        .description("Local orchestrator mode: aggregate specs and serve a local API")
+        .option("--config <path>", "Path to unispec config file")
+        .option("--host <host>", "Host to bind", "127.0.0.1")
+        .option("--port <port>", "Port to bind", "4141")
+        .option("--watch", "Watch config/spec files and refresh aggregated snapshot")
+        .action(async function (options) {
+        const parentOpts = this.parent?.opts?.();
+        const verbose = parentOpts?.verbose ?? false;
+        const host = String(options.host ?? "127.0.0.1");
+        const port = Number(options.port ?? 4141);
+        let snapshot;
+        let snapshotError;
+        const loadAndAggregate = async () => {
+            const config = await loadConfig({ explicitPath: options.config });
+            const cfg = config ?? { version: 1, services: [] };
+            return aggregateFromConfig(cfg);
+        };
+        const refreshSnapshot = async () => {
+            try {
+                snapshot = await loadAndAggregate();
+                snapshotError = undefined;
+                if (verbose) {
+                    process.stderr.write("Refreshed aggregated snapshot\n");
+                }
+            }
+            catch (err) {
+                const message = err instanceof Error ? err.message : String(err);
+                snapshotError = { message };
+                if (verbose) {
+                    process.stderr.write(`Failed to refresh snapshot: ${message}\n`);
+                }
+            }
+        };
+        await refreshSnapshot();
+        const getConfig = async () => {
+            const config = await loadConfig({ explicitPath: options.config });
+            return config ?? { version: 1, services: [] };
+        };
+        const getAggregated = async () => {
+            if (snapshot) {
+                return snapshot;
+            }
+            if (snapshotError) {
+                return {
+                    version: 1,
+                    generatedAt: new Date().toISOString(),
+                    services: [
+                        {
+                            name: "orchestrator",
+                            specPath: "config",
+                            valid: false,
+                            errors: [snapshotError],
+                        },
+                    ],
+                };
+            }
+            return loadAndAggregate();
+        };
+        if (options.watch) {
+            const configPath = await findConfigPath({ explicitPath: options.config });
+            const cfg = await getConfig();
+            const serviceSpecs = Array.isArray(cfg.services) ? cfg.services.map((s) => String(s.spec ?? "")) : [];
+            const watchTargets = [
+                ...(configPath ? [configPath] : []),
+                ...serviceSpecs.filter(Boolean).map((p) => resolve(process.cwd(), p)),
+            ];
+            let timer;
+            const scheduleRefresh = () => {
+                if (timer)
+                    clearTimeout(timer);
+                timer = setTimeout(() => {
+                    void refreshSnapshot();
+                }, 200);
+            };
+            for (const target of watchTargets) {
+                try {
+                    watch(target, { persistent: true }, () => scheduleRefresh());
+                    if (verbose) {
+                        process.stderr.write(`Watching ${target}\n`);
+                    }
+                }
+                catch (err) {
+                    if (verbose) {
+                        const message = err instanceof Error ? err.message : String(err);
+                        process.stderr.write(`Failed to watch ${target}: ${message}\n`);
+                    }
+                }
+            }
+        }
+        await startDevServer({
+            host,
+            port,
+            getConfig,
+            getAggregated,
+            verbose,
+        });
+    });
+}
+//# sourceMappingURL=dev.js.map

package/dist/commands/dev.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dev.js","sourceRoot":"","sources":["../../src/commands/dev.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAChC,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAErD,OAAO,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAEzD,OAAO,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAC1D,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAElD,MAAM,UAAU,kBAAkB,CAAC,OAAgB;IACjD,OAAO;SACJ,OAAO,CAAC,KAAK,CAAC;SACd,WAAW,CAAC,gEAAgE,CAAC;SAC7E,MAAM,CAAC,iBAAiB,EAAE,6BAA6B,CAAC;SACxD,MAAM,CAAC,eAAe,EAAE,cAAc,EAAE,WAAW,CAAC;SACpD,MAAM,CAAC,eAAe,EAAE,cAAc,EAAE,MAAM,CAAC;SAC/C,MAAM,CAAC,SAAS,EAAE,yDAAyD,CAAC;SAC5E,MAAM,CAAC,KAAK,WAEX,OAA2E;QAE3E,MAAM,UAAU,GAAG,IAAI,CAAC,MAAM,EAAE,IAAI,EAAE,EAAwD,CAAC;QAC/F,MAAM,OAAO,GAAG,UAAU,EAAE,OAAO,IAAI,KAAK,CAAC;QAE7C,MAAM,IAAI,GAAG,MAAM,CAAC,OAAO,CAAC,IAAI,IAAI,WAAW,CAAC,CAAC;QACjD,MAAM,IAAI,GAAG,MAAM,CAAC,OAAO,CAAC,IAAI,IAAI,IAAI,CAAC,CAAC;QAE1C,IAAI,QAAqC,CAAC;QAC1C,IAAI,aAA8C,CAAC;QAEnD,MAAM,gBAAgB,GAAG,KAAK,IAA8B,EAAE;YAC5D,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,EAAE,YAAY,EAAE,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;YAClE,MAAM,GAAG,GAAG,MAAM,IAAI,EAAE,OAAO,EAAE,CAAC,EAAE,QAAQ,EAAE,EAAE,EAAE,CAAC;YACnD,OAAO,mBAAmB,CAAC,GAAG,CAAC,CAAC;QAClC,CAAC,CAAC;QAEF,MAAM,eAAe,GAAG,KAAK,IAAmB,EAAE;YAChD,IAAI,CAAC;gBACH,QAAQ,GAAG,MAAM,gBAAgB,EAAE,CAAC;gBACpC,aAAa,GAAG,SAAS,CAAC;gBAC1B,IAAI,OAAO,EAAE,CAAC;oBACZ,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,iCAAiC,CAAC,CAAC;gBAC1D,CAAC;YACH,CAAC;YAAC,OAAO,GAAY,EAAE,CAAC;gBACtB,MAAM,OAAO,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;gBACjE,aAAa,GAAG,EAAE,OAAO,EAAE,CAAC;gBAC5B,IAAI,OAAO,EAAE,CAAC;oBACZ,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,+BAA+B,OAAO,IAAI,CAAC,CAAC;gBACnE,CAAC;YACH,CAAC;QACH,CAAC,CAAC;QAEF,MAAM,eAAe,EAAE,CAAC;QAExB,MAAM,SAAS,GAAG,KAAK,IAAoC,EAAE;YAC3D,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,EAAE,YAAY,EAAE,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;YAClE,OAAO,MAAM,IAAI,EAAE,OAAO,EAAE,CAAC,EAAE,QAAQ,EAAE,EAAE,EAAE,CAAC;QAChD,CAAC,CAAC;QAEF,MAAM,aAAa,GAAG,KAAK,IAA8B,EAAE;YACzD,IAAI,QAAQ,EAAE,CAAC;gBACb,OAAO,QAAQ,CAAC;YAClB,CAAC;YACD,IAAI,aAAa,EAAE,CAAC;gBAClB,OAAO;oBACL,OAAO,EAAE,CAAC;oBACV,WAAW,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;oBACrC,QAAQ,EAAE;wBACR;4BACE,IAAI,EAAE,cAAc;4BACpB,QAAQ,EAAE,QAAQ;4BAClB,KAAK,EAAE,KAAK;4BACZ,MAAM,EAAE,CAAC,aAAa,CAAC;yBACxB;qBACF;iBACF,CAAC;YACJ,CAAC;YACD,OAAO,gBAAgB,EAAE,CAAC;QAC5B,CAAC,CAAC;QAEF,IAAI,OAAO,CAAC,KAAK,EAAE,CAAC;YAClB,MAAM,UAAU,GAAG,MAAM,cAAc,CAAC,EAAE,YAAY,EAAE,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;YAC1E,MAAM,GAAG,GAAG,MAAM,SAAS,EAAE,CAAC;YAC9B,MAAM,YAAY,GAAG,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;YACtG,MAAM,YAAY,GAAG;gBACnB,GAAG,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;gBACnC,GAAG,YAAY,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,CAAC;aACtE,CAAC;YAEF,IAAI,KAAiC,CAAC;YACtC,MAAM,eAAe,GAAG,GAAS,EAAE;gBACjC,IAAI,KAAK;oBAAE,YAAY,CAAC,KAAK,CAAC,CAAC;gBAC/B,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE;oBACtB,KAAK,eAAe,EAAE,CAAC;gBACzB,CAAC,EAAE,GAAG,CAAC,CAAC;YACV,CAAC,CAAC;YAEF,KAAK,MAAM,MAAM,IAAI,YAAY,EAAE,CAAC;gBAClC,IAAI,CAAC;oBACH,KAAK,CAAC,MAAM,EAAE,EAAE,UAAU,EAAE,IAAI,EAAE,EAAE,GAAG,EAAE,CAAC,eAAe,EAAE,CAAC,CAAC;oBAC7D,IAAI,OAAO,EAAE,CAAC;wBACZ,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,YAAY,MAAM,IAAI,CAAC,CAAC;oBAC/C,CAAC;gBACH,CAAC;gBAAC,OAAO,GAAY,EAAE,CAAC;oBACtB,IAAI,OAAO,EAAE,CAAC;wBACZ,MAAM,OAAO,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;wBACjE,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,mBAAmB,MAAM,KAAK,OAAO,IAAI,CAAC,CAAC;oBAClE,CAAC;gBACH,CAAC;YACH,CAAC;QACH,CAAC;QAED,MAAM,cAAc,CAAC;YACnB,IAAI;YACJ,IAAI;YACJ,SAAS;YACT,aAAa;YACb,OAAO;SACR,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACP,CAAC"}

package/dist/commands/diff.d.ts

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"diff.d.ts","sourceRoot":"","sources":["../../src/commands/diff.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAYzC,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CA+B1D"}

package/dist/commands/diff.js

@@ -0,0 +1,32 @@
+import { diffUniSpec, loadUniSpec } from "@unispechq/unispec-core";
+import { readSpecFile } from "../io/readSpecFile.js";
+import { writeText } from "../io/writeFileOrStdout.js";
+import { stringifyOutput } from "../io/writeOutput.js";
+export function registerDiffCommand(program) {
+    program
+        .command("diff")
+        .description("Compute a structural diff between two UniSpec documents")
+        .argument("<oldFile>", "Path to old UniSpec file")
+        .argument("<newFile>", "Path to new UniSpec file")
+        .option("--format <format>", "Output format: json|yaml", "json")
+        .option("--output <file>", "Write output to file (default: stdout). Use '-' for stdout")
+        .action(async function (oldFile, newFile, options) {
+        const parentOpts = this.parent?.opts?.();
+        const verbose = parentOpts?.verbose ?? false;
+        if (verbose) {
+            process.stderr.write(`Reading old spec from ${oldFile}\n`);
+            process.stderr.write(`Reading new spec from ${newFile}\n`);
+        }
+        const oldRaw = await readSpecFile(String(oldFile));
+        const newRaw = await readSpecFile(String(newFile));
+        const oldDoc = await loadUniSpec(oldRaw);
+        const newDoc = await loadUniSpec(newRaw);
+        const result = diffUniSpec(oldDoc, newDoc);
+        await writeText(options.output, stringifyOutput(result, options.format));
+        if (verbose) {
+            const dest = options.output && options.output !== "-" ? options.output : "stdout";
+            process.stderr.write(`Wrote diff output to ${dest}\n`);
+        }
+    });
+}
+//# sourceMappingURL=diff.js.map

package/dist/commands/diff.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"diff.js","sourceRoot":"","sources":["../../src/commands/diff.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AACnE,OAAO,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AACrD,OAAO,EAAE,SAAS,EAAE,MAAM,4BAA4B,CAAC;AAEvD,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAOvD,MAAM,UAAU,mBAAmB,CAAC,OAAgB;IAClD,OAAO;SACJ,OAAO,CAAC,MAAM,CAAC;SACf,WAAW,CAAC,yDAAyD,CAAC;SACtE,QAAQ,CAAC,WAAW,EAAE,0BAA0B,CAAC;SACjD,QAAQ,CAAC,WAAW,EAAE,0BAA0B,CAAC;SACjD,MAAM,CAAC,mBAAmB,EAAE,0BAA0B,EAAE,MAAM,CAAC;SAC/D,MAAM,CAAC,iBAAiB,EAAE,4DAA4D,CAAC;SACvF,MAAM,CAAC,KAAK,WAA0B,OAAe,EAAE,OAAe,EAAE,OAAgB;QACvF,MAAM,UAAU,GAAG,IAAI,CAAC,MAAM,EAAE,IAAI,EAAE,EAAwD,CAAC;QAC/F,MAAM,OAAO,GAAG,UAAU,EAAE,OAAO,IAAI,KAAK,CAAC;QAE7C,IAAI,OAAO,EAAE,CAAC;YACZ,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,yBAAyB,OAAO,IAAI,CAAC,CAAC;YAC3D,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,yBAAyB,OAAO,IAAI,CAAC,CAAC;QAC7D,CAAC;QAED,MAAM,MAAM,GAAG,MAAM,YAAY,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC;QACnD,MAAM,MAAM,GAAG,MAAM,YAAY,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC;QAEnD,MAAM,MAAM,GAAG,MAAM,WAAW,CAAC,MAAM,CAAC,CAAC;QACzC,MAAM,MAAM,GAAG,MAAM,WAAW,CAAC,MAAM,CAAC,CAAC;QAEzC,MAAM,MAAM,GAAG,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QAC3C,MAAM,SAAS,CAAC,OAAO,CAAC,MAAM,EAAE,eAAe,CAAC,MAAM,EAAE,OAAO,CAAC,MAAsB,CAAC,CAAC,CAAC;QAEzF,IAAI,OAAO,EAAE,CAAC;YACZ,MAAM,IAAI,GAAG,OAAO,CAAC,MAAM,IAAI,OAAO,CAAC,MAAM,KAAK,GAAG,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,QAAQ,CAAC;YAClF,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,wBAAwB,IAAI,IAAI,CAAC,CAAC;QACzD,CAAC;IACH,CAAC,CAAC,CAAC;AACP,CAAC"}

package/dist/commands/index.d.ts

@@ -0,0 +1,6 @@
+export * from "./validate.js";
+export * from "./normalize.js";
+export * from "./diff.js";
+export * from "./convert.js";
+export * from "./dev.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/commands/index.ts"],"names":[],"mappings":"AAAA,cAAc,eAAe,CAAC;AAC9B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,WAAW,CAAC;AAC1B,cAAc,cAAc,CAAC;AAC7B,cAAc,UAAU,CAAC"}

package/dist/commands/index.js

@@ -0,0 +1,6 @@
+export * from "./validate.js";
+export * from "./normalize.js";
+export * from "./diff.js";
+export * from "./convert.js";
+export * from "./dev.js";
+//# sourceMappingURL=index.js.map

package/dist/commands/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/commands/index.ts"],"names":[],"mappings":"AAAA,cAAc,eAAe,CAAC;AAC9B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,WAAW,CAAC;AAC1B,cAAc,cAAc,CAAC;AAC7B,cAAc,UAAU,CAAC"}

package/dist/commands/normalize.d.ts

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"normalize.d.ts","sourceRoot":"","sources":["../../src/commands/normalize.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAazC,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CA2B/D"}

package/dist/commands/normalize.js

@@ -0,0 +1,30 @@
+import { loadUniSpec, normalizeUniSpec } from "@unispechq/unispec-core";
+import { readSpecInput } from "../io/readSpecInput.js";
+import { writeText } from "../io/writeFileOrStdout.js";
+import { stringifyOutput } from "../io/writeOutput.js";
+export function registerNormalizeCommand(program) {
+    program
+        .command("normalize")
+        .description("Normalize a UniSpec document into deterministic canonical form")
+        .argument("[file]", "Path to UniSpec file (.json/.yaml) or '-' for stdin")
+        .option("--stdin", "Read spec from stdin")
+        .option("--format <format>", "Output format: json|yaml", "json")
+        .option("--output <file>", "Write output to file (default: stdout). Use '-' for stdout")
+        .action(async function (file, options) {
+        const parentOpts = this.parent?.opts?.();
+        const verbose = parentOpts?.verbose ?? false;
+        if (verbose) {
+            const source = options.stdin || file === "-" ? "stdin" : String(file ?? "");
+            process.stderr.write(`Reading spec from ${source}\n`);
+        }
+        const raw = await readSpecInput({ filePath: file, stdin: options.stdin });
+        const doc = await loadUniSpec(raw);
+        const normalized = normalizeUniSpec(doc);
+        await writeText(options.output, stringifyOutput(normalized, options.format));
+        if (verbose) {
+            const dest = options.output && options.output !== "-" ? options.output : "stdout";
+            process.stderr.write(`Wrote normalized output to ${dest}\n`);
+        }
+    });
+}
+//# sourceMappingURL=normalize.js.map

package/dist/commands/normalize.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"normalize.js","sourceRoot":"","sources":["../../src/commands/normalize.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AACxE,OAAO,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AACvD,OAAO,EAAE,SAAS,EAAE,MAAM,4BAA4B,CAAC;AAEvD,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAQvD,MAAM,UAAU,wBAAwB,CAAC,OAAgB;IACvD,OAAO;SACJ,OAAO,CAAC,WAAW,CAAC;SACpB,WAAW,CAAC,gEAAgE,CAAC;SAC7E,QAAQ,CAAC,QAAQ,EAAE,qDAAqD,CAAC;SACzE,MAAM,CAAC,SAAS,EAAE,sBAAsB,CAAC;SACzC,MAAM,CAAC,mBAAmB,EAAE,0BAA0B,EAAE,MAAM,CAAC;SAC/D,MAAM,CAAC,iBAAiB,EAAE,4DAA4D,CAAC;SACvF,MAAM,CAAC,KAAK,WAA0B,IAAwB,EAAE,OAAgB;QAC/E,MAAM,UAAU,GAAG,IAAI,CAAC,MAAM,EAAE,IAAI,EAAE,EAAwD,CAAC;QAC/F,MAAM,OAAO,GAAG,UAAU,EAAE,OAAO,IAAI,KAAK,CAAC;QAE7C,IAAI,OAAO,EAAE,CAAC;YACZ,MAAM,MAAM,GAAG,OAAO,CAAC,KAAK,IAAI,IAAI,KAAK,GAAG,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC;YAC5E,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,qBAAqB,MAAM,IAAI,CAAC,CAAC;QACxD,CAAC;QAED,MAAM,GAAG,GAAG,MAAM,aAAa,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,CAAC,CAAC;QAC1E,MAAM,GAAG,GAAG,MAAM,WAAW,CAAC,GAAG,CAAC,CAAC;QACnC,MAAM,UAAU,GAAG,gBAAgB,CAAC,GAAG,CAAC,CAAC;QACzC,MAAM,SAAS,CAAC,OAAO,CAAC,MAAM,EAAE,eAAe,CAAC,UAAU,EAAE,OAAO,CAAC,MAAsB,CAAC,CAAC,CAAC;QAE7F,IAAI,OAAO,EAAE,CAAC;YACZ,MAAM,IAAI,GAAG,OAAO,CAAC,MAAM,IAAI,OAAO,CAAC,MAAM,KAAK,GAAG,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,QAAQ,CAAC;YAClF,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,8BAA8B,IAAI,IAAI,CAAC,CAAC;QAC/D,CAAC;IACH,CAAC,CAAC,CAAC;AACP,CAAC"}

package/dist/commands/validate.d.ts

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"validate.d.ts","sourceRoot":"","sources":["../../src/commands/validate.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAKzC,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CA8B9D"}

package/dist/commands/validate.js

@@ -0,0 +1,31 @@
+import { loadUniSpec, validateUniSpec } from "@unispechq/unispec-core";
+import { readSpecInput } from "../io/readSpecInput.js";
+import { writeOutput } from "../io/writeOutput.js";
+export function registerValidateCommand(program) {
+    program
+        .command("validate")
+        .description("Validate a UniSpec document against the official JSON Schemas")
+        .argument("[file]", "Path to UniSpec file (.json/.yaml) or '-' for stdin")
+        .option("--stdin", "Read spec from stdin")
+        .action(async function (file, options) {
+        const parentOpts = this.parent?.opts?.();
+        const quiet = parentOpts?.quiet ?? false;
+        const verbose = parentOpts?.verbose ?? false;
+        const raw = await readSpecInput({ filePath: file, stdin: options.stdin });
+        const doc = await loadUniSpec(raw);
+        const result = await validateUniSpec(doc);
+        if (result.valid) {
+            if (!quiet) {
+                process.stdout.write("OK\n");
+            }
+            process.exitCode = 0;
+            return;
+        }
+        if (verbose) {
+            process.stderr.write("Validation failed\n");
+        }
+        writeOutput(result, "json");
+        process.exitCode = 1;
+    });
+}
+//# sourceMappingURL=validate.js.map

package/dist/commands/validate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate.js","sourceRoot":"","sources":["../../src/commands/validate.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AACvE,OAAO,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AACvD,OAAO,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAEnD,MAAM,UAAU,uBAAuB,CAAC,OAAgB;IACtD,OAAO;SACJ,OAAO,CAAC,UAAU,CAAC;SACnB,WAAW,CAAC,+DAA+D,CAAC;SAC5E,QAAQ,CAAC,QAAQ,EAAE,qDAAqD,CAAC;SACzE,MAAM,CAAC,SAAS,EAAE,sBAAsB,CAAC;SACzC,MAAM,CAAC,KAAK,WAA0B,IAAwB,EAAE,OAA4B;QAC3F,MAAM,UAAU,GAAG,IAAI,CAAC,MAAM,EAAE,IAAI,EAAE,EAAwD,CAAC;QAC/F,MAAM,KAAK,GAAG,UAAU,EAAE,KAAK,IAAI,KAAK,CAAC;QACzC,MAAM,OAAO,GAAG,UAAU,EAAE,OAAO,IAAI,KAAK,CAAC;QAE7C,MAAM,GAAG,GAAG,MAAM,aAAa,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,CAAC,CAAC;QAC1E,MAAM,GAAG,GAAG,MAAM,WAAW,CAAC,GAAG,CAAC,CAAC;QACnC,MAAM,MAAM,GAAG,MAAM,eAAe,CAAC,GAAG,CAAC,CAAC;QAE1C,IAAI,MAAM,CAAC,KAAK,EAAE,CAAC;YACjB,IAAI,CAAC,KAAK,EAAE,CAAC;gBACX,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;YAC/B,CAAC;YACD,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;YACrB,OAAO;QACT,CAAC;QAED,IAAI,OAAO,EAAE,CAAC;YACZ,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,qBAAqB,CAAC,CAAC;QAC9C,CAAC;QAED,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QAC5B,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;IACvB,CAAC,CAAC,CAAC;AACP,CAAC"}

package/dist/config/loadConfig.d.ts

@@ -0,0 +1,13 @@
+export interface UniSpecPlatformConfig {
+    version?: number;
+    services?: Array<{
+        name: string;
+        spec: string;
+    }>;
+}
+export interface LoadConfigOptions {
+    explicitPath?: string;
+}
+export declare function findConfigPath(options?: LoadConfigOptions): Promise<string | undefined>;
+export declare function loadConfig(options?: LoadConfigOptions): Promise<UniSpecPlatformConfig | undefined>;
+//# sourceMappingURL=loadConfig.d.ts.map

package/dist/config/loadConfig.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"loadConfig.d.ts","sourceRoot":"","sources":["../../src/config/loadConfig.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,qBAAqB;IACpC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,KAAK,CAAC;QACf,IAAI,EAAE,MAAM,CAAC;QACb,IAAI,EAAE,MAAM,CAAC;KACd,CAAC,CAAC;CACJ;AAED,MAAM,WAAW,iBAAiB;IAChC,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAkBD,wBAAsB,cAAc,CAAC,OAAO,GAAE,iBAAsB,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAajG;AAED,wBAAsB,UAAU,CAAC,OAAO,GAAE,iBAAsB,GAAG,OAAO,CAAC,qBAAqB,GAAG,SAAS,CAAC,CAY5G"}

package/dist/config/loadConfig.js

@@ -0,0 +1,42 @@
+import { access, readFile } from "node:fs/promises";
+import { resolve } from "node:path";
+import YAML from "yaml";
+async function fileExists(path) {
+    try {
+        await access(path);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+function parseByExt(filePath, raw) {
+    if (filePath.endsWith(".yaml") || filePath.endsWith(".yml")) {
+        return YAML.parse(raw);
+    }
+    return JSON.parse(raw);
+}
+export async function findConfigPath(options = {}) {
+    const candidates = options.explicitPath
+        ? [options.explicitPath]
+        : ["unispec.config.json", "unispec.config.yaml", "unispec.config.yml"];
+    for (const rel of candidates) {
+        const abs = resolve(process.cwd(), rel);
+        if (await fileExists(abs)) {
+            return abs;
+        }
+    }
+    return undefined;
+}
+export async function loadConfig(options = {}) {
+    const abs = await findConfigPath(options);
+    if (abs) {
+        const raw = (await readFile(abs, "utf8")).trim();
+        if (!raw) {
+            return {};
+        }
+        return parseByExt(abs, raw);
+    }
+    return undefined;
+}
+//# sourceMappingURL=loadConfig.js.map

package/dist/config/loadConfig.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"loadConfig.js","sourceRoot":"","sources":["../../src/config/loadConfig.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,IAAI,MAAM,MAAM,CAAC;AAcxB,KAAK,UAAU,UAAU,CAAC,IAAY;IACpC,IAAI,CAAC;QACH,MAAM,MAAM,CAAC,IAAI,CAAC,CAAC;QACnB,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED,SAAS,UAAU,CAAC,QAAgB,EAAE,GAAW;IAC/C,IAAI,QAAQ,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,QAAQ,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;QAC5D,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IACzB,CAAC;IACD,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;AACzB,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,UAA6B,EAAE;IAClE,MAAM,UAAU,GAAG,OAAO,CAAC,YAAY;QACrC,CAAC,CAAC,CAAC,OAAO,CAAC,YAAY,CAAC;QACxB,CAAC,CAAC,CAAC,qBAAqB,EAAE,qBAAqB,EAAE,oBAAoB,CAAC,CAAC;IAEzE,KAAK,MAAM,GAAG,IAAI,UAAU,EAAE,CAAC;QAC7B,MAAM,GAAG,GAAG,OAAO,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,GAAG,CAAC,CAAC;QACxC,IAAI,MAAM,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;YAC1B,OAAO,GAAG,CAAC;QACb,CAAC;IACH,CAAC;IAED,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,UAA6B,EAAE;IAC9D,MAAM,GAAG,GAAG,MAAM,cAAc,CAAC,OAAO,CAAC,CAAC;IAC1C,IAAI,GAAG,EAAE,CAAC;QACR,MAAM,GAAG,GAAG,CAAC,MAAM,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;QACjD,IAAI,CAAC,GAAG,EAAE,CAAC;YACT,OAAO,EAAE,CAAC;QACZ,CAAC;QAED,OAAO,UAAU,CAAC,GAAG,EAAE,GAAG,CAA0B,CAAC;IACvD,CAAC;IAED,OAAO,SAAS,CAAC;AACnB,CAAC"}

package/dist/dev/aggregate.d.ts

@@ -0,0 +1,15 @@
+import type { UniSpecPlatformConfig } from "../config/loadConfig.js";
+export interface AggregatedService {
+    name: string;
+    specPath: string;
+    valid: boolean;
+    errors?: unknown;
+    spec?: unknown;
+}
+export interface AggregateResult {
+    version: number;
+    generatedAt: string;
+    services: AggregatedService[];
+}
+export declare function aggregateFromConfig(config: UniSpecPlatformConfig): Promise<AggregateResult>;
+//# sourceMappingURL=aggregate.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"aggregate.d.ts","sourceRoot":"","sources":["../../src/dev/aggregate.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AAGrE,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAED,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,iBAAiB,EAAE,CAAC;CAC/B;AAED,wBAAsB,mBAAmB,CAAC,MAAM,EAAE,qBAAqB,GAAG,OAAO,CAAC,eAAe,CAAC,CA0DjG"}

package/dist/dev/aggregate.js

@@ -0,0 +1,56 @@
+import { loadUniSpec, normalizeUniSpec, validateUniSpec } from "@unispechq/unispec-core";
+import { readSpecFile } from "../io/readSpecFile.js";
+export async function aggregateFromConfig(config) {
+    const version = typeof config.version === "number" ? config.version : 1;
+    const services = Array.isArray(config.services) ? config.services : [];
+    const results = [];
+    for (const service of services) {
+        const name = String(service?.name ?? "");
+        const specPath = String(service?.spec ?? "");
+        if (!name || !specPath) {
+            results.push({
+                name: name || "unknown",
+                specPath,
+                valid: false,
+                errors: [{ message: "Invalid config entry: service.name and service.spec are required" }],
+            });
+            continue;
+        }
+        try {
+            const raw = await readSpecFile(specPath);
+            const doc = await loadUniSpec(raw);
+            const validation = await validateUniSpec(doc);
+            if (!validation.valid) {
+                results.push({
+                    name,
+                    specPath,
+                    valid: false,
+                    errors: validation.errors,
+                });
+                continue;
+            }
+            const normalized = normalizeUniSpec(doc);
+            results.push({
+                name,
+                specPath,
+                valid: true,
+                spec: normalized,
+            });
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : String(err);
+            results.push({
+                name,
+                specPath,
+                valid: false,
+                errors: [{ message }],
+            });
+        }
+    }
+    return {
+        version,
+        generatedAt: new Date().toISOString(),
+        services: results,
+    };
+}
+//# sourceMappingURL=aggregate.js.map

package/dist/dev/aggregate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"aggregate.js","sourceRoot":"","sources":["../../src/dev/aggregate.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAEzF,OAAO,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAgBrD,MAAM,CAAC,KAAK,UAAU,mBAAmB,CAAC,MAA6B;IACrE,MAAM,OAAO,GAAG,OAAO,MAAM,CAAC,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC;IACxE,MAAM,QAAQ,GAAG,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC;IAEvE,MAAM,OAAO,GAAwB,EAAE,CAAC;IAExC,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;QAC/B,MAAM,IAAI,GAAG,MAAM,CAAC,OAAO,EAAE,IAAI,IAAI,EAAE,CAAC,CAAC;QACzC,MAAM,QAAQ,GAAG,MAAM,CAAC,OAAO,EAAE,IAAI,IAAI,EAAE,CAAC,CAAC;QAE7C,IAAI,CAAC,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;YACvB,OAAO,CAAC,IAAI,CAAC;gBACX,IAAI,EAAE,IAAI,IAAI,SAAS;gBACvB,QAAQ;gBACR,KAAK,EAAE,KAAK;gBACZ,MAAM,EAAE,CAAC,EAAE,OAAO,EAAE,kEAAkE,EAAE,CAAC;aAC1F,CAAC,CAAC;YACH,SAAS;QACX,CAAC;QAED,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,MAAM,YAAY,CAAC,QAAQ,CAAC,CAAC;YACzC,MAAM,GAAG,GAAG,MAAM,WAAW,CAAC,GAAG,CAAC,CAAC;YACnC,MAAM,UAAU,GAAG,MAAM,eAAe,CAAC,GAAG,CAAC,CAAC;YAE9C,IAAI,CAAC,UAAU,CAAC,KAAK,EAAE,CAAC;gBACtB,OAAO,CAAC,IAAI,CAAC;oBACX,IAAI;oBACJ,QAAQ;oBACR,KAAK,EAAE,KAAK;oBACZ,MAAM,EAAE,UAAU,CAAC,MAAM;iBAC1B,CAAC,CAAC;gBACH,SAAS;YACX,CAAC;YAED,MAAM,UAAU,GAAG,gBAAgB,CAAC,GAAG,CAAC,CAAC;YACzC,OAAO,CAAC,IAAI,CAAC;gBACX,IAAI;gBACJ,QAAQ;gBACR,KAAK,EAAE,IAAI;gBACX,IAAI,EAAE,UAAU;aACjB,CAAC,CAAC;QACL,CAAC;QAAC,OAAO,GAAY,EAAE,CAAC;YACtB,MAAM,OAAO,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YACjE,OAAO,CAAC,IAAI,CAAC;gBACX,IAAI;gBACJ,QAAQ;gBACR,KAAK,EAAE,KAAK;gBACZ,MAAM,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC;aACtB,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED,OAAO;QACL,OAAO;QACP,WAAW,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;QACrC,QAAQ,EAAE,OAAO;KAClB,CAAC;AACJ,CAAC"}

package/dist/dev/index.d.ts

@@ -0,0 +1,3 @@
+export * from "./aggregate.js";
+export * from "./server.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/dev/index.ts"],"names":[],"mappings":"AAAA,cAAc,gBAAgB,CAAC;AAC/B,cAAc,aAAa,CAAC"}

package/dist/dev/index.js

@@ -0,0 +1,3 @@
+export * from "./aggregate.js";
+export * from "./server.js";
+//# sourceMappingURL=index.js.map

package/dist/dev/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/dev/index.ts"],"names":[],"mappings":"AAAA,cAAc,gBAAgB,CAAC;AAC/B,cAAc,aAAa,CAAC"}

package/dist/dev/server.d.ts

@@ -0,0 +1,12 @@
+import http from "node:http";
+import type { AggregateResult } from "./aggregate.js";
+import type { UniSpecPlatformConfig } from "../config/loadConfig.js";
+export interface DevServerOptions {
+    host: string;
+    port: number;
+    getConfig: () => Promise<UniSpecPlatformConfig>;
+    getAggregated?: () => Promise<AggregateResult>;
+    verbose?: boolean;
+}
+export declare function startDevServer(options: DevServerOptions): Promise<http.Server>;
+//# sourceMappingURL=server.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../src/dev/server.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AACtD,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AAErE,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,OAAO,CAAC,qBAAqB,CAAC,CAAC;IAChD,aAAa,CAAC,EAAE,MAAM,OAAO,CAAC,eAAe,CAAC,CAAC;IAC/C,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AASD,wBAAsB,cAAc,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAuCpF"}

package/dist/dev/server.js

@@ -0,0 +1,44 @@
+import http from "node:http";
+import { aggregateFromConfig } from "./aggregate.js";
+function writeJson(res, status, body) {
+    const json = JSON.stringify(body, null, 2);
+    res.statusCode = status;
+    res.setHeader("content-type", "application/json; charset=utf-8");
+    res.end(`${json}\n`);
+}
+export async function startDevServer(options) {
+    const server = http.createServer(async (req, res) => {
+        const method = req.method ?? "GET";
+        const url = req.url ?? "/";
+        if (method === "GET" && url === "/health") {
+            res.statusCode = 200;
+            res.setHeader("content-type", "text/plain; charset=utf-8");
+            res.end("OK\n");
+            return;
+        }
+        if (method === "GET" && url === "/unispec.json") {
+            try {
+                const aggregated = options.getAggregated
+                    ? await options.getAggregated()
+                    : await aggregateFromConfig(await options.getConfig());
+                const hasErrors = aggregated.services.some((s) => !s.valid);
+                writeJson(res, hasErrors ? 422 : 200, aggregated);
+            }
+            catch (err) {
+                const message = err instanceof Error ? err.message : String(err);
+                writeJson(res, 500, { error: { message } });
+            }
+            return;
+        }
+        writeJson(res, 404, { error: { message: "Not found" } });
+    });
+    await new Promise((resolve, reject) => {
+        server.once("error", reject);
+        server.listen(options.port, options.host, () => resolve());
+    });
+    if (options.verbose) {
+        process.stderr.write(`Dev server listening on http://${options.host}:${options.port}\n`);
+    }
+    return server;
+}
+//# sourceMappingURL=server.js.map

package/dist/dev/server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../../src/dev/server.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAYrD,SAAS,SAAS,CAAC,GAAwB,EAAE,MAAc,EAAE,IAAa;IACxE,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;IAC3C,GAAG,CAAC,UAAU,GAAG,MAAM,CAAC;IACxB,GAAG,CAAC,SAAS,CAAC,cAAc,EAAE,iCAAiC,CAAC,CAAC;IACjE,GAAG,CAAC,GAAG,CAAC,GAAG,IAAI,IAAI,CAAC,CAAC;AACvB,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,OAAyB;IAC5D,MAAM,MAAM,GAAG,IAAI,CAAC,YAAY,CAAC,KAAK,EAAE,GAAG,EAAE,GAAG,EAAE,EAAE;QAClD,MAAM,MAAM,GAAG,GAAG,CAAC,MAAM,IAAI,KAAK,CAAC;QACnC,MAAM,GAAG,GAAG,GAAG,CAAC,GAAG,IAAI,GAAG,CAAC;QAE3B,IAAI,MAAM,KAAK,KAAK,IAAI,GAAG,KAAK,SAAS,EAAE,CAAC;YAC1C,GAAG,CAAC,UAAU,GAAG,GAAG,CAAC;YACrB,GAAG,CAAC,SAAS,CAAC,cAAc,EAAE,2BAA2B,CAAC,CAAC;YAC3D,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;YAChB,OAAO;QACT,CAAC;QAED,IAAI,MAAM,KAAK,KAAK,IAAI,GAAG,KAAK,eAAe,EAAE,CAAC;YAChD,IAAI,CAAC;gBACH,MAAM,UAAU,GAAG,OAAO,CAAC,aAAa;oBACtC,CAAC,CAAC,MAAM,OAAO,CAAC,aAAa,EAAE;oBAC/B,CAAC,CAAC,MAAM,mBAAmB,CAAC,MAAM,OAAO,CAAC,SAAS,EAAE,CAAC,CAAC;gBACzD,MAAM,SAAS,GAAG,UAAU,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;gBAC5D,SAAS,CAAC,GAAG,EAAE,SAAS,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,EAAE,UAAU,CAAC,CAAC;YACpD,CAAC;YAAC,OAAO,GAAY,EAAE,CAAC;gBACtB,MAAM,OAAO,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;gBACjE,SAAS,CAAC,GAAG,EAAE,GAAG,EAAE,EAAE,KAAK,EAAE,EAAE,OAAO,EAAE,EAAE,CAAC,CAAC;YAC9C,CAAC;YACD,OAAO;QACT,CAAC;QAED,SAAS,CAAC,GAAG,EAAE,GAAG,EAAE,EAAE,KAAK,EAAE,EAAE,OAAO,EAAE,WAAW,EAAE,EAAE,CAAC,CAAC;IAC3D,CAAC,CAAC,CAAC;IAEH,MAAM,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QAC1C,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;QAC7B,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,IAAI,EAAE,GAAG,EAAE,CAAC,OAAO,EAAE,CAAC,CAAC;IAC7D,CAAC,CAAC,CAAC;IAEH,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;QACpB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,kCAAkC,OAAO,CAAC,IAAI,IAAI,OAAO,CAAC,IAAI,IAAI,CAAC,CAAC;IAC3F,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/io/index.d.ts

@@ -0,0 +1,6 @@
+export * from "./readSpecFile.js";
+export * from "./readSpecInput.js";
+export * from "./readStdinText.js";
+export * from "./writeOutput.js";
+export * from "./writeFileOrStdout.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/io/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/io/index.ts"],"names":[],"mappings":"AAAA,cAAc,mBAAmB,CAAC;AAClC,cAAc,oBAAoB,CAAC;AACnC,cAAc,oBAAoB,CAAC;AACnC,cAAc,kBAAkB,CAAC;AACjC,cAAc,wBAAwB,CAAC"}

package/dist/io/index.js

@@ -0,0 +1,6 @@
+export * from "./readSpecFile.js";
+export * from "./readSpecInput.js";
+export * from "./readStdinText.js";
+export * from "./writeOutput.js";
+export * from "./writeFileOrStdout.js";
+//# sourceMappingURL=index.js.map

package/dist/io/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/io/index.ts"],"names":[],"mappings":"AAAA,cAAc,mBAAmB,CAAC;AAClC,cAAc,oBAAoB,CAAC;AACnC,cAAc,oBAAoB,CAAC;AACnC,cAAc,kBAAkB,CAAC;AACjC,cAAc,wBAAwB,CAAC"}

package/dist/io/readSpecFile.d.ts

@@ -0,0 +1,2 @@
+export declare function readSpecFile(filePath: string): Promise<object>;
+//# sourceMappingURL=readSpecFile.d.ts.map

package/dist/io/readSpecFile.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"readSpecFile.d.ts","sourceRoot":"","sources":["../../src/io/readSpecFile.ts"],"names":[],"mappings":"AAQA,wBAAsB,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAsBpE"}

package/dist/io/readSpecFile.js

@@ -0,0 +1,27 @@
+import { readFile } from "node:fs/promises";
+import { resolve } from "node:path";
+import YAML from "yaml";
+function isObjectLike(value) {
+    return typeof value === "object" && value !== null;
+}
+export async function readSpecFile(filePath) {
+    const abs = resolve(process.cwd(), filePath);
+    const raw = await readFile(abs, "utf8");
+    const trimmed = raw.trim();
+    if (!trimmed) {
+        throw new Error(`Spec file is empty: ${filePath}`);
+    }
+    if (filePath.endsWith(".yaml") || filePath.endsWith(".yml")) {
+        const parsed = YAML.parse(trimmed);
+        if (!isObjectLike(parsed)) {
+            throw new Error(`Spec file must contain an object at the root: ${filePath}`);
+        }
+        return parsed;
+    }
+    const parsed = JSON.parse(trimmed);
+    if (!isObjectLike(parsed)) {
+        throw new Error(`Spec file must contain an object at the root: ${filePath}`);
+    }
+    return parsed;
+}
+//# sourceMappingURL=readSpecFile.js.map

package/dist/io/readSpecFile.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"readSpecFile.js","sourceRoot":"","sources":["../../src/io/readSpecFile.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,IAAI,MAAM,MAAM,CAAC;AAExB,SAAS,YAAY,CAAC,KAAc;IAClC,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,CAAC;AACrD,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,QAAgB;IACjD,MAAM,GAAG,GAAG,OAAO,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,QAAQ,CAAC,CAAC;IAC7C,MAAM,GAAG,GAAG,MAAM,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;IACxC,MAAM,OAAO,GAAG,GAAG,CAAC,IAAI,EAAE,CAAC;IAE3B,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,MAAM,IAAI,KAAK,CAAC,uBAAuB,QAAQ,EAAE,CAAC,CAAC;IACrD,CAAC;IAED,IAAI,QAAQ,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,QAAQ,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;QAC5D,MAAM,MAAM,GAAY,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QAC5C,IAAI,CAAC,YAAY,CAAC,MAAM,CAAC,EAAE,CAAC;YAC1B,MAAM,IAAI,KAAK,CAAC,iDAAiD,QAAQ,EAAE,CAAC,CAAC;QAC/E,CAAC;QACD,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,MAAM,MAAM,GAAY,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IAC5C,IAAI,CAAC,YAAY,CAAC,MAAM,CAAC,EAAE,CAAC;QAC1B,MAAM,IAAI,KAAK,CAAC,iDAAiD,QAAQ,EAAE,CAAC,CAAC;IAC/E,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/io/readSpecInput.d.ts

@@ -0,0 +1,6 @@
+export interface ReadSpecInputOptions {
+    filePath?: string;
+    stdin?: boolean;
+}
+export declare function readSpecInput(options: ReadSpecInputOptions): Promise<object>;
+//# sourceMappingURL=readSpecInput.d.ts.map

package/dist/io/readSpecInput.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"readSpecInput.d.ts","sourceRoot":"","sources":["../../src/io/readSpecInput.ts"],"names":[],"mappings":"AAgDA,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,wBAAsB,aAAa,CAAC,OAAO,EAAE,oBAAoB,GAAG,OAAO,CAAC,MAAM,CAAC,CAalF"}

package/dist/io/readSpecInput.js

@@ -0,0 +1,54 @@
+import YAML from "yaml";
+import { readStdinText } from "./readStdinText.js";
+import { readSpecFile } from "./readSpecFile.js";
+function isObjectLike(value) {
+    return typeof value === "object" && value !== null;
+}
+function parseSpecText(sourceHint, text) {
+    const trimmed = text.trim();
+    if (!trimmed) {
+        throw new Error(`Spec input is empty: ${sourceHint}`);
+    }
+    const ext = sourceHint.toLowerCase();
+    if (ext.endsWith(".yaml") || ext.endsWith(".yml")) {
+        const parsed = YAML.parse(trimmed);
+        if (!isObjectLike(parsed)) {
+            throw new Error(`Spec input must contain an object at the root: ${sourceHint}`);
+        }
+        return parsed;
+    }
+    if (ext.endsWith(".json")) {
+        const parsed = JSON.parse(trimmed);
+        if (!isObjectLike(parsed)) {
+            throw new Error(`Spec input must contain an object at the root: ${sourceHint}`);
+        }
+        return parsed;
+    }
+    // Autodetect: try JSON first, then YAML.
+    try {
+        const parsedJson = JSON.parse(trimmed);
+        if (!isObjectLike(parsedJson)) {
+            throw new Error(`Spec input must contain an object at the root: ${sourceHint}`);
+        }
+        return parsedJson;
+    }
+    catch {
+        const parsedYaml = YAML.parse(trimmed);
+        if (!isObjectLike(parsedYaml)) {
+            throw new Error(`Spec input must contain an object at the root: ${sourceHint}`);
+        }
+        return parsedYaml;
+    }
+}
+export async function readSpecInput(options) {
+    const filePath = options.filePath;
+    if (options.stdin || filePath === "-") {
+        const text = await readStdinText();
+        return parseSpecText(filePath ?? "stdin", text);
+    }
+    if (!filePath) {
+        throw new Error("Missing spec input: provide <file> or --stdin");
+    }
+    return readSpecFile(filePath);
+}
+//# sourceMappingURL=readSpecInput.js.map

package/dist/io/readSpecInput.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"readSpecInput.js","sourceRoot":"","sources":["../../src/io/readSpecInput.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,MAAM,CAAC;AACxB,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEjD,SAAS,YAAY,CAAC,KAAc;IAClC,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,CAAC;AACrD,CAAC;AAED,SAAS,aAAa,CAAC,UAAkB,EAAE,IAAY;IACrD,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;IAC5B,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,MAAM,IAAI,KAAK,CAAC,wBAAwB,UAAU,EAAE,CAAC,CAAC;IACxD,CAAC;IAED,MAAM,GAAG,GAAG,UAAU,CAAC,WAAW,EAAE,CAAC;IAErC,IAAI,GAAG,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,GAAG,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;QAClD,MAAM,MAAM,GAAY,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QAC5C,IAAI,CAAC,YAAY,CAAC,MAAM,CAAC,EAAE,CAAC;YAC1B,MAAM,IAAI,KAAK,CAAC,kDAAkD,UAAU,EAAE,CAAC,CAAC;QAClF,CAAC;QACD,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,IAAI,GAAG,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC;QAC1B,MAAM,MAAM,GAAY,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QAC5C,IAAI,CAAC,YAAY,CAAC,MAAM,CAAC,EAAE,CAAC;YAC1B,MAAM,IAAI,KAAK,CAAC,kDAAkD,UAAU,EAAE,CAAC,CAAC;QAClF,CAAC;QACD,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,yCAAyC;IACzC,IAAI,CAAC;QACH,MAAM,UAAU,GAAY,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QAChD,IAAI,CAAC,YAAY,CAAC,UAAU,CAAC,EAAE,CAAC;YAC9B,MAAM,IAAI,KAAK,CAAC,kDAAkD,UAAU,EAAE,CAAC,CAAC;QAClF,CAAC;QACD,OAAO,UAAU,CAAC;IACpB,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,UAAU,GAAY,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QAChD,IAAI,CAAC,YAAY,CAAC,UAAU,CAAC,EAAE,CAAC;YAC9B,MAAM,IAAI,KAAK,CAAC,kDAAkD,UAAU,EAAE,CAAC,CAAC;QAClF,CAAC;QACD,OAAO,UAAU,CAAC;IACpB,CAAC;AACH,CAAC;AAOD,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,OAA6B;IAC/D,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC;IAElC,IAAI,OAAO,CAAC,KAAK,IAAI,QAAQ,KAAK,GAAG,EAAE,CAAC;QACtC,MAAM,IAAI,GAAG,MAAM,aAAa,EAAE,CAAC;QACnC,OAAO,aAAa,CAAC,QAAQ,IAAI,OAAO,EAAE,IAAI,CAAC,CAAC;IAClD,CAAC;IAED,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,MAAM,IAAI,KAAK,CAAC,+CAA+C,CAAC,CAAC;IACnE,CAAC;IAED,OAAO,YAAY,CAAC,QAAQ,CAAC,CAAC;AAChC,CAAC"}

package/dist/io/readStdin.d.ts

@@ -0,0 +1,2 @@
+export declare function readStdinText(): Promise<string>;
+//# sourceMappingURL=readStdin.d.ts.map

package/dist/io/readStdin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"readStdin.d.ts","sourceRoot":"","sources":["../../src/io/readStdin.ts"],"names":[],"mappings":"AAAA,wBAAsB,aAAa,IAAI,OAAO,CAAC,MAAM,CAAC,CAiBrD"}

package/dist/io/readStdin.js

@@ -0,0 +1,17 @@
+export async function readStdinText() {
+    return new Promise((resolve, reject) => {
+        let data = "";
+        process.stdin.setEncoding("utf8");
+        process.stdin.on("data", (chunk) => {
+            data += chunk;
+        });
+        process.stdin.on("end", () => resolve(data));
+        process.stdin.on("error", (err) => reject(err));
+        if (process.stdin.isTTY) {
+            // If stdin is a TTY, there may be no data coming; resolve empty.
+            // Commands that rely on stdin should validate non-empty input.
+            resolve("");
+        }
+    });
+}
+//# sourceMappingURL=readStdin.js.map

package/dist/io/readStdin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"readStdin.js","sourceRoot":"","sources":["../../src/io/readStdin.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,KAAK,UAAU,aAAa;IACjC,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QACrC,IAAI,IAAI,GAAG,EAAE,CAAC;QAEd,OAAO,CAAC,KAAK,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC;QAClC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,KAAK,EAAE,EAAE;YACjC,IAAI,IAAI,KAAK,CAAC;QAChB,CAAC,CAAC,CAAC;QACH,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC;QAC7C,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;QAEhD,IAAI,OAAO,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;YACxB,iEAAiE;YACjE,+DAA+D;YAC/D,OAAO,CAAC,EAAE,CAAC,CAAC;QACd,CAAC;IACH,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/io/readStdinText.d.ts

@@ -0,0 +1,2 @@
+export declare function readStdinText(): Promise<string>;
+//# sourceMappingURL=readStdinText.d.ts.map

package/dist/io/readStdinText.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"readStdinText.d.ts","sourceRoot":"","sources":["../../src/io/readStdinText.ts"],"names":[],"mappings":"AAAA,wBAAsB,aAAa,IAAI,OAAO,CAAC,MAAM,CAAC,CAerD"}

package/dist/io/readStdinText.js

@@ -0,0 +1,15 @@
+export async function readStdinText() {
+    return new Promise((resolve, reject) => {
+        let data = "";
+        process.stdin.setEncoding("utf8");
+        process.stdin.on("data", (chunk) => {
+            data += chunk;
+        });
+        process.stdin.on("end", () => resolve(data));
+        process.stdin.on("error", (err) => reject(err));
+        if (process.stdin.isTTY) {
+            resolve("");
+        }
+    });
+}
+//# sourceMappingURL=readStdinText.js.map

package/dist/io/readStdinText.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"readStdinText.js","sourceRoot":"","sources":["../../src/io/readStdinText.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,KAAK,UAAU,aAAa;IACjC,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QACrC,IAAI,IAAI,GAAG,EAAE,CAAC;QAEd,OAAO,CAAC,KAAK,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC;QAClC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,KAAK,EAAE,EAAE;YACjC,IAAI,IAAI,KAAK,CAAC;QAChB,CAAC,CAAC,CAAC;QACH,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC;QAC7C,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;QAEhD,IAAI,OAAO,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;YACxB,OAAO,CAAC,EAAE,CAAC,CAAC;QACd,CAAC;IACH,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/io/writeFileOrStdout.d.ts

@@ -0,0 +1,2 @@
+export declare function writeText(outputPath: string | undefined, text: string): Promise<void>;
+//# sourceMappingURL=writeFileOrStdout.d.ts.map

package/dist/io/writeFileOrStdout.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"writeFileOrStdout.d.ts","sourceRoot":"","sources":["../../src/io/writeFileOrStdout.ts"],"names":[],"mappings":"AAGA,wBAAsB,SAAS,CAAC,UAAU,EAAE,MAAM,GAAG,SAAS,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAQ3F"}

package/dist/io/writeFileOrStdout.js

@@ -0,0 +1,11 @@
+import { writeFile } from "node:fs/promises";
+import { resolve } from "node:path";
+export async function writeText(outputPath, text) {
+    if (!outputPath || outputPath === "-") {
+        process.stdout.write(text);
+        return;
+    }
+    const abs = resolve(process.cwd(), outputPath);
+    await writeFile(abs, text, "utf8");
+}
+//# sourceMappingURL=writeFileOrStdout.js.map

package/dist/io/writeFileOrStdout.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"writeFileOrStdout.js","sourceRoot":"","sources":["../../src/io/writeFileOrStdout.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAC7C,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,UAA8B,EAAE,IAAY;IAC1E,IAAI,CAAC,UAAU,IAAI,UAAU,KAAK,GAAG,EAAE,CAAC;QACtC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAC3B,OAAO;IACT,CAAC;IAED,MAAM,GAAG,GAAG,OAAO,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,UAAU,CAAC,CAAC;IAC/C,MAAM,SAAS,CAAC,GAAG,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC;AACrC,CAAC"}

package/dist/io/writeOutput.d.ts

@@ -0,0 +1,4 @@
+export type OutputFormat = "json" | "yaml";
+export declare function stringifyOutput(value: unknown, format: OutputFormat): string;
+export declare function writeOutput(value: unknown, format: OutputFormat): void;
+//# sourceMappingURL=writeOutput.d.ts.map

package/dist/io/writeOutput.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"writeOutput.d.ts","sourceRoot":"","sources":["../../src/io/writeOutput.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,YAAY,GAAG,MAAM,GAAG,MAAM,CAAC;AAE3C,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,YAAY,GAAG,MAAM,CAM5E;AAED,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,YAAY,GAAG,IAAI,CAEtE"}

package/dist/io/writeOutput.js

@@ -0,0 +1,11 @@
+import YAML from "yaml";
+export function stringifyOutput(value, format) {
+    if (format === "yaml") {
+        return YAML.stringify(value);
+    }
+    return `${JSON.stringify(value, null, 2)}\n`;
+}
+export function writeOutput(value, format) {
+    process.stdout.write(stringifyOutput(value, format));
+}
+//# sourceMappingURL=writeOutput.js.map

package/dist/io/writeOutput.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"writeOutput.js","sourceRoot":"","sources":["../../src/io/writeOutput.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,MAAM,CAAC;AAIxB,MAAM,UAAU,eAAe,CAAC,KAAc,EAAE,MAAoB;IAClE,IAAI,MAAM,KAAK,MAAM,EAAE,CAAC;QACtB,OAAO,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;IAC/B,CAAC;IAED,OAAO,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC;AAC/C,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,KAAc,EAAE,MAAoB;IAC9D,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,eAAe,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC,CAAC;AACvD,CAAC"}

package/package.json

@@ -0,0 +1,39 @@
+{
+  "name": "@unispechq/unispec-platform",
+  "version": "0.1.0",
+  "description": "CLI and local orchestrator for UniSpec (validate/normalize/diff/convert/dev).",
+  "license": "MIT",
+  "type": "module",
+  "bin": {
+    "unispec": "dist/cli.js"
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "dev": "tsx src/cli.ts",
+    "start": "node dist/cli.js",
+    "test": "npm run build && node --test tests/*.test.mjs",
+    "release:patch": "node scripts/release.js patch",
+    "release:minor": "node scripts/release.js minor",
+    "release:major": "node scripts/release.js major"
+  },
+  "dependencies": {
+    "@unispechq/unispec-core": "^0.2.2",
+    "commander": "^12.1.0",
+    "yaml": "^2.6.1"
+  },
+  "devDependencies": {
+    "@types/node": "^24.10.1",
+    "tsx": "^4.19.2",
+    "typescript": "^5.0.0"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}