@namewta/speculo 1.0.13 → 1.0.14

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

@@ -0,0 +1,34 @@
+# Published Ticket 正文模板
+
+publish 创建 GitHub Issue 时使用。先套 `<Path>{roots.workflows}/specdev/T-triage/references/public-projection.md</Path>` 脱敏，再填本模板。占位符不得把 state Path 带出去。
+
+```markdown
+> *This was generated by AI during SpecDev T-triage publish.*
+
+## Published Ticket
+
+**Category:** <bug | feature | refactor | investigation | operations | documentation | review>
+**Change:** <change-name>
+**Ticket:** T-01
+**Origin:** local | intake
+**Parent:** Part of #<n> / none
+
+**Summary:** <一句话，已经发生的事实。>
+
+**Delivered behavior:**
+<完成后系统对外可见的行为。写「现在会怎样」，不写「去改哪个文件」。>
+
+**Acceptance:**
+- [x] AC-001：<可公开验收，状态按 Evidence 勾选>
+
+**Blocked by:**
+- #<n> <title>
+- None
+
+**Out of scope:**
+<票里 OUT 列的可公开项；没有则写「无」。>
+
+**Provenance:**
+- Public commit / PR: <url or sha or 无>
+- Marker: `specdev:<change>:T-01:published`
+```

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

@@ -0,0 +1,92 @@
+# Publish Protocol
+
+仅在 Triage `mode=publish` 时加载。目标是把已完成 Change 的计划内 Ticket 投影为带分类标签的 GitHub Issue，用脱敏 Evidence 关闭它们，并留下 `<Path>{roots.state}/specdev/changes/{change}/publish.md</Path>`。
+
+GitHub 是投影和计数器，不是开发权威。源 Issue 的关闭仍走 reconcile，与本协议互不覆盖。
+
+## 1. 触发与对象
+
+用户必须指定一个已存在的 change（active 或尚未归档的 completed）。禁止扫整个 workspace 自动发。
+
+可选开关：`include-cancelled`、`force-parent` / `no-parent`、排除票号列表。目标 repo 默认从 `git remote` 推断，必须展示确认。
+
+没有先前 intake 时允许补写：
+
+- `<Path>{roots.state}/specdev/changes/{change}/triage.md</Path>`，`mode: publish`，`publish_action: pending`；
+- 轻量 `<Path>{roots.state}/specdev/changes/{change}/source.md</Path>`：`source_type` 为 `conversation | pasted | local-file`，`canonical_locator: null`，`close_capability: not-applicable`。禁止虚构 GitHub locator。
+
+publish **不得**改 Ticket / Spec / Evidence / Goal / change completed 事实。只写 `<Path>{roots.state}/specdev/changes/{change}/publish.md</Path>`、`<Path>{roots.state}/specdev/changes/{change}/triage.md</Path>` 的 publish 字段，以及经授权的远程投影。
+
+## 2. 硬门
+
+失败即停，零远程写入。`publish_action` 保持 `not-requested`（尚未开始）或变为 `publish-failed`（已开始后失败）。
+
+1. 按 `<Path>{roots.workflows}/specdev/common/rules/change-completion.md</Path>` 重验本地完成。
+2. 至少一张可发布票：status `done`，或用户选择纳入的 `cancelled`。没有 Ticket 文件（纯 Direct Spec）时停止；v1 不发 Change 级单 Issue。
+3. 调用 `<Path>{roots.skills}/github-npm-ops/SKILL.md</Path>` 能读目标 repo、能 dry-run `issue-create`。
+4. 分类映射见 `<Path>{roots.workflows}/specdev/T-triage/references/classification-map.md</Path>`。缺 type 标签时 dry-run 表列出将创建的标签，授权后才 `gh label create`。
+5. Change `classification` 为 `mixed` 时，确认表上每张纳入票都有 `kind`。
+6. 用户看见完整 dry-run 表（标题、标签、正文、关闭评论、reason）并给出 **本次** 明确确认。
+
+cancelled 默认跳过，账本记 `skipped:cancelled`。只有 `include-cancelled` 或确认表勾选才建 Issue，并以 `not_planned` 关闭。
+
+父 Change Issue：纳入票数 ≥ 2 时默认创建；1 票时票 Issue 本身就是记录。`force-parent` / `no-parent` 覆盖默认。v1 只用正文 `Part of #<n>` / `Blocked by #<n>`，不上 native sub-issue API。
+
+## 3. 准备投影
+
+对每张纳入票读取 Ticket 与对应 Evidence，按 `<Path>{roots.workflows}/specdev/T-triage/references/public-projection.md</Path>` 脱敏。
+
+- Issue 正文：`<Path>{roots.workflows}/specdev/T-triage/issue-body-template.md</Path>`（过去时）。
+- 关闭评论：`<Path>{roots.workflows}/specdev/T-triage/close-comment-template.md</Path>`。
+- `kind` 缺省继承 Change 分类；写回票 frontmatter 可选，账本该行必须有 `kind`。
+- origin：源 `close_capability` 为 supported 或 locator 是 GitHub Issue/PR 则为 `intake`，否则 `local`。
+- marker：`specdev:<change>:<ticket-id>:published`。
+
+用 `<Path>{roots.workflows}/specdev/T-triage/publish-template.md</Path>` 写或更新 `<Path>{roots.state}/specdev/changes/{change}/publish.md</Path>`。先把纳入行标 `planned`，跳过行标 `skipped:cancelled` 或 `skipped:excluded`，`publish_action: pending`。
+
+## 4. 幂等执行
+
+顺序：先父（若有）→ 按 `blocked_by` 拓扑建子 → 回写父正文真实编号 → 关子 → 关父。
+
+对每张票：
+
+1. `issue-search` 查 marker 或精确标题 + `specdev:published`。
+2. 已存在且 marker 在且已关闭 → 账本 `closed`，跳过。
+3. 已存在且 marker 在但仍 open → 只补 `issue-comment-close`。
+4. 已存在但无 marker → 停止该行，展示冲突，不覆盖别人的 Issue。
+5. 不存在 → dry-run `issue-create` → 授权后 `--apply` → 立刻 `issue-comment-close`，marker 双写（正文 Provenance + 关闭评论）。
+6. 任一步失败：该行 `failed`，记录已完成步骤和下一重试动作；已成功的票不回滚。
+
+`--apply` 只表示调用方完成本次确认，不替代授权。远程失败不回滚本地完成事实。
+
+全部纳入票到达 `closed` 或合法 `skipped:*`，且无 `failed` 时：`publish_action: published`，填写 `published_at`。用户明确放弃：`waived`。重跑是恢复，不是重发。
+
+摄入源 Change：本协议只建票 Issue。原来的源 Issue 仍由 reconcile 关闭；源 Issue ≠ 票 Issue。reconcile 评论可以链接已发布编号。
+
+## 5. 校验与计数
+
+```bash
+node <Path>{roots.workflows}/specdev/common/tools/validate-specdev.mjs</Path> \
+  --stage triage \
+  <Path>{roots.state}/specdev/changes/{change}</Path>
+```
+
+workspace 计数：
+
+```bash
+node <Path>{roots.workflows}/specdev/T-triage/tools/publish-status.mjs</Path> \
+  --state-root <Path>{roots.state}/specdev</Path>
+```
+
+数字只来自 active + archive 的 `<Path>{roots.state}/specdev/changes/{change}/publish.md</Path>`，不把 GitHub 搜索当权威。
+
+## 完成标准
+
+- 指定 completed Change 的 done 票均有对应 GitHub Issue，或账本有合法 skip；
+- 每条已发布 Issue 带且仅带一个 type 标签，以及 `specdev:published` 与 `origin:*`；
+- 关闭评论是 Evidence 脱敏投影；
+- marker 使重跑不重复建贴；
+- 本地源计入 `published_issues`；
+- `<Path>{roots.state}/specdev/changes/{change}/publish.md</Path>` 与远程重读一致，失败行可恢复；
+- Ticket / Spec / Evidence / completed 事实未被改写；
+- 未授权时远程写入为零。

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

@@ -0,0 +1,49 @@
+---
+schema_version: 1
+artifact: publish
+change: <YYYY-MM-DD-topic>
+mode: publish
+repo: owner/repo
+publish_action: pending
+include_cancelled: false
+parent_issue: null
+origin: local
+published_at: null
+updated_at: <ISO-8601>
+---
+
+# Publish: <change>
+
+## 发布计划
+
+- **目标 repo：** `owner/repo`
+- **origin：** local / intake
+- **含 cancelled：** false
+- **父 Issue：** 默认（纳入票 ≥ 2 时创建）/ 强制开 / 强制关
+- **排除票：** 无 / T-0N
+- **确认记录：** 无 / 本次授权时间与操作员
+
+publish 不改写 Ticket、Spec、Evidence、Goal 或 change completed 事实。
+
+## 账本
+
+| ticket | kind | labels | number | url | marker | sha256 | state |
+|---|---|---|---|---|---|---|---|
+| T-01 | bug | bug, specdev:published, origin:local | — | — | specdev:<change>:T-01:published | — | planned |
+
+`state`：`planned | created | commented | closed | skipped:cancelled | skipped:excluded | failed`。
+
+`sha256` 覆盖实际发出的 Issue 正文 + 关闭评论。漂移只警告，不自动重发。
+
+## 计数
+
+- **published_closed：** 0
+- **published_open：** 0
+- **skipped：** 0
+- **failed：** 0
+
+计数权威是本文件，不是 GitHub 搜索。`published_issues` = closed + created（仍 open 的失败中途行）。
+
+## 重试
+
+无 / 失败行的已完成步骤和下一步。已成功的票不回滚。

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

@@ -1,6 +1,6 @@
 # Reconcile Protocol
 
-仅在 Triage `mode=reconcile` 时加载。目标是把本地完成结果最小化投影到来源 Issue，并关闭它。
+仅在 Triage `mode=reconcile` 时加载。目标是把本地完成结果最小化投影到来源 Issue，并关闭它。票级发布走 publish，不走本协议。
 
 ## 1. 本地完成硬门
 
@@ -10,7 +10,7 @@
 
 ## 2. 准备关闭计划
 
-从本地 Evidence 生成简短评论：完成结果、关键验证、可公开的 commit/PR URL、残余风险或后续工作。不得发布 state Path、机器路径、秘密、内部日志或未核对声明。
+从本地 Evidence 生成简短评论：完成结果、关键验证、可公开的 commit/PR URL、残余风险或后续工作。遵守 `<Path>{roots.workflows}/specdev/T-triage/references/public-projection.md</Path>`。若同一 change 已 publish，评论可以链接票 Issue 编号；源 Issue 仍不是那些票 Issue。
 
 向用户展示准确 repo、Issue 编号、评论全文、close reason 和将执行的动作。只有本次明确确认后才继续；拒绝或暂不执行时零远程写入。用户明确放弃关闭可将状态置为 `waived`。
 
@@ -23,7 +23,7 @@
 - marker 不存在：评论成功后再 close；
 - 任一步失败：记录已完成步骤、错误和下一重试动作，状态为 `close-failed`。
 
-成功后重读远程状态，只有观察到 closed 才写 `external_action: closed`。
+成功后重读远程状态，只有观察到 closed 才写 `external_action: closed`。不改写 `publish_action`。
 
 ## 完成标准
 

package/template/workflows/specdev/T-triage/references/classification-map.md

@@ -0,0 +1,53 @@
+# Classification Map
+
+T-triage 本地分类与 GitHub type 标签的对照。publish 只打本表允许的标签；intake 仍把 8 值写在 `<Path>{roots.state}/specdev/changes/{change}/triage.md</Path>`，v1 不回写源 Issue。
+
+## SpecDev 分类
+
+Change 级 `classification`：`bug | feature | refactor | investigation | operations | documentation | review | mixed`。
+
+票级 `kind` 与上相同，去掉 `mixed`。缺省合法：publish 时继承 Change 分类；Change 为 `mixed` 时确认表必须给出每张纳入票的 `kind`。
+
+## GitHub type 标签
+
+优先使用目标仓库已有标签。确认表展示实际将打的字符串。
+
+| SpecDev | GitHub type（优先） | 降级 | 标题前缀 |
+|---|---|---|---|
+| `bug` | `bug` | — | `bug:` |
+| `feature` | `feature-request` | `enhancement` | `feature:` |
+| `refactor` | `enhancement`，若仓库已有 `refactor` 则额外打 `refactor` | — | `refactor:` |
+| `investigation` | `question` | `enhancement` | `investigate:` |
+| `operations` | `operations` | `enhancement` | `ops:` |
+| `documentation` | `documentation` | — | `docs:` |
+| `review` | `enhancement` | — | `review:` |
+| `mixed` | 禁止直接发布 | 拆到票级 `kind` | — |
+
+每个已发布 Issue 恰好一个 type 标签（`refactor` 的额外 `refactor` 不算第二 type）。
+
+## 固定附加标签
+
+- `specdev:published`：计数与去重。
+- `origin:local` 或 `origin:intake`：来源。本地对话/粘贴/项目文件为 `local`；冻结自 GitHub Issue/PR 为 `intake`。
+- 父 Change 索引 Issue 另打 `specdev:change`。`mixed` 的父 Issue 不打 type。
+
+## 可选标签
+
+- `area:*`：仅当 tickets-map / `expected_changes` 能唯一推断顶层目录时才打；不确定则不问不打。
+- `priority:*`：由 triage `risk` 映射：`critical→priority:critical`，`high→priority:high`，`medium→priority:medium`，`low→priority:low`。确认表可改。
+
+## 禁止标签
+
+不得打到自发布 Issue 或父索引上：
+
+`needs-triage`、`needs-info`、`ready-for-agent`、`ready-for-human`、`wontfix`、`duplicate`、`invalid`、`stale`。
+
+cancelled 票若被纳入，使用 close reason `not_planned`，不打 `wontfix`。
+
+## 标题
+
+```text
+<前缀> <ticket.title>
+```
+
+不把内部 id `T-01` 写入标题。内部 id 只出现在正文 Provenance 和 `<Path>{roots.state}/specdev/changes/{change}/publish.md</Path>`。

package/template/workflows/specdev/T-triage/references/public-projection.md

@@ -0,0 +1,66 @@
+# Public Projection
+
+T-triage 远程正文的脱敏与耐久规则。intake 不写远程。reconcile 关闭评论与 publish 的 Issue 正文 / 关闭评论都遵守本文件。
+
+## Disclaimer
+
+每条远程 Issue 正文和评论必须以这一行开头：
+
+```markdown
+> *This was generated by AI during SpecDev T-triage publish.*
+```
+
+reconcile 关闭评论把 `publish` 换成 `reconcile`：
+
+```markdown
+> *This was generated by AI during SpecDev T-triage reconcile.*
+```
+
+## 允许写入远程的字段
+
+- 已发生的行为与验收（过去时）
+- 可公开 commit / PR URL
+- 验证结论：定向 / 回归 / E2E 是否跑过、是否通过；未跑时一句原因
+- 残余风险（可公开）
+- 分类、origin、Change 名、Ticket id、marker
+- `Part of #<n>` / `Blocked by #<n>`
+- cancelled 原因：`cancelled-already-implemented`（指到已有公开位置）或 `cancelled-out-of-scope`（指到 ADR / 用户决定）
+
+项目相对路径只在描述公开模块边界时允许，并注明「当时路径，可能已变」。
+
+## 禁止写入远程
+
+- 状态根、工作流根、技能根别名与任何 Path 标签
+- 机器绝对路径、worktree 路径、state 文件路径
+- token、Cookie、密钥、私人日志、未核对声明
+- skill JSON、workspace 策略原文、candidate 内部字段、内部 SHA 链（除非该 SHA 已是将推送的公开 commit）
+- 「请 agent 去实现」的祈使句
+- 文件行号
+
+关闭评论是 Evidence 的公共投影，不是副本。不得把 Evidence 原文贴出去。
+
+## 最低关闭评论
+
+即使脱敏后也必须保留：
+
+1. 结果一句话（通过 / 取消原因）
+2. 公开 commit 或 PR URL；没有则写「无公开 commit/PR」
+3. 验证结论四字级摘要（通过 / 未跑 + 原因）
+
+## Marker
+
+票 Issue：
+
+```text
+specdev:<change>:<ticket-id>:published
+```
+
+同时写入 Issue 正文 Provenance 和关闭评论，供 `issue-search` 去重。
+
+父索引：
+
+```text
+specdev:<change>:publish-index
+```
+
+reconcile 源 Issue 仍用 `specdev:<change>:completion`，与 publish marker 互不替代。

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,7 @@
 - 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/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,21 @@ 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/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 +51,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>` 为准。
 
 代码事实可以证明计划已过时，但不能静默改写用户目标或已接受契约。出现这种情况时，按 `<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

@@ -5,6 +5,7 @@
 |---|---|---|
 | 需要冻结外部来源或审计摄入 | T-triage intake | D / G / W / P / S / C / T |
 | 本地 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 +22,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；publish 与 reconcile 写不同远程对象，可先后执行。G 是单 change Grill，P-prototype 是 UI 设计，不与统一 P-goal-plan 混淆。W 发现候选后逐个交 G/S/T；只有清晰且 Ready 的 child 才交 P。原缺陷诊断 D、风险分诊、远程 reconcile 和完成后发布投影职责不删除。

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