@qingflow-tech/qingflow-cli 1.1.50-beta.3 → 1.1.50-beta.4

package/README.md

@@ -7,7 +7,7 @@ Qingflow CLI 是轻流面向开发者和 AI Agent 的命令行工具。它把轻
 ## 安装
 
 ```bash
-npm install @qingflow-tech/qingflow-cli@1.1.50-beta.3
+npm install @qingflow-tech/qingflow-cli@1.1.50-beta.4
 ```
 
 推荐从官网复制这一条一键安装 Qingflow CLI：
@@ -21,7 +21,7 @@ npx qingflow-cli@latest install
 ## 运行
 
 ```bash
-npx -y -p @qingflow-tech/qingflow-cli@1.1.50-beta.3 qingflow
+npx -y -p @qingflow-tech/qingflow-cli@1.1.50-beta.4 qingflow
 ```
 
 全局安装后可以直接运行：
@@ -62,7 +62,7 @@ qingflow-skills install --agent codex --scope user
 如果你通过一次性 `npx -p` 执行 skills 安装，建议加 `--copy`，避免 symlink 指向 npm 临时执行缓存：
 
 ```bash
-npx -y -p @qingflow-tech/qingflow-cli@1.1.50-beta.3 qingflow-skills install --agent codex --scope user --copy
+npx -y -p @qingflow-tech/qingflow-cli@1.1.50-beta.4 qingflow-skills install --agent codex --scope user --copy
 ```
 
 `qingflow-skills install` 默认使用 symlink，且遇到同名 skill 不会覆盖；只有显式传入 `--force` 才会替换。

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@qingflow-tech/qingflow-cli",
-  "version": "1.1.50-beta.3",
+  "version": "1.1.50-beta.4",
   "description": "Human-friendly Qingflow command line interface for auth, record operations, import, tasks, and stable builder flows.",
   "license": "MIT",
   "type": "module",

package/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "qingflow-mcp"
-version = "1.1.50b3"
+version = "1.1.50b4"
 description = "User-authenticated MCP server for Qingflow"
 readme = "README.md"
 license = "MIT"

package/skills/qingflow-cli/reference/builder/50-views.md

@@ -1,6 +1,6 @@
 # Builder Views
 
-Read this when the task is about table/card/board/gantt/hierarchy views, fixed filters, query panels, view sorting, view data permissions, associated report/view display on a view, or repairing existing views.
+Read this when the task is about table/card/board/gantt/hierarchy/calendar views, fixed filters, query panels, view sorting, view data permissions, associated report/view display on a view, or repairing existing views.
 
 ## Scope
 
@@ -18,7 +18,7 @@ app get -> app get fields/views -> views schema -> prepare one view -> views val
 
 视图声明是**版本化契约**（`apiVersion: builder.qingflow.com/v1alpha1`）。`builder views apply` 是视图创建的**唯一入口**（旧命令式 `view_create` 已删除；不要再寻找或使用任何“直接创建视图”的命令/工具）。
 
-- **两级 schema**：**summary**（最简版：类型/名称/数据展示内容 + `data_permission` 数据权限形状）与 **complete**（完整版：visibility 可见性授权、`filters`、`sort`、`query_conditions`、`action_buttons`/`buttons`、`associated_resources`、`card`/`gantt`/`hierarchy` 类型专属配置、`display`/`record`/`share`）。字段级定义逐字段带 `x-backend` 后端映射。
+- **两级 schema**：**summary**（最简版：类型/名称/数据展示内容 + `data_permission` 数据权限形状）与 **complete**（完整版：visibility 可见性授权、`filters`、`sort`、`query_conditions`、`action_buttons`/`buttons`、`associated_resources`、`card`/`gantt`/`hierarchy`/`calendar` 类型专属配置、`display`/`record`/`share`）。字段级定义逐字段带 `x-backend` 后端映射。
 - **读 schema**：`qingflow --json builder views schema` 默认返回 `v1alpha1/summary.json`；需要完整可写配置时显式传 `--schema-kind complete`。MCP 对应 `app_views_schema`。
 - **Schema-first 写入**：先用 `builder views schema --schema-version VERSION --schema-kind complete` 读取完整 schema；将相同版本显式传给 `validate --schema-version VERSION` 和 `apply --schema-version VERSION`。`validate` 也可从声明信封读取 `schema_version`，但推荐显式传版本；apply 的版本校验必须用 `--schema-version`。`validate` 接受一个直接视图声明对象，不接受 `upsert_view` 包装或批量 envelope。
 - **说明字段**：视图 Schema 使用语义化的 `*Description` 自定义 key（如 `dataPermissionDescription`）承载说明，加载和引用展开时原样保留；读取说明的工具应识别这些 key。标准校验器忽略这些自定义字段，仍按 `type`、`enum`、`required` 等关键字校验；`default` 是标准注解，不会自动填值。`*Description` 不是提交视图声明时的业务字段。
@@ -26,7 +26,8 @@ app get -> app get fields/views -> views schema -> prepare one view -> views val
 - **读 canonical 声明**：`qingflow --json builder views get --app-key APP --schema-version VERSION --schema-kind summary`，返回指定版本的 summary 声明数组（字段名反解）；完整可写配置用 `--schema-kind complete` 并检查 `config_read_errors[].gaps`。
 - **完整声明的提取边界**：`views get --schema-kind complete` 优先读取 `buttonConfigVO` 中的完整按钮绑定。公式过滤、无法解析的过滤规则或按钮 ID 会使该视图返回 `VIEW_NOT_EXTRACTABLE`（见 `details.config_read_errors[].gaps`），不会生成删减后的可写声明。修改这类视图的其他属性应使用局部 patch。更新现有视图时，已配置的系统字段原样保留，不补默认值、不重算序号；读接口生成的未配置占位对象不会写回，不会因此新增系统字段配置。
 - **版本协商**：apply 显式传 `--schema-version v1alpha1` 时启用版本化校验：非法声明返回 `INVALID_SPEC` 且**不写**；响应信封回显 `schemaVersion`。apply 不传时行为与旧版一致（别名宽容，零破坏）。
-- **complete 档新能力速览**：`data_permission`（`{type: config|custom, scope: all|oneself|dept|subordinate|custom}`；`scope=custom` 的规则明细写 `filters`）；`sort`（`[{que_id, ascending}]`，空数组=恢复默认排序）；`hierarchy` 类型（须 `hierarchy.title_que_id/children_que_id`，可选 `root_filter`）；`card`/`gantt`/`display`/`record`/`share` 配置组。summary 档仅四公开类型（table/card/board/gantt）。
+- **公开视图类型**：summary 与 complete 均支持 `table`、`card`、`board`、`gantt`、`hierarchy`、`calendar`。层级视图须提供 `hierarchy: {title_que_id, children_que_id}`；日历视图须提供 `calendar: {title_que_id, date_que_id}`，可选 `color_que_id`。日历 `date_que_id` 可引用表单日期字段，也可用系统字段 `2`（申请时间）或 `3`（更新时间）。
+- **complete 档配置速览**：`data_permission`（`{type: config|custom, scope: all|oneself|dept|subordinate|custom}`；`scope=custom` 的规则明细写 `filters`）；`sort`（`[{que_id, ascending}]`，空数组=恢复默认排序）；`hierarchy`（可选 `root_filter`）；`card`/`gantt`/`calendar`/`display`/`record`/`share` 配置组。
 
 ## Update existing views
 
@@ -132,7 +133,7 @@ CLI 将参数与文件内容拼装为服务层载荷，**顶层键**如下：
 
 ## 5. `type` 与各类型必填
 
-契约 **`view.type`**：**`table`** | **`card`** | **`board`** | **`gantt`**。
+契约 **`view.type`**：**`table`** | **`card`** | **`board`** | **`gantt`** | **`hierarchy`** | **`calendar`**。
 
 | `type` | 列/字段要点 | 类型专属键 |
 |--------|----------------|------------|
@@ -140,6 +141,8 @@ CLI 将参数与文件内容拼装为服务层载荷，**顶层键**如下：
 | **`card`** | 同 table | — |
 | **`board`**（看板） | 列；且须 **`group_by`**（分组字段名） | **`group_by`** |
 | **`gantt`** | 列；须 **`start_field`**、**`end_field`**（通常为日期类字段名） | 可选 **`title_field`** |
+| **`hierarchy`** | 层级标题字段和父子关系字段 | `hierarchy.title_que_id`、`hierarchy.children_que_id`；可选 `hierarchy.root_filter` |
+| **`calendar`** | 标题字段和日期字段 | `calendar.title_que_id`、`calendar.date_que_id`；可选 `calendar.color_que_id` |
 
 实现侧校验：对 **table/card**，`columns` 至少包含一列；已知系统字段在读取已有视图时原样透传，不要求出现在表单业务字段索引中。未知系统字段仍会报告覆盖缺口。
 

package/src/qingflow_mcp/builder_facade/models.py

@@ -135,6 +135,7 @@ class PublicViewType(str, Enum):
     board = "board"
     gantt = "gantt"
     hierarchy = "hierarchy"
+    calendar = "calendar"
 
 
 class PublicButtonTriggerAction(str, Enum):
@@ -1273,6 +1274,14 @@ class ViewHierarchyConfigPatch(StrictModel):
     )
 
 
+class ViewCalendarConfigPatch(StrictModel):
+    """日历视图特有配置 → viewgraphCalendarConfigVO。"""
+
+    title_que_id: int = Field(validation_alias=AliasChoices("title_que_id", "titleQueId"))
+    date_que_id: int = Field(validation_alias=AliasChoices("date_que_id", "dateQueId"))
+    color_que_id: int | None = Field(default=None, validation_alias=AliasChoices("color_que_id", "colorQueId"))
+
+
 class ViewDisplayConfigPatch(StrictModel):
     """展示杂项 → defaultRowHigh/beingPinNavigate/remark。"""
 
@@ -1429,6 +1438,7 @@ class ViewUpsertPatch(StrictModel):
     card: ViewCardConfigPatch | None = Field(default=None)
     gantt: ViewGanttConfigPatch | None = Field(default=None)
     hierarchy: ViewHierarchyConfigPatch | None = Field(default=None)
+    calendar: ViewCalendarConfigPatch | None = Field(default=None)
     display: ViewDisplayConfigPatch | None = Field(default=None)
     record: ViewRecordConfigPatch | None = Field(default=None)
     share: ViewShareConfigPatch | None = Field(default=None)
@@ -1497,6 +1507,10 @@ class ViewUpsertPatch(StrictModel):
                 payload["type"] = "board"
             elif normalized == "ganttview":
                 payload["type"] = "gantt"
+            elif normalized == "hierarchyview":
+                payload["type"] = "hierarchy"
+            elif normalized == "calendarview":
+                payload["type"] = "calendar"
         return payload
 
     @model_validator(mode="after")
@@ -1512,6 +1526,11 @@ class ViewUpsertPatch(StrictModel):
                 raise ValueError("hierarchy view requires hierarchy.title_que_id and children_que_id")
         elif self.hierarchy is not None:
             raise ValueError("hierarchy config is only allowed on hierarchy views")
+        if self.type == PublicViewType.calendar:
+            if self.calendar is None:
+                raise ValueError("calendar view requires calendar.title_que_id and date_que_id")
+        elif self.calendar is not None:
+            raise ValueError("calendar config is only allowed on calendar views")
         if self.type != PublicViewType.card and self.card is not None:
             raise ValueError("card config is only allowed on card views")
         if self.type != PublicViewType.gantt and self.gantt is not None:

package/src/qingflow_mcp/builder_facade/schemas/views/manifest.json

@@ -32,11 +32,10 @@
         "card",
         "board",
         "gantt",
-        "hierarchy"
-      ],
-      "backendKnownUnsupportedViewTypes": [
+        "hierarchy",
         "calendar"
       ],
+      "backendKnownUnsupportedViewTypes": [],
       "status": "active"
     }
   }

package/src/qingflow_mcp/builder_facade/schemas/views/v1alpha1/complete.json

@@ -2,7 +2,7 @@
   "$schema": "https://json-schema.org/draft/2020-12/schema",
   "$id": "https://qingflow.com/schemas/builder/views/v1alpha1/complete.json",
   "title": "Qingflow Builder Views Declaration · complete (v1alpha1)",
-  "viewCompleteDescription": "视图完整声明(完整版 spec):summary 的严格超集,覆盖 app_views_apply 当前支持的公开语义——数据权限/可见性授权/筛选/排序/查询条件/按钮配置/关联资源/类型特有配置(card/gantt/hierarchy)/展示与记录开关/分享安全。展示、排序、筛选和类型专属字段使用整数 queId;查询条件 rows 兼容字段名或 ID。打印模板明细、附件权限、列级权限、高级筛选公式和 calendar 尚未进入公开写入契约。schema 校验在别名归一之后执行,只约束规范名。各配置域的专项 Schema(含清空/替换语义)通过 app_views_schema 换 schema_kind 获取(见 x-qingflow-related-schemas)。",
+  "viewCompleteDescription": "视图完整声明(完整版 spec):summary 的严格超集,覆盖 app_views_apply 当前支持的公开语义——数据权限/可见性授权/筛选/排序/查询条件/按钮配置/关联资源/类型特有配置(card/gantt/hierarchy/calendar)/展示与记录开关/分享安全。展示、排序、筛选和类型专属字段使用整数 queId;查询条件 rows 兼容字段名或 ID。打印模板明细、附件权限、列级权限和高级筛选公式尚未进入公开写入契约。schema 校验在别名归一之后执行,只约束规范名。各配置域的专项 Schema(含清空/替换语义)通过 app_views_schema 换 schema_kind 获取(见 x-qingflow-related-schemas)。",
   "$defs": {
     "ViewDeclaration": {
       "type": "object",
@@ -26,6 +26,7 @@
           "type": "string",
           "minLength": 1,
           "maxLength": 200,
+          "viewNameDescription": "视图名称;未提供 view_key 时按 name 唯一匹配决定更新或创建,重名报 AMBIGUOUS_VIEW。",
           "x-backend": "viewgraphName"
         },
         "type": {
@@ -35,10 +36,11 @@
             "card",
             "board",
             "gantt",
-            "hierarchy"
+            "hierarchy",
+            "calendar"
           ],
-          "viewTypeDescription": "完整版在四公开类型之上增加 hierarchy(层级视图;summary 档不含,dataset-v0 有 2 例)。",
-          "x-backend": "viewgraphType(tableView/cardView/boardView/ganttView/hierarchyView)"
+          "viewTypeDescription": "支持表格、卡片、看板、甘特、层级和日历视图。",
+          "x-backend": "viewgraphType(tableView/cardView/boardView/ganttView/hierarchyView/calendarView)"
         },
         "columns": {
           "type": "array",
@@ -134,6 +136,11 @@
           "hierarchyDescription": "层级视图特有配置(hierarchy 类型适用,必填)。",
           "x-backend": "viewgraphHierarchyConfigVO(titleQueId/childrenQueId/rootNodeFilter)"
         },
+        "calendar": {
+          "$ref": "#/$defs/CalendarConfig",
+          "calendarDescription": "日历视图特有配置(calendar 类型适用,必填)。",
+          "x-backend": "viewgraphCalendarConfigVO(titleQueId/dateQueId/colorQueId)"
+        },
         "display": {
           "$ref": "#/$defs/DisplayConfig",
           "displayDescription": "展示杂项:行高/固定导航/备注。",
@@ -291,6 +298,13 @@
               "hierarchy"
             ]
           }
+        },
+        {
+          "if": {
+            "properties": { "type": { "const": "calendar" } },
+            "required": ["type"]
+          },
+          "then": { "required": ["calendar"] }
         }
       ]
     },
@@ -497,10 +511,12 @@
         "ascending": {
           "type": "boolean",
           "default": true,
+          "ascendingDescription": "是否升序;默认 true。",
           "x-backend": "beingSortAscend"
         },
         "que_id": {
           "type": "integer",
+          "queIdDescription": "排序字段 queId。别名 fieldName/field/name。",
           "x-backend": "ViewgraphSortQuestion.queId"
         }
       }
@@ -512,11 +528,13 @@
         "enabled": {
           "type": "boolean",
           "default": true,
+          "enabledDescription": "是否开启查询面板。",
           "x-backend": "queryConditionStatus"
         },
         "exact": {
           "type": "boolean",
           "default": false,
+          "exactDescription": "是否精确匹配;true=多条件同时满足,false=任一满足。",
           "x-backend": "queryConditionExact"
         },
         "hide_before_query": {
@@ -813,31 +831,37 @@
             "default",
             "fill"
           ],
+          "clippingModeDescription": "封面裁剪模式:default=默认,fill=填充。",
           "x-backend": "clippingMode(default 实测)"
         },
         "image_adaption": {
           "type": "boolean",
           "default": false,
+          "imageAdaptionDescription": "封面图是否自适应尺寸。",
           "x-backend": "beingImageAdaption"
         },
         "show_field_title": {
           "type": "boolean",
           "default": true,
+          "showFieldTitleDescription": "是否显示字段标题。",
           "x-backend": "beingShowQueTitle"
         },
         "show_title": {
           "type": "boolean",
           "default": true,
+          "showTitleDescription": "是否显示卡片标题。",
           "x-backend": "beingShowTitleQue"
         },
         "show_cover": {
           "type": "boolean",
           "default": false,
+          "showCoverDescription": "是否显示封面图。",
           "x-backend": "beingShowCover"
         },
         "group_color": {
           "type": "boolean",
           "default": false,
+          "groupColorDescription": "分组是否显示颜色标识。",
           "x-backend": "beingGroupColor"
         },
         "group_que_id": {
@@ -870,6 +894,7 @@
             "year"
           ],
           "default": "month",
+          "defaultTimeDimensionDescription": "默认时间维度:day/week/month/year。",
           "x-backend": "defaultTimeDimension(month×8/week×4 实测)"
         },
         "auto_calibration": {
@@ -880,16 +905,18 @@
         },
         "groups": {
           "type": "array",
+          "groupsDescription": "甘特分组字段列表,按 ordinal 排序。",
           "items": {
             "type": "object",
             "additionalProperties": false,
             "properties": {
               "ordinal": {
-                "type": "integer"
+                "type": "integer",
+                "ordinalDescription": "分组展示顺序。"
               },
               "que_id": {
                 "type": "integer",
-                "minLength": 1
+                "queIdDescription": "分组字段 queId。"
               }
             }
           },
@@ -898,6 +925,7 @@
         "dependencies": {
           "type": "array",
           "maxItems": 1,
+          "dependenciesDescription": "任务依赖关系;后端为单对象,v1alpha1 限 1 条。",
           "items": {
             "$ref": "#/$defs/GanttDependency"
           },
@@ -905,14 +933,17 @@
         },
         "start_que_id": {
           "type": "integer",
+          "startQueIdDescription": "甘特开始时间字段 queId;与顶层 start_que_id 等价,取其一。",
           "x-backend": "startTimeQueId"
         },
         "end_que_id": {
           "type": "integer",
+          "endQueIdDescription": "甘特结束时间字段 queId;与顶层 end_que_id 等价,取其一。",
           "x-backend": "endTimeQueId"
         },
         "title_que_id": {
           "type": "integer",
+          "titleQueIdDescription": "甘特标题字段 queId;与顶层 title_que_id 等价。",
           "x-backend": "titleQueId"
         }
       }
@@ -927,28 +958,32 @@
       "properties": {
         "start_start_option_id": {
           "type": "integer",
+          "startStartOptionIdDescription": "开始→开始依赖的偏移选项 id(可选)。",
           "x-backend": "startStartOptionId"
         },
         "start_end_option_id": {
           "type": "integer",
+          "startEndOptionIdDescription": "开始→结束依赖的偏移选项 id(可选)。",
           "x-backend": "startEndOptionId"
         },
         "end_start_option_id": {
           "type": "integer",
+          "endStartOptionIdDescription": "结束→开始依赖的偏移选项 id(可选)。",
           "x-backend": "endStartOptionId"
         },
         "end_end_option_id": {
           "type": "integer",
+          "endEndOptionIdDescription": "结束→结束依赖的偏移选项 id(可选)。",
           "x-backend": "endEndOptionId"
         },
         "dependency_que_id": {
           "type": "integer",
-          "minLength": 1,
+          "dependencyQueIdDescription": "被依赖(后续)任务的关联字段 queId。",
           "x-backend": "dependencyQueId"
         },
         "predecessor_que_id": {
           "type": "integer",
-          "minLength": 1,
+          "predecessorQueIdDescription": "前置任务的关联字段 queId。",
           "x-backend": "predecessorTaskQueId"
         }
       }
@@ -974,14 +1009,26 @@
         },
         "title_que_id": {
           "type": "integer",
+          "titleQueIdDescription": "层级标题字段 queId。",
           "x-backend": "viewgraph_hierarchy_config.titleQueId"
         },
         "children_que_id": {
           "type": "integer",
+          "childrenQueIdDescription": "子节点关联字段 queId(引用/关联字段)。",
           "x-backend": "childrenQueId"
         }
       }
     },
+    "CalendarConfig": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["title_que_id", "date_que_id"],
+      "properties": {
+        "title_que_id": { "type": "integer", "calendarTitleQueIdDescription": "日历事项标题字段 queId。", "x-backend": "titleQueId" },
+        "date_que_id": { "type": "integer", "calendarDateQueIdDescription": "日历日期字段 queId；可使用表单日期字段或系统字段申请时间(2)/更新时间(3)。", "x-backend": "dateQueId" },
+        "color_que_id": { "type": "integer", "calendarColorQueIdDescription": "可选的日历颜色字段 queId。", "x-backend": "colorQueId" }
+      }
+    },
     "DisplayConfig": {
       "type": "object",
       "additionalProperties": false,
@@ -994,15 +1041,18 @@
             "highest",
             "high"
           ],
+          "rowHeightDescription": "表格行高:compact=紧凑,moderate=适中,high=高,highest=最高。",
           "x-backend": "defaultRowHigh(compact×705 实测)"
         },
         "pin_navigate": {
           "type": "boolean",
           "default": false,
+          "pinNavigateDescription": "是否固定视图内导航;与顶层 pinned(视图列表固定)无关。",
           "x-backend": "beingPinNavigate"
         },
         "remark": {
           "type": "string",
+          "remarkDescription": "视图备注。",
           "x-backend": "remark"
         }
       }
@@ -1014,26 +1064,31 @@
         "audit_visible": {
           "type": "boolean",
           "default": true,
+          "auditVisibleDescription": "是否显示操作记录。",
           "x-backend": "beingAuditRecordVisible"
         },
         "data_log_visible": {
           "type": "boolean",
           "default": true,
+          "dataLogVisibleDescription": "是否显示数据日志(字段变更历史)。",
           "x-backend": "beingDataLogVisible"
         },
         "qrobot_record_visible": {
           "type": "boolean",
           "default": false,
+          "qrobotRecordVisibleDescription": "是否显示机器人记录。",
           "x-backend": "beingQrobotRecordVisible"
         },
         "workflow_future_visible": {
           "type": "boolean",
           "default": true,
+          "workflowFutureVisibleDescription": "是否显示流程未来节点。",
           "x-backend": "beingWorkflowNodeFutureListVisible"
         },
         "comment": {
           "type": "boolean",
           "default": false,
+          "commentDescription": "是否开启留言。",
           "x-backend": "beingCommentStatus"
         }
       }
@@ -1045,6 +1100,7 @@
         "need_pass": {
           "type": "boolean",
           "default": false,
+          "needPassDescription": "分享是否需要访问密码;true 时用 password 提供密码。",
           "x-backend": "beingNeedPass"
         },
         "password": {
@@ -1055,6 +1111,7 @@
         "force_login": {
           "type": "boolean",
           "default": false,
+          "forceLoginDescription": "分享是否强制登录后查看。",
           "x-backend": "beingForceLogin"
         },
         "print_enabled": {
@@ -1071,7 +1128,7 @@
     {
       "kind": "display",
       "displayDescription": "展示字段、排序、关联资源和各公开视图类型的专属配置。",
-      "fields": ["columns", "sort", "card", "gantt", "hierarchy", "associated_resources", "display", "group_que_id", "title_que_id", "start_que_id", "end_que_id"]
+      "fields": ["columns", "sort", "card", "gantt", "hierarchy", "calendar", "associated_resources", "display", "group_que_id", "title_que_id", "start_que_id", "end_que_id"]
     },
     {
       "kind": "data-permission",
@@ -1102,7 +1159,7 @@
     "kinds": {
       "summary": "最小创建声明:类型/名称/展示字段 + 数据权限形状。",
       "complete": "完整声明:全部公开可写字段,含各配置域与类型专属配置。",
-      "display": "展示字段、排序、卡片/甘特/层级配置、分组字段和关联资源。",
+      "display": "展示字段、排序、卡片/甘特/层级/日历配置、分组字段和关联资源。",
       "data-permission": "数据权限模式、数据范围和固定筛选条件。",
       "operation-permission": "成员可见范围、记录日志、留言、打印和分享策略。",
       "query-condition": "用户查询面板的开关、匹配模式和字段布局。",
@@ -1121,11 +1178,6 @@
     "backend_warning": "底层 ViewgraphInfo 更新接口对部分省略字段会执行 false、true、空数组或空字符串初始化，因此不得把直接后端请求中的省略统一理解为保留。"
   },
   "x-qingflow-backend-known-unsupported": {
-    "calendar": {
-      "backend": "viewgraphType=calendarView + viewgraphCalendarConfigVO",
-      "status": "not-writable",
-      "reason": "当前 app_views_apply 编译器没有 calendar 分支。"
-    },
     "column_permissions": {
       "backend": "viewgraphQuestions/ViewgraphQuestion",
       "status": "not-writable",

package/src/qingflow_mcp/builder_facade/schemas/views/v1alpha1/details/button-config.json

@@ -6,9 +6,9 @@
   "type": "object",
   "additionalProperties": false,
   "properties": {
-    "action_buttons": { "type": "array", "items": { "$ref": "../complete.json#/$defs/ActionButton" }, "maxItems": 60 },
-    "action_buttons_mode": { "type": "string", "enum": ["merge", "replace"], "default": "merge" },
-    "buttons": { "type": "array", "items": { "$ref": "../complete.json#/$defs/ButtonBinding" }, "maxItems": 60 },
+    "action_buttons": { "type": "array", "items": { "$ref": "../complete.json#/$defs/ActionButton" }, "maxItems": 60, "actionButtonsDescription": "系统动作按钮(add_data/link/qRobot/wings);省略保留现有,空数组清空。" },
+    "action_buttons_mode": { "type": "string", "enum": ["merge", "replace"], "default": "merge", "actionButtonsModeDescription": "merge=与现有按钮合并(默认),replace=按声明全量替换。" },
+    "buttons": { "type": "array", "items": { "$ref": "../complete.json#/$defs/ButtonBinding" }, "maxItems": 60, "buttonsDescription": "已有自定义按钮的视图绑定(按 button_id 引用,维护位置/主次/显隐)。" },
     "query_conditions": { "$ref": "../complete.json#/$defs/QueryConditions", "queryConditionsDescription": "搜索按钮配置依赖的查询面板。" }
   },
   "x-qingflow-related-schemas": {

package/src/qingflow_mcp/builder_facade/schemas/views/v1alpha1/details/data-permission.json

@@ -6,7 +6,7 @@
   "type": "object",
   "additionalProperties": false,
   "properties": {
-    "data_permission": { "$ref": "../complete.json#/$defs/DataPermission" },
+    "data_permission": { "$ref": "../complete.json#/$defs/DataPermission", "dataPermissionDescription": "数据权限生效类型(config/custom)与数据范围(scope)。" },
     "filters": {
       "type": "array",
       "items": { "anyOf": [

package/src/qingflow_mcp/builder_facade/schemas/views/v1alpha1/details/display.json

@@ -2,20 +2,21 @@
   "$schema": "https://json-schema.org/draft/2020-12/schema",
   "$id": "https://qingflow.com/schemas/builder/views/v1alpha1/details/display.json",
   "title": "Qingflow Views display configuration",
-  "displayDescription": "视图展示配置片段(schema_kind=display),字段直接并入完整视图声明。所有字段引用均为实际整数 queId；calendar 等当前 apply 不支持的类型不在公开 schema 中。",
+  "displayDescription": "视图展示配置片段(schema_kind=display),字段直接并入完整视图声明。所有字段引用均为实际整数 queId。",
   "type": "object",
   "additionalProperties": false,
   "properties": {
     "pinned": { "type": "boolean", "pinnedDescription": "是否固定在应用的视图列表顶部。true=固定，false=取消固定；省略时保持当前状态。它与 display.pin_navigate 无关。", "x-backend": "POST /app/{appKey}/view/ordinal (FIXED_VIEW_LIST|VIEW_LIST)" },
     "columns": { "type": "array", "items": { "type": "integer" }, "minItems": 1, "columnsDescription": "表格或卡片展示字段，按数组顺序显示。" },
     "sort": { "type": "array", "items": { "$ref": "../complete.json#/$defs/SortRule" }, "sortDescription": "多级排序。空数组恢复默认排序。" },
-    "card": { "$ref": "../complete.json#/$defs/CardConfig" },
-    "gantt": { "$ref": "../complete.json#/$defs/GanttConfig" },
-    "hierarchy": { "$ref": "../complete.json#/$defs/HierarchyConfig" },
-    "associated_resources": { "$ref": "../complete.json#/$defs/AssociatedResources" },
-    "display": { "$ref": "../complete.json#/$defs/DisplayConfig" },
+    "card": { "$ref": "../complete.json#/$defs/CardConfig", "cardDescription": "卡片视图配置(封面/标题/字段标题/分组)。" },
+    "gantt": { "$ref": "../complete.json#/$defs/GanttConfig", "ganttDescription": "甘特视图配置(时间维度/分组/依赖)。" },
+    "hierarchy": { "$ref": "../complete.json#/$defs/HierarchyConfig", "hierarchyDescription": "层级视图配置(必填 title_que_id/children_que_id,可选 root_filter)。" },
+    "calendar": { "$ref": "../complete.json#/$defs/CalendarConfig", "calendarDescription": "日历视图配置(必填 title_que_id/date_que_id)。" },
+    "associated_resources": { "$ref": "../complete.json#/$defs/AssociatedResources", "associatedResourcesDescription": "关联报表/图表资源展示配置;应用级资源池用 app_associated_resources_apply 维护。" },
+    "display": { "$ref": "../complete.json#/$defs/DisplayConfig", "displayMiscDescription": "展示杂项(行高/视图内导航固定/备注)。" },
     "group_que_id": { "type": "integer", "groupQueIdDescription": "看板分组字段 queId。" },
-    "title_que_id": { "type": "integer", "titleQueIdDescription": "卡片、甘特或层级标题字段 queId。" },
+    "title_que_id": { "type": "integer", "titleQueIdDescription": "卡片、甘特、层级或日历标题字段 queId。" },
     "start_que_id": { "type": "integer", "startQueIdDescription": "甘特开始时间字段 queId。" },
     "end_que_id": { "type": "integer", "endQueIdDescription": "甘特结束时间字段 queId。" }
   },
@@ -27,7 +28,7 @@
     "kinds": {
       "summary": "最小创建声明:类型/名称/展示字段 + 数据权限形状。",
       "complete": "完整声明:全部公开可写字段,含各配置域与类型专属配置。",
-      "display": "展示字段、排序、卡片/甘特/层级配置、分组字段和关联资源。",
+      "display": "展示字段、排序、卡片/甘特/层级/日历配置、分组字段和关联资源。",
       "data-permission": "数据权限模式、数据范围和固定筛选条件。",
       "operation-permission": "成员可见范围、记录日志、留言、打印和分享策略。",
       "query-condition": "用户查询面板的开关、匹配模式和字段布局。",
@@ -56,16 +57,17 @@
     "card": "columns 至少包含一个业务字段；标题和封面等使用 card。",
     "board": "必须提供 group_que_id。",
     "gantt": "必须提供 start_que_id 和 end_que_id，或在 gantt 中提供等价字段。",
-    "hierarchy": "必须提供 hierarchy.title_que_id 和 hierarchy.children_que_id。"
+    "hierarchy": "必须提供 hierarchy.title_que_id 和 hierarchy.children_que_id。",
+    "calendar": "必须提供 calendar.title_que_id 和 calendar.date_que_id。date_que_id 可为表单日期字段或系统字段 2(申请时间)/3(更新时间)。"
   },
   "x-qingflow-unsupported": {
-    "calendar": "app_views_apply 当前不支持 calendar；后端对应 calendarView + viewgraphCalendarConfigVO。",
     "column_permissions": "列级可编辑、隐藏、下载等 ViewgraphQuestion 配置尚未进入公开 DSL。"
   },
   "examples": [
     { "columns": [101, 102], "sort": [{ "que_id": 101, "ascending": true }] },
     { "group_que_id": 103, "title_que_id": 101, "card": { "show_title": true, "group_color": true } },
     { "gantt": { "title_que_id": 101, "start_que_id": 104, "end_que_id": 105, "default_time_dimension": "month", "auto_calibration": false } },
-    { "hierarchy": { "title_que_id": 101, "children_que_id": 106, "root_filter": [] } }
+    { "hierarchy": { "title_que_id": 101, "children_que_id": 106, "root_filter": [] } },
+    { "calendar": { "title_que_id": 101, "date_que_id": 104, "color_que_id": 103 } }
   ]
 }

package/src/qingflow_mcp/builder_facade/schemas/views/v1alpha1/details/operation-permission.json

@@ -6,9 +6,9 @@
   "type": "object",
   "additionalProperties": false,
   "properties": {
-    "visibility": { "$ref": "../complete.json#/$defs/Visibility" },
-    "record": { "$ref": "../complete.json#/$defs/RecordConfig" },
-    "share": { "$ref": "../complete.json#/$defs/ShareConfig" }
+    "visibility": { "$ref": "../complete.json#/$defs/Visibility", "visibilityDescription": "对内可见范围 + 外部成员授权。" },
+    "record": { "$ref": "../complete.json#/$defs/RecordConfig", "recordDescription": "记录可见性开关:操作记录/数据日志/机器人记录/流程未来节点/留言。" },
+    "share": { "$ref": "../complete.json#/$defs/ShareConfig", "shareDescription": "分享与安全:密码/强制登录/打印。" }
   },
   "x-qingflow-related-schemas": {
     "currentKind": "operation-permission",

package/src/qingflow_mcp/builder_facade/schemas/views/v1alpha1/details/query-condition.json

@@ -6,7 +6,7 @@
   "type": "object",
   "additionalProperties": false,
   "properties": {
-    "query_conditions": { "$ref": "../complete.json#/$defs/QueryConditions" }
+    "query_conditions": { "$ref": "../complete.json#/$defs/QueryConditions", "queryConditionsDescription": "查询面板开关/匹配模式/查询前隐藏/行列布局。" }
   },
   "x-qingflow-related-schemas": {
     "currentKind": "query-condition",

package/src/qingflow_mcp/builder_facade/schemas/views/v1alpha1/summary.json

@@ -35,10 +35,12 @@
             "table",
             "card",
             "board",
-            "gantt"
+            "gantt",
+            "hierarchy",
+            "calendar"
           ],
-          "viewTypeDescription": "视图类型。别名归一:tableView→table、cardView→card、kanban→board、ganttView→gantt。summary 档不含 hierarchy(仅 complete 档)。",
-          "x-backend": "viewgraph.viewgraphType(tableView/cardView/boardView/ganttView)"
+          "viewTypeDescription": "视图类型。别名归一:tableView→table、cardView→card、kanban→board、ganttView→gantt、hierarchyView→hierarchy、calendarView→calendar。",
+          "x-backend": "viewgraph.viewgraphType(tableView/cardView/boardView/ganttView/hierarchyView/calendarView)"
         },
         "columns": {
           "type": "array",
@@ -57,7 +59,8 @@
           "groupQueIdDescription": "分组字段 queId"
         },
         "title_que_id": {
-          "type": "integer"
+          "type": "integer",
+          "titleQueIdDescription": "卡片/看板/甘特/层级标题字段 queId(可选)。"
         },
         "start_que_id": {
           "type": "integer",
@@ -68,6 +71,14 @@
           "type": "integer",
           "endQueIdDescription": "甘特结束时间字段 queId(gantt 必填)。别名 endField。",
           "x-backend": "viewgraphGanttConfigVO.endTimeQueId"
+        },
+        "hierarchy": {
+          "$ref": "#/$defs/HierarchyConfig",
+          "hierarchyDescription": "层级视图特有配置(hierarchy 类型适用,必填)。"
+        },
+        "calendar": {
+          "$ref": "#/$defs/CalendarConfig",
+          "calendarDescription": "日历视图特有配置(calendar 类型适用,必填)。"
         }
       },
       "allOf": [
@@ -149,9 +160,42 @@
               "end_que_id"
             ]
           }
+        },
+        {
+          "if": {
+            "properties": { "type": { "const": "hierarchy" } },
+            "required": ["type"]
+          },
+          "then": { "required": ["hierarchy"] }
+        },
+        {
+          "if": {
+            "properties": { "type": { "const": "calendar" } },
+            "required": ["type"]
+          },
+          "then": { "required": ["calendar"] }
         }
       ]
     },
+    "HierarchyConfig": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["title_que_id", "children_que_id"],
+      "properties": {
+        "title_que_id": { "type": "integer", "hierarchyTitleQueIdDescription": "层级节点标题字段 queId。" },
+        "children_que_id": { "type": "integer", "hierarchyChildrenQueIdDescription": "层级父子关系字段 queId。" }
+      }
+    },
+    "CalendarConfig": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["title_que_id", "date_que_id"],
+      "properties": {
+        "title_que_id": { "type": "integer", "calendarTitleQueIdDescription": "日历事项标题字段 queId。" },
+        "date_que_id": { "type": "integer", "calendarDateQueIdDescription": "日历日期字段 queId；可使用表单日期字段或系统字段申请时间(2)/更新时间(3)。" },
+        "color_que_id": { "type": "integer", "calendarColorQueIdDescription": "可选的日历颜色字段 queId。" }
+      }
+    },
     "DataPermission": {
       "type": "object",
       "additionalProperties": false,
@@ -197,7 +241,7 @@
       "complete"
     ],
     "kindDescriptions": {
-      "display": "展示字段、排序、卡片/甘特/层级配置、分组字段和关联资源。",
+      "display": "展示字段、排序、卡片/甘特/层级/日历配置、分组字段和关联资源。",
       "data-permission": "数据权限模式、数据范围和固定筛选条件。",
       "operation-permission": "成员可见范围、记录日志、留言、打印和分享策略。",
       "query-condition": "用户查询面板的开关、匹配模式和字段布局。",
@@ -247,7 +291,6 @@
   "x-qingflow-capability-boundary": {
     "contract": "仅列出 app_views_apply 当前可写字段。",
     "backendKnownUnsupported": {
-      "calendar": "后端存在 calendarView DTO，但当前 app_views_apply 不支持创建或更新日历视图。",
       "column_permissions": "后端 ViewgraphQuestion 支持列级查看、编辑和下载权限，当前公开 DSL 尚未开放。",
       "advanced_filter_formula": "后端支持 viewgraphLimitFormula，当前 filters 只公开简易条件。",
       "print_templates": "后端支持默认打印模板和 printTpls 绑定，当前只公开打印开关。",
@@ -255,6 +298,8 @@
     }
   },
   "examples": [
+    { "name": "任务层级", "type": "hierarchy", "hierarchy": { "title_que_id": 101, "children_que_id": 106 } },
+    { "name": "事项日历", "type": "calendar", "calendar": { "title_que_id": 101, "date_que_id": 104, "color_que_id": 103 } },
     {
       "name": "业务记录",
       "type": "table",

package/src/qingflow_mcp/builder_facade/service.py

@@ -12460,7 +12460,12 @@ class AiBuilderFacade:
                         suggested_next_call={"tool_name": "app_get_fields", "arguments": {"profile": profile, "app_key": app_key}},
                     )
             for group_name, config_que_ids in _iter_view_config_group_field_names(patch):
-                missing_config_fields = [que for que in config_que_ids if que not in fields_by_que_id]
+                calendar_system_date = (
+                    {patch.calendar.date_que_id}
+                    if group_name == "calendar" and patch.calendar is not None and patch.calendar.date_que_id in {2, 3}
+                    else set()
+                )
+                missing_config_fields = [que for que in config_que_ids if que not in fields_by_que_id and que not in calendar_system_date]
                 if missing_config_fields:
                     return _failed(
                         "UNKNOWN_VIEW_FIELD",
@@ -20942,6 +20947,8 @@ def _normalize_portal_view_type(view: dict[str, Any]) -> str:
         "ganttView": "ganttView",
         "hierarchy": "hierarchyView",
         "hierarchyView": "hierarchyView",
+        "calendar": "calendarView",
+        "calendarView": "calendarView",
     }
     return mapping.get(raw, "tableView")
 
@@ -29741,6 +29748,8 @@ def _normalize_view_type_name(value: Any) -> str:
         return "board"
     if "hierarchy" in normalized:
         return "hierarchy"
+    if "calendar" in normalized:
+        return "calendar"
     if "card" in normalized:
         return "card"
     return "table"
@@ -29847,6 +29856,10 @@ def _build_view_update_payload(
         payload["viewgraphType"] = "hierarchyView"
         payload["beingShowTitleQue"] = True
         payload.pop("groupQueId", None)
+    elif normalized_type == "calendar":
+        payload["viewgraphType"] = "calendarView"
+        payload["beingShowTitleQue"] = True
+        payload.pop("groupQueId", None)
     return _hydrate_view_backend_payload(
         payload=payload,
         view_type=normalized_type,
@@ -29949,6 +29962,7 @@ def _build_minimal_view_payload(
             "board": "boardView",
             "gantt": "ganttView",
             "hierarchy": "hierarchyView",
+            "calendar": "calendarView",
         }[patch.type.value],
         "ordinal": ordinal,
         "viewgraphQueIds": visible_que_id_values,
@@ -30067,6 +30081,11 @@ def _hydrate_view_backend_payload(
         data["beingShowTitleQue"] = True
         data["groupQueId"] = None
         data["viewgraphGanttConfigVO"] = None
+    elif view_type == "calendar":
+        data["viewgraphType"] = "calendarView"
+        data["beingShowTitleQue"] = True
+        data["groupQueId"] = None
+        data["viewgraphGanttConfigVO"] = None
     if view_filters is not None:
         data["viewgraphLimit"] = deepcopy(view_filters)
         data["viewgraphLimitType"] = 1
@@ -30164,6 +30183,13 @@ def _apply_view_config_groups(
             "rootNodeFilter": deepcopy(hierarchy_filter_groups) if hierarchy_filter_groups is not None else [],
         }
         data["titleQue"] = patch.hierarchy.title_que_id
+    if patch.calendar is not None and view_type == "calendar":
+        data["viewgraphCalendarConfigVO"] = {
+            "titleQueId": patch.calendar.title_que_id,
+            "dateQueId": patch.calendar.date_que_id,
+            "colorQueId": patch.calendar.color_que_id,
+        }
+        data["titleQue"] = patch.calendar.title_que_id
     display = patch.display
     if display is not None:
         if display.row_height is not None:
@@ -30231,6 +30257,11 @@ def _iter_view_config_group_field_names(patch: ViewUpsertPatch) -> list[tuple[st
             groups.append(("gantt", gantt_ids))
     if patch.hierarchy is not None:
         groups.append(("hierarchy", [patch.hierarchy.title_que_id, patch.hierarchy.children_que_id]))
+    if patch.calendar is not None:
+        calendar_ids = [patch.calendar.title_que_id, patch.calendar.date_que_id]
+        if patch.calendar.color_que_id is not None:
+            calendar_ids.append(patch.calendar.color_que_id)
+        groups.append(("calendar", calendar_ids))
     return groups
 
 
@@ -30241,6 +30272,8 @@ def _resolve_view_visible_que_ids(patch: ViewUpsertPatch) -> list[int]:
     extra_ids: list[int | None] = []
     if patch.hierarchy is not None:
         extra_ids.extend([patch.hierarchy.title_que_id, patch.hierarchy.children_que_id])
+    if patch.calendar is not None:
+        extra_ids.extend([patch.calendar.title_que_id, patch.calendar.date_que_id, patch.calendar.color_que_id])
     for value in [*patch.columns, patch.title_que_id, patch.start_que_id, patch.end_que_id, patch.group_que_id, *extra_ids]:
         que_id = _coerce_any_int(value)
         if que_id is not None and (que_id > 0 or _is_known_system_view_que_id(que_id)) and que_id not in ordered:

package/src/qingflow_mcp/builder_facade/views_extract.py

@@ -25,6 +25,7 @@ _VIEW_TYPE_BY_BACKEND = {
     "boardView": "board",
     "ganttView": "gantt",
     "hierarchyView": "hierarchy",
+    "calendarView": "calendar",
 }
 
 # 后端 dataScope → 公开 data_permission.scope(与 _DATA_PERMISSION_SCOPE_MAP 对称)
@@ -68,7 +69,6 @@ _SYSTEM_COLUMN_NAMES = {
 # complete 契约不覆盖、读面存在的配置键(进入 SKIP 账本,evaluation.md §4.3)
 _UNCOVERED_READBACK_KEYS = (
     "attachVisibleOnlyConfig",
-    "viewgraphCalendarConfigVO",
     "beingRemarkStatus",
     "querySearchStatus",
     "beingDefaultPrintTplStatus",
@@ -417,6 +417,26 @@ def extract_complete_view_declaration(
         declaration["hierarchy"] = hierarchy
         _optionally(declaration, "title_que_id", title_que)
 
+    if view_type == "calendar":
+        calendar_raw = view_info.get("viewgraphCalendarConfigVO") if isinstance(view_info.get("viewgraphCalendarConfigVO"), dict) else {}
+        title_que = _coerce_positive_int(calendar_raw.get("titleQueId"))
+        date_que = _coerce_any_int(calendar_raw.get("dateQueId"))
+        color_que = _coerce_positive_int(calendar_raw.get("colorQueId"))
+        if title_que is None or title_que not in fields_by_que_id:
+            gaps.append(_gap("calendar.title_que_id", "unresolved_calendar_config", "calendar title queId does not resolve; view is not extractable", que_id=title_que))
+            return {}, gaps
+        if date_que is None or (date_que not in {2, 3} and date_que not in fields_by_que_id):
+            gaps.append(_gap("calendar.date_que_id", "unresolved_calendar_config", "calendar date queId does not resolve; view is not extractable", que_id=date_que))
+            return {}, gaps
+        calendar: dict[str, Any] = {"title_que_id": title_que, "date_que_id": date_que}
+        if color_que is not None:
+            if color_que not in fields_by_que_id:
+                gaps.append(_gap("calendar.color_que_id", "unresolved_que_id", "calendar color queId does not resolve", que_id=color_que))
+                return {}, gaps
+            calendar["color_que_id"] = color_que
+        declaration["calendar"] = calendar
+        declaration["title_que_id"] = title_que
+
     if view_type in {"card", "board"}:
         _optionally(declaration, "title_que_id", _coerce_positive_int(view_info.get("titleQue")))
 

package/src/qingflow_mcp/solution/compiler/view_compiler.py

@@ -12,6 +12,7 @@ VIEW_TYPE_MAP = {
     ViewType.board: "boardView",
     ViewType.gantt: "ganttView",
     ViewType.hierarchy: "hierarchyView",
+    ViewType.calendar: "calendarView",
 }
 
 
@@ -32,7 +33,7 @@ def compile_views(entity: EntitySpec) -> list[dict[str, Any]]:
                     "viewgraphQueIds": list(view.field_ids),
                     "viewgraphQuestions": [],
                     "ordinal": ordinal,
-                    "beingShowTitleQue": view.type in (ViewType.card, ViewType.board, ViewType.gantt, ViewType.hierarchy),
+                    "beingShowTitleQue": view.type in (ViewType.card, ViewType.board, ViewType.gantt, ViewType.hierarchy, ViewType.calendar),
                     "beingShowCover": False,
                     "viewgraphLimitType": 1,
                     "viewgraphLimit": view.filters,

package/src/qingflow_mcp/solution/executor.py

@@ -911,13 +911,14 @@ class SolutionExecutor:
         data.setdefault("asosChartConfig", {"limitType": 1, "asosChartIdList": []})
         data.setdefault("viewgraphGanttConfigVO", None)
         data.setdefault("viewgraphHierarchyConfigVO", None)
+        data.setdefault("viewgraphCalendarConfigVO", None)
         data.setdefault("viewgraphLimitFormula", "")
         data.setdefault("buttonConfigDTOList", [])
         if not data.get("viewgraphQuestions"):
             data["viewgraphQuestions"] = _build_viewgraph_questions(schema, visible_que_ids)
         if not data.get("viewgraphSorts"):
             data["viewgraphSorts"] = [{"queId": 0, "beingSortAscend": True, "queType": 8}]
-        if data.get("viewgraphType") in {"cardView", "boardView", "ganttView", "hierarchyView"}:
+        if data.get("viewgraphType") in {"cardView", "boardView", "ganttView", "hierarchyView", "calendarView"}:
             data["titleQue"] = visible_que_ids[0] if visible_que_ids else None
         else:
             data.setdefault("titleQue", None)
@@ -2234,6 +2235,7 @@ def _portal_view_type(store: RunArtifactStore, entity_id: str, view_id: str) ->
         "board": "boardView",
         "gantt": "ganttView",
         "hierarchy": "hierarchyView",
+        "calendar": "calendarView",
     }
     for entity in store.data.get("normalized_solution_spec", {}).get("entities", []):
         if entity["entity_id"] != entity_id:

package/src/qingflow_mcp/solution/spec_models.py

@@ -56,6 +56,7 @@ class ViewType(str, Enum):
     board = "board"
     gantt = "gantt"
     hierarchy = "hierarchy"
+    calendar = "calendar"
 
 
 class ChartType(str, Enum):