@glubean/sdk 0.2.1 → 0.2.3

package/dist/contract-artifacts.js

@@ -0,0 +1,402 @@
+/**
+ * @module contract-artifacts
+ *
+ * Contract artifact registry — declarative extension point for
+ * "contracts → X" rendering (markdown / openapi / future proto / sdl /
+ * asyncapi / ...).
+ *
+ * Replaces the v0.1 per-adapter `toMarkdown?` / `toOpenApi?` hooks which
+ * (a) polluted the generic `ContractProtocolAdapter` interface with
+ * protocol-specific artifacts (OpenAPI is HTTP-only), (b) had dead
+ * declarations that nothing called, and (c) gave consumers no way to
+ * enumerate "which artifact kinds does this project support".
+ *
+ * See `internal/40-discovery/proposals/contract-artifact-registry.md` (v6).
+ *
+ * ## Concepts
+ *
+ * **ArtifactKind**: first-class description of an output format (name +
+ * merge strategy + empty skeleton + optional defaultRender). Per-contract
+ * Part and final merged Final are independently typed (markdown renders
+ * structured parts that the merge assembles into a document; openapi
+ * renders per-contract partial documents that the merge stitches together).
+ *
+ * **ContractProtocolAdapter.artifacts**: each adapter declares which
+ * kinds it produces. Mapping from kind name to per-contract renderer.
+ *
+ * **Consumers**: `renderArtifact(kind, contracts, options?, control?)`
+ * dispatches across all registered adapters; fallback to kind.defaultRender
+ * where the adapter doesn't implement the kind; ultimate fallback to
+ * kind.empty when no contract contributes a part.
+ *
+ * ## Types
+ *
+ * `KnownArtifacts` / `KnownArtifactParts` / `KnownArtifactOptions` are
+ * declared at the package root (`packages/sdk/src/index.ts`) so third-
+ * party plugins can augment via `declare module "@glubean/sdk"`. This file
+ * imports them as types from the root so declaration merging hits the
+ * same node.
+ */
+import { getAdapter, listRegisteredProtocols, } from "./contract-core.js";
+import { emptyOpenApiDocument, mergeOpenApiParts, } from "./contract-http/openapi.js";
+// =============================================================================
+// Kind registry
+// =============================================================================
+const _kinds = new Map();
+/**
+ * Register an artifact kind by name. Idempotent when re-registering the same
+ * kind object; throws when a different object tries to take the same name
+ * (protects against typo-level collisions across plugins).
+ *
+ * `defineArtifactKind` is the ergonomic entry; this is exported for advanced
+ * scenarios where a kind is built separately from its registration.
+ */
+export function registerArtifactKind(kind) {
+    const existing = _kinds.get(kind.name);
+    if (existing) {
+        if (existing !== kind) {
+            throw new Error(`Artifact kind "${kind.name}" already registered with a different instance. ` +
+                `Ensure each kind is defined exactly once per process.`);
+        }
+        return;
+    }
+    _kinds.set(kind.name, kind);
+}
+/**
+ * Look up a registered kind by name. Used by `renderArtifactByName` and any
+ * other string-driven consumer (CLI --format, MCP tool inputs, etc.).
+ */
+export function getArtifactKind(name) {
+    return _kinds.get(name);
+}
+/** List all registered kind names (insertion order). */
+export function listArtifactKinds() {
+    return [..._kinds.keys()];
+}
+/**
+ * Define and register an artifact kind in one call. Preferred entry point
+ * for kind authors (SDK built-ins + first-party plugins).
+ */
+export function defineArtifactKind(spec) {
+    registerArtifactKind(spec);
+    return spec;
+}
+/**
+ * Test-only: clear the kind registry. Not exposed publicly; imported by
+ * `contract-artifacts.test.ts` via relative path.
+ *
+ * @internal
+ */
+export function __resetArtifactKindsForTesting() {
+    _kinds.clear();
+}
+/**
+ * Core render pipeline implementation — produces both a value and a
+ * detailed summary. `renderArtifact` is a thin wrapper returning just the
+ * value; `renderArtifactWithSummary` returns the full summary.
+ *
+ * Generic type `Final` / `Part` / `Options` instead of referring to the
+ * kind's generics directly so runtime-typed callers (renderArtifactByName)
+ * can pass `unknown`.
+ */
+function runRender(kind, contracts, options, control) {
+    const parts = [];
+    const contributions = [];
+    const skipped = [];
+    for (const c of contracts) {
+        const adapter = getAdapter(c.protocol);
+        const explicitProducer = !control?.preferDefaultRender
+            ? adapter?.artifacts?.[kind.name]
+            : undefined;
+        if (explicitProducer) {
+            parts.push(explicitProducer(c, options));
+            contributions.push({
+                contractId: c.id,
+                protocol: c.protocol,
+                source: "explicit-producer",
+            });
+            continue;
+        }
+        if (kind.defaultRender) {
+            parts.push(kind.defaultRender(c, options));
+            contributions.push({
+                contractId: c.id,
+                protocol: c.protocol,
+                source: "default-render",
+            });
+            continue;
+        }
+        skipped.push({
+            contractId: c.id,
+            protocol: c.protocol,
+            reason: control?.preferDefaultRender
+                ? "prefer-default-render-no-default"
+                : "no-producer-no-default-render",
+        });
+    }
+    if (parts.length === 0) {
+        return {
+            value: kind.empty,
+            contributions,
+            skipped,
+            usedEmptyFallback: true,
+        };
+    }
+    return {
+        value: kind.merge(parts, options),
+        contributions,
+        skipped,
+        usedEmptyFallback: false,
+    };
+}
+/**
+ * Render an artifact of the given kind from a list of contracts. Threads
+ * `options` through the producer / defaultRender / merge pipeline. When no
+ * contract contributes a part, returns `kind.empty` (guaranteed valid
+ * `Final`).
+ *
+ * Strong-typed entry point: kind argument is a concrete `ArtifactKind<...>`
+ * object, so `options` type and return type are inferred at compile time.
+ */
+export function renderArtifact(kind, contracts, options, control) {
+    return runRender(kind, contracts, options, control).value;
+}
+/**
+ * Render an artifact and return the full summary (value + contributions +
+ * skipped + usedEmptyFallback). Use this when you need to distinguish
+ * "zero contribution" from "merged to kind.empty-shaped value" — the
+ * `usedEmptyFallback` field is the authoritative signal (do not compare
+ * `value === kind.empty` yourself for object-typed Final).
+ */
+export function renderArtifactWithSummary(kind, contracts, options, control) {
+    return runRender(kind, contracts, options, control);
+}
+/**
+ * Look up a kind by name and render. Used by string-driven consumers
+ * (CLI --format <name>, MCP tools, agent introspection). Throws when the
+ * name is not registered — the error message includes the list of
+ * registered kinds so callers can surface it without extra lookups.
+ *
+ * Returns `unknown` since we don't know the Final type statically;
+ * callers that need a typed return should use `renderArtifact` directly
+ * with the kind object they import.
+ */
+export function renderArtifactByName(kindName, contracts, options, control) {
+    const kind = getArtifactKind(kindName);
+    if (!kind) {
+        const known = listArtifactKinds();
+        const hint = known.length > 0 ? known.join(", ") : "(none)";
+        throw new Error(`Unknown artifact kind "${kindName}". Registered kinds: ${hint}`);
+    }
+    return renderArtifact(kind, contracts, options, control);
+}
+// =============================================================================
+// Introspection
+// =============================================================================
+/**
+ * List the protocols whose adapter **explicitly declares a producer** for
+ * the given kind. Does NOT include protocols that would fall back to
+ * `kind.defaultRender`. Use `listArtifactCapability` for the three-way split.
+ */
+export function listArtifactProducers(kindName) {
+    return listRegisteredProtocols().filter((p) => {
+        const adapter = getAdapter(p);
+        return (adapter !== undefined &&
+            adapter.artifacts?.[kindName] !==
+                undefined);
+    });
+}
+/**
+ * Static capability view — **based on installed adapters**, not on any
+ * particular project's contracts. Partitions protocols into:
+ *
+ *   - `explicit`    : adapter declares a producer for this kind
+ *   - `fallback`    : adapter has no producer but kind.defaultRender exists
+ *   - `unsupported` : adapter has no producer and kind has no defaultRender
+ *
+ * To answer "does **this project** produce the artifact?", use
+ * `renderArtifactWithSummary` and inspect `contributions` + `usedEmptyFallback`.
+ * The capability view cannot know how many contracts of each protocol exist
+ * in the caller's project.
+ */
+export function listArtifactCapability(kindName) {
+    const kind = getArtifactKind(kindName);
+    const allProtocols = listRegisteredProtocols();
+    const explicit = listArtifactProducers(kindName);
+    const explicitSet = new Set(explicit);
+    const rest = allProtocols.filter((p) => !explicitSet.has(p));
+    if (kind?.defaultRender) {
+        return { explicit, fallback: rest, unsupported: [] };
+    }
+    return { explicit, fallback: [], unsupported: rest };
+}
+// =============================================================================
+// Built-in kinds
+// =============================================================================
+/**
+ * OpenAPI 3.1 artifact kind. Per-contract partials are produced by HTTP
+ * adapter's `artifacts.openapi` (see `contract-http/openapi.ts`); merge
+ * combines them into a full spec. No `defaultRender` — non-HTTP protocols
+ * don't map to OpenAPI and are skipped.
+ *
+ * Ported from MCP's former `contractsToOpenApi` — CAR-1 Phase 2.
+ */
+export const openapiArtifact = defineArtifactKind({
+    name: "openapi",
+    merge: (parts, options) => mergeOpenApiParts(parts, options),
+    empty: emptyOpenApiDocument,
+});
+/**
+ * Protocol-agnostic default renderer. Reads raw fields off the
+ * projection; every protocol gets a valid Part even if its adapter
+ * doesn't declare `artifacts.markdown`.
+ */
+export function genericMarkdownPart(projection) {
+    return {
+        contractId: projection.id,
+        endpoint: projection.target,
+        protocol: projection.protocol,
+        description: projection.description,
+        feature: projection.feature,
+        instanceName: projection.instanceName,
+        deprecated: projection.deprecated,
+        cases: projection.cases.map((c) => ({
+            key: c.key,
+            description: c.description,
+            lifecycle: c.lifecycle ??
+                (c.deprecatedReason
+                    ? "deprecated"
+                    : c.deferredReason
+                        ? "deferred"
+                        : "active"),
+            severity: c.severity ?? "warning",
+            defaultRun: c.defaultRun,
+            requires: c.requires,
+            deferredReason: c.deferredReason,
+            deprecatedReason: c.deprecatedReason,
+        })),
+    };
+}
+function computeMarkdownSummary(parts) {
+    let total = 0;
+    let deferred = 0;
+    let deprecated = 0;
+    let gated = 0;
+    for (const p of parts) {
+        for (const c of p.cases) {
+            total++;
+            if (c.lifecycle === "deprecated")
+                deprecated++;
+            else if (c.lifecycle === "deferred")
+                deferred++;
+            else if (c.requires === "browser" || c.requires === "out-of-band")
+                gated++;
+        }
+    }
+    return {
+        total,
+        active: total - deferred - deprecated - gated,
+        deferred,
+        deprecated,
+        gated,
+    };
+}
+function formatMarkdownCase(c) {
+    const desc = c.description ? ` — ${c.description}` : "";
+    if (c.lifecycle === "deprecated") {
+        const reason = c.deprecatedReason ?? "deprecated";
+        return `- ⊘ **${c.key}** — deprecated: ${reason}`;
+    }
+    if (c.lifecycle === "deferred") {
+        const reason = c.deferredReason ?? "deferred";
+        return `- ⊘ **${c.key}** — deferred: ${reason}`;
+    }
+    if (c.requires === "browser" || c.requires === "out-of-band") {
+        return `- ⊘ **${c.key}** — requires: ${c.requires}`;
+    }
+    const severityTag = c.severity === "critical" ? " 🔴" : c.severity === "info" ? " ℹ️" : "";
+    const suffix = c.defaultRun === "opt-in" ? " *(opt-in)*" : "";
+    return `- **${c.key}**${desc}${suffix}${severityTag}`;
+}
+/**
+ * Compute the effective feature key for a part — applies the
+ * instanceName-aware transform when the project has any instanced
+ * contract (matches CLI `hasInstances` pre-pass behavior).
+ */
+function displayFeature(part, hasInstances) {
+    if (hasInstances && part.instanceName) {
+        return `${part.instanceName}: ${part.feature ?? part.endpoint}`;
+    }
+    return part.feature ?? part.endpoint;
+}
+/**
+ * Feature-grouped, doc-level markdown assembly. Byte-for-byte output
+ * compatible with `formatMdOutline` from `packages/cli/src/commands/
+ * contracts.ts` (the legacy CLI markdown path).
+ *
+ * Structure:
+ *   # Contract Specification
+ *   Generated: YYYY-MM-DD | N cases | N active | ...
+ *
+ *   ## <feature>
+ *   🚫 **Deprecated:** ...   (if contract-level deprecated)
+ *   <description or endpoint intro>
+ *   - **case** — ...
+ */
+export function assembleMarkdownDocument(parts) {
+    if (parts.length === 0)
+        return "";
+    const hasInstances = parts.some((p) => !!p.instanceName);
+    // Group preserving insertion order
+    const groups = new Map();
+    for (const part of parts) {
+        const key = displayFeature(part, hasInstances);
+        const list = groups.get(key) ?? [];
+        list.push(part);
+        groups.set(key, list);
+    }
+    const summary = computeMarkdownSummary(parts);
+    const lines = [];
+    lines.push("# Contract Specification");
+    lines.push("");
+    const date = new Date().toISOString().slice(0, 10);
+    const summaryParts = [`Generated: ${date}`, `${summary.total} cases`];
+    if (summary.active > 0)
+        summaryParts.push(`${summary.active} active`);
+    if (summary.deferred > 0)
+        summaryParts.push(`${summary.deferred} deferred`);
+    if (summary.deprecated > 0)
+        summaryParts.push(`${summary.deprecated} deprecated`);
+    if (summary.gated > 0)
+        summaryParts.push(`${summary.gated} gated`);
+    lines.push(summaryParts.join(" | "));
+    lines.push("");
+    for (const [featureName, featureParts] of groups.entries()) {
+        lines.push(`## ${featureName}`);
+        lines.push("");
+        for (const contract of featureParts) {
+            const intro = contract.description ??
+                (featureName !== contract.endpoint ? contract.endpoint : undefined);
+            if (contract.deprecated) {
+                lines.push(`🚫 **Deprecated:** ${contract.deprecated}`);
+                lines.push("");
+            }
+            if (intro) {
+                lines.push(intro);
+                lines.push("");
+            }
+            for (const c of contract.cases) {
+                lines.push(formatMarkdownCase(c));
+            }
+            lines.push("");
+        }
+    }
+    return lines.join("\n").trimEnd() + "\n";
+}
+export const markdownArtifact = defineArtifactKind({
+    name: "markdown",
+    defaultRender: (projection) => genericMarkdownPart(projection),
+    merge: (parts) => assembleMarkdownDocument(parts),
+    empty: "",
+});
+//# sourceMappingURL=contract-artifacts.js.map

package/dist/contract-artifacts.js.map

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

package/dist/contract-core.d.ts

@@ -19,9 +19,39 @@
  *   - `internal/40-discovery/proposals/contract-flow.md` v9
  */
 import type { TestContext } from "./types.js";
-import type { ContractProtocolAdapter, ExtractedFlowProjection, FieldMapping, FlowBuilder, FlowContract, FlowMeta, RuntimeFlowProjection } from "./contract-types.js";
+import type { Bootstrap, BootstrapAttachment, ContractCaseRef, ContractProtocolAdapter, ExtractedFlowProjection, FieldMapping, FlowBuilder, FlowContract, FlowMeta, RuntimeFlowProjection } from "./contract-types.js";
 /** Internal accessor for plugins / downstream (scanner, runner). */
 export declare function getAdapter(protocol: string): ContractProtocolAdapter<any, any, any, any, any> | undefined;
+/**
+ * List all currently registered protocol names. Used by the artifact
+ * registry's capability introspection (`listArtifactCapability`) to iterate
+ * all adapters and classify them against a given artifact kind.
+ *
+ * Order is insertion order (Map semantics). Consumers that need stable
+ * output should sort.
+ */
+export declare function listRegisteredProtocols(): string[];
+/**
+ * Test-only: unregister a protocol adapter + remove its dispatcher from the
+ * `contract` namespace. Used by `__resetInstalledPluginsForTesting` in
+ * `install-plugin.ts` to restore a clean state between test scenarios.
+ *
+ * Not exposed via the public `contract` object — callers must import it
+ * directly from `@glubean/sdk/internal`. Reserved protocol names
+ * (`register`, `flow`, `getAdapter`) are refused.
+ *
+ * @internal
+ */
+export declare function __unregisterProtocolForTesting(protocol: string): void;
+/**
+ * Test-only: unregister all protocol adapters at once (iterates the current
+ * registry and calls `__unregisterProtocolForTesting` for each, including
+ * built-in "http"). Used by contract-artifacts tests that need a clean
+ * adapter registry between assertions. Reserved names are naturally skipped.
+ *
+ * @internal
+ */
+export declare function __resetAdapterRegistryForTesting(): void;
 /**
  * Register an adapter. Called by built-in HTTP adapter on SDK load, and by
  * external protocol packages (`@glubean/grpc`, `@glubean/graphql` etc.) on
@@ -32,8 +62,20 @@ declare function register<Spec, RuntimeSchemas = unknown, RuntimeMeta = unknown,
 type ContractNamespace = {
     register: typeof register;
     flow: typeof flow;
+    bootstrap: typeof bootstrap;
     [protocol: string]: unknown;
 };
+/**
+ * Register a bootstrap overlay for a contract case. Standalone-only
+ * execution path; flow NEVER invokes bootstrap (non-negotiable invariant
+ * from attachment model §0.4 / §14.0).
+ *
+ * `NoInfer<Needs>` on the spec parameter prevents TypeScript's multi-site
+ * inference from silently accepting a mismatched `run` return type —
+ * without it, TS merges inferences from ref + spec and produces a
+ * compatible Needs, masking real type errors (Spike 0 Finding 1).
+ */
+export declare function bootstrap<Needs, Params = void>(ref: ContractCaseRef<Needs, unknown>, spec: Bootstrap<Params, NoInfer<Needs>>): BootstrapAttachment<Needs, Params>;
 export declare const contract: ContractNamespace;
 /**
  * Protocol-agnostic flow builder. See contract-flow.md v9 §4.1.

package/dist/contract-core.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"contract-core.d.ts","sourceRoot":"","sources":["../src/contract-core.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,KAAK,EAAQ,WAAW,EAAE,MAAM,YAAY,CAAC;AACpD,OAAO,KAAK,EAEV,uBAAuB,EAGvB,uBAAuB,EAEvB,YAAY,EACZ,WAAW,EACX,YAAY,EACZ,QAAQ,EAKR,qBAAqB,EAEtB,MAAM,qBAAqB,CAAC;AAS7B,oEAAoE;AACpE,wBAAgB,UAAU,CACxB,QAAQ,EAAE,MAAM,GACf,uBAAuB,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,GAAG,SAAS,CAE9D;AAYD;;;;;GAKG;AACH,iBAAS,QAAQ,CACf,IAAI,EACJ,cAAc,GAAG,OAAO,EACxB,WAAW,GAAG,OAAO,EACrB,WAAW,GAAG,OAAO,EACrB,QAAQ,GAAG,OAAO,EAElB,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,uBAAuB,CAAC,IAAI,EAAE,cAAc,EAAE,WAAW,EAAE,WAAW,EAAE,QAAQ,CAAC,GACzF,IAAI,CAgBN;AA6OD,KAAK,iBAAiB,GAAG;IACvB,QAAQ,EAAE,OAAO,QAAQ,CAAC;IAC1B,IAAI,EAAE,OAAO,IAAI,CAAC;IAClB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC;CAC7B,CAAC;AAEF,eAAO,MAAM,QAAQ,EAAE,iBAGtB,CAAC;AAMF;;GAEG;AACH,wBAAgB,IAAI,CAAC,QAAQ,EAAE,MAAM,GAAG,QAAQ,GAAG,WAAW,CAAC,OAAO,CAAC,CAqJtE;AAyBD;;;GAGG;AACH,wBAAsB,OAAO,CAAC,KAAK,EACjC,YAAY,EAAE,YAAY,CAAC,KAAK,CAAC,EACjC,GAAG,EAAE,WAAW,GACf,OAAO,CAAC,IAAI,CAAC,CAuEf;AAMD;;;;;;;GAOG;AACH,wBAAgB,aAAa,CAAC,KAAK,EACjC,OAAO,EAAE,qBAAqB,CAAC,KAAK,CAAC,GAAG;IAAE,EAAE,EAAE,MAAM,CAAA;CAAE,GACrD,uBAAuB,CAoEzB;AAED;;;;;;;;;GASG;AACH,wBAAgB,eAAe,CAAC,EAAE,EAAE,CAAC,KAAK,EAAE,GAAG,KAAK,GAAG,GAAG,YAAY,EAAE,CAIvE;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAChC,EAAE,EAAE,CAAC,KAAK,EAAE,GAAG,EAAE,QAAQ,EAAE,GAAG,KAAK,GAAG,GACrC,YAAY,EAAE,CAMhB;AAkED;;;;GAIG;AACH,qBAAa,eAAgB,SAAQ,KAAK;IACxC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;gBACf,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM;CAY5C;AAiDD;;;;;;;;GAQG;AACH,wBAAgB,cAAc,CAC5B,EAAE,EAAE,CAAC,KAAK,EAAE,GAAG,KAAK,GAAG,GACtB;IAAE,KAAK,EAAE,MAAM,EAAE,CAAC;IAAC,MAAM,EAAE,MAAM,EAAE,CAAA;CAAE,CAavC"}
+{"version":3,"file":"contract-core.d.ts","sourceRoot":"","sources":["../src/contract-core.ts"],"names":[],"mappings":"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"}