ai-delivery-workflow 0.2.2

package/skills/ai-delivery-orchestrate/assets/project-template/.workflow/standards/STD-ARTIFACT-PATH-001.md

@@ -0,0 +1,47 @@
+# STD-ARTIFACT-PATH-001 研发文档默认输出到 .workflow
+
+## 元数据
+
+- 版本：1.0.0
+- 状态：approved
+- 生效日期：2026-07-16
+- 适用范围：工作流状态、研发过程文档、结构化交付物、审阅材料和验证证据
+
+## 规则
+
+1. AI 生成的研发流程文档默认写入项目根目录 `.workflow/`，不得散落在项目根目录或源码目录。
+2. 工作流控制文件使用 `.workflow/delivery/`：
+   - `project.yaml`
+   - `workflow-state.yaml`
+   - `artifact-registry.yaml`
+   - `standards-baseline.yaml`
+   - `bootstrap/`
+   - `runtime/`
+3. 项目规范使用 `.workflow/standards/`。
+4. 长期产品、架构和体验基线，以及迭代节点交付物，必须位于 `.workflow/` 内；推荐使用：
+   - `.workflow/product/`
+   - `.workflow/architecture/`
+   - `.workflow/experience/`
+   - `.workflow/iterations/<iteration-id>/<node-id>/`
+5. Markdown、CSV、YAML、JSON、JSONL、图表、原型清单、评审记录、测试报告、发布清单、部署记录和验证证据均属于本规范所称的研发文档。
+6. 文档中的路径引用应使用相对项目根目录的 `.workflow/...` 路径，并在正式产物注册表中记录稳定 ID、版本和 checksum。
+7. `.workflow/` 默认纳入版本控制；只有 `.workflow/delivery/runtime/` 属于本地运行时并加入 Git 忽略。
+
+## 明确例外
+
+以下文件或目录因工具发现、执行或制品管理要求保留原位置：
+
+- 根目录 `AGENTS.md` 和 `.gitignore`；
+- `.agents/skills/`；
+- `.codex/config.toml`；
+- 应用源码、自动化测试源码、依赖清单和仓库配置；
+- 编译输出、容器镜像、发布二进制和其他非文档制品，其位置由构建与制品契约决定。
+
+即使非文档制品位于 `.workflow/` 外，描述其身份、digest、部署、验证和回滚的文档仍必须位于 `.workflow/`。
+
+## 验证
+
+- 新项目安装后必须存在 `.workflow/delivery/` 和 `.workflow/standards/`。
+- `.gitignore` 必须忽略 `.workflow/delivery/runtime/`，不得忽略整个 `.workflow/`。
+- 节点交接前，验证所有新产生的研发文档路径均位于 `.workflow/` 或属于上述明确例外。
+- 发现根目录或源码目录中的未授权流程文档时，节点不得放行；应迁移到 `.workflow/` 并更新所有引用和 checksum。

package/skills/ai-delivery-orchestrate/assets/project-template/.workflow/standards/STD-DOC-LANG-001.md

@@ -0,0 +1,62 @@
+---
+id: STD-DOC-LANG-001
+title: 研发文档默认使用中文
+version: 1.0.0
+status: approved
+scope:
+  - documentation
+  - delivery-artifacts
+  - human-facing-output
+effective_from: "2026-07-15"
+supersedes: null
+---
+
+# 规则
+
+所有新建或修订的面向人阅读的研发文档、交付说明、评审报告、风险说明和决策结论默认使用简体中文。
+
+# 适用范围
+
+- Markdown、纯文本、产品手册、需求说明、架构说明、体验说明、测试方案、测试报告、评审报告、发布说明、部署记录和生产验证报告。
+- CSV、YAML、JSON 等结构化产物中的人类可读标题、描述、理由、风险、结论和备注字段。
+- AI 向用户输出的流程状态、交接摘要和异常说明。
+
+# 排除项
+
+- 源代码标识符、命令、参数、文件路径、环境变量、稳定 ID、哈希、版本号和日志原文。
+- 既定 CSV/YAML/JSON 字段名、API 路径、协议字段、Schema、枚举值和第三方系统要求的固定文本。
+- 外部专有名词、标准名称和引用标题；保留原文，并在必要时补充中文解释。
+- 已批准、已发布或已归档的不可变历史产物，不因本规范追溯改写。
+- 用户在当前任务中明确指定其他语言的输出。
+
+# 正确示例
+
+```markdown
+# 发布风险
+
+本版本新增任务创建接口。主要风险是进程重启后内存数据丢失，该限制已在 V1 产品范围中接受。
+```
+
+```yaml
+release_id: REL-V1
+decision: released
+summary: "生产验证通过，版本可以归档。"
+```
+
+# 错误示例
+
+在没有外部格式要求或用户语言要求时，产品说明、架构结论和风险分析全部使用英文叙述。
+
+# 验证
+
+- 产出节点在交接前检查标题、正文、结论、风险和备注是否以中文为默认语言。
+- 下游验证节点检查技术原文是否被错误翻译，以及人类可读叙述是否无理由使用其他语言。
+- 产物 Schema 允许时，在基线或清单元数据中记录 `document_language: zh-CN`。
+
+# 例外
+
+用户明确要求其他语言、外部系统强制固定语言，或为了保持协议兼容性必须使用原文时可以例外。例外必须记录原因和影响范围，不得扩展到无关文档。
+
+# 违规处理
+
+行为：`return`。下游节点将不符合规范的文档退回原产出节点修订；不得由验证节点静默翻译或修改正式产物。

package/skills/ai-delivery-orchestrate/assets/project-template/.workflow/standards/STD-TEST-LOCATION-001.md

@@ -0,0 +1,23 @@
+# STD-TEST-LOCATION-001 应用测试遵循代码仓库原生约定
+
+## 元数据
+
+- 版本：1.1.0
+- 状态：approved
+- 生效日期：2026-07-18
+- 适用范围：应用自动化测试、测试入口、测试辅助代码、测试运行输出
+
+## 规则
+
+1. 应用测试必须存放在 `.workflow/config/workspace.yaml` 中 `code_repository.path` 所指代码仓库，并遵循该代码仓库已有框架、命名和目录约定。
+2. 不得为了满足工作流而强制创建固定的 `test/` 目录；已有 `tests/`、`__tests__/`、模块同目录测试或框架默认目录均可继续使用。
+3. 测试源码、夹具和测试配置不得写入 `.workflow/`；`.workflow/` 只记录测试计划、追踪关系、命令、结果摘要和证据引用。
+4. 测试运行生成的缓存、日志、覆盖率、临时数据库和环境副本按代码仓库现有规则忽略，不得登记为正式交付物。
+5. 候选验证与发布物料必须引用实际测试命令、代码 commit、证据路径和 checksum，不能依赖未受版本管理的临时输出证明通过。
+6. 新增、移动或删除应用测试时，同步更新代码仓库测试命令和受影响的工作流追踪物料。
+
+## 验证
+
+- 架构和开发工作包声明的测试命令必须在代码仓库中可执行。
+- `.workflow/` 中不得出现应用测试源码或测试运行缓存。
+- 候选验证必须能从正式证据追溯到对应代码 commit 和测试命令。

package/skills/ai-delivery-orchestrate/assets/project-template/.workflow/standards/index.yaml

@@ -0,0 +1,36 @@
+standards:
+  - id: STD-DOC-LANG-001
+    title: 研发文档默认使用中文
+    version: 1.0.0
+    status: approved
+    scope:
+      - documentation
+      - delivery-artifacts
+      - human-facing-output
+    effective_from: "2026-07-15"
+    superseded_id: null
+    path: STD-DOC-LANG-001.md
+  - id: STD-ARTIFACT-PATH-001
+    title: 研发文档默认输出到 .workflow
+    version: 1.0.0
+    status: approved
+    scope:
+      - documentation
+      - delivery-artifacts
+      - workflow-state
+      - human-facing-output
+    effective_from: "2026-07-16"
+    superseded_id: null
+    path: STD-ARTIFACT-PATH-001.md
+  - id: STD-TEST-LOCATION-001
+    title: 应用测试遵循代码仓库原生约定
+    version: 1.1.0
+    status: approved
+    scope:
+      - application-tests
+      - test-entrypoints
+      - test-helpers
+      - test-runtime-output
+    effective_from: "2026-07-18"
+    superseded_id: null
+    path: STD-TEST-LOCATION-001.md

package/skills/ai-delivery-orchestrate/assets/project-template/.workflow/tools/bootstrap/bootstrap.mjs

@@ -0,0 +1,33 @@
+#!/usr/bin/env node
+
+import path from "node:path";
+import { bootstrapProject, inspectProjectState } from "./project-bootstrap.mjs";
+
+function usage() {
+  return [
+    "Usage:",
+    "  node .workflow/tools/bootstrap/bootstrap.mjs inspect [project]",
+    "  node .workflow/tools/bootstrap/bootstrap.mjs bootstrap [project] [--dry-run]",
+  ].join("\n");
+}
+
+try {
+  const args = process.argv.slice(2);
+  const command = args[0] || "inspect";
+  if (command === "--help" || command === "help") {
+    process.stdout.write(`${usage()}\n`);
+  } else {
+    const projectArg = args.find((value, index) => index > 0 && !value.startsWith("--"));
+    const target = path.resolve(projectArg || process.cwd());
+    const result = command === "inspect"
+      ? inspectProjectState(target)
+      : command === "bootstrap"
+        ? bootstrapProject(null, target, { dryRun: args.includes("--dry-run") })
+        : null;
+    if (!result) throw new Error(`Unknown command: ${command}\n\n${usage()}`);
+    process.stdout.write(`${JSON.stringify(result, null, 2)}\n`);
+  }
+} catch (error) {
+  process.stderr.write(`ai-delivery-bootstrap: ${error.message}\n`);
+  process.exitCode = 1;
+}

package/skills/ai-delivery-orchestrate/assets/project-template/.workflow/tools/evolution/evolve.mjs

@@ -0,0 +1,15 @@
+#!/usr/bin/env node
+
+import { parse, stringify } from "../state/vendor/yaml/dist/index.js";
+import { executeEvolutionCommand } from "./evolution-runtime.mjs";
+
+try {
+  const result = executeEvolutionCommand(process.argv.slice(2), {
+    yaml: { parse, stringify: (value, options) => stringify(value, options) },
+  });
+  process.stdout.write(`${JSON.stringify(result, null, 2)}\n`);
+  if (result?.ok === false) process.exitCode = 1;
+} catch (error) {
+  process.stderr.write(`ai-delivery evolve: ${error.message}\n`);
+  process.exitCode = 1;
+}

package/skills/ai-delivery-orchestrate/assets/project-template/.workflow/tools/hooks/hook-event.mjs

@@ -0,0 +1,131 @@
+import fs from "node:fs";
+import path from "node:path";
+import { spawnSync } from "node:child_process";
+
+const SECRET_KEY = /^(authorization|cookie|set-cookie|password|passwd|secret|access[_-]?token|refresh[_-]?token|api[_-]?key|private[_-]?key)$/i;
+const MAX_STRING = 8_192;
+const MAX_EVENT = 64 * 1024;
+
+function now() {
+  return new Date().toISOString();
+}
+
+function findUp(start, relative) {
+  let current = path.resolve(start);
+  while (true) {
+    const candidate = path.join(current, relative);
+    if (fs.existsSync(candidate)) return candidate;
+    const parent = path.dirname(current);
+    if (parent === current) return null;
+    current = parent;
+  }
+}
+
+function redact(value, key = "") {
+  if (SECRET_KEY.test(key)) return "[REDACTED]";
+  if (typeof value === "string") {
+    return value
+      .replace(/Bearer\s+[A-Za-z0-9._~+\/-]+=*/gi, "Bearer [REDACTED]")
+      .replace(/\bsk-[A-Za-z0-9_-]{12,}\b/g, "[REDACTED_TOKEN]")
+      .slice(0, MAX_STRING);
+  }
+  if (Array.isArray(value)) return value.slice(0, 100).map((item) => redact(item));
+  if (value && typeof value === "object") {
+    return Object.fromEntries(Object.entries(value).slice(0, 200).map(([name, item]) => [name, redact(item, name)]));
+  }
+  return value;
+}
+
+function safeId(value) {
+  return String(value || "unassigned").replace(/[^A-Za-z0-9._-]/g, "_").slice(0, 128);
+}
+
+function atomicWrite(file, value) {
+  fs.mkdirSync(path.dirname(file), { recursive: true });
+  const temp = `${file}.${process.pid}.${Date.now()}.tmp`;
+  fs.writeFileSync(temp, `${JSON.stringify(value, null, 2)}\n`, "utf8");
+  fs.renameSync(temp, file);
+}
+
+async function readStdin() {
+  const chunks = [];
+  for await (const chunk of process.stdin) chunks.push(chunk);
+  return Buffer.concat(chunks).toString("utf8");
+}
+
+try {
+  const currentProjectFile = findUp(process.cwd(), path.join(".workflow", "delivery", "project.yaml"));
+  const legacyProjectFile = currentProjectFile
+    ? null
+    : findUp(process.cwd(), path.join("delivery", "project.yaml"));
+  const projectFile = currentProjectFile || legacyProjectFile;
+  if (!projectFile) process.exit(0);
+  const projectRoot = currentProjectFile
+    ? path.dirname(path.dirname(path.dirname(projectFile)))
+    : path.dirname(path.dirname(projectFile));
+  const markerFile = path.join(projectRoot, ".workflow", "delivery", "runtime", "active-task.json");
+  const marker = fs.existsSync(markerFile) ? JSON.parse(fs.readFileSync(markerFile, "utf8")) : null;
+  const raw = await readStdin();
+  const input = raw.trim() ? JSON.parse(raw) : {};
+  const taskId = safeId(process.env.AI_DELIVERY_TASK_ID || marker?.task_id || input.turn_id || input.session_id);
+  const stateRoot = path.resolve(process.env.AI_DELIVERY_STATE_ROOT || marker?.state_root || projectRoot);
+  const workflowRoot = fs.existsSync(path.join(stateRoot, ".workflow", "delivery", "project.yaml"))
+    ? path.join(stateRoot, ".workflow")
+    : stateRoot;
+  if (input.schema_version === 1 && typeof input.event_type === "string") {
+    const evolutionProjectRoot = path.basename(workflowRoot) === ".workflow"
+      ? path.dirname(workflowRoot)
+      : projectRoot;
+    const evolutionCli = path.join(evolutionProjectRoot, ".workflow", "tools", "evolution", "evolve.mjs");
+    if (!fs.existsSync(evolutionCli)) throw new Error(`Evolution CLI is missing: ${evolutionCli}`);
+    const dispatched = spawnSync(process.execPath, [
+      evolutionCli,
+      "hook", "dispatch", "--input", "-", "--project", evolutionProjectRoot,
+    ], {
+      cwd: evolutionProjectRoot,
+      input: raw,
+      encoding: "utf8",
+      timeout: 15_000,
+      windowsHide: true,
+    });
+    if (dispatched.error || dispatched.status !== 0) {
+      throw new Error(dispatched.error?.message || dispatched.stderr || `Evolution Hook exited ${dispatched.status}`);
+    }
+    process.stdout.write(dispatched.stdout);
+    const outcome = JSON.parse(dispatched.stdout);
+    process.exit(outcome.decision === "block" ? 2 : 0);
+  }
+  const runtime = path.join(workflowRoot, "delivery", "runtime");
+  const event = redact({
+    at: now(),
+    task_id: taskId,
+    event_name: input.hook_event_name || input.hookEventName || "unknown",
+    session_id: input.session_id || null,
+    turn_id: input.turn_id || null,
+    agent_id: input.agent_id || null,
+    agent_type: input.agent_type || null,
+    tool_name: input.tool_name || null,
+    input_fields: Object.keys(input).sort(),
+    tool_input_fields: input.tool_input && typeof input.tool_input === "object"
+      ? Object.keys(input.tool_input).sort()
+      : [],
+  });
+  let line = JSON.stringify(event);
+  if (Buffer.byteLength(line, "utf8") > MAX_EVENT) {
+    line = JSON.stringify({ at: event.at, task_id: taskId, event_name: event.event_name, truncated: true });
+  }
+  const eventFile = path.join(runtime, "events", `${taskId}.jsonl`);
+  fs.mkdirSync(path.dirname(eventFile), { recursive: true });
+  fs.appendFileSync(eventFile, `${line}\n`, "utf8");
+  atomicWrite(path.join(runtime, "heartbeats", `${taskId}.json`), {
+    task_id: taskId,
+    updated_at: event.at,
+    event_name: event.event_name,
+    session_id: event.session_id,
+    turn_id: event.turn_id,
+    tool_name: event.tool_name,
+  });
+} catch (error) {
+  process.stderr.write(`ai-delivery hook logger: ${error.message}\n`);
+  process.exitCode = 1;
+}

package/skills/ai-delivery-orchestrate/assets/project-template/.workflow/tools/state/state.mjs

@@ -0,0 +1,21 @@
+#!/usr/bin/env node
+
+import yamlPackage from "./vendor/yaml/dist/index.js";
+import { executeDeliveryStateCommand } from "./delivery-state.mjs";
+import { dispatchEvolutionHookEvent } from "../evolution/evolution-runtime.mjs";
+
+const yaml = {
+  parse: yamlPackage.parse,
+  stringify: (value) => yamlPackage.stringify(value, { lineWidth: 0 }),
+};
+
+try {
+  const result = executeDeliveryStateCommand(process.argv.slice(2), {
+    yaml,
+    onLifecycleEvent: (event) => dispatchEvolutionHookEvent(event.scope.project_root, event, { yaml }),
+  });
+  process.stdout.write(`${JSON.stringify(result, null, 2)}\n`);
+} catch (error) {
+  process.stderr.write(`ai-delivery-state: ${error.message}\n`);
+  process.exitCode = 1;
+}