create-yss-spec 3.5.4 → 3.5.6

package/template/scripts/lib/lifecycle-status.mjs

@@ -6,6 +6,7 @@ import { readFileSync } from 'node:fs';
 import path from 'node:path';
 import { parseDocument } from '../vendor/yaml.mjs';
 import { safeTrackingPath, trackingDrift } from './stage-tracking.mjs';
+import { loadLifecyclePresenter } from './lifecycle-presentation.mjs';
 
 const sha = bytes => `sha256:${createHash('sha256').update(bytes).digest('hex')}`;
 function parse(bytes) {
@@ -52,7 +53,7 @@ export function lifecycleStatus({ root, checkpointRef, taskPackageRef }) {
   if (value.next_work_unit && !workUnit) issue('unknown-work-unit', `未知下一工作单元: ${value.next_work_unit}`, registryRef, '按注册表核对下一工作单元');
   if (workUnit && workUnit.id !== 'work-unit.entry-triage' && !contract.value.work_unit_routes?.[workUnit.id]) issue('missing-route', `缺少执行路由: ${workUnit.id}`, contractRef, '修复当前合同路由后重验');
   check('stage-and-route', diagnostics.some(x => ['unknown-stage', 'unknown-work-unit', 'missing-route'].includes(x.code)) ? 'failed' : 'passed', [registryRef, contractRef], '仅检查身份与路由存在，不计算完整 frontier');
-  if (value.context_reconciliation?.status === 'blocked') issue('context-blocked', 'Context reconciliation blocked', checkpointRef, '修复词汇对账并执行适用校验');
+  if (value.context_reconciliation?.status === 'blocked') issue('context-blocked', '术语对账受阻', checkpointRef, '修复词汇对账并执行适用校验');
   check('context-reconciliation', value.context_reconciliation?.status === 'blocked' ? 'failed' : 'not-checked', [value.context_reconciliation?.ref].filter(Boolean), '读取登记状态；当前对账内容和摘要仍须由原验证器核验');
   for (const [id, gate] of Object.entries(value.gates ?? {})) {
     if (['blocked', 'stale'].includes(gate?.status)) issue('gate-blocked', `${id}: ${gate.status}`, checkpointRef, '核对受影响依据和当前批准');
@@ -142,7 +143,21 @@ export function lifecycleStatus({ root, checkpointRef, taskPackageRef }) {
   }
   const implementationArtifact=value.artifacts?.['artifact.vertical-slice-ticket'];
   const implementationCoverage=setRef && implementationArtifact?.ref?.endsWith('.md')?summarizeBusinessImplementation({root,setRef,sliceRefs:[implementationArtifact.ref]}):null;
+  const presenter = loadLifecyclePresenter(root);
+  const statusNames = { routing: '正在确定下一步', running: '正在推进', blocked: '受阻', 'paused-human-gate': '等待会签', completed: '记录为已完成，仍需核验' };
+  const readable = text => presenter.text(text, {trace: false}).replace(/: (blocked|stale)$/, (_, status) => status === 'blocked' ? '：受阻' : '：依据已过期，需重新核验');
+  const presentation = {
+    read_only: true, execution_allowed: false, approval_validity: 'not-checked',
+    stage: value.stage ? presenter.label(value.stage, {trace: false}) : '未登记',
+    checkpoint_status: Object.hasOwn(statusNames, value.status) ? statusNames[value.status] : `未识别状态（${value.status ?? '未登记'}）`,
+    work_unit: value.next_work_unit ? presenter.label(value.next_work_unit, {trace: false}) : '未登记',
+    owner: presenter.text(owner, {trace: false}), blockers: blockers.map(readable),
+    expected_output: workUnit ? readable(workUnit.public_output ?? workUnit.output ?? '产出说明未登记') : null,
+    next_action: readable(next_action), sources: presenter.sources, warnings: presenter.warnings,
+    names: presenter.catalog({stage: value.stage, work_unit: value.next_work_unit, owner, gates: value.gates, artifacts: value.artifacts}),
+  };
   return {
+    presentation,
     decomposition: {business, implementation: {status:implementationArtifact?'recorded':'not-recorded',recorded_status:implementationArtifact?.status??null,ref:implementationArtifact?.ref??null,coverage:implementationCoverage}, readiness:{status:'not-evaluated',reason:'阶段工作完成不替代批准与实现就绪校验'}},
     schema_version: 1, read_only: true, stage: value.stage, checkpoint_status: value.status,
     work_unit: value.next_work_unit ?? null, owner, blockers, next_action,

package/template/scripts/lib/plan-stage-coverage.mjs

@@ -0,0 +1,40 @@
+import fs from 'node:fs';
+import { parseMarkdown } from '../vendor/markdown.mjs';
+import { plain } from './plan-spec-markdown.mjs';
+import { parseAsset, byteDigest } from './structured-assets.mjs';
+import { safeFile } from './governance-io.mjs';
+
+function tables(source) {
+  let heading='';const result=[];
+  for(const node of parseMarkdown(source).children) {
+    if(node.type==='heading')heading=plain(node);
+    if(node.type!=='table')continue;
+    const headers=node.children[0].children.map(plain);
+    for(const row of node.children.slice(1))result.push({heading,headers,cells:row.children.map(plain),line:row.position.start.line});
+  }
+  return result;
+}
+/** Coverage is deterministic; equivalence of rewritten business statements requires independent review. */
+export function planStageCoverage(root,{plan_ref,decisions_ref,package_ref,mapping_ref}) {
+  const bytes=ref=>fs.readFileSync(safeFile(root,ref));
+  const plan=bytes(plan_ref),decisions=bytes(decisions_ref),pkgBytes=bytes(package_ref),pkg=parseAsset(pkgBytes,package_ref);
+  const mapping=mapping_ref?parseAsset(bytes(mapping_ref),mapping_ref):{non_goals:[]};
+  const sourceBindings={plan:{ref:plan_ref,digest:byteDigest(plan)},decisions:{ref:decisions_ref,digest:byteDigest(decisions)}};
+  if(mapping_ref && (mapping.plan_digest!==sourceBindings.plan.digest||mapping.package_digest!==byteDigest(pkgBytes)))throw new Error('PLAN_COVERAGE_MAPPING_STALE');
+  const sourceDecisions=tables(decisions.toString()).filter(r=>/^D[0-9]+$/.test(r.cells[0])&&r.headers.includes('决定'));
+  const sourceNonGoals=tables(plan.toString()).filter(r=>r.headers.some(x=>/MVP.*非目标/.test(x))&&/^非目标/.test(r.cells[r.headers.findIndex(x=>/MVP.*非目标/.test(x))]||''));
+  if(!sourceDecisions.length||!sourceNonGoals.length)throw new Error('PLAN_COVERAGE_UNASSESSED: supported decision/non-goal tables were not found');
+  if(new Set(sourceDecisions.map(r=>r.cells[0])).size!==sourceDecisions.length)throw new Error('PLAN_COVERAGE_DUPLICATE_SOURCE_ID');
+  const rows=sourceDecisions.map(row=>{
+    const id=row.cells[0],targets=(pkg.confirmed_decisions||[]).filter(item=>new RegExp(`^decision\\.plan-${id.toLowerCase()}(?:-|$)`).test(item.id));
+    return {source_ref:decisions_ref,source_id:id,source_line:row.line,source_text:row.cells.join(' | '),targets:targets.map(x=>({id:x.id,statement:x.statement})),status:targets.length===1?'mapped':'missing-or-ambiguous',semantic_review:'required'};
+  });
+  const nonGoals=sourceNonGoals.map(row=>{
+    const sourceText=row.cells[0],entry=(mapping.non_goals||[]).find(x=>x.source_text===sourceText&&x.source_line===row.line);
+    const target=Number.isInteger(entry?.target_index)?pkg.non_goals?.[entry.target_index]:undefined;
+    return {source_ref:plan_ref,source_line:row.line,source_text:sourceText,target_index:entry?.target_index??null,target_text:target??null,status:typeof target==='string'&&target===entry.target_text?'mapped':'unmapped',semantic_review:'required'};
+  });
+  const known=new Set(sourceDecisions.map(r=>r.cells[0].toLowerCase()));
+  const undeclared=(pkg.confirmed_decisions||[]).filter(r=>/^decision\.plan-d\d+(?:-|$)/.test(r.id)&&!known.has(r.id.match(/^decision\.plan-(d\d+)/)[1])).map(r=>r.id);
+  return {schema_version:1,kind:'plan-stage-coverage',sources:sourceBindings,subject:{ref:package_ref,digest:byteDigest(pkgBytes)},...(mapping_ref?{mapping:{ref:mapping_ref,digest:byteDigest(bytes(mapping_ref))}}:{}),decisions:rows,non_goals:nonGoals,undeclared_decision_ids:undeclared,coverage_status:rows.every(r=>r.status==='mapped')&&nonGoals.every(r=>r.status==='mapped')&&!undeclared.length?'complete':'incomplete',semantic_review:'required',execution_authorization:'not-granted'};
+}

package/template/scripts/lib/reading-view-bundle.mjs

@@ -50,6 +50,7 @@ function build(root,checkpoint){
   for(const asset of assets){
    bindReferences(parseSliceYaml(bytes(root,asset.ref)));
    const view=viewContract(asset.ref,{root,kind:asset.kind});
+   bindReferences(view.presentation);
    diagnostics.push(...view.blockers.map(reason=>({ref:asset.ref,reason})));
    const name=asset.kind==='checkpoint'?'status':asset.kind;
    outputs[`${loc.directory}/${name}.review.md`]=view.markdown;

package/template/scripts/lib/reading-view-markdown.mjs

@@ -14,14 +14,15 @@ const scalar=value=>value===null?'null':String(value);
 function textLines(value,indent=''){
   return scalar(value).split(/\r?\n/).map((line,index)=>`${index?'\n'+indent+'> ':''}${escapeMarkdown(line)}`).join('');
 }
-export function renderReadingValue(value,depth=0){
-  if(value===null||typeof value!=='object')return textLines(value);
+export function renderReadingValue(value,depth=0,names={}){
+  const named=value=>typeof value==='string'&&Object.hasOwn(names,value)?`${names[value].name}（${value}）`:value;
+  if(value===null||typeof value!=='object')return textLines(named(value));
   const entries=Object.entries(value);
   if(!entries.length)return Array.isArray(value)?'[]（来源明确为空）':'{}（来源明确为空）';
   return entries.map(([key,child])=>{
-    if(Array.isArray(value)&&(child===null||typeof child!=='object'))return '- '+textLines(child).replace(/\n/g,'\n  ');
-    const label=Array.isArray(value)?`第 ${Number(key)+1} 项`:escapeMarkdown(readingLabels[key]||key);
-    const rendered=renderReadingValue(child,depth+1).split('\n');
+    if(Array.isArray(value)&&(child===null||typeof child!=='object'))return '- '+textLines(named(child)).replace(/\n/g,'\n  ');
+    const label=Array.isArray(value)?`第 ${Number(key)+1} 项`:escapeMarkdown(Object.hasOwn(readingLabels,key)?readingLabels[key]:named(key));
+    const rendered=renderReadingValue(child,depth+1,names).split('\n');
     return child!==null&&typeof child==='object'&&Object.keys(child).length?`- **${label}**：\n${rendered.map(line=>'  '+line).join('\n')}`:`- **${label}**：${rendered[0]}${rendered.slice(1).map(line=>'\n  '+line).join('')}`;
   }).join('\n');
 }
@@ -32,8 +33,9 @@ export function renderReadingMarkdown(view){
     '本页为来源快照；当前有效性需重新检查。批准有效性未核验；本视图不授予执行权限。',
     `检查范围：${view.checks.map(escapeMarkdown).join('；')}`];
   for(const [key,value]of Object.entries(view.content))if(value!==undefined){
-    lines.push(`## ${readingLabels[key]||escapeMarkdown(key)}`,key==='正文'&&typeof value==='string'?value:renderReadingValue(value));
+    lines.push(`## ${readingLabels[key]||escapeMarkdown(key)}`,key==='正文'&&typeof value==='string'?value:renderReadingValue(value,0,view.presentation?.names));
   }
+  if(view.presentation?.warnings.length)lines.push('## 名称来源提示',...view.presentation.warnings.map(escapeMarkdown));
   if(view.blockers.length)lines.push('## 阻断与未决检查',...view.blockers.map(item=>`- ${escapeMarkdown(item)}`));
   return lines.join('\n\n')+'\n';
 }

package/template/scripts/lib/stage-tracking-migration.mjs

@@ -1,4 +1,6 @@
 import {finalizeReading} from './reading-view-bundle.mjs';
+import {runAssetTransaction,assertAssetTransactionIdle,assertCurrentAssetReference} from './asset-transactions.mjs';
+import {parseAsset} from './structured-assets.mjs';
 import { existsSync, readFileSync, writeFileSync, mkdirSync, renameSync, unlinkSync, statSync, openSync, closeSync } from 'node:fs';
 import path from 'node:path';
 import { parseDocument, stringify } from '../vendor/yaml.mjs';
@@ -27,17 +29,20 @@ function definition(item, checkpointRef) {
   return `---\n${stringify(fields)}---\n# ${item.title}\n\n负责人：${item.owner}\n\n${item.scope}\n\n## 验收\n\n${item.acceptance.map(x => `- ${x}`).join('\n')}\n\n当前进度、依赖与完成证据以 ${checkpointRef} 中的 ${item.id} 为准。\n`;
 }
 export function checkTracking(root, checkpointRef) {
+  assertAssetTransactionIdle(root);assertCurrentAssetReference(root,checkpointRef);
   identity(root);
   const feature = featureFrom(checkpointRef);
   const config = trackerConfig(root);
   if (!existsSync(safeTrackingPath(root, checkpointRef))) return { status: 'missing-checkpoint', feature_id: feature, enabled: config.lifecycle_tracking_version === 1 };
-  const checkpoint = parseYaml(readTracking(root, checkpointRef));
+  const checkpoint = parseAsset(readTracking(root, checkpointRef),checkpointRef);
   try {
     const result = assertStageTracking(checkpoint, { root, checkpointRef });
     return { ...result, feature_id: checkpoint.feature_id || feature, enabled: config.lifecycle_tracking_version === 1, migration_required: !checkpoint.stage_tracking };
   } catch (error) { return { status: 'blocked', feature_id: feature, enabled: config.lifecycle_tracking_version === 1, error: error.message, migration_required: !checkpoint.stage_tracking }; }
 }
 export function planTracking(root, { checkpoint_ref, items = [], refresh = false } = {}) {
+  assertAssetTransactionIdle(root);assertCurrentAssetReference(root,checkpoint_ref);
+  if (!checkpoint_ref?.endsWith('.json')) throw new Error('ASSET_MIGRATION_REQUIRED: stage-tracking writes require an explicit JSON checkpoint');
   root = path.resolve(root); identity(root);
   const feature = featureFrom(checkpoint_ref);
   trackerConfig(root);
@@ -50,9 +55,10 @@ export function planTracking(root, { checkpoint_ref, items = [], refresh = false
   for (const ref of ['yss-project.yaml', 'CONTEXT.md', TRACKER_REF, '.template-spec/process/lifecycle-registry.yaml', '.template-spec/process/schemas/stage-tracking.schema.json', '.template-spec/process/harness-profile.yaml', checkpoint_ref]) watch(ref);
   const exists = observed[checkpoint_ref] !== null;
   let checkpoint;
-  if (exists) checkpoint = parseYaml(readTracking(root, checkpoint_ref));
+  if (exists) checkpoint = parseAsset(readTracking(root, checkpoint_ref), checkpoint_ref);
   else {
-    const template = '.template-spec/process/templates/lifecycle-checkpoint-template.yaml'; watch(template);
+    const preferred = '.template-spec/process/templates/lifecycle-checkpoint-template.json';
+    const template = existsSync(safeTrackingPath(root,preferred))?preferred:'.template-spec/process/templates/lifecycle-checkpoint-template.yaml'; watch(template);
     checkpoint = parseYaml(readTracking(root, template));
     checkpoint.feature_id = feature;
     checkpoint.mode = 'orchestrate'; checkpoint.status = 'running';
@@ -141,6 +147,7 @@ function applyTrackingSources(root, plan, { afterWrite } = {}) {
   const backups = plan.changes.map(c => ({ ref: c.ref, before: c.before, bytes: c.before ? readFileSync(safeTrackingPath(root, c.ref)).toString('base64') : null }));
   writeFileSync(path.join(transactionPath, 'backup.json'), json(backups), { flag: 'wx' });
   writeFileSync(path.join(transactionPath, 'plan.json'), json(plan), { flag: 'wx' });
+  return runAssetTransaction(root,plan.changes,()=>{
   const written = [], temporary = new Set();
   try {
     for (const [ref, before] of Object.entries(plan.observed)) if (JSON.stringify(descriptor(root, ref)) !== JSON.stringify(before)) throw new Error('tracking-concurrent-change');
@@ -175,6 +182,7 @@ function applyTrackingSources(root, plan, { afterWrite } = {}) {
     writeFileSync(path.join(transactionPath, 'failure.json'), json({ error: error.message, recovery_conflicts: conflicts }));
     throw new Error(`${error.message}; tracking-rollback-${conflicts.length ? `conflict:${conflicts.join(',')}` : 'complete'}`);
   }
+  });
 }
 
 // Finalize after the source transaction has committed; presentation failure never rolls it back.

package/template/scripts/lib/structured-assets.mjs

@@ -0,0 +1,81 @@
+import fs from 'node:fs';
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { createHash } from 'node:crypto';
+import { parseDocument, YAMLMap, YAMLSeq } from '../vendor/yaml.mjs';
+import { validateJsonSchema } from './json-schema.mjs';
+
+export const TOOL_ROOT = path.resolve(path.dirname(fileURLToPath(import.meta.url)), '../..');
+export const ASSET_KINDS = Object.freeze(['checkpoint', 'domain-strategy', 'stage-decision-package', 'task-package', 'approval-record']);
+export const byteDigest = bytes => `sha256:${createHash('sha256').update(bytes).digest('hex')}`;
+export const canonicalValue = value => Array.isArray(value) ? value.map(canonicalValue) : value && typeof value === 'object' ? Object.fromEntries(Object.keys(value).sort().map(key => [key, canonicalValue(value[key])])) : value;
+export const semanticDigest = value => byteDigest(JSON.stringify(canonicalValue(value)));
+export const serializeAsset = value => `${JSON.stringify(canonicalValue(value), null, 2)}\n`;
+const isMap = node => node instanceof YAMLMap;
+const isSeq = node => node instanceof YAMLSeq;
+const isScalar = node => node && Object.hasOwn(node, 'value');
+
+export function assetComments(bytes) {
+  const doc = parseDocument(String(bytes), { uniqueKeys: true }), result = [];
+  function visit(node, location) {
+    if (!node || typeof node !== 'object') return;
+    for (const key of ['comment', 'commentBefore']) if (node[key]) result.push({ location, text: node[key] });
+    if (node.contents) visit(node.contents, '<root>');
+    if (isMap(node)) for (const pair of node.items) { visit(pair.key, `${location}.${pair.key?.value}`); visit(pair.value, `${location}.${pair.key?.value}`); }
+    if (isSeq(node)) node.items.forEach((item, index) => visit(item, `${location}[${index}]`));
+  }
+  visit(doc, '<document>'); return result;
+}
+
+/** JSON syntax is strict; the YAML AST supplies duplicate-key and lossless-type checks. */
+export function parseAsset(bytes, file = 'asset.yaml') {
+  const source = Buffer.isBuffer(bytes) ? new TextDecoder('utf-8', { fatal: true }).decode(bytes) : String(bytes);
+  if (/\.json$/i.test(file)) JSON.parse(source);
+  const doc = parseDocument(source, { uniqueKeys: true, maxAliasCount: 0, intAsBigInt: true });
+  if (doc.errors.length || doc.warnings.length) throw new TypeError(`ASSET_PARSE: ${file}: ${(doc.errors[0] || doc.warnings[0]).message}`);
+  function visit(node) {
+    if (!node) return;
+    if (node.anchor || node.tag) throw new TypeError(`ASSET_TYPE: anchors/tags are unsupported: ${file}`);
+    if (isMap(node)) for (const pair of node.items) {
+      if (!isScalar(pair.key) || typeof pair.key.value !== 'string') throw new TypeError(`ASSET_TYPE: keys must be strings: ${file}`);
+      visit(pair.value);
+    }
+    else if (isSeq(node)) node.items.forEach(visit);
+    else if (isScalar(node)) {
+      if (typeof node.value === 'bigint') {
+        const number = Number(node.value);
+        if (!Number.isSafeInteger(number)) throw new TypeError(`ASSET_TYPE: unsafe integer: ${file}`);
+        node.value = number;
+      }
+      if (typeof node.value === 'number' && !Number.isFinite(node.value)) throw new TypeError(`ASSET_TYPE: non-finite number: ${file}`);
+      if (typeof node.value === 'number' && Number.isInteger(node.value) && !Number.isSafeInteger(node.value)) throw new TypeError(`ASSET_TYPE: unsafe integer: ${file}`);
+    } else throw new TypeError(`ASSET_TYPE: aliases are unsupported: ${file}`);
+  }
+  visit(doc.contents);
+  const value = doc.toJS({ maxAliasCount: 0 });
+  if (!value || typeof value !== 'object' || Array.isArray(value)) throw new TypeError(`ASSET_TYPE: root must be an object: ${file}`);
+  return value;
+}
+
+export function assetSchema(kind, value, root = TOOL_ROOT) {
+  if (!ASSET_KINDS.includes(kind)) throw new TypeError(`ASSET_KIND: ${kind}`);
+  if (['domain-strategy', 'stage-decision-package'].includes(kind)) {
+    if (![2, 3].includes(value.schema_version)) throw new TypeError('migration-required: unsupported strategy schema_version');
+    const authoring = path.join(root, `.agents/skills/yss-stage-decision/references/${kind}.schema.json`);
+    return fs.existsSync(authoring) ? authoring : path.join(root, `.template-spec/process/schemas/${kind}-reading.schema.json`);
+  }
+  const name = { checkpoint: 'lifecycle-checkpoint', 'task-package': 'digital-human-task-package', 'approval-record': value.kind === 'review-bundle' ? 'review-bundle' : 'approval-record' }[kind];
+  return path.join(root, `.template-spec/process/schemas/${name}.schema.json`);
+}
+
+export function validateAssetStructure(value, kind, { schemaRoot = TOOL_ROOT } = {}) {
+  const schemaPath = assetSchema(kind, value, schemaRoot);
+  validateJsonSchema(value, schemaPath, { cwd: schemaRoot });
+  return { kind, schema_version: value.schema_version, schema: path.relative(schemaRoot, schemaPath), semantic_digest: semanticDigest(value), execution_authorization: 'not-evaluated' };
+}
+
+export function readAsset(file, kind, options = {}) {
+  const bytes = fs.readFileSync(file), value = parseAsset(bytes, file);
+  validateAssetStructure(value, kind, options);
+  return { value, bytes, digest: byteDigest(bytes) };
+}

package/template/scripts/lib/task-package.mjs

@@ -1,4 +1,6 @@
 import { validateReadOnlyIntake } from './read-only-intake.mjs';
+import { parseAsset } from './structured-assets.mjs';
+import { assertAssetTransactionIdle } from './asset-transactions.mjs';
 import { assertTrackingEntry } from './stage-tracking.mjs';
 import { normalizeSliceContract } from './slice-contract.mjs';
 import { assertSliceV3TaskPackage } from './slice-task-package.mjs';
@@ -56,7 +58,7 @@ function assertReadableEvidenceRef(value, field) {
 export function loadTaskPackage(filePath) {
   const sourcePath = path.resolve(filePath);
   if (!existsSync(sourcePath)) fail(`任务包不存在: ${filePath}`);
-  const value = parseYaml(readFileSync(sourcePath, "utf8"), "任务包");
+  const value = parseAsset(readFileSync(sourcePath), sourcePath);
   if (!value || typeof value !== "object" || Array.isArray(value)) fail("任务包必须是对象");
   return { value, sourcePath };
 }
@@ -226,6 +228,7 @@ function validateTaskPackageInternal(value, { rolesDoc, lifecycleDoc, root = ROO
 }
 
 export function validateTaskPackage(value, options = {}) {
+  assertAssetTransactionIdle(ROOT);
   return validateTaskPackageInternal(value, {...options, history:false});
 }
 

package/template/scripts/lifecycle-status

@@ -3,17 +3,20 @@ import { parseArgs } from 'node:util';
 import path from 'node:path';
 import { checkProjectGovernance } from './lib/project-governance.mjs';
 import { lifecycleStatus } from './lib/lifecycle-status.mjs';
+import { renderLifecycleStatus } from './lib/lifecycle-presentation.mjs';
 
 try {
-  const { values } = parseArgs({ strict: true, options: { root: { type: 'string' }, checkpoint: { type: 'string' }, task: {type: 'string'}, preflight: {type:'boolean'}, help:{type:'boolean'} } });
-  if(values.help)process.stdout.write('用法: scripts/lifecycle-status --root <项目> [--checkpoint <根相对路径>] [--task <任务包>] [--preflight]\n普通查询不执行预检；--preflight 复验当前证据，仅提供恢复动作，不批准或派发。普通查询退出码保持 0/1；预检 0=通过、1=失败、2=输入或能力异常。\n');
+  const { values } = parseArgs({ strict: true, options: { root: { type: 'string' }, checkpoint: { type: 'string' }, task: {type: 'string'}, preflight: {type:'boolean'}, help:{type:'boolean'}, format: {type:'string', default:'json'} } });
+  if (!['json', 'text'].includes(values.format)) throw Error('--format 仅支持 json 或 text');
+  if (values.preflight && values.format === 'text') throw Error('--preflight 使用 JSON 诊断；中文状态阅读请单独调用 --format text');
+  if(values.help)process.stdout.write('用法: scripts/lifecycle-status --root <项目> [--checkpoint <根相对路径>] [--task <任务包>] [--preflight] [--format json|text]\n普通查询不执行预检；--preflight 复验当前证据，仅提供恢复动作，不批准或派发。普通查询退出码保持 0/1；预检 0=通过、1=失败、2=输入或能力异常。\n');
   else if(values.preflight) {
     if(!values.checkpoint&&!values.task)throw new Error('--preflight 必须指定 --checkpoint 或 --task');
     const {report,exitCode}=checkProjectGovernance({root:path.resolve(values.root??'.'),checkpointRef:values.checkpoint,taskRef:values.task,recovery:true});
     process.stdout.write(JSON.stringify(report,null,2)+'\n');process.exitCode=exitCode;
   } else {
   const result = lifecycleStatus({ root: path.resolve(values.root ?? '.'), checkpointRef: values.checkpoint, taskPackageRef: values.task });
-  process.stdout.write(`${JSON.stringify(result, null, 2)}\n`);
+  process.stdout.write(values.format === 'text' ? renderLifecycleStatus(result) : `${JSON.stringify(result, null, 2)}\n`);
   if (result.blockers.length) process.exitCode = 1;
   }
 } catch (error) {

package/template/scripts/verify-lifecycle-checkpoint

@@ -12,6 +12,8 @@ import { assertCheckpointApprovals, assertCheckpointUserDecisions } from "./lib/
 import { loadExecutionScope, assertScopeWorkUnit, verifyDeliveryTerminal } from './lib/lifecycle-execution-scope.mjs';
 import { assertPlanCheckpoint } from "./lib/plan-spec-entry.mjs";
 import { assertCheckpointBoundary } from './lib/checkpoint-boundary.mjs';
+import { parseAsset, validateAssetStructure } from './lib/structured-assets.mjs';
+import { assertCurrentAssetReference } from './lib/asset-transactions.mjs';
 
 const root = path.resolve(path.dirname(fileURLToPath(import.meta.url)), "..");
 const schemaPath = path.join(root, ".template-spec/process/schemas/lifecycle-checkpoint.schema.json");
@@ -37,11 +39,12 @@ try {
   else {
   if (positionals.length !== 1) throw new TypeError("用法: scripts/verify-lifecycle-checkpoint <checkpoint.yaml|checkpoint.json>");
   const sourcePath = path.resolve(positionals[0]);
-  const document = parseDocument(readFileSync(sourcePath, "utf8"), { maxAliasCount: 0, uniqueKeys: true });
-  if (document.errors.length) throw new TypeError(document.errors[0].message);
-  const value = document.toJS({ maxAliasCount: 0 });
-  const result = spawnSync("python3", ["-c", validator, schemaPath,values.history?'history':'current'], { cwd: root, encoding: "utf8", input: JSON.stringify(value) });
-  if (result.status !== 0) throw new TypeError(`${result.stdout}${result.stderr}`.trim());
+  if(!values.history)assertCurrentAssetReference(root,path.relative(root,sourcePath));
+  const value = parseAsset(readFileSync(sourcePath), sourcePath);
+  if (values.history) {
+    const result = spawnSync("python3", ["-c", validator, schemaPath,'history'], { cwd: root, encoding: "utf8", input: JSON.stringify(value) });
+    if (result.status !== 0) throw new TypeError(`${result.stdout}${result.stderr}`.trim());
+  } else validateAssetStructure(value, 'checkpoint');
   if(values.history) process.stdout.write('历史兼容结构检查完成；不证明当前批准或流转，execution_authorization=not-evaluated\n');
   else {
   assertCheckpointBoundary(value,{root});

package/template/skills-lock.json

@@ -18,7 +18,7 @@
       "revision": "c4d958f18cc947cb91cbe1bd48783fa4601cc18f"
     },
     "iloveZzz/yss-harness-design-agent": {
-      "revision": "d754260a597df6bc342f2411ccfd5bcf94a307e9"
+      "revision": "fbe4084276a8fe9a8f59e58481f2913133346eaf"
     },
     "ayghri/i-have-adhd": {
       "revision": "7b9069b39972e269e61bd95c2f66ebb90cac6a02"
@@ -392,7 +392,7 @@
         "sourceType": "git-submodule",
         "skillPath": ".agents/skills/prototype-review/SKILL.md",
         "effectiveHash": "e1b3c28881d315870d40c90d2d0dcfa9a4bb6b080744257e2ca57ed98d146c41",
-        "sourceRevision": "d754260a597df6bc342f2411ccfd5bcf94a307e9",
+        "sourceRevision": "fbe4084276a8fe9a8f59e58481f2913133346eaf",
         "upstreamHash": "9c0b042760f7d741487e62eaccf55b5079a1991e5489286560e278c9642a09b0",
         "adaptationRef": ".template-source/agents/strategic-design-skills-integration.md",
         "targets": [
@@ -644,7 +644,7 @@
         "sourceType": "git-submodule",
         "skillPath": ".agents/skills/yss-design-system/SKILL.md",
         "effectiveHash": "497f2ca2201be1c0f4faeb7a356d80e94885cb0752f3aa4dad01d10450b75773",
-        "sourceRevision": "d754260a597df6bc342f2411ccfd5bcf94a307e9",
+        "sourceRevision": "fbe4084276a8fe9a8f59e58481f2913133346eaf",
         "upstreamHash": "3884a6b9e0a836c2c783bbe51d7737fee874662ea1964a7df545c2f1ababf4e3",
         "adaptationRef": ".template-source/agents/strategic-design-skills-integration.md",
         "targets": [
@@ -753,6 +753,18 @@
           ".pi/skills"
         ]
       },
+      "yss-harness-upgrade": {
+        "source": "project",
+        "sourceType": "local",
+        "skillPath": ".agents/skills/yss-harness-upgrade/SKILL.md",
+        "effectiveHash": "1ca31a3a701cfd560116f6c3d355357b080889c58a9468d2bad39051a2545262",
+        "targets": [
+          ".agents/skills",
+          ".codex/skills",
+          ".cursor/skills",
+          ".pi/skills"
+        ]
+      },
       "yss-hook": {
         "source": "project",
         "sourceType": "local",
@@ -769,7 +781,7 @@
         "source": "project",
         "sourceType": "local",
         "skillPath": ".agents/skills/yss-implementation-contract-compiler/SKILL.md",
-        "effectiveHash": "c957b2230c8db7d1724cf1c592d9d4661e561eabefd8a4a612bdc903b1ad377f",
+        "effectiveHash": "ef7778cad116b9bc1a59290ad99cdacc9ddc85c26ff608d5e9db3ca0451adfc2",
         "targets": [
           ".agents/skills",
           ".codex/skills",
@@ -829,7 +841,7 @@
         "source": "project",
         "sourceType": "local",
         "skillPath": ".agents/skills/yss-product-lifecycle/SKILL.md",
-        "effectiveHash": "3b53105bc8e5ab7c49e3482ba1a4cad8e344512e560424bd2c66ca334bed4414",
+        "effectiveHash": "19fc768b7e60c7efdbdca3ffb2494a3067eac1c1c93c0cb5a2df4022b9d27be0",
         "targets": [
           ".agents/skills",
           ".codex/skills",
@@ -842,7 +854,7 @@
         "sourceType": "git-submodule",
         "skillPath": ".agents/skills/yss-prototype-stage/SKILL.md",
         "effectiveHash": "c88b1b84ae99ba90cd9bca8b3c6b9c258d0dd41968689910556695b8729c51a4",
-        "sourceRevision": "d754260a597df6bc342f2411ccfd5bcf94a307e9",
+        "sourceRevision": "fbe4084276a8fe9a8f59e58481f2913133346eaf",
         "upstreamHash": "0e82e8c0f6b5446dbe48aec8df092574ab895be303efe33d8fc8457bce98d02e",
         "adaptationRef": ".template-source/agents/strategic-design-skills-integration.md",
         "targets": [
@@ -919,9 +931,9 @@
         "source": "iloveZzz/yss-harness-design-agent",
         "sourceType": "git-submodule",
         "skillPath": ".agents/skills/yss-stage-decision/SKILL.md",
-        "effectiveHash": "cc741295a158d3166e9b0ef351538c50f2921f52d808da31782c401b6d7d873a",
-        "sourceRevision": "d754260a597df6bc342f2411ccfd5bcf94a307e9",
-        "upstreamHash": "9e06107a37c2251b454bde7e258f2e462ba5fe766f9fabe9e7f76419b60f5c98",
+        "effectiveHash": "fa738fba485549181534419336eb266506d282b2cb8cf720c3375f62b5d70444",
+        "sourceRevision": "fbe4084276a8fe9a8f59e58481f2913133346eaf",
+        "upstreamHash": "77fa3075f90966821881998ff5fa9d674672bd2568e70b8d877402efeb360453",
         "adaptationRef": ".template-source/agents/strategic-design-skills-integration.md",
         "targets": [
           ".agents/skills",

package/template.manifest.json

@@ -95,7 +95,8 @@
     "scripts/lib/template-verification-runner.mjs",
     "scripts/lib/verification-selection.mjs",
     "scripts/lib/verification-report.mjs",
-    "scripts/lib/maintenance-counterexample.mjs"
+    "scripts/lib/maintenance-counterexample.mjs",
+    "scripts/sync-harness-upgrade"
   ],
   "excludePathSuffixes": [
     "-scenarios"

package/template.snapshot.json

@@ -3,10 +3,10 @@
   "templateName": "yss-spec-project-template",
   "templateSource": "github:iloveZzz/yss-spec-project-template",
   "templateRepository": "https://github.com/iloveZzz/yss-spec-project-template.git",
-  "requestedRef": "8cc9764ca3d69069dc4fba3765c6c3c038d317a8",
-  "templateCommit": "8cc9764ca3d69069dc4fba3765c6c3c038d317a8",
+  "requestedRef": "dd58fc3929b3958579ac8a426f06f087682f2f6c",
+  "templateCommit": "dd58fc3929b3958579ac8a426f06f087682f2f6c",
   "sourceState": "committed",
-  "manifestHash": "b8e3fc9b7eecd3155ec4515afb151d344191410a8b3f18305f107a54ce1b337a",
+  "manifestHash": "544e8ae01c49ef451a784237b06772137876f8e8d6b5334094827e2ca2fe0f13",
   "encodedPaths": {
     ".agents/skills/yss-frontend-scaffold-generator/assets/data-quality-v1/.gitignore": ".agents/skills/yss-frontend-scaffold-generator/assets/data-quality-v1/__yss_dotfile__.gitignore",
     ".codex/skills/product-design/.npmignore": ".codex/skills/product-design/__yss_dotfile__.npmignore",
@@ -16,6 +16,6 @@
     ".gitignore": "__yss_dotfile__.gitignore",
     ".pi/skills/yss-frontend-scaffold-generator/assets/data-quality-v1/.gitignore": ".pi/skills/yss-frontend-scaffold-generator/assets/data-quality-v1/__yss_dotfile__.gitignore"
   },
-  "snapshotHash": "c055086fadfc1a00c0770b5d6f0a49fea5b9f268175beb3ab6ba86440474b86f",
-  "generatedAt": "2026-10-01T01:02:49.512Z"
+  "snapshotHash": "e97773b2461a3bb7a35551a1f97371af689b94f281bbdb7a635e687d5239b405",
+  "generatedAt": "2026-10-01T15:17:35.092Z"
 }