@conform-ed/contracts 0.0.3

package/src/case/v1_1/shared.ts

@@ -0,0 +1,384 @@
+import { z } from "zod";
+
+function strictObject<T extends z.ZodRawShape>(shape: T) {
+  return z.object(shape).strict();
+}
+
+function extensibleEnum<Values extends readonly [string, ...string[]]>(values: Values) {
+  return z.union([z.enum(values), ExtensibleVocabularyValueSchema]);
+}
+
+export const UuidSchema = z
+  .string()
+  .regex(/^[0-9a-f]{8}-[0-9a-f]{4}-[1-5][0-9a-f]{3}-[8-9a-b][0-9a-f]{3}-[0-9a-f]{12}$/u);
+const UriSchema = z.string().regex(/^[a-zA-Z][a-zA-Z0-9+.-]*:.+$/u);
+const DateSchema = z.iso.date();
+export const DateTimeSchema = z.iso.datetime();
+
+export const ExtensionEnumSchema = extensibleEnum;
+
+const ExtensibleVocabularyValueSchema = z.string().regex(/^(ext:)[a-zA-Z0-9.\-_]+$/u);
+
+const ASSOCIATION_TYPES = [
+  "isChildOf",
+  "isPeerOf",
+  "isPartOf",
+  "exactMatchOf",
+  "precedes",
+  "isRelatedTo",
+  "replacedBy",
+  "exemplar",
+  "hasSkillLevel",
+  "isTranslationOf",
+] as const;
+
+const LinkTargetTypeSchema = extensibleEnum(["CASE"]);
+const AssociationTypeSchema = extensibleEnum(ASSOCIATION_TYPES);
+
+export const CFAssociationExtensionSchema = z.record(z.string(), z.unknown());
+export const CFAssociationGroupingExtensionSchema = z.record(z.string(), z.unknown());
+export const CFConceptExtensionSchema = z.record(z.string(), z.unknown());
+export const CFDefinitionExtensionSchema = z.record(z.string(), z.unknown());
+export const CFDocumentExtensionSchema = z.record(z.string(), z.unknown());
+export const CFItemExtensionSchema = z.record(z.string(), z.unknown());
+export const CFItemTypeExtensionSchema = z.record(z.string(), z.unknown());
+export const CFLicenseExtensionSchema = z.record(z.string(), z.unknown());
+export const CFPackageExtensionSchema = z.record(z.string(), z.unknown());
+export const CFRubricExtensionSchema = z.record(z.string(), z.unknown());
+export const CFRubricCriterionExtensionSchema = z.record(z.string(), z.unknown());
+export const CFRubricCriterionLevelExtensionSchema = z.record(z.string(), z.unknown());
+export const CFSubjectExtensionSchema = z.record(z.string(), z.unknown());
+
+export const LinkUriSchema = strictObject({
+  title: z.string(),
+  identifier: UuidSchema,
+  uri: UriSchema,
+});
+
+export const LinkGenUriSchema = strictObject({
+  title: z.string(),
+  identifier: z.string(),
+  uri: UriSchema,
+  targetType: LinkTargetTypeSchema.optional(),
+});
+
+export const CFConceptSchema = strictObject({
+  identifier: UuidSchema,
+  uri: UriSchema,
+  title: z.string(),
+  keywords: z.string().optional(),
+  hierarchyCode: z.string(),
+  description: z.string().optional(),
+  lastChangeDateTime: DateTimeSchema,
+  extensions: CFConceptExtensionSchema.optional(),
+});
+
+export const CFConceptSetSchema = strictObject({
+  CFConcepts: z.array(CFConceptSchema),
+});
+
+export const CFSubjectSchema = strictObject({
+  identifier: UuidSchema,
+  uri: UriSchema,
+  title: z.string(),
+  hierarchyCode: z.string(),
+  description: z.string().optional(),
+  lastChangeDateTime: DateTimeSchema,
+  extensions: CFSubjectExtensionSchema.optional(),
+});
+
+export const CFSubjectSetSchema = strictObject({
+  CFSubjects: z.array(CFSubjectSchema),
+});
+
+export const CFLicenseSchema = strictObject({
+  identifier: UuidSchema,
+  uri: UriSchema,
+  title: z.string(),
+  description: z.string().optional(),
+  licenseText: z.string(),
+  lastChangeDateTime: DateTimeSchema,
+  extensions: CFLicenseExtensionSchema.optional(),
+});
+
+export const CFItemTypeSchema = strictObject({
+  identifier: UuidSchema,
+  uri: UriSchema,
+  title: z.string(),
+  description: z.string(),
+  hierarchyCode: z.string(),
+  typeCode: z.string().optional(),
+  lastChangeDateTime: DateTimeSchema,
+  extensions: CFItemTypeExtensionSchema.optional(),
+});
+
+export const CFItemTypeSetSchema = strictObject({
+  CFItemTypes: z.array(CFItemTypeSchema),
+});
+
+export const CFAssociationGroupingSchema = strictObject({
+  identifier: UuidSchema,
+  uri: UriSchema,
+  title: z.string(),
+  description: z.string().optional(),
+  lastChangeDateTime: DateTimeSchema,
+  extensions: CFAssociationGroupingExtensionSchema.optional(),
+});
+
+export const CFAssociationSchema = strictObject({
+  identifier: UuidSchema,
+  associationType: AssociationTypeSchema,
+  sequenceNumber: z.number().int().optional(),
+  uri: UriSchema,
+  originNodeURI: LinkGenUriSchema,
+  destinationNodeURI: LinkGenUriSchema,
+  CFAssociationGroupingURI: LinkUriSchema.optional(),
+  lastChangeDateTime: DateTimeSchema,
+  notes: z.string().optional(),
+  extensions: CFAssociationExtensionSchema.optional(),
+  CFDocumentURI: LinkUriSchema.optional(),
+});
+
+export const CFPckgAssociationSchema = strictObject({
+  identifier: UuidSchema,
+  associationType: AssociationTypeSchema,
+  sequenceNumber: z.number().int().optional(),
+  uri: UriSchema,
+  originNodeURI: LinkGenUriSchema,
+  destinationNodeURI: LinkGenUriSchema,
+  CFAssociationGroupingURI: LinkUriSchema.optional(),
+  lastChangeDateTime: DateTimeSchema,
+  notes: z.string().optional(),
+  extensions: CFAssociationExtensionSchema.optional(),
+});
+
+export const CFPckgDocumentSchema = strictObject({
+  identifier: UuidSchema,
+  uri: UriSchema,
+  frameworkType: z.string().optional(),
+  caseVersion: z.literal("1.1").optional(),
+  creator: z.string(),
+  title: z.string(),
+  lastChangeDateTime: DateTimeSchema,
+  officialSourceURL: UriSchema.optional(),
+  publisher: z.string().optional(),
+  description: z.string().optional(),
+  subject: z.array(z.string()).optional(),
+  subjectURI: z.array(LinkUriSchema).optional(),
+  language: z.string().optional(),
+  version: z.string().optional(),
+  adoptionStatus: z.string().optional(),
+  statusStartDate: DateSchema.optional(),
+  statusEndDate: DateSchema.optional(),
+  licenseURI: LinkUriSchema.optional(),
+  notes: z.string().optional(),
+  extensions: CFDocumentExtensionSchema.optional(),
+});
+
+export const CFDocumentSchema = strictObject({
+  identifier: UuidSchema,
+  uri: UriSchema,
+  frameworkType: z.string().optional(),
+  caseVersion: z.literal("1.1").optional(),
+  creator: z.string(),
+  title: z.string(),
+  lastChangeDateTime: DateTimeSchema,
+  officialSourceURL: UriSchema.optional(),
+  publisher: z.string().optional(),
+  description: z.string().optional(),
+  subject: z.array(z.string()).optional(),
+  subjectURI: z.array(LinkUriSchema).optional(),
+  language: z.string().optional(),
+  version: z.string().optional(),
+  adoptionStatus: z.string().optional(),
+  statusStartDate: DateSchema.optional(),
+  statusEndDate: DateSchema.optional(),
+  licenseURI: LinkUriSchema.optional(),
+  notes: z.string().optional(),
+  extensions: CFDocumentExtensionSchema.optional(),
+  CFPackageURI: LinkUriSchema,
+});
+
+export const CFDocumentSetSchema = strictObject({
+  CFDocuments: z.array(CFDocumentSchema),
+});
+
+export const CFPckgItemSchema = strictObject({
+  identifier: UuidSchema,
+  fullStatement: z.string(),
+  alternativeLabel: z.string().optional(),
+  CFItemType: z.string().optional(),
+  uri: UriSchema,
+  humanCodingScheme: z.string().optional(),
+  listEnumeration: z.string().optional(),
+  abbreviatedStatement: z.string().optional(),
+  conceptKeywords: z.array(z.string()).optional(),
+  conceptKeywordsURI: LinkUriSchema.optional(),
+  notes: z.string().optional(),
+  subject: z.array(z.string()).optional(),
+  subjectURI: z.array(LinkUriSchema).optional(),
+  language: z.string().optional(),
+  educationLevel: z.array(z.string()).optional(),
+  CFItemTypeURI: LinkUriSchema.optional(),
+  licenseURI: LinkUriSchema.optional(),
+  statusStartDate: DateSchema.optional(),
+  statusEndDate: DateSchema.optional(),
+  lastChangeDateTime: DateTimeSchema,
+  extensions: CFItemExtensionSchema.optional(),
+});
+
+export const CFItemSchema = strictObject({
+  identifier: UuidSchema,
+  fullStatement: z.string(),
+  alternativeLabel: z.string().optional(),
+  CFItemType: z.string().optional(),
+  uri: UriSchema,
+  humanCodingScheme: z.string().optional(),
+  listEnumeration: z.string().optional(),
+  abbreviatedStatement: z.string().optional(),
+  conceptKeywords: z.array(z.string()).optional(),
+  conceptKeywordsURI: LinkUriSchema.optional(),
+  notes: z.string().optional(),
+  subject: z.array(z.string()).optional(),
+  subjectURI: z.array(LinkUriSchema).optional(),
+  language: z.string().optional(),
+  educationLevel: z.array(z.string()).optional(),
+  CFItemTypeURI: LinkUriSchema.optional(),
+  licenseURI: LinkUriSchema.optional(),
+  statusStartDate: DateSchema.optional(),
+  statusEndDate: DateSchema.optional(),
+  lastChangeDateTime: DateTimeSchema,
+  extensions: CFItemExtensionSchema.optional(),
+  CFDocumentURI: LinkUriSchema,
+});
+
+export const CFAssociationSetSchema = strictObject({
+  CFItem: CFItemSchema,
+  CFAssociations: z.array(CFPckgAssociationSchema),
+});
+
+export const CFRubricCriterionLevelSchema = strictObject({
+  identifier: UuidSchema,
+  uri: UriSchema,
+  description: z.string().optional(),
+  quality: z.string().optional(),
+  score: z.number().optional(),
+  feedback: z.string().optional(),
+  position: z.number().int().optional(),
+  rubricCriterionId: UuidSchema.optional(),
+  lastChangeDateTime: DateTimeSchema,
+  extensions: z.array(CFRubricCriterionLevelExtensionSchema).optional(),
+});
+
+export const CFRubricCriterionSchema = strictObject({
+  identifier: UuidSchema,
+  uri: UriSchema,
+  category: z.string().optional(),
+  description: z.string().optional(),
+  CFItemURI: LinkUriSchema.optional(),
+  weight: z.number().optional(),
+  position: z.number().int().optional(),
+  rubricId: UuidSchema.optional(),
+  lastChangeDateTime: DateTimeSchema,
+  CFRubricCriterionLevels: z.array(CFRubricCriterionLevelSchema).optional(),
+  extensions: CFRubricCriterionExtensionSchema.optional(),
+});
+
+export const CFRubricSchema = strictObject({
+  identifier: UuidSchema,
+  uri: UriSchema,
+  title: z.string().optional(),
+  description: z.string().optional(),
+  lastChangeDateTime: DateTimeSchema,
+  CFRubricCriteria: z.array(CFRubricCriterionSchema).optional(),
+  extensions: CFRubricExtensionSchema.optional(),
+});
+
+export const CFDefinitionSchema = strictObject({
+  CFConcepts: z.array(CFConceptSchema).optional(),
+  CFSubjects: z.array(CFSubjectSchema).optional(),
+  CFLicenses: z.array(CFLicenseSchema).optional(),
+  CFItemTypes: z.array(CFItemTypeSchema).optional(),
+  CFAssociationGroupings: z.array(CFAssociationGroupingSchema).optional(),
+  extensions: CFDefinitionExtensionSchema.optional(),
+});
+
+export const CFPackageSchema = strictObject({
+  CFDocument: CFPckgDocumentSchema,
+  CFItems: z.array(CFPckgItemSchema).optional(),
+  CFAssociations: z.array(CFPckgAssociationSchema).optional(),
+  CFDefinitions: CFDefinitionSchema.optional(),
+  CFRubrics: z.array(CFRubricSchema).optional(),
+  extensions: CFPackageExtensionSchema.optional(),
+});
+
+export const ImsxCodeMinorFieldSchema = strictObject({
+  imsx_codeMinorFieldName: z.string(),
+  imsx_codeMinorFieldValue: z.enum([
+    "forbidden",
+    "fullsuccess",
+    "internal_server_error",
+    "invalid_selection_field",
+    "invalid_sort_field",
+    "invalid_uuid",
+    "server_busy",
+    "unauthorised_request",
+    "unknownobject",
+  ]),
+});
+
+export const ImsxCodeMinorSchema = strictObject({
+  imsx_codeMinorField: z.array(ImsxCodeMinorFieldSchema),
+});
+
+export const ImsxStatusInfoSchema = strictObject({
+  imsx_codeMajor: z.enum(["failure", "processing", "success", "unsupported"]),
+  imsx_severity: z.enum(["error", "status", "warning"]),
+  imsx_description: z.string().optional(),
+  imsx_codeMinor: ImsxCodeMinorSchema.optional(),
+});
+
+export { strictObject };
+// Inferred types from exported Zod validators.
+export type Uuid = z.infer<typeof UuidSchema>;
+export type DateTime = z.infer<typeof DateTimeSchema>;
+export type ExtensionEnum = z.infer<typeof ExtensionEnumSchema>;
+export type CFAssociationExtension = z.infer<typeof CFAssociationExtensionSchema>;
+export type CFAssociationGroupingExtension = z.infer<typeof CFAssociationGroupingExtensionSchema>;
+export type CFConceptExtension = z.infer<typeof CFConceptExtensionSchema>;
+export type CFDefinitionExtension = z.infer<typeof CFDefinitionExtensionSchema>;
+export type CFDocumentExtension = z.infer<typeof CFDocumentExtensionSchema>;
+export type CFItemExtension = z.infer<typeof CFItemExtensionSchema>;
+export type CFItemTypeExtension = z.infer<typeof CFItemTypeExtensionSchema>;
+export type CFLicenseExtension = z.infer<typeof CFLicenseExtensionSchema>;
+export type CFPackageExtension = z.infer<typeof CFPackageExtensionSchema>;
+export type CFRubricExtension = z.infer<typeof CFRubricExtensionSchema>;
+export type CFRubricCriterionExtension = z.infer<typeof CFRubricCriterionExtensionSchema>;
+export type CFRubricCriterionLevelExtension = z.infer<typeof CFRubricCriterionLevelExtensionSchema>;
+export type CFSubjectExtension = z.infer<typeof CFSubjectExtensionSchema>;
+export type LinkUri = z.infer<typeof LinkUriSchema>;
+export type LinkGenUri = z.infer<typeof LinkGenUriSchema>;
+export type CFConcept = z.infer<typeof CFConceptSchema>;
+export type CFConceptSet = z.infer<typeof CFConceptSetSchema>;
+export type CFSubject = z.infer<typeof CFSubjectSchema>;
+export type CFSubjectSet = z.infer<typeof CFSubjectSetSchema>;
+export type CFLicense = z.infer<typeof CFLicenseSchema>;
+export type CFItemType = z.infer<typeof CFItemTypeSchema>;
+export type CFItemTypeSet = z.infer<typeof CFItemTypeSetSchema>;
+export type CFAssociationGrouping = z.infer<typeof CFAssociationGroupingSchema>;
+export type CFAssociation = z.infer<typeof CFAssociationSchema>;
+export type CFPckgAssociation = z.infer<typeof CFPckgAssociationSchema>;
+export type CFPckgDocument = z.infer<typeof CFPckgDocumentSchema>;
+export type CFDocument = z.infer<typeof CFDocumentSchema>;
+export type CFDocumentSet = z.infer<typeof CFDocumentSetSchema>;
+export type CFPckgItem = z.infer<typeof CFPckgItemSchema>;
+export type CFItem = z.infer<typeof CFItemSchema>;
+export type CFAssociationSet = z.infer<typeof CFAssociationSetSchema>;
+export type CFRubricCriterionLevel = z.infer<typeof CFRubricCriterionLevelSchema>;
+export type CFRubricCriterion = z.infer<typeof CFRubricCriterionSchema>;
+export type CFRubric = z.infer<typeof CFRubricSchema>;
+export type CFDefinition = z.infer<typeof CFDefinitionSchema>;
+export type CFPackage = z.infer<typeof CFPackageSchema>;
+export type ImsxCodeMinorField = z.infer<typeof ImsxCodeMinorFieldSchema>;
+export type ImsxCodeMinor = z.infer<typeof ImsxCodeMinorSchema>;
+export type ImsxStatusInfo = z.infer<typeof ImsxStatusInfoSchema>;

package/src/cat/v1_0/cat_v1p0_restbinding_operations_schema.ts

@@ -0,0 +1,75 @@
+import { z } from "zod";
+
+import {
+  CreateSectionRequestSchema,
+  CreateSectionResponseSchema,
+  GetSectionResponseSchema,
+  CreateSessionRequestSchema,
+  CreateSessionResponseSchema,
+  SubmitResultsRequestSchema,
+  SubmitResultsResponseSchema,
+  EndSessionRequestSchema,
+  EndSessionResponseSchema,
+  EndSectionRequestSchema,
+  EndSectionResponseSchema,
+  ErrorResponseSchema,
+} from "./shared";
+
+const EmptyPayloadSchema = z.undefined();
+
+/**
+ * CAT REST Operation Bindings - extracted from CAT v1.0 specification
+ * Each operation defines the HTTP method, path, request payload schema, and response payload schemas.
+ */
+
+export const CatV1P0RestBindingOperations = {
+  createSection: {
+    method: "POST",
+    path: "/sections",
+    requestPayload: CreateSectionRequestSchema,
+    successResponsePayload: CreateSectionResponseSchema,
+    errorResponsePayload: ErrorResponseSchema,
+  },
+
+  getSection: {
+    method: "GET",
+    path: "/sections/{sectionId}",
+    requestPayload: EmptyPayloadSchema,
+    successResponsePayload: GetSectionResponseSchema,
+    errorResponsePayload: ErrorResponseSchema,
+  },
+
+  createSession: {
+    method: "POST",
+    path: "/sessions",
+    requestPayload: CreateSessionRequestSchema,
+    successResponsePayload: CreateSessionResponseSchema,
+    errorResponsePayload: ErrorResponseSchema,
+  },
+
+  submitResults: {
+    method: "POST",
+    path: "/sessions/{sessionId}/results",
+    requestPayload: SubmitResultsRequestSchema,
+    successResponsePayload: SubmitResultsResponseSchema,
+    errorResponsePayload: ErrorResponseSchema,
+  },
+
+  endSession: {
+    method: "POST",
+    path: "/sessions/{sessionId}/end",
+    requestPayload: EndSessionRequestSchema,
+    successResponsePayload: EndSessionResponseSchema,
+    errorResponsePayload: ErrorResponseSchema,
+  },
+
+  endSection: {
+    method: "POST",
+    path: "/sections/{sectionId}/end",
+    requestPayload: EndSectionRequestSchema,
+    successResponsePayload: EndSectionResponseSchema,
+    errorResponsePayload: ErrorResponseSchema,
+  },
+} as const;
+
+export type CatV1P0Operations = typeof CatV1P0RestBindingOperations;

package/src/cat/v1_0/index.ts

@@ -0,0 +1,124 @@
+import {
+  UuidSchema,
+  DateTimeSchema,
+  ExtensionEnumSchema,
+  OutcomeVariableSchema,
+  ResponseVariableSchema,
+  ItemRefSchema,
+  CatConstraintSchema,
+  ItemPoolSchema,
+  SectionDataSchema,
+  ItemStageSchema,
+  AssessmentResultSchema,
+  CatEngineResultReportSchema,
+  SessionInfoSchema,
+  CreateSectionRequestSchema,
+  CreateSectionResponseSchema,
+  GetSectionRequestSchema,
+  GetSectionResponseSchema,
+  CreateSessionRequestSchema,
+  CreateSessionResponseSchema,
+  SubmitResultsRequestSchema,
+  SubmitResultsResponseSchema,
+  EndSessionRequestSchema,
+  EndSessionResponseSchema,
+  EndSectionRequestSchema,
+  EndSectionResponseSchema,
+  ErrorResponseSchema,
+  OutcomeVariableTypeSchema,
+  OutcomeCardinalitySchema,
+  AssessmentResultTypeSchema,
+} from "./shared";
+import { CatV1P0RestBindingOperations } from "./cat_v1p0_restbinding_operations_schema";
+
+export namespace CatV1_0 {
+  export namespace Schemas {
+    // Request schemas
+    export const CreateSectionRequest = CreateSectionRequestSchema;
+    export const GetSectionRequest = GetSectionRequestSchema;
+    export const CreateSessionRequest = CreateSessionRequestSchema;
+    export const SubmitResultsRequest = SubmitResultsRequestSchema;
+    export const EndSessionRequest = EndSessionRequestSchema;
+    export const EndSectionRequest = EndSectionRequestSchema;
+
+    // Response schemas
+    export const CreateSectionResponse = CreateSectionResponseSchema;
+    export const GetSectionResponse = GetSectionResponseSchema;
+    export const CreateSessionResponse = CreateSessionResponseSchema;
+    export const SubmitResultsResponse = SubmitResultsResponseSchema;
+    export const EndSessionResponse = EndSessionResponseSchema;
+    export const EndSectionResponse = EndSectionResponseSchema;
+
+    // Data type schemas
+    export const OutcomeVariable = OutcomeVariableSchema;
+    export const ResponseVariable = ResponseVariableSchema;
+    export const ItemRef = ItemRefSchema;
+    export const CatConstraint = CatConstraintSchema;
+    export const ItemPool = ItemPoolSchema;
+    export const SectionData = SectionDataSchema;
+    export const ItemStage = ItemStageSchema;
+    export const AssessmentResult = AssessmentResultSchema;
+    export const CatEngineResultReport = CatEngineResultReportSchema;
+    export const SessionInfo = SessionInfoSchema;
+    export const ErrorResponse = ErrorResponseSchema;
+  }
+
+  export namespace Shared {
+    export const Uuid = UuidSchema;
+    export const DateTime = DateTimeSchema;
+    export const ExtensionEnum = ExtensionEnumSchema;
+    export const OutcomeVariableType = OutcomeVariableTypeSchema;
+    export const OutcomeCardinality = OutcomeCardinalitySchema;
+    export const AssessmentResultType = AssessmentResultTypeSchema;
+  }
+
+  export namespace RestBinding {
+    export const Operations = CatV1P0RestBindingOperations;
+  }
+}
+
+export type CatV1_0Schemas = typeof CatV1_0.Schemas;
+
+export const Cat10DerivedZodTemplates = {
+  description: "CAT v1.0 Zod schemas derived from official 1EdTech CAT Specification",
+  specLinks: {
+    main: "https://www.imsglobal.org/spec/cat/v1p0/impl/",
+    errata: "https://www.imsglobal.org/spec/cat/v1p0/errata/",
+  },
+  scope: "Computer Adaptive Testing (CAT) REST API for item selection and delivery delegation",
+  coreEntities: [
+    "SectionData - Adaptive section configuration and item pool",
+    "ItemStage - Set of items to present to candidate",
+    "AssessmentResult - Candidate responses and item processing results",
+    "CatEngineResultReport - CAT engine scoring and recommendations",
+    "SessionInfo - Session state and context",
+  ],
+  restOperations: [
+    "POST /sections - Create adaptive section",
+    "GET /sections/:id - Retrieve section configuration",
+    "POST /sessions - Create new session",
+    "POST /sessions/:id/results - Submit responses and get next items",
+    "POST /sessions/:id/end - Terminate session",
+    "POST /sections/:id/end - Close section",
+  ],
+  designNotes: [
+    "Strict validation (.strict()) enforces exact schema conformance with specification",
+    "Extensible enums support vendor-specific values via ext:* pattern",
+    "UUID validators enforce RFC4122 v1-v5 format compliance",
+    "DateTime validators enforce ISO8601 format with optional timezone",
+    "All request/response payloads are JSON objects (no XML)",
+    "CAT engine treated as black box - input/output contracts standardized, internal algorithms not",
+    "Support for custom parameters allows CAT engines to require engine-specific configuration",
+  ],
+  knownLimitations: [
+    "This version focuses on core 6 operations - may not cover all CAT engine extensions",
+    "Custom parameters are typed as z.record(z.string(), z.unknown()) - consider stricter validation for specific CAT engines",
+    "Item metadata format is flexible (z.record) - specific metadata types not yet standardized",
+  ],
+  futureEnhancements: [
+    "Define standardized CustomParameters interfaces for common CAT engines",
+    "Add ItemMetadata schema for QTI metadata bindings",
+    "Support for QTI Usage Data (Item Statistics) vocabulary",
+    "Support for CSM (Curriculum Standards Mapping) vocabulary",
+  ],
+};