@namewta/speculo 1.0.13 → 1.0.15

package/template/workflows/specdev/T-triage/tools/capture-status.mjs

@@ -0,0 +1,125 @@
+#!/usr/bin/env node
+/**
+ * Aggregate inbox counts from the workspace-owned capture.md ledger.
+ * Local file is authoritative; this tool does not query GitHub.
+ * Missing capture.md is legal and counts as an empty inbox.
+ */
+import { existsSync, readFileSync } from "node:fs";
+import { join, resolve } from "node:path";
+import { fileURLToPath } from "node:url";
+
+const OPEN = "open";
+const INTAKEN = "intaken";
+const WAIVED = "waived";
+const SKIPPED = new Set(["skipped:duplicate"]);
+
+function parseFrontmatter(text) {
+  const match = text.match(/^---\r?\n([\s\S]*?)\r?\n---/);
+  if (!match) return {};
+  const meta = {};
+  for (const line of match[1].split(/\r?\n/)) {
+    const idx = line.indexOf(":");
+    if (idx === -1) continue;
+    meta[line.slice(0, idx).trim()] = line.slice(idx + 1).trim();
+  }
+  return meta;
+}
+
+function parseLedgerStates(body) {
+  const rows = [];
+  for (const line of body.split(/\r?\n/)) {
+    if (!/^\|/.test(line) || /^\|\s*-+/.test(line) || /^\|\s*id\s*\|/i.test(line)) continue;
+    const cells = line.split("|").map((c) => c.trim()).filter((_, i, arr) => i > 0 && i < arr.length - 1);
+    if (cells.length < 9) continue;
+    rows.push({
+      id: cells[0],
+      kind: cells[1],
+      state: cells[8],
+    });
+  }
+  return rows;
+}
+
+function summarize(stateRoot) {
+  const file = join(stateRoot, "capture.md");
+  if (!existsSync(file)) {
+    return {
+      inbox_open: 0,
+      inbox_intaken: 0,
+      inbox_waived: 0,
+      inbox_skipped: 0,
+      inbox_failed: 0,
+      records: 0,
+      missing: true,
+      ledger: null,
+    };
+  }
+
+  const text = readFileSync(file, "utf8");
+  const meta = parseFrontmatter(text);
+  const body = text.replace(/^---[\s\S]*?---/, "");
+  const rows = parseLedgerStates(body);
+  let inbox_open = 0;
+  let inbox_intaken = 0;
+  let inbox_waived = 0;
+  let inbox_skipped = 0;
+  let inbox_failed = 0;
+  for (const row of rows) {
+    if (row.state === OPEN) inbox_open += 1;
+    else if (row.state === INTAKEN) inbox_intaken += 1;
+    else if (row.state === WAIVED) inbox_waived += 1;
+    else if (SKIPPED.has(row.state)) inbox_skipped += 1;
+    else if (row.state === "failed") inbox_failed += 1;
+  }
+
+  return {
+    inbox_open,
+    inbox_intaken,
+    inbox_waived,
+    inbox_skipped,
+    inbox_failed,
+    records: rows.length,
+    missing: false,
+    ledger: file,
+    repo: meta.repo || null,
+  };
+}
+
+function usage() {
+  console.error("Usage: node capture-status.mjs --state-root <specdev-state-root> [--json]");
+  process.exit(2);
+}
+
+function main(argv) {
+  let stateRoot = null;
+  let json = false;
+  for (let i = 0; i < argv.length; i += 1) {
+    if (argv[i] === "--state-root") {
+      stateRoot = argv[i + 1];
+      i += 1;
+    } else if (argv[i] === "--json") {
+      json = true;
+    } else {
+      usage();
+    }
+  }
+  if (!stateRoot) usage();
+  const summary = summarize(stateRoot);
+  if (json) {
+    console.log(JSON.stringify(summary, null, 2));
+    return 0;
+  }
+  const missing = summary.missing ? " (missing ledger, empty inbox)" : "";
+  console.log(`inbox_open:    ${summary.inbox_open}${missing}`);
+  console.log(`inbox_intaken: ${summary.inbox_intaken}`);
+  console.log(`inbox_waived:  ${summary.inbox_waived}`);
+  console.log(`inbox_skipped: ${summary.inbox_skipped}`);
+  console.log(`inbox_failed:  ${summary.inbox_failed}`);
+  return 0;
+}
+
+if (process.argv[1] && resolve(process.argv[1]) === fileURLToPath(import.meta.url)) {
+  process.exit(main(process.argv.slice(2)));
+}
+
+export { summarize };

package/template/workflows/specdev/T-triage/tools/publish-status.mjs

@@ -0,0 +1,148 @@
+#!/usr/bin/env node
+/**
+ * Aggregate published-issue counts from active + archive publish.md ledgers.
+ * Local files are authoritative; this tool does not query GitHub.
+ */
+import { existsSync, readdirSync, readFileSync, statSync } from "node:fs";
+import { dirname, join, resolve } from "node:path";
+import { fileURLToPath } from "node:url";
+
+const COUNTED = new Set(["closed", "created", "commented"]);
+const SKIPPED = new Set(["skipped:cancelled", "skipped:excluded"]);
+
+function parseFrontmatter(text) {
+  const match = text.match(/^---\r?\n([\s\S]*?)\r?\n---/);
+  if (!match) return {};
+  const meta = {};
+  for (const line of match[1].split(/\r?\n/)) {
+    const idx = line.indexOf(":");
+    if (idx === -1) continue;
+    meta[line.slice(0, idx).trim()] = line.slice(idx + 1).trim();
+  }
+  return meta;
+}
+
+function parseLedgerStates(body) {
+  const states = [];
+  for (const line of body.split(/\r?\n/)) {
+    if (!/^\|/.test(line) || /^\|\s*-+/.test(line) || /^\|\s*ticket\s*\|/i.test(line)) continue;
+    const cells = line.split("|").map((c) => c.trim()).filter((_, i, arr) => i > 0 && i < arr.length - 1);
+    if (cells.length < 8) continue;
+    states.push(cells[7]);
+  }
+  return { states };
+}
+
+function collectLedgers(stateRoot) {
+  const roots = [
+    join(stateRoot, "changes"),
+    join(stateRoot, "archive"),
+  ];
+  const files = [];
+  function walk(dir, depth = 0) {
+    if (!existsSync(dir) || depth > 6) return;
+    for (const name of readdirSync(dir)) {
+      const p = join(dir, name);
+      let st;
+      try {
+        st = statSync(p);
+      } catch {
+        continue;
+      }
+      if (st.isDirectory()) walk(p, depth + 1);
+      else if (name === "publish.md") files.push(p);
+    }
+  }
+  for (const root of roots) walk(root);
+  return files;
+}
+
+function summarize(stateRoot) {
+  const files = collectLedgers(stateRoot);
+  let published = 0;
+  let skipped = 0;
+  let failed = 0;
+  let originLocal = 0;
+  let originIntake = 0;
+  const byChange = [];
+
+  for (const file of files) {
+    const text = readFileSync(file, "utf8");
+    const meta = parseFrontmatter(text);
+    const body = text.replace(/^---[\s\S]*?---/, "");
+    const { states } = parseLedgerStates(body);
+    const origin = meta.origin === "intake" ? "intake" : "local";
+    let changePublished = 0;
+    let changeSkipped = 0;
+    let changeFailed = 0;
+    for (const state of states) {
+      if (COUNTED.has(state)) {
+        changePublished += 1;
+        if (origin === "intake") originIntake += 1;
+        else originLocal += 1;
+      } else if (SKIPPED.has(state)) {
+        changeSkipped += 1;
+      } else if (state === "failed") {
+        changeFailed += 1;
+      }
+    }
+    published += changePublished;
+    skipped += changeSkipped;
+    failed += changeFailed;
+    byChange.push({
+      change: meta.change || file,
+      origin,
+      publish_action: meta.publish_action || "unknown",
+      published: changePublished,
+      skipped: changeSkipped,
+      failed: changeFailed,
+    });
+  }
+
+  return {
+    published_issues: published,
+    origin: { local: originLocal, intake: originIntake },
+    publish_skipped: skipped,
+    publish_failed: failed,
+    ledgers: files.length,
+    changes: byChange,
+  };
+}
+
+function usage() {
+  console.error("Usage: node publish-status.mjs --state-root <specdev-state-root> [--json]");
+  process.exit(2);
+}
+
+function main(argv) {
+  let stateRoot = null;
+  let json = false;
+  for (let i = 0; i < argv.length; i += 1) {
+    if (argv[i] === "--state-root") {
+      stateRoot = argv[i + 1];
+      i += 1;
+    } else if (argv[i] === "--json") {
+      json = true;
+    } else {
+      usage();
+    }
+  }
+  if (!stateRoot) usage();
+  const summary = summarize(stateRoot);
+  if (json) {
+    console.log(JSON.stringify(summary, null, 2));
+    return 0;
+  }
+  console.log(
+    `published_issues: ${summary.published_issues}   (origin:local ${summary.origin.local}, origin:intake ${summary.origin.intake})`,
+  );
+  console.log(`publish_skipped:  ${summary.publish_skipped}`);
+  console.log(`publish_failed:   ${summary.publish_failed}`);
+  return 0;
+}
+
+if (process.argv[1] && resolve(process.argv[1]) === fileURLToPath(import.meta.url)) {
+  process.exit(main(process.argv.slice(2)));
+}
+
+export { summarize };

package/template/workflows/specdev/T-triage/triage-template.md

@@ -9,6 +9,8 @@ risk: medium
 route: specdev/wayfinder
 ready_for_implementation: false
 external_action: not-applicable
+publish_action: not-requested
+publish: null
 updated_at: <ISO-8601>
 ---
 
@@ -40,4 +42,13 @@ updated_at: <ISO-8601>
 - **授权记录：** 无
 - **尝试与结果：** 无
 
-外部动作只投影最终完成，不替代本地状态、Ticket、Map 或 Evidence。
+外部动作只投影来源 Issue 的最终完成，不替代本地状态、Ticket、Map 或 Evidence。
+
+## 发布投影
+
+- **publish_action：** not-requested / pending / published / publish-failed / waived
+- **账本：** 无 / `<Path>{roots.state}/specdev/changes/{change}/publish.md</Path>`
+- **origin：** local / intake
+- **计数：** 见账本；workspace 汇总用 publish-status
+
+发布投影只记账已完成 Ticket，不把 GitHub 提升为开发权威。`publish_action` 与 `external_action` 分立。

package/template/workflows/specdev/common/README.md

@@ -39,6 +39,8 @@
 - Wayfinder Ticket：`<Path>{roots.workflows}/specdev/common/schemas/wayfinder-ticket.schema.json</Path>`
 - 来源快照：`<Path>{roots.workflows}/specdev/common/schemas/source.schema.json</Path>`
 - 分诊：`<Path>{roots.workflows}/specdev/common/schemas/triage.schema.json</Path>`
+- 发布账本：`<Path>{roots.workflows}/specdev/common/schemas/publish.schema.json</Path>`
+- 捕获账本：`<Path>{roots.workflows}/specdev/common/schemas/capture.schema.json</Path>`
 - 诊断：`<Path>{roots.workflows}/specdev/common/schemas/diagnosis.schema.json</Path>`
 - 代码审查：`<Path>{roots.workflows}/specdev/common/schemas/code-review.schema.json</Path>`
 - UI 设计包：`<Path>{roots.workflows}/specdev/P-prototype/design-package.schema.json</Path>`

package/template/workflows/specdev/common/rules/artifact-contract.md

@@ -7,20 +7,22 @@ SpecDev 通过分层工件避免同一决策被多个模型反复重做。每个
 | 工件 | 具体位置 | 必须决定 | 不应决定 |
 |---|---|---|---|
 | 来源快照 | `<Path>{roots.state}/specdev/changes/{change}/source.md</Path>` | 原始请求、捕获时间、locator、hash 和关闭能力 | 当前产品合同或实现状态 |
-| 分诊 | `<Path>{roots.state}/specdev/changes/{change}/triage.md</Path>` | 请求类别、影响、风险、缺失输入、下一 work 和远程 reconcile 状态 | 详细实现方案或开发进度 |
+| 分诊 | `<Path>{roots.state}/specdev/changes/{change}/triage.md</Path>` | 请求类别、影响、风险、缺失输入、下一 work、源 Issue reconcile 状态和 publish_action | 详细实现方案、开发进度或票级发布账本 |
+| 发布账本 | `<Path>{roots.state}/specdev/changes/{change}/publish.md</Path>` | 票级 GitHub 投影的编号、标签、marker、state 和发布计数 | Ticket 契约、Evidence 原文或源 Issue 关闭 |
+| 捕获账本 | `<Path>{roots.state}/specdev/capture.md</Path>` | 尚未成 Change 的记事项、GitHub inbox 编号、标签、marker 和 inbox 计数；缺失合法 | Change、Ticket、Evidence 或已完成票的发布投影 |
 | 诊断 | `<Path>{roots.state}/specdev/changes/{change}/diagnosis.md</Path>` | 复现、证据、根因、修复不变量和回归契约 | 未经验证的修复实现 |
 | 设计日志 | `<Path>{roots.state}/specdev/changes/{change}/LOG.md</Path>` | 讨论轨迹、确认、延后、替代与废弃结论 | 当前架构权威摘要 |
 | 设计树 | `<Path>{roots.state}/specdev/changes/{change}/design-tree.json</Path>` | 决策节点、依赖、当前 frontier、轮次与共识状态 | 领域真相或架构决定正文 |
 | Change 领域上下文 | `<Path>{roots.state}/specdev/changes/{change}/CONTEXT.md</Path>` | 本 change 已确认、供下游使用的领域术语和语义 | 永久领域知识或临时会议记录 |
 | Change 架构决策 | `<Path>{roots.state}/specdev/changes/{change}/ADR.md</Path>` | 已成为本 change 下游合同的架构决策、原因、后果和替代关系 | 永久项目 ADR 或尚未决定的方案集合 |
 | Spec | `<Path>{roots.state}/specdev/changes/{change}/spec.md</Path>` | 用户问题、外部行为、范围、验收合同、非功能要求和已锁定实现约束 | 文件级施工步骤 |
-| Ticket | `<Path>{roots.state}/specdev/changes/{change}/ticket/{ticket-file}.md</Path>` | 单一垂直切片的行为、决策、范围、路径所有权、执行路线和验证证据 | 跨 Ticket 里程碑治理 |
+| Ticket | `<Path>{roots.state}/specdev/changes/{change}/ticket/{ticket-file}.md</Path>` | 单一垂直切片的行为、决策、范围、路径所有权、执行路线和验证证据 | 跨 Ticket 里程碑治理或远程 Issue 编号 |
 | Tickets Map | `<Path>{roots.state}/specdev/changes/{change}/tickets-map.md</Path>` | 总体实施背景、项目 Skill 最低调用路由、依赖 DAG、合同覆盖、Ready 投影、并行候选和路径冲突 | 单 Ticket 的完整实现契约 |
 | Goal Plan | `<Path>{roots.state}/specdev/changes/{change}/goal-plan.md</Path>` | 跨 Ticket 调度、Gate、共享所有权、迁移顺序、集成和偏差治理 | 复制 Ticket 全文 |
 | Implementation Map | `<Path>{roots.state}/specdev/changes/{change}/implementation-map.md</Path>` | Ready 成员、组合 Ticket inventory、跨 change dependency/serialization 与 revision | 创建或改写子 Spec、Ticket 或实现细节 |
 | Implementation Plan | `<Path>{roots.state}/specdev/changes/{change}/implementation-plan.md</Path>` | 父 Lead、全局 workspace/实现上限、frontier/Wave/locks/integration queue 和可恢复进度投影 | 改写子 change 权威或伪造完成 |
 | Implementation Orchestration Evidence | `<Path>{roots.state}/specdev/changes/{change}/evidence/implementation-orchestration.md</Path>` | 成员完成、组合 Ticket 顺序/锁、repository integration、整体验证、漂移和残余风险 | 新产品/架构决定或单 Ticket Evidence 替代品 |
-| Evidence | `<Path>{roots.state}/specdev/changes/{change}/evidence/{ticket-id}.md</Path>` | 实际修改、命令、结果、验收映射、偏差、风险和提交引用 | 新的产品或架构决策 |
+| Evidence | `<Path>{roots.state}/specdev/changes/{change}/evidence/{ticket-id}.md</Path>` | 实际修改、命令、结果、验收映射、偏差、风险和提交引用 | 新的产品或架构决策或远程 Issue 正文 |
 | Change 学习图解 | `<Path>{roots.state}/specdev/changes/{change}/learning/index.md</Path>` 与 `<Path>{roots.state}/specdev/changes/{change}/learning/{number}_{topic}.md</Path>` | 面向零专业背景读者解释当前 change 的已验证工件、实现和测试事实；索引按序号持续追加 | 产品决定、架构决定、实现授权或 Learning workflow 知识 |
 | 代码审查 | `<Path>{roots.state}/specdev/changes/{change}/reviews/CR-###.md</Path>` | 固定点、标准轴和规范轴 finding | 实施修复或合并两轴排名 |
 | UI 设计包 | `<Path>{roots.state}/specdev/changes/{change}/prototypes/{design-id}/design-system.md</Path>`、`<Path>{roots.state}/specdev/changes/{change}/prototypes/{design-id}/comparison/</Path>` 与 `<Path>{roots.state}/specdev/changes/{change}/prototypes/{design-id}/final/</Path>` | 项目 UI 证据、功能风格候选、逐层用户决定、设计 token、交互合同和可运行 HTML/CSS/JS 投影 | 生产 UI 实现或替用户确认高影响偏好 |
@@ -50,7 +52,7 @@ Change CONTEXT/ADR 是 active change 内的执行权威，不是 workflow 级永
 
 当前 change 决定与永久知识冲突时，必须在 LOG/ADR 中显式说明替代关系；它只约束当前 change，直到 A 决定是否提升并更新永久版本。
 
-`<Path>{roots.state}/specdev/changes/{change}/source.md</Path>` 只对“原始输入是什么”具有权威；后续用户决定、ADR 和 Spec 可以显式演进该意图。远程来源在摄入后发生变化不会自动改写本地合同，必须重新 Triage。
+`<Path>{roots.state}/specdev/changes/{change}/source.md</Path>` 只对“原始输入是什么”具有权威；后续用户决定、ADR 和 Spec 可以显式演进该意图。远程来源在摄入后发生变化不会自动改写本地合同，必须重新 Triage。GitHub 上由 publish 投影出的 Issue 不是开发权威；发布计数以 `<Path>{roots.state}/specdev/changes/{change}/publish.md</Path>` 为准。GitHub 上由 capture 记下的 inbox Issue 也不是开发权威；inbox 计数以 `<Path>{roots.state}/specdev/capture.md</Path>` 为准，缺失该文件视为空 inbox。
 
 代码事实可以证明计划已过时，但不能静默改写用户目标或已接受契约。出现这种情况时，按 `<Path>{roots.workflows}/specdev/common/rules/deviation-control.md</Path>` 退回相应工件修订。
 

package/template/workflows/specdev/common/rules/change-completion.md

@@ -29,6 +29,6 @@ Owner 原子更新 `<Path>{roots.state}/specdev/changes/{change}/.status.json</P
 
 ## 远程来源与归档
 
-远程动作不参与本地完成判定。Triage 为 `pending-close`/`close-failed` 时先 reconcile；`closed`、`waived` 或 `not-applicable` 才允许 Archive。归档后工件只读。
+远程动作不参与本地完成判定。Triage `external_action` 为 `pending-close`/`close-failed` 时先 reconcile；`closed`、`waived` 或 `not-applicable` 才允许 Archive。Triage `publish_action` 为 `pending`/`publish-failed` 时先恢复或结束 publish；`not-requested`、`published` 或 `waived` 才允许 Archive。`not-requested` 是默认，未点过 publish 的 change 不被新模式绑架。归档后工件只读。
 
 **完成标准**：完成声明可由本地工件、Git 与验证重建；只有一个 owner 命中；失败 candidate 不污染父分支。

package/template/workflows/specdev/common/rules/evidence-and-verification.md

@@ -51,3 +51,5 @@ required Ticket Done 必须有 source commit、通过 candidate、父分支 resu
 Direct Spec Evidence 至少包含：用户批准与轻量合同、Lead、实施前/最终 checkpoint、实际路径、定向/回归/E2E 命令及环境、验收映射、未运行项、偏差、残余风险和提交授权状态。
 
 父实现 change 的 Implementation Orchestration Evidence 不能替代子 Evidence。它至少记录最终 Map revision、全部成员最终状态和子证据指针、dependency/serialization 实际顺序、跨 change 合同检查、aggregate 命令/环境/结果、stale candidate 处理、偏差和残余风险。任何成员未 completed 或整体验证未通过时不得形成父完成证据。
+
+Evidence 原文不出仓库。对 GitHub 的公共投影由 T-triage publish 按公共投影规则生成，不替代本文件的完整记录。

package/template/workflows/specdev/common/rules/workflow-routing.md

@@ -4,7 +4,9 @@
 | 场景 | 入口 | 正常出口 |
 |---|---|---|
 | 需要冻结外部来源或审计摄入 | T-triage intake | D / G / W / P / S / C / T |
+| 尚未成 Change，只要先在 GitHub 留一条仍 open 的记事项 | T-triage capture | 停止 / 以后 intake / W |
 | 本地 change 完成且来源可关闭 | T-triage reconcile | A |
+| 本地 change 完成且要把 Ticket 记到 GitHub | T-triage publish | reconcile / A / 停止 |
 | 疑难 bug 或性能回归 | D-diagnose-bugs | S / T / I / R / W |
 | 模糊但可通过决策访谈收敛 | G-grill-with-docs | P / S / T / W |
 | 大需求包含多个未界定 change 或未知路径 | W-wayfinder | G / P / D / S / T |
@@ -21,4 +23,4 @@
 同 change 下一阶段需要当前一手推理且上下文健康时继续；切换 repo/person/harness 或旁路时使用 `<Path>{roots.commands}/handoff.md</Path>`；严格限定且可独立派单时使用 Dispatch Packet；其他长上下文以权威工件路径恢复。平台不支持 clear/compact 时不虚构操作。
 
 
-本地已清晰请求不强制绕行 Triage。G 是单 change Grill，P-prototype 是 UI 设计，不与统一 P-goal-plan 混淆。W 发现候选后逐个交 G/S/T；只有清晰且 Ready 的 child 才交 P。原缺陷诊断 D、风险分诊和远程 reconcile 职责不删除。
+本地已清晰请求不强制绕行 Triage。完成后要记账才选 publish；尚未成 Change、只想先留 inbox 记录才选 capture。publish、reconcile 与 capture 写不同远程对象，可先后执行。G 是单 change Grill，P-prototype 是 UI 设计，不与统一 P-goal-plan 混淆。W 发现候选后逐个交 G/S/T；只有清晰且 Ready 的 child 才交 P。原缺陷诊断 D、风险分诊、远程 reconcile、完成后发布投影和记事项捕获职责不删除。

package/template/workflows/specdev/common/rules/workflow-state-and-lifecycle.md

@@ -9,6 +9,7 @@
 - 全局状态：`<Path>{roots.state}/specdev/status.json</Path>`
 - 活跃 change：`<Path>{roots.state}/specdev/changes/</Path>`
 - 历史归档：`<Path>{roots.state}/specdev/archive/</Path>`
+- 捕获账本（可选，缺失合法）：`<Path>{roots.state}/specdev/capture.md</Path>`
 
 刷新时 CLI 依据 `<Path>{roots.workflows}/specdev/runtime-contract.json</Path>` 处理持久化数据：配置使用 baseline 三方合并，登记的状态 schema 使用显式 migrator，其他 runtime 文件按字节保留。只有字段删除或结构迁移时才在 `<Path>{roots.state}/back/</Path>` 写入 targeted backup；冲突在替换 active 安装前阻塞。`<Path>{roots.state}/back/</Path>`、`<Path>{roots.state}/install.json</Path>`、`<Path>{roots.state}/managed.json</Path>` 与 `<Path>{roots.state}/baselines/</Path>` 均不属于 SpecDev 写入 namespace。
 

package/template/workflows/specdev/common/schemas/capture.schema.json

@@ -0,0 +1,15 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "urn:speculo:specdev:capture:v1",
+  "title": "SpecDev Capture Index Frontmatter",
+  "type": "object",
+  "required": ["schema_version", "artifact", "mode", "repo", "updated_at"],
+  "properties": {
+    "schema_version": {"const": 1},
+    "artifact": {"const": "capture-index"},
+    "mode": {"const": "capture"},
+    "repo": {"type": "string", "pattern": "^.+/.+$"},
+    "updated_at": {"type": "string", "minLength": 1}
+  },
+  "additionalProperties": true
+}

package/template/workflows/specdev/common/schemas/publish.schema.json

@@ -0,0 +1,21 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "urn:speculo:specdev:publish:v1",
+  "title": "SpecDev Publish Ledger Frontmatter",
+  "type": "object",
+  "required": ["schema_version", "artifact", "change", "mode", "repo", "publish_action", "include_cancelled", "origin", "updated_at"],
+  "properties": {
+    "schema_version": {"const": 1},
+    "artifact": {"const": "publish"},
+    "change": {"type": "string", "pattern": "^[0-9]{4}-[0-9]{2}-[0-9]{2}-[a-z0-9]+(?:-[a-z0-9]+)*$"},
+    "mode": {"const": "publish"},
+    "repo": {"type": "string", "pattern": "^.+/.+$"},
+    "publish_action": {"enum": ["pending", "published", "publish-failed", "waived"]},
+    "include_cancelled": {"type": "boolean"},
+    "parent_issue": {"type": ["integer", "null"]},
+    "origin": {"enum": ["local", "intake"]},
+    "published_at": {"type": ["string", "null"]},
+    "updated_at": {"type": "string", "minLength": 1}
+  },
+  "additionalProperties": true
+}

package/template/workflows/specdev/common/schemas/ticket.schema.json

@@ -54,6 +54,17 @@
         "cancelled"
       ]
     },
+    "kind": {
+      "enum": [
+        "bug",
+        "feature",
+        "refactor",
+        "investigation",
+        "operations",
+        "documentation",
+        "review"
+      ]
+    },
     "planning_depth": {
       "enum": [
         "lite",

package/template/workflows/specdev/common/schemas/triage.schema.json

@@ -8,13 +8,15 @@
     "schema_version": {"const": 1},
     "artifact": {"const": "triage"},
     "change": {"type": "string", "pattern": "^[0-9]{4}-[0-9]{2}-[0-9]{2}-[a-z0-9]+(?:-[a-z0-9]+)*$"},
-    "mode": {"enum": ["intake", "reconcile"]},
+    "mode": {"enum": ["intake", "reconcile", "publish"]},
     "source": {"type": "string", "minLength": 1},
     "classification": {"enum": ["bug", "feature", "refactor", "investigation", "operations", "documentation", "review", "mixed"]},
     "risk": {"enum": ["low", "medium", "high", "critical"]},
     "route": {"type": "string", "pattern": "^specdev/[a-z0-9]+(?:-[a-z0-9]+)*$"},
     "ready_for_implementation": {"type": "boolean"},
     "external_action": {"enum": ["not-applicable", "pending-close", "closed", "close-failed", "waived"]},
+    "publish_action": {"enum": ["not-requested", "pending", "published", "publish-failed", "waived"]},
+    "publish": {"type": ["string", "null"]},
     "updated_at": {"type": "string", "minLength": 1}
   },
   "additionalProperties": true

package/template/workflows/specdev/common/tools/README.md

@@ -11,6 +11,13 @@ node <Path>{roots.workflows}/specdev/common/tools/validate-specdev.mjs</Path> \
 
 `--stage` 只要求该阶段已经拥有的工件；所有已经存在的工件仍会验证。`goal-plan` 还会读取父 change 的 sibling 成员，要求每个成员已有 Ready Spec/Tickets，校验组合 Ticket DAG、唯一父归属、serialization、跨 Ticket 写路径、全局 workspace/实现配额和完成门。省略 stage 时验证当前存在的工件，不会因未来 Work 尚未运行而报错。`--repo` 可选；提供后会把状态中的 SHA、祖先关系、当前分支和完成时 clean 状态与真实 Git 仓库交叉验证。
 
+校验 workspace 捕获账本（文件必须已存在；缺失时不要为了校验去创建）：
+
+```bash
+node <Path>{roots.workflows}/specdev/common/tools/validate-specdev.mjs</Path> \
+  --capture <Path>{roots.state}/specdev/capture.md</Path>
+```
+
 ## 校验 SpecDev 工作流包
 
 ```bash