@unispechq/unispec-platform 0.2.0 → 0.2.2

package/README.md

@@ -1,8 +1,8 @@
 # UniSpec Platform
 
-**CLI and local orchestrator for the UniSpec ecosystem**
+**UniSpec CLI utilities and portal launcher**
 
-This repository contains the official UniSpec CLI and the foundation for a local orchestrator.
+This repository contains the UniSpec CLI utilities and a launcher for `@unispechq/unispec-portal`.
 It builds on top of:
 
 - `unispec-spec` — the UniSpec format definition (schemas, examples, reference docs)
@@ -23,8 +23,7 @@ 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)
+- Provide a stable launcher for `unispec portal <dev|start>`
 
 ---
 
@@ -34,9 +33,9 @@ Current focus:
 unispec-platform/
 ├─ src/
 │  ├─ cli.ts              # CLI entrypoint
-│  ├─ commands/           # Command registration (validate/normalize/diff/convert/dev)
+│  ├─ commands/           # Command registration (validate/normalize/diff/convert/portal)
 │  ├─ io/                 # File IO + output helpers
-│  └─ config/             # Config loading (future dev/orchestrator mode)
+│  └─ config/             # Config loading
 ├─ package.json
 ├─ tsconfig.json
 └─ README.md
@@ -89,218 +88,35 @@ Options:
 - `--format <format>` — `json|yaml` (for JSON-like targets)
 - `--output <file>` — write output to file (use `-` for stdout)
 
-### `unispec dev`
-Local orchestrator mode.
+### `unispec portal <dev|start>`
+Launch UniSpec Portal (Next.js orchestrator).
 
-Serves:
+In the current architecture, `unispec-platform` provides CLI utilities (validate/normalize/diff/convert) and a launcher for `@unispechq/unispec-portal`.
 
-- `GET /` — embedded UI (reads `/unispec.json` in the browser)
-- `GET /unispec.json` — aggregated snapshot
-- `GET /health` — healthcheck
-- `GET /workspace.json` — workspace info (enabled when config path is known)
-- `GET /workspace/state` — workspace state (stored in `.unispec/workspace.json`)
-- `PUT /workspace/state` — replace workspace state
-- `POST /tests/run` — run workspace tests (suite/flow)
-
-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
-- `--ui` / `--no-ui` — enable/disable embedded UI at `/` (default: enabled)
-- `--ui-dev <url>` — proxy UI requests to an external dev server (e.g. Next.js) for HMR
-- `--portal` — spawn portal server from an installed dependency and proxy UI to it
-- `--portal-port <port>` — port for portal server (default: `3000`)
-- `--portal-package <name>` — portal package name (default: `@unispechq/unispec-portal`)
-
-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
-- `GET /workspace.json` -> workspace info (paths + API URLs)
-- `GET /workspace/state` -> workspace state
-- `PUT /workspace/state` -> save workspace state
-- `POST /tests/run` -> run tests (suite flow)
-
-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
-
-Start the server:
-
-```bash
-npm run dev -- dev --verbose
-```
-
-Run using the bundled examples:
+Examples:
 
 ```bash
-npm run dev -- dev -- --config example/unispec.config.json --verbose
+unispec portal dev --config ./unispec.config.json
+unispec portal start --config ./unispec.config.json
 ```
 
-Then open:
-
-- `http://127.0.0.1:4141/health`
-- `http://127.0.0.1:4141/unispec.json`
-- `http://127.0.0.1:4141/`
-
-### `unispec start`
-Production-like server mode.
-
-`unispec start` runs the same HTTP surface as `unispec dev`, but is intended for long-running use.
-
 Options:
 
 - `--config <path>` — path to config file
-- `--host <host>` — bind host (default: `127.0.0.1`)
-- `--port <port>` — bind port (default: `4141`)
-- `--ui` / `--no-ui` — enable/disable embedded UI
-- `--ui-url <url>` — proxy UI requests to an external UI server
-- `--portal` — spawn portal server (SSR) from an installed dependency and proxy UI to it
-- `--portal-port <port>` — port for portal server (default: `3000`)
+- `--host <host>` — bind host (forwarded to portal)
+- `--port <port>` — bind port (forwarded to portal)
+- `--storage <type>` — `json|sqlite` (forwarded to portal)
+- `--data-dir <path>` — data directory (forwarded to portal)
+- `--open` — open browser (forwarded to portal)
+- `--verbose` — verbose output (forwarded to portal)
+- `--json-errors` — output errors as JSON (forwarded to portal)
 - `--portal-package <name>` — portal package name (default: `@unispechq/unispec-portal`)
 
-### Portal package contract
-
-When using `--portal`, the portal package is expected to provide a single runnable `bin` entry which supports:
-
-- `--port <port>`
-- `--mode dev|start`
-
-Example:
-
-```bash
-unispec-portal --mode dev --port 3000
-unispec-portal --mode start --port 3000
-```
-
 ---
 
-## Workspace layer
-
-Workspace data is stored in `.unispec/workspace.json` next to your config file. This file is not part of UniSpec.
-
-### Workspace endpoints
-
-- `GET /workspace.json` — info for clients (mode, configPath, storage paths, and API URLs)
-- `GET /workspace/state` — workspace state JSON
-- `PUT /workspace/state` — replace workspace state JSON (atomic write)
-
-### Endpoint IDs
-
-Workspace entities reference endpoints using:
-
-```
-{serviceName}:{METHOD}:{path}
-```
-
-Example:
+## Notes
 
-```
-users:GET:/users
-```
-
----
-
-## Workspace tests
-
-Tests are stored in workspace state as YAML or JSON strings and can be run through:
-
-- `POST /tests/run` with `{ "suiteId": "..." }` or `{ "testIds": ["..."] }`
-
-### YAML/JSON test format (single request)
-
-```yaml
-request:
-  method: GET
-  url: "http://127.0.0.1:4141/health"
-expect:
-  status: 200
-  bodyContains: "OK"
-```
-
-### Multi-step tests (flow)
-
-```yaml
-steps:
-  - name: health
-    request:
-      method: GET
-      url: "http://127.0.0.1:4141/health"
-    expect:
-      status: 200
-      bodyContains: "OK"
-    extract:
-      st:
-        from: status
-
-  - name: unispec
-    request:
-      method: GET
-      url: "http://127.0.0.1:4141/unispec.json"
-    expect:
-      status: 200
-      jsonContains:
-        version: 1
-```
-
-### Variables and interpolation
-
-You can extract variables and use them with `{{var}}` in URL/headers/body:
-
-```yaml
-steps:
-  - request:
-      method: GET
-      url: "https://example.com/api/session"
-    extract:
-      token:
-        from: json
-        path: "$.token"
-  - request:
-      method: GET
-      url: "https://example.com/api/me"
-      headers:
-        authorization: "Bearer {{token}}"
-    expect:
-      status: 200
-```
+All orchestration responsibilities (HTTP API, watch mode, workspace storage, and test runner) live in the Portal package.
 
 ---
 

package/dist/cli.js

@@ -1,6 +1,7 @@
 #!/usr/bin/env node
 import { Command } from "commander";
-import { registerConvertCommand, registerDevCommand, registerDiffCommand, registerNormalizeCommand, registerStartCommand, registerValidateCommand, } from "./commands/index.js";
+import { createRequire } from "node:module";
+import { registerConvertCommand, registerDiffCommand, registerNormalizeCommand, registerPortalCommand, 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;
@@ -30,10 +31,12 @@ function normalizeGlobalOptionsArgv(argv) {
     return [...head, ...extracted, ...remaining];
 }
 const program = new Command();
+const require = createRequire(import.meta.url);
+const pkg = require("../package.json");
 program
     .name("unispec")
-    .description("UniSpec CLI and local orchestrator")
-    .version("0.1.0")
+    .description("UniSpec CLI and portal launcher")
+    .version(String(pkg.version ?? "0.0.0"))
     .option("-q, --quiet", "Suppress non-essential output")
     .option("--verbose", "Enable verbose diagnostic output (stderr)")
     .option("--json-errors", "Output errors as JSON to stderr");
@@ -41,8 +44,7 @@ registerValidateCommand(program);
 registerNormalizeCommand(program);
 registerDiffCommand(program);
 registerConvertCommand(program);
-registerDevCommand(program);
-registerStartCommand(program);
+registerPortalCommand(program);
 program.parseAsync(normalizeGlobalOptionsArgv(process.argv)).catch((err) => {
     const opts = program.opts();
     const verbose = opts.verbose ?? false;

package/dist/cli.js.map

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

package/dist/commands/index.d.ts

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

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

@@ -1 +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;AACzB,cAAc,YAAY,CAAC"}
+{"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,aAAa,CAAC"}

package/dist/commands/index.js

@@ -2,6 +2,5 @@ export * from "./validate.js";
 export * from "./normalize.js";
 export * from "./diff.js";
 export * from "./convert.js";
-export * from "./dev.js";
-export * from "./start.js";
+export * from "./portal.js";
 //# sourceMappingURL=index.js.map

package/dist/commands/index.js.map

@@ -1 +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;AACzB,cAAc,YAAY,CAAC"}
+{"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,aAAa,CAAC"}

package/dist/commands/portal.d.ts

@@ -0,0 +1,4 @@
+import type { Command } from "commander";
+export declare function buildPortalNodeArgs(binPath: string, mode: "dev" | "start", options: Record<string, unknown>): string[];
+export declare function registerPortalCommand(program: Command): void;
+//# sourceMappingURL=portal.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"portal.d.ts","sourceRoot":"","sources":["../../src/commands/portal.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAoCzC,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,GAAG,OAAO,EAAE,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,EAAE,CAoBtH;AAED,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAoD5D"}

package/dist/commands/portal.js

@@ -0,0 +1,94 @@
+import { spawn } from "node:child_process";
+import { createRequire } from "node:module";
+import { dirname, join } from "node:path";
+import { readFile } from "node:fs/promises";
+async function resolvePortalBin(portalPackage) {
+    const require = createRequire(import.meta.url);
+    const pkgJsonPath = require.resolve(`${portalPackage}/package.json`);
+    const pkgDir = dirname(pkgJsonPath);
+    const pkgRaw = await readFile(pkgJsonPath, "utf8");
+    const pkg = JSON.parse(pkgRaw);
+    if (!pkg.bin) {
+        return null;
+    }
+    if (typeof pkg.bin === "string") {
+        return { binPath: join(pkgDir, pkg.bin), binName: portalPackage };
+    }
+    const entries = Object.entries(pkg.bin);
+    if (entries.length === 0) {
+        return null;
+    }
+    const preferred = entries.find(([name]) => name === "unispec-portal") ?? entries[0];
+    return { binPath: join(pkgDir, preferred[1]), binName: preferred[0] };
+}
+function pickArg(options, camel, kebab) {
+    const v = options[camel] ?? options[kebab];
+    if (v === undefined || v === null)
+        return undefined;
+    return String(v);
+}
+export function buildPortalNodeArgs(binPath, mode, options) {
+    const args = [binPath, mode, "--config", String(options.config)];
+    const host = pickArg(options, "host", "host");
+    if (host)
+        args.push("--host", host);
+    const port = pickArg(options, "port", "port");
+    if (port)
+        args.push("--port", port);
+    const storage = pickArg(options, "storage", "storage");
+    if (storage)
+        args.push("--storage", storage);
+    const dataDir = pickArg(options, "dataDir", "data-dir");
+    if (dataDir)
+        args.push("--data-dir", dataDir);
+    if (options.open)
+        args.push("--open");
+    if (options.verbose)
+        args.push("--verbose");
+    if (options["jsonErrors"] ?? options["json-errors"])
+        args.push("--json-errors");
+    return args;
+}
+export function registerPortalCommand(program) {
+    const cmd = program
+        .command("portal")
+        .description("Launch UniSpec Portal (Next.js orchestrator)")
+        .option("--portal-package <name>", "Portal package name", "@unispechq/unispec-portal");
+    const addSharedOptions = (c) => c
+        .requiredOption("--config <path>", "Path to unispec config file")
+        .option("--host <host>", "Bind host")
+        .option("--port <port>", "Bind port")
+        .option("--storage <type>", "Storage backend (json|sqlite)")
+        .option("--data-dir <path>", "Data directory (default: <configDir>/.unispec)")
+        .option("--open", "Open browser")
+        .option("--verbose", "Verbose portal output")
+        .option("--json-errors", "Output portal errors as JSON");
+    for (const mode of ["dev", "start"]) {
+        addSharedOptions(cmd
+            .command(mode)
+            .description(`Run portal in ${mode} mode`)
+            .action(async function (options) {
+            const parentOpts = this.parent?.opts?.();
+            const portalPackage = String(parentOpts?.portalPackage ?? "@unispechq/unispec-portal");
+            let resolved = null;
+            try {
+                resolved = await resolvePortalBin(portalPackage);
+            }
+            catch (err) {
+                const message = err instanceof Error ? err.message : String(err);
+                throw new Error(`Failed to resolve portal package '${portalPackage}': ${message}`);
+            }
+            if (!resolved) {
+                throw new Error(`Portal package '${portalPackage}' does not expose a runnable bin. Expected a package.json "bin" entry.`);
+            }
+            const args = buildPortalNodeArgs(resolved.binPath, mode, options);
+            const child = spawn(process.execPath, args, {
+                stdio: "inherit",
+                env: { ...process.env },
+            });
+            const code = await new Promise((resolve) => child.once("exit", (c) => resolve(c ?? 0)));
+            process.exitCode = code;
+        }));
+    }
+}
+//# sourceMappingURL=portal.js.map

package/dist/commands/portal.js.map

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

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@unispechq/unispec-platform",
-  "version": "0.2.0",
-  "description": "CLI and local orchestrator for UniSpec (validate/normalize/diff/convert/dev).",
+  "version": "0.2.2",
+  "description": "UniSpec CLI utilities (validate/normalize/diff/convert) and portal launcher.",
   "license": "MIT",
   "type": "module",
   "bin": {

package/dist/commands/dev.d.ts

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

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

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