@contractspec/bundle.library 3.8.10 → 3.8.11

package/dist/node/application/mcp/contractsMcpTools.js

@@ -1,199 +1 @@
-// src/application/mcp/contractsMcpTools.ts
-import {
-  defineCommand,
-  installOp,
-  OperationSpecRegistry
-} from "@contractspec/lib.contracts-spec";
-import { defineSchemaModel, ScalarTypeEnum } from "@contractspec/lib.schema";
-var OWNERS = ["@contractspec"];
-var TAGS = ["contracts", "mcp"];
-function buildContractsOps(services) {
-  const registry = new OperationSpecRegistry;
-  const ListInput = defineSchemaModel({
-    name: "ContractsListInput",
-    fields: {
-      pattern: { type: ScalarTypeEnum.String_unsecure(), isOptional: true },
-      type: { type: ScalarTypeEnum.String_unsecure(), isOptional: true }
-    }
-  });
-  const ListOutput = defineSchemaModel({
-    name: "ContractsListOutput",
-    fields: {
-      specs: { type: ScalarTypeEnum.JSON(), isOptional: false },
-      total: { type: ScalarTypeEnum.Int_unsecure(), isOptional: false }
-    }
-  });
-  installOp(registry, defineCommand({
-    meta: {
-      key: "contracts.list",
-      version: "1.0.0",
-      stability: "beta",
-      owners: OWNERS,
-      tags: TAGS,
-      description: "List contract specs in the workspace.",
-      goal: "Discover available contracts by type, pattern, or owner.",
-      context: "Contracts MCP server."
-    },
-    io: { input: ListInput, output: ListOutput },
-    policy: { auth: "anonymous" }
-  }), async ({ pattern, type }) => {
-    const specs = await services.listSpecs({ pattern, type });
-    return { specs, total: specs.length };
-  });
-  const GetInput = defineSchemaModel({
-    name: "ContractsGetInput",
-    fields: {
-      path: { type: ScalarTypeEnum.String_unsecure(), isOptional: false }
-    }
-  });
-  const GetOutput = defineSchemaModel({
-    name: "ContractsGetOutput",
-    fields: {
-      content: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
-      info: { type: ScalarTypeEnum.JSON(), isOptional: false }
-    }
-  });
-  installOp(registry, defineCommand({
-    meta: {
-      key: "contracts.get",
-      version: "1.0.0",
-      stability: "beta",
-      owners: OWNERS,
-      tags: TAGS,
-      description: "Read a single contract spec file.",
-      goal: "Fetch spec content and parsed metadata.",
-      context: "Contracts MCP server."
-    },
-    io: { input: GetInput, output: GetOutput },
-    policy: { auth: "anonymous" }
-  }), async ({ path }) => {
-    const result = await services.getSpec(path);
-    if (!result)
-      throw new Error(`Spec not found: ${path}`);
-    return result;
-  });
-  const ValidateInput = defineSchemaModel({
-    name: "ContractsValidateInput",
-    fields: {
-      path: { type: ScalarTypeEnum.String_unsecure(), isOptional: false }
-    }
-  });
-  const ValidateOutput = defineSchemaModel({
-    name: "ContractsValidateOutput",
-    fields: {
-      valid: { type: ScalarTypeEnum.Boolean(), isOptional: false },
-      errors: { type: ScalarTypeEnum.JSON(), isOptional: false },
-      warnings: { type: ScalarTypeEnum.JSON(), isOptional: false }
-    }
-  });
-  installOp(registry, defineCommand({
-    meta: {
-      key: "contracts.validate",
-      version: "1.0.0",
-      stability: "beta",
-      owners: OWNERS,
-      tags: TAGS,
-      description: "Validate a contract spec structure.",
-      goal: "Check spec for structural or policy issues.",
-      context: "Contracts MCP server."
-    },
-    io: { input: ValidateInput, output: ValidateOutput },
-    policy: { auth: "anonymous" }
-  }), async ({ path }) => services.validateSpec(path));
-  const BuildInput = defineSchemaModel({
-    name: "ContractsBuildInput",
-    fields: {
-      path: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
-      dryRun: { type: ScalarTypeEnum.Boolean(), isOptional: true }
-    }
-  });
-  const BuildOutput = defineSchemaModel({
-    name: "ContractsBuildOutput",
-    fields: {
-      results: { type: ScalarTypeEnum.JSON(), isOptional: false }
-    }
-  });
-  installOp(registry, defineCommand({
-    meta: {
-      key: "contracts.build",
-      version: "1.0.0",
-      stability: "beta",
-      owners: OWNERS,
-      tags: TAGS,
-      description: "Generate implementation code from a contract spec.",
-      goal: "Produce handler, component, or test skeletons.",
-      context: "Contracts MCP server."
-    },
-    io: { input: BuildInput, output: BuildOutput },
-    policy: { auth: "user" }
-  }), async ({ path, dryRun }) => services.buildSpec(path, { dryRun }));
-  registerMutationTools(registry, services);
-  return registry;
-}
-function registerMutationTools(registry, services) {
-  const UpdateInput = defineSchemaModel({
-    name: "ContractsUpdateInput",
-    fields: {
-      path: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
-      content: { type: ScalarTypeEnum.String_unsecure(), isOptional: true },
-      fields: { type: ScalarTypeEnum.JSON(), isOptional: true }
-    }
-  });
-  const UpdateOutput = defineSchemaModel({
-    name: "ContractsUpdateOutput",
-    fields: {
-      updated: { type: ScalarTypeEnum.Boolean(), isOptional: false },
-      errors: { type: ScalarTypeEnum.JSON(), isOptional: false },
-      warnings: { type: ScalarTypeEnum.JSON(), isOptional: false }
-    }
-  });
-  installOp(registry, defineCommand({
-    meta: {
-      key: "contracts.update",
-      version: "1.0.0",
-      stability: "beta",
-      owners: OWNERS,
-      tags: TAGS,
-      description: "Update an existing contract spec.",
-      goal: "Modify spec content or individual fields with validation.",
-      context: "Contracts MCP server."
-    },
-    io: { input: UpdateInput, output: UpdateOutput },
-    policy: { auth: "user" }
-  }), async ({ path, content, fields }) => services.updateSpec(path, {
-    content,
-    fields: Array.isArray(fields) ? fields : undefined
-  }));
-  const DeleteInput = defineSchemaModel({
-    name: "ContractsDeleteInput",
-    fields: {
-      path: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
-      clean: { type: ScalarTypeEnum.Boolean(), isOptional: true }
-    }
-  });
-  const DeleteOutput = defineSchemaModel({
-    name: "ContractsDeleteOutput",
-    fields: {
-      deleted: { type: ScalarTypeEnum.Boolean(), isOptional: false },
-      cleanedFiles: { type: ScalarTypeEnum.JSON(), isOptional: false },
-      errors: { type: ScalarTypeEnum.JSON(), isOptional: false }
-    }
-  });
-  installOp(registry, defineCommand({
-    meta: {
-      key: "contracts.delete",
-      version: "1.0.0",
-      stability: "beta",
-      owners: OWNERS,
-      tags: TAGS,
-      description: "Delete a contract spec and optionally its artifacts.",
-      goal: "Remove a spec file and clean generated handlers/tests.",
-      context: "Contracts MCP server."
-    },
-    io: { input: DeleteInput, output: DeleteOutput },
-    policy: { auth: "user" }
-  }), async ({ path, clean }) => services.deleteSpec(path, { clean }));
-}
-export {
-  buildContractsOps
-};
+import{defineCommand as F,installOp as H,OperationSpecRegistry as D}from"@contractspec/lib.contracts-spec";import{defineSchemaModel as k,ScalarTypeEnum as j}from"@contractspec/lib.schema";var J=["@contractspec"],K=["contracts","mcp"];function A(w){let q=new D,Y=k({name:"ContractsListInput",fields:{pattern:{type:j.String_unsecure(),isOptional:!0},type:{type:j.String_unsecure(),isOptional:!0}}}),Z=k({name:"ContractsListOutput",fields:{specs:{type:j.JSON(),isOptional:!1},total:{type:j.Int_unsecure(),isOptional:!1}}});H(q,F({meta:{key:"contracts.list",version:"1.0.0",stability:"beta",owners:J,tags:K,description:"List contract specs in the workspace.",goal:"Discover available contracts by type, pattern, or owner.",context:"Contracts MCP server."},io:{input:Y,output:Z},policy:{auth:"anonymous"}}),async({pattern:x,type:z})=>{let b=await w.listSpecs({pattern:x,type:z});return{specs:b,total:b.length}});let _=k({name:"ContractsGetInput",fields:{path:{type:j.String_unsecure(),isOptional:!1}}}),$=k({name:"ContractsGetOutput",fields:{content:{type:j.String_unsecure(),isOptional:!1},info:{type:j.JSON(),isOptional:!1}}});H(q,F({meta:{key:"contracts.get",version:"1.0.0",stability:"beta",owners:J,tags:K,description:"Read a single contract spec file.",goal:"Fetch spec content and parsed metadata.",context:"Contracts MCP server."},io:{input:_,output:$},policy:{auth:"anonymous"}}),async({path:x})=>{let z=await w.getSpec(x);if(!z)throw Error(`Spec not found: ${x}`);return z});let P=k({name:"ContractsValidateInput",fields:{path:{type:j.String_unsecure(),isOptional:!1}}}),Q=k({name:"ContractsValidateOutput",fields:{valid:{type:j.Boolean(),isOptional:!1},errors:{type:j.JSON(),isOptional:!1},warnings:{type:j.JSON(),isOptional:!1}}});H(q,F({meta:{key:"contracts.validate",version:"1.0.0",stability:"beta",owners:J,tags:K,description:"Validate a contract spec structure.",goal:"Check spec for structural or policy issues.",context:"Contracts MCP server."},io:{input:P,output:Q},policy:{auth:"anonymous"}}),async({path:x})=>w.validateSpec(x));let X=k({name:"ContractsBuildInput",fields:{path:{type:j.String_unsecure(),isOptional:!1},dryRun:{type:j.Boolean(),isOptional:!0}}}),B=k({name:"ContractsBuildOutput",fields:{results:{type:j.JSON(),isOptional:!1}}});return H(q,F({meta:{key:"contracts.build",version:"1.0.0",stability:"beta",owners:J,tags:K,description:"Generate implementation code from a contract spec.",goal:"Produce handler, component, or test skeletons.",context:"Contracts MCP server."},io:{input:X,output:B},policy:{auth:"user"}}),async({path:x,dryRun:z})=>w.buildSpec(x,{dryRun:z})),L(q,w),q}function L(w,q){let Y=k({name:"ContractsUpdateInput",fields:{path:{type:j.String_unsecure(),isOptional:!1},content:{type:j.String_unsecure(),isOptional:!0},fields:{type:j.JSON(),isOptional:!0}}}),Z=k({name:"ContractsUpdateOutput",fields:{updated:{type:j.Boolean(),isOptional:!1},errors:{type:j.JSON(),isOptional:!1},warnings:{type:j.JSON(),isOptional:!1}}});H(w,F({meta:{key:"contracts.update",version:"1.0.0",stability:"beta",owners:J,tags:K,description:"Update an existing contract spec.",goal:"Modify spec content or individual fields with validation.",context:"Contracts MCP server."},io:{input:Y,output:Z},policy:{auth:"user"}}),async({path:P,content:Q,fields:X})=>q.updateSpec(P,{content:Q,fields:Array.isArray(X)?X:void 0}));let _=k({name:"ContractsDeleteInput",fields:{path:{type:j.String_unsecure(),isOptional:!1},clean:{type:j.Boolean(),isOptional:!0}}}),$=k({name:"ContractsDeleteOutput",fields:{deleted:{type:j.Boolean(),isOptional:!1},cleanedFiles:{type:j.JSON(),isOptional:!1},errors:{type:j.JSON(),isOptional:!1}}});H(w,F({meta:{key:"contracts.delete",version:"1.0.0",stability:"beta",owners:J,tags:K,description:"Delete a contract spec and optionally its artifacts.",goal:"Remove a spec file and clean generated handlers/tests.",context:"Contracts MCP server."},io:{input:_,output:$},policy:{auth:"user"}}),async({path:P,clean:Q})=>q.deleteSpec(P,{clean:Q}))}export{A as buildContractsOps};

package/dist/node/application/mcp/docsMcp.catalog.js

@@ -1,381 +1,3 @@
-// src/application/mcp/docsMcp.data.ts
-import { defaultDocRegistry } from "@contractspec/lib.contracts-spec/docs";
-var DEFAULT_LIMIT = 20;
-var MAX_LIMIT = 100;
-function normalizeText(value) {
-  return value?.trim().toLowerCase() ?? "";
-}
-function normalizeRoute(route) {
-  const decoded = decodeURIComponent(route).trim();
-  if (!decoded)
-    return "/";
-  return decoded.startsWith("/") ? decoded : `/${decoded}`;
-}
-function normalizeTags(value) {
-  const tags = Array.isArray(value) ? value : value ? [value] : [];
-  return tags.map((tag) => normalizeText(tag)).filter(Boolean);
-}
-function clampLimit(limit) {
-  if (!limit || Number.isNaN(limit))
-    return DEFAULT_LIMIT;
-  return Math.min(Math.max(limit, 1), MAX_LIMIT);
-}
-function clampOffset(offset) {
-  if (!offset || Number.isNaN(offset))
-    return 0;
-  return Math.max(offset, 0);
-}
-function toDocSummary({ block, route }) {
-  return {
-    id: block.id,
-    title: block.title,
-    summary: block.summary ?? "",
-    route,
-    visibility: block.visibility ?? "public",
-    kind: block.kind ?? "reference",
-    version: block.version ?? "1.0.0",
-    tags: block.tags ?? []
-  };
-}
-function scoreDoc(route, query) {
-  if (!query)
-    return 1;
-  const tokens = query.split(/\s+/).filter(Boolean);
-  const title = normalizeText(route.block.title);
-  const id = normalizeText(route.block.id);
-  const summary = normalizeText(route.block.summary);
-  const body = normalizeText(route.block.body);
-  const path = normalizeText(route.route);
-  const tags = (route.block.tags ?? []).map((tag) => normalizeText(tag));
-  const haystack = [title, id, summary, body, path, ...tags].join(" ");
-  if (tokens.some((token) => !haystack.includes(token)))
-    return 0;
-  let score = 0;
-  for (const token of tokens) {
-    if (id.includes(token))
-      score += 8;
-    if (title.includes(token))
-      score += 7;
-    if (tags.some((tag) => tag.includes(token)))
-      score += 5;
-    if (summary.includes(token))
-      score += 4;
-    if (path.includes(token))
-      score += 3;
-    if (body.includes(token))
-      score += 2;
-  }
-  return score;
-}
-function searchDocs(routes, args) {
-  const query = normalizeText(typeof args.query === "string" ? args.query : undefined);
-  const tags = normalizeTags(args.tag);
-  const visibility = normalizeText(typeof args.visibility === "string" ? args.visibility : undefined);
-  const kind = normalizeText(typeof args.kind === "string" ? args.kind : undefined);
-  const limit = clampLimit(typeof args.limit === "number" ? args.limit : undefined);
-  const offset = clampOffset(typeof args.offset === "number" ? args.offset : undefined);
-  const ranked = routes.map((route) => ({
-    doc: toDocSummary(route),
-    score: scoreDoc(route, query)
-  })).filter(({ doc, score }) => {
-    const matchesQuery = query ? score > 0 : true;
-    const matchesTags = tags.length ? tags.every((tag) => doc.tags.some((docTag) => normalizeText(docTag).includes(tag))) : true;
-    const matchesVisibility = visibility ? normalizeText(doc.visibility) === visibility : true;
-    const matchesKind = kind ? normalizeText(doc.kind) === kind : true;
-    return matchesQuery && matchesTags && matchesVisibility && matchesKind;
-  }).sort((left, right) => {
-    if (right.score !== left.score)
-      return right.score - left.score;
-    return left.doc.title.localeCompare(right.doc.title);
-  });
-  const docs = ranked.slice(offset, offset + limit).map(({ doc }) => doc);
-  const nextOffset = offset + docs.length < ranked.length ? offset + docs.length : undefined;
-  return {
-    docs,
-    items: docs,
-    total: ranked.length,
-    ...nextOffset != null ? { nextOffset } : {}
-  };
-}
-function getDocById(id) {
-  const normalizedId = decodeURIComponent(id);
-  const found = defaultDocRegistry.get(normalizedId);
-  if (!found)
-    return;
-  return {
-    doc: toDocSummary(found),
-    content: String(found.block.body ?? "")
-  };
-}
-function getDocByRoute(routes, routePath) {
-  const normalizedPath = normalizeRoute(routePath);
-  const found = routes.find((route) => normalizeRoute(route.route) === normalizedPath);
-  if (!found)
-    return;
-  return {
-    doc: toDocSummary(found),
-    content: String(found.block.body ?? "")
-  };
-}
-function listDocFacets(routes) {
-  const tags = new Map;
-  const kinds = new Map;
-  const visibilities = new Map;
-  for (const route of routes) {
-    const kind = route.block.kind ?? "reference";
-    const visibility = route.block.visibility ?? "public";
-    kinds.set(kind, (kinds.get(kind) ?? 0) + 1);
-    visibilities.set(visibility, (visibilities.get(visibility) ?? 0) + 1);
-    for (const tag of route.block.tags ?? []) {
-      tags.set(tag, (tags.get(tag) ?? 0) + 1);
-    }
-  }
-  const toEntries = (values, key) => [...values.entries()].sort((left, right) => right[1] - left[1] || left[0].localeCompare(right[0])).map(([value, count]) => ({ [key]: value, count }));
-  return {
-    totalDocs: routes.length,
-    tags: toEntries(tags, "tag"),
-    kinds: toEntries(kinds, "kind"),
-    visibilities: toEntries(visibilities, "visibility")
-  };
-}
-
-// src/features/contracts-registry.ts
-import {
-  EventRegistry,
-  OperationSpecRegistry
-} from "@contractspec/lib.contracts-spec";
-import {
-  DataViewRegistry
-} from "@contractspec/lib.contracts-spec/data-views";
-import {
-  ContractReferenceDataView,
-  ContractReferenceQuery,
-  DocsGenerateCommand,
-  DocsGeneratedEvent,
-  DocsIndexDataView,
-  DocsIndexQuery,
-  DocsLayoutPresentation,
-  DocsPublishCommand,
-  DocsPublishedEvent,
-  DocsReferencePagePresentation,
-  DocsSearchForm,
-  ExampleCatalogDataView
-} from "@contractspec/lib.contracts-spec/docs";
-import { FormRegistry } from "@contractspec/lib.contracts-spec/forms";
-import {
-  PresentationRegistry
-} from "@contractspec/lib.contracts-spec/presentations";
-import {
-  serializeDataViewSpec,
-  serializeEventSpec,
-  serializeFormSpec,
-  serializeOperationSpec,
-  serializePresentationSpec
-} from "@contractspec/lib.contracts-spec/serialization";
-var operationRegistry = null;
-function createContractSpecOperationRegistry() {
-  const registry = new OperationSpecRegistry;
-  registry.register(DocsIndexQuery).register(ContractReferenceQuery).register(DocsGenerateCommand).register(DocsPublishCommand);
-  return registry;
-}
-function getContractSpecOperationRegistry() {
-  if (!operationRegistry) {
-    operationRegistry = createContractSpecOperationRegistry();
-  }
-  return operationRegistry;
-}
-function resolveOperationSpec(key, version) {
-  return getContractSpecOperationRegistry().get(key, version);
-}
-var eventRegistry = null;
-function createContractSpecEventRegistry() {
-  const registry = new EventRegistry;
-  registry.register(DocsGeneratedEvent).register(DocsPublishedEvent);
-  return registry;
-}
-function getContractSpecEventRegistry() {
-  if (!eventRegistry) {
-    eventRegistry = createContractSpecEventRegistry();
-  }
-  return eventRegistry;
-}
-function resolveEventSpec(key, version) {
-  return getContractSpecEventRegistry().get(key, version);
-}
-var presentationRegistry = null;
-function createContractSpecPresentationRegistry() {
-  const registry = new PresentationRegistry;
-  registry.register(DocsLayoutPresentation).register(DocsReferencePagePresentation);
-  return registry;
-}
-function getContractSpecPresentationRegistry() {
-  if (!presentationRegistry) {
-    presentationRegistry = createContractSpecPresentationRegistry();
-  }
-  return presentationRegistry;
-}
-function resolvePresentationSpec(key, version) {
-  return getContractSpecPresentationRegistry().get(key, version);
-}
-var dataViewRegistry = null;
-function createContractSpecDataViewRegistry() {
-  const registry = new DataViewRegistry;
-  registry.register(DocsIndexDataView).register(ContractReferenceDataView).register(ExampleCatalogDataView);
-  return registry;
-}
-function getContractSpecDataViewRegistry() {
-  if (!dataViewRegistry) {
-    dataViewRegistry = createContractSpecDataViewRegistry();
-  }
-  return dataViewRegistry;
-}
-function resolveDataViewSpec(key, version) {
-  return getContractSpecDataViewRegistry().get(key, version);
-}
-var formRegistry = null;
-function createContractSpecFormRegistry() {
-  const registry = new FormRegistry;
-  registry.register(DocsSearchForm);
-  return registry;
-}
-function getContractSpecFormRegistry() {
-  if (!formRegistry) {
-    formRegistry = createContractSpecFormRegistry();
-  }
-  return formRegistry;
-}
-function resolveFormSpec(key, _version) {
-  return getContractSpecFormRegistry().get(key);
-}
-function resolveSerializedOperationSpec(key, version) {
-  const spec = resolveOperationSpec(key, version);
-  return serializeOperationSpec(spec) ?? undefined;
-}
-function resolveSerializedEventSpec(key, version) {
-  const spec = resolveEventSpec(key, version);
-  return serializeEventSpec(spec) ?? undefined;
-}
-function resolveSerializedPresentationSpec(key, version) {
-  const spec = resolvePresentationSpec(key, version);
-  return serializePresentationSpec(spec) ?? undefined;
-}
-function resolveSerializedDataViewSpec(key, version) {
-  const spec = resolveDataViewSpec(key, version);
-  return serializeDataViewSpec(spec) ?? undefined;
-}
-function resolveSerializedFormSpec(key, version) {
-  const spec = resolveFormSpec(key, version);
-  return serializeFormSpec(spec) ?? undefined;
-}
-function resetContractSpecOperationRegistry() {
-  operationRegistry = null;
-}
-function resetContractSpecEventRegistry() {
-  eventRegistry = null;
-}
-function resetContractSpecPresentationRegistry() {
-  presentationRegistry = null;
-}
-function resetContractSpecDataViewRegistry() {
-  dataViewRegistry = null;
-}
-function resetContractSpecFormRegistry() {
-  formRegistry = null;
-}
-function resetAllContractSpecRegistries() {
-  resetContractSpecOperationRegistry();
-  resetContractSpecEventRegistry();
-  resetContractSpecPresentationRegistry();
-  resetContractSpecDataViewRegistry();
-  resetContractSpecFormRegistry();
-}
-
-// src/application/mcp/docsMcp.reference.ts
-import { defaultDocRegistry as defaultDocRegistry2 } from "@contractspec/lib.contracts-spec/docs";
-function normalizeText2(value) {
-  return value?.trim().toLowerCase() ?? "";
-}
-function routeFromDocIds(docIds) {
-  for (const docId of docIds ?? []) {
-    const doc = defaultDocRegistry2.get(docId);
-    if (doc)
-      return doc.route;
-  }
-  return;
-}
-function toReference(spec, type, schema, policy) {
-  const title = spec.meta.title ?? spec.meta.key;
-  const route = routeFromDocIds(spec.meta.docId);
-  const description = spec.meta.description;
-  return {
-    key: spec.meta.key,
-    version: spec.meta.version,
-    type,
-    title,
-    description,
-    markdown: [
-      `# ${title}`,
-      `- Key: ${spec.meta.key}`,
-      `- Type: ${type}`,
-      `- Version: ${spec.meta.version}`,
-      route ? `- Docs route: ${route}` : "",
-      description ? `
-${description}` : ""
-    ].filter(Boolean).join(`
-`),
-    ...route ? { route } : {},
-    ...schema ? { schema } : {},
-    ...policy ? { policy } : {},
-    tags: spec.meta.tags ?? [],
-    owners: spec.meta.owners ?? [],
-    stability: spec.meta.stability
-  };
-}
-function resolveContractReference(args) {
-  const includeSchema = args.includeSchema ?? false;
-  const requestedType = normalizeText2(args.type);
-  const operation = resolveOperationSpec(args.key, args.version);
-  if (operation && (!requestedType || requestedType === "operation" || requestedType === operation.meta.kind)) {
-    return {
-      reference: toReference(operation, operation.meta.kind, includeSchema ? resolveSerializedOperationSpec(args.key, args.version) : undefined, operation.policy)
-    };
-  }
-  const resolvers = [
-    {
-      type: "data-view",
-      spec: resolveDataViewSpec(args.key, args.version),
-      schema: includeSchema ? resolveSerializedDataViewSpec(args.key, args.version) : undefined
-    },
-    {
-      type: "form",
-      spec: resolveFormSpec(args.key, args.version),
-      schema: includeSchema ? resolveSerializedFormSpec(args.key, args.version) : undefined
-    },
-    {
-      type: "presentation",
-      spec: resolvePresentationSpec(args.key, args.version),
-      schema: includeSchema ? resolveSerializedPresentationSpec(args.key, args.version) : undefined
-    },
-    {
-      type: "event",
-      spec: resolveEventSpec(args.key, args.version),
-      schema: includeSchema ? resolveSerializedEventSpec(args.key, args.version) : undefined
-    }
-  ];
-  for (const candidate of resolvers) {
-    if (candidate.spec && (!requestedType || requestedType === candidate.type)) {
-      return {
-        reference: toReference(candidate.spec, candidate.type, candidate.schema)
-      };
-    }
-  }
-  throw new Error(`Contract reference not found: ${args.key}`);
-}
-export {
-  toDocSummary,
-  searchDocs,
-  resolveContractReference,
-  listDocFacets,
-  getDocByRoute,
-  getDocById
-};
+import{defaultDocRegistry as p}from"@contractspec/lib.contracts-spec/docs";var k=20,y=100;function $(j){return j?.trim().toLowerCase()??""}function P(j){let w=decodeURIComponent(j).trim();if(!w)return"/";return w.startsWith("/")?w:`/${w}`}function d(j){return(Array.isArray(j)?j:j?[j]:[]).map((B)=>$(B)).filter(Boolean)}function u(j){if(!j||Number.isNaN(j))return k;return Math.min(Math.max(j,1),y)}function l(j){if(!j||Number.isNaN(j))return 0;return Math.max(j,0)}function _({block:j,route:w}){return{id:j.id,title:j.title,summary:j.summary??"",route:w,visibility:j.visibility??"public",kind:j.kind??"reference",version:j.version??"1.0.0",tags:j.tags??[]}}function n(j,w){if(!w)return 1;let B=w.split(/\s+/).filter(Boolean),H=$(j.block.title),N=$(j.block.id),J=$(j.block.summary),Z=$(j.block.body),W=$(j.route),Y=(j.block.tags??[]).map((G)=>$(G)),K=[H,N,J,Z,W,...Y].join(" ");if(B.some((G)=>!K.includes(G)))return 0;let C=0;for(let G of B){if(N.includes(G))C+=8;if(H.includes(G))C+=7;if(Y.some((F)=>F.includes(G)))C+=5;if(J.includes(G))C+=4;if(W.includes(G))C+=3;if(Z.includes(G))C+=2}return C}function bj(j,w){let B=$(typeof w.query==="string"?w.query:void 0),H=d(w.tag),N=$(typeof w.visibility==="string"?w.visibility:void 0),J=$(typeof w.kind==="string"?w.kind:void 0),Z=u(typeof w.limit==="number"?w.limit:void 0),W=l(typeof w.offset==="number"?w.offset:void 0),Y=j.map((G)=>({doc:_(G),score:n(G,B)})).filter(({doc:G,score:F})=>{let b=B?F>0:!0,T=H.length?H.every((v)=>G.tags.some((m)=>$(m).includes(v))):!0,h=N?$(G.visibility)===N:!0,f=J?$(G.kind)===J:!0;return b&&T&&h&&f}).sort((G,F)=>{if(F.score!==G.score)return F.score-G.score;return G.doc.title.localeCompare(F.doc.title)}),K=Y.slice(W,W+Z).map(({doc:G})=>G),C=W+K.length<Y.length?W+K.length:void 0;return{docs:K,items:K,total:Y.length,...C!=null?{nextOffset:C}:{}}}function Tj(j){let w=decodeURIComponent(j),B=p.get(w);if(!B)return;return{doc:_(B),content:String(B.block.body??"")}}function hj(j,w){let B=P(w),H=j.find((N)=>P(N.route)===B);if(!H)return;return{doc:_(H),content:String(H.block.body??"")}}function fj(j){let w=new Map,B=new Map,H=new Map;for(let J of j){let Z=J.block.kind??"reference",W=J.block.visibility??"public";B.set(Z,(B.get(Z)??0)+1),H.set(W,(H.get(W)??0)+1);for(let Y of J.block.tags??[])w.set(Y,(w.get(Y)??0)+1)}let N=(J,Z)=>[...J.entries()].sort((W,Y)=>Y[1]-W[1]||W[0].localeCompare(Y[0])).map(([W,Y])=>({[Z]:W,count:Y}));return{totalDocs:j.length,tags:N(w,"tag"),kinds:N(B,"kind"),visibilities:N(H,"visibility")}}import{EventRegistry as g,OperationSpecRegistry as c}from"@contractspec/lib.contracts-spec";import{DataViewRegistry as i}from"@contractspec/lib.contracts-spec/data-views";import{ContractReferenceDataView as a,ContractReferenceQuery as o,DocsGenerateCommand as t,DocsGeneratedEvent as s,DocsIndexDataView as r,DocsIndexQuery as e,DocsLayoutPresentation as jj,DocsPublishCommand as wj,DocsPublishedEvent as Bj,DocsReferencePagePresentation as Gj,DocsSearchForm as Hj,ExampleCatalogDataView as Jj}from"@contractspec/lib.contracts-spec/docs";import{FormRegistry as Nj}from"@contractspec/lib.contracts-spec/forms";import{PresentationRegistry as Wj}from"@contractspec/lib.contracts-spec/presentations";import{serializeDataViewSpec as Yj,serializeEventSpec as Zj,serializeFormSpec as $j,serializeOperationSpec as Cj,serializePresentationSpec as Fj}from"@contractspec/lib.contracts-spec/serialization";var Q=null;function Kj(){let j=new c;return j.register(e).register(o).register(t).register(wj),j}function Qj(){if(!Q)Q=Kj();return Q}function M(j,w){return Qj().get(j,w)}var U=null;function Uj(){let j=new g;return j.register(s).register(Bj),j}function Vj(){if(!U)U=Uj();return U}function O(j,w){return Vj().get(j,w)}var V=null;function Xj(){let j=new Wj;return j.register(jj).register(Gj),j}function Aj(){if(!V)V=Xj();return V}function L(j,w){return Aj().get(j,w)}var X=null;function _j(){let j=new i;return j.register(r).register(a).register(Jj),j}function Mj(){if(!X)X=_j();return X}function R(j,w){return Mj().get(j,w)}var A=null;function Oj(){let j=new Nj;return j.register(Hj),j}function Lj(){if(!A)A=Oj();return A}function E(j,w){return Lj().get(j)}function D(j,w){let B=M(j,w);return Cj(B)??void 0}function I(j,w){let B=O(j,w);return Zj(B)??void 0}function q(j,w){let B=L(j,w);return Fj(B)??void 0}function S(j,w){let B=R(j,w);return Yj(B)??void 0}function x(j,w){let B=E(j,w);return $j(B)??void 0}function Rj(){Q=null}function Ej(){U=null}function Pj(){V=null}function Dj(){X=null}function Ij(){A=null}function lj(){Rj(),Ej(),Pj(),Dj(),Ij()}import{defaultDocRegistry as qj}from"@contractspec/lib.contracts-spec/docs";function Sj(j){return j?.trim().toLowerCase()??""}function xj(j){for(let w of j??[]){let B=qj.get(w);if(B)return B.route}return}function z(j,w,B,H){let N=j.meta.title??j.meta.key,J=xj(j.meta.docId),Z=j.meta.description;return{key:j.meta.key,version:j.meta.version,type:w,title:N,description:Z,markdown:[`# ${N}`,`- Key: ${j.meta.key}`,`- Type: ${w}`,`- Version: ${j.meta.version}`,J?`- Docs route: ${J}`:"",Z?`
+${Z}`:""].filter(Boolean).join(`
+`),...J?{route:J}:{},...B?{schema:B}:{},...H?{policy:H}:{},tags:j.meta.tags??[],owners:j.meta.owners??[],stability:j.meta.stability}}function ij(j){let w=j.includeSchema??!1,B=Sj(j.type),H=M(j.key,j.version);if(H&&(!B||B==="operation"||B===H.meta.kind))return{reference:z(H,H.meta.kind,w?D(j.key,j.version):void 0,H.policy)};let N=[{type:"data-view",spec:R(j.key,j.version),schema:w?S(j.key,j.version):void 0},{type:"form",spec:E(j.key,j.version),schema:w?x(j.key,j.version):void 0},{type:"presentation",spec:L(j.key,j.version),schema:w?q(j.key,j.version):void 0},{type:"event",spec:O(j.key,j.version),schema:w?I(j.key,j.version):void 0}];for(let J of N)if(J.spec&&(!B||B===J.type))return{reference:z(J.spec,J.type,J.schema)};throw Error(`Contract reference not found: ${j.key}`)}export{_ as toDocSummary,bj as searchDocs,ij as resolveContractReference,fj as listDocFacets,hj as getDocByRoute,Tj as getDocById};