@zenalexa/unicli 0.211.2 → 0.213.0-beta.2

package/dist/core/envelope.d.ts

@@ -0,0 +1,87 @@
+/**
+ * Envelope — the uniform result shape returned by every
+ * `TransportAdapter.action()` call.
+ *
+ * Shape:
+ *   { ok: true, data, elapsedMs? }
+ *   { ok: false, error: { transport, step, action, reason, suggestion,
+ *                         adapter_path?, diff_candidate?, minimum_capability?,
+ *                         retryable, exit_code }, elapsedMs? }
+ *
+ * Sysexits codes (sysexits.h):
+ *   0  SUCCESS
+ *   1  GENERIC_ERROR
+ *   2  USAGE_ERROR
+ *   66 EMPTY_RESULT
+ *   69 SERVICE_UNAVAILABLE  (EX_UNAVAILABLE)
+ *   75 TEMP_FAILURE          (EX_TEMPFAIL)
+ *   77 AUTH_REQUIRED         (EX_NOPERM)
+ *   78 CONFIG_ERROR          (EX_CONFIG)
+ */
+import type { TransportKind } from "../transport/types.js";
+/** Structured error carried inside a failed envelope. */
+export interface EnvelopeError {
+    transport: TransportKind;
+    adapter_path?: string;
+    step: number;
+    action: string;
+    reason: string;
+    suggestion: string;
+    minimum_capability?: string;
+    diff_candidate?: string;
+    retryable: boolean;
+    exit_code: number;
+}
+/** Optional metadata fields the runner or orchestrator may attach. */
+export interface EnvelopeMeta {
+    elapsedMs?: number;
+}
+/** Success envelope — `data` is populated, `error` is absent. */
+export interface EnvelopeOk<T> extends EnvelopeMeta {
+    ok: true;
+    data: T;
+    error?: undefined;
+}
+/** Failure envelope — `error` is populated, `data` is absent. */
+export interface EnvelopeErr extends EnvelopeMeta {
+    ok: false;
+    data?: undefined;
+    error: EnvelopeError;
+}
+/** Discriminated union callers pattern-match on via `.ok`. */
+export type Envelope<T = unknown> = EnvelopeOk<T> | EnvelopeErr;
+/** Sysexits-aligned exit codes. Freeze for stability. */
+export declare const EnvelopeExit: Readonly<{
+    readonly SUCCESS: 0;
+    readonly GENERIC_ERROR: 1;
+    readonly USAGE_ERROR: 2;
+    readonly EMPTY_RESULT: 66;
+    readonly SERVICE_UNAVAILABLE: 69;
+    readonly TEMP_FAILURE: 75;
+    readonly AUTH_REQUIRED: 77;
+    readonly CONFIG_ERROR: 78;
+}>;
+export type EnvelopeExitCode = (typeof EnvelopeExit)[keyof typeof EnvelopeExit];
+/**
+ * Map a short reason token to its sysexits code. Unknown tokens degrade to
+ * GENERIC_ERROR so callers can always supply a code without branching.
+ */
+export declare function exitCodeFor(reason: string): EnvelopeExitCode;
+/** Build a success envelope. */
+export declare function ok<T>(data: T, meta?: EnvelopeMeta): EnvelopeOk<T>;
+/** Input shape for {@link err}. All but five fields are optional. */
+export interface ErrInput {
+    transport: TransportKind;
+    step: number;
+    action: string;
+    reason: string;
+    suggestion: string;
+    adapter_path?: string;
+    diff_candidate?: string;
+    minimum_capability?: string;
+    retryable?: boolean;
+    exit_code?: number;
+}
+/** Build a failure envelope. Missing fields get safe defaults. */
+export declare function err(input: ErrInput, meta?: EnvelopeMeta): EnvelopeErr;
+//# sourceMappingURL=envelope.d.ts.map

package/dist/core/envelope.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"envelope.d.ts","sourceRoot":"","sources":["../../src/core/envelope.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAE3D,yDAAyD;AACzD,MAAM,WAAW,aAAa;IAC5B,SAAS,EAAE,aAAa,CAAC;IACzB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,SAAS,EAAE,OAAO,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,sEAAsE;AACtE,MAAM,WAAW,YAAY;IAC3B,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,iEAAiE;AACjE,MAAM,WAAW,UAAU,CAAC,CAAC,CAAE,SAAQ,YAAY;IACjD,EAAE,EAAE,IAAI,CAAC;IACT,IAAI,EAAE,CAAC,CAAC;IACR,KAAK,CAAC,EAAE,SAAS,CAAC;CACnB;AAED,iEAAiE;AACjE,MAAM,WAAW,WAAY,SAAQ,YAAY;IAC/C,EAAE,EAAE,KAAK,CAAC;IACV,IAAI,CAAC,EAAE,SAAS,CAAC;IACjB,KAAK,EAAE,aAAa,CAAC;CACtB;AAED,8DAA8D;AAC9D,MAAM,MAAM,QAAQ,CAAC,CAAC,GAAG,OAAO,IAAI,UAAU,CAAC,CAAC,CAAC,GAAG,WAAW,CAAC;AAEhE,yDAAyD;AACzD,eAAO,MAAM,YAAY;;;;;;;;;EASd,CAAC;AAEZ,MAAM,MAAM,gBAAgB,GAAG,CAAC,OAAO,YAAY,CAAC,CAAC,MAAM,OAAO,YAAY,CAAC,CAAC;AAEhF;;;GAGG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,gBAAgB,CAuB5D;AAED,gCAAgC;AAChC,wBAAgB,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,IAAI,GAAE,YAAiB,GAAG,UAAU,CAAC,CAAC,CAAC,CAMrE;AAED,qEAAqE;AACrE,MAAM,WAAW,QAAQ;IACvB,SAAS,EAAE,aAAa,CAAC;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,kEAAkE;AAClE,wBAAgB,GAAG,CAAC,KAAK,EAAE,QAAQ,EAAE,IAAI,GAAE,YAAiB,GAAG,WAAW,CAwBzE"}

package/dist/core/envelope.js

@@ -0,0 +1,94 @@
+/**
+ * Envelope — the uniform result shape returned by every
+ * `TransportAdapter.action()` call.
+ *
+ * Shape:
+ *   { ok: true, data, elapsedMs? }
+ *   { ok: false, error: { transport, step, action, reason, suggestion,
+ *                         adapter_path?, diff_candidate?, minimum_capability?,
+ *                         retryable, exit_code }, elapsedMs? }
+ *
+ * Sysexits codes (sysexits.h):
+ *   0  SUCCESS
+ *   1  GENERIC_ERROR
+ *   2  USAGE_ERROR
+ *   66 EMPTY_RESULT
+ *   69 SERVICE_UNAVAILABLE  (EX_UNAVAILABLE)
+ *   75 TEMP_FAILURE          (EX_TEMPFAIL)
+ *   77 AUTH_REQUIRED         (EX_NOPERM)
+ *   78 CONFIG_ERROR          (EX_CONFIG)
+ */
+/** Sysexits-aligned exit codes. Freeze for stability. */
+export const EnvelopeExit = Object.freeze({
+    SUCCESS: 0,
+    GENERIC_ERROR: 1,
+    USAGE_ERROR: 2,
+    EMPTY_RESULT: 66,
+    SERVICE_UNAVAILABLE: 69,
+    TEMP_FAILURE: 75,
+    AUTH_REQUIRED: 77,
+    CONFIG_ERROR: 78,
+});
+/**
+ * Map a short reason token to its sysexits code. Unknown tokens degrade to
+ * GENERIC_ERROR so callers can always supply a code without branching.
+ */
+export function exitCodeFor(reason) {
+    switch (reason) {
+        case "success":
+            return EnvelopeExit.SUCCESS;
+        case "usage_error":
+            return EnvelopeExit.USAGE_ERROR;
+        case "empty_result":
+            return EnvelopeExit.EMPTY_RESULT;
+        case "service_unavailable":
+        case "unavailable":
+            return EnvelopeExit.SERVICE_UNAVAILABLE;
+        case "temp_failure":
+        case "timeout":
+            return EnvelopeExit.TEMP_FAILURE;
+        case "auth_required":
+        case "auth":
+            return EnvelopeExit.AUTH_REQUIRED;
+        case "config_error":
+        case "config":
+            return EnvelopeExit.CONFIG_ERROR;
+        default:
+            return EnvelopeExit.GENERIC_ERROR;
+    }
+}
+/** Build a success envelope. */
+export function ok(data, meta = {}) {
+    return {
+        ok: true,
+        data,
+        ...(meta.elapsedMs !== undefined ? { elapsedMs: meta.elapsedMs } : {}),
+    };
+}
+/** Build a failure envelope. Missing fields get safe defaults. */
+export function err(input, meta = {}) {
+    const error = {
+        transport: input.transport,
+        step: input.step,
+        action: input.action,
+        reason: input.reason,
+        suggestion: input.suggestion,
+        retryable: input.retryable ?? false,
+        exit_code: input.exit_code ?? EnvelopeExit.GENERIC_ERROR,
+        ...(input.adapter_path !== undefined
+            ? { adapter_path: input.adapter_path }
+            : {}),
+        ...(input.diff_candidate !== undefined
+            ? { diff_candidate: input.diff_candidate }
+            : {}),
+        ...(input.minimum_capability !== undefined
+            ? { minimum_capability: input.minimum_capability }
+            : {}),
+    };
+    return {
+        ok: false,
+        error,
+        ...(meta.elapsedMs !== undefined ? { elapsedMs: meta.elapsedMs } : {}),
+    };
+}
+//# sourceMappingURL=envelope.js.map

package/dist/core/envelope.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"envelope.js","sourceRoot":"","sources":["../../src/core/envelope.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAwCH,yDAAyD;AACzD,MAAM,CAAC,MAAM,YAAY,GAAG,MAAM,CAAC,MAAM,CAAC;IACxC,OAAO,EAAE,CAAC;IACV,aAAa,EAAE,CAAC;IAChB,WAAW,EAAE,CAAC;IACd,YAAY,EAAE,EAAE;IAChB,mBAAmB,EAAE,EAAE;IACvB,YAAY,EAAE,EAAE;IAChB,aAAa,EAAE,EAAE;IACjB,YAAY,EAAE,EAAE;CACR,CAAC,CAAC;AAIZ;;;GAGG;AACH,MAAM,UAAU,WAAW,CAAC,MAAc;IACxC,QAAQ,MAAM,EAAE,CAAC;QACf,KAAK,SAAS;YACZ,OAAO,YAAY,CAAC,OAAO,CAAC;QAC9B,KAAK,aAAa;YAChB,OAAO,YAAY,CAAC,WAAW,CAAC;QAClC,KAAK,cAAc;YACjB,OAAO,YAAY,CAAC,YAAY,CAAC;QACnC,KAAK,qBAAqB,CAAC;QAC3B,KAAK,aAAa;YAChB,OAAO,YAAY,CAAC,mBAAmB,CAAC;QAC1C,KAAK,cAAc,CAAC;QACpB,KAAK,SAAS;YACZ,OAAO,YAAY,CAAC,YAAY,CAAC;QACnC,KAAK,eAAe,CAAC;QACrB,KAAK,MAAM;YACT,OAAO,YAAY,CAAC,aAAa,CAAC;QACpC,KAAK,cAAc,CAAC;QACpB,KAAK,QAAQ;YACX,OAAO,YAAY,CAAC,YAAY,CAAC;QACnC;YACE,OAAO,YAAY,CAAC,aAAa,CAAC;IACtC,CAAC;AACH,CAAC;AAED,gCAAgC;AAChC,MAAM,UAAU,EAAE,CAAI,IAAO,EAAE,OAAqB,EAAE;IACpD,OAAO;QACL,EAAE,EAAE,IAAI;QACR,IAAI;QACJ,GAAG,CAAC,IAAI,CAAC,SAAS,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,IAAI,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KACvE,CAAC;AACJ,CAAC;AAgBD,kEAAkE;AAClE,MAAM,UAAU,GAAG,CAAC,KAAe,EAAE,OAAqB,EAAE;IAC1D,MAAM,KAAK,GAAkB;QAC3B,SAAS,EAAE,KAAK,CAAC,SAAS;QAC1B,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,MAAM,EAAE,KAAK,CAAC,MAAM;QACpB,MAAM,EAAE,KAAK,CAAC,MAAM;QACpB,UAAU,EAAE,KAAK,CAAC,UAAU;QAC5B,SAAS,EAAE,KAAK,CAAC,SAAS,IAAI,KAAK;QACnC,SAAS,EAAE,KAAK,CAAC,SAAS,IAAI,YAAY,CAAC,aAAa;QACxD,GAAG,CAAC,KAAK,CAAC,YAAY,KAAK,SAAS;YAClC,CAAC,CAAC,EAAE,YAAY,EAAE,KAAK,CAAC,YAAY,EAAE;YACtC,CAAC,CAAC,EAAE,CAAC;QACP,GAAG,CAAC,KAAK,CAAC,cAAc,KAAK,SAAS;YACpC,CAAC,CAAC,EAAE,cAAc,EAAE,KAAK,CAAC,cAAc,EAAE;YAC1C,CAAC,CAAC,EAAE,CAAC;QACP,GAAG,CAAC,KAAK,CAAC,kBAAkB,KAAK,SAAS;YACxC,CAAC,CAAC,EAAE,kBAAkB,EAAE,KAAK,CAAC,kBAAkB,EAAE;YAClD,CAAC,CAAC,EAAE,CAAC;KACR,CAAC;IACF,OAAO;QACL,EAAE,EAAE,KAAK;QACT,KAAK;QACL,GAAG,CAAC,IAAI,CAAC,SAAS,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,IAAI,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KACvE,CAAC;AACJ,CAAC"}

package/dist/core/index.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Barrel export for the v0.212 core layer.
+ *
+ * Prefer importing from `@zenalexa/unicli/core` (or the relative
+ * path `src/core/index.js`) so adapter authors get a single stable
+ * surface.
+ */
+export * from "./types.js";
+export * from "./envelope.js";
+export * from "./schema-v2.js";
+export { cli, getCommandMetadataV2, listCommandMetadataV2, registerAdapter, resolveCommand, getAdapter, getAllAdapters, listCommands, __resetCommandMetadataV2, type CliRegistration, type CliRegistrationV2, type CommandMetadataV2, } from "./registry.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/core/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,cAAc,YAAY,CAAC;AAC3B,cAAc,eAAe,CAAC;AAC9B,cAAc,gBAAgB,CAAC;AAC/B,OAAO,EACL,GAAG,EACH,oBAAoB,EACpB,qBAAqB,EACrB,eAAe,EACf,cAAc,EACd,UAAU,EACV,cAAc,EACd,YAAY,EACZ,wBAAwB,EACxB,KAAK,eAAe,EACpB,KAAK,iBAAiB,EACtB,KAAK,iBAAiB,GACvB,MAAM,eAAe,CAAC"}

package/dist/core/index.js

@@ -0,0 +1,12 @@
+/**
+ * Barrel export for the v0.212 core layer.
+ *
+ * Prefer importing from `@zenalexa/unicli/core` (or the relative
+ * path `src/core/index.js`) so adapter authors get a single stable
+ * surface.
+ */
+export * from "./types.js";
+export * from "./envelope.js";
+export * from "./schema-v2.js";
+export { cli, getCommandMetadataV2, listCommandMetadataV2, registerAdapter, resolveCommand, getAdapter, getAllAdapters, listCommands, __resetCommandMetadataV2, } from "./registry.js";
+//# sourceMappingURL=index.js.map

package/dist/core/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/core/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,cAAc,YAAY,CAAC;AAC3B,cAAc,eAAe,CAAC;AAC9B,cAAc,gBAAgB,CAAC;AAC/B,OAAO,EACL,GAAG,EACH,oBAAoB,EACpB,qBAAqB,EACrB,eAAe,EACf,cAAc,EACd,UAAU,EACV,cAAc,EACd,YAAY,EACZ,wBAAwB,GAIzB,MAAM,eAAe,CAAC"}

package/dist/core/registry.d.ts

@@ -0,0 +1,63 @@
+/**
+ * Registry v2 — enhanced `cli()` helper that accepts the v0.212
+ * schema-v2 fields (capabilities, minimum_capability, trust,
+ * confidentiality, quarantine) and delegates to the legacy registry
+ * for the underlying adapter map.
+ *
+ * Backward-compat: existing callers that import { cli } from
+ * "../../registry.js" keep working unchanged. New callers can import
+ * from "../../core/registry.js" to pass the expanded metadata.
+ */
+import { getAdapter, getAllAdapters, listCommands, registerAdapter, resolveCommand, type CliRegistration } from "../registry.js";
+import type { Capability } from "../transport/types.js";
+import type { AdapterTrust, AdapterConfidentiality } from "./schema-v2.js";
+/**
+ * v2 registration shape. All legacy fields are forwarded to
+ * {@link legacyCli}; the v2 fields are stored in a side table so the
+ * schema-v2 validators + the upcoming migration tool can introspect
+ * them without touching the `AdapterManifest` runtime shape.
+ */
+export interface CliRegistrationV2 extends CliRegistration {
+    /** Pipeline step names this command may invoke at runtime. */
+    capabilities?: Capability | readonly string[];
+    /** The single step the dispatcher MUST support to run this command. */
+    minimum_capability?: string;
+    /** Provenance trust level. Defaults to "public". */
+    trust?: AdapterTrust;
+    /** Data sensitivity label. Defaults to "public". */
+    confidentiality?: AdapterConfidentiality;
+    /** If true, CI quarantines the command until repaired. */
+    quarantine?: boolean;
+}
+/**
+ * Metadata captured at registration time for v2 callers. Keyed by
+ * `"<site>/<command>"` so the same adapter can host multiple commands
+ * with different trust levels (e.g. read-only vs write).
+ */
+export interface CommandMetadataV2 {
+    site: string;
+    name: string;
+    capabilities: readonly string[];
+    minimum_capability: string;
+    trust: AdapterTrust;
+    confidentiality: AdapterConfidentiality;
+    quarantine: boolean;
+}
+/**
+ * Register a TypeScript adapter with v2 metadata. Writes the legacy
+ * manifest via {@link legacyCli} so existing code paths (help, listing,
+ * dispatcher) continue to work unchanged.
+ */
+export declare function cli(config: CliRegistrationV2): void;
+/** Lookup v2 metadata for a command previously registered via {@link cli}. */
+export declare function getCommandMetadataV2(site: string, name: string): CommandMetadataV2 | undefined;
+/** Enumerate all v2 metadata records. */
+export declare function listCommandMetadataV2(): CommandMetadataV2[];
+/**
+ * Test-only: clear the v2 metadata map. Kept internal by convention —
+ * agents should not rely on it outside tests.
+ */
+export declare function __resetCommandMetadataV2(): void;
+export { getAdapter, getAllAdapters, listCommands, registerAdapter, resolveCommand, };
+export type { CliRegistration };
+//# sourceMappingURL=registry.d.ts.map

package/dist/core/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/core/registry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAEL,UAAU,EACV,cAAc,EACd,YAAY,EACZ,eAAe,EACf,cAAc,EACd,KAAK,eAAe,EACrB,MAAM,gBAAgB,CAAC;AACxB,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,KAAK,EAAE,YAAY,EAAE,sBAAsB,EAAE,MAAM,gBAAgB,CAAC;AAE3E;;;;;GAKG;AACH,MAAM,WAAW,iBAAkB,SAAQ,eAAe;IACxD,8DAA8D;IAC9D,YAAY,CAAC,EAAE,UAAU,GAAG,SAAS,MAAM,EAAE,CAAC;IAC9C,uEAAuE;IACvE,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,oDAAoD;IACpD,KAAK,CAAC,EAAE,YAAY,CAAC;IACrB,oDAAoD;IACpD,eAAe,CAAC,EAAE,sBAAsB,CAAC;IACzC,0DAA0D;IAC1D,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AAED;;;;GAIG;AACH,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,EAAE,SAAS,MAAM,EAAE,CAAC;IAChC,kBAAkB,EAAE,MAAM,CAAC;IAC3B,KAAK,EAAE,YAAY,CAAC;IACpB,eAAe,EAAE,sBAAsB,CAAC;IACxC,UAAU,EAAE,OAAO,CAAC;CACrB;AAmBD;;;;GAIG;AACH,wBAAgB,GAAG,CAAC,MAAM,EAAE,iBAAiB,GAAG,IAAI,CAqBnD;AAED,8EAA8E;AAC9E,wBAAgB,oBAAoB,CAClC,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,GACX,iBAAiB,GAAG,SAAS,CAE/B;AAED,yCAAyC;AACzC,wBAAgB,qBAAqB,IAAI,iBAAiB,EAAE,CAE3D;AAED;;;GAGG;AACH,wBAAgB,wBAAwB,IAAI,IAAI,CAE/C;AAID,OAAO,EACL,UAAU,EACV,cAAc,EACd,YAAY,EACZ,eAAe,EACf,cAAc,GACf,CAAC;AACF,YAAY,EAAE,eAAe,EAAE,CAAC"}

package/dist/core/registry.js

@@ -0,0 +1,62 @@
+/**
+ * Registry v2 — enhanced `cli()` helper that accepts the v0.212
+ * schema-v2 fields (capabilities, minimum_capability, trust,
+ * confidentiality, quarantine) and delegates to the legacy registry
+ * for the underlying adapter map.
+ *
+ * Backward-compat: existing callers that import { cli } from
+ * "../../registry.js" keep working unchanged. New callers can import
+ * from "../../core/registry.js" to pass the expanded metadata.
+ */
+import { cli as legacyCli, getAdapter, getAllAdapters, listCommands, registerAdapter, resolveCommand, } from "../registry.js";
+const metadata = new Map();
+function metadataKey(site, name) {
+    return `${site}/${name}`;
+}
+function normalizeCapabilities(input) {
+    if (!input)
+        return [];
+    if (Array.isArray(input))
+        return [...input];
+    if (typeof input === "object" && "steps" in input) {
+        return [...input.steps];
+    }
+    return [];
+}
+/**
+ * Register a TypeScript adapter with v2 metadata. Writes the legacy
+ * manifest via {@link legacyCli} so existing code paths (help, listing,
+ * dispatcher) continue to work unchanged.
+ */
+export function cli(config) {
+    const { capabilities, minimum_capability, trust, confidentiality, quarantine, ...legacy } = config;
+    legacyCli(legacy);
+    metadata.set(metadataKey(config.site, config.name), {
+        site: config.site,
+        name: config.name,
+        capabilities: normalizeCapabilities(capabilities),
+        minimum_capability: minimum_capability ?? "http.fetch",
+        trust: trust ?? "public",
+        confidentiality: confidentiality ?? "public",
+        quarantine: quarantine ?? false,
+    });
+}
+/** Lookup v2 metadata for a command previously registered via {@link cli}. */
+export function getCommandMetadataV2(site, name) {
+    return metadata.get(metadataKey(site, name));
+}
+/** Enumerate all v2 metadata records. */
+export function listCommandMetadataV2() {
+    return Array.from(metadata.values());
+}
+/**
+ * Test-only: clear the v2 metadata map. Kept internal by convention —
+ * agents should not rely on it outside tests.
+ */
+export function __resetCommandMetadataV2() {
+    metadata.clear();
+}
+// Re-export the legacy registry surface so downstream callers need only
+// one import.
+export { getAdapter, getAllAdapters, listCommands, registerAdapter, resolveCommand, };
+//# sourceMappingURL=registry.js.map

package/dist/core/registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../src/core/registry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EACL,GAAG,IAAI,SAAS,EAChB,UAAU,EACV,cAAc,EACd,YAAY,EACZ,eAAe,EACf,cAAc,GAEf,MAAM,gBAAgB,CAAC;AAsCxB,MAAM,QAAQ,GAAG,IAAI,GAAG,EAA6B,CAAC;AAEtD,SAAS,WAAW,CAAC,IAAY,EAAE,IAAY;IAC7C,OAAO,GAAG,IAAI,IAAI,IAAI,EAAE,CAAC;AAC3B,CAAC;AAED,SAAS,qBAAqB,CAC5B,KAAiD;IAEjD,IAAI,CAAC,KAAK;QAAE,OAAO,EAAE,CAAC;IACtB,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QAAE,OAAO,CAAC,GAAI,KAA2B,CAAC,CAAC;IACnE,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,OAAO,IAAI,KAAK,EAAE,CAAC;QAClD,OAAO,CAAC,GAAI,KAAoB,CAAC,KAAK,CAAC,CAAC;IAC1C,CAAC;IACD,OAAO,EAAE,CAAC;AACZ,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,GAAG,CAAC,MAAyB;IAC3C,MAAM,EACJ,YAAY,EACZ,kBAAkB,EAClB,KAAK,EACL,eAAe,EACf,UAAU,EACV,GAAG,MAAM,EACV,GAAG,MAAM,CAAC;IAEX,SAAS,CAAC,MAAM,CAAC,CAAC;IAElB,QAAQ,CAAC,GAAG,CAAC,WAAW,CAAC,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,IAAI,CAAC,EAAE;QAClD,IAAI,EAAE,MAAM,CAAC,IAAI;QACjB,IAAI,EAAE,MAAM,CAAC,IAAI;QACjB,YAAY,EAAE,qBAAqB,CAAC,YAAY,CAAC;QACjD,kBAAkB,EAAE,kBAAkB,IAAI,YAAY;QACtD,KAAK,EAAE,KAAK,IAAI,QAAQ;QACxB,eAAe,EAAE,eAAe,IAAI,QAAQ;QAC5C,UAAU,EAAE,UAAU,IAAI,KAAK;KAChC,CAAC,CAAC;AACL,CAAC;AAED,8EAA8E;AAC9E,MAAM,UAAU,oBAAoB,CAClC,IAAY,EACZ,IAAY;IAEZ,OAAO,QAAQ,CAAC,GAAG,CAAC,WAAW,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC;AAC/C,CAAC;AAED,yCAAyC;AACzC,MAAM,UAAU,qBAAqB;IACnC,OAAO,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC;AACvC,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,wBAAwB;IACtC,QAAQ,CAAC,KAAK,EAAE,CAAC;AACnB,CAAC;AAED,wEAAwE;AACxE,cAAc;AACd,OAAO,EACL,UAAU,EACV,cAAc,EACd,YAAY,EACZ,eAAe,EACf,cAAc,GACf,CAAC"}

package/dist/core/schema-v2.d.ts

@@ -0,0 +1,119 @@
+/**
+ * AdapterCommand schema v2 — runtime validation + v1 migration.
+ *
+ * Adds five required fields over v1:
+ *   capabilities         — pipeline step names this command may invoke
+ *   minimum_capability   — single step the dispatcher must support to run it
+ *   trust                — provenance trust level (public | user | system)
+ *   confidentiality      — data sensitivity label (public | internal | private)
+ *   quarantine           — CI health gate flag; if true, command is skipped
+ *                          until repaired
+ *
+ * Legacy v1 adapters (the 800+ YAML in `src/adapters/`) migrate via
+ * {@link migrateToV2} which fills defaults without touching already-set fields.
+ */
+import { z } from "zod";
+/** Trust level enum — mirrors adapter source provenance. */
+export declare const AdapterTrustSchema: z.ZodEnum<{
+    public: "public";
+    user: "user";
+    system: "system";
+}>;
+export type AdapterTrust = z.infer<typeof AdapterTrustSchema>;
+/**
+ * Schema version tag. Currently fixed at `"v2"`; when a future breaking
+ * migration lands (e.g. v3), we widen the union and keep the loader
+ * backward-compatible during the migration window.
+ */
+export declare const AdapterSchemaVersionSchema: z.ZodLiteral<"v2">;
+export type AdapterSchemaVersion = z.infer<typeof AdapterSchemaVersionSchema>;
+/** Confidentiality label enum — mirrors data sensitivity classification. */
+export declare const AdapterConfidentialitySchema: z.ZodEnum<{
+    public: "public";
+    internal: "internal";
+    private: "private";
+}>;
+export type AdapterConfidentiality = z.infer<typeof AdapterConfidentialitySchema>;
+/**
+ * The default capability legacy adapters inherit. `http.fetch` is chosen
+ * because the overwhelming majority of v1 YAML adapters are web-api
+ * pipelines — the safe, lowest-privilege baseline.
+ */
+export declare const AdapterV2DefaultMinimumCapability: "http.fetch";
+/**
+ * AdapterCommand v2 schema.
+ *
+ * Kept loose on the legacy fields (name, description, pipeline, ...) because
+ * the v1 shape has historical leniency. The v2 layer is strictly validated
+ * on the new fields — which is the point of the migration gate.
+ */
+export declare const AdapterCommandV2Schema: z.ZodObject<{
+    name: z.ZodString;
+    description: z.ZodOptional<z.ZodString>;
+    schema_version: z.ZodOptional<z.ZodLiteral<"v2">>;
+    capabilities: z.ZodArray<z.ZodString>;
+    minimum_capability: z.ZodString;
+    trust: z.ZodEnum<{
+        public: "public";
+        user: "user";
+        system: "system";
+    }>;
+    confidentiality: z.ZodEnum<{
+        public: "public";
+        internal: "internal";
+        private: "private";
+    }>;
+    quarantine: z.ZodBoolean;
+    pipeline: z.ZodOptional<z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
+    method: z.ZodOptional<z.ZodString>;
+    path: z.ZodOptional<z.ZodString>;
+    url: z.ZodOptional<z.ZodString>;
+    params: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    body: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    headers: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    navigate: z.ZodOptional<z.ZodString>;
+    wait: z.ZodOptional<z.ZodString>;
+    extract: z.ZodOptional<z.ZodString>;
+    execArgs: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    output: z.ZodOptional<z.ZodUnknown>;
+    columns: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    defaultFormat: z.ZodOptional<z.ZodEnum<{
+        table: "table";
+        json: "json";
+        yaml: "yaml";
+        csv: "csv";
+        md: "md";
+    }>>;
+    stream: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strip>;
+export type AdapterCommandV2 = z.infer<typeof AdapterCommandV2Schema>;
+/** Result of {@link validateAdapterV2}. */
+export type AdapterValidationResult = {
+    ok: true;
+    data: AdapterCommandV2;
+} | {
+    ok: false;
+    error: string;
+};
+/**
+ * Strict parse — throws on invalid input. Use inside trusted boundaries
+ * where we genuinely want a loud failure (e.g. CLI `unicli lint`).
+ */
+export declare function parseAdapterV2(input: unknown): AdapterCommandV2;
+/**
+ * Safe parse — returns a tagged union. Use inside adapter loaders where we
+ * want to continue with a degraded result instead of aborting the run.
+ */
+export declare function validateAdapterV2(input: unknown): AdapterValidationResult;
+/**
+ * Migrate a v1 AdapterCommand to v2. Fields already present are preserved;
+ * missing required v2 fields get safe defaults:
+ *
+ *   capabilities       → []
+ *   minimum_capability → "http.fetch"
+ *   trust              → "public"
+ *   confidentiality    → "public"
+ *   quarantine         → false
+ */
+export declare function migrateToV2(input: unknown): AdapterCommandV2;
+//# sourceMappingURL=schema-v2.d.ts.map

package/dist/core/schema-v2.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema-v2.d.ts","sourceRoot":"","sources":["../../src/core/schema-v2.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,4DAA4D;AAC5D,eAAO,MAAM,kBAAkB;;;;EAAuC,CAAC;AACvE,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAE9D;;;;GAIG;AACH,eAAO,MAAM,0BAA0B,oBAAkB,CAAC;AAC1D,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,0BAA0B,CAAC,CAAC;AAE9E,4EAA4E;AAC5E,eAAO,MAAM,4BAA4B;;;;EAIvC,CAAC;AACH,MAAM,MAAM,sBAAsB,GAAG,CAAC,CAAC,KAAK,CAC1C,OAAO,4BAA4B,CACpC,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,iCAAiC,EAAG,YAAqB,CAAC;AAEvE;;;;;;GAMG;AACH,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBA8BjC,CAAC;AAEH,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AAEtE,2CAA2C;AAC3C,MAAM,MAAM,uBAAuB,GAC/B;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,IAAI,EAAE,gBAAgB,CAAA;CAAE,GACpC;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC;AAEjC;;;GAGG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,GAAG,gBAAgB,CAE/D;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,OAAO,GAAG,uBAAuB,CAIzE;AAWD;;;;;;;;;GASG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG,gBAAgB,CAuB5D"}

package/dist/core/schema-v2.js

@@ -0,0 +1,130 @@
+/**
+ * AdapterCommand schema v2 — runtime validation + v1 migration.
+ *
+ * Adds five required fields over v1:
+ *   capabilities         — pipeline step names this command may invoke
+ *   minimum_capability   — single step the dispatcher must support to run it
+ *   trust                — provenance trust level (public | user | system)
+ *   confidentiality      — data sensitivity label (public | internal | private)
+ *   quarantine           — CI health gate flag; if true, command is skipped
+ *                          until repaired
+ *
+ * Legacy v1 adapters (the 800+ YAML in `src/adapters/`) migrate via
+ * {@link migrateToV2} which fills defaults without touching already-set fields.
+ */
+import { z } from "zod";
+/** Trust level enum — mirrors adapter source provenance. */
+export const AdapterTrustSchema = z.enum(["public", "user", "system"]);
+/**
+ * Schema version tag. Currently fixed at `"v2"`; when a future breaking
+ * migration lands (e.g. v3), we widen the union and keep the loader
+ * backward-compatible during the migration window.
+ */
+export const AdapterSchemaVersionSchema = z.literal("v2");
+/** Confidentiality label enum — mirrors data sensitivity classification. */
+export const AdapterConfidentialitySchema = z.enum([
+    "public",
+    "internal",
+    "private",
+]);
+/**
+ * The default capability legacy adapters inherit. `http.fetch` is chosen
+ * because the overwhelming majority of v1 YAML adapters are web-api
+ * pipelines — the safe, lowest-privilege baseline.
+ */
+export const AdapterV2DefaultMinimumCapability = "http.fetch";
+/**
+ * AdapterCommand v2 schema.
+ *
+ * Kept loose on the legacy fields (name, description, pipeline, ...) because
+ * the v1 shape has historical leniency. The v2 layer is strictly validated
+ * on the new fields — which is the point of the migration gate.
+ */
+export const AdapterCommandV2Schema = z.object({
+    name: z.string().min(1),
+    description: z.string().optional(),
+    // Optional on the parser so legacy v1 -> v2 migration paths can still
+    // flow through parseAdapterV2 without a value. The schema-v2 lint
+    // (scripts/lint-schema-v2.ts) enforces that every *committed* adapter
+    // YAML carries the tag explicitly.
+    schema_version: AdapterSchemaVersionSchema.optional(),
+    capabilities: z.array(z.string()),
+    minimum_capability: z.string().min(1),
+    trust: AdapterTrustSchema,
+    confidentiality: AdapterConfidentialitySchema,
+    quarantine: z.boolean(),
+    // Legacy shape fields carried through opaquely — zod.unknown keeps them
+    // without forcing a schema for every historical key.
+    pipeline: z.array(z.record(z.string(), z.unknown())).optional(),
+    method: z.string().optional(),
+    path: z.string().optional(),
+    url: z.string().optional(),
+    params: z.record(z.string(), z.unknown()).optional(),
+    body: z.record(z.string(), z.unknown()).optional(),
+    headers: z.record(z.string(), z.string()).optional(),
+    navigate: z.string().optional(),
+    wait: z.string().optional(),
+    extract: z.string().optional(),
+    execArgs: z.array(z.string()).optional(),
+    output: z.unknown().optional(),
+    columns: z.array(z.string()).optional(),
+    defaultFormat: z.enum(["table", "json", "yaml", "csv", "md"]).optional(),
+    stream: z.boolean().optional(),
+});
+/**
+ * Strict parse — throws on invalid input. Use inside trusted boundaries
+ * where we genuinely want a loud failure (e.g. CLI `unicli lint`).
+ */
+export function parseAdapterV2(input) {
+    return AdapterCommandV2Schema.parse(input);
+}
+/**
+ * Safe parse — returns a tagged union. Use inside adapter loaders where we
+ * want to continue with a degraded result instead of aborting the run.
+ */
+export function validateAdapterV2(input) {
+    const result = AdapterCommandV2Schema.safeParse(input);
+    if (result.success)
+        return { ok: true, data: result.data };
+    return { ok: false, error: formatZodError(result.error) };
+}
+function formatZodError(error) {
+    return error.issues
+        .map((issue) => {
+        const path = issue.path.length ? issue.path.join(".") : "(root)";
+        return `${path}: ${issue.message}`;
+    })
+        .join("; ");
+}
+/**
+ * Migrate a v1 AdapterCommand to v2. Fields already present are preserved;
+ * missing required v2 fields get safe defaults:
+ *
+ *   capabilities       → []
+ *   minimum_capability → "http.fetch"
+ *   trust              → "public"
+ *   confidentiality    → "public"
+ *   quarantine         → false
+ */
+export function migrateToV2(input) {
+    const src = (input ?? {});
+    const merged = {
+        ...src,
+        schema_version: "v2",
+        capabilities: Array.isArray(src.capabilities) ? src.capabilities : [],
+        minimum_capability: typeof src.minimum_capability === "string"
+            ? src.minimum_capability
+            : AdapterV2DefaultMinimumCapability,
+        trust: typeof src.trust === "string" &&
+            AdapterTrustSchema.safeParse(src.trust).success
+            ? src.trust
+            : "public",
+        confidentiality: typeof src.confidentiality === "string" &&
+            AdapterConfidentialitySchema.safeParse(src.confidentiality).success
+            ? src.confidentiality
+            : "public",
+        quarantine: typeof src.quarantine === "boolean" ? src.quarantine : false,
+    };
+    return parseAdapterV2(merged);
+}
+//# sourceMappingURL=schema-v2.js.map

package/dist/core/schema-v2.js.map

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

package/dist/core/types.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Unified type exports for the v0.212 core layer.
+ *
+ * This module is the single entry point agents and adapters import to reach
+ * the envelope, transport kinds, capability declaration, and the schema-v2
+ * shape for AdapterCommand.
+ *
+ * Backward-compat: re-exports legacy `AdapterType`, `Strategy`, `IPage`,
+ * `OutputFormat`, `ExitCode` from `src/types.ts` so existing imports keep
+ * working while the migration is in-flight.
+ */
+export type { AdapterArg, AdapterCommand, AdapterManifest, DownloadResult, IPage, NetworkRequest, OutputFormat, OutputSchema, PipelineErrorDetail, PipelineStep, ResolvedCommand, ScreenshotOptions, SnapshotOptions, } from "../types.js";
+export { AdapterType, ExitCode, Strategy } from "../types.js";
+export type { Capability, TransportKind } from "../transport/types.js";
+export type { Envelope, EnvelopeError, EnvelopeErr, EnvelopeOk, EnvelopeMeta, EnvelopeExitCode, ErrInput, } from "./envelope.js";
+export { EnvelopeExit, err, exitCodeFor, ok } from "./envelope.js";
+export type { AdapterCommandV2, AdapterTrust, AdapterConfidentiality, AdapterValidationResult, } from "./schema-v2.js";
+export { AdapterV2DefaultMinimumCapability, AdapterCommandV2Schema, migrateToV2, parseAdapterV2, validateAdapterV2, } from "./schema-v2.js";
+/**
+ * `TransportId` is the stable string literal union identifying a transport.
+ * Aliased here for callers that prefer the shorter name.
+ */
+export type { TransportKind as TransportId } from "../transport/types.js";
+//# sourceMappingURL=types.d.ts.map

package/dist/core/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/core/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAGH,YAAY,EACV,UAAU,EACV,cAAc,EACd,eAAe,EACf,cAAc,EACd,KAAK,EACL,cAAc,EACd,YAAY,EACZ,YAAY,EACZ,mBAAmB,EACnB,YAAY,EACZ,eAAe,EACf,iBAAiB,EACjB,eAAe,GAChB,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAG9D,YAAY,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAEvE,YAAY,EACV,QAAQ,EACR,aAAa,EACb,WAAW,EACX,UAAU,EACV,YAAY,EACZ,gBAAgB,EAChB,QAAQ,GACT,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,YAAY,EAAE,GAAG,EAAE,WAAW,EAAE,EAAE,EAAE,MAAM,eAAe,CAAC;AAEnE,YAAY,EACV,gBAAgB,EAChB,YAAY,EACZ,sBAAsB,EACtB,uBAAuB,GACxB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EACL,iCAAiC,EACjC,sBAAsB,EACtB,WAAW,EACX,cAAc,EACd,iBAAiB,GAClB,MAAM,gBAAgB,CAAC;AAExB;;;GAGG;AACH,YAAY,EAAE,aAAa,IAAI,WAAW,EAAE,MAAM,uBAAuB,CAAC"}