@namewta/speculo 0.8.13 → 1.0.1

package/template/.speculo/README.md

@@ -10,7 +10,7 @@
 
 配置使用 `.speculo/baselines/` 中的上次模板默认值执行 base/local/incoming 三方合并：模板新增项自动增加，模板删除项直接删除，未被用户修改的旧默认值跟随模板更新，用户覆盖值在满足目标合同的前提下保留。只有字段删除、显式 schema 迁移或结构化文件变换时，CLI 才把原文件写入 `back/` 并生成 targeted manifest；opaque 内容不会被整包复制到备份。
 
-`install.json` 使用 schema v2，记录包版本、已安装 workflows、managed manifest 路径和 baseline schema。初始化以项目锁、完整 staging、active fingerprint 复验、原子 rename 与失败 rollback 组成一个事务；冲突不会发布部分结果，也不会创建新的 pending marker。
+`install.json` 使用 schema v3，记录包版本、已安装 workflows、managed manifest 路径和 baseline schema。`kernel.json` 定义共享 change、风险、checkpoint、能力和 trace 位置。Speculo 1.0 不读取或迁移任何 0.x 安装；检测到旧 manifest 时必须先由用户移除或改名旧 `speculo/` 目录。初始化以项目锁、完整 staging、active fingerprint 复验、原子 rename 与失败 rollback 组成一个事务；冲突不会发布部分结果，也不会创建新的 pending marker。
 
 ## 读取顺序
 

package/template/.speculo/capabilities.json

@@ -0,0 +1,14 @@
+{
+  "schema_version": 1,
+  "model": {
+    "id": "unknown",
+    "provider": "unknown",
+    "modalities": ["text"],
+    "context_window": 0,
+    "max_output": 0,
+    "reasoning_levels": []
+  },
+  "tools": {"classes": ["read-only"], "parallel": false, "programmatic": false},
+  "execution": {"sandbox": false, "network": false, "filesystem_roots": [], "data_retention": "session"},
+  "memory": {"compaction": false, "persistent": true, "cache": false}
+}

package/template/.speculo/kernel/README.md

@@ -0,0 +1,10 @@
+# Speculo Runtime Kernel
+
+The kernel is the provider-neutral persistence contract shared by every workflow.
+
+- `events.jsonl` is append-only and records transitions, tools, approvals and evidence.
+- `context/checkpoint.json` is the minimum recovery input after compaction or session loss.
+- `capabilities.json` is a model/tool/sandbox capability snapshot captured at run start.
+- `trace/` stores immutable run traces used by offline scenario evaluation.
+
+Workflow packages declare stages and domain artifacts; they do not redefine lifecycle, risk, approval, or recovery semantics.

package/template/.speculo/kernel/capability-profile.schema.json

@@ -0,0 +1,14 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "urn:speculo:kernel:capability-profile:v1",
+  "type": "object",
+  "required": ["schema_version", "model", "tools", "execution", "memory"],
+  "properties": {
+    "schema_version": {"const": 1},
+    "model": {"type": "object", "required": ["id", "modalities", "context_window", "max_output", "reasoning_levels"]},
+    "tools": {"type": "object", "required": ["classes", "parallel", "programmatic"]},
+    "execution": {"type": "object", "required": ["sandbox", "network", "filesystem_roots", "data_retention"]},
+    "memory": {"type": "object", "required": ["compaction", "persistent", "cache"]}
+  },
+  "additionalProperties": false
+}

package/template/.speculo/kernel/checkpoint.schema.json

@@ -0,0 +1,7 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "urn:speculo:kernel:checkpoint:v1",
+  "type": "object",
+  "required": ["schema_version", "change_id", "stage", "locked_decisions", "open_questions", "next_action", "evidence", "state_digest", "created_at"],
+  "properties": {"schema_version": {"const": 1}, "change_id": {"type": "string"}, "stage": {"type": "string"}, "locked_decisions": {"type": "array", "items": {"type": "string"}}, "open_questions": {"type": "array", "items": {"type": "string"}}, "next_action": {"type": "string"}, "evidence": {"type": "array", "items": {"type": "string"}}, "state_digest": {"type": "string"}, "created_at": {"type": "string", "format": "date-time"}}
+}

package/template/.speculo/kernel/trace-event.schema.json

@@ -0,0 +1,8 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "urn:speculo:kernel:trace-event:v1",
+  "type": "object",
+  "required": ["schema_version", "sequence", "at", "kind", "payload"],
+  "properties": {"schema_version": {"const": 1}, "sequence": {"type": "integer", "minimum": 1}, "at": {"type": "string", "format": "date-time"}, "kind": {"enum": ["capability", "context", "tool", "transition", "approval", "evidence"]}, "payload": {"type": "object"}},
+  "additionalProperties": false
+}

package/template/.speculo/kernel/workflow-manifest.schema.json

@@ -0,0 +1,13 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "urn:speculo:kernel:workflow-manifest:v1",
+  "type": "object",
+  "required": ["schema_version", "id", "version", "stages"],
+  "properties": {
+    "schema_version": {"const": 1},
+    "id": {"type": "string"},
+    "version": {"type": "string"},
+    "stages": {"type": "array", "items": {"type": "object", "required": ["id", "after", "inputs", "outputs", "risk", "context_budget"]}}
+  },
+  "additionalProperties": false
+}

package/template/.speculo/kernel.json

@@ -0,0 +1,10 @@
+{
+  "schema_version": 1,
+  "runtime": "speculo-kernel",
+  "change_lifecycle": ["draft", "active", "blocked", "awaiting_user", "completed", "archived", "cancelled"],
+  "risk_classes": ["read-only", "local-reversible", "local-destructive", "external-mutation", "production-critical"],
+  "event_log": ".speculo/events.jsonl",
+  "checkpoint": ".speculo/context/checkpoint.json",
+  "capability_profile": ".speculo/capabilities.json",
+  "trace": ".speculo/trace/"
+}

package/template/.speculo/refresh-contract.json

@@ -9,12 +9,15 @@
   "managed_metadata": [
     ".speculo/README.md",
     ".speculo/workspace.json",
-    ".speculo/refresh-contract.json"
+    ".speculo/refresh-contract.json",
+    ".speculo/kernel.json"
   ],
   "reserved_runtime": [
     "README.md",
     "workspace.json",
     "refresh-contract.json",
+    "kernel.json",
+    "kernel",
     "install.json",
     "managed.json",
     "migration.json",

package/template/AGENTS.md

@@ -1,4 +1 @@
 # AGENTS.md
-
-<SPECULO>
-</SPECULO>

package/template/commands/archive-and-consolidate.md

@@ -3,58 +3,31 @@ id: archive-and-consolidate
 type: command
 name: Archive and Consolidate
 description: >
-  归档已完成 change，从归档中提取知识合并到 workflow 声明的知识 store（如 adr/、context/），
-  并清理过时/重复知识。默认 dry-run，需用户确认后执行。
-keywords: [archive, consolidate, knowledge, cleanup, adr, 归档, 知识合并, 清理, 收尾]
+  统一入口：Learning 先做用户确认的主题整合或冷归档，其他 workflow 继续使用各自的归档合同。
+keywords: [archive, consolidate, learning, topic, cold-archive, 归档, 综合]
 ---
 
 # Archive and Consolidate 命令
 
 ## 报告
 
-统一写入：`<Path>{roots.state}/commands/archive-and-consolidate/{date}-{scope}-{topic}[-NN].md</Path>`（`<scope>` 为目标 workflow 名，`<topic>` 为 change 名或 `batch`）。
+统一写入：`<Path>{roots.state}/commands/archive-and-consolidate/{date}-{scope}-{topic}[-NN].md</Path>`。报告记录 workflow、source/root IDs、dry-run 清单、用户确认、relocation manifest、synthesis revision 或 archive locator 和验证结果。
 
-报告必须记录：`mode`（dry-run 或 executed）、选中的 workflow、归档计划、合并计划、清理候选、用户确认状态和最终结果。
+## Learning 路由
 
-## Ops 路由
+目标 workflow 为 Learning 时，读取 `<Path>{roots.workflows}/learning/README.md</Path>`，由用户明确选择一个 Work：
 
-目标 workflow 为 Ops 时，不调用通用 archive skill；该 skill 的机械路径合同只支持 workflow 根级 `changes/` 与 `archive/`，不能处理 Ops 的 project scope。
+- `C-consolidate`：生成 source manifest 和 dry-run；确认后调用 `<Path>{roots.workflows}/learning/common/tools/relocate-learning.mjs</Path>` 物理移动 active/closed Change 到父 Change 的 `children/`，再生成带 provenance 的 synthesis。未确认时不得移动或更新 context。
+- `A-archive`：只处理用户 close/confirm 的 root Change 树，以最新源更新时间决定 `archive/YYYY-MM/`，不要求 Homework、R 或 mastery，也不写 context。
 
-- `archive-single`：读取 `<Path>{roots.workflows}/ops/README.md</Path>` 和 `<Path>{roots.workflows}/ops/A-archive-and-learn/A-archive-and-learn.md</Path>`，把用户选择的完整 `{scope, project_id, change}` 交给 A 执行复盘、promotion dry-run、批量确认和 scope-aware 事务关闭。Command 报告只记录选择、A 返回的 manifest/approval/archive locator 和验证结果，不成为知识 writer。
-- `archive-batch`：只读列出全部 completed Ops tuples 和各自复盘/提升状态，生成 command 报告后停止。知识合并与归档必须逐 change 进入 A 并分别批准，不能用一次跨项目确认替代多个精确 promotion manifest。
+不得把 Learning 交给共享的根级机械归档 skill；该 skill 不能理解递归 locator、parent lock 或单文件 Homework 证据。已冷归档树保持只读，需先由用户显式恢复才能作为 C 的可移动 source。
 
-以下通用模式只适用于仍采用 workflow 根级 changes/archive 合同的其他 workflows。
+## 其他 workflow
 
-## 模式
-
-### archive-single
-
-归档并合并单个已完成 change 的知识。
-
-1. 读取 `<Path>{roots.skills}/archive-and-consolidate/SKILL.md</Path>`，执行路径解析（Step 0），解析 `<Path>{roots.config}</Path>`（不存在时静默降级）。
-2. 选择一个 `change_status: completed` 的 change。
-3. 目标为 SpecDev 时先读取 `<Path>{roots.workflows}/specdev/common/rules/change-completion.md</Path>` 与当前 change 的 `<Path>{roots.state}/specdev/changes/{change}/triage.md</Path>`：完成门必须通过，`external_action` 必须为 `closed | waived | not-applicable`；pending/failed 返回 Triage，不生成可执行归档计划。
-4. 执行 Step 1-5：扫描 stores、扫描 change、生成归档计划、生成合并计划、生成清理候选。
-5. 默认 dry-run：将完整计划写入报告文件，展示摘要并等待用户显式确认。
-6. 确认后以 mode=`confirmed` 执行 Step 7-8：归档移动、合并写入、清理、重读验证。
-7. 执行结果作为补遗追加到原报告。
-
-### archive-batch
-
-批量归档并合并所有已完成 change 的知识。
-
-1. 读取 `<Path>{roots.skills}/archive-and-consolidate/SKILL.md</Path>`，执行路径解析。
-2. 扫描目标 workflow 下所有 `change_status: completed` 的 change。不接受 active 或 broken 状态。
-3. SpecDev 候选逐个通过 change completion 与 external reconcile 门；任一 pending/failed 阻塞整批。
-4. 执行 Step 1-5：扫描 stores、逐 change 扫描、批量预检、合并计划、清理候选。
-5. 批量原子性：任一预检失败阻塞整批。
-6. 默认 dry-run：将完整计划写入报告文件，展示摘要并等待用户显式确认。
-7. 确认后逐项执行：归档移动 → 合并写入 → 清理 → 重读验证。失败时报告已完成/未完成清单。
+非 Learning 目标继续读取自身 README 和归档 Work，Command 报告只记录选择和 owning Work 返回的 manifest，不成为知识 writer。
 
 ## 完成标准
 
-- 报告文件位于 command 专属目录，scope 可从文件名判断。
-- 所有状态、目录和索引变更均已重读验证。
-- 未确认或 mode=`dry-run` 时无任何文件修改。
-- 合并写入的每条知识有来源 change 标注。
-- 每个清理候选有分类和理由。
+- dry-run、确认、移动、回滚和最终验证均有报告；
+- 原始 Markdown 内容不被覆盖，跨路径引用通过 stable ID/locations 解析；
+- 未确认或失败事务不留下部分移动或 context 写入。

package/template/commands/status.md

@@ -10,8 +10,8 @@ keywords: [status, 状态, active, blocked]
 
 1. 读取 `<Path>{roots.state}/workspace.json</Path>`，解析 `<Path>{roots.config}</Path>`（不存在时以默认值静默降级），获取全部已安装 workflow/state 根。
 2. 扫描 `<Path>{roots.workflows}/{workflow}/INDEX.md</Path>`，得到已安装 workflow ids。
-3. 对每个 id 读取 `<Path>{roots.state}/{workflow}/status.json</Path>`，按该 workflow 自己的 schema 解释，不把 SpecDev 字段套到其他 workflow。SpecDev schema v5 和 Learning schema v1 按根级 `changes/<change>` 与 `archive/YYYY-MM/<change>` 定位。Ops schema v2 将 active/archived entry 解析为 `{scope, project_id, change}`：global 仍使用根级路径，project 必须使用 `<Path>{roots.state}/ops/projects/{project_id}/changes/{change}/.status.json</Path>` 或对应 `archive/YYYY-MM/{change}/.status.json`；不得按 change 名跨项目合并。
-4. 报告 active 数量、各 change 的 `current_work`、去重后的 `works_run`、业务状态、最近更新时间和停滞 change（`.status.json` 超过 14 天未更新）。SpecDev 额外报告调查 claims 与 triage `external_action`；Learning 额外报告 domain/topic、测验与复习状态；Ops 额外报告 scope/project、phase、outcome、current plan/approval、latest attempt 和 blockers，并把同名不同项目 Change 分行展示。
-5. 报告 archived 数量和完整 scope/project/change locator；Learning 同时读取 `context/REVIEW.md` 汇总已到期、即将到期和 `needs_refresh` 知识。预期归档目录或 `.status.json` 缺失、active/archived tuple 重叠、同 scope 重复、Ops project.json 缺失、未知 schema、断开链接和 malformed 目录均列为异常，不自动修复。
+3. 对每个 id 读取 `<Path>{roots.state}/{workflow}/status.json</Path>`，按该 workflow 自己的 schema 解释，不把 SpecDev 字段套到其他 workflow。Learning schema v2 的 active/archived entry 携带 stable `change_id`、kind、parent/root、current locator、current_work、Homework 和 retention projection；递归 Change 位于 `changes/**` 或 `archive/**`，位置历史读取 `<Path>{roots.state}/learning/locations.json</Path>`。SpecDev 继续使用 schema v5 根级 `changes/<change>`/`archive/YYYY-MM/<change>`；Ops schema v2 仍使用 `<Path>{roots.state}/ops/projects/{project_id}/changes/{change}/.status.json</Path>` 或对应 `archive/YYYY-MM/{change}/.status.json`。不得按 change 名跨 workflow 合并。
+4. 报告 active 数量、各 Change 的 `current_work`、去重后的 `works_run`、生命周期、parent/root、最近更新时间和停滞 Change（`.status.json` 超过 14 天未更新）。SpecDev 额外报告调查 claims 与 triage `external_action`；Learning 额外报告 domain/topic、Lesson/Homework、immediate/retention 和 synthesis 状态；Ops 额外报告 scope/project、phase、outcome、current plan/approval、latest attempt 和 blockers，并把同名不同项目 Change 分行展示。
+5. 报告 archived 数量和完整 scope/project/change locator；Learning 同时读取 `context/REVIEW.md` 汇总到期 Review、topic evidence status 和需要刷新内容。预期归档目录或 `.status.json` 缺失、active/archived 重叠、parent cycle、位置登记不一致、未知 schema、断开链接和 malformed 目录均列为异常，不自动修复。
 6. 报告没有 workflow 资产的孤立状态根，以及缺少状态根的已安装 workflow；不自动修复。
 7. 用户要求持久化时写入 `<Path>{roots.state}/commands/status/{date}-workspace-{topic}[-NN].md</Path>`，并在报告中列出本次扫描的 workflow 选择。

package/template/workflows/learning/A-archive/A-archive.md

@@ -0,0 +1,25 @@
+---
+id: learning/archive
+type: workflow-entry
+workflow: learning
+name: 冷归档
+description: 用户明确关闭后移动整个 Change 树到日期目录；不做知识综合或掌握判断。
+keywords: [archive, cold-archive, close]
+---
+
+# 冷归档
+
+> 激活本 Work 后，先读取 `<Path>{roots.workflows}/learning/README.md</Path>`。
+
+## 流程
+
+1. 用户明确指定 root Change 并写入 close/confirm；没有确认只输出待归档清单。
+2. 检查 root 没有 active Work 或活动子树；未完成 Homework、未做 R 或未掌握不构成阻塞，证据随树保留。
+3. 以整棵树所有节点 `updated_at` 的最大值作为 `YYYY-MM`，在锁内 stage 并移动 `changes/<root>` 到 `archive/YYYY-MM/<root>`，更新 locations/status projection。
+4. 验证旧路径不存在、新路径存在、哈希和索引完整；失败回滚。归档树只读，后续纠正通过新 Change；A 不写 context。
+
+## 完成标准
+
+- 没有静默删除或改写原始课程、作业、答案、Review 或 synthesis；
+- archive 是用户关闭的历史容器，不等同于 mastered；
+- 归档日期以最新源更新时间为准，原始时间和 relocation history 仍可追溯。

package/template/workflows/learning/A-assess-and-plan/A-assess-and-plan.md

@@ -2,38 +2,32 @@
 id: learning/assess-and-plan
 type: workflow-entry
 workflow: learning
-name: 评估背景并制定学习计划
-description: 从学习请求和已有 Markdown 知识中建立未教学基线，锁定目标、前置知识、来源和掌握证据。
-keywords: [评估, baseline, 学习计划, objectives, 背景知识]
+name: 评估背景并设计课程
+description: 以目标和证据为起点建立课程、背景、基线、来源和可变 Lesson 地图。
+keywords: [评估, baseline, course-design, objectives, background]
 ---
 
-# 评估背景并制定学习计划
+# 评估背景并设计课程
 
-> 激活本 Work 后，先读取 `<Path>{roots.workflows}/learning/README.md</Path>`，再执行本入口。
-
-本 Work 拥有 intake、baseline、learning plan 和初始 sources。它不开始正式教学，也不根据用户自信度直接宣称掌握。
+> 激活本 Work 后，先读取 `<Path>{roots.workflows}/learning/README.md</Path>`。
 
 ## 流程
 
-1. 确认 I 已完成。解析主题、领域 id 和 `project | product | subject | language | skill` 类型；缺少真正影响目标的选择时一次只问一个问题。
-2. 选择或创建 change。新建时使用 `<Path>{roots.workflows}/learning/A-assess-and-plan/change-status-template.json</Path>`，原子登记两级状态并设置 `current_work=learning/assess-and-plan`。
-3. 写 `intake.md`，记录学习对象、期望能做什么、范围外内容、可用时间、来源范围和安全限制。
-4. 按 `<Path>{roots.workflows}/learning/common/rules/knowledge-organization.md</Path>` 读取 context 总目录、目标领域 INDEX 和精确相关知识；不要遍历无关领域。索引失效时用 `rg` 定位并在计划中记录异常。
-5. 在任何 lesson 前进行短基线：让学习者回忆、解释或完成一个小任务；原样保存回答到 `baseline.md`。不能仅用“是否听说过”判断水平。
-6. 从模板写 `learning-plan.md`：明确记录“5 岁的小孩”“大一新生”等教学表达基线；目标使用稳定 `OBJ-NN`，标记关键目标、前置知识、证据类型、深度 `quick | standard | deep`、课程顺序和双重掌握门。目标实质变化必须保留 revision 记录。
-7. 写 `sources.md`，区分项目事实、权威外部来源、类比和未知。外部 URL 在使用时验证；无法验证的结论不进入关键目标答案。
-8. 运行 Learning validator。成功后把 phase 设置为 `assessment`，完成本 Work，并路由 E-eli5；失败时保留 blocker 和当前 Work。
+1. 确认 I 已完成，收集学习目标、期望效果、受众、范围、时间、表达基线和深度。缺少会改变课程设计的选择时，一次只问一个问题。
+2. 创建或恢复 `YYYY-MM-DD-<kebab-topic>[-NN]` Change，生成 `.status.json`，设置 `current_work=learning/assess-and-plan`。
+3. 写 `course.md`：可观察 OBJ、先决条件、课程地图、每节 Lesson 的 30–40 分钟预算、可选路径、Homework 映射和成功证据。章节顺序是参考方案，不是强制教学模型。
+4. 写 `background/foundation.md`：主题宏观背景、概念关系、术语、历史/上下文和学习前置知识；另写 `baseline.md` 保存学习者原始基线，不将“听说过”当作能力。
+5. 写 `sources.md`：搜索范围、权威来源、source id、URL/定位、访问日期、支持的 claim、未决冲突和不确定性。项目事实、外部证据、类比和未知分开。
+6. 创建 `INDEX.md`、`lessons/INDEX.md`、`homework/INDEX.md` 和 `learning-log.md`，运行 validator；完成后清空 `current_work`，不自动激活 L/H。
 
 ## 完成标准
 
-- baseline 先于 lesson，且包含学习者原始证据；
-- 教学表达基线使用直接标签，不使用含糊的“初学者”替代；
-- 每个目标有关键性、证据和完成判断；
-- 已有知识来自精确 Markdown 文件，不来自索引摘要推测；
-- rubric 没有因基线表现而降低目标；
-- 所有输入、状态和下一路由可恢复。
+- 每个 OBJ 有可观察证据、前置关系、Lesson 估时和来源计划；
+- background 与 baseline 分离，所有原始回答保持不改写；
+- 后续新问题写入 `notes/`，实质范围变化创建新 Lesson 或新 Change，并保留 revision。
 
-## 子文件引用
+## 子文件
 
 - Change seed：`<Path>{roots.workflows}/learning/A-assess-and-plan/change-status-template.json</Path>`
-- 计划模板：`<Path>{roots.workflows}/learning/A-assess-and-plan/learning-plan-template.md</Path>`
+- Course 模板：`<Path>{roots.workflows}/learning/A-assess-and-plan/course-template.md</Path>`
+- Background 模板：`<Path>{roots.workflows}/learning/A-assess-and-plan/background-template.md</Path>`

package/template/workflows/learning/A-assess-and-plan/background-template.md

@@ -0,0 +1,13 @@
+# 总体背景与基础知识：<主题>
+
+## 为什么这个主题重要
+
+## 宏观地图
+
+## 核心概念与关系
+
+## 先决知识与缺口
+
+## 术语表
+
+## 来源与不确定性

package/template/workflows/learning/A-assess-and-plan/change-status-template.json

@@ -1,28 +1,35 @@
 {
-  "schema_version": 1,
+  "schema_version": 2,
   "artifact": "learning-change-status",
-  "change": "{change}",
-  "domain": "{domain}",
-  "domain_type": "{domain_type}",
-  "topic": "{topic}",
-  "change_status": "active",
-  "phase": "intake",
+  "change_id": "<YYYY-MM-DD-kebab-topic>",
+  "kind": "learning",
+  "domain": "<domain-id>",
+  "domain_type": "subject",
+  "topic_id": "<topic-id>",
+  "parent_change": null,
+  "root_change": "<YYYY-MM-DD-kebab-topic>",
+  "locator": "changes/<YYYY-MM-DD-kebab-topic>",
+  "lifecycle": "active",
+  "phase": "planning",
   "current_work": "learning/assess-and-plan",
   "works_run": [],
-  "created_at": "{timestamp}",
-  "updated_at": "{timestamp}",
-  "completed_at": null,
+  "created_at": "<ISO-8601>",
+  "updated_at": "<ISO-8601>",
+  "closed_at": null,
   "archived_at": null,
+  "closure_reason": null,
   "archive_path": null,
+  "homework": {"status": "none", "latest_id": null, "submitted_at": null},
   "mastery": {
+    "overall": "unverified",
     "immediate": "not_attempted",
-    "retention": "not_attempted",
-    "score": null,
-    "critical_objectives_passed": false,
-    "transfer_passed": false,
+    "retention": "not_scheduled",
+    "critical_objectives": "not_attempted",
+    "transfer": "not_attempted",
     "blocking_misconceptions": [],
     "evidence": [],
     "next_review_at": null
   },
+  "children": [],
   "blockers": []
 }

package/template/workflows/learning/A-assess-and-plan/course-template.md

@@ -0,0 +1,28 @@
+# 课程设计：<主题>
+
+## 目标与期望效果
+
+## 学习者与表达/深度配置
+
+| 字段 | 值 |
+| --- | --- |
+| expression_level | `eli5` |
+| coverage_depth | `standard` |
+| Lesson 时长 | `35` 分钟 |
+
+## 目标合同
+
+| ID | 可观察目标 | 关键性 | 前置 OBJ | 证据类型 | Lesson | Homework |
+| --- | --- | --- | --- | --- | --- | --- |
+| OBJ-01 | `<能做什么>` | 是 | `<none>` | `<解释/应用/产出>` | L-001 | HW-001 |
+
+## 课程地图
+
+可按主题采用问题驱动、机制驱动、历史脉络、案例驱动或其他适合的结构；这里记录宏观路线和替代路线，不冻结每章模板。
+
+## 成功证据与范围外
+
+## Revision 记录
+
+| 时间 | 变化 | 原因 | 是否重新生成 Lesson |
+| --- | --- | --- | --- |

package/template/workflows/learning/C-consolidate/C-consolidate.md

@@ -0,0 +1,33 @@
+---
+id: learning/consolidate
+type: workflow-entry
+workflow: learning
+name: 主题整合
+description: 将选定 Change 物理嵌入父 Change，生成带 claim 级 provenance 的可迭代主题综合。
+keywords: [consolidate, synthesis, provenance, topic, relocate]
+---
+
+# 主题整合
+
+> 激活本 Work 后，先读取 `<Path>{roots.workflows}/learning/README.md</Path>`。
+
+## 流程
+
+1. 用户指定目标 domain/topic 和 source Change IDs。允许 active/closed 的未归档根 Change；已归档内容必须先显式恢复。已有综合子树只能整棵选择，不得拆分。
+2. 读取每个 source 的 current locator、旧 locator、时间、内容哈希、Lesson/Homework/Review 索引和关系；若祖先/后代循环、重复 ID、活动锁或路径越界则阻塞。
+3. 输出 dry-run：目标父 Change、子目录、effective date、移动清单、哈希、未掌握 evidence、冲突/空白和 context 写入计划。用户未确认前不移动、不改状态。
+4. 用户确认后由 `<Path>{roots.workflows}/learning/common/tools/relocate-learning.mjs</Path>` 在父根锁内 stage、移动整个目录到 `children/<child-id>/`、更新 locations/status projection，并在失败时回滚。现有 Markdown 字节必须保持一致；子 owner 仍写自己的子目录，父负责路由和锁。
+5. 生成 `synthesis/` 的 source-manifest、overview、claim-matrix、concept-map、conflicts-and-gaps 和带版本的 revisions。每个 claim 带 source Change/Lesson/Homework anchor、外部 source id、evidence status 和验证时间。
+6. 用户再次确认后才发布 `context/domains/<domain>/topics/<topic-id>/`；发布不删除原料、不改变 immediate/retention 掌握结论。C 完成后不自动激活 A/R。
+
+## 完成标准
+
+- 物理移动可证明、可回滚、可由稳定 Change ID 解析；
+- 原始工件不被综合覆盖，后续综合以新 revision 记录；
+- active 子 Change 的后续 L/H 仍写子目录，不能绕过父根锁；
+- synthesis 能明确支持、争议、未决 claim，并保留引用。
+
+## 子文件
+
+- 综合规则：`<Path>{roots.workflows}/learning/common/skills/topic-synthesis/SKILL.md</Path>`
+- 迁移工具：`<Path>{roots.workflows}/learning/common/tools/relocate-learning.mjs</Path>`

package/template/workflows/learning/H-homework/H-homework.md

@@ -0,0 +1,31 @@
+---
+id: learning/homework
+type: workflow-entry
+workflow: learning
+name: 课程作业与评审
+description: 以单一 Markdown 文件生成题目、接收显式提交并追加逐题评审；不与 Lesson 混写。
+keywords: [homework, assignment, questions, grading, explain]
+---
+
+# 课程作业与评审
+
+> 激活本 Work 后，先读取 `<Path>{roots.workflows}/learning/README.md</Path>`。
+
+## 流程
+
+1. 用户指定一个或多个 Lesson/OBJ 和题数（默认 5）。读取课程正文、目标、来源和背景；不得把题目答案提前写入作业。
+2. 创建 `homework/HW-<NNN>-<slug>-attempt-01.md`，写元数据、Q1…、空白 A1… 和 `Submission: pending`，更新 `homework/INDEX.md`。
+3. 用户填写 A1…并在文件中加入精确行 `Submission: ready` 后再次激活 H。H 校验回答原文和提交标记，冻结问题/答案内容。
+4. 只在同一文件末尾追加 `## Review`：每题给出 `correct|partial|incorrect|uncertain`、证据覆盖、中文详细讲解、`Explain (English)`、误区和下一步，并记录引用的 Lesson/source anchor。
+5. 评审完成后更新 homework/immediate 投影；不写 mastered、不自动启动 R/C/A。重新作答必须创建新的 attempt 文件并链接旧 attempt，旧文件不可改写。
+
+## 完成标准
+
+- 一个作业文件包含问题、学习者答案、提交标记和 AI 评审；
+- 评审不会改写学习者答案，答案不完整时按 evidence/uncertain 处理；
+- H 的分类结论可结束当前学习轮次，R 才是延迟掌握证据。
+
+## 子文件
+
+- 作业模板：`<Path>{roots.workflows}/learning/H-homework/homework-template.md</Path>`
+- 评审规则：`<Path>{roots.workflows}/learning/common/rules/assessment-policy.md</Path>`

package/template/workflows/learning/H-homework/homework-template.md

@@ -0,0 +1,63 @@
+---
+homework_id: HW-<NNN>
+attempt: 01
+lesson_ids: [L-001]
+objective_ids: [OBJ-01]
+question_count: 5
+created_at: <ISO-8601>
+---
+
+# 作业：<课程标题>
+
+## 引用课程
+
+- Lesson：`<stable lesson id and current locator>`
+- 目标：`<OBJ ids>`
+
+## Questions
+
+### Q1 — 回忆与定义
+
+<问题>
+
+### Q2 — 机制与为什么
+
+<问题>
+
+### Q3 — 变式应用
+
+<问题>
+
+### Q4 — 全新情境迁移
+
+<问题>
+
+### Q5 — 误区辨析
+
+<问题>
+
+## Learner Answers
+
+### A1
+
+<在此填写，不要改写 Q1>
+
+### A2
+
+<在此填写，不要改写 Q2>
+
+### A3
+
+<在此填写，不要改写 Q3>
+
+### A4
+
+<在此填写，不要改写 Q4>
+
+### A5
+
+<在此填写，不要改写 Q5>
+
+Submission: pending
+
+<!-- H 在 Submission: ready 后只能追加 Review；不得改写以上内容。 -->

package/template/workflows/learning/I-init-setup/I-init-setup.md

@@ -3,34 +3,29 @@ id: learning/init-setup
 type: workflow-entry
 workflow: learning
 name: 初始化学习系统
-description: 初始化学习者教学偏好、纯 Markdown 知识目录和可验证的 Learning 状态，不写入任何伪造知识。
-keywords: [初始化, learner-profile, context-index, learning]
+description: 初始化 Learning v2 的教学偏好、空索引、位置登记和可验证状态。
+keywords: [初始化, learner-profile, context, learning-v2]
 ---
 
 # 初始化学习系统
 
-> 激活本 Work 后，先读取 `<Path>{roots.workflows}/learning/README.md</Path>`，再执行本入口。
-
-本 Work 只建立恢复所需骨架。它不评估能力、不创建已掌握知识，也不把用户年龄写成领域水平。
+> 激活本 Work 后，先读取 `<Path>{roots.workflows}/learning/README.md</Path>`。
 
 ## 流程
 
-1. 读取 `<Path>{roots.state}/learning/status.json</Path>`；不存在时从 workflow seed 原子创建。存在时按 schema v1 验证，不覆盖或修复未知结构。
-2. 读取 `<Path>{roots.workflows}/learning/I-init-setup/learner-profile-template.md</Path>`。`learner-profile.md` 不存在时，只询问无法发现的教学语言、图解偏好、单次节奏和复习时间偏好，然后创建；存在时保留未要求修改的内容。
-3. 创建不存在的 `<Path>{roots.state}/learning/changes/</Path>`、`<Path>{roots.state}/learning/archive/</Path>` 和 `<Path>{roots.state}/learning/context/domains/</Path>`。
-4. 从对应模板创建缺失的 `context/INDEX.md` 与 `context/REVIEW.md`。索引只包含标题和表头，不写示例知识行。
-5. 运行 `<Path>{roots.workflows}/learning/common/tools/validate-learning.mjs</Path>` 的 state 校验；重读所有新建文件。
-6. 初始化不创建 change，也不写 `works_run`。返回 A-assess-and-plan 作为正常下一路由。
+1. 读取 `<Path>{roots.state}/learning/status.json</Path>`。不存在时从 `_state/status.json` 原子创建；存在 v1 或未知 schema 时停止并返回 `learning-reset-required`，不修复旧文件。
+2. 读取 `<Path>{roots.workflows}/learning/I-init-setup/learner-profile-template.md</Path>`。只询问无法从环境发现的语言、表达基线、深度、图像/图解偏好、默认 Lesson 时长、Homework 题数和 R 偏好；保留已有字段。
+3. 创建 `changes/`、`archive/`、`context/domains/`，并初始化 `locations.json`、`context/INDEX.md`、`context/REVIEW.md`；不写任何知识条目。
+4. 运行 `<Path>{roots.workflows}/learning/common/tools/validate-learning.mjs</Path>` 的 state 校验并重读新文件。
 
 ## 完成标准
 
-- 全局状态是合法 schema v1，既有状态未丢失；
-- profile 只记录教学和复习偏好，不声明无证据能力；
-- context 目录是空的可导航 Markdown 图书；
-- 没有新增 mastered 条目、active change 或外部副作用。
+- 状态、位置登记和 profile 是合法 v2；
+- 没有 active Change、mastered 条目或外部副作用；
+- 空索引可导航，后续 Work 可恢复。
 
-## 子文件引用
+## 子文件
 
-- Profile 模板：`<Path>{roots.workflows}/learning/I-init-setup/learner-profile-template.md</Path>`
-- 总目录模板：`<Path>{roots.workflows}/learning/I-init-setup/context-index-template.md</Path>`
-- 复习目录模板：`<Path>{roots.workflows}/learning/I-init-setup/review-index-template.md</Path>`
+- Profile：`<Path>{roots.workflows}/learning/I-init-setup/learner-profile-template.md</Path>`
+- 总目录：`<Path>{roots.workflows}/learning/I-init-setup/context-index-template.md</Path>`
+- 复习目录：`<Path>{roots.workflows}/learning/I-init-setup/review-index-template.md</Path>`

package/template/workflows/learning/I-init-setup/context-index-template.md

@@ -1,6 +1,6 @@
-# 已掌握知识总目录
+# 主题知识总目录
 
-> 先从本表选择领域，再读取该领域的 `INDEX.md`。本文件不保存课程正文。
+> 本目录只登记 C 发布的派生主题视图；原始课程、作业和回答留在 Change。
 
-| 领域 | 类型 | 状态 | 入口 | 摘要 | 最近验证 |
+| Domain | Topic ID | Evidence status | 入口 | 最近验证 | 原料 Change |
 | --- | --- | --- | --- | --- | --- |

package/template/workflows/learning/I-init-setup/learner-profile-template.md

@@ -1,17 +1,19 @@
 # 学习者偏好
 
-> 本文件只记录教学交互偏好。领域能力以 context 中的掌握证据为准。
+本文件只记录表达和交互偏好；能力必须由 Lesson/Homework/Review 证据支持。
 
-| 字段 | 值 |
+| 字段 | 默认值或用户选择 |
 | --- | --- |
 | 交互语言 | `<待确认>` |
-| 教学表达基线 | 5 岁的小孩 |
-| 教学表达 | 通俗短句；先图后文；术语先解释后命名 |
-| 图解偏好 | 仅纯文本 ASCII |
-| 单次节奏 | `<待确认>` |
-| 首次保持测验间隔 | 至少 24 小时 |
-| 周期复习间隔 | 7、30、90 天 |
+| expression_level | `eli5`（通俗但完整） |
+| coverage_depth | `standard`；需要时 `deep` |
+| 图解表示 | `ASCII + Markdown table + 可选 Mermaid/外链图片` |
+| 图片无障碍 | 每个外链图片必须有 alt、caption、source、访问日期和文字等价物 |
+| 标准 Lesson 时长 | `35` 分钟（允许 30–40） |
+| 默认 Homework 题数 | `5` |
+| R 保持复习 | 用户主动激活，默认不自动安排 |
+| 复习间隔偏好 | `<待确认>` |
 
-## 无障碍与限制
+## 表达规则
 
-`<没有已确认内容时留空>`
+ELI5 只改变词汇、句法、脚手架和类比比例，不删除技术事实、机制、边界、反例或来源。类比后必须说明失效处；外部媒体失效时仍能用文字和文本图理解课程。