@playcademy/sandbox 0.10.1-beta.2 → 0.10.1-beta.4

package/dist/cli.js

@@ -285,7 +285,7 @@ var init_platform = __esm(() => {
 var PLATFORM_TIMEZONE = "America/New_York";
 
 // ../constants/src/timeback.ts
-var TIMEBACK_GRADES, TIMEBACK_SUBJECTS, ASSESSMENT_PURPOSES, PLAYCADEMY_ASSESSMENT_RESULT_METADATA_VERSION = 1, PLAYCADEMY_ASSESSMENT_CONTRACT_VERSION = 1, PLAYCADEMY_ASSESSMENT_RESULT_METADATA_KEY = "playcademyAssessment", PLAYCADEMY_ASSESSMENT_ITEM_RESULT_METADATA_KEY = "playcademyAssessmentItem", TIMEBACK_ASSESSMENT_REVIEW_REQUEST_LIMITS, TIMEBACK_ORG_SOURCED_ID = "PLAYCADEMY", TIMEBACK_ORG_NAME = "Playcademy Studios", TIMEBACK_ORG_TYPE = "department", TIMEBACK_COURSE_DEFAULTS, TIMEBACK_RESOURCE_DEFAULTS, TIMEBACK_COMPONENT_DEFAULTS, TIMEBACK_COMPONENT_RESOURCE_DEFAULTS, TIMEBACK_ASSESSMENT_RESPONSE_VALUE_MAX_LENGTH = 2048, TIMEBACK_GAME_METRIC_DECIMAL_PLACES, TIMEBACK_GAME_METRIC_COMPARISON_TOLERANCE;
+var TIMEBACK_GRADES, TIMEBACK_SUBJECTS, ASSESSMENT_PURPOSES, PLAYCADEMY_ASSESSMENT_RESULT_METADATA_VERSION = 1, PLAYCADEMY_ASSESSMENT_CONTRACT_VERSION = 2, PLAYCADEMY_ASSESSMENT_RESULT_METADATA_KEY = "playcademyAssessment", PLAYCADEMY_ASSESSMENT_ITEM_RESULT_METADATA_KEY = "playcademyAssessmentItem", TIMEBACK_ASSESSMENT_REVIEW_REQUEST_LIMITS, TIMEBACK_ORG_SOURCED_ID = "PLAYCADEMY", TIMEBACK_ORG_NAME = "Playcademy Studios", TIMEBACK_ORG_TYPE = "department", TIMEBACK_COURSE_DEFAULTS, TIMEBACK_RESOURCE_DEFAULTS, TIMEBACK_COMPONENT_DEFAULTS, TIMEBACK_COMPONENT_RESOURCE_DEFAULTS, TIMEBACK_ASSESSMENT_RESPONSE_VALUE_MAX_LENGTH = 2048, TIMEBACK_GAME_METRIC_DECIMAL_PLACES, TIMEBACK_GAME_METRIC_COMPARISON_TOLERANCE;
 var init_timeback2 = __esm(() => {
   TIMEBACK_GRADES = [-1, 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13];
   TIMEBACK_SUBJECTS = [
@@ -1128,7 +1128,7 @@ var package_default;
 var init_package = __esm(() => {
   package_default = {
     name: "@playcademy/sandbox",
-    version: "0.10.1-beta.2",
+    version: "0.10.1-beta.4",
     description: "Local development server for Playcademy game development",
     type: "module",
     exports: {
@@ -10834,30 +10834,60 @@ function comparePresentationText(left, right) {
   }
   return 0;
 }
+function presentationRandomIndex(seed) {
+  let state = presentationHash(seed);
+  const range = 2 ** 32;
+  return (bound) => {
+    const limit = range - range % bound;
+    let value;
+    do {
+      state = state + 1831565813 >>> 0;
+      let mixed = Math.imul(state ^ state >>> 15, state | 1);
+      mixed ^= mixed + Math.imul(mixed ^ mixed >>> 7, mixed | 61);
+      value = (mixed ^ mixed >>> 14) >>> 0;
+    } while (value >= limit);
+    return value % bound;
+  };
+}
 function presentationChoices(choices, attemptId, itemIdentifier, domain) {
-  const seed = `${attemptId}\x00${itemIdentifier}\x00${domain}\x00`;
-  return [...choices].toSorted((left, right) => {
-    const hashDifference = presentationHash(`${seed}${left.identifier}`) - presentationHash(`${seed}${right.identifier}`);
-    return hashDifference || comparePresentationText(left.identifier, right.identifier);
-  });
+  const randomIndex = presentationRandomIndex(JSON.stringify([attemptId, itemIdentifier, domain]));
+  const movable = choices.filter((choice) => !choice.fixed).toSorted((left, right) => comparePresentationText(left.identifier, right.identifier));
+  for (let index = movable.length - 1;index > 0; index--) {
+    const other = randomIndex(index + 1);
+    [movable[index], movable[other]] = [movable[other], movable[index]];
+  }
+  let next = 0;
+  return choices.map((choice) => choice.fixed ? choice : movable[next++]);
 }
 function assessmentPresentationForAttempt(assessment, attemptId) {
   const items = assessment.items.map((item) => {
     const interactions = item.interactions.map((interaction) => {
-      if (interaction.type === "order" && interaction.shuffle) {
-        return {
-          ...interaction,
-          choices: presentationChoices(interaction.choices, attemptId, item.identifier, `order\x00${interaction.responseIdentifier}`)
-        };
+      if (!("shuffle" in interaction) || !interaction.shuffle) {
+        return interaction;
       }
-      if (interaction.type === "match" && interaction.shuffle) {
-        return {
-          ...interaction,
-          sourceChoices: presentationChoices(interaction.sourceChoices, attemptId, item.identifier, `match-source\x00${interaction.responseIdentifier}`),
-          targetChoices: presentationChoices(interaction.targetChoices, attemptId, item.identifier, `match-target\x00${interaction.responseIdentifier}`)
-        };
+      function shuffled(choices, domain) {
+        return presentationChoices(choices, attemptId, item.identifier, `${domain}\x00${interaction.responseIdentifier}`);
+      }
+      switch (interaction.type) {
+        case "choice":
+        case "inline-choice":
+        case "order": {
+          return {
+            ...interaction,
+            choices: shuffled(interaction.choices, interaction.type)
+          };
+        }
+        case "gap-match": {
+          return { ...interaction, gapTexts: shuffled(interaction.gapTexts, "gap-match") };
+        }
+        case "match": {
+          return {
+            ...interaction,
+            sourceChoices: shuffled(interaction.sourceChoices, "match-source"),
+            targetChoices: shuffled(interaction.targetChoices, "match-target")
+          };
+        }
       }
-      return interaction;
     });
     return { ...item, interactions };
   });
@@ -11002,19 +11032,22 @@ function scorePlatformAssessmentItem(item, responses) {
     isCorrect: verdicts.length > 0 && verdicts.every(Boolean)
   };
 }
+function reviewStandardRef({
+  framework,
+  identifier
+}) {
+  return { framework, identifier };
+}
 function reportReviewRequiredPairUnavailable(review, administeredItemIdentifiers2, report) {
-  if (!review.requireBothQuestions) {
-    return;
-  }
   const administered = new Set(administeredItemIdentifiers2);
   const failures = [];
-  for (const standard of review.standards) {
+  for (const standard of review.standards.filter((entry) => entry.requireBothQuestions)) {
     const key = assessmentStandardRefKey(standard);
     const selected = new Set(review.selections.filter((selection) => assessmentStandardRefKey(selection.standard) === key).map((selection) => selection.itemIdentifier));
     const administeredCount = [...selected].filter((identifier) => administered.has(identifier)).length;
     if (selected.size < 2 || administeredCount === 1) {
       failures.push({
-        standard,
+        standard: reviewStandardRef(standard),
         reason: selected.size < 2 ? "selection_shortage" : "not_administered",
         requiredCount: 2,
         selectedCount: selected.size,
@@ -11057,6 +11090,9 @@ function canonicalRequestStandards(standards) {
   }
   const canonical = new Map;
   for (const input of standards) {
+    if (input.requireBothQuestions !== undefined && typeof input.requireBothQuestions !== "boolean") {
+      throw new Error("review standard requireBothQuestions must be a boolean");
+    }
     const standard = canonicalAssessmentStandardRef(input);
     if (!reviewStandardFieldsWithinLimits(standard)) {
       throw new RangeError(`Review standard fields may contain at most ${TIMEBACK_ASSESSMENT_REVIEW_REQUEST_LIMITS.standardFieldLength} characters`);
@@ -11065,13 +11101,19 @@ function canonicalRequestStandards(standards) {
       throw new Error("Review standards require a framework and identifier");
     }
     const key = assessmentStandardRefKey(standard);
-    if (!canonical.has(key)) {
-      canonical.set(key, standard);
+    if (!canonical.has(key) || input.requireBothQuestions) {
+      canonical.set(key, {
+        ...standard,
+        ...input.requireBothQuestions ? { requireBothQuestions: true } : {}
+      });
     }
   }
-  return [...canonical.values()].toSorted((left, right) => compareCodeUnits(assessmentStandardRefKey(left), assessmentStandardRefKey(right)));
+  return [...canonical.values()];
 }
 function normalizeReviewRequest(request) {
+  if ("requireBothQuestions" in request && request.requireBothQuestions !== undefined) {
+    throw new Error("Set requireBothQuestions on individual review standards, not the review request");
+  }
   const candidateItemsPerStandard = request.candidateItemsPerStandard ?? 1;
   if (!Number.isInteger(candidateItemsPerStandard) || candidateItemsPerStandard <= 0 || candidateItemsPerStandard > TIMEBACK_ASSESSMENT_REVIEW_REQUEST_LIMITS.candidateItemsPerStandard) {
     throw new RangeError(`candidateItemsPerStandard must be a positive integer at most ${TIMEBACK_ASSESSMENT_REVIEW_REQUEST_LIMITS.candidateItemsPerStandard}`);
@@ -11082,20 +11124,20 @@ function normalizeReviewRequest(request) {
   }
   return {
     standards,
-    candidateItemsPerStandard,
-    ...request.requireBothQuestions ? { requireBothQuestions: true } : {}
+    candidateItemsPerStandard
   };
 }
 function reviewRequestFingerprint(request, policy) {
   const normalized = normalizeReviewRequest(request);
+  const requiredStandardKeys = normalized.standards.filter((standard) => standard.requireBothQuestions).map(assessmentStandardRefKey);
   return JSON.stringify({
     kind: "standards-review",
     policy: {
       version: policy.version
     },
     candidateItemsPerStandard: normalized.candidateItemsPerStandard,
-    ...normalized.requireBothQuestions ? { requireBothQuestions: true } : {},
-    standardKeys: normalized.standards.map(assessmentStandardRefKey)
+    standardKeys: normalized.standards.map(assessmentStandardRefKey),
+    ...requiredStandardKeys.length > 0 ? { requiredStandardKeys } : {}
   });
 }
 function reviewQuestionLineItemId(parentLineItemId, itemIdentifier) {
@@ -11321,9 +11363,10 @@ function rankedCandidatesByStandard(bank, exposures) {
   return byStandard;
 }
 function reviewSlots(request) {
-  return request.standards.flatMap((standard) => Array.from({ length: request.candidateItemsPerStandard }, () => ({
-    standard,
-    standardKey: assessmentStandardRefKey(standard)
+  return request.standards.flatMap((standard, servingIndex) => Array.from({ length: request.candidateItemsPerStandard }, () => ({
+    standard: reviewStandardRef(standard),
+    standardKey: assessmentStandardRefKey(standard),
+    servingIndex
   })));
 }
 function matchingCandidates(candidatesByStandard, slotCount) {
@@ -11436,7 +11479,7 @@ function fulfillment(request, candidatesByStandard, selections) {
     const selected = selectedByStandard.get(key) ?? 0;
     return selected < request.candidateItemsPerStandard ? [
       {
-        standard,
+        standard: reviewStandardRef(standard),
         requested: request.candidateItemsPerStandard,
         selected,
         eligible: candidatesByStandard.get(key)?.length ?? 0
@@ -11461,10 +11504,10 @@ function fulfillment(request, candidatesByStandard, selections) {
 function selectReviewItems(input) {
   const request = normalizeReviewRequest(input.request);
   const candidatesByStandard = rankedCandidatesByStandard(input.bank, input.exposures);
-  const slots = reviewSlots(request);
+  const slots = reviewSlots(request).toSorted((left, right) => compareCodeUnits(left.standardKey, right.standardKey));
   const boundedCandidates = matchingCandidates(candidatesByStandard, slots.length);
   const selected = preferredDistinctMatching(slots, boundedCandidates);
-  const selections = [...selected.entries()].toSorted(([left], [right]) => left - right).map(([index, itemIdentifier]) => ({
+  const selections = [...selected.entries()].toSorted(([left], [right]) => slots[left].servingIndex - slots[right].servingIndex || left - right).map(([index, itemIdentifier]) => ({
     standard: slots[index].standard,
     itemIdentifier
   }));
@@ -11603,6 +11646,9 @@ function isAssessmentScore(value) {
 function isAssessmentStandardRef(value) {
   return isRecord(value) && typeof value.framework === "string" && value.framework.length > 0 && typeof value.identifier === "string" && value.identifier.length > 0;
 }
+function isAssessmentReviewStandard(value) {
+  return isRecord(value) && isAssessmentStandardRef(value) && (value.requireBothQuestions === undefined || typeof value.requireBothQuestions === "boolean");
+}
 function isReviewFulfillment(value) {
   if (!isRecord(value) || value.status !== "complete" && value.status !== "partial" || !Number.isInteger(value.requestedItemCount) || !Number.isInteger(value.selectedItemCount) || !Array.isArray(value.shortages)) {
     return false;
@@ -11677,7 +11723,7 @@ function isRoutedDiagnosticAttemptMetadata(value, itemSubmissions, responseVersi
   });
 }
 function isReviewAttemptMetadata(value) {
-  return isRecord(value) && typeof value.requestFingerprint === "string" && typeof value.bankRevision === "string" && Array.isArray(value.standards) && value.standards.every(isAssessmentStandardRef) && Number.isInteger(value.candidateItemsPerStandard) && (value.requireBothQuestions === undefined || typeof value.requireBothQuestions === "boolean") && Array.isArray(value.selections) && value.selections.every((selection) => isRecord(selection) && isAssessmentStandardRef(selection.standard) && typeof selection.itemIdentifier === "string") && isReviewFulfillment(value.fulfillment);
+  return isRecord(value) && typeof value.requestFingerprint === "string" && typeof value.bankRevision === "string" && Array.isArray(value.standards) && value.standards.every(isAssessmentReviewStandard) && Number.isInteger(value.candidateItemsPerStandard) && value.requireBothQuestions === undefined && Array.isArray(value.selections) && value.selections.every((selection) => isRecord(selection) && isAssessmentStandardRef(selection.standard) && typeof selection.itemIdentifier === "string") && isReviewFulfillment(value.fulfillment);
 }
 function isOptionalInteger(value) {
   return value === undefined || Number.isInteger(value);
@@ -11796,6 +11842,7 @@ var init_assessment_runtime2 = __esm(() => {
   init_src();
   init_timeback3();
   init_src();
+  init_src();
   init_uuid();
   init_esm();
   init_src();
@@ -12375,8 +12422,8 @@ var init_assessment_runtime2 = __esm(() => {
     }),
     StartAssessmentBaseSchema.extend({
       purpose: exports_external.literal("review"),
-      requireBothQuestions: exports_external.boolean().optional(),
-      standards: exports_external.array(AssessmentStandardRefSchema2).min(1).max(TIMEBACK_ASSESSMENT_REVIEW_REQUEST_LIMITS.standards),
+      requireBothQuestions: exports_external.never().optional(),
+      standards: exports_external.array(AssessmentStandardRefSchema2.and(exports_external.object({ requireBothQuestions: exports_external.boolean().optional() }))).min(1).max(TIMEBACK_ASSESSMENT_REVIEW_REQUEST_LIMITS.standards),
       candidateItemsPerStandard: exports_external.number().int().positive().max(TIMEBACK_ASSESSMENT_REVIEW_REQUEST_LIMITS.candidateItemsPerStandard).optional()
     }),
     StartAssessmentBaseSchema.extend({
@@ -39193,7 +39240,7 @@ function assertMatchingAssessmentArtifactPair(playable, scoring, expectedIdentit
     throw new ValidationError("Assessment artifact pair does not describe one revision");
   }
 }
-var ASSESSMENT_ARTIFACT_SCHEMA_VERSION = 1, ASSESSMENT_GRADER_PROTOCOL_VERSION = 1, ARTIFACT_KEY_PREFIX = "assessment-artifacts", SHA256_HEX, textEncoder;
+var ASSESSMENT_ARTIFACT_SCHEMA_VERSION = 2, ASSESSMENT_GRADER_PROTOCOL_VERSION = 1, ARTIFACT_KEY_PREFIX = "assessment-artifacts", SHA256_HEX, textEncoder;
 var init_assessment_artifact_envelope_util = __esm(() => {
   init_errors2();
   SHA256_HEX = /^[a-f0-9]{64}$/;
@@ -94287,6 +94334,30 @@ var init_timeback_game_metrics_comparison_util = __esm(() => {
 });
 
 // ../timeback/dist/engines/qti/index.js
+function qtiAttributeNumber(attributes, name3, fallback) {
+  const raw = attributes[name3]?.trim();
+  if (!raw) {
+    return fallback;
+  }
+  const value = Number(raw);
+  return Number.isFinite(value) ? value : fallback;
+}
+function qtiAttributeCapacity(attributes, name3, fallback) {
+  const raw = attributes[name3]?.trim();
+  if (!raw) {
+    return fallback;
+  }
+  const value = Number(raw);
+  return Number.isInteger(value) && value >= 0 ? value : null;
+}
+function qtiAttributeMaximum(attributes, name3, fallback, unlimited) {
+  const maximum = qtiAttributeNumber(attributes, name3, fallback);
+  return maximum === 0 ? unlimited : maximum;
+}
+function qtiAttributeBoolean(attributes, name3) {
+  const value = attributes[name3];
+  return value === "true" || value === "1";
+}
 function decodeCssEscapes(value) {
   return value.replace(/\\([0-9a-fA-F]{1,6})\s?/g, (_, hex3) => {
     const code = Number.parseInt(hex3, 16);
@@ -94874,7 +94945,8 @@ function parseGapTexts(interaction) {
     return {
       identifier: attributes2.identifier || "",
       content: plainTextFromNodes(gapText.children),
-      matchMax: finiteNumber(attributes2["match-max"]) ?? 1
+      matchMax: finiteNumber(attributes2["match-max"]) ?? 1,
+      ...qtiAttributeBoolean(attributes2, "fixed") ? { fixed: true } : {}
     };
   }).filter((gapText) => gapText.identifier);
 }
@@ -95974,30 +96046,6 @@ ${body2}
 ${processing}` : ""}
 </qti-assessment-item>`;
 }
-function qtiAttributeNumber(attributes2, name3, fallback) {
-  const raw = attributes2[name3]?.trim();
-  if (!raw) {
-    return fallback;
-  }
-  const value = Number(raw);
-  return Number.isFinite(value) ? value : fallback;
-}
-function qtiAttributeCapacity(attributes2, name3, fallback) {
-  const raw = attributes2[name3]?.trim();
-  if (!raw) {
-    return fallback;
-  }
-  const value = Number(raw);
-  return Number.isInteger(value) && value >= 0 ? value : null;
-}
-function qtiAttributeMaximum(attributes2, name3, fallback, unlimited) {
-  const maximum = qtiAttributeNumber(attributes2, name3, fallback);
-  return maximum === 0 ? unlimited : maximum;
-}
-function qtiAttributeBoolean(attributes2, name3) {
-  const value = attributes2[name3];
-  return value === "true" || value === "1";
-}
 function gapContentIdentifiers(nodes) {
   return nodes.flatMap((node) => {
     if (node.kind === "gap") {
@@ -96078,6 +96126,7 @@ function authorableQtiInteractionProjection(interaction) {
         type: interaction.type,
         choices: interaction.choices,
         minChoices: qtiAttributeNumber(attributes2, "min-choices", 1),
+        shuffle: qtiAttributeBoolean(attributes2, "shuffle"),
         maxChoices: qtiAttributeMaximum(attributes2, "max-choices", 1, interaction.choices.length)
       };
     }
@@ -96086,6 +96135,7 @@ function authorableQtiInteractionProjection(interaction) {
         ...base,
         type: interaction.type,
         choices: interaction.choices,
+        shuffle: qtiAttributeBoolean(attributes2, "shuffle"),
         blankIndex: interaction.blankIndex ?? 0
       } : null;
     }
@@ -99917,11 +99967,13 @@ var init_assessment_artifact_runtime_util = __esm(() => {
   playableContentNodesSchema = exports_external.array(exports_external.unknown());
   playableChoiceSchema = exports_external.object({
     identifier: trimmedNonEmptyString3,
+    fixed: exports_external.boolean().optional(),
     content: exports_external.string(),
     contentNodes: playableContentNodesSchema.optional()
   }).strict();
   playableMatchChoiceSchema = exports_external.object({
     identifier: trimmedNonEmptyString3,
+    fixed: exports_external.boolean().optional(),
     content: exports_external.string(),
     contentNodes: playableContentNodesSchema.optional(),
     matchMax: nonnegativeInteger
@@ -99941,6 +99993,7 @@ var init_assessment_artifact_runtime_util = __esm(() => {
   }).strict();
   playableGapTextSchema = exports_external.object({
     identifier: trimmedNonEmptyString3,
+    fixed: exports_external.boolean().optional(),
     content: exports_external.string(),
     matchMax: nonnegativeInteger
   }).strict();
@@ -99958,6 +100011,7 @@ var init_assessment_artifact_runtime_util = __esm(() => {
     exports_external.object({
       ...playableInteractionBase,
       type: exports_external.literal("choice"),
+      shuffle: exports_external.boolean(),
       choices: exports_external.array(playableChoiceSchema),
       minChoices: nonnegativeInteger,
       maxChoices: nonnegativeInteger
@@ -99965,6 +100019,7 @@ var init_assessment_artifact_runtime_util = __esm(() => {
     exports_external.object({
       ...playableInteractionBase,
       type: exports_external.literal("inline-choice"),
+      shuffle: exports_external.boolean(),
       choices: exports_external.array(playableChoiceSchema)
     }).strict(),
     exports_external.object({
@@ -100008,6 +100063,7 @@ var init_assessment_artifact_runtime_util = __esm(() => {
     exports_external.object({
       ...playableInteractionBase,
       type: exports_external.literal("gap-match"),
+      shuffle: exports_external.boolean(),
       content: exports_external.string(),
       contentNodes: playableContentNodesSchema,
       gapTexts: exports_external.array(playableGapTextSchema),
@@ -100346,7 +100402,6 @@ function buildConventionalAssessmentSnapshot(input) {
       purpose: metadata2.purpose,
       standards: [...metadata2.review.standards],
       candidateItemsPerStandard: metadata2.review.candidateItemsPerStandard,
-      ...metadata2.review.requireBothQuestions ? { requireBothQuestions: true } : {},
       selections: [...metadata2.review.selections],
       fulfillment: metadata2.review.fulfillment
     };
@@ -100521,6 +100576,7 @@ function playableChoice(choice) {
   return {
     identifier: choice.identifier,
     content: choice.content,
+    ...qtiAttributeBoolean(choice.attributes, "fixed") ? { fixed: true } : {},
     ...choice.contentNodes ? { contentNodes: choice.contentNodes } : {}
   };
 }
@@ -100583,6 +100639,7 @@ function parseInteraction2(questionIdentifier, interaction) {
       responseIdentifier,
       ...prompt,
       choices,
+      shuffle: qtiAttributeBoolean(interaction.attributes, "shuffle"),
       minChoices: qtiAttributeNumber(interaction.attributes, "min-choices", 1),
       maxChoices: qtiAttributeMaximum(interaction.attributes, "max-choices", 1, choices.length)
     };
@@ -100592,7 +100649,8 @@ function parseInteraction2(questionIdentifier, interaction) {
       type,
       responseIdentifier,
       ...prompt,
-      choices: requireChoices2(interaction.choices.map(playableChoice))
+      choices: requireChoices2(interaction.choices.map(playableChoice)),
+      shuffle: qtiAttributeBoolean(interaction.attributes, "shuffle")
     };
   }
   if (type === "text-entry") {
@@ -100653,11 +100711,13 @@ function parseInteraction2(questionIdentifier, interaction) {
       responseIdentifier,
       ...prompt,
       content: interaction.textWithGaps,
+      shuffle: qtiAttributeBoolean(interaction.attributes, "shuffle"),
       contentNodes: interaction.gapContent,
       gapTexts: interaction.gapTexts.map((gapText) => ({
         identifier: gapText.identifier,
         content: gapText.content,
-        matchMax: gapText.matchMax
+        matchMax: gapText.matchMax,
+        ...gapText.fixed ? { fixed: true } : {}
       })),
       gaps: [...interaction.gaps],
       maxAssociations: qtiAttributeNumber(interaction.attributes, "max-associations", 0)
@@ -101476,7 +101536,7 @@ function buildInlineChoiceQuestionXml(input, identifier, title) {
   if (!envelope) {
     return null;
   }
-  const { structure, responseIdentifier, prompt } = envelope;
+  const { interaction, structure, responseIdentifier, prompt } = envelope;
   const promptParts = prompt.split(INLINE_CHOICE_BLANK);
   if (promptParts.length !== 2) {
     throw new ValidationError("Inline-choice questions require exactly one blank");
@@ -101490,7 +101550,7 @@ function buildInlineChoiceQuestionXml(input, identifier, title) {
   const choicesXml = choices.map((choice) => `        <qti-inline-choice identifier="${escapeXml(choice.identifier)}">${escapeXml(choice.content)}</qti-inline-choice>`).join(`
 `);
   const [before = "", after = ""] = promptParts;
-  const itemBody = `    <p>${escapeXml(before)}<qti-inline-choice-interaction response-identifier="${escapeXml(responseIdentifier)}">
+  const itemBody = `    <p>${escapeXml(before)}<qti-inline-choice-interaction response-identifier="${escapeXml(responseIdentifier)}" shuffle="${interaction.shuffle === true}">
 ${choicesXml}
       </qti-inline-choice-interaction>${escapeXml(after)}</p>`;
   return buildExactMatchQuestionXml({
@@ -102105,7 +102165,7 @@ async function prepareReviewMappingUpdate(test, questions) {
   const contentRevision = await assessmentContentRevision(test, questions);
   const assessment = {
     identifier: test.identifier,
-    contractVersion: 1,
+    contractVersion: PLAYCADEMY_ASSESSMENT_CONTRACT_VERSION,
     contentRevision,
     title: test.title,
     items: questions.questions.map(({ question }) => ({
@@ -102144,6 +102204,7 @@ async function prepareReviewMappingUpdate(test, questions) {
 var PLAYCADEMY_REVIEW_BANK_TITLE = "Review Bank", PLAYCADEMY_REVIEW_BANK_SINK_METADATA_KEY = "playcademyReviewBankSink", PLAYCADEMY_REVIEW_BANK_SINK_VERSION = 1, StoredSinkWarningSchema, ReviewBankSinkMarkerSchema;
 var init_timeback_review_mapping_util = __esm(() => {
   init_esm();
+  init_src();
   init_assessment_runtime2();
   init_qti();
   init_timeback3();
@@ -102818,13 +102879,11 @@ function buildPreparedAssessmentMetadata(plan, timestamp6, testName) {
       review: {
         requestFingerprint: reviewRequestFingerprint({
           standards: plan.review.standards,
-          candidateItemsPerStandard: plan.review.candidateItemsPerStandard,
-          requireBothQuestions: plan.review.requireBothQuestions
+          candidateItemsPerStandard: plan.review.candidateItemsPerStandard
         }, DEFAULT_REVIEW_SELECTION_POLICY),
         bankRevision: plan.review.bankRevision,
         standards: plan.review.standards,
         candidateItemsPerStandard: plan.review.candidateItemsPerStandard,
-        ...plan.review.requireBothQuestions ? { requireBothQuestions: true } : {},
         selections: plan.review.selections,
         fulfillment: plan.review.fulfillment
       }
@@ -104007,7 +104066,6 @@ var init_timeback_assessment_runtime_service = __esm(async () => {
           bankRevision: catalog.bank.bankRevision,
           standards: [...normalized.standards],
           candidateItemsPerStandard: normalized.candidateItemsPerStandard,
-          ...normalized.requireBothQuestions ? { requireBothQuestions: true } : {},
           selections: [...selected.selections],
           fulfillment: selected.fulfillment
         }
@@ -104279,7 +104337,6 @@ var init_timeback_assessment_runtime_service = __esm(async () => {
             bankRevision: source.bank.bankRevision,
             standards: [...normalizedRequest.standards],
             candidateItemsPerStandard: normalizedRequest.candidateItemsPerStandard,
-            ...normalizedRequest.requireBothQuestions ? { requireBothQuestions: true } : {},
             selections: [...selected.selections],
             fulfillment: selected.fulfillment
           }

package/dist/constants.js

@@ -100,7 +100,7 @@ var init_platform = __esm(() => {
 var PLATFORM_TIMEZONE = "America/New_York";
 
 // ../constants/src/timeback.ts
-var TIMEBACK_GRADES, TIMEBACK_SUBJECTS, ASSESSMENT_PURPOSES, PLAYCADEMY_ASSESSMENT_RESULT_METADATA_VERSION = 1, PLAYCADEMY_ASSESSMENT_CONTRACT_VERSION = 1, PLAYCADEMY_ASSESSMENT_RESULT_METADATA_KEY = "playcademyAssessment", PLAYCADEMY_ASSESSMENT_ITEM_RESULT_METADATA_KEY = "playcademyAssessmentItem", TIMEBACK_ASSESSMENT_REVIEW_REQUEST_LIMITS, TIMEBACK_ORG_SOURCED_ID = "PLAYCADEMY", TIMEBACK_ORG_NAME = "Playcademy Studios", TIMEBACK_ORG_TYPE = "department", TIMEBACK_COURSE_DEFAULTS, TIMEBACK_RESOURCE_DEFAULTS, TIMEBACK_COMPONENT_DEFAULTS, TIMEBACK_COMPONENT_RESOURCE_DEFAULTS, TIMEBACK_ASSESSMENT_RESPONSE_VALUE_MAX_LENGTH = 2048, TIMEBACK_GAME_METRIC_DECIMAL_PLACES, TIMEBACK_GAME_METRIC_COMPARISON_TOLERANCE;
+var TIMEBACK_GRADES, TIMEBACK_SUBJECTS, ASSESSMENT_PURPOSES, PLAYCADEMY_ASSESSMENT_RESULT_METADATA_VERSION = 1, PLAYCADEMY_ASSESSMENT_CONTRACT_VERSION = 2, PLAYCADEMY_ASSESSMENT_RESULT_METADATA_KEY = "playcademyAssessment", PLAYCADEMY_ASSESSMENT_ITEM_RESULT_METADATA_KEY = "playcademyAssessmentItem", TIMEBACK_ASSESSMENT_REVIEW_REQUEST_LIMITS, TIMEBACK_ORG_SOURCED_ID = "PLAYCADEMY", TIMEBACK_ORG_NAME = "Playcademy Studios", TIMEBACK_ORG_TYPE = "department", TIMEBACK_COURSE_DEFAULTS, TIMEBACK_RESOURCE_DEFAULTS, TIMEBACK_COMPONENT_DEFAULTS, TIMEBACK_COMPONENT_RESOURCE_DEFAULTS, TIMEBACK_ASSESSMENT_RESPONSE_VALUE_MAX_LENGTH = 2048, TIMEBACK_GAME_METRIC_DECIMAL_PLACES, TIMEBACK_GAME_METRIC_COMPARISON_TOLERANCE;
 var init_timeback = __esm(() => {
   TIMEBACK_GRADES = [-1, 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13];
   TIMEBACK_SUBJECTS = [

package/dist/server.js

@@ -284,7 +284,7 @@ var init_platform = __esm(() => {
 var PLATFORM_TIMEZONE = "America/New_York";
 
 // ../constants/src/timeback.ts
-var TIMEBACK_GRADES, TIMEBACK_SUBJECTS, ASSESSMENT_PURPOSES, PLAYCADEMY_ASSESSMENT_RESULT_METADATA_VERSION = 1, PLAYCADEMY_ASSESSMENT_CONTRACT_VERSION = 1, PLAYCADEMY_ASSESSMENT_RESULT_METADATA_KEY = "playcademyAssessment", PLAYCADEMY_ASSESSMENT_ITEM_RESULT_METADATA_KEY = "playcademyAssessmentItem", TIMEBACK_ASSESSMENT_REVIEW_REQUEST_LIMITS, TIMEBACK_ORG_SOURCED_ID = "PLAYCADEMY", TIMEBACK_ORG_NAME = "Playcademy Studios", TIMEBACK_ORG_TYPE = "department", TIMEBACK_COURSE_DEFAULTS, TIMEBACK_RESOURCE_DEFAULTS, TIMEBACK_COMPONENT_DEFAULTS, TIMEBACK_COMPONENT_RESOURCE_DEFAULTS, TIMEBACK_ASSESSMENT_RESPONSE_VALUE_MAX_LENGTH = 2048, TIMEBACK_GAME_METRIC_DECIMAL_PLACES, TIMEBACK_GAME_METRIC_COMPARISON_TOLERANCE;
+var TIMEBACK_GRADES, TIMEBACK_SUBJECTS, ASSESSMENT_PURPOSES, PLAYCADEMY_ASSESSMENT_RESULT_METADATA_VERSION = 1, PLAYCADEMY_ASSESSMENT_CONTRACT_VERSION = 2, PLAYCADEMY_ASSESSMENT_RESULT_METADATA_KEY = "playcademyAssessment", PLAYCADEMY_ASSESSMENT_ITEM_RESULT_METADATA_KEY = "playcademyAssessmentItem", TIMEBACK_ASSESSMENT_REVIEW_REQUEST_LIMITS, TIMEBACK_ORG_SOURCED_ID = "PLAYCADEMY", TIMEBACK_ORG_NAME = "Playcademy Studios", TIMEBACK_ORG_TYPE = "department", TIMEBACK_COURSE_DEFAULTS, TIMEBACK_RESOURCE_DEFAULTS, TIMEBACK_COMPONENT_DEFAULTS, TIMEBACK_COMPONENT_RESOURCE_DEFAULTS, TIMEBACK_ASSESSMENT_RESPONSE_VALUE_MAX_LENGTH = 2048, TIMEBACK_GAME_METRIC_DECIMAL_PLACES, TIMEBACK_GAME_METRIC_COMPARISON_TOLERANCE;
 var init_timeback2 = __esm(() => {
   TIMEBACK_GRADES = [-1, 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13];
   TIMEBACK_SUBJECTS = [
@@ -1127,7 +1127,7 @@ var package_default;
 var init_package = __esm(() => {
   package_default = {
     name: "@playcademy/sandbox",
-    version: "0.10.1-beta.2",
+    version: "0.10.1-beta.4",
     description: "Local development server for Playcademy game development",
     type: "module",
     exports: {
@@ -10833,30 +10833,60 @@ function comparePresentationText(left, right) {
   }
   return 0;
 }
+function presentationRandomIndex(seed) {
+  let state = presentationHash(seed);
+  const range = 2 ** 32;
+  return (bound) => {
+    const limit = range - range % bound;
+    let value;
+    do {
+      state = state + 1831565813 >>> 0;
+      let mixed = Math.imul(state ^ state >>> 15, state | 1);
+      mixed ^= mixed + Math.imul(mixed ^ mixed >>> 7, mixed | 61);
+      value = (mixed ^ mixed >>> 14) >>> 0;
+    } while (value >= limit);
+    return value % bound;
+  };
+}
 function presentationChoices(choices, attemptId, itemIdentifier, domain) {
-  const seed = `${attemptId}\x00${itemIdentifier}\x00${domain}\x00`;
-  return [...choices].toSorted((left, right) => {
-    const hashDifference = presentationHash(`${seed}${left.identifier}`) - presentationHash(`${seed}${right.identifier}`);
-    return hashDifference || comparePresentationText(left.identifier, right.identifier);
-  });
+  const randomIndex = presentationRandomIndex(JSON.stringify([attemptId, itemIdentifier, domain]));
+  const movable = choices.filter((choice) => !choice.fixed).toSorted((left, right) => comparePresentationText(left.identifier, right.identifier));
+  for (let index = movable.length - 1;index > 0; index--) {
+    const other = randomIndex(index + 1);
+    [movable[index], movable[other]] = [movable[other], movable[index]];
+  }
+  let next = 0;
+  return choices.map((choice) => choice.fixed ? choice : movable[next++]);
 }
 function assessmentPresentationForAttempt(assessment, attemptId) {
   const items = assessment.items.map((item) => {
     const interactions = item.interactions.map((interaction) => {
-      if (interaction.type === "order" && interaction.shuffle) {
-        return {
-          ...interaction,
-          choices: presentationChoices(interaction.choices, attemptId, item.identifier, `order\x00${interaction.responseIdentifier}`)
-        };
+      if (!("shuffle" in interaction) || !interaction.shuffle) {
+        return interaction;
       }
-      if (interaction.type === "match" && interaction.shuffle) {
-        return {
-          ...interaction,
-          sourceChoices: presentationChoices(interaction.sourceChoices, attemptId, item.identifier, `match-source\x00${interaction.responseIdentifier}`),
-          targetChoices: presentationChoices(interaction.targetChoices, attemptId, item.identifier, `match-target\x00${interaction.responseIdentifier}`)
-        };
+      function shuffled(choices, domain) {
+        return presentationChoices(choices, attemptId, item.identifier, `${domain}\x00${interaction.responseIdentifier}`);
+      }
+      switch (interaction.type) {
+        case "choice":
+        case "inline-choice":
+        case "order": {
+          return {
+            ...interaction,
+            choices: shuffled(interaction.choices, interaction.type)
+          };
+        }
+        case "gap-match": {
+          return { ...interaction, gapTexts: shuffled(interaction.gapTexts, "gap-match") };
+        }
+        case "match": {
+          return {
+            ...interaction,
+            sourceChoices: shuffled(interaction.sourceChoices, "match-source"),
+            targetChoices: shuffled(interaction.targetChoices, "match-target")
+          };
+        }
       }
-      return interaction;
     });
     return { ...item, interactions };
   });
@@ -11001,19 +11031,22 @@ function scorePlatformAssessmentItem(item, responses) {
     isCorrect: verdicts.length > 0 && verdicts.every(Boolean)
   };
 }
+function reviewStandardRef({
+  framework,
+  identifier
+}) {
+  return { framework, identifier };
+}
 function reportReviewRequiredPairUnavailable(review, administeredItemIdentifiers2, report) {
-  if (!review.requireBothQuestions) {
-    return;
-  }
   const administered = new Set(administeredItemIdentifiers2);
   const failures = [];
-  for (const standard of review.standards) {
+  for (const standard of review.standards.filter((entry) => entry.requireBothQuestions)) {
     const key = assessmentStandardRefKey(standard);
     const selected = new Set(review.selections.filter((selection) => assessmentStandardRefKey(selection.standard) === key).map((selection) => selection.itemIdentifier));
     const administeredCount = [...selected].filter((identifier) => administered.has(identifier)).length;
     if (selected.size < 2 || administeredCount === 1) {
       failures.push({
-        standard,
+        standard: reviewStandardRef(standard),
         reason: selected.size < 2 ? "selection_shortage" : "not_administered",
         requiredCount: 2,
         selectedCount: selected.size,
@@ -11056,6 +11089,9 @@ function canonicalRequestStandards(standards) {
   }
   const canonical = new Map;
   for (const input of standards) {
+    if (input.requireBothQuestions !== undefined && typeof input.requireBothQuestions !== "boolean") {
+      throw new Error("review standard requireBothQuestions must be a boolean");
+    }
     const standard = canonicalAssessmentStandardRef(input);
     if (!reviewStandardFieldsWithinLimits(standard)) {
       throw new RangeError(`Review standard fields may contain at most ${TIMEBACK_ASSESSMENT_REVIEW_REQUEST_LIMITS.standardFieldLength} characters`);
@@ -11064,13 +11100,19 @@ function canonicalRequestStandards(standards) {
       throw new Error("Review standards require a framework and identifier");
     }
     const key = assessmentStandardRefKey(standard);
-    if (!canonical.has(key)) {
-      canonical.set(key, standard);
+    if (!canonical.has(key) || input.requireBothQuestions) {
+      canonical.set(key, {
+        ...standard,
+        ...input.requireBothQuestions ? { requireBothQuestions: true } : {}
+      });
     }
   }
-  return [...canonical.values()].toSorted((left, right) => compareCodeUnits(assessmentStandardRefKey(left), assessmentStandardRefKey(right)));
+  return [...canonical.values()];
 }
 function normalizeReviewRequest(request) {
+  if ("requireBothQuestions" in request && request.requireBothQuestions !== undefined) {
+    throw new Error("Set requireBothQuestions on individual review standards, not the review request");
+  }
   const candidateItemsPerStandard = request.candidateItemsPerStandard ?? 1;
   if (!Number.isInteger(candidateItemsPerStandard) || candidateItemsPerStandard <= 0 || candidateItemsPerStandard > TIMEBACK_ASSESSMENT_REVIEW_REQUEST_LIMITS.candidateItemsPerStandard) {
     throw new RangeError(`candidateItemsPerStandard must be a positive integer at most ${TIMEBACK_ASSESSMENT_REVIEW_REQUEST_LIMITS.candidateItemsPerStandard}`);
@@ -11081,20 +11123,20 @@ function normalizeReviewRequest(request) {
   }
   return {
     standards,
-    candidateItemsPerStandard,
-    ...request.requireBothQuestions ? { requireBothQuestions: true } : {}
+    candidateItemsPerStandard
   };
 }
 function reviewRequestFingerprint(request, policy) {
   const normalized = normalizeReviewRequest(request);
+  const requiredStandardKeys = normalized.standards.filter((standard) => standard.requireBothQuestions).map(assessmentStandardRefKey);
   return JSON.stringify({
     kind: "standards-review",
     policy: {
       version: policy.version
     },
     candidateItemsPerStandard: normalized.candidateItemsPerStandard,
-    ...normalized.requireBothQuestions ? { requireBothQuestions: true } : {},
-    standardKeys: normalized.standards.map(assessmentStandardRefKey)
+    standardKeys: normalized.standards.map(assessmentStandardRefKey),
+    ...requiredStandardKeys.length > 0 ? { requiredStandardKeys } : {}
   });
 }
 function reviewQuestionLineItemId(parentLineItemId, itemIdentifier) {
@@ -11320,9 +11362,10 @@ function rankedCandidatesByStandard(bank, exposures) {
   return byStandard;
 }
 function reviewSlots(request) {
-  return request.standards.flatMap((standard) => Array.from({ length: request.candidateItemsPerStandard }, () => ({
-    standard,
-    standardKey: assessmentStandardRefKey(standard)
+  return request.standards.flatMap((standard, servingIndex) => Array.from({ length: request.candidateItemsPerStandard }, () => ({
+    standard: reviewStandardRef(standard),
+    standardKey: assessmentStandardRefKey(standard),
+    servingIndex
   })));
 }
 function matchingCandidates(candidatesByStandard, slotCount) {
@@ -11435,7 +11478,7 @@ function fulfillment(request, candidatesByStandard, selections) {
     const selected = selectedByStandard.get(key) ?? 0;
     return selected < request.candidateItemsPerStandard ? [
       {
-        standard,
+        standard: reviewStandardRef(standard),
         requested: request.candidateItemsPerStandard,
         selected,
         eligible: candidatesByStandard.get(key)?.length ?? 0
@@ -11460,10 +11503,10 @@ function fulfillment(request, candidatesByStandard, selections) {
 function selectReviewItems(input) {
   const request = normalizeReviewRequest(input.request);
   const candidatesByStandard = rankedCandidatesByStandard(input.bank, input.exposures);
-  const slots = reviewSlots(request);
+  const slots = reviewSlots(request).toSorted((left, right) => compareCodeUnits(left.standardKey, right.standardKey));
   const boundedCandidates = matchingCandidates(candidatesByStandard, slots.length);
   const selected = preferredDistinctMatching(slots, boundedCandidates);
-  const selections = [...selected.entries()].toSorted(([left], [right]) => left - right).map(([index, itemIdentifier]) => ({
+  const selections = [...selected.entries()].toSorted(([left], [right]) => slots[left].servingIndex - slots[right].servingIndex || left - right).map(([index, itemIdentifier]) => ({
     standard: slots[index].standard,
     itemIdentifier
   }));
@@ -11602,6 +11645,9 @@ function isAssessmentScore(value) {
 function isAssessmentStandardRef(value) {
   return isRecord(value) && typeof value.framework === "string" && value.framework.length > 0 && typeof value.identifier === "string" && value.identifier.length > 0;
 }
+function isAssessmentReviewStandard(value) {
+  return isRecord(value) && isAssessmentStandardRef(value) && (value.requireBothQuestions === undefined || typeof value.requireBothQuestions === "boolean");
+}
 function isReviewFulfillment(value) {
   if (!isRecord(value) || value.status !== "complete" && value.status !== "partial" || !Number.isInteger(value.requestedItemCount) || !Number.isInteger(value.selectedItemCount) || !Array.isArray(value.shortages)) {
     return false;
@@ -11676,7 +11722,7 @@ function isRoutedDiagnosticAttemptMetadata(value, itemSubmissions, responseVersi
   });
 }
 function isReviewAttemptMetadata(value) {
-  return isRecord(value) && typeof value.requestFingerprint === "string" && typeof value.bankRevision === "string" && Array.isArray(value.standards) && value.standards.every(isAssessmentStandardRef) && Number.isInteger(value.candidateItemsPerStandard) && (value.requireBothQuestions === undefined || typeof value.requireBothQuestions === "boolean") && Array.isArray(value.selections) && value.selections.every((selection) => isRecord(selection) && isAssessmentStandardRef(selection.standard) && typeof selection.itemIdentifier === "string") && isReviewFulfillment(value.fulfillment);
+  return isRecord(value) && typeof value.requestFingerprint === "string" && typeof value.bankRevision === "string" && Array.isArray(value.standards) && value.standards.every(isAssessmentReviewStandard) && Number.isInteger(value.candidateItemsPerStandard) && value.requireBothQuestions === undefined && Array.isArray(value.selections) && value.selections.every((selection) => isRecord(selection) && isAssessmentStandardRef(selection.standard) && typeof selection.itemIdentifier === "string") && isReviewFulfillment(value.fulfillment);
 }
 function isOptionalInteger(value) {
   return value === undefined || Number.isInteger(value);
@@ -11795,6 +11841,7 @@ var init_assessment_runtime2 = __esm(() => {
   init_src();
   init_timeback3();
   init_src();
+  init_src();
   init_uuid();
   init_esm();
   init_src();
@@ -12374,8 +12421,8 @@ var init_assessment_runtime2 = __esm(() => {
     }),
     StartAssessmentBaseSchema.extend({
       purpose: exports_external.literal("review"),
-      requireBothQuestions: exports_external.boolean().optional(),
-      standards: exports_external.array(AssessmentStandardRefSchema2).min(1).max(TIMEBACK_ASSESSMENT_REVIEW_REQUEST_LIMITS.standards),
+      requireBothQuestions: exports_external.never().optional(),
+      standards: exports_external.array(AssessmentStandardRefSchema2.and(exports_external.object({ requireBothQuestions: exports_external.boolean().optional() }))).min(1).max(TIMEBACK_ASSESSMENT_REVIEW_REQUEST_LIMITS.standards),
       candidateItemsPerStandard: exports_external.number().int().positive().max(TIMEBACK_ASSESSMENT_REVIEW_REQUEST_LIMITS.candidateItemsPerStandard).optional()
     }),
     StartAssessmentBaseSchema.extend({
@@ -39192,7 +39239,7 @@ function assertMatchingAssessmentArtifactPair(playable, scoring, expectedIdentit
     throw new ValidationError("Assessment artifact pair does not describe one revision");
   }
 }
-var ASSESSMENT_ARTIFACT_SCHEMA_VERSION = 1, ASSESSMENT_GRADER_PROTOCOL_VERSION = 1, ARTIFACT_KEY_PREFIX = "assessment-artifacts", SHA256_HEX, textEncoder;
+var ASSESSMENT_ARTIFACT_SCHEMA_VERSION = 2, ASSESSMENT_GRADER_PROTOCOL_VERSION = 1, ARTIFACT_KEY_PREFIX = "assessment-artifacts", SHA256_HEX, textEncoder;
 var init_assessment_artifact_envelope_util = __esm(() => {
   init_errors2();
   SHA256_HEX = /^[a-f0-9]{64}$/;
@@ -94286,6 +94333,30 @@ var init_timeback_game_metrics_comparison_util = __esm(() => {
 });
 
 // ../timeback/dist/engines/qti/index.js
+function qtiAttributeNumber(attributes, name3, fallback) {
+  const raw = attributes[name3]?.trim();
+  if (!raw) {
+    return fallback;
+  }
+  const value = Number(raw);
+  return Number.isFinite(value) ? value : fallback;
+}
+function qtiAttributeCapacity(attributes, name3, fallback) {
+  const raw = attributes[name3]?.trim();
+  if (!raw) {
+    return fallback;
+  }
+  const value = Number(raw);
+  return Number.isInteger(value) && value >= 0 ? value : null;
+}
+function qtiAttributeMaximum(attributes, name3, fallback, unlimited) {
+  const maximum = qtiAttributeNumber(attributes, name3, fallback);
+  return maximum === 0 ? unlimited : maximum;
+}
+function qtiAttributeBoolean(attributes, name3) {
+  const value = attributes[name3];
+  return value === "true" || value === "1";
+}
 function decodeCssEscapes(value) {
   return value.replace(/\\([0-9a-fA-F]{1,6})\s?/g, (_, hex3) => {
     const code = Number.parseInt(hex3, 16);
@@ -94873,7 +94944,8 @@ function parseGapTexts(interaction) {
     return {
       identifier: attributes2.identifier || "",
       content: plainTextFromNodes(gapText.children),
-      matchMax: finiteNumber(attributes2["match-max"]) ?? 1
+      matchMax: finiteNumber(attributes2["match-max"]) ?? 1,
+      ...qtiAttributeBoolean(attributes2, "fixed") ? { fixed: true } : {}
     };
   }).filter((gapText) => gapText.identifier);
 }
@@ -95973,30 +96045,6 @@ ${body2}
 ${processing}` : ""}
 </qti-assessment-item>`;
 }
-function qtiAttributeNumber(attributes2, name3, fallback) {
-  const raw = attributes2[name3]?.trim();
-  if (!raw) {
-    return fallback;
-  }
-  const value = Number(raw);
-  return Number.isFinite(value) ? value : fallback;
-}
-function qtiAttributeCapacity(attributes2, name3, fallback) {
-  const raw = attributes2[name3]?.trim();
-  if (!raw) {
-    return fallback;
-  }
-  const value = Number(raw);
-  return Number.isInteger(value) && value >= 0 ? value : null;
-}
-function qtiAttributeMaximum(attributes2, name3, fallback, unlimited) {
-  const maximum = qtiAttributeNumber(attributes2, name3, fallback);
-  return maximum === 0 ? unlimited : maximum;
-}
-function qtiAttributeBoolean(attributes2, name3) {
-  const value = attributes2[name3];
-  return value === "true" || value === "1";
-}
 function gapContentIdentifiers(nodes) {
   return nodes.flatMap((node) => {
     if (node.kind === "gap") {
@@ -96077,6 +96125,7 @@ function authorableQtiInteractionProjection(interaction) {
         type: interaction.type,
         choices: interaction.choices,
         minChoices: qtiAttributeNumber(attributes2, "min-choices", 1),
+        shuffle: qtiAttributeBoolean(attributes2, "shuffle"),
         maxChoices: qtiAttributeMaximum(attributes2, "max-choices", 1, interaction.choices.length)
       };
     }
@@ -96085,6 +96134,7 @@ function authorableQtiInteractionProjection(interaction) {
         ...base,
         type: interaction.type,
         choices: interaction.choices,
+        shuffle: qtiAttributeBoolean(attributes2, "shuffle"),
         blankIndex: interaction.blankIndex ?? 0
       } : null;
     }
@@ -99916,11 +99966,13 @@ var init_assessment_artifact_runtime_util = __esm(() => {
   playableContentNodesSchema = exports_external.array(exports_external.unknown());
   playableChoiceSchema = exports_external.object({
     identifier: trimmedNonEmptyString3,
+    fixed: exports_external.boolean().optional(),
     content: exports_external.string(),
     contentNodes: playableContentNodesSchema.optional()
   }).strict();
   playableMatchChoiceSchema = exports_external.object({
     identifier: trimmedNonEmptyString3,
+    fixed: exports_external.boolean().optional(),
     content: exports_external.string(),
     contentNodes: playableContentNodesSchema.optional(),
     matchMax: nonnegativeInteger
@@ -99940,6 +99992,7 @@ var init_assessment_artifact_runtime_util = __esm(() => {
   }).strict();
   playableGapTextSchema = exports_external.object({
     identifier: trimmedNonEmptyString3,
+    fixed: exports_external.boolean().optional(),
     content: exports_external.string(),
     matchMax: nonnegativeInteger
   }).strict();
@@ -99957,6 +100010,7 @@ var init_assessment_artifact_runtime_util = __esm(() => {
     exports_external.object({
       ...playableInteractionBase,
       type: exports_external.literal("choice"),
+      shuffle: exports_external.boolean(),
       choices: exports_external.array(playableChoiceSchema),
       minChoices: nonnegativeInteger,
       maxChoices: nonnegativeInteger
@@ -99964,6 +100018,7 @@ var init_assessment_artifact_runtime_util = __esm(() => {
     exports_external.object({
       ...playableInteractionBase,
       type: exports_external.literal("inline-choice"),
+      shuffle: exports_external.boolean(),
       choices: exports_external.array(playableChoiceSchema)
     }).strict(),
     exports_external.object({
@@ -100007,6 +100062,7 @@ var init_assessment_artifact_runtime_util = __esm(() => {
     exports_external.object({
       ...playableInteractionBase,
       type: exports_external.literal("gap-match"),
+      shuffle: exports_external.boolean(),
       content: exports_external.string(),
       contentNodes: playableContentNodesSchema,
       gapTexts: exports_external.array(playableGapTextSchema),
@@ -100345,7 +100401,6 @@ function buildConventionalAssessmentSnapshot(input) {
       purpose: metadata2.purpose,
       standards: [...metadata2.review.standards],
       candidateItemsPerStandard: metadata2.review.candidateItemsPerStandard,
-      ...metadata2.review.requireBothQuestions ? { requireBothQuestions: true } : {},
       selections: [...metadata2.review.selections],
       fulfillment: metadata2.review.fulfillment
     };
@@ -100520,6 +100575,7 @@ function playableChoice(choice) {
   return {
     identifier: choice.identifier,
     content: choice.content,
+    ...qtiAttributeBoolean(choice.attributes, "fixed") ? { fixed: true } : {},
     ...choice.contentNodes ? { contentNodes: choice.contentNodes } : {}
   };
 }
@@ -100582,6 +100638,7 @@ function parseInteraction2(questionIdentifier, interaction) {
       responseIdentifier,
       ...prompt,
       choices,
+      shuffle: qtiAttributeBoolean(interaction.attributes, "shuffle"),
       minChoices: qtiAttributeNumber(interaction.attributes, "min-choices", 1),
       maxChoices: qtiAttributeMaximum(interaction.attributes, "max-choices", 1, choices.length)
     };
@@ -100591,7 +100648,8 @@ function parseInteraction2(questionIdentifier, interaction) {
       type,
       responseIdentifier,
       ...prompt,
-      choices: requireChoices2(interaction.choices.map(playableChoice))
+      choices: requireChoices2(interaction.choices.map(playableChoice)),
+      shuffle: qtiAttributeBoolean(interaction.attributes, "shuffle")
     };
   }
   if (type === "text-entry") {
@@ -100652,11 +100710,13 @@ function parseInteraction2(questionIdentifier, interaction) {
       responseIdentifier,
       ...prompt,
       content: interaction.textWithGaps,
+      shuffle: qtiAttributeBoolean(interaction.attributes, "shuffle"),
       contentNodes: interaction.gapContent,
       gapTexts: interaction.gapTexts.map((gapText) => ({
         identifier: gapText.identifier,
         content: gapText.content,
-        matchMax: gapText.matchMax
+        matchMax: gapText.matchMax,
+        ...gapText.fixed ? { fixed: true } : {}
       })),
       gaps: [...interaction.gaps],
       maxAssociations: qtiAttributeNumber(interaction.attributes, "max-associations", 0)
@@ -101475,7 +101535,7 @@ function buildInlineChoiceQuestionXml(input, identifier, title) {
   if (!envelope) {
     return null;
   }
-  const { structure, responseIdentifier, prompt } = envelope;
+  const { interaction, structure, responseIdentifier, prompt } = envelope;
   const promptParts = prompt.split(INLINE_CHOICE_BLANK);
   if (promptParts.length !== 2) {
     throw new ValidationError("Inline-choice questions require exactly one blank");
@@ -101489,7 +101549,7 @@ function buildInlineChoiceQuestionXml(input, identifier, title) {
   const choicesXml = choices.map((choice) => `        <qti-inline-choice identifier="${escapeXml(choice.identifier)}">${escapeXml(choice.content)}</qti-inline-choice>`).join(`
 `);
   const [before = "", after = ""] = promptParts;
-  const itemBody = `    <p>${escapeXml(before)}<qti-inline-choice-interaction response-identifier="${escapeXml(responseIdentifier)}">
+  const itemBody = `    <p>${escapeXml(before)}<qti-inline-choice-interaction response-identifier="${escapeXml(responseIdentifier)}" shuffle="${interaction.shuffle === true}">
 ${choicesXml}
       </qti-inline-choice-interaction>${escapeXml(after)}</p>`;
   return buildExactMatchQuestionXml({
@@ -102104,7 +102164,7 @@ async function prepareReviewMappingUpdate(test, questions) {
   const contentRevision = await assessmentContentRevision(test, questions);
   const assessment = {
     identifier: test.identifier,
-    contractVersion: 1,
+    contractVersion: PLAYCADEMY_ASSESSMENT_CONTRACT_VERSION,
     contentRevision,
     title: test.title,
     items: questions.questions.map(({ question }) => ({
@@ -102143,6 +102203,7 @@ async function prepareReviewMappingUpdate(test, questions) {
 var PLAYCADEMY_REVIEW_BANK_TITLE = "Review Bank", PLAYCADEMY_REVIEW_BANK_SINK_METADATA_KEY = "playcademyReviewBankSink", PLAYCADEMY_REVIEW_BANK_SINK_VERSION = 1, StoredSinkWarningSchema, ReviewBankSinkMarkerSchema;
 var init_timeback_review_mapping_util = __esm(() => {
   init_esm();
+  init_src();
   init_assessment_runtime2();
   init_qti();
   init_timeback3();
@@ -102817,13 +102878,11 @@ function buildPreparedAssessmentMetadata(plan, timestamp6, testName) {
       review: {
         requestFingerprint: reviewRequestFingerprint({
           standards: plan.review.standards,
-          candidateItemsPerStandard: plan.review.candidateItemsPerStandard,
-          requireBothQuestions: plan.review.requireBothQuestions
+          candidateItemsPerStandard: plan.review.candidateItemsPerStandard
         }, DEFAULT_REVIEW_SELECTION_POLICY),
         bankRevision: plan.review.bankRevision,
         standards: plan.review.standards,
         candidateItemsPerStandard: plan.review.candidateItemsPerStandard,
-        ...plan.review.requireBothQuestions ? { requireBothQuestions: true } : {},
         selections: plan.review.selections,
         fulfillment: plan.review.fulfillment
       }
@@ -104006,7 +104065,6 @@ var init_timeback_assessment_runtime_service = __esm(async () => {
           bankRevision: catalog.bank.bankRevision,
           standards: [...normalized.standards],
           candidateItemsPerStandard: normalized.candidateItemsPerStandard,
-          ...normalized.requireBothQuestions ? { requireBothQuestions: true } : {},
           selections: [...selected.selections],
           fulfillment: selected.fulfillment
         }
@@ -104278,7 +104336,6 @@ var init_timeback_assessment_runtime_service = __esm(async () => {
             bankRevision: source.bank.bankRevision,
             standards: [...normalizedRequest.standards],
             candidateItemsPerStandard: normalizedRequest.candidateItemsPerStandard,
-            ...normalizedRequest.requireBothQuestions ? { requireBothQuestions: true } : {},
             selections: [...selected.selections],
             fulfillment: selected.fulfillment
           }

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@playcademy/sandbox",
-    "version": "0.10.1-beta.2",
+    "version": "0.10.1-beta.4",
     "description": "Local development server for Playcademy game development",
     "type": "module",
     "exports": {