@liche/product

Product schema authoring, generated surfaces, and conformance for Liche CLIs.

This package is published as Bun-only TypeScript source. Use Bun >= 1.3.0; the current package format does not ship dist or declaration artifacts.

Use @liche/product when one product catalog should drive CLI source, OpenAPI, command manifests, MCP tools, agent docs, user docs, config schema, catalog/discovery artifacts, compile entrypoints, auth/session commands, local diagnostics, telemetry status, and conformance checks.

Generated CLIs still run on @liche/core, so generated commands inherit the shared parser, structured result envelope, and transport behavior used by handwritten commands.

import { Auth, Command, Field, Http, Schema, ValueSource, defineProduct } from "@liche/product";

export default defineProduct({
  id: "workers",
  name: "Workers",
  version: "1.0.0",
  auth: Auth.none(),
  remote: { baseUrl: ValueSource.env("WORKERS_API_BASE_URL") },
  commands: {
    deploy: Command.http({
      path: ["deploy"],
      summary: "Deploy a Worker",
      input: Schema.object({ name: Field.string("Worker name") }),
      output: Schema.object({ id: Field.string("Deployment ID") }),
      http: Http.post("/deployments", { bind: Http.bind({ body: true }) }),
    }),
  },
});

Generate

liche-product generate ./product.ts --out ./generated
liche-product generate ./product.ts --out ./generated --check --json

Generated artifacts include:

• liche.generated.ts
• liche.generated.openapi.json
• liche.generated.commands.json
• liche.generated.mcp.json
• liche.generated.agent.md
• liche.generated.docs.md
• liche.generated.config.schema.json
• liche.generated.catalog.json
• liche.generated.discovery.json
• liche.compile-entry.ts
• liche.generated.manifest.json

Opt-in ops.release metadata is embedded into generated docs, discovery JSON, doctor --json, and a local release --json command. It is static by design: install commands, channel, latest known version, packages, and yanked versions are available to users and agents without a hosted update service.

Conformance

Run conformance against an owned fixture server or local server:

liche-product conform ./product.ts --base-url http://localhost:8787 --report .liche/conformance.json --json

Conformance reports redact auth material and keep destructive capabilities opt-in.

Generated CLIs use @liche/core for runtime behavior, config, auth/session state, config-owned diagnostics, opt-in telemetry sinks, validation envelopes, and HTTP transport. Catalog-generated surfaces remain canonical for Product command manifests, MCP tools, agent docs, and reference docs.