create-yss-spec 3.2.0 → 3.3.1

package/template/scripts/verify-lifecycle-context-query-scenarios

@@ -0,0 +1,88 @@
+#!/usr/bin/env node
+import assert from "node:assert/strict";
+import { readFileSync } from "node:fs";
+import { spawnSync } from "node:child_process";
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+import { queryLifecycleContext } from "./lib/lifecycle-context-query.mjs";
+
+const ROOT = path.resolve(path.dirname(fileURLToPath(import.meta.url)), "..");
+
+const query = {
+  mode: "route",
+  stageId: "stage.plan",
+  workUnitId: "work-unit.plan-requirements",
+  include: ["grill_exit"],
+};
+const first = queryLifecycleContext(query);
+const second = queryLifecycleContext(query);
+
+assert.deepEqual(first, second, "同一查询必须产生确定性结果");
+// 合并调用须保留原来三次查询的路由、阶段和技能信息。
+const modeOnly = queryLifecycleContext({ mode: query.mode });
+const stageOnly = queryLifecycleContext({ stageId: query.stageId });
+const unitOnly = queryLifecycleContext({ workUnitId: query.workUnitId });
+assert.deepEqual(first.execution.mode, modeOnly.execution.mode);
+for (const key of ["stage", "gates", "artifacts", "evidence"]) {
+  assert.deepEqual(first.lifecycle[key], stageOnly.lifecycle[key]);
+}
+assert.deepEqual(first.lifecycle.work_unit, unitOnly.lifecycle.work_unit);
+assert.deepEqual(first.execution.work_unit_route, unitOnly.execution.work_unit_route);
+assert.deepEqual(first.execution.transition, unitOnly.execution.transition);
+assert.deepEqual(first.skills, unitOnly.skills);
+const efficient = queryLifecycleContext({ ...query, include: ["grill_exit", "execution_efficiency"] });
+assert.deepEqual(efficient.lifecycle, first.lifecycle, "执行成本策略不得改变阶段门禁");
+assert.deepEqual(efficient.skills, first.skills);
+assert.deepEqual(efficient.execution.transition, first.execution.transition);
+assert.equal(efficient.execution.selected.execution_efficiency.verification.skip_triggered_gates, "forbidden");
+assert.equal("execution_efficiency" in first.execution.selected, false, "成本策略仍按需加载");
+assert.equal(first.query.mode, "route");
+assert.equal(first.lifecycle.stage.id, "stage.plan");
+assert.ok(first.lifecycle.gates.every((gate) => gate.stage === "stage.plan"));
+assert.ok(first.lifecycle.artifacts.every((artifact) => artifact.stage === "stage.plan"));
+assert.equal(first.lifecycle.work_unit.id, "work-unit.plan-requirements");
+assert.equal(first.execution.mode, "read_only");
+assert.equal(first.execution.work_unit_route.primary_skill, "yss-product-lifecycle");
+assert.ok(first.execution.selected.grill_exit.required.includes("frontier_empty"));
+assert.equal("review_input" in first.execution.selected, false, "不得返回未请求的合同子树");
+assert.ok(first.skills.some((skill) => skill.id === "grilling"));
+assert.throws(() => queryLifecycleContext({ stageId: "stage.discovery" }), /未知阶段/);
+assert.throws(() => queryLifecycleContext({ workUnitId: "work-unit.discovery-requirements" }), /未知工作单元/);
+assert.match(first.sources.lifecycle_registry.semantic_sha256, /^[0-9a-f]{64}$/);
+assert.match(first.sources.orchestration_contract.sha256, /^[0-9a-f]{64}$/);
+
+for (const invalid of [
+  { mode: "invalid" },
+  { stageId: "stage.missing" },
+  { workUnitId: "work-unit.missing" },
+  { include: ["missing_contract_section"] },
+]) {
+  assert.throws(() => queryLifecycleContext(invalid), /未知|至少提供/);
+}
+
+const cli = spawnSync("node", [
+  "scripts/query-lifecycle-context",
+  "--mode", "route",
+  "--stage", "stage.plan",
+  "--work-unit", "work-unit.plan-requirements",
+  "--include", "grill_exit",
+], { cwd: ROOT, encoding: "utf8" });
+assert.equal(cli.status, 0, cli.stderr);
+assert.deepEqual(JSON.parse(cli.stdout), first, "CLI 输出必须等于库函数的规范投影");
+
+const skillPath = path.join(ROOT, ".agents/skills/yss-product-lifecycle/SKILL.md");
+const skill = readFileSync(skillPath, "utf8");
+assert.ok(Buffer.byteLength(skill) <= 8192, "生命周期入口 Skill 必须保持在 8KB 软预算内");
+assert.equal(skill.includes("| 主阶段 |"), false, "入口 Skill 不得复制完整阶段表");
+for (const marker of [
+  "docs/process/lifecycle-registry.yaml",
+  "references/orchestration-contract.yaml",
+  "docs/agents/yss-skill-registry.yaml",
+  "scripts/query-lifecycle-context",
+  "### 仓库身份",
+  "### 流转与实现",
+  "### 用户决定",
+  "### 外部副作用与 Git",
+]) assert.match(skill, new RegExp(marker.replace(/[.*+?^${}()|[\]\\]/g, "\\$&")));
+
+process.stdout.write("生命周期按需上下文查询场景验证通过\n");

package/template/scripts/verify-lifecycle-transition-scenarios

@@ -3,16 +3,24 @@ import assert from "node:assert/strict";
 import { mkdtempSync, rmSync, readFileSync, existsSync } from "node:fs";
 import os from "node:os";
 import path from "node:path";
-import { buildImplementationFixture } from "./fixtures/user-decision/build-fixture.mjs";
+import { buildDecisionFixture, buildImplementationFixture } from "./fixtures/user-decision/build-fixture.mjs";
 const temp = mkdtempSync(path.join(os.tmpdir(), "lifecycle-decision-test-"));
 process.on("exit", () => rmSync(temp, { recursive: true, force: true }));
 const approval = buildImplementationFixture(temp, "docs/.scratch/demo/issues/01-valid-slice.md");
-import { validateImplementationEntry, validateNextRoute, validateTicketFormalization } from "./lib/lifecycle-transition.mjs";
+const scaffoldApproval = buildDecisionFixture(path.join(temp, "scaffold-choice"), { boundary: "scaffold-choice", scope: ["backend", "frontend"] });
+import { validateImplementationEntry, validateImplementationRepositoriesReady, validateNextRoute, validateTicketFormalization } from "./lib/lifecycle-transition.mjs";
 
 const exists = (ref) => [
   "docs/process/lifecycle-registry.yaml",
   "docs/.scratch/demo/issues/01-valid-slice.md",
   "docs/.scratch/demo/evidence/ticket-decomposition-result.yaml",
+  "docs/.scratch/demo/evidence/repository-preparation.yaml",
+  "docs/.scratch/demo/evidence/backend-onboarding.yaml",
+  "docs/.scratch/demo/evidence/frontend-onboarding.yaml",
+  "docs/.scratch/demo/evidence/backend-manifest.json",
+  "docs/.scratch/demo/evidence/backend-verification.json",
+  "docs/.scratch/demo/evidence/frontend-manifest.json",
+  "docs/.scratch/demo/evidence/frontend-verification.json",
 ].includes(ref) || existsSync(ref);
 const decompositionResult = `result_schema: workflow-execution-result-v1\nwork_unit: work-unit.ticket-decomposition\nresult: completed\nevidence_refs:\n  - docs/.scratch/demo/evidence/ticket-decomposition-result.yaml\n`;
 const read = (ref) => ref === "docs/.scratch/demo/evidence/ticket-decomposition-result.yaml" ? decompositionResult : readFileSync(ref, "utf8");
@@ -20,6 +28,17 @@ const options = { exists, read };
 
 const validTicketState = {
   ...approval.state,
+  user_decisions: [...approval.state.user_decisions, scaffoldApproval.requirement],
+  delivery_impacts: { backend: true, frontend: true },
+  implementation_repository_preparation: {
+    result: "completed",
+    current_version: true,
+    evidence_refs: ["docs/.scratch/demo/evidence/repository-preparation.yaml"],
+    projects: [
+      { project_id: "backend", delivery_role: "backend", status: "existing-and-onboarded", repository_ref: "git://backend", project_root: "/workspace/backend", repository_scope: "external-repository", onboarding_result: { status: "completed", ref: "docs/.scratch/demo/evidence/backend-onboarding.yaml" } },
+      { project_id: "frontend", delivery_role: "frontend", status: "existing-and-onboarded", repository_ref: "git://frontend", project_root: "/workspace/frontend", repository_scope: "external-repository", onboarding_result: { status: "completed", ref: "docs/.scratch/demo/evidence/frontend-onboarding.yaml" } },
+    ],
+  },
   predecessor_work_unit: "work-unit.ticket-decomposition",
   tracker_kind: "local-markdown",
   ticket_decomposition_result_ref: "docs/.scratch/demo/evidence/ticket-decomposition-result.yaml",
@@ -45,6 +64,19 @@ const validTicketState = {
 
 const valid = validateTicketFormalization(validTicketState, options);
 assert.equal(valid.result, "allowed");
+assert.equal(validateImplementationRepositoriesReady(validTicketState, options).result, "allowed");
+const initializedState = {
+  delivery_impacts: { backend: true, frontend: true },
+  implementation_repository_preparation: {
+    result: "completed", current_version: true, evidence_refs: ["docs/.scratch/demo/evidence/repository-preparation.yaml"],
+    projects: [
+      { project_id: "backend-ddd", delivery_role: "backend", status: "initialized-and-verified", repository_ref: "git://backend", project_root: "/workspace/backend", repository_scope: "external-repository", architecture_family: "domain-driven", scaffold_contract: { schema_version: 4, status: "approved", persisted: true, current_version: true }, scaffold_manifest_ref: "docs/.scratch/demo/evidence/backend-manifest.json", scaffold_verification: { status: "passed", ref: "docs/.scratch/demo/evidence/backend-verification.json" } },
+      { project_id: "frontend", delivery_role: "frontend", status: "initialized-and-verified", repository_ref: "git://frontend", project_root: "/workspace/frontend", repository_scope: "external-repository", template_available: true, scaffold_contract: { schema_version: 4, status: "approved", persisted: true, current_version: true }, scaffold_manifest_ref: "docs/.scratch/demo/evidence/frontend-manifest.json", scaffold_verification: { status: "passed", ref: "docs/.scratch/demo/evidence/frontend-verification.json" } },
+    ],
+  },
+};
+assert.equal(validateImplementationRepositoriesReady(initializedState, options).result, "allowed");
+assert.equal(validateImplementationRepositoriesReady({ delivery_impacts: { backend: false, frontend: false }, implementation_repository_preparation: { result: "completed", current_version: true, evidence_refs: ["docs/.scratch/demo/evidence/repository-preparation.yaml"], projects: [{ project_id: "backend-na", delivery_role: "backend", status: "not-applicable", reason: "no backend impact" }, { project_id: "frontend-na", delivery_role: "frontend", status: "not-applicable", reason: "no frontend impact" }] } }, options).result, "allowed");
 
 const implementation = validateImplementationEntry({
   ...validTicketState,
@@ -53,6 +85,11 @@ const implementation = validateImplementationEntry({
 assert.equal(implementation.result, "allowed");
 
 const cases = [
+  ["missing repository preparation", { ...validTicketState, implementation_repository_preparation: undefined }, "implementation-repository-decision-required"],
+  ["stale repository preparation", { ...validTicketState, implementation_repositories_stale: true }, "implementation-repositories-stale"],
+  ["missing frontend decision", { ...validTicketState, implementation_repository_preparation: { ...validTicketState.implementation_repository_preparation, projects: validTicketState.implementation_repository_preparation.projects.filter((item) => item.delivery_role !== "frontend") } }, "implementation-repository-decision-required"],
+  ["missing repository location", { ...validTicketState, implementation_repository_preparation: { ...validTicketState.implementation_repository_preparation, projects: validTicketState.implementation_repository_preparation.projects.map((item) => item.delivery_role === "backend" ? { ...item, project_root: undefined } : item) } }, "implementation-repository-location-required"],
+  ["incomplete onboarding", { ...validTicketState, implementation_repository_preparation: { ...validTicketState.implementation_repository_preparation, projects: validTicketState.implementation_repository_preparation.projects.map((item) => item.delivery_role === "backend" ? { ...item, onboarding_result: { status: "blocked" } } : item) } }, "implementation-repository-onboarding-incomplete"],
   ["missing decomposition result ref", { ...validTicketState, ticket_decomposition_result_ref: undefined }, "ticket-decomposition-result-ref-missing"],
   ["missing slice ref", { ...validTicketState, vertical_slice_ticket_ref: undefined }, "vertical-slice-ticket-ref-missing"],
   ["missing slice role", { ...validTicketState, vertical_slice_ticket_role: undefined }, "vertical-slice-ticket-role-missing"],
@@ -90,7 +127,10 @@ for (const current of ["work-unit.spec-synthesis", "work-unit.prototype-design",
   assert.equal(result.result, "blocked", current);
   assert.ok(result.blocking_signals.includes("ticket-formalization-required"), current);
 }
-assert.equal(validateNextRoute("work-unit.spec-synthesis", "work-unit.ticket-decomposition").result, "allowed");
+assert.equal(validateNextRoute("work-unit.spec-synthesis", "work-unit.ticket-decomposition").result, "blocked");
+assert.equal(validateNextRoute("work-unit.technical-analysis", "work-unit.implementation-repository-preparation").result, "allowed");
+assert.equal(validateNextRoute("work-unit.implementation-repository-preparation", "work-unit.ticket-decomposition", validTicketState, options).result, "allowed");
+assert.ok(validateNextRoute("work-unit.implementation-repository-preparation", "work-unit.ticket-decomposition", {}, options).blocking_signals.includes("implementation-repository-decision-required"));
 assert.equal(validateNextRoute("work-unit.intensity-aware-verification", "work-unit.intensity-aware-review").result, "allowed");
 assert.equal(validateNextRoute("work-unit.release-and-rollback", null).result, "allowed");
 const arbitraryReadable = validateTicketFormalization({
@@ -110,6 +150,6 @@ assert.equal(validateTicketFormalization({
   vertical_slice_ticket_ref: "https://github.com/example/project/issues/1",
   vertical_slice_ticket: { ref: "https://github.com/example/project/issues/1", kind: "vertical-slice-ticket", role: "ready-for-agent" },
   slice_contract: { ...validTicketState.slice_contract, ticket_ref: "https://github.com/example/project/issues/1" },
-}, { ...options, exists: (ref) => ref === "https://github.com/example/project/issues/1", read: (ref) => ref === "https://github.com/example/project/issues/1" ? decompositionResult.replace("docs/.scratch/demo/evidence/ticket-decomposition-result.yaml", "https://github.com/example/project/issues/1") : readFileSync(ref, "utf8") }).result, "allowed");
+}, { ...options, exists: (ref) => ref === "https://github.com/example/project/issues/1" || exists(ref), read: (ref) => ref === "https://github.com/example/project/issues/1" ? decompositionResult.replace("docs/.scratch/demo/evidence/ticket-decomposition-result.yaml", "https://github.com/example/project/issues/1") : readFileSync(ref, "utf8") }).result, "allowed");
 
 process.stdout.write("生命周期转换压力场景验证通过\n");

package/template/scripts/verify-plan-spec-entry

@@ -0,0 +1,11 @@
+#!/usr/bin/env node
+import { decisionIO } from './lib/user-decision.mjs';
+import { assertPlanSpecEntry } from './lib/plan-spec-entry.mjs';
+try {
+  if (process.argv.length !== 3) throw new TypeError('用法: node scripts/verify-plan-spec-entry <state.yaml|json>');
+  assertPlanSpecEntry(decisionIO().document(process.argv[2]));
+  process.stdout.write('Plan → Spec 入口检查通过（不授权实现）\n');
+} catch (error) {
+  process.stderr.write(`${error.message}\n`);
+  process.exitCode = 1;
+}

package/template/scripts/verify-plan-spec-entry-scenarios

@@ -0,0 +1,79 @@
+#!/usr/bin/env node
+import assert from 'node:assert/strict';
+import { validateNextRoute } from './lib/lifecycle-transition.mjs';
+import { queryLifecycleContext } from './lib/lifecycle-context-query.mjs';
+import { mkdtempSync, rmSync } from 'node:fs';
+import { tmpdir } from 'node:os';
+import path from 'node:path';
+import { buildPlanFixture } from './fixtures/user-decision/plan-fixture.mjs';
+import { assertPlanSpecEntry, assertPlanCheckpoint } from './lib/plan-spec-entry.mjs';
+import { readFileSync } from 'node:fs';
+import { decisionDigest } from './lib/user-decision.mjs';
+import { buildDecisionFixture } from './fixtures/user-decision/build-fixture.mjs';
+import { loadDigitalHumanRoles, countersignRuleForGate } from './lib/digital-human-roles.mjs';
+
+for (const unit of ['plan-opportunity', 'plan-requirements', 'domain-strategy-design', 'stage-decision']) {
+  for (const state of [undefined, {}, { gates: {}, user_decisions: [] }]) {
+    assert.equal(validateNextRoute(`work-unit.${unit}`, 'work-unit.spec-synthesis', state).result, 'blocked', `${unit}: missing Plan review must block`);
+  }
+}
+const query = queryLifecycleContext({ workUnitId: 'work-unit.plan-requirements' });
+assert.ok(query.execution.selected.planning);
+assert.ok(query.execution.selected.grill_exit);
+assert.ok(query.lifecycle.gates.length);
+assert.ok(query.execution.plan_checks.every(check => check.status === 'pending'));
+const specQuery = queryLifecycleContext({ stageId: 'stage.spec-architecture' });
+assert.ok(specQuery.execution.selected.planning);
+assert.ok(specQuery.execution.plan_checks.every(check => check.status === 'pending'));
+assert.ok(specQuery.lifecycle.gates.some(gate => gate.stage === 'stage.plan'));
+const temp = mkdtempSync(path.join(tmpdir(), 'yss-plan-entry-'));
+try {
+  const mutations = [
+    ['缺检查项', f => delete f.review.checks.goals],
+    ['默认 pending', f => f.review.checks.goals.status = 'pending'],
+    ['检查项不能 N/A', f => f.review.checks.goals.status = 'not-applicable'],
+    ['缺证据', f => f.review.checks.goals.evidence_refs = []],
+    ['缺影响面', f => delete f.review.impacts.domain_strategy],
+    ['缺门禁', f => delete f.review.gates['gate.domain-strategy-approved']],
+    ['命中门禁不能 N/A', f => f.review.impacts.domain_strategy = true],
+    ['N/A 无原因', f => delete f.review.gates['gate.domain-strategy-approved'].reason],
+    ['关键问题延期', f => f.review.open_items.push({ id: 'q1', critical: true, runnable_blocker: false, status: 'deferred' })],
+    ['可执行阻塞延期', f => f.review.open_items.push({ id: 'q1', critical: false, runnable_blocker: true, status: 'deferred' })],
+    ['延期未交接', f => f.review.open_items.push({ id: 'q1', critical: false, runnable_blocker: false, status: 'deferred' })],
+    ['无回复', f => { f.approval.record.responses = []; f.approval.save(); }],
+    ['过期依据', f => f.write('plan.md', '变更后的范围')],
+    ['错误范围', f => f.state.feature_id = 'feature.other'],
+    ['调和未通过', f => f.review.context_reconciliation_ref = 'plan.md'],
+  ];
+  const valid = buildPlanFixture(path.join(temp, 'valid'));
+  assert.equal(assertPlanSpecEntry(valid.state, { root: valid.root }).result, 'allowed');
+  assert.equal(validateNextRoute('work-unit.plan-opportunity', 'work-unit.spec-synthesis', valid.state, { root: valid.root }).result, 'allowed');
+  valid.review.open_items = [{ id: 'q-detail', critical: false, runnable_blocker: false, status: 'deferred', noncritical_reason: '不影响范围或关键规则', owner: '测试负责人', resolution_point: 'Spec 评审前', downstream_recipient: '测试需求负责人', evidence_refs: ['plan.md'] }];
+  valid.reapprove();
+  assert.equal(assertPlanSpecEntry(valid.state, { root: valid.root }).result, 'allowed', '用户确认后的非关键延期可通过');
+  for (const [gateId, impact] of Object.entries({ 'gate.domain-strategy-approved': 'domain_strategy', 'gate.stage-decision-package-approved': 'stage_decision' })) {
+    const subjectRef = path.join(valid.root, 'plan.md');
+    const reply = buildDecisionFixture(path.join(valid.root, impact), { boundary: gateId, subjectRef });
+    const rule = countersignRuleForGate(loadDigitalHumanRoles().gate_policy, gateId);
+    const approvalRef = path.join(valid.root, `${impact}.json`);
+    valid.write(approvalRef, { schema_version: 1, gate_id: gateId, decision: 'approved', actor_kind: 'digital-human', role_id: rule.countersigners[0], runtime_id: 'runtime.skill-projection', principal_ref: 'test-only.reviewer', subject_ref: subjectRef, approval_scope: ['feature.demo'], user_decision_ref: reply.ref });
+    valid.review.impacts[impact] = true;
+    valid.review.gates[gateId] = { status: 'approved', approval_ref: approvalRef, subject_ref: subjectRef, approval_scope: ['feature.demo'], evidence_refs: [approvalRef, subjectRef] };
+    for (const ref of [approvalRef, subjectRef]) if (!valid.review.basis.some(asset => asset.ref === ref)) valid.review.basis.push({ ref, digest: decisionDigest(readFileSync(ref)) });
+  }
+  valid.reapprove();
+  assert.equal(assertPlanSpecEntry(valid.state, { root: valid.root }).result, 'allowed', '命中门禁、真实回复来源与当前资产绑定均通过');
+  valid.review.gates['gate.domain-strategy-approved'].approval_scope = ['feature.other']; valid.reapprove();
+  assert.throws(() => assertPlanSpecEntry(valid.state, { root: valid.root }), /会签资产或范围不匹配/);
+  for (const [name, mutate] of mutations) {
+    const f = buildPlanFixture(path.join(temp, name)); mutate(f); f.save();
+    assert.throws(() => assertPlanSpecEntry(f.state, { root: f.root }), undefined, name);
+  }
+  for (const checkpoint of [{ next_work_unit: 'work-unit.spec-synthesis' }, { stage: 'stage.spec-architecture' }, { stage_trace: { completed_work_unit: 'work-unit.spec-synthesis' } }]) {
+    assert.throws(() => assertPlanCheckpoint({ repository_mode: 'project-instance', ...checkpoint }), /plan-spec-entry-blocked/);
+  }
+  const stale = buildPlanFixture(path.join(temp, 'stale-review'));
+  stale.review.gates['gate.domain-strategy-approved'].reason += ' changed'; stale.save();
+  assert.throws(() => assertPlanSpecEntry(stale.state, { root: stale.root }), /user-decision-stale/);
+} finally { rmSync(temp, { recursive: true, force: true }); }
+process.stdout.write('Plan → Spec 无状态绕过与默认加载检查通过\n');

package/template/scripts/verify-script-performance-scenarios

@@ -0,0 +1,56 @@
+#!/usr/bin/env node
+import assert from 'node:assert/strict';
+import * as fs from 'node:fs';
+import os from 'node:os';
+import path from 'node:path';
+import { spawn, spawnSync } from 'node:child_process';
+import { once } from 'node:events';
+import { pathToFileURL } from 'node:url';
+import { validateJsonSchemas, validateJsonSchema } from './lib/json-schema.mjs';
+import { runCommand, runCommandSync } from './lib/command-runner.mjs';
+const temp=fs.mkdtempSync(path.join(os.tmpdir(),'yss-performance-scenarios-'));
+try {
+  const schema=path.join(temp,'schema.json');
+  fs.writeFileSync(schema,JSON.stringify({$defs:{name:{type:'string',minLength:2}},type:'object',required:['name'],properties:{name:{$ref:'#/$defs/name'},email:{type:'string',format:'email'},items:{type:'array',items:{type:'integer'}}},additionalProperties:false}));
+  const values=[{name:'okay'},{name:'x'},{name:'okay',email:'wrong'},null,{name:'okay',items:['bad']},{name:'okay',unknown:1}];
+  for(const formatChecker of [true,false])for(const errorStyle of ['compact','verbose']) {
+    const jobs=values.map(value=>({value,schemaPath:schema,formatChecker,errorStyle}));
+    const results=validateJsonSchemas(jobs);
+    // Independent original Python behavior, not the new single-item wrapper.
+    const legacy=spawnSync('python3',['-c',`import json,sys\nfrom jsonschema import Draft202012Validator,FormatChecker\ns=json.load(open(sys.argv[1])); rows=[]\nfor v in json.load(sys.stdin):\n e=list(Draft202012Validator(s,format_checker=${formatChecker?'FormatChecker()':'None'}).iter_errors(v))\n ${errorStyle==='compact'?"e.sort(key=lambda x:list(x.absolute_path))":"pass"}\n message=${errorStyle==='compact'?`'\\n'.join(f"{'.'.join(str(p) for p in x.absolute_path) or '<root>'}: {x.message}" for x in e)`:`'\\n'.join(str(x) for x in e)`}\n rows.append({'valid':not e,'error':message})\njson.dump(rows,sys.stdout)`,schema],{input:JSON.stringify(values),encoding:'utf8'});
+    assert.equal(legacy.status,0,legacy.stderr);
+    assert.deepEqual(results,JSON.parse(legacy.stdout));
+  }
+  assert.deepEqual(validateJsonSchemas([]),[]);
+  assert.throws(()=>validateJsonSchema({},path.join(temp,'missing.json')),/缺少/);
+  fs.writeFileSync(schema,JSON.stringify({type:'number'}));
+  assert.throws(()=>validateJsonSchema({name:'okay'},schema),/not of type/,'schema 改变后必须重新读取');
+  const log=path.join(temp,'stdout.log');
+  const split=await runCommand(process.execPath,['-e',"process.stdout.write('ab');setTimeout(()=>process.stdout.write('aba!'),20)"],{stdoutFile:log,secrets:['ababa']});
+  assert.equal(split.stdout,'[REDACTED]!');assert.equal(fs.readFileSync(log,'utf8'),'[REDACTED]!');
+  const timed=await runCommand(process.execPath,['-e',"setInterval(()=>{},1000)"],{timeoutMs:100});
+  assert.equal(timed.status,124);assert.equal(timed.termination,'timeout');
+  const controller=new AbortController();
+  const cancelled=runCommand(process.execPath,['-e',"setInterval(()=>{},1000)"],{signal:controller.signal});
+  setTimeout(()=>controller.abort(),50);assert.equal((await cancelled).termination,'cancelled');
+  const missing=await runCommand(path.join(temp,'missing'),[]);assert.notEqual(missing.status,0);
+  assert.equal(runCommandSync(process.execPath,['-e',"process.stdout.write('sync')"]).stdout,'sync');
+  const pidFile=path.join(temp,'pid');
+  const tree=await runCommand(process.execPath,['-e',`const {spawn}=require('node:child_process');const fs=require('node:fs');const c=spawn(process.execPath,['-e','setInterval(()=>{},1000)'],{stdio:'ignore'});fs.writeFileSync(${JSON.stringify(pidFile)},String(c.pid));setInterval(()=>{},1000)`],{timeoutMs:250});
+  assert.equal(tree.termination,'timeout');
+  const pid=Number(fs.readFileSync(pidFile,'utf8'));
+  // A reparented zombie may briefly exist; it must never remain a running child.
+  const state=spawnSync('ps',['-o','stat=','-p',String(pid)],{encoding:'utf8'});
+  assert.ok(state.status!==0 || !state.stdout.trim() || state.stdout.trim().startsWith('Z'),state.stdout);
+  const orphanPid=path.join(temp,'orphan-pid'), scratch=path.join(temp,'owned-fetch');fs.mkdirSync(scratch);
+  const parent=spawn(process.execPath,['--input-type=module','-e',`import {runCommandSync} from ${JSON.stringify(pathToFileURL(path.join(import.meta.dirname,'lib/command-runner.mjs')).href)};runCommandSync(process.execPath,['-e',${JSON.stringify(`require('node:fs').writeFileSync(${JSON.stringify(orphanPid)},String(process.pid));setInterval(()=>{},1000)`)}],{cleanupPathsOnFailure:[${JSON.stringify(scratch)}]});`],{stdio:'ignore'});
+  const exited=once(parent,'exit');
+  for(let n=0;n<150&&!fs.existsSync(orphanPid);n++)await new Promise(resolve=>setTimeout(resolve,20));
+  assert.ok(fs.existsSync(orphanPid),'worker 子进程应启动');
+  parent.kill('SIGTERM');await exited;
+  for(let n=0;n<150&&fs.existsSync(scratch);n++)await new Promise(resolve=>setTimeout(resolve,20));
+  assert.equal(fs.existsSync(scratch),false,'同步调用者退出后 worker 应清理其临时资源');
+  const orphanState=spawnSync('ps',['-o','stat=','-p',fs.readFileSync(orphanPid,'utf8')],{encoding:'utf8'});
+  assert.ok(orphanState.status!==0 || !orphanState.stdout.trim() || orphanState.stdout.trim().startsWith('Z'),orphanState.stdout);
+  console.log('schema 批量差分、重新读取、日志脱敏、超时、取消与进程树清理通过');
+} finally { fs.rmSync(temp,{recursive:true,force:true}); }

package/template/scripts/verify-subagent-task-package-scenarios

@@ -83,7 +83,7 @@ function packageBase(roleId, taskId, workUnitId, kind, contractFields, stageId)
 }
 
 function lifecyclePackage() {
-  return packageBase("role.requirements-manager", "task-discovery", "work-unit.discovery-opportunity", "lifecycle-work-unit", { lifecycle_ref: "docs/process/lifecycle-registry.yaml", artifact_refs: ["artifact.discovery-record"] , gate_refs: [] , contract_id: "lifecycle-discovery", contract_version: 1 }, "stage.discovery");
+  return packageBase("role.requirements-manager", "task-discovery", "work-unit.plan-opportunity", "lifecycle-work-unit", { lifecycle_ref: "docs/process/lifecycle-registry.yaml", artifact_refs: ["artifact.plan-record"] , gate_refs: [] , contract_id: "lifecycle-discovery", contract_version: 1 }, "stage.plan");
 }
 
 function lifecycleStagePackage(roleId, taskId, workUnitId, stageId) {
@@ -134,7 +134,7 @@ function completedResult(pkg, overrides = {}) {
     violation: [],
     new_impacts: [],
     stale_candidates: [],
-    next_route: "work-unit.spec-synthesis",
+    next_route: "work-unit.plan-requirements",
     blocking_signals: [],
     ...overrides
   };
@@ -160,18 +160,19 @@ try {
   maintenance.review_context = { implementation_actor_id: "role.lifecycle-orchestrator.instance-1" };
   const frontend = slicePackage("role.frontend-engineer", "task-frontend", "work-unit.slice-frontend", "apps/frontend/todo/");
   const backend = slicePackage("role.backend-engineer", "task-backend", "work-unit.slice-backend", "apps/backend/todo/");
-  [discovery, spec, prototype, technical, tickets, review].forEach((pkg) => validateTaskPackage(pkg));
+  [discovery, prototype, technical, tickets, review].forEach((pkg) => validateTaskPackage(pkg));
+  assert.throws(() => validateTaskPackage(spec), /plan-spec-entry-blocked/, "直接派发 Spec 缺 Plan 审阅须阻断");
   validateTaskPackage(maintenance);
   validateTaskPackage(frontend);
   assert.throws(() => validateTaskPackage({ ...frontend, user_decisions: [] }), /user-decision-scope-mismatch/, "Worker 派发前必须有当前实施范围批准");
   validateTaskPackage(backend);
   validateTaskPackageSet([frontend, backend]);
 
-  const completedDiscovery = lifecyclePackage();
-  completedDiscovery.workflow_status = "resolved";
-  completedDiscovery.verification_results = [{ command: "scripts/verify-template", exit_code: 0, executed_at: "now", evidence_ref: evidenceRef }];
-  completedDiscovery.result = completedResult(completedDiscovery);
-  validateTaskPackage(completedDiscovery);
+  const completedPlan = lifecyclePackage();
+  completedPlan.workflow_status = "resolved";
+  completedPlan.verification_results = [{ command: "scripts/verify-template", exit_code: 0, executed_at: "now", evidence_ref: evidenceRef }];
+  completedPlan.result = completedResult(completedPlan);
+  validateTaskPackage(completedPlan);
 
   const validFile = path.join(ROOT, ".template-source/evidence/.task-package-valid.json");
   writeFileSync(validFile, JSON.stringify(discovery));

package/template/scripts/verify-template-cache-scenarios

@@ -1,6 +1,6 @@
 #!/usr/bin/env node
 import assert from "node:assert/strict";
-import { mkdtempSync, readFileSync, rmSync, writeFileSync } from "node:fs";
+import { chmodSync, mkdirSync, mkdtempSync, readFileSync, readdirSync, rmSync, writeFileSync } from "node:fs";
 import { tmpdir } from "node:os";
 import path from "node:path";
 import { spawnSync } from "node:child_process";
@@ -40,6 +40,16 @@ try {
   assert.throws(() => acquireTemplateCommit({ repository: remote, commit, cacheRoot, allowLocal: true }), /缓存不完整/);
   assert.throws(() => acquireTemplateCommit({ repository: path.join(root, "offline"), commit, cacheRoot: path.join(root, "offline-cache"), allowLocal: true }), /执行失败|does not appear to be a git repository/);
   assert.throws(() => acquireTemplateCommit({ repository: remote, commit: "main", cacheRoot, allowLocal: true }), /40 位 commit/);
+  const realGit = spawnSync("which", ["git"], { encoding: "utf8" }).stdout.trim();
+  const bin = path.join(root, "bin"), timeoutCache = path.join(root, "timeout-cache"), previousPath = process.env.PATH;
+  mkdirSync(bin);
+  writeFileSync(path.join(bin, "git"), `#!/usr/bin/env node\nconst {spawnSync}=require('node:child_process');const args=process.argv.slice(2);if(args.includes('fetch'))setTimeout(()=>{},10000);else process.exit(spawnSync(${JSON.stringify(realGit)},args,{stdio:'inherit'}).status ?? 1);\n`);
+  chmodSync(path.join(bin, "git"), 0o755);
+  try {
+    process.env.PATH = bin + path.delimiter + previousPath;
+    assert.throws(() => acquireTemplateCommit({ repository: remote, commit, cacheRoot: timeoutCache, allowLocal: true, timeoutMs: 100 }), /timeout/);
+    assert.deepEqual(readdirSync(timeoutCache), [], "超时 fetch 不遗留临时缓存或伪成功条目");
+  } finally { process.env.PATH = previousPath; }
 } finally {
   rmSync(root, { recursive: true, force: true });
 }

package/template/scripts/verify-user-decision-scenarios

@@ -88,10 +88,10 @@ check("历史数字人记录可读但不能关闭关键门禁", () => {
   const f = fixture("approval"); Object.assign(record, { subject_ref: f.requirement.subject_ref, approval_scope: f.requirement.scope, user_decision_ref: f.ref }); validateApprovalRecord(record, { requireApproved: true });
 });
 check("等待期间可保存状态但不能流转依赖工作", () => {
-  const f = fixture("workflow", { boundary: "discovery-conclusion" }); const state = { user_decisions: [f.requirement] };
-  assert.equal(validateNextRoute("work-unit.discovery-requirements", "work-unit.spec-synthesis", state).result, "allowed");
-  f.record.responses = []; f.save(); assert.equal(validateNextRoute("work-unit.discovery-requirements", "work-unit.spec-synthesis", state).result, "blocked");
-  assert.equal(validateNextRoute("work-unit.discovery-opportunity", "work-unit.discovery-requirements", state).result, "allowed");
+  const f = fixture("workflow", { boundary: "plan-conclusion" }); const state = { user_decisions: [f.requirement] };
+  assert.equal(validateNextRoute("work-unit.plan-requirements", "work-unit.spec-synthesis", state).result, "blocked", "仅用户确认不能代替完整 Plan 入口审阅");
+  f.record.responses = []; f.save(); assert.equal(validateNextRoute("work-unit.plan-requirements", "work-unit.spec-synthesis", state).result, "blocked");
+  assert.equal(validateNextRoute("work-unit.plan-opportunity", "work-unit.plan-requirements", state).result, "allowed");
   assertCheckpointUserDecisions({ repository_mode: "project-instance", status: "paused-human-gate", human_review: { required_decisions: [f.requirement] } });
   assert.throws(() => assertCheckpointUserDecisions({ repository_mode: "project-instance", status: "running", human_review: { required_decisions: [f.requirement] } }), /user-decision-response-required/);
 });

package/template/skills-lock.json

@@ -21,7 +21,7 @@
       "revision": "c4d958f18cc947cb91cbe1bd48783fa4601cc18f"
     },
     "iloveZzz/yss-harness-design-agent": {
-      "revision": "8a67e0f5a56aa5085d18c2b42bb540c8f36c2fab"
+      "revision": "3a358684c5684ada433dca4fd97ee187050ca6d8"
     }
   },
   "skills": {
@@ -63,7 +63,7 @@
         "source": "mattpocock/skills",
         "sourceType": "github",
         "skillPath": "skills/engineering/code-review/SKILL.md",
-        "effectiveHash": "a9839b761443bcb9bf46b886630378e53dfb748ed77fc46b96e5777e701a438e",
+        "effectiveHash": "660ca39ab37b65099940b2e6a197089291e2fb74494ec93bbeb8e2fde6559465",
         "sourceRevision": "0ab1b63a410a03d3627979a109c8695de27af954",
         "upstreamHash": "12daafb9c4f77deb3c3303dc2e6f8a3c2a0ff7928fc004af959ba18b8bd38068",
         "adaptationRef": "docs/process/MATT-POCOCK-ENGINEERING-SKILLS.md",
@@ -99,7 +99,7 @@
         "source": "competitive-intelligence",
         "sourceType": "local",
         "skillPath": "sales/skills/competitive-intelligence/SKILL.md",
-        "effectiveHash": "d4b83600889b6045182232f0c11a9d6a563030b5f60faa4385a7886843ef0109",
+        "effectiveHash": "df1473dfd96b1a3ba63ef929917973b613988edf62193b5b82d734de2e8418cd",
         "targets": [
           ".agents/skills",
           ".claude/skills",
@@ -164,7 +164,7 @@
         "source": "mattpocock/skills",
         "sourceType": "github",
         "skillPath": "skills/engineering/domain-modeling/SKILL.md",
-        "effectiveHash": "02989ac6fd21562ba87af7a88b5d34f11661f86a3a42014e366613ecdb81bd81",
+        "effectiveHash": "7e691aeef60ee61c423f224acd3c4481a8764d3d336c8c49585b36d1a9bca9be",
         "sourceRevision": "0ab1b63a410a03d3627979a109c8695de27af954",
         "upstreamHash": "2bc3bb0a64ea9c6f5c3bcf78fc17f0fcdc7c062edc547ef006441de0b576d248",
         "adaptationRef": "docs/process/MATT-POCOCK-ENGINEERING-SKILLS.md",
@@ -304,7 +304,7 @@
         "source": "mattpocock/skills",
         "sourceType": "github",
         "skillPath": "skills/engineering/grill-with-docs/SKILL.md",
-        "effectiveHash": "c0f724b8cb4be22d10d8e8de3dfd49eb024cf131a3bcf5e7b89e109ad3d80b32",
+        "effectiveHash": "2006f65f386e79ff37c2c3294efe146e2e546845cf52e1571340dcb2a81a0df3",
         "sourceRevision": "0ab1b63a410a03d3627979a109c8695de27af954",
         "upstreamHash": "6b1292031c4f38a11309b9dad9be1141c1921c6edf86d1ae6da8b048fa71a349",
         "adaptationRef": "docs/process/MATT-POCOCK-ENGINEERING-SKILLS.md",
@@ -559,7 +559,7 @@
         "sourceType": "git-submodule",
         "skillPath": ".agents/skills/prototype-review/SKILL.md",
         "effectiveHash": "51021f119697dbff644d70c3d6ba3314147c47f412c6f56e4b5540ea3bf554a1",
-        "sourceRevision": "8a67e0f5a56aa5085d18c2b42bb540c8f36c2fab",
+        "sourceRevision": "3a358684c5684ada433dca4fd97ee187050ca6d8",
         "upstreamHash": "2e77b3093a758bb692fb3bda453c5c020d0523f875975e17e2731365f67432e1",
         "adaptationRef": "docs/agents/strategic-design-skills-integration.md",
         "targets": [
@@ -594,7 +594,7 @@
         "source": "mattpocock/skills",
         "sourceType": "github",
         "skillPath": "skills/engineering/setup-matt-pocock-skills/SKILL.md",
-        "effectiveHash": "c1463ecc928789308855e9995e9787cf311128a8567f8ed671b83d696a9b4cc9",
+        "effectiveHash": "1f63e63e8036a08ac6d0626b4dbbd16d8fbe1ae171cae31b36e82c606552396e",
         "sourceRevision": "0ab1b63a410a03d3627979a109c8695de27af954",
         "upstreamHash": "80cd6b5be4f67913f1b10f5acd97fccaeb6401682ae7ff3a971460cb73d86cbe",
         "adaptationRef": "docs/process/MATT-POCOCK-ENGINEERING-SKILLS.md",
@@ -824,7 +824,7 @@
         "sourceType": "git-submodule",
         "skillPath": ".agents/skills/yss-antd-design/SKILL.md",
         "effectiveHash": "917099caa9b76ca3cfd1d0f81f61b28111c1c54ed93e92891f81012dcd0662e2",
-        "sourceRevision": "8a67e0f5a56aa5085d18c2b42bb540c8f36c2fab",
+        "sourceRevision": "3a358684c5684ada433dca4fd97ee187050ca6d8",
         "upstreamHash": "08ce99d45586d5ea19e25fdd9e9a6ede16e66f18992b70b87e0cd23f92343b16",
         "adaptationRef": "docs/agents/strategic-design-skills-integration.md",
         "targets": [
@@ -842,7 +842,7 @@
         "sourceType": "git-submodule",
         "skillPath": ".agents/skills/yss-antdv-next-design/SKILL.md",
         "effectiveHash": "8c55e3a815ace34fbf591e931a58970b3d58cb657e00432ca6c72938d307563b",
-        "sourceRevision": "8a67e0f5a56aa5085d18c2b42bb540c8f36c2fab",
+        "sourceRevision": "3a358684c5684ada433dca4fd97ee187050ca6d8",
         "upstreamHash": "2942ed52dd58a38e51f09eb11254809334aeaed08f21cd081f09f35e6647a68c",
         "adaptationRef": "docs/agents/strategic-design-skills-integration.md",
         "targets": [
@@ -937,7 +937,7 @@
         "source": "project",
         "sourceType": "local",
         "skillPath": ".agents/skills/yss-ddd-scaffold-generator/SKILL.md",
-        "effectiveHash": "438b92a03e9e0c80ac68db65096fd499275ad16cb69d4d751571754a97aa38a8",
+        "effectiveHash": "ab1bd70b73a148d57a8e3f88e9a94be57b81f59bbfb81849e6e1dba16bfc7e16",
         "targets": [
           ".agents/skills",
           ".claude/skills",
@@ -953,7 +953,7 @@
         "sourceType": "git-submodule",
         "skillPath": ".agents/skills/yss-design-system/SKILL.md",
         "effectiveHash": "e69597b8b6a5ce4de5bd40f67630443b8176202f6b028b2ce146a2a1d062816f",
-        "sourceRevision": "8a67e0f5a56aa5085d18c2b42bb540c8f36c2fab",
+        "sourceRevision": "3a358684c5684ada433dca4fd97ee187050ca6d8",
         "upstreamHash": "90aaf06b2514353152464a4d032076fa9d5ef56272d8ad526f5544f3c22a2b00",
         "adaptationRef": "docs/agents/strategic-design-skills-integration.md",
         "targets": [
@@ -1078,7 +1078,7 @@
         "source": "project",
         "sourceType": "local",
         "skillPath": ".agents/skills/yss-frontend-scaffold-generator/SKILL.md",
-        "effectiveHash": "87bc0d2f0c279d3fff14ded7a07ba7b9f72a61080e7b9ca826bb452894877e4e",
+        "effectiveHash": "2f829e4e2a9cb42e123e8de37fe812bc65eef1308758e077b52f0698de9b68ab",
         "targets": [
           ".agents/skills",
           ".claude/skills",
@@ -1108,7 +1108,7 @@
         "source": "project",
         "sourceType": "local",
         "skillPath": ".agents/skills/yss-implementation-contract-compiler/SKILL.md",
-        "effectiveHash": "4f9ec75e4484bc2794ea057037890d2bcb96512c8c64bef9d9fdae7c66abe46d",
+        "effectiveHash": "96582c950a13f26a7c16b2087d0614cb28a99f0f805190fc64cfc80e6456c335",
         "targets": [
           ".agents/skills",
           ".claude/skills",
@@ -1123,7 +1123,7 @@
         "source": "project",
         "sourceType": "local",
         "skillPath": ".agents/skills/yss-layered-mvc-scaffold-generator/SKILL.md",
-        "effectiveHash": "360389486d6bd07949c0b11ab30e266fbf073169d8ee447d89581fe583228950",
+        "effectiveHash": "50d0f704326fc523c29f4b728c08148cde372c674b9e8686829bee3e74b66fdc",
         "targets": [
           ".agents/skills",
           ".claude/skills",
@@ -1183,7 +1183,7 @@
         "source": "project",
         "sourceType": "local",
         "skillPath": ".agents/skills/yss-mybatis/SKILL.md",
-        "effectiveHash": "1f70b00dcc6be6fde9c32ebf4ee41a86f2b348ca4bb789a3f2f32a7a24258ff4",
+        "effectiveHash": "8ab792d519c045a8a682942185f9aae3dcabfe86dbd8a4a9a444d7f657798701",
         "targets": [
           ".agents/skills",
           ".claude/skills",
@@ -1228,7 +1228,7 @@
         "source": "project",
         "sourceType": "local",
         "skillPath": ".agents/skills/yss-product-lifecycle/SKILL.md",
-        "effectiveHash": "c262bd69e978eee24b49526043b2439c30ce006f4fbbcb56e881c903ba6f3d51",
+        "effectiveHash": "a54a583c92621aede69e2f7db99f7373e0724b3187acd44c6d20c0144ca9943b",
         "targets": [
           ".agents/skills",
           ".claude/skills",
@@ -1244,7 +1244,7 @@
         "sourceType": "git-submodule",
         "skillPath": ".agents/skills/yss-prototype-stage/SKILL.md",
         "effectiveHash": "0ecf3125a73d15e4c9b6b665f92535180df82ccb2255fa863ec59f3ff5d460aa",
-        "sourceRevision": "8a67e0f5a56aa5085d18c2b42bb540c8f36c2fab",
+        "sourceRevision": "3a358684c5684ada433dca4fd97ee187050ca6d8",
         "upstreamHash": "e8f2f3a507da6bf7be0582e4a4dd9659381da8e291755070698a1f51a4e33808",
         "adaptationRef": "docs/agents/strategic-design-skills-integration.md",
         "targets": [
@@ -1261,7 +1261,7 @@
         "source": "project",
         "sourceType": "local",
         "skillPath": ".agents/skills/yss-repository/SKILL.md",
-        "effectiveHash": "19f4380ba81f6cf373b737a4b17316f35bf2be27646be38707d52cfd6c1c7aef",
+        "effectiveHash": "0abe4e8f4896613985074615281f11711b807fcfc5727a6e6d2e7d2ebcf7ddc7",
         "targets": [
           ".agents/skills",
           ".claude/skills",
@@ -1276,7 +1276,7 @@
         "source": "mattpocock/skills",
         "sourceType": "github",
         "skillPath": "skills/engineering/research/SKILL.md",
-        "effectiveHash": "a0c69c6cff59bdb6d36b03d24cceb29698e76cd6aae88919bf864284737c3aaa",
+        "effectiveHash": "0d8f94e6379ad56897a7821b4803a3ba72910e617aab730e47db719e6eb02807",
         "sourceRevision": "0ab1b63a410a03d3627979a109c8695de27af954",
         "upstreamHash": "75b7f9bbd7ccff6755a006f8b25d319a46ecbf6bd4b4c3323965ed9cb65e78ff",
         "adaptationRef": "docs/process/MATT-POCOCK-ENGINEERING-SKILLS.md",
@@ -1324,7 +1324,7 @@
         "source": "project",
         "sourceType": "local",
         "skillPath": ".agents/skills/yss-skill-source-index-refresh/SKILL.md",
-        "effectiveHash": "4c95ec664da1d3515ac49b80c063df20bf69d352c6892f66ceb29d0a12b55458",
+        "effectiveHash": "96ff974a0f7b3db8de09680daf9ecada94dd19f608341dcc85a32d40c02591b0",
         "targets": [
           ".agents/skills",
           ".claude/skills",
@@ -1339,9 +1339,9 @@
         "source": "iloveZzz/yss-harness-design-agent",
         "sourceType": "git-submodule",
         "skillPath": ".agents/skills/yss-stage-decision/SKILL.md",
-        "effectiveHash": "63e222ec2bc572c8d66fc52143ba3862650d243f57e1e9c71214b533eba37c23",
-        "sourceRevision": "8a67e0f5a56aa5085d18c2b42bb540c8f36c2fab",
-        "upstreamHash": "1eadf230f0e17bf6d209c1df1249acef3520ab29c26a80c476a2a557a224c10a",
+        "effectiveHash": "ad5180d162c6f9484aac556ed114e1447f93715d2d7e3c4bc1a53430adae65f1",
+        "sourceRevision": "3a358684c5684ada433dca4fd97ee187050ca6d8",
+        "upstreamHash": "2ec63f66aaf799d693cec0f0b5d71b8c4917e4e2822e0ddd519bc9b711fa3c95",
         "adaptationRef": "docs/agents/strategic-design-skills-integration.md",
         "targets": [
           ".agents/skills",