@longtable/cli 0.1.49 → 0.1.50

package/dist/project-session.d.ts

@@ -1,4 +1,4 @@
-import type { DecisionRecord, EvidenceRecord, InvocationRecord, LongTableQuestionObligation, ProviderKind, QuestionOption, QuestionCommitmentFamily, QuestionEpistemicBasis, QuestionGenerationResult, QuestionOpportunity, QuestionSurface, QuestionRecord, ResearchSpecificationChange, ResearchSpecificationPatch, ResearchSpecificationPatchSource, ResearchSpecificationRevision, ResearchState } from "@longtable/core";
+import type { DecisionRecord, EvidenceRecord, InvocationRecord, LongTableQuestionObligation, ProviderKind, QuestionOption, QuestionCommitmentFamily, QuestionEpistemicBasis, QuestionGenerationResult, QuestionOpportunity, QuestionSurface, QuestionPromptType, QuestionRecord, ResearchSpecificationChange, ResearchSpecificationPatch, ResearchSpecificationPatchSource, ResearchSpecificationRevision, ResearchState } from "@longtable/core";
 import type { SetupPersistedOutput } from "@longtable/setup";
 export type ProjectDisagreementPreference = "synthesis_only" | "show_on_conflict" | "always_visible";
 export type StartInterviewSignal = "phenomenon" | "audience" | "artifact" | "evidence" | "assumption" | "decision_risk" | "voice";
@@ -393,8 +393,11 @@ export declare function createWorkspaceQuestion(options: {
     prompt: string;
     title?: string;
     question?: string;
+    type?: QuestionPromptType;
     checkpointKey?: string;
     questionOptions?: QuestionOption[];
+    allowOther?: boolean;
+    otherLabel?: string;
     displayReason?: string;
     provider?: ProviderKind;
     required?: boolean;
@@ -404,10 +407,17 @@ export declare function createWorkspaceQuestion(options: {
     question: QuestionRecord;
     state: ResearchState;
 }>;
+type WorkspaceQuestionAnswerInput = string | string[] | {
+    answer?: string | string[];
+    selectedValue?: string;
+    selectedValues?: string[];
+    otherText?: string;
+    rationale?: string;
+};
 export declare function answerWorkspaceQuestion(options: {
     context: LongTableProjectContext;
     questionId?: string;
-    answer: string;
+    answer: WorkspaceQuestionAnswerInput;
     rationale?: string;
     provider?: "codex" | "claude";
     surface?: QuestionSurface;

package/dist/project-session.js

@@ -2397,6 +2397,7 @@ export async function createWorkspaceQuestion(options) {
         studyContract: state.studyContract
     });
     const checkpointKey = options.checkpointKey ?? trigger.signal.checkpointKey;
+    const promptType = options.type ?? "single_choice";
     const createdAt = nowIso();
     const title = options.title ?? questionTitleForCheckpoint(trigger.family, checkpointKey);
     const questionText = options.question ?? questionTextForCheckpoint(trigger.family, options.prompt, checkpointKey);
@@ -2427,10 +2428,10 @@ export async function createWorkspaceQuestion(options) {
             checkpointKey,
             title,
             question: questionText,
-            type: "single_choice",
+            type: promptType,
             options: options.questionOptions ?? optionsForCheckpointTrigger(trigger.family, checkpointKey),
-            allowOther: true,
-            otherLabel: "Other decision",
+            allowOther: options.allowOther ?? promptType !== "free_text",
+            otherLabel: options.otherLabel ?? "Other decision",
             required: options.required ?? trigger.requiresQuestionBeforeClosure,
             source: "checkpoint",
             displayReason: options.displayReason ?? trigger.rationale[0],
@@ -2486,53 +2487,159 @@ function splitAnswerAndRationale(rawAnswer) {
         ...(rationale ? { rationale } : {})
     };
 }
-function normalizeQuestionAnswerSelection(question, rawAnswer) {
-    const trimmed = rawAnswer.trim();
-    const { selection, rationale } = splitAnswerAndRationale(trimmed);
-    const numeric = Number(selection);
-    if (/^\d+$/.test(selection) && Number.isInteger(numeric)) {
+function uniqueStrings(values) {
+    return [...new Set(values.map((value) => value.trim()).filter(Boolean))];
+}
+function answerInputParts(input) {
+    if (typeof input === "string") {
+        return { values: [input], rawText: input };
+    }
+    if (Array.isArray(input)) {
+        return { values: input };
+    }
+    let values = input.selectedValues ?? [];
+    if (values.length === 0 && input.selectedValue) {
+        values = [input.selectedValue];
+    }
+    if (values.length === 0 && Array.isArray(input.answer)) {
+        values = input.answer;
+    }
+    if (values.length === 0 && typeof input.answer === "string") {
+        values = [input.answer];
+    }
+    const otherText = input.otherText?.trim();
+    const rationale = input.rationale?.trim();
+    return {
+        values,
+        ...(otherText ? { otherText } : {}),
+        ...(rationale ? { inlineRationale: rationale } : {})
+    };
+}
+function splitSelectionTokens(selection, type) {
+    if (type !== "multi_choice") {
+        return [selection];
+    }
+    return selection.split(/[;,]/).map((token) => token.trim()).filter(Boolean);
+}
+function normalizeFreeTextAnswer(input) {
+    const parts = answerInputParts(input);
+    const selectedText = parts.values.join("\n").trim();
+    const text = parts.rawText ?? (selectedText || parts.otherText || "");
+    const trimmed = text.trim();
+    if (!trimmed) {
+        throw new Error("Free-text LongTable question answers cannot be empty.");
+    }
+    return {
+        selectedValues: [trimmed],
+        selectedLabels: [trimmed],
+        otherText: trimmed,
+        ...(parts.inlineRationale ? { inlineRationale: parts.inlineRationale } : {})
+    };
+}
+function resolveQuestionAnswerToken(question, token) {
+    const trimmed = token.trim();
+    if (!trimmed) {
+        throw new Error("LongTable question answers cannot contain empty selections.");
+    }
+    const numeric = Number(trimmed);
+    if (/^\d+$/.test(trimmed) && Number.isInteger(numeric)) {
         const option = question.prompt.options[numeric - 1];
         if (option) {
             return {
                 selectedValue: option.value,
-                selectedLabel: option.label,
-                ...(rationale ? { inlineRationale: rationale } : {})
+                selectedLabel: option.label
             };
         }
         if (question.prompt.allowOther && numeric === question.prompt.options.length + 1) {
             return {
                 selectedValue: "other",
-                selectedLabel: question.prompt.otherLabel ?? "Other",
-                ...(rationale ? { inlineRationale: rationale } : {})
+                selectedLabel: question.prompt.otherLabel ?? "Other"
             };
         }
-        throw new Error(`Answer ${selection} is outside the available LongTable question options.`);
+        throw new Error(`Answer ${trimmed} is outside the available LongTable question options.`);
     }
-    const normalizedSelection = normalizeAnswerToken(selection);
+    const normalizedSelection = normalizeAnswerToken(trimmed);
     const option = question.prompt.options.find((candidate) => optionAnswerCandidates(candidate).includes(normalizedSelection));
     if (option) {
         return {
             selectedValue: option.value,
-            selectedLabel: option.label,
-            ...(rationale ? { inlineRationale: rationale } : {})
+            selectedLabel: option.label
         };
     }
     if (normalizedSelection === "other" && question.prompt.allowOther) {
         return {
             selectedValue: "other",
-            selectedLabel: question.prompt.otherLabel ?? "Other",
-            ...(rationale ? { inlineRationale: rationale } : {})
+            selectedLabel: question.prompt.otherLabel ?? "Other"
         };
     }
     if (question.prompt.allowOther) {
         return {
-            selectedValue: "other",
-            selectedLabel: selection,
-            otherText: trimmed,
-            ...(rationale ? { inlineRationale: rationale } : {})
+            selectedValue: trimmed,
+            selectedLabel: question.prompt.otherLabel ?? "Other",
+            otherText: trimmed
         };
     }
-    throw new Error(`Answer "${selection}" does not match a LongTable question option.`);
+    throw new Error(`Answer "${trimmed}" does not match a LongTable question option.`);
+}
+function isOtherAnswerToken(question, token) {
+    if (!question.prompt.allowOther) {
+        return false;
+    }
+    const trimmed = token.trim();
+    const normalized = normalizeAnswerToken(trimmed);
+    const otherLabel = normalizeAnswerToken(question.prompt.otherLabel ?? "Other");
+    if (normalized === "other" || normalized === otherLabel) {
+        return true;
+    }
+    const numeric = Number(trimmed);
+    return /^\d+$/.test(trimmed) && Number.isInteger(numeric) && numeric === question.prompt.options.length + 1;
+}
+function normalizeQuestionAnswerSelection(question, rawAnswer) {
+    if (question.prompt.type === "free_text") {
+        return normalizeFreeTextAnswer(rawAnswer);
+    }
+    const parts = answerInputParts(rawAnswer);
+    const parsedValues = parts.values.flatMap((value) => {
+        if (typeof rawAnswer === "string") {
+            const { selection } = splitAnswerAndRationale(value.trim());
+            return splitSelectionTokens(selection, question.prompt.type);
+        }
+        return splitSelectionTokens(value, question.prompt.type);
+    });
+    const inlineRationale = typeof rawAnswer === "string"
+        ? splitAnswerAndRationale(rawAnswer.trim()).rationale
+        : parts.inlineRationale;
+    const hasOtherText = Boolean(parts.otherText);
+    const hasOtherToken = parsedValues.some((value) => isOtherAnswerToken(question, value));
+    if (hasOtherText && !hasOtherToken) {
+        throw new Error("Other text requires selecting the LongTable question Other option.");
+    }
+    const selectionTokens = parts.otherText
+        ? parsedValues.filter((value) => !isOtherAnswerToken(question, value))
+        : parsedValues;
+    const tokens = uniqueStrings([
+        ...selectionTokens,
+        ...(parts.otherText ? [parts.otherText] : [])
+    ]);
+    if (tokens.length === 0) {
+        throw new Error("LongTable question answers cannot be empty.");
+    }
+    if (question.prompt.type !== "multi_choice" && tokens.length > 1) {
+        throw new Error("Single-choice LongTable questions accept exactly one answer.");
+    }
+    const resolved = tokens.map((token) => resolveQuestionAnswerToken(question, token));
+    const selectedValues = uniqueStrings(resolved.map((entry) => entry.selectedValue));
+    const selectedLabels = selectedValues.map((value) => {
+        const entry = resolved.find((candidate) => candidate.selectedValue === value);
+        return entry?.selectedLabel ?? value;
+    });
+    const otherText = parts.otherText ?? resolved.map((entry) => entry.otherText).find(Boolean);
+    return {
+        selectedValues,
+        selectedLabels,
+        ...(otherText ? { otherText } : {}),
+        ...(inlineRationale ? { inlineRationale } : {})
+    };
 }
 export async function answerWorkspaceQuestion(options) {
     const state = await loadResearchState(options.context.stateFilePath);
@@ -2546,8 +2653,8 @@ export async function answerWorkspaceQuestion(options) {
         .join("\n");
     const answer = {
         promptId: question.prompt.id,
-        selectedValues: [normalized.selectedValue],
-        selectedLabels: [normalized.selectedLabel],
+        selectedValues: normalized.selectedValues,
+        selectedLabels: normalized.selectedLabels,
         ...(normalized.otherText ? { otherText: normalized.otherText } : {}),
         ...(rationale ? { rationale } : {}),
         ...(options.provider ? { provider: options.provider } : {}),
@@ -2564,6 +2671,7 @@ export async function answerWorkspaceQuestion(options) {
         ...(question.commitmentFamily ? { commitmentFamily: question.commitmentFamily } : {}),
         ...(question.epistemicBasis ? { epistemicBasis: question.epistemicBasis } : {}),
         selectedOption: answer.selectedValues[0],
+        selectedOptions: answer.selectedValues,
         ...(rationale ? { rationale } : {})
     };
     const answeredQuestion = {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@longtable/cli",
-  "version": "0.1.49",
+  "version": "0.1.50",
   "private": false,
   "description": "Researcher-facing LongTable CLI",
   "type": "module",
@@ -29,12 +29,12 @@
   },
   "dependencies": {
     "@clack/prompts": "^1.2.0",
-    "@longtable/checkpoints": "0.1.49",
-    "@longtable/core": "0.1.49",
-    "@longtable/memory": "0.1.49",
-    "@longtable/provider-claude": "0.1.49",
-    "@longtable/provider-codex": "0.1.49",
-    "@longtable/setup": "0.1.49"
+    "@longtable/checkpoints": "0.1.50",
+    "@longtable/core": "0.1.50",
+    "@longtable/memory": "0.1.50",
+    "@longtable/provider-claude": "0.1.50",
+    "@longtable/provider-codex": "0.1.50",
+    "@longtable/setup": "0.1.50"
   },
   "devDependencies": {
     "@types/node": "^22.10.1",