@sendevia/pi-ask-author 1.0.6 → 1.1.0

package/dist/tool-card.d.ts

@@ -0,0 +1,64 @@
+/**
+ * @file tool-card.ts
+ * @description 会话回放卡片渲染：`renderCall` 的摘要派生与 `renderResult` 的三态明细
+ *
+ * 核心架构特性：
+ * - 调用摘要与执行路径共用 `sanitizeAskAuthorArgs`，别名、包装键、终端转义清洗与数量上限只有一条规则
+ * - 渲染器只读取宿主传入的入参与详情，不持有组件实例；槽位既有 `Text` 复用由 `lastComponent` 提供
+ * - 缓存只存与主题无关的派生数据，按 args 对象身份失效；主题着色每帧现场计算
+ *
+ * 依赖方向：tool-card.ts → model.ts（类型）/ sanitize.ts / schema.ts（类型）/ texts.ts / theme.ts / tool-result.ts；被 index.ts 注册
+ */
+import type { ToolDefinition, ToolRenderResultOptions } from "@earendil-works/pi-coding-agent";
+import { type Component } from "@earendil-works/pi-tui";
+import type { AskAuthorResult } from "./model.js";
+import type { AskAuthorParams, RawParams } from "./schema.js";
+import type { Theme } from "./theme.js";
+import { type AskAuthorToolResult } from "./tool-result.js";
+/** 调用卡片派生数据：与主题无关的纯计算结果（颜色合成每帧按当前主题现场计算） */
+export interface CallCardData {
+    /** 卡片标题（已清洗的 `formTitle`） */
+    title: string;
+    /** 计数标签（多题模式为 `2 题 • 6 选项`，单题模式仅 `6 选项`） */
+    countLabel: string;
+}
+/**
+ * `renderCall` 记忆化状态载荷：宿主按工具执行行创建一次、跨帧复用的可变对象（`ToolRenderContext.state`，同一行的 `renderCall` 与 `renderResult` 共享该实例）
+ * 以 **args 对象身份** 为键；宿主经 `ToolExecutionComponent.updateArgs` 赋入新对象，身份变化即失效重新计算
+ */
+export interface CallRenderState {
+    /** 上一次派生所用的 args 对象身份（仅作 `===` 引用比对，不读取任何属性） */
+    cachedArgs?: object;
+    /** 与 `cachedArgs` 配对的派生数据；身份命中时直接复用 */
+    cachedCard?: CallCardData;
+}
+/** 卡片渲染上下文（从宿主公开的 `ToolDefinition` 派生，避免依赖未从包入口导出的内部类型） */
+type CardRenderContext = Parameters<NonNullable<ToolDefinition<typeof AskAuthorParams, AskAuthorResult, CallRenderState>["renderCall"]>>[2];
+/**
+ * 派生调用卡片数据（标题 + 计数标签：题目数 > 1 时附带题量，单题模式仅选项数）
+ * 本函数不构建表单模型：流式调用期间 `showIf` 可能引用尚未到达的题目，模型构造会因条件非法而抛出
+ * @param args - 本次渲染的原始工具入参（流式期间可能为不完整对象）
+ * @param state - 宿主按工具行复用、跨帧身份稳定的可变状态载荷
+ * @returns 派生卡片数据（args 身份命中时直接复用）
+ */
+export declare function resolveCallCard(args: RawParams, state: CallRenderState): CallCardData;
+/**
+ * 会话回放调用卡片渲染（复用槽位既有 Text；摘要按 args 身份记忆化）
+ * `args` 由宿主原样透传（流式期间可能不完整且未经 Schema 校验），摘要派生统一经 `sanitizeAskAuthorArgs` 收敛
+ * @param args - 原始工具入参（运行时未经清洗，可能为不完整对象）
+ * @param theme - 当前 TUI 主题实例
+ * @param context - 宿主渲染上下文（`state` 记忆化载荷 / `lastComponent` 槽位复用）
+ * @returns 调用卡片 `Text`（复用 `context.lastComponent` 就地更新）
+ */
+export declare function renderCallCard(args: RawParams, theme: Theme, context: CardRenderContext): Component;
+/**
+ * 会话回放结果卡片渲染（错误 / 取消 / 完成三态，展开态追加答卷明细）
+ * 错误态优先于取消态判定：`details.error` 为真值时即使 `cancelled` 为 true 也按错误呈现
+ * @param result - 工具执行结果（`details` 必须经由 {@link narrowResultDetails} 收窄）
+ * @param options - 宿主渲染选项（仅使用 `expanded`；本工具不上报流式部分结果）
+ * @param theme - 当前 TUI 主题实例
+ * @param context - 宿主渲染上下文（`lastComponent` 槽位复用）
+ * @returns 结果卡片 `Text`（复用 `context.lastComponent` 就地更新）
+ */
+export declare function renderResultCard(result: AskAuthorToolResult, options: ToolRenderResultOptions, theme: Theme, context: CardRenderContext): Component;
+export {};

package/dist/tool-result.d.ts

@@ -0,0 +1,69 @@
+/**
+ * @file tool-result.ts
+ * @description `ask_author` 的四类结果工厂与结果详情的宿主边界收窄
+ *
+ * 核心架构特性：
+ * - 完成 / 取消 / 结构化错误 / 运行期异常四类出口集中在此，封套前缀保持字节稳定以提升 Prompt Cache 命中率
+ * - 失败类结果同时设置 `isError: true`，让宿主按错误结果处理；`content` 仍携带面向 LLM 的封套与纠正指引
+ * - `narrowResultDetails` 是 `renderResult` 收到的不可信 `details` 的唯一类型收窄点
+ *
+ * 依赖方向：tool-result.ts → model.ts / texts.ts（类型与文案）；被 index.ts 与 tool-card.ts 消费
+ */
+import type { AgentToolResult } from "@earendil-works/pi-coding-agent";
+import { type AskAuthorFormModel, type AskAuthorResult, type AuthorAnswerItem, type NormalizedQuestion } from "./model.js";
+/** `ask_author` 工具执行结果结构（基于 Pi 官方 `AgentToolResult` 结构特化） */
+export type AskAuthorToolResult = AgentToolResult<AskAuthorResult>;
+/** 结果构造上下文：题目快照与标题/描述的可选覆盖（缺省值统一由 {@link resolveResultContext} 收敛） */
+export interface ResultContext {
+    /** 题目快照（缺省空数组：取消/错误可能发生在模型构建前） */
+    questions?: NormalizedQuestion[];
+    /** 问卷总标题（缺省 `TEXTS.fallbacks.defaultFormTitle`） */
+    formTitle?: string;
+    /** 问卷全局描述（缺省 undefined，不携带该字段内容） */
+    formDescription?: string;
+}
+/**
+ * 构造取消结果（智能体封套 `[Author Decision Cancelled]` + `cancelled: true`，`answers` 恒为空数组）
+ * @param ctx - 结果构造上下文（题目快照与被取消时的表单快照）
+ * @returns 取消结果（`content` 为取消封套单行文本，`details` 不含 `error` 字段）
+ */
+export declare function createCancelledResult(ctx?: ResultContext): AskAuthorToolResult;
+/**
+ * 构造错误结果（智能体错误封套 + 用户界面提示；作为工具错误结果返回，`details` 仍可用于渲染）
+ * @param reason - 面向智能体的原因
+ * @param guidance - 面向智能体的纠正指引
+ * @param userFacingError - 面向用户的界面提示
+ * @param ctx - 结果构造上下文（缺省值由 `resolveResultContext` 收敛）
+ * @returns 错误结果对象（`isError: true`、`cancelled: false` + `error` 详情，无作答内容）
+ */
+export declare function createErrorResult(reason: string, guidance: string, userFacingError: string, ctx?: ResultContext): AskAuthorToolResult;
+/**
+ * 构造运行期异常结果（模型构建抛出错误与 `execute` 异常捕获两条路径共用本工厂）
+ * @param err - 异常对象或消息（字符串经 {@link toErrorMessage} 原样返回）
+ * @param ctx - 结果构造上下文（题目快照与表单快照）
+ * @returns 运行期异常结果（封套原因携带 {@link toErrorMessage} 归一后的消息）
+ */
+export declare function createRuntimeErrorResult(err: unknown, ctx?: ResultContext): AskAuthorToolResult;
+/**
+ * 构造完成结果（`[Author Decision Finalized]` 封套正文由模型编译，空答卷渲染为空答卷提示）
+ * @param formModel - 本次请示的表单模型（详情表单快照来源，与组件回传结果同源）
+ * @param answers - 组件编译完成的答卷条目（封套正文与详情 `answers` 共用同一数组）
+ * @returns 完成结果（`cancelled: false`、无 `error` 字段；`answers` 为空数组时正文为 `TEXTS.markdown.envelopeEmpty`）
+ */
+export declare function createSuccessResult(formModel: AskAuthorFormModel, answers: AuthorAnswerItem[]): AskAuthorToolResult;
+/**
+ * 结果卡片宿主边界的**唯一**类型收窄点：把 `renderResult` 的 `details` 从不可信类型提升为 `AskAuthorResult`
+ * 会话回放时 `details` 由转录 JSON 反序列化而来（运行期形状不可信），故先做形状闸门再断言一次；数组元素由本扩展自身写入，不在闸门范围
+ * 校验项：普通对象、`cancelled`/`answers`/`questions`/`formTitle` 键存在性、`cancelled` 布尔、`answers`/`questions` 数组、`formTitle` 字符串
+ * 可选 `error` / `formDescription` 不设闸门：二者仅参与字符串插值，非字符串至多渲染为退化文本
+ * @param value - 宿主传入的不可信 `details` 值
+ * @returns 通过形状闸门的 `AskAuthorResult`
+ * @throws 任一校验项失败时抛出错误（就地崩溃）
+ */
+export declare function narrowResultDetails(value: unknown): AskAuthorResult;
+/**
+ * 将单条答案展开为明细内容行（多选以 `TEXTS.common.optionSeparator` 连接并附选项批注角标，零勾选回退 `未选`；单选无选中项时回退题目补充说明，两者皆空再回退 `未选`）
+ * @param ans - 答卷条目
+ * @returns 单行明细文本（不含换行；题目级补充说明以 `TEXTS.card.questionNoteTag` 角标追加）
+ */
+export declare function formatAnswerLine(ans: AuthorAnswerItem): string;

package/dist/view-editor.d.ts

@@ -0,0 +1,24 @@
+/**
+ * @file view-editor.ts
+ * @description 补充说明编辑器的全屏视图构建器
+ *
+ * 核心架构特性：
+ * - 只根据编辑目标拼装标题、上下文与编辑器行，编辑器实例由组件传入并保持焦点状态
+ * - 不读取也不写入组件的输入模式标记；离开输入模式仍由组件在按键路径决定
+ *
+ * 依赖方向：view-editor.ts → format.ts / model.ts / texts.ts / theme.ts / view-rows.ts；禁止反向导入 component.ts
+ */
+import type { Editor } from "@earendil-works/pi-tui";
+import type { AskAuthorFormModel, EditTarget } from "./model.js";
+import type { Theme } from "./theme.js";
+/**
+ * 渲染补充说明编辑器全屏模式（标题 / 上下文背景 / 编辑框 / 页脚按键提示 / 底部框架线）
+ * @param theme - 当前 TUI 主题
+ * @param model - 问卷模型（读取题目与选项文案）
+ * @param tab - 当前题目索引
+ * @param target - 编辑目标（题目整体或指定选项）
+ * @param editor - 内置编辑器实例
+ * @param renderWidth - 终端可视宽度
+ * @returns 编辑器页的完整终端行；题目越界时返回空数组
+ */
+export declare function renderEditorPage(theme: Theme, model: AskAuthorFormModel, tab: number, target: EditTarget | undefined, editor: Editor, renderWidth: number): string[];

package/dist/view-question.d.ts

@@ -0,0 +1,127 @@
+/**
+ * @file view-question.ts
+ * @description 题目作答页的视图构建器：题头、选项菜单、双栏 / 单栏预览与底部按键提示
+ *
+ * 核心架构特性：
+ * - 只读取组件传入的视口状态并返回终端行，滚动位移与光标写入仍由组件在输入路径完成
+ * - 预览完整内容按「题号 + 条目 + 列宽 + 批注」缓存，左栏按「题号 + 光标 + 位移 + revision + 列宽」缓存；`clear()` 由组件在状态突变与主题切换时调用
+ * - 双栏与单栏的判定、视口高度与帮助行组装集中在此，组件只做模式选择
+ *
+ * 依赖方向：view-question.ts → format.ts / layout.ts / model.ts / novel-markdown.ts / texts.ts / theme.ts / view-rows.ts；禁止反向导入 component.ts
+ */
+import { type AskAuthorFormModel, type MenuItem } from "./model.js";
+import type { Theme } from "./theme.js";
+/** 题目作答页的只读视口状态（全部字段来自组件，构建器不写回） */
+export interface QuestionViewState {
+    /** 当前题目索引（0-based；调用方保证不是总览页） */
+    readonly tab: number;
+    /** 当前聚焦菜单项索引 */
+    readonly optionIndex: number;
+    /** 左栏菜单滚动位移（行） */
+    readonly listScrollOffset: number;
+    /** 预览区滚动位移（行） */
+    readonly previewScrollOffset: number;
+    /** 底部临时状态通知（可为空） */
+    readonly statusMessage: string | null;
+    /** 当前题目的菜单项（由模型派生并记忆化） */
+    readonly menuItems: readonly MenuItem[];
+}
+/** 预览视口观察值：渲染后回传组件，供输入路径归一化滚动位移 */
+export interface PreviewViewport {
+    /** 未切片的完整内容行数 */
+    readonly total: number;
+    /** 本帧视口高度（行） */
+    readonly viewHeight: number;
+}
+/** 题目作答页渲染结果 */
+export interface QuestionViewResult {
+    /** 整页终端行（含底部状态、帮助与框架线） */
+    readonly lines: string[];
+    /** 本帧预览视口；未渲染预览时为 undefined（沿用上一帧观察值） */
+    readonly previewViewport?: PreviewViewport;
+}
+/**
+ * 双栏右侧预览视口高度（随终端高度收缩；区间 `[6, LAYOUT_CONFIG.splitPreviewHeight]`）
+ * @param terminalRows - 终端可视行数
+ * @returns 视口最大行数
+ */
+export declare function splitPreviewHeight(terminalRows: number): number;
+/**
+ * 单栏内联预览视口高度（随终端高度收缩；区间 `[3, LAYOUT_CONFIG.singlePreviewHeight]`）
+ * @param terminalRows - 终端可视行数
+ * @returns 视口最大行数
+ */
+export declare function singlePreviewHeight(terminalRows: number): number;
+/**
+ * 题目作答页视图构建器（持有预览与左栏缓存；模型与主题在构造期固定）
+ */
+export declare class QuestionView {
+    private readonly theme;
+    private readonly model;
+    /** 预览框完整渲染行缓存池（键：题号 + 条目身份 + 列宽 + 补充说明；超容量按插入序淘汰） */
+    private readonly previewCache;
+    /** 左栏菜单行缓存（键：题号 + 光标 + 位移 + revision + 左栏宽） */
+    private leftColCache?;
+    /**
+     * @param theme - 当前 TUI 主题
+     * @param model - 问卷模型（只读访问）
+     */
+    constructor(theme: Theme, model: AskAuthorFormModel);
+    /** 清空预览池与左栏缓存（状态突变、主题切换与组件回收时调用） */
+    clear(): void;
+    /** 只清空左栏菜单行缓存（焦点变化时调用，保留已解析的预览内容） */
+    clearColumnCache(): void;
+    /**
+     * 渲染题目作答页
+     * @param state - 只读视口状态（当前题、光标、滚动位移、状态通知与菜单项）
+     * @param renderWidth - 终端布局列宽
+     * @param terminalRows - 终端可视行数（决定预览视口高度）
+     * @returns 整页终端行与本帧预览视口
+     */
+    render(state: QuestionViewState, renderWidth: number, terminalRows: number): QuestionViewResult;
+    /**
+     * 获取聚焦条目的预渲染完整内容行（`previewCache` 透明备忘缓存，跨条目 / 切换题目零重复解析）
+     * @param tab - 题目索引
+     * @param item - 目标菜单项
+     * @param customText - 题目整体补充说明
+     * @param optionNote - 选项专属补充说明
+     * @param targetWidth - 预览可用列宽
+     * @returns 未切片的完整内容行数组；`item` 缺省时返回空数组
+     */
+    private previewContentLines;
+    /**
+     * 计算并切片本帧预览框行（纯计算，不写回滚动位移）
+     * @param tab - 题目索引
+     * @param item - 目标菜单项
+     * @param customText - 题目整体补充说明
+     * @param optionNote - 选项专属补充说明
+     * @param targetWidth - 预览可用列宽
+     * @param viewHeight - 视口最大行数
+     * @param scrollOffset - 当前预览滚动位移
+     * @returns 本帧可视内容行与视口观察值
+     */
+    private buildPreviewBox;
+    /**
+     * 渲染双栏视图（左选项菜单 + 右推演 / 分镜预览框）
+     * @param lines - 输出行数组（原地追加）
+     * @param q - 当前题目
+     * @param st - 作答状态
+     * @param state - 只读视口状态
+     * @param renderWidth - 终端可用宽度
+     * @param terminalRows - 终端可视行数
+     * @returns 本帧预览视口观察值
+     */
+    private renderSplitView;
+    /**
+     * 遍历输出菜单项行，单栏模式下在聚焦项下方内联展开预览
+     * @param lines - 输出行数组（原地追加）
+     * @param q - 当前题目
+     * @param st - 作答状态
+     * @param state - 只读视口状态
+     * @param rowWidth - 选项行可用列宽
+     * @param expandFocused - 是否展开聚焦项预览（窗口外条目不访问）
+     * @param terminalRows - 终端可视行数
+     * @returns 本帧聚焦项预览视口；未展开预览时 undefined
+     */
+    private pushListItems;
+}

package/dist/view-rows.d.ts

@@ -39,6 +39,8 @@ export declare function formatMenuItemRow(theme: Theme, item: MenuItem, isFocuse
  * 渲染完整 Tab 导航栏区块（各题标签 + 提交页标签 + 末尾单横分隔线）
  *
  * 算法不变量：
+ * - 只为当前可见题目产出标签（序条件隐藏的题目不出现在导航栏），标签序号为可见题目的展示序号
+ * - 题目标签文本优先取题目的 `tabLabel`（超过 `LAYOUT_CONFIG.tabLabelMaxWidth` 时截断），未声明时回退题号文案；
  * - 题目标签以 `ICONS.checked` / `ICONS.unchecked` 与 `success` / `muted` 配色表达完成度，激活题页恒为
  *   `selectedBg` + `accent` 的 `bold` 反白（激活提交页为 `selectedBg` + `success`）
  * - 提交页标签在全部作答完成时用 `success`，否则 `dim`；激活判定为 `currentTab === model.questionCount`
@@ -46,12 +48,19 @@ export declare function formatMenuItemRow(theme: Theme, item: MenuItem, isFocuse
  *   `dim` 配色的单横分隔线（`LAYOUT_CONFIG.dividerThin`）
  *
  * @param theme - 主题样式提供者
- * @param model - 问卷表单数据模型（提供题目数、作答完成度）
- * @param currentTab - 激活页索引（`0 ~ questionCount - 1` 为题页，`questionCount` 为总览页）
+ * @param model - 问卷表单数据模型（提供可见题目、作答完成度）
+ * @param currentTab - 激活页索引（题目顺序索引；`questionCount` 为总览页）
  * @param renderWidth - 终端可视宽度限制
  * @returns Tab 导航栏终端行数组（至少含末尾分隔线一行；超宽时标签折为多行）
  */
 export declare function buildTabLines(theme: Theme, model: AskAuthorFormModel, currentTab: number, renderWidth: number): string[];
+/**
+ * 原地追加底部状态通知行（无文案时不追加）
+ * @param lines - 输出行数组（原地追加）
+ * @param theme - 主题样式提供者
+ * @param statusMessage - 当前状态通知（可为空）
+ */
+export declare function pushStatusMessage(lines: string[], theme: Theme, statusMessage: string | null): void;
 /**
  * 原地追加底部按键提示行（统一 `dim` 配色 + 单空格悬挂缩进，超宽时折行）
  * @param lines - 输出行数组（原地追加）

package/dist/view-summary.d.ts

@@ -1,27 +1,61 @@
 /**
  * @file view-summary.ts
- * @description 纯函数视图排版层：答卷总览确认页的内容行与底部按键提示构建器
+ * @description 答卷总览确认页的视图构建层：内容行、分页、提示与操作栏
  *
  * 核心架构特性：
- * - 全部函数为无状态纯函数（无 `this` / 缓存 / IO）：内容构建器返回未切片的完整内容行数组，提示构建器返回提示片段数组
+ * - 内容构建器与提示构建器为无状态纯函数；`SummaryView` 只持有按（列宽, `revision`）失效的内容行缓存
  * - 多选分支一律经 `model.getSelectedIndices`（升序不变量由模型层集中保证）
  *
- * 依赖方向：view-summary.ts → format.ts / model.ts / texts.ts / theme.ts；禁止反向导入 `component.ts`
+ * 依赖方向：view-summary.ts → format.ts / layout.ts / model.ts / texts.ts / theme.ts / view-rows.ts；禁止反向导入 `component.ts`
  */
 import type { AskAuthorFormModel } from "./model.js";
 import type { Theme } from "./theme.js";
 /**
- * 构建总览页底部按键提示片段（依据题目数量动态增删跳转题目提示）
- * @param model - 问卷表单数据模型（提供题目总数）
- * @returns 包含切换题目 / 滚动 / 提交 / 取消四项，题目数 > 1 时额外插入跳转题目提示
+ * 构建总览页底部按键提示片段（依据可见题目数量动态增删跳转题目提示）
+ * @param model - 问卷表单数据模型（提供可见题目数与作答完成度）
+ * @returns 包含切换题目 / 滚动 / 提交 / 取消四项，可见题目数 > 1 时额外插入跳转题目提示
  */
 export declare function buildSummaryHelpParts(model: AskAuthorFormModel): string[];
+/**
+ * 总览页视口高度（随终端高度自适应；区间 `[4, LAYOUT_CONFIG.summaryPageSize]`）
+ * @param terminalRows - 终端可视行数
+ * @returns 单页最大内容行数
+ */
+export declare function summaryPageSize(terminalRows: number): number;
+/**
+ * 答卷总览与提交页构建器（持有内容行缓存，模型与主题在构造期固定）
+ */
+export declare class SummaryView {
+    private readonly theme;
+    private readonly model;
+    /** 未切片内容行缓存（键：列宽 + `revision`） */
+    private cache?;
+    /**
+     * @param theme - 当前 TUI 主题
+     * @param model - 问卷模型（只读访问）
+     */
+    constructor(theme: Theme, model: AskAuthorFormModel);
+    /** 清空内容行缓存（状态突变、主题切换与组件回收时调用） */
+    clear(): void;
+    /** 上一次构建的内容行总数（供组件在输入路径归一化滚动位移；尚未渲染时为 0） */
+    get contentLineCount(): number;
+    /**
+     * 渲染总览页
+     * @param scrollOffset - 当前滚动位移（在本地收敛，不写回）
+     * @param pageSize - 单页最大内容行数
+     * @param statusMessage - 底部临时状态通知（可为空）
+     * @param renderWidth - 终端布局列宽
+     * @returns 总览页完整终端行（含标题、提示、状态、帮助与底部框架线）
+     */
+    render(scrollOffset: number, pageSize: number, statusMessage: string | null, renderWidth: number): string[];
+}
 /**
  * 构建未切片的完整答卷总览内容行
- * 逐题输出四段（状态徽章 + 题目标题 / 已选项 / 选项专属批注 / 题目整体批注），题间以空行分隔；显式跳过与仅批注提交的题目同样入列，不静默消失
+ * 逐题输出四段（状态徽章 + 题目标题 / 已选项 / 选项专属批注 / 题目整体批注），题间以空行分隔；隐条件隐藏的题目不入列，
+ * 显式跳过与仅批注提交的题目同样入列；题目序号为可见题目的展示序号
  * @param model - 问卷表单数据模型（作答状态的唯一权威来源）
  * @param theme - 主题样式提供者
  * @param contentWidth - 总览主体可用列宽（列），超宽行沿各段悬挂前缀折行
- * @returns 完整未切片的内容行数组；无效题目跳过，无有效题目时返回空数组
+ * @returns 完整未切片的内容行数组；无效题目跳过，无可见题目时返回空数组
  */
 export declare function buildSubmitSummaryContentLines(model: AskAuthorFormModel, theme: Theme, contentWidth: number): string[];

package/lang/en_US.json

@@ -0,0 +1,172 @@
+{
+  "tool": { "label": "Consult Author" },
+  "command": {
+    "name": "ask-author",
+    "description": "Show the ask_author consultation tool reference",
+    "notify": "Ask the AI to call ask_author in your prompt to consult you on creative decisions"
+  },
+  "common": { "optionSeparator": ", ", "bulletPrefix": "• ", "helpSeparator": " • " },
+  "tabs": {
+    "questionTab": { "template": "Q{index}", "params": ["index"] },
+    "submitTab": { "template": "{icon.check} Submit" }
+  },
+  "view": {
+    "modeSingle": "[Single]",
+    "conditionalBadge": "[Conditional]",
+    "modeMultiAtLeast": { "template": "[Multi, at least {min}{maxPart}]", "params": ["min", "maxPart"] },
+    "modeMultiOptional": { "template": "[Multi, optional{maxPart}]", "params": ["maxPart"] },
+    "modeMultiUnconstrained": { "template": "[Multi{maxPart}]", "params": ["maxPart"] },
+    "modeMultiMaxPart": { "template": ", up to {max}", "params": ["max"] },
+    "attachedNoteBanner": { "template": "{icon.note} Question note: {text}", "params": ["text"] },
+    "optionAttachedNoteBanner": {
+      "template": "{icon.note} [{label}] option note: {text}",
+      "params": ["label", "text"]
+    },
+    "listTopMore": { "template": "  {icon.scrollUp} {count} more above", "params": ["count"] },
+    "listBottomMore": { "template": "  {icon.scrollDown} {count} more below", "params": ["count"] },
+    "optionNotePanelTitle": "Option Note",
+    "storyDescriptionPanelTitle": "Plot Deduction",
+    "storyDraftPanelTitle": "Draft / Storyboard Preview",
+    "customNotePanelTitle": "Question Note",
+    "confirmPanelTitle": "Controls",
+    "customNotePanelCurrent": "Current content:",
+    "previewScrollInfo": {
+      "template": "(lines {start}-{end}/{total}, use [ ] to scroll)",
+      "params": ["start", "end", "total"]
+    },
+    "previewNoDraft": "(nothing to preview)",
+    "customNotePanelTips": [
+      "• Press \"N\", or select this item and press \"Enter\", to write or edit the question note",
+      "• Press \"x\" to clear the question note",
+      "• The note is submitted together with the selected options and their option notes"
+    ],
+    "confirmPanelTips": [
+      "• Press `Enter` to confirm this question and move on to the next one",
+      "• Confirming the last question opens the summary and submit page"
+    ],
+    "sectionTitle": { "template": "### {title}", "params": ["title"] },
+    "fieldLabel": { "template": "**{label}**", "params": ["label"] },
+    "italicLine": { "template": "_{text}_", "params": ["text"] }
+  },
+  "menu": {
+    "customNoteLabel": { "template": "{icon.note} Question note" },
+    "customNoteLabelFilled": { "template": "{icon.note} Question note (filled)" },
+    "confirmDetailMulti": { "template": "{selectedCount} selected", "params": ["selectedCount", "minSelect"] },
+    "confirmDetailMultiBelowMin": {
+      "template": "{selectedCount}/{minSelect} selected",
+      "params": ["selectedCount", "minSelect"]
+    },
+    "confirmLabel": {
+      "template": "{icon.check} Confirm question ({detail}{noteSuffix})",
+      "params": ["detail", "noteSuffix"]
+    },
+    "confirmNoteSuffix": " + note",
+    "confirmDesc": "Confirm and continue to the next question or the summary"
+  },
+  "editor": {
+    "title": { "template": " {icon.note} Question note ({questionTitle})", "params": ["questionTitle"] },
+    "optionTitle": {
+      "template": " {icon.note} Option note ({optionLabel} - {questionTitle})",
+      "params": ["questionTitle", "optionLabel"]
+    },
+    "footerHelp": " [Enter] save and return • [Esc/Ctrl+C] cancel"
+  },
+  "status": {
+    "questionNoteSaved": "Question note saved",
+    "noteCleared": "Question note cleared",
+    "optionNoteSaved": { "template": "Saved note for {label}", "params": ["label"] },
+    "optionNoteSavedUnselected": {
+      "template": "Saved note for {label} (option not selected; submitted as a note only)",
+      "params": ["label"]
+    },
+    "optionNoteSavedAtLimit": {
+      "template": "Limit reached (up to {max} options): note saved, option left unselected",
+      "params": ["max"]
+    },
+    "optionNoteCleared": { "template": "Cleared note for {label}", "params": ["label"] },
+    "selectedUpToLimit": { "template": "Selection limit reached (up to {limit} items)", "params": ["limit"] },
+    "maxSelectExceeded": {
+      "template": "Limit reached (up to {max} items): press \"Space\" to deselect an item first",
+      "params": ["max"]
+    },
+    "minSelectRequired": {
+      "template": "Below minimum (at least {min} required): press \"Space\" to select more, or press \"n/N\" to write a note",
+      "params": ["min"]
+    },
+    "pleaseAnswerBeforeSubmit": "Question not answered: press \"Space/Enter\" to pick an option, or press \"n/N\" to write a note",
+    "editorDiscardConfirm": "Press Esc/Ctrl+C again to discard changes (unsaved content will be lost); keep typing to cancel",
+    "errorNonTui": "The current environment is not an interactive terminal, so the interface cannot start; retry in an interactive TUI session",
+    "errorNoQuestions": "No valid question or option was provided; provide at least one question with options",
+    "errorInvalidCondition": {
+      "template": "Invalid adaptive condition: {details} (make showIf reference an earlier question and an existing option label, or use answered)",
+      "params": ["details"]
+    },
+    "errorExecutionFailed": {
+      "template": "Component failure: {reason} (fix the arguments and retry)",
+      "params": ["reason"]
+    }
+  },
+  "help": {
+    "cancel": "Esc/Ctrl+C cancel",
+    "clearNote": "x clear note",
+    "confirmQuestion": "Enter confirm",
+    "confirmSubmit": "Enter submit",
+    "editNote": "n question note",
+    "editOptionNote": "n option note",
+    "editQuestionNote": "N question note",
+    "jumpQuestion": "1-9 jump to question",
+    "moveCursor": "↑↓/jk move",
+    "scrollDraft": "[ ] scroll draft",
+    "scrollSummary": "↑↓/[ ] scroll",
+    "selectOptionSingle": "Space/Enter select",
+    "switchQuestion": "Tab/←→/hl switch question",
+    "toggleAll": "a select/clear all",
+    "toggleCheckMulti": "Space toggle"
+  },
+  "summary": {
+    "title": "[Answer Summary]",
+    "statusDone": "[Done]",
+    "statusPending": "[Pending]",
+    "questionPrefix": { "template": "Q{index}: {title}", "params": ["index", "title"] },
+    "selectedLabel": "Selected:",
+    "optionNoteBadge": { "template": "({icon.note} note)" },
+    "optionNotePrefix": { "template": "{icon.note} Option note ({optLabel}):", "params": ["optLabel"] },
+    "customNoteLabel": { "template": "{icon.note} Question note:" },
+    "allDonePrompt": {
+      "template": " {icon.check} All questions answered; press Enter/Ctrl+S to submit, Tab/hl/1-9 to revise"
+    },
+    "pendingWarning": {
+      "template": " {icon.unchecked} Some questions are unanswered; press Enter to answer, Tab/hl/1-9 to switch"
+    },
+    "topMore": { "template": "  {icon.scrollUp} {count} more lines above", "params": ["count"] },
+    "bottomMore": { "template": "  {icon.scrollDown} {count} more lines below", "params": ["count"] }
+  },
+  "card": {
+    "callQuestionAndOptionCount": {
+      "template": "{qCount} questions • {optCount} options",
+      "params": ["qCount", "optCount"]
+    },
+    "callOptionCountOnly": { "template": "{optCount} options", "params": ["optCount"] },
+    "resultCancelled": { "template": "{icon.cancel} Cancelled" },
+    "resultErrorShort": { "template": "{icon.error} Failed" },
+    "resultCompleted": { "template": "{icon.check} Completed" },
+    "resultCount": { "template": "{n} items", "params": ["n"] },
+    "optionBullet": { "template": "• {title}: {content}", "params": ["title", "content"] },
+    "optionWithNote": { "template": "{label} [{icon.note} {note}]", "params": ["label", "note"] },
+    "questionNoteTag": { "template": " ({icon.note} question note: {text})", "params": ["text"] },
+    "errorBullet": { "template": "• Error: {err}", "params": ["err"] }
+  },
+  "fallbacks": {
+    "defaultFormTitle": "Creative Decision",
+    "defaultQuestionTitle": "Choose the next creative option",
+    "defaultCustomPlaceholder": "Enter overall requirements, foreshadowing details, or revision notes for this question...",
+    "defaultOptionCustomPlaceholder": "Enter specific requirements or revision details for this option...",
+    "defaultCustomChoiceName": "Custom option",
+    "defaultOptionLabel": "Default option",
+    "unnamedOptionLabel": "Unnamed option",
+    "unselectedOption": "Not selected",
+    "autoQuestionId": { "template": "q_{n}", "params": ["n"] },
+    "autoQuestionTitle": { "template": "Question {n}", "params": ["n"] },
+    "autoOptionLabel": { "template": "Option {n}", "params": ["n"] }
+  }
+}