@namewta/speculo 1.0.12 → 1.0.14

package/template/workflows/ops/common/tools/opslib/transport.mjs

@@ -1,7 +1,7 @@
 /** Strict host-key SSH and subprocess local transport. No passwords in argv. */
 import { spawnSync } from "node:child_process";
 import { readFileSync } from "node:fs";
-import { dirname, join, resolve } from "node:path";
+import { dirname, isAbsolute, join, resolve } from "node:path";
 import { fileURLToPath } from "node:url";
 import { canonical, digest, noSymlinks, OpsError, redact, UnknownResult } from "./core.mjs";
 import { fingerprint } from "./agent.mjs";
@@ -30,6 +30,102 @@ export function hostTransportDigest(host) {
   return digest({ host, known_hosts_digest: kh });
 }
 
+export function validateSshEndpoint(c) {
+  if (!c || typeof c !== "object") throw new OpsError("ssh endpoint missing");
+  for (const k of ["hostname", "username", "known_hosts"]) {
+    if (!c[k]) throw new OpsError("ssh connection missing " + k);
+  }
+  if (!/^[A-Za-z0-9_.:-]+$/.test(c.hostname) || c.hostname.startsWith("-")) throw new OpsError("unsafe SSH hostname");
+  if (!/^[A-Za-z0-9_.-]+$/.test(c.username) || c.username.startsWith("-")) throw new OpsError("unsafe SSH username");
+  if (![undefined, "posix", "powershell"].includes(c.shell)) throw new OpsError("unsupported remote shell");
+}
+
+export function sshArgv(connection, { scp = false } = {}) {
+  validateSshEndpoint(connection);
+  const kh = resolve(connection.known_hosts);
+  noSymlinks(kh, { allowMissing: false });
+  const argv = [
+    scp ? "scp" : "ssh",
+    ...(scp ? [] : ["-T"]),
+    "-o", "BatchMode=yes",
+    "-o", "StrictHostKeyChecking=yes",
+    "-o", `UserKnownHostsFile=${kh}`,
+    "-o", "ConnectTimeout=15",
+    "-o", "ServerAliveInterval=15",
+    "-o", "ServerAliveCountMax=3",
+    scp ? "-P" : "-p", String(connection.port ?? 22),
+  ];
+  if (connection.identity_file) argv.push("-i", connection.identity_file, "-o", "IdentitiesOnly=yes");
+  return argv;
+}
+
+function spawnTransport(argv, { input, timeout, encoding = "buffer" } = {}) {
+  return transportHooks.spawnSync(argv[0], argv.slice(1), {
+    input,
+    encoding,
+    timeout: timeout * 1000,
+    maxBuffer: 64 * 1024 * 1024,
+    windowsHide: true,
+  });
+}
+
+function buffers(p) {
+  const stdout = Buffer.isBuffer(p.stdout) ? p.stdout.toString("utf8") : (p.stdout || "");
+  const stderr = Buffer.isBuffer(p.stderr) ? p.stderr.toString("utf8") : (p.stderr || "");
+  return { stdout, stderr };
+}
+
+export function posixCall(endpoint, script, { timeout = 180, args = [], sudo = false } = {}) {
+  validateSshEndpoint(endpoint);
+  if ((endpoint.shell ?? "posix") === "powershell") {
+    throw new OpsError("POSIX bootstrap is Linux-only; PowerShell targets still require an existing Node");
+  }
+  const useSudo = sudo || endpoint.sudo;
+  let remote = ["/bin/sh", "-s", "--", ...args.map(String)];
+  if (useSudo) remote = ["sudo", "-n", "--", ...remote];
+  const argv = sshArgv(endpoint);
+  argv.push("--", endpoint.username + "@" + endpoint.hostname, shlexJoin(remote));
+  let p;
+  try {
+    p = spawnTransport(argv, { input: Buffer.from(String(script), "utf8"), timeout });
+  } catch (e) {
+    throw new OpsError("target posix unavailable: " + e);
+  }
+  if (p.error && (p.error.code === "ETIMEDOUT" || p.signal === "SIGTERM")) {
+    throw new OpsError("target posix unavailable: " + p.error);
+  }
+  const { stdout, stderr } = buffers(p);
+  if (p.status !== 0) {
+    throw new OpsError("target posix failed: " + redact(stderr, []).slice(-2000));
+  }
+  return { status: p.status, stdout, stderr };
+}
+
+export function posixSend(endpoint, localFile, remotePath, { timeout = 180 } = {}) {
+  validateSshEndpoint(endpoint);
+  if ((endpoint.shell ?? "posix") === "powershell") {
+    throw new OpsError("POSIX bootstrap is Linux-only; PowerShell targets still require an existing Node");
+  }
+  noSymlinks(localFile, { allowMissing: false });
+  if (typeof remotePath !== "string" || !isAbsolute(remotePath) || remotePath.split("/").includes("..") || /[\s\n\r]/.test(remotePath)) {
+    throw new OpsError("remote scp path must be absolute without spaces or ..");
+  }
+  const argv = sshArgv(endpoint, { scp: true });
+  argv.push("--", localFile, `${endpoint.username}@${endpoint.hostname}:${remotePath}`);
+  let p;
+  try {
+    p = spawnTransport(argv, { input: Buffer.alloc(0), timeout });
+  } catch (e) {
+    throw new OpsError("target scp unavailable: " + e);
+  }
+  if (p.error && (p.error.code === "ETIMEDOUT" || p.signal === "SIGTERM")) {
+    throw new OpsError("target scp unavailable: " + p.error);
+  }
+  const { stderr } = buffers(p);
+  if (p.status !== 0) throw new OpsError("target scp failed: " + redact(stderr, []).slice(-2000));
+  return { status: 0, remotePath };
+}
+
 function injectRequest(source, request) {
   const b64 = Buffer.from(canonical(request)).toString("base64");
   const assign = `globalThis.OPS_REQUEST = JSON.parse(Buffer.from(${JSON.stringify(b64)}, "base64").toString("utf8"));`;
@@ -49,13 +145,7 @@ export function call(host, request, { timeout = 1800 } = {}) {
     const argv = [process.execPath, "--input-type=module"];
     let p;
     try {
-      p = transportHooks.spawnSync(argv[0], argv.slice(1), {
-        input: content,
-        encoding: "utf8",
-        timeout: timeout * 1000,
-        maxBuffer: 64 * 1024 * 1024,
-        windowsHide: true,
-      });
+      p = spawnTransport(argv, { input: content, timeout, encoding: "utf8" });
     } catch (e) {
       if (["step", "lock", "unlock"].includes(request.action)) throw new UnknownResult("target transport interrupted; inspect receipts before retry");
       throw new OpsError("target read unavailable: " + e);
@@ -63,11 +153,7 @@ export function call(host, request, { timeout = 1800 } = {}) {
     return decode(p, request);
   }
   const c = host.connection;
-  const kh = resolve(c.known_hosts);
-  noSymlinks(kh, { allowMissing: false });
-  const argv = ["ssh", "-T", "-o", "BatchMode=yes", "-o", "StrictHostKeyChecking=yes", "-o", `UserKnownHostsFile=${kh}`,
-    "-o", "ConnectTimeout=15", "-o", "ServerAliveInterval=15", "-o", "ServerAliveCountMax=3", "-p", String(c.port ?? 22)];
-  if (c.identity_file) argv.push("-i", c.identity_file, "-o", "IdentitiesOnly=yes");
+  const argv = sshArgv(c);
   let remote = [c.node, "--input-type=module"];
   if (c.sudo) remote = ["sudo", "-n", "--", ...remote];
   let remoteCommand;
@@ -82,13 +168,7 @@ export function call(host, request, { timeout = 1800 } = {}) {
   argv.push("--", c.username + "@" + c.hostname, remoteCommand);
   let p;
   try {
-    p = transportHooks.spawnSync(argv[0], argv.slice(1), {
-      input: Buffer.from(content, "utf8"),
-      encoding: "buffer",
-      timeout: timeout * 1000,
-      maxBuffer: 64 * 1024 * 1024,
-      windowsHide: true,
-    });
+    p = spawnTransport(argv, { input: Buffer.from(content, "utf8"), timeout });
   } catch (e) {
     if (["step", "lock", "unlock"].includes(request.action)) throw new UnknownResult("target transport interrupted; inspect receipts before retry");
     throw new OpsError("target read unavailable: " + e);
@@ -101,8 +181,7 @@ function decode(p, request) {
     if (["step", "lock", "unlock"].includes(request.action)) throw new UnknownResult("target transport interrupted; inspect receipts before retry");
     throw new OpsError("target read unavailable: " + p.error);
   }
-  const stdout = Buffer.isBuffer(p.stdout) ? p.stdout.toString("utf8") : (p.stdout || "");
-  const stderr = Buffer.isBuffer(p.stderr) ? p.stderr.toString("utf8") : (p.stderr || "");
+  const { stdout, stderr } = buffers(p);
   if (p.status !== 0) {
     const text = redact(stderr, request.secrets || []).slice(-2000);
     if (["step", "lock", "unlock"].includes(request.action)) throw new UnknownResult("target transport failed: " + text);

package/template/workflows/ops/common/tools/validate-ops.mjs

@@ -27,6 +27,7 @@ try {
     for (const name of readdirSync(join(root, "common/schemas")).filter((x) => x.endsWith(".json"))) {
       JSON.parse(readFileSync(join(root, "common/schemas", name), "utf8"));
     }
+    JSON.parse(readFileSync(join(root, "common/toolchains/volta-linux.json"), "utf8"));
     validateStatus(JSON.parse(readFileSync(join(root, "_state/status.json"), "utf8")));
     console.log("resource schema valid");
     console.log(JSON.stringify({

package/template/workflows/specdev/A-archive-and-consolidate/A-archive-and-consolidate.md

@@ -3,7 +3,7 @@ id: specdev/archive-and-consolidate
 type: workflow-entry
 workflow: specdev
 name: 归档与沉淀
-description: 校验本地完成与远程 reconcile 门，复用全局归档能力移动 completed change 并提升当前知识，或从代码访谈形成可归档知识 change。
+description: 校验本地完成、源 Issue reconcile 门和票级 publish_action 门，复用全局归档能力移动 completed change 并提升当前知识，或从代码访谈形成可归档知识 change。
 keywords: [归档, consolidation, ADR, context, research, knowledge, 代码库访谈]
 ---
 
@@ -31,7 +31,7 @@ A 是 SpecDev 的归档 wrapper：它拥有模式选择、SpecDev 完成门和
 
 1. 读取全局/change 状态、Ticket、Map、Goal Plan、Evidence、ADR、CONTEXT、LOG、triage 和项目验证事实。
 2. 加载 `<Path>{roots.workflows}/specdev/common/rules/change-completion.md</Path>` 与 `<Path>{roots.workflows}/specdev/common/rules/parent-implementation-orchestration.md</Path>`，确认 `change_status: completed`、完成 owner 已写入时间和证据、无 blocker/deviation；若该 change 是未完成父实现 change 的成员则停止，若其自身是父实现 change 则还需所有成员与 aggregate Evidence 完成。
-3. 检查 `<Path>{roots.state}/specdev/changes/{change}/triage.md</Path>` 的 `external_action`：`pending-close` 或 `close-failed` 返回 `<Path>{roots.workflows}/specdev/T-triage/T-triage.md</Path>`；只有 `closed | waived | not-applicable` 继续。
+3. 检查 `<Path>{roots.state}/specdev/changes/{change}/triage.md</Path>` 的 `external_action`：`pending-close` 或 `close-failed` 返回 `<Path>{roots.workflows}/specdev/T-triage/T-triage.md</Path>`；只有 `closed | waived | not-applicable` 继续。再检查 `publish_action`：`pending` 或 `publish-failed` 同样返回 T-triage publish；只有 `not-requested | published | waived`（缺省视为 `not-requested`）继续。
 4. 调用 `<Path>{roots.skills}/archive-and-consolidate/SKILL.md</Path>` 的 `archive-single + dry-run`，传入已解析 workflow/state/changes/archive/knowledge roots。展示完整移动、提升和清理计划。
 5. 只有用户明确批准该计划后调用 `confirmed`。移动、知识写入和清理均使用计划内路径；计划后出现 drift 时停止。
 6. 重读源、归档目标、全局索引、归档 `<Path>{roots.state}/specdev/archive/YYYY-MM/{change}/.status.json</Path>` 和永久知识；运行 `--stage complete` 及包级校验，报告每个提升/跳过结论。
@@ -51,7 +51,7 @@ Dry-run 不修改文件。归档移动、知识 merge/rewrite/delete、Git 动
 ## 完成标准
 
 - 模式与唯一 change 已确定；
-- 本地完成和 external reconcile 门通过；
+- 本地完成、external reconcile 门和 publish_action 门通过；
 - 机械归档与知识规则只有全局 skill 一个事实源；
 - dry-run 与 confirmed 执行严格分离；
 - 源不存在、目标完整、active/archived 无重叠、归档状态正确；

package/template/workflows/specdev/I-implement/references/implementation-procedure.md

@@ -147,7 +147,7 @@ Lead 使用 `<Path>{roots.workflows}/specdev/I-implement/evidence-template.md</P
 
 Ticket 正常状态：`ready → in_progress → review → done`。`required` 的 `done` 要求 change worktree 已完成集成（`integrated` 或 `removed`）、父 HEAD=result SHA 且包含 source commit；`current` 的 `done` 要求 current workspace clean、direct-parent 验证通过且父 HEAD=result SHA。阻塞使用 `blocked`，契约偏差使用 `deviated`，无需改动使用 `cancelled`。Direct Spec 由当前 I-implement owner 按 `<Path>{roots.workflows}/specdev/common/rules/change-completion.md</Path>` 关闭 change。
 
-按存在和当前模式同步 Ticket、Tickets Map、Goal Plan、`<Path>{roots.state}/specdev/changes/{change}/.status.json</Path>` 和全局状态；Direct Spec 不创建缺失的 Ticket/Map/Goal Plan。最后一个计划内 Ticket 完成后，Goal Plan 的 Lead 按 change completion 关闭；无 Goal Plan 的当前 I owner 承担同一门禁。需要远程 reconcile 时返回 T-triage，否则进入 Archive。
+按存在和当前模式同步 Ticket、Tickets Map、Goal Plan、`<Path>{roots.state}/specdev/changes/{change}/.status.json</Path>` 和全局状态；Direct Spec 不创建缺失的 Ticket/Map/Goal Plan。最后一个计划内 Ticket 完成后，Goal Plan 的 Lead 按 change completion 关闭；无 Goal Plan 的当前 I owner 承担同一门禁。需要远程 reconcile 或把已完成 Ticket 投影为 GitHub Issue 时返回 T-triage，否则进入 Archive。
 
 当前 change 属于未完成父实现 change 时，单个组合 Ticket 完成、阻塞或触发 Lead 复盘，且子状态与 Evidence 已写入后，必须自动返回 `<Path>{roots.workflows}/specdev/P-goal-plan/P-goal-plan.md</Path>`，由父 Lead 重读全部成员并决定重新派发、返回上游或继续下一 frontier；不得要求用户逐个重新激活，不得直接归档子 change，也不得从本 Work 实现另一个成员。
 

package/template/workflows/specdev/I-init-setup/tracking-template.md

@@ -10,4 +10,4 @@ SpecDev 只使用本地 Markdown/JSON 工件跟踪开发。远程 Issue、URL
 - 工件状态应在同一次操作中同步，避免入口状态、Ticket 状态与 Map 状态漂移。
 - 完成条件：全部必需 Ticket 为 `done` 或有批准的 `cancelled`，证据齐全，无未批准 deviation，change 级验证通过。
 - 归档后的 `<Path>{roots.state}/specdev/archive/YYYY-MM/{change}/</Path>` 默认只读；后续纠正通过新 change 和 supersedes 链完成。
-- 可关闭的远程来源在本地完成后由 Triage reconcile；`closed`、显式 `waived` 或 `not-applicable` 后才归档。
+- 可关闭的远程来源在本地完成后由 Triage reconcile；`closed`、显式 `waived` 或 `not-applicable` 后才归档。完成后若要把 Ticket 记到 GitHub，由 T-triage publish 写入 `<Path>{roots.state}/specdev/changes/{change}/publish.md</Path>`；`pending`/`publish-failed` 不可归档。发布计数以该账本为准，标签词表见 T-triage classification-map。远程 Issue 仍不是开发权威。

package/template/workflows/specdev/INDEX.md

@@ -3,7 +3,7 @@ id: specdev
 type: workflow
 workflow: specdev
 name: SpecDev Workflow
-description: 以本地工件为唯一开发权威，从来源冻结、诊断、设计、原型、规格、Ticket、编排和审查推进到证据驱动实现、远程 reconcile 与知识归档。
+description: 以本地工件为唯一开发权威，从来源冻结、诊断、设计、原型、规格、Ticket、编排和审查推进到证据驱动实现、远程 reconcile 或票级发布投影与知识归档。
 keywords: [specdev, local-first, 规格驱动开发, decision-complete, prototype, code-review, TDD, 证据]
 ---
 

package/template/workflows/specdev/README.md

@@ -8,7 +8,7 @@
 
 ## 工件链与权威
 
-大需求 → W 的 Initiative 候选图 → 每个 change 自己的 G/Grill → S/Spec → T 的计划型 Ticket 与 tickets-map → P 的 Goal → I/实现与 Evidence → Goal 集成验收 → 按需学习/远程 reconcile/归档。
+大需求 → W 的 Initiative 候选图 → 每个 change 自己的 G/Grill → S/Spec → T 的计划型 Ticket 与 tickets-map → P 的 Goal → I/实现与 Evidence → Goal 集成验收 → 按需学习/远程 reconcile 或 publish/归档。
 
 已明确的小请求直接进入适用阶段；无需为了路由而创建 Triage。跨 change 实现由 P 统一管理。
 
@@ -47,14 +47,14 @@ CLI 初始化和刷新保持原 namespace、三方配置合并、schema migrator
 
 ## 场景路由
 
-不清晰的大需求选 W，单 change 的高影响决定选 G，Ready Spec 拆票选 T-tickets，一个或多个 Ready change 的 Goal 选 P-goal-plan；来源冻结/远程回写才选 T-triage。精确条件与全部出口见 `<Path>{roots.workflows}/specdev/common/rules/workflow-routing.md</Path>`。
+不清晰的大需求选 W，单 change 的高影响决定选 G，Ready Spec 拆票选 T-tickets，一个或多个 Ready change 的 Goal 选 P-goal-plan；来源冻结/远程回写/完成后记账才选 T-triage。精确条件与全部出口见 `<Path>{roots.workflows}/specdev/common/rules/workflow-routing.md</Path>`。
 
 ## Work 条目
 
 
 <!-- AUTO-INDEX-START -->
 
-- **A-archive-and-consolidate** — 归档与沉淀：校验本地完成与远程 reconcile 门，复用全局归档能力移动 completed change 并提升当前知识，或从代码访谈形成可归档知识 change。
+- **A-archive-and-consolidate** — 归档与沉淀：校验本地完成、源 Issue reconcile 门和票级 publish_action 门，复用全局归档能力移动 completed change 并提升当前知识，或从代码访谈形成可归档知识 change。
 - **C-code-review** — 代码审查：将 commit、branch、tag、merge-base 或 PR 解析为本地不可变固定点，执行隔离的标准轴与规范轴审查并持久化可恢复报告。
 - **D-diagnose-bugs** — 诊断 Bug：先建立会在精确症状上变红的紧凑反馈回路，再通过最小化、排名假设和单变量探针确认根因，输出修复契约而不实施生产修复。
 - **G-grill-with-docs** — Change 决策访谈：一个已界定 change 仍有产品、领域或架构决定待确认时进行可恢复访谈；跨 change 边界未清晰时先用 W。
@@ -66,7 +66,7 @@ CLI 初始化和刷新保持原 namespace、三方配置合并、schema migrator
 - **R-review-architecture** — 架构审查：从用户指定范围或 Git 热点扫描代码库中的结构性坏味道、代码 judo 机会和维护性风险，以中文 Markdown 记录高置信候选，并对用户选择的一个方案运行设计树访谈。
 - **S-spec** — 编写 Spec：综合已知事实、设计决定、诊断与代码现状，产出以外部行为和验收合同为权威的 Ready Spec。
 - **T-tickets** — 编写计划型 Tickets：将已澄清的 Spec 或等价获批计划拆为可验收的实施 Ticket，并绑定真实项目 Skill；不用于探索未知需求或执行代码。
-- **T-triage** — 请求分诊：需要冻结外部来源、审计摄入或对 completed change 回写来源 Issue 时使用；已清晰的本地需求不必经本入口路由。
+- **T-triage** — 请求分诊：需要冻结外部来源、审计摄入、对 completed change 回写来源 Issue，或把已完成 Ticket 投影为带分类标签的 GitHub Issue 时使用；已清晰的本地需求不必为了路由而经本入口。
 - **W-wayfinder** — 探索大需求与 Change 边界：大需求的 change 边界或实施路线尚不可见时建立探索地图，并分别澄清各 change；已有清晰 Spec 时不触发。
 
 <!-- AUTO-INDEX-END -->

package/template/workflows/specdev/T-tickets/ticket-template.md

@@ -9,6 +9,7 @@ change: <YYYY-MM-DD-topic>
 id: T-01
 title: <标题>
 status: draft
+kind: bug
 planning_depth: standard
 planning_depth_reason: <触发该深度的事实>
 ready: false

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

@@ -3,15 +3,15 @@ id: specdev/triage
 type: workflow-entry
 workflow: specdev
 name: 请求分诊
-description: 需要冻结外部来源、审计摄入或对 completed change 回写来源 Issue 时使用；已清晰的本地需求不必经本入口路由。
-keywords: [triage, 摄入, import, issue, reconcile, close, 风险, 路由]
+description: 需要冻结外部来源、审计摄入、对 completed change 回写来源 Issue，或把已完成 Ticket 投影为带分类标签的 GitHub Issue 时使用；已清晰的本地需求不必为了路由而经本入口。
+keywords: [triage, 摄入, import, issue, reconcile, publish, close, 风险, 路由]
 ---
 
 # 请求分诊
 
 > 激活本 Work 后，先读取 `<Path>{roots.workflows}/specdev/README.md</Path>`，再执行本入口。
 
-Triage 是 SpecDev 唯一的远程摄入与关闭边界。开发期间，`<Path>{roots.state}/specdev/changes/{change}/source.md</Path>`、`<Path>{roots.state}/specdev/changes/{change}/triage.md</Path>`、Spec、Ticket、Map、Goal Plan、Evidence 和状态文件是唯一权威；远程系统只保存原始请求以及经确认后的完成通知。
+Triage 是 SpecDev 唯一的远程摄入、关闭与发布投影边界。开发期间，`<Path>{roots.state}/specdev/changes/{change}/source.md</Path>`、`<Path>{roots.state}/specdev/changes/{change}/triage.md</Path>`、`<Path>{roots.state}/specdev/changes/{change}/publish.md</Path>`、Spec、Ticket、Map、Goal Plan、Evidence 和状态文件是唯一权威；远程系统只保存原始请求以及经确认后的完成通知与票级发布记录。
 
 ## 读取范围
 
@@ -19,28 +19,30 @@ Triage 是 SpecDev 唯一的远程摄入与关闭边界。开发期间，`<Path>
 2. 再读取 `<Path>{roots.workflows}/specdev/common/rules/activation-and-memory.md</Path>`，按当前分支、状态和关键词定位最小相关工件。
 3. 只在本 Work 明确要求恢复、冲突、执行安全或归档证据时扩展为全量读取；缺少匹配证据或 owner/gateway 时停止受影响分支。
 
-
-普通本地请求直接进入适用 Work，不为了完成路由额外创建来源工件。用户明确要求来源审计时仍执行完整 intake；缺陷根因诊断仍交 D，不删除风险分诊与远程回写能力。
+普通本地请求直接进入适用 Work，不为了完成路由额外创建来源工件。用户明确要求来源审计时仍执行完整 intake；缺陷根因诊断仍交 D，不删除风险分诊与远程回写能力。完成后要记账才选 publish。
 
 ## 模式
 
 - **intake**：冻结输入、创建或恢复 change、分类并返回下一 Work。
-- **reconcile**：本地 change 已完成后，确认远程完成摘要并关闭支持的 GitHub Issue；不重新分诊或修改开发契约。
+- **reconcile**：本地 change 已完成后，确认远程完成摘要并关闭支持的 GitHub 来源 Issue；不重新分诊或修改开发契约。
+- **publish**：本地 change 已完成后，把计划内 Ticket 投影为带分类标签的 GitHub Issue，用脱敏 Evidence 关闭它们，并留下 `<Path>{roots.state}/specdev/changes/{change}/publish.md</Path>` 账本。标签必须包含 `specdev:published`。
 
 ## 共同启动
 
 1. 解析 roots，按 `<Path>{roots.workflows}/specdev/README.md</Path>` 读取全局状态和 change 状态。
-2. Intake 可以创建 change；reconcile 必须选择一个已存在的 completed change。
+2. Intake 可以创建 change；reconcile 与 publish 必须选择一个已存在的 change。publish 的对象必须已 completed。
 3. 若该 change 的 `current_work` 为 null，设置为 `specdev/triage`；指向其他 Work 时先恢复或完成显式 handoff。
-4. 重读已有 `<Path>{roots.state}/specdev/changes/{change}/source.md</Path>` 与 `<Path>{roots.state}/specdev/changes/{change}/triage.md</Path>`，不覆盖已冻结的来源。
+4. 重读已有 `<Path>{roots.state}/specdev/changes/{change}/source.md</Path>` 与 `<Path>{roots.state}/specdev/changes/{change}/triage.md</Path>`，不覆盖已冻结的来源。publish 在本地源缺失这些文件时可以按协议补建轻量快照，仍不得虚构 GitHub locator。
+
+`external_action` 只描述源 Issue。`publish_action` 只描述票级发布投影。两者互不覆盖。未授权时远程写入为零。
 
 ## Intake
 
 输入为远程 Issue、URL、项目相对文件、用户粘贴内容或当前对话时，加载 `<Path>{roots.workflows}/specdev/T-triage/intake-protocol.md</Path>`：
 
 1. 按协议解析来源、查重、脱敏、冻结并计算内容 hash；使用 `<Path>{roots.workflows}/specdev/T-triage/source-template.md</Path>` 原子写入 `<Path>{roots.state}/specdev/changes/{change}/source.md</Path>`。
-2. 按需读取永久 ADR/CONTEXT、当前 change 工件和相关代码事实；缺失的可选输入静默跳过。
-3. 分类为 bug、feature、refactor、investigation、operations、documentation、review 或 mixed。
+2. 按需读取永久 ADR/CONTEXT、当前 change 工件和相关代码事实；缺失的可选输入静默跳过。相似的已归档拒绝或 ADR 只展示，不自动 wontfix，也不回写源 Issue 标签。
+3. 分类为 bug、feature、refactor、investigation、operations、documentation、review 或 mixed。对照见 `<Path>{roots.workflows}/specdev/T-triage/references/classification-map.md</Path>`。
 4. 评估影响、紧急度、事故半径、安全、数据、迁移和人工批准；把未知项分为可发现事实、decision-needed 和低影响实现细节。
 5. 使用 `<Path>{roots.workflows}/specdev/T-triage/triage-template.md</Path>` 写入 `<Path>{roots.state}/specdev/changes/{change}/triage.md</Path>`。
 6. 运行阶段校验并返回最小正确路线：
@@ -59,11 +61,32 @@ Triage 是 SpecDev 唯一的远程摄入与关闭边界。开发期间，`<Path>
 本地 change 完成并需要关闭来源 Issue 时，加载：
 
 - `<Path>{roots.workflows}/specdev/common/rules/change-completion.md</Path>`；
-- `<Path>{roots.workflows}/specdev/T-triage/reconcile-protocol.md</Path>`。
+- `<Path>{roots.workflows}/specdev/T-triage/reconcile-protocol.md</Path>`；
+- `<Path>{roots.workflows}/specdev/T-triage/references/public-projection.md</Path>`。
 
 按协议重验本地完成、生成最小外部摘要、展示准确目标和动作、取得本次明确授权，再调用 `<Path>{roots.skills}/github-npm-ops/SKILL.md</Path>`。成功时把 `external_action` 更新为 `closed`；部分或完全失败为 `close-failed` 并保留可重试检查点；用户明确不关闭时为 `waived`。任何结果都不改写本地完成事实。
 
-Reconcile 成功或 waived 后返回 `<Path>{roots.workflows}/specdev/A-archive-and-consolidate/A-archive-and-consolidate.md</Path>`。不支持关闭的来源使用 `not-applicable`，无需虚构 provider。
+Reconcile 成功或 waived 后返回 `<Path>{roots.workflows}/specdev/A-archive-and-consolidate/A-archive-and-consolidate.md</Path>`。不支持关闭的来源使用 `not-applicable`，无需虚构 provider。若用户同时要求 publish，源 Issue 仍不是票 Issue。
+
+## Publish
+
+本地 change 完成、用户指定该 change 并要求把 Ticket 记到 GitHub 时，加载：
+
+- `<Path>{roots.workflows}/specdev/common/rules/change-completion.md</Path>`；
+- `<Path>{roots.workflows}/specdev/T-triage/publish-protocol.md</Path>`；
+- `<Path>{roots.workflows}/specdev/T-triage/references/classification-map.md</Path>`；
+- `<Path>{roots.workflows}/specdev/T-triage/references/public-projection.md</Path>`。
+
+按协议走硬门、确认表、dry-run，再调用 github-npm-ops 的 `issue-search` / `issue-create` / `issue-comment-close`。账本写 `<Path>{roots.state}/specdev/changes/{change}/publish.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>`。
+
+成功 `published`、用户放弃 `waived`，或从未请求的 `not-requested` 才允许归档。`pending` 与 `publish-failed` 挡住 Archive。下一站由用户指定：reconcile、A，或停止。
+
+workspace 计数：
+
+```bash
+node <Path>{roots.workflows}/specdev/T-triage/tools/publish-status.mjs</Path> \
+  --state-root <Path>{roots.state}/specdev</Path>
+```
 
 ## 状态与验证
 
@@ -75,7 +98,7 @@ node <Path>{roots.workflows}/specdev/common/tools/validate-specdev.mjs</Path> \
   <Path>{roots.state}/specdev/changes/{change}</Path>
 ```
 
-验证通过后原子重读 source、triage 和 change 状态。Intake 或 reconcile 成功时将 `specdev/triage` 去重加入 `works_run` 并清空 `current_work`；可恢复失败保留 `current_work` 和具体 blocker。
+验证通过后原子重读 source、triage、publish（若请求过）和 change 状态。Intake、reconcile 或 publish 成功时将 `specdev/triage` 去重加入 `works_run` 并清空 `current_work`；可恢复失败保留 `current_work` 和具体 blocker。
 
 ## 完成标准
 
@@ -85,11 +108,19 @@ node <Path>{roots.workflows}/specdev/common/tools/validate-specdev.mjs</Path> \
 - 开发权威完全位于本地 state；
 - 未授权时远程写入为零；
 - Reconcile 可从失败检查点幂等恢复；
+- Publish 可从 `<Path>{roots.state}/specdev/changes/{change}/publish.md</Path>` 失败行幂等恢复，cancelled 默认 skip，本地源计入发布数；
 - 状态、验证结果和下一 Work 完整路径已返回。
 
 ## 子文件引用
 
 - Intake：`<Path>{roots.workflows}/specdev/T-triage/intake-protocol.md</Path>`
 - Reconcile：`<Path>{roots.workflows}/specdev/T-triage/reconcile-protocol.md</Path>`
+- Publish：`<Path>{roots.workflows}/specdev/T-triage/publish-protocol.md</Path>`
 - Source 模板：`<Path>{roots.workflows}/specdev/T-triage/source-template.md</Path>`
 - Triage 模板：`<Path>{roots.workflows}/specdev/T-triage/triage-template.md</Path>`
+- Publish 模板：`<Path>{roots.workflows}/specdev/T-triage/publish-template.md</Path>`
+- 分类映射：`<Path>{roots.workflows}/specdev/T-triage/references/classification-map.md</Path>`
+- 公共投影：`<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>`
+- 发布计数：`<Path>{roots.workflows}/specdev/T-triage/tools/publish-status.mjs</Path>`

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

@@ -0,0 +1,42 @@
+# Evidence 关闭评论模板
+
+publish 调用 `issue-comment-close` 时使用。先套 `<Path>{roots.workflows}/specdev/T-triage/references/public-projection.md</Path>`。
+
+done 票 `--reason completed`：
+
+```markdown
+> *This was generated by AI during SpecDev T-triage publish.*
+
+## Completion
+
+**Result:** delivered and verified.
+
+**Public commit / PR:** <url or sha or 无公开 commit/PR>
+
+**Verification:**
+- Directed: passed | not-run (<reason>)
+- Regression: passed | not-run (<reason>)
+- E2E: passed | not-run (<reason>)
+
+**Residual risk:** <可公开残余风险或「无」。>
+
+Marker: `specdev:<change>:T-01:published`
+```
+
+纳入的 cancelled 票 `--reason not_planned`：
+
+```markdown
+> *This was generated by AI during SpecDev T-triage publish.*
+
+## Cancelled
+
+**Reason:** cancelled-already-implemented | cancelled-out-of-scope
+
+**Notes:** <指到已有公开位置或 ADR / 用户决定；不贴内部路径。>
+
+**Public commit / PR:** <url or sha or 无公开 commit/PR>
+
+Marker: `specdev:<change>:T-01:published`
+```
+
+父索引关闭评论 marker 为 `specdev:<change>:publish-index`，正文列出已关闭的子 Issue 编号与计数。

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

@@ -1,6 +1,6 @@
 # Intake Protocol
 
-仅在 Triage `mode=intake` 时加载。本协议把外部输入转换为不可静默覆盖的本地来源快照。
+仅在 Triage `mode=intake` 时加载。本协议把外部输入转换为不可静默覆盖的本地来源快照。v1 不回写源 Issue 标签。
 
 ## 1. 解析来源
 
@@ -16,6 +16,8 @@
 - locator 相同但 hash 不同：展示漂移，不覆盖原快照；只有用户确认后才创建新 change，并在新 source 中记录 `supersedes_source`；
 - 没有稳定 locator：按用户指定 change 或新 change 继续。
 
+同时只读扫描永久 ADR、archive 中已关闭的同类请求和当前 active change 标题。发现概念相似项时向用户展示路径与一句话理由，询问是否仍要继续。不自动 wontfix，不新建 `.out-of-scope/` 目录。
+
 ## 3. 冻结内容
 
 GitHub 来源保存 title、body、author、state、labels、created/updated 和截至捕获时可见的全部评论。普通 URL 保存可读正文和元数据；项目文件保存内容及项目相对 Path；粘贴或对话保存用户原文。
@@ -29,4 +31,6 @@ GitHub 来源保存 title、body、author、state、labels、created/updated 和
 - 来源类型、locator、捕获时间、hash 和关闭能力已确定；
 - 完整可持久化正文与评论已冻结；
 - 重复和漂移分支有唯一结果；
-- 失败没有生成伪造或不完整的 Ready source。
+- 相似归档/ADR 项已展示或明确无匹配；
+- 失败没有生成伪造或不完整的 Ready source；
+- 源 Issue 标签未被本协议修改。

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 事实未被改写；
+- 未授权时远程写入为零。