create-yss-spec 3.0.0 → 3.0.1

package/template/.hermes/skills/archify/test/proof-aperture.test.mjs

@@ -1,78 +0,0 @@
-import { test } from 'node:test';
-import assert from 'node:assert/strict';
-import fs from 'node:fs';
-import path from 'node:path';
-import { fileURLToPath } from 'node:url';
-
-const __dirname = path.dirname(fileURLToPath(import.meta.url));
-const landing = fs.readFileSync(path.resolve(__dirname, '..', '..', 'docs', 'index.html'), 'utf8');
-
-function cssRule(selector) {
-  const escaped = selector.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
-  const match = landing.match(new RegExp(`${escaped}\\s*\\{([^}]+)\\}`));
-  assert.ok(match, `${selector}: CSS rule missing`);
-  return match[1];
-}
-
-test('landing declares a truthful first-fold proof aperture in document order', () => {
-  assert.match(landing, /<section class="hero" data-proof-aperture="first-fold">/);
-  const heroStart = landing.indexOf('data-proof-aperture="first-fold"');
-  const headline = landing.indexOf('data-i18n="hero-h1"', heroStart);
-  const actions = landing.indexOf('class="hero-actions', headline);
-  const proof = landing.indexOf('id="hero-proof-stage"', actions);
-  assert.ok(heroStart < headline && headline < actions && actions < proof);
-});
-
-test('desktop hero budget exposes live diagram content without shrinking its canvas', () => {
-  assert.match(cssRule('.hero'), /padding-top:9rem/);
-  assert.match(cssRule('.hero-bento'), /grid-template-columns:repeat\(12,1fr\)/);
-  assert.match(cssRule('.hero-intro'), /grid-column:1 \/ 8/);
-  assert.match(cssRule('.proof-main'), /grid-column:8 \/ 13/);
-  assert.match(cssRule('.proof-main'), /grid-row:1 \/ 3/);
-  assert.match(cssRule('.hero-actions .btn'), /min-height:44px/);
-  assert.match(cssRule('.proof-viewport'), /min-height:430px/);
-});
-
-test('narrow viewport preserves a contained fallback without adding a mobile product surface', () => {
-  const mobile = landing.match(/@media\(max-width:640px\)\s*\{([\s\S]+?)\n\s*\}\n\s*<\/style>/)?.[1];
-  assert.ok(mobile, 'narrow mobile media query missing');
-  assert.match(mobile, /\.hero\s*\{\s*padding-top:6\.75rem;\s*\}/);
-  assert.match(mobile, /\.hero-actions \.btn\s*\{\s*flex:1;\s*justify-content:center;\s*\}/);
-  assert.match(mobile, /\.proof-viewport\s*\{\s*min-height:360px;\s*\}/);
-  assert.match(mobile, /\.proof-rail\s*\{\s*grid-template-columns:1fr;\s*\}/);
-});
-
-test('proof aperture remains one real eager sandboxed artifact with explicit user-selected identities', () => {
-  assert.equal((landing.match(/<iframe id="hero-proof-frame"/g) || []).length, 1);
-  assert.match(landing, /loading="eager"/);
-  assert.match(landing, /sandbox="allow-scripts"/);
-  assert.doesNotMatch(landing, /sandbox="[^"]*allow-same-origin/);
-  assert.equal((landing.match(/class="spec-card"/g) || []).length, 3);
-  assert.match(landing, /data-proof-playback="first-fold-once"/);
-  assert.match(landing, /\?embed=1&amp;play=1&amp;theme=dark#view=happy-path/);
-  assert.doesNotMatch(landing, /setInterval\(|scrollIntoView\(|scroll-triggered|proof-carousel/);
-});
-
-test('initial proof playback uses one sandboxed load without parent-frame reach-through', () => {
-  assert.match(landing, /src="gallery\/artifacts\/agent-tool-call\.workflow\.html\?embed=1&amp;play=1&amp;theme=dark#view=happy-path"/);
-  assert.doesNotMatch(landing, /initialProof|proofFrameDocumentIsReady|proofFrame\.contentWindow|proofFrame\.contentDocument/);
-  assert.match(landing, /proofFrame\.addEventListener\('load', \(\) => \{/);
-  assert.match(landing, /proofStage\.classList\.remove\('is-loading'\)/);
-});
-
-test('proof playback delegates reduced motion to the artifact and keeps deliberate-choice boundaries', () => {
-  assert.match(landing, /renderProof\(tab\.dataset\.proof, \{ deliberate: true \}\)/);
-  assert.match(landing, /renderProof\(tabs\[next\]\.dataset\.proof, \{ focus: true, deliberate: true \}\)/);
-  assert.match(landing, /proofEmbedUrl\(proof, \{ play: deliberate \}\)/);
-  assert.match(landing, /document\.querySelectorAll\('\.fade-up'\)\.forEach\(el => el\.classList\.add\('visible'\)\)/);
-  assert.doesNotMatch(landing, /addEventListener\('scroll'/);
-});
-
-test('aperture uses normal flow and preserves reduced-motion boundaries', () => {
-  const hero = cssRule('.hero');
-  const proof = cssRule('.proof-main');
-  assert.doesNotMatch(hero + proof, /position:absolute|transform:|top:-|margin-top:-|height:100vh/);
-  assert.match(landing, /@media\s*\(prefers-reduced-motion:\s*reduce\)/);
-  assert.match(landing, /\.fade-up\s*\{\s*opacity:1!important;\s*transform:none!important;/);
-  assert.match(landing, /\.pulse-dot,\.proof-live::before\s*\{\s*animation:none!important;\s*\}/);
-});

package/template/.hermes/skills/archify/test/reach-share-card.test.mjs

@@ -1,149 +0,0 @@
-import { test } from 'node:test';
-import assert from 'node:assert/strict';
-import { execFileSync } from 'node:child_process';
-import fs from 'node:fs';
-import os from 'node:os';
-import path from 'node:path';
-import { fileURLToPath } from 'node:url';
-
-const __dirname = path.dirname(fileURLToPath(import.meta.url));
-const skillRoot = path.resolve(__dirname, '..');
-const repoRoot = path.resolve(skillRoot, '..');
-const tmp = fs.mkdtempSync(path.join(os.tmpdir(), 'archify-reach-share-card-'));
-
-const CASES = {
-  architecture: 'web-app.architecture.json',
-  workflow: 'agent-tool-call.workflow.json',
-  sequence: 'cache-miss-request.sequence.json',
-  dataflow: 'product-analytics.dataflow.json',
-  lifecycle: 'agent-run.lifecycle.json',
-};
-
-function render(mode, example) {
-  const output = path.join(tmp, `${mode}.html`);
-  execFileSync(process.execPath, [
-    path.join(skillRoot, `renderers/${mode}/render-${mode}.mjs`),
-    path.join(skillRoot, 'examples', example),
-    output,
-  ]);
-  return fs.readFileSync(output, 'utf8');
-}
-
-function canonicalSvg(html) {
-  return html.match(/<svg\b[\s\S]*?<\/svg>/)?.[0] || '';
-}
-
-test('all five renderers inherit one active-reach-only Reach Share Card item', () => {
-  for (const [mode, example] of Object.entries(CASES)) {
-    const html = render(mode, example);
-    assert.match(html, /data-action="reach-share-card"[^>]*hidden disabled[^>]*>[\s\S]*?Reach Share Card[\s\S]*?1200(?:&times;|×)630 PNG/, mode);
-    assert.match(html, /function syncReachShareItem\(\)/, mode);
-    assert.match(html, /reachShareItem\.hidden = !snapshot;/, mode);
-    assert.match(html, /reachShareItem\.disabled = !snapshot;/, mode);
-    assert.match(html, /function open\(focusLast\)[\s\S]*?syncReachShareItem\(\);/, mode);
-    assert.doesNotMatch(html, /id="reach-share-card"|class="reach-share-card"/, mode);
-    assert.doesNotMatch(canonicalSvg(html), /data-share-reach(?:-|=)/, mode);
-  }
-});
-
-test('Reach Share Card snapshots copy the active authored closure without rerunning traversal', () => {
-  const html = render('architecture', CASES.architecture);
-  const start = html.indexOf('function reachabilitySnapshot() {');
-  const end = html.indexOf('\n      function setPassportValue', start);
-  const snapshotBlock = start >= 0 && end > start ? html.slice(start, end) : '';
-
-  assert.match(snapshotBlock, /activeReachability\.nodeIds\.slice\(\)/);
-  assert.match(snapshotBlock, /activeReachability\.edgeKeys\.slice\(\)/);
-  assert.match(snapshotBlock, /activeReachability\.depths/);
-  assert.match(snapshotBlock, /direction: reachabilityMode/);
-  assert.match(snapshotBlock, /origin: \{ id: originId, label:/);
-  assert.match(snapshotBlock, /maxDepth: activeReachability\.maxDepth/);
-  assert.match(snapshotBlock, /seenNodeIds = Object\.create\(null\)/);
-  assert.match(snapshotBlock, /seenEdgeKeys = Object\.create\(null\)/);
-  assert.match(snapshotBlock, /drawableFragments = fragments\.filter\(hasDrawableGeometry\)/);
-  assert.match(snapshotBlock, /drawableFragments\.length !== 1/);
-  assert.match(snapshotBlock, /return null/);
-  assert.doesNotMatch(snapshotBlock, /computeReachability|reachabilityFor|queue\s*=|shortestDirectedPath/);
-  assert.match(html, /reachabilitySnapshot: reachabilitySnapshot/);
-});
-
-test('Reach variant decorates only a finite canonical clone with static authored identity', () => {
-  const html = render('workflow', CASES.workflow);
-  const start = html.indexOf('function applyReachSnapshot(clone, snapshot) {');
-  const end = html.indexOf('\n      function serializeSvg', start);
-  const applyBlock = start >= 0 && end > start ? html.slice(start, end) : '';
-
-  assert.match(applyBlock, /snapshot\.direction !== 'upstream'/);
-  assert.match(applyBlock, /snapshot\.direction !== 'downstream'/);
-  assert.match(applyBlock, /snapshot\.nodeIds\.length < 2/);
-  assert.match(applyBlock, /snapshot\.origin\.label\.trim\(\)/);
-  assert.match(applyBlock, /nodeId === snapshot\.origin\.id \? depth !== 0 : depth < 1/);
-  assert.match(applyBlock, /edge\.depth !== Math\.max\(snapshot\.depths\[edge\.from\], snapshot\.depths\[edge\.to\]\)/);
-  assert.match(applyBlock, /matchedNodes\.length !== 1/);
-  assert.match(applyBlock, /drawableMatches\.length !== 1/);
-  assert.match(applyBlock, /data-share-reach-match/);
-  assert.match(applyBlock, /data-share-reach-origin/);
-  assert.match(applyBlock, /data-share-reach-depth/);
-  assert.match(applyBlock, /clone\.setAttribute\('data-share-reach', snapshot\.direction\)/);
-  assert.doesNotMatch(applyBlock, /setAttribute\('data-reach-(?:active|match|origin|depth)/);
-  assert.doesNotMatch(applyBlock, /animation:|setTimeout|requestAnimationFrame/);
-  assert.match(html, /canonicalStateClean && finiteSvgDimensions && !opts\.routeSnapshot && applyReachSnapshot\(clone, opts\.reachSnapshot\)/);
-  assert.ok(html.indexOf('var canonicalStateClean =') < html.indexOf('applyReachSnapshot(clone, opts.reachSnapshot)'), 'canonical cleanup must precede reach decoration');
-});
-
-test('Reach styling preserves context, direction, and Blueprint restraint without motion', () => {
-  const html = render('dataflow', CASES.dataflow);
-  assert.match(html, /svg\[data-share-reach\] \[data-node-id\], svg\[data-share-reach\] \[data-edge-from\] \{ opacity: 0\.14; \}/);
-  assert.match(html, /svg\[data-share-reach\] \[data-share-reach-match\] \{ opacity: 1; \}/);
-  assert.match(html, /data-share-reach=\\?"upstream\\?"[\s\S]*?--database-stroke/);
-  assert.match(html, /data-share-reach=\\?"downstream\\?"[\s\S]*?--backend-stroke/);
-  assert.match(html, /data-preset=\\?"blueprint\\?"\]\[data-share-reach\][\s\S]*?filter: none/);
-  const reachStyleBlock = html.match(/if \(opts\.reachSnapshot\) \{[\s\S]*?\n        \}/)?.[0] || '';
-  assert.doesNotMatch(reachStyleBlock, /animation:|display:\s*none|transform:/);
-});
-
-test('Reach Share Card reuses the 1200x630 seam and publishes a truthful scoped receipt', () => {
-  const html = render('architecture', CASES.architecture);
-  assert.match(html, /options\.variant !== 'route' && options\.variant !== 'reach'/);
-  assert.match(html, /Archify\.focus\.reachabilitySnapshot\(\)/);
-  assert.match(html, /renderShareCard\(\{ reachSnapshot: snapshot \}\)/);
-  assert.doesNotMatch(html, /function rasterizeReachShareCard|reachShareCard:/);
-  assert.match(html, /viewerText\('viewer\.export\.card\.reachSummary'/);
-  assert.match(html, /direction: directionLabel/);
-  assert.match(html, /origin: reachSnapshot\.origin\.label/);
-  assert.match(html, /reachSnapshot\.nodeIds\.length - 1/);
-  assert.match(html, /reachSnapshot\.edges\.length/);
-  assert.match(html, /reachSnapshot\.maxDepth/);
-  assert.match(html, /recordExportReceipt\('share-card', blob, false, \{ width: SHARE_CARD_WIDTH, height: SHARE_CARD_HEIGHT \}, 'reach', false, true\)/);
-  assert.match(html, /'-' \+ snapshot\.direction \+ '-reach-share-card\.png'/);
-  assert.match(html, /data-last-export-reach-state-clean/);
-  assert.match(html, /Trace authored reach before exporting a Reach Share Card/);
-  assert.match(html, /downloadReachShareCard: runReachShareCard/);
-});
-
-test('Skill, product docs, and READMEs keep the optional truthful boundary explicit', () => {
-  const viewer = fs.readFileSync(path.join(skillRoot, 'references', 'viewer-runtime.md'), 'utf8');
-  assert.match(viewer, /Export → Reach Share Card/);
-  assert.match(viewer, /variant=reach/);
-  assert.match(viewer, /data-share-reach-\*/);
-  assert.match(viewer, /authored reachability/i);
-  assert.match(viewer, /download-only/i);
-
-  for (const readme of ['README.md', 'README_EN.md', 'README_ZH.md']) {
-    const text = fs.readFileSync(path.join(repoRoot, readme), 'utf8');
-    assert.match(text, /Reach Share Card/, readme);
-    assert.match(text, /docs\/assets\/mco-runtime-reach-share-card\.png/, readme);
-  }
-  const png = fs.readFileSync(path.join(repoRoot, 'docs/assets/mco-runtime-reach-share-card.png'));
-  assert.equal(png.subarray(0, 8).toString('hex'), '89504e470d0a1a0a');
-  assert.equal(png.readUInt32BE(16), 1200);
-  assert.equal(png.readUInt32BE(20), 630);
-
-  const product = fs.readFileSync(path.join(repoRoot, 'PRODUCT.md'), 'utf8');
-  const design = fs.readFileSync(path.join(repoRoot, 'DESIGN.md'), 'utf8');
-  assert.match(product, /Reach Share Card/);
-  assert.match(design, /Reach Share Card/);
-  assert.match(design, /not (?:runtime )?(?:impact|causality|breakage)/i);
-});
-
-process.on('exit', () => fs.rmSync(tmp, { recursive: true, force: true }));

package/template/.hermes/skills/archify/test/readme-showcase.test.mjs

@@ -1,318 +0,0 @@
-import { test } from 'node:test';
-import assert from 'node:assert/strict';
-import { execFileSync } from 'node:child_process';
-import crypto from 'node:crypto';
-import fs from 'node:fs';
-import os from 'node:os';
-import path from 'node:path';
-import { fileURLToPath } from 'node:url';
-
-const __dirname = path.dirname(fileURLToPath(import.meta.url));
-const skillRoot = path.resolve(__dirname, '..');
-const repoRoot = path.resolve(skillRoot, '..');
-const assetPath = path.join(repoRoot, 'docs', 'assets', 'archify-live-proof.gif');
-const receiptPath = path.join(repoRoot, 'docs', 'assets', 'archify-live-proof.json');
-
-function sha256(file) {
-  return crypto.createHash('sha256').update(fs.readFileSync(file)).digest('hex');
-}
-
-function git(cwd, ...args) {
-  return execFileSync('git', args, { cwd, encoding: 'utf8' }).trim();
-}
-
-function writeStarHistoryCharts(cwd, version) {
-  const assets = path.join(cwd, 'assets');
-  fs.mkdirSync(assets, { recursive: true });
-  fs.writeFileSync(path.join(assets, 'star-history-light.svg'), `<svg><title>light ${version}</title></svg>\n`);
-  fs.writeFileSync(path.join(assets, 'star-history-dark.svg'), `<svg><title>dark ${version}</title></svg>\n`);
-}
-
-function skipSubBlocks(buffer, start) {
-  let offset = start;
-  while (offset < buffer.length) {
-    const size = buffer[offset];
-    offset += 1;
-    if (size === 0) return offset;
-    offset += size;
-  }
-  throw new Error('GIF sub-block runs past end of file');
-}
-
-function inspectGif(buffer) {
-  assert.match(buffer.subarray(0, 6).toString('ascii'), /^GIF8[79]a$/);
-  const width = buffer.readUInt16LE(6);
-  const height = buffer.readUInt16LE(8);
-  const packed = buffer[10];
-  let offset = 13;
-  if (packed & 0x80) offset += 3 * (2 ** ((packed & 0x07) + 1));
-  let frameCount = 0;
-  let durationCentiseconds = 0;
-  let trailer = false;
-
-  while (offset < buffer.length) {
-    const marker = buffer[offset];
-    offset += 1;
-    if (marker === 0x3b) {
-      trailer = true;
-      break;
-    }
-    if (marker === 0x21) {
-      const label = buffer[offset];
-      offset += 1;
-      if (label === 0xf9) {
-        const blockSize = buffer[offset];
-        offset += 1;
-        assert.equal(blockSize, 4, 'unexpected graphic-control block size');
-        durationCentiseconds += buffer.readUInt16LE(offset + 1);
-        offset += blockSize;
-        assert.equal(buffer[offset], 0, 'graphic-control block missing terminator');
-        offset += 1;
-      } else {
-        offset = skipSubBlocks(buffer, offset);
-      }
-      continue;
-    }
-    if (marker === 0x2c) {
-      frameCount += 1;
-      const localPacked = buffer[offset + 8];
-      offset += 9;
-      if (localPacked & 0x80) offset += 3 * (2 ** ((localPacked & 0x07) + 1));
-      offset += 1;
-      offset = skipSubBlocks(buffer, offset);
-      continue;
-    }
-    throw new Error(`unexpected GIF marker 0x${marker.toString(16)} at ${offset - 1}`);
-  }
-  assert.equal(trailer, true, 'GIF trailer missing');
-  return { width, height, frameCount, durationSeconds: durationCentiseconds / 100 };
-}
-
-test('README motion proof is compact, looping, and backed by current gallery artifacts', () => {
-  const builder = fs.readFileSync(path.join(repoRoot, 'scripts', 'build-readme-showcase.mjs'), 'utf8');
-  assert.match(builder, /\?embed=1&play=1&theme=dark#view=/);
-  const buffer = fs.readFileSync(assetPath);
-  const receipt = JSON.parse(fs.readFileSync(receiptPath, 'utf8'));
-  const inspected = inspectGif(buffer);
-
-  assert.deepEqual(inspected, { width: 960, height: 540, frameCount: 54, durationSeconds: 5.4 });
-  assert.ok(buffer.includes(Buffer.from('NETSCAPE2.0')), 'GIF must loop continuously');
-  assert.ok(buffer.byteLength <= 3 * 1024 * 1024, `README GIF is too large: ${buffer.byteLength} bytes`);
-  assert.equal(receipt.schemaVersion, 1);
-  assert.equal(receipt.generator, 'scripts/build-readme-showcase.mjs');
-  assert.equal(receipt.output, 'docs/assets/archify-live-proof.gif');
-  assert.equal(receipt.width, inspected.width);
-  assert.equal(receipt.height, inspected.height);
-  assert.equal(receipt.frameCount, inspected.frameCount);
-  assert.equal(receipt.durationSeconds, inspected.durationSeconds);
-  assert.equal(receipt.bytes, buffer.byteLength);
-  assert.equal(receipt.sha256, sha256(assetPath));
-  assert.deepEqual(receipt.scenes.map(scene => scene.id), ['signal-flow', 'blueprint', 'classic']);
-  for (const scene of receipt.scenes) {
-    const artifact = path.join(repoRoot, scene.artifact);
-    assert.ok(fs.existsSync(artifact), `${scene.id}: source artifact missing`);
-    assert.equal(scene.artifactSha256, sha256(artifact), `${scene.id}: source artifact drift; rebuild README showcase`);
-    assert.match(scene.receipt, /9\/9 checks/);
-  }
-});
-
-test('all README languages keep the product hero and retain the verified animated proof', () => {
-  for (const filename of ['README.md', 'README_EN.md', 'README_ZH.md']) {
-    const readme = fs.readFileSync(path.join(repoRoot, filename), 'utf8');
-    const heroIndex = readme.indexOf('docs/assets/archify-readme-hero.png');
-    const titleIndex = readme.indexOf('# Archify');
-    const proofIndex = readme.indexOf('docs/assets/archify-live-proof.gif');
-    const demosIndex = Math.max(readme.indexOf('## See Archify in action'), readme.indexOf('## 看看 Archify 能做什么'));
-    assert.ok(heroIndex >= 0 && heroIndex < titleIndex, `${filename}: product hero is not above the title`);
-    assert.ok(proofIndex > demosIndex, `${filename}: animated proof must live in the demo section`);
-    assert.match(readme, /docs\/assets\/archify-live-proof\.gif/);
-    assert.match(readme, /https:\/\/tt-a1i\.github\.io\/archify\/gallery\.html/);
-  }
-  assert.equal(
-    fs.readFileSync(path.join(repoRoot, 'README.md'), 'utf8'),
-    fs.readFileSync(path.join(repoRoot, 'README_EN.md'), 'utf8'),
-    'README.md and README_EN.md must stay synchronized',
-  );
-});
-
-test('README installation tables contain a complete DeepSeek Harness row', () => {
-  for (const filename of ['README.md', 'README_EN.md', 'README_ZH.md']) {
-    const readme = fs.readFileSync(path.join(repoRoot, filename), 'utf8');
-    const row = readme.split('\n').find((line) => line.startsWith('| **DeepSeek Harness** |'));
-    assert.ok(row, `${filename}: DeepSeek Harness must be an installation table row`);
-    assert.equal(
-      (row.match(/(?<!\\)\|/g) || []).length,
-      4,
-      `${filename}: DeepSeek Harness must have exactly three table cells`,
-    );
-    assert.ok(
-      row.includes('Node `^22.19.0 \\|\\| >=24.0.0`'),
-      `${filename}: Node version pipes must be escaped inside the table row`,
-    );
-    assert.ok(
-      readme.includes(`${row}\n\n`),
-      `${filename}: installation table must end after the DeepSeek Harness row`,
-    );
-  }
-});
-
-test('README demos use checked-in captures and live deep links below the existing hero', () => {
-  const demos = [
-    {
-      asset: 'archify-demo-story.png',
-      link: 'agent-tool-call.workflow.html?theme=dark&present=1&play=1#view=happy-path',
-    },
-    {
-      asset: 'archify-demo-route.png',
-      link: 'cache-miss.sequence.html?theme=dark&present=1#route=web~db',
-    },
-    {
-      asset: 'archify-demo-lens.png',
-      link: 'production-deployment.architecture.html?theme=dark&present=1#lens=backend~database',
-    },
-  ];
-
-  for (const demo of demos) {
-    const buffer = fs.readFileSync(path.join(repoRoot, 'docs', 'assets', demo.asset));
-    assert.equal(buffer.subarray(1, 4).toString('ascii'), 'PNG', `${demo.asset}: invalid PNG signature`);
-    assert.equal(buffer.readUInt32BE(16), 1280, `${demo.asset}: unexpected width`);
-    assert.equal(buffer.readUInt32BE(20), 720, `${demo.asset}: unexpected height`);
-    assert.ok(buffer.byteLength < 400 * 1024, `${demo.asset}: capture is too large`);
-  }
-
-  for (const filename of ['README.md', 'README_EN.md', 'README_ZH.md']) {
-    const readme = fs.readFileSync(path.join(repoRoot, filename), 'utf8');
-    const heroIndex = readme.indexOf('docs/assets/archify-readme-hero.png');
-    const proofIndex = readme.indexOf('docs/assets/archify-live-proof.gif');
-    const previewIndex = Math.max(readme.indexOf('## Preview'), readme.indexOf('## 预览'));
-    const demosIndex = Math.max(readme.indexOf('## See Archify in action'), readme.indexOf('## 看看 Archify 能做什么'));
-    const quickStartIndex = Math.max(readme.indexOf('## Quick start'), readme.indexOf('## 快速开始'));
-    assert.ok(heroIndex >= 0 && heroIndex < demosIndex, `${filename}: existing hero proof moved`);
-    assert.ok(demosIndex < previewIndex && previewIndex < quickStartIndex, `${filename}: demo section is misplaced`);
-    assert.ok(demosIndex < proofIndex && proofIndex < previewIndex, `${filename}: animated proof is outside the demo section`);
-    for (const demo of demos) {
-      assert.match(readme, new RegExp(`docs/assets/${demo.asset.replaceAll('.', '\\.')}`));
-      assert.ok(readme.includes(demo.link), `${filename}: missing ${demo.link}`);
-    }
-  }
-});
-
-test('README stays scannable without deleting the visual proof set', () => {
-  const commonAssets = [
-    'archify-readme-hero.png',
-    'archify-live-proof.gif',
-    'archify-demo-story.png',
-    'archify-demo-route.png',
-    'archify-demo-lens.png',
-    'mco-runtime-share-card.png',
-    'archify-dark.png',
-    'archify-light.png',
-    'archify-menu.png',
-    'archify-workflow.png',
-    'archify-sequence.png',
-    'archify-dataflow.png',
-    'archify-lifecycle.png',
-  ];
-
-  for (const filename of ['README.md', 'README_EN.md', 'README_ZH.md']) {
-    const readme = fs.readFileSync(path.join(repoRoot, filename), 'utf8');
-    assert.ok(readme.split('\n').length <= 295, `${filename}: README grew beyond the scannable line budget`);
-    assert.match(readme, filename === 'README_ZH.md' ? /不需要绑定代码库/ : /No repository is required/);
-    for (const asset of commonAssets) {
-      assert.ok(readme.includes(`docs/assets/${asset}`), `${filename}: visual proof ${asset} was removed`);
-    }
-  }
-
-  const english = fs.readFileSync(path.join(repoRoot, 'README.md'), 'utf8');
-  const wordCount = english.trim().split(/\s+/).length;
-  const intro = english.slice(0, english.indexOf('![License]'));
-  const introBullets = intro.match(/^- \*\*/gm) || [];
-  assert.ok(wordCount <= 2085, `README.md is too verbose again (${wordCount} words)`);
-  assert.ok(introBullets.length <= 8, `README.md has too many top-level capability bullets (${introBullets.length})`);
-
-  const chinese = fs.readFileSync(path.join(repoRoot, 'README_ZH.md'), 'utf8');
-  assert.ok(chinese.includes('docs/assets/claude-skills-settings.png'), 'README_ZH.md lost the Claude Skills setup image');
-});
-
-test('all README languages end with the self-hosted star history chart', () => {
-  const lightChart = 'https://raw.githubusercontent.com/tt-a1i/archify/star-history/assets/star-history-light.svg';
-  const darkChart = 'https://raw.githubusercontent.com/tt-a1i/archify/star-history/assets/star-history-dark.svg';
-  const workflow = fs.readFileSync(path.join(repoRoot, '.github', 'workflows', 'star-history.yml'), 'utf8');
-
-  for (const filename of ['README.md', 'README_EN.md', 'README_ZH.md']) {
-    const readme = fs.readFileSync(path.join(repoRoot, filename), 'utf8');
-    const sectionIndex = readme.lastIndexOf('## Star History');
-    const contributingIndex = Math.max(readme.indexOf('## Contributing'), readme.indexOf('## 参与贡献'));
-    assert.ok(sectionIndex > contributingIndex, `${filename}: Star History must follow Contributing`);
-    assert.ok(readme.includes(lightChart), `${filename}: missing light star history chart`);
-    assert.ok(readme.includes(darkChart), `${filename}: missing dark star history chart`);
-    assert.equal(readme.trimEnd().endsWith('</p>'), true, `${filename}: Star History must remain the final section`);
-  }
-
-  assert.match(workflow, /permissions:\n  contents: write/);
-  assert.match(workflow, /narayann7\/star-history-action@[0-9a-f]{40}/);
-  // Upstream PR #6 migrates setup-node to Node 24 without the v1.0.6 chart changes.
-  assert.match(workflow, /narayann7\/star-history-action@00dfada13f106e4114ee46728aa415857078e76c\s/);
-  assert.match(workflow, /output-dir: assets/);
-  assert.match(workflow, /update-readme: ['"]false['"]/);
-  assert.match(workflow, /commit: ['"]false['"]/);
-  assert.match(workflow, /bash scripts\/publish-star-history\.sh star-history/);
-  assert.doesNotMatch(workflow, /branch: star-history/);
-  assert.doesNotMatch(workflow, /xpzouying\/star-history/);
-});
-
-test('Star History publishing advances the data branch without a force push', () => {
-  const fixture = fs.mkdtempSync(path.join(os.tmpdir(), 'archify-star-history-'));
-  const remote = path.join(fixture, 'remote.git');
-  const firstCheckout = path.join(fixture, 'first');
-  const secondCheckout = path.join(fixture, 'second');
-  const publisher = path.join(repoRoot, 'scripts', 'publish-star-history.sh');
-
-  try {
-    git(fixture, 'init', '--bare', remote);
-    git(fixture, '--git-dir', remote, 'config', 'receive.denyNonFastForwards', 'true');
-    git(fixture, '--git-dir', remote, 'config', 'receive.denyDeletes', 'true');
-
-    fs.mkdirSync(firstCheckout);
-    git(firstCheckout, 'init', '-b', 'main');
-    git(firstCheckout, 'config', 'user.name', 'Fixture');
-    git(firstCheckout, 'config', 'user.email', 'fixture@example.com');
-    fs.writeFileSync(path.join(firstCheckout, 'README.md'), 'fixture\n');
-    git(firstCheckout, 'add', 'README.md');
-    git(firstCheckout, 'commit', '-m', 'seed');
-    git(firstCheckout, 'remote', 'add', 'origin', remote);
-    git(firstCheckout, 'push', '-u', 'origin', 'main');
-
-    const firstTemp = path.join(fixture, 'run-1');
-    fs.mkdirSync(firstTemp);
-    writeStarHistoryCharts(firstCheckout, 'v1');
-    execFileSync('bash', [publisher, 'star-history'], {
-      cwd: firstCheckout,
-      env: { ...process.env, RUNNER_TEMP: firstTemp },
-    });
-    const firstCommit = git(fixture, '--git-dir', remote, 'rev-parse', 'refs/heads/star-history');
-
-    git(fixture, 'clone', '--branch', 'main', remote, secondCheckout);
-    const secondTemp = path.join(fixture, 'run-2');
-    fs.mkdirSync(secondTemp);
-    writeStarHistoryCharts(secondCheckout, 'v2');
-    execFileSync('bash', [publisher, 'star-history'], {
-      cwd: secondCheckout,
-      env: { ...process.env, RUNNER_TEMP: secondTemp },
-    });
-    const secondCommit = git(fixture, '--git-dir', remote, 'rev-parse', 'refs/heads/star-history');
-
-    assert.notEqual(secondCommit, firstCommit);
-    git(fixture, '--git-dir', remote, 'merge-base', '--is-ancestor', firstCommit, secondCommit);
-    assert.deepEqual(
-      git(fixture, '--git-dir', remote, 'ls-tree', '-r', '--name-only', secondCommit).split('\n'),
-      ['assets/star-history-dark.svg', 'assets/star-history-light.svg'],
-    );
-    assert.match(
-      git(fixture, '--git-dir', remote, 'show', `${secondCommit}:assets/star-history-light.svg`),
-      /light v2/,
-    );
-  } finally {
-    fs.rmSync(fixture, { recursive: true, force: true });
-  }
-});