@yijiancaotang/cli 1.0.0 → 1.1.0

package/dist/capability-result.js

@@ -38,6 +38,8 @@ export function commandAcceptsSwitch(args, capability) {
             eligible = op === "create" || op === "update" ? ["write_project"] : ["read_projects", "read_drafts"];
             break;
         case "search":
+            eligible = ["read_projects", "read_knowledge", "read_workbench"];
+            break;
         case "activity":
             eligible = ["read_projects", "read_knowledge"];
             break;
@@ -47,6 +49,9 @@ export function commandAcceptsSwitch(args, capability) {
         case "checkins":
             eligible = ["read_projects"];
             break;
+        case "context":
+            eligible = ["read_workbench"];
+            break;
         case "source":
         case "upload":
             eligible = ["write_knowledge_sources"];

package/dist/cli.js

@@ -15,17 +15,21 @@ import { ApiClient } from "./http.js";
 import { explicitUnknownWrite, redact, renderError, renderResult } from "./output.js";
 import { localDoctor, localSetup, localVersion, manualUpdateInstructions, selectedPlatforms } from "./local-commands.js";
 import { commandHelp } from "./command-help.js";
+import { scheduleCommandUsages } from "./schedule-help.js";
+import { calendarCommandUsages } from "./calendar-help.js";
+import { WRITE_ROUTING_HELP } from "./write-routing.js";
 import { flagError, validateCommandArguments } from "./input-validation.js";
 const help = {
     brand: "一间草堂",
     usage: "caotang --agent <你的名字> <command> [--env production|test] [--human]",
+    write_routing: WRITE_ROUTING_HELP,
     advance_example: { command: "caotang advance CARD_ID --input -", input: { internalization_status: "applied", source_type: "project", source_id: "PROJECT_ID", evidence_summary: "经本人确认，这张卡实际用于该项目的登录回归检查。" } },
     commands: ["setup [--platform claude-code,codex,openclaw,kimi-code,kimi-work,workbuddy] [--no-open]", "doctor [--platform claude-code,codex,openclaw,kimi-code,kimi-work,workbuddy]", "version", "update", "auth login [--device-name name] [--client-name name] [--no-open]", "auth status", "auth logout", "context [--since cursor]", "context --start", "rules", "activity --start-date YYYY-MM-DD --end-date YYYY-MM-DD [--limit N --offset N]", "projects", "project <id>", "project create --input file|-", "project update <id> --input file|-", "progress list <id>", "checkins", "progress add <id> --input file|- [--idempotency-key key]", "cognition set <id> --input file|-", "stage set <id> --input file|-", "knowledge", "knowledge show <id>", "search [query]", "knowledge add --input file|-", "knowledge update <id> --input file|-", "source add <id> --input file|-", "link <card> <project> [--core]", "unlink <card> <project>", "advance <card> --input file|-", "upload <pdf> --card <id> [--source-title title]", "pending", "notifications [--filter all|unread|read|agent]", "drafts", "request delete --input file|-", "request archive --input file|-", "request visibility --input file|-"],
     platform_scope: "kimi-code、kimi-work（Kimi.app工作模式）和workbuddy仅支持macOS本机安装；目录发现不代表真实AI端到端通过。Kimi Code和Kimi工作模式是独立入口，不互相代替。",
     options: ["--limit", "--offset", "--q", "--project", "--topic", "--status", "--publication-status", "--start-date YYYY-MM-DD", "--end-date YYYY-MM-DD", "--date-field created_at|updated_at", "--since", "notifications: --filter", "upload: --source-title / --summary"],
     command_help: "每个命令用 --help 查看自己的字段和固定 JSON 示例；写入 JSON 支持 --input -。knowledge 不带参数是知识列表；记录一件事完成了，用 progress add。source add 的 source_title 选填；progress add 的 visibility 省略时默认 private。",
     shared_connection: "每条命令都带 --agent <你的名字>，只有这个 AI 的连接会被读取、复用或断开。auth logout 先经本人确认，再吊销这个 AI 的连接；其它 AI 不受影响。重新接入使用相同名字 setup --agent <你的名字>，由本人在网页批准。",
-    query: "search [query]统一搜索项目、项目进展、知识和手写进展；省略或空白词按日期浏览，多个词全部命中、不分顺序和大小写，按字面匹配而非语义搜索。--status/--topic/--publication-status/--project只筛知识分支，--project不会限制其它类型；定向项目进展用progress list ID，仅知识用knowledge --q。搜索返回kind/snippet等统一结果项，不再是旧知识DTO；search、projects、knowledge可加--core-only只读筛选；结果is_core按项目已有标记、知识发芽及以上（applied/reviewed/templated）分别判断，它不是新的可写星标。只看核心项目默认不含已归档；显式 projects --core-only --status archived 可查已归档核心项目。只看核心不含项目进展和手写进展；要查核心项目的进展，先查核心项目，再用progress list ID。项目、知识、search、progress list、checkins支持北京时间含首尾日期与limit/offset分页，返回total、has_more、limit、offset；默认20/0，日期列表最多50条，pending最多100条。项目/知识默认updated_at，可created_at；进展固定created_at。pending默认有效待确认，--status all查历史。",
+    query: "search [query]统一搜索项目、项目进展、知识、手写进展、待办标题（pending/completed/cancelled，归read_workbench）和当天总结正文（归read_projects）；省略或空白词按日期浏览，多个词全部命中、不分顺序和大小写，按字面匹配而非语义搜索。--status/--topic/--publication-status/--project只筛知识分支，--project不会限制其它类型；定向项目进展用progress list ID，仅知识用knowledge --q。搜索返回kind/snippet等统一结果项，不再是旧知识DTO；search、projects、knowledge可加--core-only只读筛选；结果is_core按项目已有标记、知识发芽及以上（applied/reviewed/templated）分别判断，它不是新的可写星标。只看核心项目默认不含已归档；显式 projects --core-only --status archived 可查已归档核心项目。只看核心不含项目进展、手写进展、待办和当天总结；待办不继承所属项目核心标记。AI知识分支默认published，显式--publication-status all仍受read_drafts限制；搜索至少需read_projects/read_knowledge/read_workbench之一。要查核心项目的进展，先查核心项目，再用progress list ID。项目、知识、search、progress list、checkins支持北京时间含首尾日期与limit/offset分页，返回total、has_more、limit、offset；默认20/0，日期列表最多50条，pending最多100条。项目/知识/待办默认updated_at，可created_at；进展固定created_at。当天总结仅返date/confirmed_at，按业务日期筛选、按confirmed_at排序，不伪造created_at/updated_at，date_field不改变总结日期口径。pending默认有效待确认，--status all查历史。",
     activity: "activity仅接受必填起止日期与limit/offset，日期真实且北京时间含首尾最多一个日历年，闰日周年归一到3月1日。days是全范围日统计，不是当前页；items/total只含可读明细，默认20/0、最多50条。null和未完整覆盖不能解释为0，草稿受限不计入；只有符合资格的知识应用进展可匿名计数，不返身份/正文。不支持q、date-field、项目/长势/核心筛选。",
     knowledge_growth: `机器枚举保持不变；可读知识返回growth，真实变化返回from_growth/to_growth，安全逐级提示返回current_growth/next_growth（中文名、说明、level/total）。未返回或未知状态不推断，不补发请求。五级长势：${KNOWLEDGE_GROWTH_HELP}`,
     growth_confirmation: "用户说某张卡已经用上时，可以主动问一次：“你把这张卡用在这个项目，做了这件事，要记为发芽吗？”复述已知事实，只问缺的；未来打算、沉默、拒绝或只报项目名都不是同意。没有项目或尚未关联，先问要不要新建或关联，不同意就不推进。播种到发芽先说清“先生根、再发芽”，本人明确同意两步后才逐级调用；第一步未确认成功不发第二步。第二步明确失败只报最后确认的级别；待审或结果未知说明哪个结果未确认，不自动重试。 从生根进入发芽必须带 source_type=project、已关联的本人项目 source_id、一句本人确认的实际使用说明 evidence_summary；同时需要写知识长势和写项目进展权限。状态、应用证据、项目时间线一起写入。网页从发芽以下直接跳到更高级也要填写这一表单。退级、同级、已发芽后的推进不要求补项目或说明；不回填历史。 link --core 是兼容关联参数，不会设置项目或知识的核心标记。",
@@ -35,12 +39,17 @@ const help = {
     safety: "不要将令牌放入参数。写入不会自动重试；待审核202退出0，不是业务完成；结果未知的写入退出6，不执行依赖步骤。202需按回执区分待处理与write_outcome_unknown（写入结果未确认，不保证后台队列，请先在网页核对）。"
 };
 const usageError = () => new CliError("invalid_arguments", "命令或参数无效。", "运行 --help，写入数据使用 --input file 或 --input -。");
+help.commands.push(...scheduleCommandUsages);
+help.commands.push(...calendarCommandUsages);
 const parserOptions = {
     agent: { type: "string" }, env: { type: "string" }, human: { type: "boolean" }, help: { type: "boolean", short: "h" }, version: { type: "boolean", short: "v" }, platform: { type: "string" },
     input: { type: "string" }, limit: { type: "string" }, offset: { type: "string" }, q: { type: "string" }, project: { type: "string" }, topic: { type: "string" }, status: { type: "string" }, "publication-status": { type: "string" }, since: { type: "string" }, filter: { type: "string" },
     start: { type: "boolean" }, "start-date": { type: "string" }, "end-date": { type: "string" }, "date-field": { type: "string" }, "core-only": { type: "boolean" },
     "idempotency-key": { type: "string" }, card: { type: "string" }, "source-title": { type: "string" }, summary: { type: "string" }, core: { type: "boolean" },
-    "device-name": { type: "string" }, "client-name": { type: "string" }, "no-open": { type: "boolean" }
+    "device-name": { type: "string" }, "client-name": { type: "string" }, "no-open": { type: "boolean" },
+    view: { type: "string" }, "group-by": { type: "string" }, revision: { type: "string" },
+    "actor-kind": { type: "string" }, "actor-name": { type: "string" }, "actor-source-id": { type: "string" },
+    kind: { type: "string" }, "only-core": { type: "string" }, cursor: { type: "string" }
 };
 // Node's strict parser treats a separate negative numeric value as an option.
 // Normalize only offset values, so both syntaxes reach the same range check;
@@ -168,7 +177,7 @@ export async function runCLI(args, options = {}) {
                 throw usageError();
             positionals = ["version"];
         }
-        if (!["setup", "doctor", "version", "update", "auth", "context", "rules", "activity", "projects", "project", "progress", "checkins", "cognition", "stage", "knowledge", "search", "source", "link", "unlink", "advance", "upload", "pending", "notifications", "drafts", "request"].includes(positionals[0] ?? ""))
+        if (!["setup", "doctor", "version", "update", "auth", "context", "rules", "activity", "projects", "project", "progress", "checkins", "cognition", "stage", "knowledge", "search", "source", "link", "unlink", "advance", "upload", "pending", "notifications", "drafts", "request", "schedule", "calendar", "timeline", "daily-summary"].includes(positionals[0] ?? ""))
             throw usageError();
         validateCommandArguments(positionals, flags);
         const localCommand = ["setup", "doctor", "version", "update"].includes(positionals[0]);

package/dist/command-help.js

@@ -1,4 +1,7 @@
 import { KNOWLEDGE_GROWTH_STEPS } from "./generated/knowledge-growth.js";
+import { scheduleCommandHelp } from "./schedule-help.js";
+import { calendarCommandHelp } from "./calendar-help.js";
+import { WRITE_ROUTING_NOT_THIS } from "./write-routing.js";
 const dates = ["--start-date", "--end-date", "--date-field"];
 const page = ["--limit", "--offset"];
 const knowledge = [...page, "--core-only", "--q", "--project", "--topic", "--status", "--publication-status", ...dates];
@@ -34,14 +37,14 @@ const help = {
     "project update": write("project update", " <id>", "修改项目标题或简介，至少提供一个字段。", {
         title: "选填，去首尾空白后 2-80 个 Unicode 字符。", summary: "选填，去首尾空白后最多 280 字符；只有当前状态为 draft 的项目可清空，最终由服务端按当前状态校验。",
     }, [], { summary: "本人确认的新简介" }),
-    "progress add": write("progress add", " <id>", "记录一件事完成了，用 progress add。", {
+    "progress add": write("progress add", " <id>", `${WRITE_ROUTING_NOT_THIS.progress} 记录一件事完成了，用 progress add。`, {
         body: "必填，2-360 个 Unicode 字符。", update_type: "选填：progress、knowledge_applied、cognition、stage；默认 progress。", visibility: privateOnly,
     }, ["body"], { body: "已完成本人确认的工作", visibility: "private" }, true),
-    "cognition set": write("cognition set", " <id>", "更新项目认知摘要。", { cognition_summary: "必填字符串，最多 1000 字符，可为空。" }, ["cognition_summary"], { cognition_summary: "本人确认的新认识" }),
+    "cognition set": write("cognition set", " <id>", `${WRITE_ROUTING_NOT_THIS.cognition} 更新项目认知摘要。`, { cognition_summary: "必填字符串，最多 1000 字符，可为空。" }, ["cognition_summary"], { cognition_summary: "本人确认的新认识" }),
     "stage set": write("stage set", " <id>", "更新项目阶段；至少提供一个字段，不是记录已完成工作的入口。", {
         stage: "选填，非空，最多 30 字符。", stages: "选填，1-8 个非空阶段，每项最多 30 字符。", status: "选填：draft、active、paused。",
     }, [], { stage: "验证" }),
-    "knowledge add": write("knowledge add", "", "保存本人确认的知识分析；intent 不是选填。", {
+    "knowledge add": write("knowledge add", "", `${WRITE_ROUTING_NOT_THIS.knowledge} 保存本人确认的知识分析；intent 不是选填。`, {
         title: "必填，2-160 字符。", intent: "必填，2-500 字符；用户没说时可拟一句用途并告知本人，确认后保存。",
         summary: "必填，1-4000 字符；分析正文不堆网址。", source_type: "必填：manual、douyin、xiaohongshu、forum、book、publisher_preview、expert、agent、web；不补默认值。",
         source_label: "选填，最多 300 字符。", topic: "选填，最多 120 字符。", linked_project_id: "选填，关联项目 ID。",
@@ -61,7 +64,7 @@ const help = {
     project: read("project", " <id>", "读取指定项目详情。"),
     knowledge: read("knowledge", "", "knowledge 不带参数是知识列表；记录一件事完成了，用 progress add。", knowledge, "默认 published；草稿用 --publication-status draft，需要读取知识和读取草稿权限。"),
     "knowledge show": read("knowledge show", " <id>", "读取指定知识详情。"),
-    search: { ...read("search", "", "按名称或关键词统一搜索项目、进展和知识；省略查询词按日期浏览。", knowledge.filter(option => option !== "--q"), "--project、--topic、--status、--publication-status 只筛知识分支；定向项目进展用 progress list。"), usage: "caotang search [query]", example: { command: 'caotang search "项目名称"' } },
+    search: { ...read("search", "", "按名称或关键词统一搜索项目、进展、知识、待办标题和当天总结正文；省略查询词按日期浏览。", knowledge.filter(option => option !== "--q"), "--project、--topic、--status、--publication-status 只筛知识分支；定向项目进展用 progress list。待办含 pending（未完成）、completed（已完成）、cancelled（已取消），归 read_workbench；搜索须至少开启 read_projects、read_knowledge、read_workbench 之一。AI 知识分支默认 published，显式 --publication-status all 可含可读草稿；关闭 read_drafts 仍不读草稿。--core-only 不含待办和当天总结，待办不继承所属项目的核心标记。待办日期用 created_at / updated_at。当天总结归 read_projects，返回 date 和 confirmed_at；按业务日期筛选、按 confirmed_at 排序，不提供创建/更新时间，不伪造 created_at/updated_at，date_field 不改变总结日期口径。"), usage: "caotang search [query]", example: { command: 'caotang search "项目名称"' } },
     "progress list": read("progress list", " <id>", "读取指定项目的进展。", [...page, ...dates]),
     checkins: read("checkins", "", "列出手写进展。", [...page, ...dates]),
     context: read("context", "", "读取工作台上下文；--start 读取新工作对话的短上下文。", ["--start", "--limit", "--since"], "--start 不与 --limit 或 --since 混用；短读不覆盖账号全部内容，不据此判断账号为空。"),
@@ -87,12 +90,14 @@ for (const operation of ["delete", "archive", "visibility"]) {
         ...(operation === "visibility" ? { visibility: "必填：public 或 private；这是申请，不是直接公开。" } : {}),
     }, ["target_type", "target_id", "reason", ...(operation === "visibility" ? ["visibility"] : [])], { target_type: "project", target_id: id, reason: "本人确认的申请", ...(operation === "visibility" ? { visibility: "private" } : {}) });
 }
+Object.assign(help, scheduleCommandHelp);
+Object.assign(help, calendarCommandHelp);
 export function commandHelp(positionals) {
     const [first, second] = positionals;
     const pair = `${first} ${second}`;
     if (Object.hasOwn(help, pair))
         return help[pair];
-    if (["auth", "request", "progress", "source", "cognition", "stage"].includes(first))
+    if (["auth", "request", "progress", "source", "cognition", "stage", "schedule", "daily-summary"].includes(first))
         return undefined;
     if (first === "knowledge" && second !== undefined)
         return undefined;

package/dist/commands.js

@@ -13,6 +13,8 @@ import { readHabit } from "./habit-read.js";
 import { citationOrigin, webCitations } from "./web-citations.js";
 import { KNOWLEDGE_GROWTH_STEPS, knowledgeGrowthMetadata } from "./generated/knowledge-growth.js";
 import { inputDetails, invalidInput, validateInput, validateCommandArguments } from "./input-validation.js";
+import { executeSchedule } from "./schedule.js";
+import { executeCalendar } from "./calendar.js";
 const root = "/api/v1/agent";
 // Go limits display text by Unicode code points, not UTF-16 code units.
 const runeLength = (value) => [...value].length;
@@ -323,6 +325,10 @@ async function dispatch(p, flags, ctx) {
     return invalid();
 }
 export async function executeCommand(positionals, flags, ctx) {
+    if (positionals[0] === "schedule")
+        return executeSchedule(positionals, flags, ctx);
+    if (["calendar", "timeline", "daily-summary"].includes(positionals[0]))
+        return executeCalendar(positionals, flags, ctx);
     try {
         validateCommandArguments(positionals, flags);
         const result = await dispatch(positionals, flags, ctx);

package/dist/doctor.js

@@ -12,11 +12,13 @@ const localMessages = {
     platform_detection_failed: ["无法完成平台程序检查。", "请检查本地程序目录后重新运行只读检查，不要启动客户端。"],
     command_missing: ["一间草堂命令行尚未完整安装。", "请核对本地安装结果，再由本人决定是否运行 setup。"],
     command_modified: ["已有命令行与当前候选不一致。", "请保留现有文件，由本人核对安装来源和差异，不要自动覆盖或删除。"],
+    command_outdated: ["已核对为旧版受管命令行，需要更新。", "沿用原来的名字运行 npx @yijiancaotang/cli@latest setup --agent <你的名字> 更新，不需要重新批准连接。"],
     command_not_on_path: ["当前找不到可直接使用的一间草堂命令。", "请先核对安装是否完整；有已核验的完整路径时使用它，不修改 shell 或 PATH 配置。"],
     command_version_unknown: ["无法确认本地命令行版本。", "请核对本地安装版本，不要自动升级或执行未知程序。"],
     no_platform_detected: ["尚未识别到支持的 AI 客户端程序。", "请由本人确认 Claude Code、Codex、OpenClaw，或 macOS 上 Kimi Code、Kimi 工作模式、WorkBuddy 的程序安装位置后重新检查。"],
     skills_missing: ["已识别平台的技能包不完整。", "请按当前安装包的技能清单核对所选平台，再由本人决定是否运行 setup。"],
     skills_modified: ["已识别平台的技能内容与本包不一致。", "请保留现有技能，由本人核对差异；不要自动覆盖或删除。"],
+    skills_outdated: ["已核对为这个名字的旧版受管技能，需要更新。", "沿用原来的名字运行 npx @yijiancaotang/cli@latest setup --agent <你的名字> 更新，不需要重新批准连接。"],
     skills_unsafe: ["已识别平台的技能目录未通过安全检查。", "请由本人检查技能目录的属主、权限和符号链接，不要自动修复或提权。"],
 };
 const hasLocalCode = (code) => Object.hasOwn(localMessages, code);
@@ -152,17 +154,20 @@ export async function doctor(ctx) {
     const ids = PLATFORM_IDS;
     if (local && (!Array.isArray(local.platforms) || local.platforms.some((platform) => !platform || !ids.includes(platform.id)) || new Set(local.platforms.map((platform) => platform?.id)).size !== local.platforms.length))
         addLocal("local_inspection_failed");
+    if (local?.skill_platforms !== undefined && (!Array.isArray(local.skill_platforms) || local.skill_platforms.some(id => !ids.includes(id)) || new Set(local.skill_platforms).size !== local.skill_platforms.length))
+        addLocal("local_inspection_failed");
     const platforms = ids.map((id) => {
         const platform = Array.isArray(local?.platforms) ? local.platforms.find((candidate) => candidate?.id === id) : undefined;
         const detected = platform?.detected === true;
         const skills = Array.isArray(platform?.skills) ? platform.skills : [];
         let status = "not_checked";
         if (detected) {
-            status = skills.some((skill) => !skill || !skillNames.includes(skill.name) || skill.status === "unsafe" || !["installed", "missing", "modified"].includes(skill.status)) ? "unsafe"
+            status = skills.some((skill) => !skill || !skillNames.includes(skill.name) || skill.status === "unsafe" || !["installed", "outdated", "missing", "modified"].includes(skill.status)) ? "unsafe"
                 : skills.some((skill) => skill.status === "modified") ? "modified"
-                    : !completeSkillInventory(skills.map(skill => skill.name)) || skills.some((skill) => skill.status !== "installed") ? "missing" : "installed";
+                    : !completeSkillInventory(skills.map(skill => skill.name)) || skills.some((skill) => skill.status === "missing") ? "missing"
+                        : skills.some((skill) => skill.status === "outdated") ? "outdated" : "installed";
             if (status !== "installed")
-                addLocal(status === "unsafe" ? "skills_unsafe" : status === "modified" ? "skills_modified" : "skills_missing");
+                addLocal(status === "unsafe" ? "skills_unsafe" : status === "modified" ? "skills_modified" : status === "outdated" ? "skills_outdated" : "skills_missing");
         }
         // Report aggregate skill state, not unchecked names or filesystem paths from the inspector.
         const installed = detected ? new Set(skills.filter((skill) => skill?.status === "installed" && skillNames.includes(skill.name)).map((skill) => skill.name)).size : 0;
@@ -210,5 +215,7 @@ export async function doctor(ctx) {
             authExit = failed.exitCode;
         }
     }
-    return { result: { status: 200, body: { readiness_scope: "local_cli_and_skills", ...(ctx.agent ? { agent_name: ctx.agent.name, own_connection: auth.status === "valid", skill_platform: ctx.agent.platform ?? "generic" } : {}), end_to_end_verified: false, command, platforms, auth, network, issues, next_actions: [...new Set(issues.map((value) => value.next_action))], ready: issues.length === 0 && auth.status === "valid" } }, exitCode: authExit || localExit };
+    const skillPlatforms = platforms.filter(platform => platform.skills.status === "installed" || local?.skill_platforms?.includes(platform.id)).map(platform => platform.id);
+    const supplement = ctx.agent && skillPlatforms.length === 0 ? ["可以用 setup --platform <平台> 补装技能，不影响现有连接。", "仅检查了已知默认目录和本次显式目录参数；若以前使用自定义目录，请保留原来的目录参数再检查，不能据此判断其它位置是否装过。"] : [];
+    return { result: { status: 200, body: { readiness_scope: "local_cli_and_skills", ...(ctx.agent ? { agent_name: ctx.agent.name, own_connection: auth.status === "valid", skill_platform: skillPlatforms[0] ?? "generic", skill_platforms: skillPlatforms, skill_search_scope: "known_paths_only" } : {}), end_to_end_verified: false, command, platforms, auth, network, issues, next_actions: [...new Set([...issues.map((value) => value.next_action), ...supplement])], ready: issues.length === 0 && auth.status === "valid" } }, exitCode: authExit || localExit };
 }

package/dist/habit-read.js

@@ -1,5 +1,5 @@
 import { asRecord, CliError, expectOK, networkFailure } from "./errors.js";
-import { verifiedHabit } from "./habit-wire.js";
+import { verifiedHabit, habitWorkbenchDisabled } from "./habit-wire.js";
 export async function readHabit(ctx, start) {
     let result;
     try {
@@ -14,6 +14,8 @@ export async function readHabit(ctx, start) {
         throw new CliError("unauthorized", "草堂授权已失效，未读到本次内容。", "先继续当前工作，请本人核对设备授权；不要自动重新授权。", 3, { http_status: 401 });
     if (result.status >= 500)
         throw new CliError("server_error", "草堂服务暂时不可用，未读到本次内容。", "先继续当前工作，稍后核对服务；不要反复重试或重新授权。", 7, { http_status: result.status });
+    if (start && result.status === 403 && habitWorkbenchDisabled(result.body))
+        throw new CliError("capability_disabled", "“读取工作台”开关未开启，未读到本次开工内容。", "请本人到网页的 Agent 管理核对开关；本次不记开工，不换入口、重新授权或反复重试。", 4, { http_status: 403, required_capability: "read_workbench" });
     expectOK(result, "read");
     const body = verifiedHabit(result.body, start);
     if (result.status !== 200 || !body)

package/dist/habit-wire.js

@@ -1,3 +1,4 @@
+import { dailySummaryResult } from "./calendar-contract.js";
 import { validDate as validDay } from "./query-validation.js";
 const record = (value) => value !== null && typeof value === "object" && !Array.isArray(value) ? value : undefined;
 const list = (value, n) => { if (!Array.isArray(value) || value.length > n)
@@ -25,8 +26,10 @@ function day(value) { const r = record(value); if (!validDay(r.date))
     throw Error(); return { kind: p.kind, id: id(p.id), summary: str(p.summary, 120), ...(p.project_id === undefined ? {} : { project_id: id(p.project_id) }) }; }); if (items.length > total)
     throw Error(); return { date: r.date, total, items }; }
 function step(value) { const r = record(value); return { id: id(r.id), project_id: id(r.project_id), summary: str(r.summary, 120), created_at: str(r.created_at, 64) }; }
-function gap(value) { const r = record(value); if (typeof r.reason !== "string" || !["capability_disabled", "read_failed", "community_disabled"].includes(r.reason))
-    throw Error(); return { section: key(r.section), ...(r.required_capability === undefined ? {} : { required_capability: key(r.required_capability) }), reason: r.reason }; }
+function gap(value) { const r = record(value), section = key(r.section); if (typeof r.reason !== "string" || !["capability_disabled", "read_failed", "community_disabled", "record_failed"].includes(r.reason))
+    throw Error(); if (r.reason === "record_failed" && (section !== "calendar_start" || r.required_capability !== "read_workbench"))
+    throw Error(); if (section === "calendar_start" && (r.required_capability !== "read_workbench" || !["capability_disabled", "record_failed"].includes(r.reason)))
+    throw Error(); return { section, ...(r.required_capability === undefined ? {} : { required_capability: key(r.required_capability) }), reason: r.reason }; }
 function official(value) { const r = record(value), total = count(r.unread_count), title = str(r.latest_title, 120); if ((total === 0 && title !== "") || (total > 0 && !title))
     throw Error(); return { unread_count: total, latest_title: title }; }
 // Project the bounded wire fields rather than forwarding unknown content or
@@ -43,14 +46,42 @@ export function verifiedHabit(value, start) {
             return;
         const rules = r.rules === null ? null : list(r.rules, 20).map(rule), p = r.pending === null ? null : pending(r.pending), days = r.recent_days === null ? null : list(r.recent_days, 3).map(day), next = r.next_step === null ? null : step(r.next_step), gaps = list(r.missing_sections, 32).map(gap);
         const owner = typeof r.owner_id === "string" && /^[0-9a-f]{8}(?:-[0-9a-f]{4}){3}-[0-9a-f]{12}(?![\s\S])/i.test(r.owner_id) ? r.owner_id : undefined;
-        const incomplete = rules === null || p === null || days === null || gaps.some(g => g.reason !== "community_disabled");
+        const schedules = r.schedule_items === undefined ? undefined : r.schedule_items === null ? null : verifiedScheduleStart(r.schedule_items);
+        const summary = r.last_daily_summary === undefined ? undefined : r.last_daily_summary === null ? null : dailySummaryResult(r.last_daily_summary);
+        const incomplete = rules === null || p === null || days === null || schedules === null || gaps.some(g => g.reason !== "community_disabled" && g.reason !== "record_failed");
+        const onlyStartRecordGap = gaps.length > 0 && gaps.every(g => g.section === "calendar_start" && g.reason === "record_failed");
         if ((incomplete || gaps.length > 0) && !r.partial)
             return;
-        const contradicted = r.account_empty === true && (!!rules?.length || !!p?.total || !!days?.length || !!next);
+        const contradicted = r.account_empty === true && (!!rules?.length || !!p?.total || !!days?.length || !!next || !!schedules?.total_stored || !!summary);
         return { ...(owner ? { owner_id: owner } : {}), ...(r.official_notices === undefined ? {} : { official_notices: r.official_notices === null ? null : official(r.official_notices) }), rules, pending: p, recent_days: days, next_step: next,
-            account_empty: !owner || r.partial || incomplete || contradicted ? null : r.account_empty, partial: r.partial, missing_sections: gaps };
+            ...(schedules === undefined ? {} : { schedule_items: schedules }), ...(summary === undefined ? {} : { last_daily_summary: summary }), account_empty: !owner || (r.partial && !onlyStartRecordGap) || incomplete || contradicted ? null : r.account_empty, partial: r.partial, missing_sections: gaps };
     }
     catch {
         return undefined;
     }
 }
+import { verifiedScheduleStart } from "./schedule-start-wire.js";
+// A closed content switch is diagnosed only from an exact, non-conflicting
+// start receipt; bare 403 and unrelated capabilities remain unknown.
+export function habitWorkbenchDisabled(value) {
+    const body = record(value);
+    if (!body)
+        return false;
+    const code = body.code ?? body.error;
+    return code === "capability_disabled" && (body.code === undefined || body.code === code) && (body.error === undefined || body.error === code)
+        && body.required_capability === "read_workbench" && (!Object.hasOwn(body, "missing_sections") || Array.isArray(body.missing_sections) && body.missing_sections.length === 0);
+}
+// Derived only from validated protocol metadata; upstream free text is ignored.
+export function calendarStartNotice(value) {
+    const body = record(value), rows = body?.missing_sections;
+    if (!Array.isArray(rows))
+        return "";
+    const reasons = new Set(rows.slice(0, 32).filter(v => record(v)?.section === "calendar_start" && record(v)?.required_capability === "read_workbench").map(v => record(v)?.reason));
+    if (reasons.size !== 1)
+        return "";
+    if (reasons.has("record_failed"))
+        return "这次没记上开工时间，已读内容仍可使用；不自动重试。";
+    if (reasons.has("capability_disabled"))
+        return "读取工作台开关未开启，这次未记录开工时间；其余内容按原权限返回。";
+    return "";
+}

package/dist/http.js

@@ -3,6 +3,8 @@ import { isPagedQueryPath, isQueryParameterError, isProjectIDParameterError } fr
 import { isSearchParameterError } from "./query-search.js";
 import { isDailyParameterError } from "./query-daily.js";
 import { isCreatePath } from "./create-bundle.js";
+import { isScheduleHeaderPath, scheduleHeaders } from "./schedule-contract.js";
+import { isCalendarHeaderPath, calendarHeaders } from "./calendar-contract.js";
 const maxJSONBytes = 4 * 1024 * 1024;
 const invalidResponse = () => new CliError("invalid_response", "一间草堂返回了无法确认的响应。", "请先核对网页中的实际结果，不要自动重复写入。", 7);
 const invalidRequest = () => new CliError("invalid_request", "请求参数无效。", "请检查命令帮助和输入数据。");
@@ -100,7 +102,15 @@ export class ApiClient {
         }
         if (options.body && typeof options.body === "object" && "device_code" in options.body && typeof options.body.device_code === "string")
             this.secrets.add(options.body.device_code);
-        if (options.headers !== undefined) {
+        if (isScheduleHeaderPath(url.pathname, method)) {
+            for (const [name, value] of Object.entries(scheduleHeaders(url.pathname, method, options.headers)))
+                headers.set(name, value);
+        }
+        else if (isCalendarHeaderPath(url.pathname, method)) {
+            for (const [name, value] of Object.entries(calendarHeaders(url.pathname, method, options.headers)))
+                headers.set(name, value);
+        }
+        else if (options.headers !== undefined) {
             if (!options.headers || Object.keys(options.headers).some((key) => key !== "Idempotency-Key"))
                 throw invalidRequest();
             const key = options.headers["Idempotency-Key"];