cotutor 0.1.0 → 0.3.0

package/dist/schema/ledger.d.ts

@@ -1,80 +1,23 @@
 /**
- * 公共账本(《cotutor契约草案.md》§5):observations.jsonl 与 artifacts.jsonl,追加式、一行一条、id 唯一;
- * 改状态追加新行,同 id 后者为准,不改历史。retracted 用追加行(2026-09-08 拍板)。
+ * 产物账本:artifacts.jsonl,追加式、一行一条、id 唯一;改状态追加新行,同 id 后者为准,不改历史。
+ * 观察不在这里:观察的真相是 vault 的日记(《obsidian仓库设计.md》§1),老师记账时回「## 记账」段、应用写日记。
  */
 import { z } from 'zod';
-export declare const EvidenceSchema: z.ZodUnion<readonly [z.ZodObject<{
-    conversation: z.ZodString;
-    job: z.ZodOptional<z.ZodString>;
-}, z.core.$strip>, z.ZodObject<{
-    artifact: z.ZodString;
-}, z.core.$strip>]>;
-export type Evidence = z.infer<typeof EvidenceSchema>;
-/** 完整观察行 */
-export declare const ObservationSchema: z.ZodObject<{
-    id: z.ZodString;
-    date: z.ZodString;
-    author: z.ZodString;
-    subject: z.ZodOptional<z.ZodString>;
-    topic: z.ZodOptional<z.ZodString>;
-    claim: z.ZodString;
-    evidence: z.ZodOptional<z.ZodUnion<readonly [z.ZodObject<{
-        conversation: z.ZodString;
-        job: z.ZodOptional<z.ZodString>;
-    }, z.core.$strip>, z.ZodObject<{
-        artifact: z.ZodString;
-    }, z.core.$strip>]>>;
-    retracted: z.ZodDefault<z.ZodBoolean>;
-}, z.core.$strip>;
-export type Observation = z.infer<typeof ObservationSchema>;
-/** 纠错行:只带 id + retracted + 谁 + 何时 */
-export declare const ObservationRetractSchema: z.ZodObject<{
-    id: z.ZodString;
-    retracted: z.ZodLiteral<true>;
-    by: z.ZodString;
-    date: z.ZodString;
-}, z.core.$strip>;
-export type ObservationRetract = z.infer<typeof ObservationRetractSchema>;
-export declare const ObservationLineSchema: z.ZodUnion<readonly [z.ZodObject<{
-    id: z.ZodString;
-    date: z.ZodString;
-    author: z.ZodString;
-    subject: z.ZodOptional<z.ZodString>;
-    topic: z.ZodOptional<z.ZodString>;
-    claim: z.ZodString;
-    evidence: z.ZodOptional<z.ZodUnion<readonly [z.ZodObject<{
-        conversation: z.ZodString;
-        job: z.ZodOptional<z.ZodString>;
-    }, z.core.$strip>, z.ZodObject<{
-        artifact: z.ZodString;
-    }, z.core.$strip>]>>;
-    retracted: z.ZodDefault<z.ZodBoolean>;
-}, z.core.$strip>, z.ZodObject<{
-    id: z.ZodString;
-    retracted: z.ZodLiteral<true>;
-    by: z.ZodString;
-    date: z.ZodString;
-}, z.core.$strip>]>;
-export type ObservationLine = z.infer<typeof ObservationLineSchema>;
-export declare const ARTIFACT_KINDS: readonly ["课包", "补讲", "批改", "计划", "其它"];
-export declare const ARTIFACT_STATUS: readonly ["draft", "ready", "accepted", "retired"];
+export declare const ARTIFACT_KINDS: readonly ["课包", "其它"];
+export declare const ARTIFACT_STATUS: readonly ["draft", "ready", "retired"];
 export type ArtifactStatus = (typeof ARTIFACT_STATUS)[number];
 /** 产物事件行:首行要带 kind / by / path,后续行只带变化的字段 */
 export declare const ArtifactEventSchema: z.ZodObject<{
     id: z.ZodString;
     kind: z.ZodOptional<z.ZodEnum<{
         课包: "课包";
-        补讲: "补讲";
-        批改: "批改";
-        计划: "计划";
         其它: "其它";
     }>>;
     by: z.ZodOptional<z.ZodString>;
     at: z.ZodString;
     status: z.ZodOptional<z.ZodEnum<{
-        draft: "draft";
         ready: "ready";
-        accepted: "accepted";
+        draft: "draft";
         retired: "retired";
     }>>;
     path: z.ZodOptional<z.ZodString>;
@@ -82,7 +25,8 @@ export declare const ArtifactEventSchema: z.ZodObject<{
         conversation: z.ZodString;
         job: z.ZodOptional<z.ZodString>;
     }, z.core.$strip>>;
-    hash: z.ZodOptional<z.ZodString>;
+    costUsd: z.ZodOptional<z.ZodNumber>;
+    durationMs: z.ZodOptional<z.ZodNumber>;
 }, z.core.$strip>;
 export type ArtifactEvent = z.infer<typeof ArtifactEventSchema>;
 /** 折叠后的产物 */
@@ -94,7 +38,8 @@ export interface Artifact {
     status: ArtifactStatus;
     path?: string;
     source?: ArtifactEvent['source'];
-    hash?: string;
+    costUsd?: number;
+    durationMs?: number;
     /** 最后一次事件时间 */
     updatedAt: string;
 }

package/dist/schema/ledger.js

@@ -1,35 +1,10 @@
 /**
- * 公共账本(《cotutor契约草案.md》§5):observations.jsonl 与 artifacts.jsonl,追加式、一行一条、id 唯一;
- * 改状态追加新行,同 id 后者为准,不改历史。retracted 用追加行(2026-09-08 拍板)。
+ * 产物账本:artifacts.jsonl,追加式、一行一条、id 唯一;改状态追加新行,同 id 后者为准,不改历史。
+ * 观察不在这里:观察的真相是 vault 的日记(《obsidian仓库设计.md》§1),老师记账时回「## 记账」段、应用写日记。
  */
 import { z } from 'zod';
-export const EvidenceSchema = z.union([
-    z.object({ conversation: z.string().min(1), job: z.string().optional() }),
-    z.object({ artifact: z.string().min(1) }),
-]);
-/** 完整观察行 */
-export const ObservationSchema = z.object({
-    id: z.string().min(1),
-    date: z.string().min(1),
-    /** 写它的老师(agent 名)或 parent */
-    author: z.string().min(1),
-    subject: z.string().optional(),
-    topic: z.string().optional(),
-    /** 一句话 */
-    claim: z.string().min(1),
-    evidence: EvidenceSchema.optional(),
-    retracted: z.boolean().default(false),
-});
-/** 纠错行:只带 id + retracted + 谁 + 何时 */
-export const ObservationRetractSchema = z.object({
-    id: z.string().min(1),
-    retracted: z.literal(true),
-    by: z.string().min(1),
-    date: z.string().min(1),
-});
-export const ObservationLineSchema = z.union([ObservationSchema, ObservationRetractSchema]);
-export const ARTIFACT_KINDS = ['课包', '补讲', '批改', '计划', '其它'];
-export const ARTIFACT_STATUS = ['draft', 'ready', 'accepted', 'retired'];
+export const ARTIFACT_KINDS = ['课包', '其它'];
+export const ARTIFACT_STATUS = ['draft', 'ready', 'retired'];
 /** 产物事件行:首行要带 kind / by / path,后续行只带变化的字段 */
 export const ArtifactEventSchema = z.object({
     id: z.string().min(1),
@@ -39,6 +14,7 @@ export const ArtifactEventSchema = z.object({
     status: z.enum(ARTIFACT_STATUS).optional(),
     path: z.string().optional(),
     source: z.object({ conversation: z.string().min(1), job: z.string().optional() }).optional(),
-    /** manifest 指纹,同内容重出验收延续;验收开关关掉时可以没有 accepted 行 */
-    hash: z.string().optional(),
+    /** 做这个产物花的钱与时长(做它的那一方记;老 workspace 里有 scene-maker 那轮收尾时应用追加的) */
+    costUsd: z.number().nonnegative().optional(),
+    durationMs: z.number().int().nonnegative().optional(),
 });

package/dist/schema/memory.d.ts

@@ -0,0 +1,73 @@
+/**
+ * 老师回的「## 记忆」「## 记账」怎么进 vault(《vault重构方案》§3,2026-10-30):老师写的是建议,应用校验后提交。
+ *  - 建议:「## 记忆」的一条。行首 `孩子:` 是关于孩子本人的(target: child),有脸的老师写的进孩子的记忆(`agent: all`,所有有脸的老师共用),
+ *    行末 `证据:「…」` 是孩子在这个话题里说过的原话。证据对不上孩子说过的就不提交;没写证据的照旧提交,记成 unverified。
+ *  - 提交:先在这一轮的索引上记 pending(要写什么、写到哪、写之前的版本),再写 vault,写完把 pending 换成 memoryLines / diaryBlock / booked。
+ *    写 vault 与写索引之间断了,下次记账、删话题之前先对照文件里的实际结果补记或丢掉,不重写一遍。
+ * 证据只记在 workspace 的索引里,vault 的格式不变。
+ */
+import { z } from 'zod';
+/** 一行记忆的改动:before = 改之前那行(新增为 null),after = 改之后那行(删掉为 null);删话题时按整行原文撤 */
+export declare const MemoryLineSchema: z.ZodObject<{
+    before: z.ZodNullable<z.ZodString>;
+    after: z.ZodNullable<z.ZodString>;
+}, z.core.$strip>;
+export type MemoryLine = z.infer<typeof MemoryLineSchema>;
+/** 证据对没对上:verified = 孩子说过这句;unverified = 没写证据;rejected = 孩子没说过(不提交) */
+export declare const EVIDENCE_CHECKS: readonly ["verified", "unverified", "rejected"];
+export type EvidenceCheck = (typeof EVIDENCE_CHECKS)[number];
+export declare const MemoryProposalSchema: z.ZodObject<{
+    item: z.ZodString;
+    target: z.ZodEnum<{
+        tutor: "tutor";
+        child: "child";
+    }>;
+    quote: z.ZodOptional<z.ZodString>;
+    check: z.ZodEnum<{
+        verified: "verified";
+        unverified: "unverified";
+        rejected: "rejected";
+    }>;
+}, z.core.$strip>;
+export type MemoryProposal = z.infer<typeof MemoryProposalSchema>;
+/** 一个记忆文件要写的那笔 */
+export declare const PendingMemorySchema: z.ZodObject<{
+    file: z.ZodString;
+    base: z.ZodNullable<z.ZodString>;
+    hash: z.ZodString;
+    changes: z.ZodArray<z.ZodString>;
+    lines: z.ZodArray<z.ZodObject<{
+        before: z.ZodNullable<z.ZodString>;
+        after: z.ZodNullable<z.ZodString>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type PendingMemory = z.infer<typeof PendingMemorySchema>;
+/** 写 vault 之前记下的一笔;写完就换成 memoryLines / childLines / diaryBlock(没了这条 = 提交完了) */
+export declare const PendingCommitSchema: z.ZodObject<{
+    memory: z.ZodOptional<z.ZodObject<{
+        file: z.ZodString;
+        base: z.ZodNullable<z.ZodString>;
+        hash: z.ZodString;
+        changes: z.ZodArray<z.ZodString>;
+        lines: z.ZodArray<z.ZodObject<{
+            before: z.ZodNullable<z.ZodString>;
+            after: z.ZodNullable<z.ZodString>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>;
+    child: z.ZodOptional<z.ZodObject<{
+        file: z.ZodString;
+        base: z.ZodNullable<z.ZodString>;
+        hash: z.ZodString;
+        changes: z.ZodArray<z.ZodString>;
+        lines: z.ZodArray<z.ZodObject<{
+            before: z.ZodNullable<z.ZodString>;
+            after: z.ZodNullable<z.ZodString>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>;
+    diary: z.ZodOptional<z.ZodObject<{
+        file: z.ZodString;
+        block: z.ZodString;
+        thread: z.ZodString;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type PendingCommit = z.infer<typeof PendingCommitSchema>;

package/dist/schema/memory.js

@@ -0,0 +1,47 @@
+/**
+ * 老师回的「## 记忆」「## 记账」怎么进 vault(《vault重构方案》§3,2026-10-30):老师写的是建议,应用校验后提交。
+ *  - 建议:「## 记忆」的一条。行首 `孩子:` 是关于孩子本人的(target: child),有脸的老师写的进孩子的记忆(`agent: all`,所有有脸的老师共用),
+ *    行末 `证据:「…」` 是孩子在这个话题里说过的原话。证据对不上孩子说过的就不提交;没写证据的照旧提交,记成 unverified。
+ *  - 提交:先在这一轮的索引上记 pending(要写什么、写到哪、写之前的版本),再写 vault,写完把 pending 换成 memoryLines / diaryBlock / booked。
+ *    写 vault 与写索引之间断了,下次记账、删话题之前先对照文件里的实际结果补记或丢掉,不重写一遍。
+ * 证据只记在 workspace 的索引里,vault 的格式不变。
+ */
+import { z } from 'zod';
+/** 一行记忆的改动:before = 改之前那行(新增为 null),after = 改之后那行(删掉为 null);删话题时按整行原文撤 */
+export const MemoryLineSchema = z.object({ before: z.string().nullable(), after: z.string().nullable() });
+/** 证据对没对上:verified = 孩子说过这句;unverified = 没写证据;rejected = 孩子没说过(不提交) */
+export const EVIDENCE_CHECKS = ['verified', 'unverified', 'rejected'];
+export const MemoryProposalSchema = z.object({
+    /** 去掉 `证据:「…」` 之后的那条,增 / 改 / 删的写法照旧(`孩子:` 前缀留着) */
+    item: z.string(),
+    /** tutor = 这位老师(或这个 activity)自己的记忆;child = 关于孩子本人的(行首 `孩子:`) */
+    target: z.enum(['tutor', 'child']),
+    /** 证据:老师抄的孩子原话 */
+    quote: z.string().optional(),
+    check: z.enum(EVIDENCE_CHECKS),
+});
+/** 一个记忆文件要写的那笔 */
+export const PendingMemorySchema = z.object({
+    /** 记忆文件,相对 vault 根 */
+    file: z.string().min(1),
+    /** 写之前的版本(textHash);新建的文件为 null */
+    base: z.string().nullable(),
+    /** 写成之后的版本 */
+    hash: z.string().min(1),
+    changes: z.array(z.string()),
+    lines: z.array(MemoryLineSchema),
+});
+/** 写 vault 之前记下的一笔;写完就换成 memoryLines / childLines / diaryBlock(没了这条 = 提交完了) */
+export const PendingCommitSchema = z.object({
+    /** 这位老师(或这个 activity)自己的记忆 */
+    memory: PendingMemorySchema.optional(),
+    /** 孩子的记忆(`agent: all`,`孩子:` 开头的那几条) */
+    child: PendingMemorySchema.optional(),
+    diary: z.object({
+        /** 日记文件名(<日期>.md) */
+        file: z.string().min(1),
+        block: z.string().min(1),
+        /** 记的是哪个话题的账(写成了就记进索引的 booked) */
+        thread: z.string().min(1),
+    }).optional(),
+});

package/dist/schema/plan.d.ts

@@ -1,6 +1,6 @@
 /**
- * 计划文件 vault/计划/<周>.md(《cotutor契约草案.md》§8):frontmatter week / status / author,
- * 正文按老师分 H2(用显示名,2026-09-08 拍板),行内自由。家长改成 confirmed 即真相。
+ * 计划文件 vault/计划/<周>.md:frontmatter week / status / author,
+ * 正文按老师分 H2(用显示名),行内自由。家长改成 confirmed 即真相。
  */
 import { z } from 'zod';
 export declare const PLAN_STATUS: readonly ["draft", "confirmed"];

package/dist/schema/plan.js

@@ -1,6 +1,6 @@
 /**
- * 计划文件 vault/计划/<周>.md(《cotutor契约草案.md》§8):frontmatter week / status / author,
- * 正文按老师分 H2(用显示名,2026-09-08 拍板),行内自由。家长改成 confirmed 即真相。
+ * 计划文件 vault/计划/<周>.md:frontmatter week / status / author,
+ * 正文按老师分 H2(用显示名),行内自由。家长改成 confirmed 即真相。
  */
 import { z } from 'zod';
 export const PLAN_STATUS = ['draft', 'confirmed'];

package/dist/schema/sections.d.ts

@@ -1,30 +1,37 @@
 /**
- * 老师最终文本里的两种固定段(《cotutor契约草案.md》§4 / §6):
- *  - 「## 待裁量」需要家长拍板的问题 + 选项(HoldupAskV0,沿用 growth-apps 的形状);
- *  - 「## 转交」交给另一位老师(HandoffV0,第一期只允许一跳)。
- * 孩子视图剥掉它们;家长视图渲染成按钮;应用按转交 resume 目标老师。解析不出整段当正文——格式是增强不是门槛。
+ * 老师最终文本里的固定段(《obsidian仓库设计.md》§6):只剩「## 记账」——记账任务的回答:话题叫什么、属于哪册哪节、摘要、讲解骨架、观察;
+ * 老师不直接写 vault,应用按它渲染日记。孩子视图剥掉它;解析不出整段当正文——格式是增强不是门槛。
  */
 import { z } from 'zod';
-export declare const HoldupOptionSchema: z.ZodObject<{
-    label: z.ZodString;
-    note: z.ZodOptional<z.ZodString>;
-    recommended: z.ZodOptional<z.ZodBoolean>;
+/** 记账段里的一个话题(《obsidian仓库设计.md》§6):只有 thread 与 name 必需;summary / steps 只在话题打分够时才要 */
+export declare const BookkeepingEntrySchema: z.ZodObject<{
+    thread: z.ZodString;
+    name: z.ZodString;
+    textbook: z.ZodOptional<z.ZodString>;
+    summary: z.ZodOptional<z.ZodString>;
+    steps: z.ZodOptional<z.ZodString>;
+    observations: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    asked: z.ZodOptional<z.ZodArray<z.ZodString>>;
 }, z.core.$strip>;
-export type HoldupOption = z.infer<typeof HoldupOptionSchema>;
-export declare const HoldupAskSchema: z.ZodObject<{
-    question: z.ZodString;
-    options: z.ZodDefault<z.ZodArray<z.ZodObject<{
-        label: z.ZodString;
-        note: z.ZodOptional<z.ZodString>;
-        recommended: z.ZodOptional<z.ZodBoolean>;
-    }, z.core.$strip>>>;
+export type BookkeepingEntry = z.infer<typeof BookkeepingEntrySchema>;
+export declare const BookkeepingSchema: z.ZodObject<{
+    entries: z.ZodArray<z.ZodObject<{
+        thread: z.ZodString;
+        name: z.ZodString;
+        textbook: z.ZodOptional<z.ZodString>;
+        summary: z.ZodOptional<z.ZodString>;
+        steps: z.ZodOptional<z.ZodString>;
+        observations: z.ZodDefault<z.ZodArray<z.ZodString>>;
+        asked: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    }, z.core.$strip>>;
 }, z.core.$strip>;
-export type HoldupAsk = z.infer<typeof HoldupAskSchema>;
-export declare const HandoffSchema: z.ZodObject<{
-    to: z.ZodString;
-    why: z.ZodOptional<z.ZodString>;
-    refs: z.ZodDefault<z.ZodArray<z.ZodString>>;
-}, z.core.$strip>;
-export type Handoff = z.infer<typeof HandoffSchema>;
-export declare const HOLDUP_HEADING = "\u5F85\u88C1\u91CF";
-export declare const HANDOFF_HEADING = "\u8F6C\u4EA4";
+export type Bookkeeping = z.infer<typeof BookkeepingSchema>;
+export declare const BOOKKEEPING_HEADING = "\u8BB0\u8D26";
+/**
+ * 「## 记忆」段(2026-09-17;2026-09-18 起能改能删):任何一轮都能写,一行一条 `- …`:缺省新增(应用加日期追加),
+ * `- 改:原话 → 新的` 改一行,`- 删:原话` 删一行(按原话找,任何一行都能动);落进 vault 里这位 agent 的记忆文件(`cotutor: memory`),
+ * 家长在 Obsidian 里读、改、删。讲课的轮每轮最多 MEMORY_MAX_PER_TURN 条,多的丢并提醒;记账后的整理轮不限,整理完不超过 MEMORY_TIDY_CAP 条。老师不直接写文件。
+ */
+export declare const MEMORY_HEADING = "\u8BB0\u5FC6";
+export declare const MEMORY_MAX_PER_TURN = 2;
+export declare const MEMORY_TIDY_CAP = 30;

package/dist/schema/sections.js

@@ -1,26 +1,25 @@
 /**
- * 老师最终文本里的两种固定段(《cotutor契约草案.md》§4 / §6):
- *  - 「## 待裁量」需要家长拍板的问题 + 选项(HoldupAskV0,沿用 growth-apps 的形状);
- *  - 「## 转交」交给另一位老师(HandoffV0,第一期只允许一跳)。
- * 孩子视图剥掉它们;家长视图渲染成按钮;应用按转交 resume 目标老师。解析不出整段当正文——格式是增强不是门槛。
+ * 老师最终文本里的固定段(《obsidian仓库设计.md》§6):只剩「## 记账」——记账任务的回答:话题叫什么、属于哪册哪节、摘要、讲解骨架、观察;
+ * 老师不直接写 vault,应用按它渲染日记。孩子视图剥掉它;解析不出整段当正文——格式是增强不是门槛。
  */
 import { z } from 'zod';
-import { AGENT_NAME_RE } from "./config.js";
-export const HoldupOptionSchema = z.object({
-    label: z.string().min(1),
-    note: z.string().optional(),
-    recommended: z.boolean().optional(),
+/** 记账段里的一个话题(《obsidian仓库设计.md》§6):只有 thread 与 name 必需;summary / steps 只在话题打分够时才要 */
+export const BookkeepingEntrySchema = z.object({
+    thread: z.string().min(1).describe('话题 id;记账任务的消息里给了,原样抄'),
+    name: z.string().min(1).max(24).describe('话题名,≤ 12 字;日记里的 H2 = 学科 · 话题名'),
+    textbook: z.string().optional().describe('属于哪册哪节,写成 wikilink 的目标「册#节标题」(教材目录的 H2,记账消息里列了可选项,原样抄一条);认不出就不写这行'),
+    summary: z.string().optional().describe('1–3 句:讲了什么、难点在哪、孩子哪里卡住;只在家长打分 ≥ keepScore 时才要(消息里要了才写),不够的应用会丢'),
+    steps: z.string().optional().describe('讲解的骨架,一行,步骤用 → 连;只在打分够时才要'),
+    observations: z.array(z.string().min(1)).default([]).describe('关于孩子、值得别的老师下次知道的,0–3 条;进日记的「- 观察:」行,是上下文包 recent 的来源;没有就不写'),
+    asked: z.array(z.string().min(1)).optional().describe('孩子在这个话题里说的话,挑 1–3 句值得留的,照原话抄(可以只抄其中一截);应用核对必须是孩子说过的,进日记的「孩子问」;不写就由应用从孩子的话里筛(2026-10-30)'),
 });
-export const HoldupAskSchema = z.object({
-    question: z.string().min(1),
-    options: z.array(HoldupOptionSchema).default([]),
-});
-export const HandoffSchema = z.object({
-    /** 目标老师(agent 名) */
-    to: z.string().regex(AGENT_NAME_RE),
-    why: z.string().optional(),
-    /** 相关文件或产物引用 */
-    refs: z.array(z.string()).default([]),
-});
-export const HOLDUP_HEADING = '待裁量';
-export const HANDOFF_HEADING = '转交';
+export const BookkeepingSchema = z.object({ entries: z.array(BookkeepingEntrySchema).min(1) });
+export const BOOKKEEPING_HEADING = '记账';
+/**
+ * 「## 记忆」段(2026-09-17;2026-09-18 起能改能删):任何一轮都能写,一行一条 `- …`:缺省新增(应用加日期追加),
+ * `- 改:原话 → 新的` 改一行,`- 删:原话` 删一行(按原话找,任何一行都能动);落进 vault 里这位 agent 的记忆文件(`cotutor: memory`),
+ * 家长在 Obsidian 里读、改、删。讲课的轮每轮最多 MEMORY_MAX_PER_TURN 条,多的丢并提醒;记账后的整理轮不限,整理完不超过 MEMORY_TIDY_CAP 条。老师不直接写文件。
+ */
+export const MEMORY_HEADING = '记忆';
+export const MEMORY_MAX_PER_TURN = 2;
+export const MEMORY_TIDY_CAP = 30;

package/dist/schema/theme.d.ts

@@ -0,0 +1,25 @@
+/**
+ * 主题清单(themes/<name>/theme.json)的契约。样子的真相在主题里,不在卡的协议里:
+ * 卡的底色槽(tints)、字形槽(looks)、五支笔(pens)各是一张表,主题想要几个就几个,每个一个名字 + 一句「给什么用」——
+ * 老师与课文件在围栏行上写的 tint= / look= 照这张表认,名字不在表里就落 `default`;所以换主题永远能显示。
+ * 颜色的值不在清单里,在旁边的 kid.css 里(同一个名字对应 CSS 里的 data-tint / data-look / mk-<pen>)。
+ */
+import { z } from 'zod';
+export declare const THEME_NAME_RE: RegExp;
+export declare const THEME_MANIFEST_FILE = "theme.json";
+export declare const THEME_CSS_FILE = "kid.css";
+export declare const THEMES_DIR = "themes";
+export declare const ThemeManifestSchema: z.ZodObject<{
+    name: z.ZodString;
+    default: z.ZodString;
+    tints: z.ZodRecord<z.ZodString, z.ZodObject<{
+        use: z.ZodString;
+    }, z.core.$strip>>;
+    looks: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodObject<{
+        use: z.ZodString;
+    }, z.core.$strip>>>;
+    pens: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodObject<{
+        use: z.ZodString;
+    }, z.core.$strip>>>;
+}, z.core.$strip>;
+export type ThemeManifest = z.infer<typeof ThemeManifestSchema>;

package/dist/schema/theme.js

@@ -0,0 +1,26 @@
+/**
+ * 主题清单(themes/<name>/theme.json)的契约。样子的真相在主题里,不在卡的协议里:
+ * 卡的底色槽(tints)、字形槽(looks)、五支笔(pens)各是一张表,主题想要几个就几个,每个一个名字 + 一句「给什么用」——
+ * 老师与课文件在围栏行上写的 tint= / look= 照这张表认,名字不在表里就落 `default`;所以换主题永远能显示。
+ * 颜色的值不在清单里,在旁边的 kid.css 里(同一个名字对应 CSS 里的 data-tint / data-look / mk-<pen>)。
+ */
+import { z } from 'zod';
+export const THEME_NAME_RE = /^[a-z0-9][a-z0-9-]*$/;
+export const THEME_MANIFEST_FILE = 'theme.json';
+export const THEME_CSS_FILE = 'kid.css';
+export const THEMES_DIR = 'themes';
+const SlotSchema = z.object({ use: z.string().min(1).describe('给什么用(写课文件、排版时照这句挑)') });
+const SlotTable = z.record(z.string().regex(THEME_NAME_RE), SlotSchema);
+export const ThemeManifestSchema = z
+    .object({
+    name: z.string().regex(THEME_NAME_RE),
+    /** 素版与回退用的底色槽,必须在 tints 里 */
+    default: z.string().regex(THEME_NAME_RE),
+    tints: SlotTable.refine((t) => Object.keys(t).length > 0, '至少一个底色槽'),
+    looks: SlotTable.default({}),
+    pens: SlotTable.default({}),
+})
+    .superRefine((m, ctx) => {
+    if (!(m.default in m.tints))
+        ctx.addIssue({ code: 'custom', path: ['default'], message: `default 槽 "${m.default}" 不在 tints 里` });
+});

package/dist/schema/timetable.d.ts

@@ -0,0 +1,26 @@
+/**
+ * 课程表:一周的固定时段(星期 × 时间 × 学科 [× 孩子])。真相是 vault 里的 `课程表.md`(paths.timetable),
+ * 家长在 Obsidian 里改一张 markdown 表;解析器在 memory/timetable.ts(抄自 growth-apps,错误即修复指南带行号)。
+ * 一孩一 workspace 后「孩子」列可选,留着是给多孩共用一张表的家。
+ * 课程表只做归类线索(今天有什么、现在是什么时段),不做逻辑约束——孩子任何时候都能找任何老师。
+ */
+import { z } from 'zod';
+export declare const TIME_RE: RegExp;
+export declare const TimetableEntrySchema: z.ZodObject<{
+    day: z.ZodNumber;
+    start: z.ZodString;
+    end: z.ZodString;
+    subject: z.ZodString;
+    kid: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type TimetableEntry = z.infer<typeof TimetableEntrySchema>;
+export declare const TimetableSchema: z.ZodObject<{
+    entries: z.ZodArray<z.ZodObject<{
+        day: z.ZodNumber;
+        start: z.ZodString;
+        end: z.ZodString;
+        subject: z.ZodString;
+        kid: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type Timetable = z.infer<typeof TimetableSchema>;

package/dist/schema/timetable.js

@@ -0,0 +1,18 @@
+/**
+ * 课程表:一周的固定时段(星期 × 时间 × 学科 [× 孩子])。真相是 vault 里的 `课程表.md`(paths.timetable),
+ * 家长在 Obsidian 里改一张 markdown 表;解析器在 memory/timetable.ts(抄自 growth-apps,错误即修复指南带行号)。
+ * 一孩一 workspace 后「孩子」列可选,留着是给多孩共用一张表的家。
+ * 课程表只做归类线索(今天有什么、现在是什么时段),不做逻辑约束——孩子任何时候都能找任何老师。
+ */
+import { z } from 'zod';
+export const TIME_RE = /^\d{2}:\d{2}$/;
+export const TimetableEntrySchema = z.object({
+    /** 1–7 = 周一–周日 */
+    day: z.number().int().min(1).max(7),
+    start: z.string().regex(TIME_RE),
+    end: z.string().regex(TIME_RE),
+    /** 自由文本(语文 / 数学 / 英语……),与 tutors[].subject 对齐即归到那位老师 */
+    subject: z.string().min(1),
+    kid: z.string().optional(),
+});
+export const TimetableSchema = z.object({ entries: z.array(TimetableEntrySchema) });

package/dist/schema/workspace.d.ts

@@ -0,0 +1,41 @@
+/**
+ * 一个孩子的 workspace 解析好的样子(app/workspace.ts 的 loadWorkspace 给;从那边挪来,2026-10-29):根、从哪认出来的、cotutor.json、各角色的绝对路径、几个目录。
+ * 类型放在 schema:运行层、记忆、场景都按它取自己要的那几样,不用去引命令行那一层。
+ */
+import type { CotutorConfig, PathRole } from './config.ts';
+/**
+ * 技能目录,相对 workspace 根(2026-10-30 从 .claude/skills 挪来):Codex、Qwen Code 在 workspace 里对话时直接读它;
+ * Claude Code 只认 .claude/skills,那里是一条指过来的相对链(init / upgrade 建)
+ */
+export declare const SKILLS_DIR = ".agents/skills";
+/** 老师文件 agents/<name>.md(2026-10-30 从 .claude/agents 挪来):和老师的家 agents/<name>/ 并排,同包里的 grades/grade-<n>/agents/ */
+export declare function tutorFilePath(agentsDir: string, name: string): string;
+/** workspace 是怎么找到的:--workspace / COTUTOR_WORKSPACE / cwd 祖先 / ~/.config/cotutor/config.json / ~/cotutor/ 唯一目录 */
+export type RootSource = 'flag' | 'env' | 'cwd' | 'user-config' | 'home-single';
+export interface Workspace {
+    root: string;
+    source: RootSource;
+    config: CotutorConfig;
+    /** 角色 → 绝对路径;vault 侧角色相对 vault 解析,没配 vault 就相对 workspace 根;captures 相对 workspace 根 */
+    paths: Record<PathRole, string> & Record<string, string>;
+    dirs: {
+        /** 老师文件 <name>.md 与老师的家 <name>/(会话 cwd,activity 在里面) */
+        agents: string;
+        ledger: string;
+        conversations: string;
+        /** 技能 .agents/skills/ */
+        skills: string;
+        /** 课包(cotutor chalk build 的产物,小课堂与 lecture 卡从这里放;派生物,gitignore) */
+        bundles: string;
+        /** 首页:草稿、已发布、历史;publish 时才建,不进骨架 */
+        home: string;
+        /** 视频小课堂(第 4 步):lectures/<id>/lecture.md + video.mp4;家长在编程助手里做,不进骨架 */
+        lectures: string;
+        /** 配音的缓存(.cotutor/tts/,src/media/tts.ts):同一句同一个音色只合成一次;机器文件,gitignore */
+        tts: string;
+    };
+    files: {
+        config: string;
+        artifacts: string;
+    };
+}

package/dist/schema/workspace.js

@@ -0,0 +1,9 @@
+/**
+ * 技能目录,相对 workspace 根(2026-10-30 从 .claude/skills 挪来):Codex、Qwen Code 在 workspace 里对话时直接读它;
+ * Claude Code 只认 .claude/skills,那里是一条指过来的相对链(init / upgrade 建)
+ */
+export const SKILLS_DIR = '.agents/skills';
+/** 老师文件 agents/<name>.md(2026-10-30 从 .claude/agents 挪来):和老师的家 agents/<name>/ 并排,同包里的 grades/grade-<n>/agents/ */
+export function tutorFilePath(agentsDir, name) {
+    return `${agentsDir}/${name}.md`;
+}

package/dist/shared/errors.d.ts

@@ -0,0 +1,8 @@
+/** 用法错误:main 捕获后 exit 2,错误信息即修复指南。 */
+export declare class UsageError extends Error {
+}
+/** 配置文件损坏或形状不对:文件在,但用不了。 */
+export declare class ConfigError extends UsageError {
+    readonly file: string;
+    constructor(file: string, cause: string);
+}

package/dist/shared/errors.js

@@ -0,0 +1,13 @@
+/** 跨模块共用的错误(从 app/workspace.ts 挪来,2026-10-29) */
+import { redactHome } from "./home.js";
+/** 用法错误:main 捕获后 exit 2,错误信息即修复指南。 */
+export class UsageError extends Error {
+}
+/** 配置文件损坏或形状不对:文件在,但用不了。 */
+export class ConfigError extends UsageError {
+    file;
+    constructor(file, cause) {
+        super(`配置文件用不了:${redactHome(file)}\n${cause}\n修好它;文件在 git 里就 git diff 看改动、git checkout 回退。cotutor doctor 可逐项体检。`);
+        this.file = file;
+    }
+}

package/dist/shared/home.d.ts

@@ -0,0 +1,2 @@
+export declare function redactHome(value: string): string;
+export declare function redactDeep<T>(value: T): T;

package/dist/shared/home.js

@@ -0,0 +1,16 @@
+/** 给人看的路径里把家目录换成 $HOME(报错、doctor、--json 输出不带出用户名;从 app/workspace.ts 挪来,2026-10-29) */
+import { homedir } from 'node:os';
+export function redactHome(value) {
+    const home = homedir();
+    return home && value.startsWith(home) ? '$HOME' + value.slice(home.length) : value;
+}
+export function redactDeep(value) {
+    if (typeof value === 'string')
+        return redactHome(value);
+    if (Array.isArray(value))
+        return value.map(redactDeep);
+    if (value && typeof value === 'object') {
+        return Object.fromEntries(Object.entries(value).map(([k, v]) => [k, redactDeep(v)]));
+    }
+    return value;
+}

package/dist/shared/human-notes.d.ts

@@ -0,0 +1,5 @@
+/**
+ * 独占一行(或几行)的 `<!-- … -->` 是给人看的(谁读、为什么,《写提示词.md》§二、§四),递给模型前剥掉;
+ * 连同它前面那个换行一起去掉,规矩下面紧跟的注释剥完不留空行。行内的注释不动。
+ */
+export declare function stripHumanNotes(body: string): string;

package/dist/shared/human-notes.js

@@ -0,0 +1,7 @@
+/**
+ * 独占一行(或几行)的 `<!-- … -->` 是给人看的(谁读、为什么,《写提示词.md》§二、§四),递给模型前剥掉;
+ * 连同它前面那个换行一起去掉,规矩下面紧跟的注释剥完不留空行。行内的注释不动。
+ */
+export function stripHumanNotes(body) {
+    return body.replace(/(^|\n)[ \t]*<!--[\s\S]*?-->[ \t]*(?=\n|$)/g, '').trim();
+}