create-yss-spec 3.3.0 → 3.3.3

package/template/.trae/skills/archify/test/chapter-delta-preview.test.mjs

@@ -1,157 +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 tmp = fs.mkdtempSync(path.join(os.tmpdir(), 'archify-chapter-delta-preview-'));
-
-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',
-};
-
-const PROOF_CASES = [
-  'agent-tool-call.workflow.json',
-  'production-deployment.architecture.json',
-  'cache-miss-request.sequence.json',
-  'release-delivery.workflow.json',
-  'incident-response.workflow.json',
-  'product-analytics.dataflow.json',
-  'async-job-roundtrip.sequence.json',
-  'event-stream.dataflow.json',
-  'agent-run.lifecycle.json',
-  'deployment-release.lifecycle.json',
-  'web-app.architecture.json',
-];
-
-function render(mode) {
-  const output = path.join(tmp, `${mode}.html`);
-  execFileSync(process.execPath, [
-    path.join(skillRoot, `renderers/${mode}/render-${mode}.mjs`),
-    path.join(skillRoot, 'examples', CASES[mode]),
-    output,
-  ]);
-  return fs.readFileSync(output, 'utf8');
-}
-
-function canonicalSvg(html) {
-  return html.match(/<svg\b[\s\S]*?<\/svg>/)?.[0] || '';
-}
-
-function delta(previous, destination) {
-  const previousIds = new Set(previous);
-  const destinationIds = new Set(destination);
-  return {
-    stay: previous.filter((id) => destinationIds.has(id)),
-    enter: destination.filter((id) => !previousIds.has(id)),
-    leave: previous.filter((id) => !destinationIds.has(id)),
-  };
-}
-
-test('all five renderers inherit one viewer-only static Chapter Delta Preview', () => {
-  for (const mode of Object.keys(CASES)) {
-    const html = render(mode);
-    assert.match(html, /function chapterDelta\(previous, destination\)/, mode);
-    assert.match(html, /className = 'guided-view-chapter-delta'/, mode);
-    assert.match(html, /svg\.setAttribute\('data-chapter-preview', views\[index\]\.id\)/, mode);
-    assert.match(html, /data-chapter-preview-role/, mode);
-    assert.match(html, /transition: none !important/, mode);
-    assert.doesNotMatch(canonicalSvg(html), /data-chapter-preview|data-chapter-preview-role/, mode);
-  }
-});
-
-test('exact stable-ID set math powers truthful counts and the existing handoff', () => {
-  const html = render('workflow');
-  assert.match(html, /stay: previousFocus\.filter\(function \(id\) \{ return destinationIds\[id\]; \}\)/);
-  assert.match(html, /enter: destinationFocus\.filter\(function \(id\) \{ return !previousIds\[id\]; \}\)/);
-  assert.match(html, /leave: previousFocus\.filter\(function \(id\) \{ return !destinationIds\[id\]; \}\)/);
-  assert.match(html, /var delta = chapterDelta\(previous, destination\);[\s\S]*?chapterAnchor\(previous, destination, outgoingBeatIndex, delta\)/);
-  assert.match(html, /var compact = '=' \+ delta\.stay\.length \+ ' \+' \+ delta\.enter\.length \+ ' \\u2212' \+ delta\.leave\.length/);
-  assert.match(html, /viewerText\('viewer\.guided\.chapter\.delta\.aria'/);
-  assert.doesNotMatch(html, /inferChapterDelta|matchChapterLabel|nearestKind/);
-
-  let adjacent = 0;
-  let shared = 0;
-  for (const file of PROOF_CASES) {
-    const doc = JSON.parse(fs.readFileSync(path.join(skillRoot, 'examples', file), 'utf8'));
-    const views = doc.meta.views;
-    for (let index = 1; index < views.length; index += 1) {
-      adjacent += 1;
-      if (delta(views[index - 1].focus, views[index].focus).stay.length) shared += 1;
-    }
-  }
-  assert.equal(adjacent, 22);
-  assert.equal(shared, 19);
-
-  const workflow = JSON.parse(fs.readFileSync(path.join(skillRoot, 'examples', CASES.workflow), 'utf8'));
-  const [first, second, third] = workflow.meta.views;
-  assert.deepEqual(delta(first.focus, second.focus), {
-    stay: ['router', 'approval'],
-    enter: ['blocked', 'retry'],
-    leave: ['user', 'chat', 'planner', 'tool', 'external', 'final'],
-  });
-  assert.deepEqual(delta(second.focus, third.focus), {
-    stay: [],
-    enter: ['external', 'store', 'trace'],
-    leave: ['router', 'approval', 'blocked', 'retry'],
-  });
-});
-
-test('pointer and keyboard inspect while touch and native activation still commit directly', () => {
-  const html = render('architecture');
-  assert.match(html, /chapterList\.addEventListener\('pointerover'/);
-  assert.match(html, /!hoverCapable\(\) \|\| event\.pointerType === 'touch'/);
-  assert.match(html, /setChapterPreviewIntent\('pointer', chapterButtons\.indexOf\(button\)\)/);
-  assert.match(html, /chapterIndex\.addEventListener\('focusin',[\s\S]*?setChapterPreviewIntent\('focus'/);
-  assert.match(html, /event\.key === 'Escape' && activePreviewIndex >= 0[\s\S]*?event\.stopImmediatePropagation\(\)[\s\S]*?clearChapterPreview\(\{ clearIntents: true \}\)/);
-  assert.match(html, /chapterList\.addEventListener\('click',[\s\S]*?activateById/);
-  assert.match(html, /button\.type = 'button'/);
-  assert.doesNotMatch(html, /firstTap|secondTap|longpress|long-press/);
-
-  const previewRuntime = html.slice(
-    html.indexOf('function chapterPreviewBlocked()'),
-    html.indexOf('function sharePlaybackRequested()'),
-  );
-  assert.doesNotMatch(previewRuntime, /Archify\.view\.|updateUrl\(|Archify\.focus\.|renderStoryTrail\(/);
-});
-
-test('latest intent, stronger owners, playback, and lifecycle cleanup remain bounded', () => {
-  const html = render('lifecycle');
-  assert.match(html, /var previewGeneration = 0/);
-  assert.match(html, /right\.generation - left\.generation/);
-  assert.match(html, /\[pointerPreviewIntent, focusPreviewIntent\]/);
-  assert.match(html, /document\.hidden \|\| playing \|\| currentHandoff/);
-  assert.match(html, /data-route-picking'[\s\S]*?data-route-active/);
-  assert.match(html, /data-lens-active'[\s\S]*?data-legend-preview-active/);
-  assert.match(html, /data-relationship-preview-active'[\s\S]*?data-intent-trace-active/);
-  assert.match(html, /if \(playing\) pausePlayback\(\)/);
-  assert.match(html, /Archify\.motionGovernor\.claim\('chapter-preview'/);
-  assert.match(html, /Archify\.motionGovernor\.release\(token\)/);
-  assert.match(html, /handoff\.resolve[\s\S]*?syncChapterPreview\(\)/);
-  assert.match(html, /visibilitychange'[\s\S]*?clearChapterPreview/);
-  assert.match(html, /beforeprint'[\s\S]*?clearChapterPreview[\s\S]*?settleHandoff/);
-});
-
-test('mobile, Still, embed, print, and canonical exports keep the preview viewer-only', () => {
-  const html = render('sequence');
-  assert.match(html, /\.guided-view-chapter \{ min-height: 2\.75rem; \}/);
-  assert.match(html, /flex: 0 0 min\(14rem, 78vw\)/);
-  assert.match(html, /\.guided-view-chapter-delta\[hidden\] \{ display: none; \}/);
-  assert.match(html, /document\.documentElement\.getAttribute\('data-embed'\) === 'true'/);
-  assert.match(html, /prefers-reduced-motion: reduce[\s\S]*?svg\[data-chapter-preview\]/);
-  assert.match(html, /svg\[data-chapter-preview\] \[data-node-id\],[\s\S]*?opacity: 1 !important; filter: none !important/);
-  assert.match(html, /clone\.removeAttribute\('data-chapter-preview'\)/);
-  assert.match(html, /clone\.querySelectorAll\('\[data-chapter-preview-role\]'\)/);
-  assert.match(html, /!clone\.hasAttribute\('data-chapter-preview'\)/);
-  assert.match(html, /canonicalStateClean/);
-});
-
-process.on('exit', () => fs.rmSync(tmp, { recursive: true, force: true }));

package/template/.trae/skills/archify/test/chapter-handoff.test.mjs

@@ -1,97 +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 tmp = fs.mkdtempSync(path.join(os.tmpdir(), 'archify-chapter-handoff-'));
-
-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) {
-  const output = path.join(tmp, `${mode}.html`);
-  execFileSync(process.execPath, [
-    path.join(skillRoot, `renderers/${mode}/render-${mode}.mjs`),
-    path.join(skillRoot, 'examples', CASES[mode]),
-    output,
-  ]);
-  return fs.readFileSync(output, 'utf8');
-}
-
-function canonicalSvg(html) {
-  return html.match(/<svg\b[\s\S]*?<\/svg>/)?.[0] || '';
-}
-
-test('all five renderers inherit one viewer-only Shared Anchor Chapter Handoff', () => {
-  for (const mode of Object.keys(CASES)) {
-    const html = render(mode);
-    assert.match(html, /id="guided-view-handoff" hidden aria-hidden="true"/, mode);
-    assert.match(html, /function beginHandoff\(previousIndex, nextIndex, previous, destination, outgoingBeatIndex, reason\)/, mode);
-    assert.match(html, /data-chapter-handoff-overlay/, mode);
-    assert.match(html, /ring\.setAttribute\('class', 'chapter-handoff-anchor'\)/, mode);
-    assert.doesNotMatch(canonicalSvg(html), /data-chapter-handoff|data-chapter-role|chapter-handoff-anchor/, mode);
-  }
-});
-
-test('anchor selection uses exact stable-id intersection with deterministic outgoing priority', () => {
-  const html = render('workflow');
-  assert.match(html, /function chapterDelta\(previous, destination\)/);
-  assert.match(html, /function chapterAnchor\(previous, destination, outgoingBeatIndex, delta\)/);
-  assert.match(html, /delta\.stay\.forEach\(function \(id\) \{ stayIds\[id\] = true; \}\)/);
-  assert.match(html, /var activeBeat = outgoingBeatIndex >= 0 \? previous\.focus\[outgoingBeatIndex\] : ''/);
-  assert.match(html, /activeBeat && stayIds\[activeBeat\]/);
-  assert.match(html, /for \(var index = previous\.focus\.length - 1; index >= 0; index -= 1\)/);
-  assert.match(html, /if \(stayIds\[previous\.focus\[index\]\]\) return previous\.focus\[index\]/);
-  assert.doesNotMatch(html, /inferChapterAnchor|matchChapterLabel|nearestKind/);
-});
-
-test('handoff holds one truthful anchor then settles through one finite camera transaction', () => {
-  const html = render('architecture');
-  assert.match(html, /handoff\.mode = 'settling'/);
-  assert.match(html, /setTimeout\(startCamera, 110\)/);
-  assert.match(html, /duration: 420/);
-  assert.match(html, /requestAnimationFrame\(step\)/);
-  assert.match(html, /var eased = 1 - Math\.pow\(1 - fraction, 3\)/);
-  assert.match(html, /Archify\.motionGovernor\.claim\('handoff'/);
-  assert.match(html, /Archify\.motionGovernor\.release\(handoff\.ownerToken\)/);
-  assert.match(html, /handoffReceipt\.textContent = viewerText\('viewer\.guided\.handoff'/);
-  assert.doesNotMatch(html, /chapter-handoff[^\n]+infinite/);
-});
-
-test('latest intent, manual takeover, Still, reduced motion, and hidden pages cleanly settle', () => {
-  const html = render('lifecycle');
-  assert.match(html, /cancelHandoff\('replaced'\)/);
-  assert.match(html, /cameraTransaction\.cancel\(reason \|\| 'cancelled', commitTarget === true\)/);
-  assert.match(html, /transaction\.settled/);
-  assert.match(html, /currentHandoff !== handoff/);
-  assert.match(html, /Archify\.guidedViews\.cancelHandoff\(reason \|\| 'manual'\)/);
-  assert.match(html, /settleHandoff\(systemPaused \? 'reduced-motion' : \(hasSuspension\(\) \? 'hidden' : 'still'\)\)/);
-  assert.match(html, /settleHandoff\('hidden'\)/);
-  assert.match(html, /settleHandoff\('reduced-motion'\)/);
-  assert.match(html, /window\.addEventListener\('beforeprint',[\s\S]*?clearChapterPreview[\s\S]*?settleHandoff\('print'\)/);
-});
-
-test('mobile, embed, print, and canonical exports keep strict static boundaries', () => {
-  const html = render('sequence');
-  assert.match(html, /document\.documentElement\.getAttribute\('data-embed'\) === 'true'/);
-  assert.match(html, /cameraReceipt\(\{ scrollLeft: target \}/);
-  assert.match(html, /behavior: instant \? 'auto' : 'smooth'/);
-  assert.match(html, /\.chapter-handoff-overlay \{ display: none !important; \}/);
-  assert.match(html, /clone\.removeAttribute\('data-chapter-handoff'\)/);
-  assert.match(html, /clone\.removeAttribute\('data-chapter-anchor'\)/);
-  assert.match(html, /clone\.querySelectorAll\('\[data-chapter-handoff-overlay\]'\)/);
-  assert.match(html, /clone\.querySelectorAll\('\[data-chapter-role\]'\)/);
-  assert.match(html, /!clone\.hasAttribute\('data-chapter-handoff'\)/);
-});
-
-process.on('exit', () => fs.rmSync(tmp, { recursive: true, force: true }));

package/template/.trae/skills/archify/test/chapter-rail.test.mjs

@@ -1,86 +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 tmp = fs.mkdtempSync(path.join(os.tmpdir(), 'archify-chapter-rail-'));
-
-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) {
-  const output = path.join(tmp, `${mode}.html`);
-  execFileSync(process.execPath, [
-    path.join(skillRoot, `renderers/${mode}/render-${mode}.mjs`),
-    path.join(skillRoot, 'examples', CASES[mode]),
-    output,
-  ]);
-  return fs.readFileSync(output, 'utf8');
-}
-
-function canonicalSvg(html) {
-  return html.match(/<svg\b[\s\S]*?<\/svg>/)?.[0] || '';
-}
-
-test('all guided renderers expose one runtime-built named chapter rail', () => {
-  for (const mode of Object.keys(CASES)) {
-    const html = render(mode);
-    assert.match(html, /<nav class="guided-view-index" id="guided-view-index" aria-label="Story chapters">/, mode);
-    assert.match(html, /<ol class="guided-view-chapters" id="guided-view-chapters"><\/ol>/, mode);
-    assert.match(html, /function buildChapterIndex\(\)/, mode);
-    assert.match(html, /views\.forEach\(function \(view, index\)/, mode);
-    assert.match(html, /position\.textContent = \(index \+ 1 < 10 \? '0' : ''\) \+ \(index \+ 1\)/, mode);
-    assert.match(html, /title\.textContent = view\.label/, mode);
-    assert.match(html, /stops\.textContent = viewerCount\('viewer\.guided\.chapter\.stop', view\.focus\.length\)/, mode);
-    assert.doesNotMatch(canonicalSvg(html), /guided-view-chapter|data-chapter-position/, mode);
-  }
-});
-
-test('chapter rail delegates selection and mirrors the existing activeIndex owner', () => {
-  const html = render('architecture');
-  assert.match(html, /activateById\(button\.getAttribute\('data-guided-view-id'\)\)/);
-  assert.match(html, /var current = index === activeIndex/);
-  assert.match(html, /activeIndex < 0 \? 'available' : \(current \? 'current' : \(index < activeIndex \? 'before' : 'after'\)\)/);
-  assert.match(html, /button\.setAttribute\('aria-current', 'step'\)/);
-  assert.match(html, /button\.removeAttribute\('aria-current'\)/);
-  assert.match(html, /syncChapterIndex\(\);[\s\S]*renderShareCue\(\)/);
-  assert.doesNotMatch(html, /selectedChapter|visitedChapters|completedChapters/);
-});
-
-test('chapter rail is keyboard-first and pauses playback on reader takeover', () => {
-  const html = render('workflow');
-  assert.match(html, /chapterIndex\.addEventListener\('focusin',[\s\S]*if \(playing\) pausePlayback\(\)/);
-  assert.match(html, /event\.key === 'ArrowRight'/);
-  assert.match(html, /event\.key === 'ArrowLeft'/);
-  assert.match(html, /event\.key === 'Home'/);
-  assert.match(html, /event\.key === 'End'/);
-  assert.match(html, /focusChapterButton\(target\)/);
-  assert.match(html, /button\.type = 'button'/);
-  assert.doesNotMatch(html, /role="tab"|role="tabpanel"/);
-});
-
-test('chapter rail has positional, touch, mobile, motion, embed, and print boundaries', () => {
-  const html = render('lifecycle');
-  assert.match(html, /\.guided-view-chapter\[data-chapter-position="current"\][\s\S]*border: 2px solid/);
-  assert.match(html, /data-chapter-position="before"[\s\S]*border-style: solid/);
-  assert.match(html, /data-chapter-position="after"[\s\S]*border-style: dashed/);
-  assert.match(html, /\.guided-view-chapter \{ min-height: 2\.75rem; \}/);
-  assert.match(html, /scroll-snap-type: x proximity/);
-  assert.match(html, /flex: 0 0 min\(14rem, 78vw\)/);
-  assert.match(html, /behavior: 'auto'/);
-  assert.match(html, /prefers-reduced-motion: reduce[\s\S]*\.guided-view-chapter \{ transition: none !important; \}/);
-  assert.match(html, /html\[data-embed="true"\] \.guided-views \{ display: none !important; \}/);
-  assert.match(html, /\.toolbar, \.diagram-nav, \.focus-chip, \.guided-views, \.archify-toast, \.no-print \{ display: none !important; \}/);
-});
-
-process.on('exit', () => fs.rmSync(tmp, { recursive: true, force: true }));

package/template/.trae/skills/archify/test/checkout-line-endings.test.mjs

@@ -1,72 +0,0 @@
-import { test } from 'node:test';
-import assert from 'node:assert/strict';
-import { spawnSync } 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 repoRoot = fileURLToPath(new URL('../../', import.meta.url));
-
-for (const autocrlf of ['true', 'input', 'false']) {
-  test(`Git checkout preserves committed text and binary bytes with core.autocrlf=${autocrlf}`, () => {
-    const fixture = fs.mkdtempSync(path.join(os.tmpdir(), 'archify-checkout-eol-'));
-    const source = path.join(fixture, 'source');
-    const checkout = path.join(fixture, 'checkout');
-    // Ignore caller Git configuration, attributes, repository paths, and signing hooks.
-    const env = Object.fromEntries(Object.entries(process.env).filter(([key]) => !key.startsWith('GIT_')));
-    Object.assign(env, {
-      GIT_CONFIG_NOSYSTEM: '1',
-      GIT_CONFIG_GLOBAL: os.devNull,
-      GIT_ATTR_NOSYSTEM: '1',
-    });
-    const runGit = (cwd, args) => {
-      const result = spawnSync('git', ['-c', `core.attributesFile=${os.devNull}`, ...args], {
-        cwd, env, timeout: 30_000,
-      });
-      assert.equal(result.status, 0, `git ${args.join(' ')}: ${result.error || result.stderr}`);
-      return result.stdout;
-    };
-
-    try {
-      fs.mkdirSync(source);
-      runGit(source, ['init', '--quiet', '--template=']);
-      runGit(source, ['config', 'core.autocrlf', 'false']);
-      runGit(source, ['config', 'user.name', 'Archify Test']);
-      runGit(source, ['config', 'user.email', 'archify@example.invalid']);
-      const files = new Map([
-        ['.gitattributes', fs.readFileSync(path.join(repoRoot, '.gitattributes'))],
-        ['README.md', Buffer.from('# Checkout proof\n文本 stays LF.\n')],
-        ['archify/bin/example.mjs', Buffer.from('export const value = 1;\n')],
-        ['examples/proof.html', Buffer.from('<!doctype html>\n<p>diagram</p>\n')],
-        ['scripts/proof.sh', Buffer.from('#!/bin/sh\nprintf "proof"\n')],
-        // NUL identifies binary data; embedded CRLF must remain byte-for-byte intact.
-        ['archify.zip', Buffer.from([0x50, 0x4b, 3, 4, 0, 13, 10, 0xff])],
-        ['docs/assets/proof.png', Buffer.from([0x89, 0x50, 0x4e, 0x47, 13, 10, 0, 0xff])],
-      ]);
-      for (const [relative, bytes] of files) {
-        const target = path.join(source, relative);
-        fs.mkdirSync(path.dirname(target), { recursive: true });
-        fs.writeFileSync(target, bytes);
-      }
-      runGit(source, ['add', '--all']);
-      runGit(source, ['-c', 'commit.gpgSign=false', 'commit', '--quiet', '-m', 'checkout fixture']);
-      runGit(fixture, ['clone', '--quiet', '--no-checkout', '--no-hardlinks', '--template=', source, checkout]);
-      runGit(checkout, ['config', 'core.autocrlf', autocrlf]);
-      runGit(checkout, ['config', 'core.eol', 'crlf']);
-      runGit(checkout, ['checkout', '--quiet', '--detach', 'HEAD']);
-
-      for (const [relative, expected] of files) {
-        const committed = runGit(checkout, ['show', `HEAD:${relative}`]);
-        assert.deepEqual(committed, expected, `${relative}: staging must not rewrite fixture bytes`);
-        assert.deepEqual(fs.readFileSync(path.join(checkout, relative)), committed,
-          `${relative}: checkout bytes must equal committed bytes`);
-      }
-      assert.equal(runGit(checkout, ['status', '--porcelain']).toString().trim(), '');
-      assert.equal(runGit(checkout, ['check-attr', 'linguist-generated', '--', 'examples/proof.html'])
-        .toString().trim(), 'examples/proof.html: linguist-generated: true');
-    } finally {
-      fs.rmSync(fixture, { recursive: true, force: true });
-    }
-  });
-}

package/template/.trae/skills/archify/test/clean-skill-staging.test.mjs

@@ -1,244 +0,0 @@
-import assert from 'node:assert/strict';
-import { spawnSync } from 'node:child_process';
-import fs from 'node:fs';
-import os from 'node:os';
-import path from 'node:path';
-import test from 'node:test';
-import { fileURLToPath } from 'node:url';
-
-import { stageCleanSkill } from '../../scripts/stage-clean-skill.mjs';
-
-const stagerPath = path.resolve(path.dirname(fileURLToPath(import.meta.url)), '../../scripts/stage-clean-skill.mjs');
-
-function git(root, args) {
-  const result = spawnSync('git', args, { cwd: root, encoding: 'utf8' });
-  assert.equal(result.status, 0, result.stderr);
-}
-
-function write(root, relative, content, mode = null) {
-  const target = path.join(root, relative);
-  fs.mkdirSync(path.dirname(target), { recursive: true });
-  fs.writeFileSync(target, content);
-  if (mode !== null) fs.chmodSync(target, mode);
-  return target;
-}
-
-function repositoryFixture() {
-  const root = fs.mkdtempSync(path.join(os.tmpdir(), 'archify-clean-stage-'));
-  write(root, 'archify/package.json', JSON.stringify({
-    name: 'archify-fixture',
-    scripts: { test: 'node --test' },
-    devDependencies: { ajv: '1.0.0' },
-  }));
-  write(root, 'archify/package-lock.json', '{}\n');
-  write(root, 'archify/skill-release.json', '{}\n');
-  write(root, 'archify/scripts/check-update.mjs', 'export {};\n');
-  write(root, 'archify/scripts/update-contract.mjs', 'export {};\n');
-  write(root, 'archify/renderers/shared/generated-validators.mjs', 'export {};\n');
-  write(root, 'archify/test/repository-only.test.mjs', 'throw new Error();\n');
-  git(root, ['init']);
-  return root;
-}
-
-test('clean staging preserves index modes and strips repository-only package metadata', () => {
-  const root = repositoryFixture();
-  const destination = path.join(root, 'staged-skill');
-  try {
-    write(root, 'archify/bin/executable.mjs', '#!/usr/bin/env node\n', 0o755);
-    write(root, 'archify/runtime/test/required.dat', 'runtime fixture\n');
-    git(root, ['add', 'archify']);
-
-    stageCleanSkill({ repoRoot: root, destination });
-
-    assert.equal(fs.statSync(path.join(destination, 'bin', 'executable.mjs')).mode & 0o777, 0o755);
-    assert.equal(fs.existsSync(path.join(destination, 'test')), false);
-    assert.equal(
-      fs.readFileSync(path.join(destination, 'runtime', 'test', 'required.dat'), 'utf8'),
-      'runtime fixture\n',
-      'only the repository-root test tree is excluded',
-    );
-    assert.equal(fs.existsSync(path.join(destination, 'package-lock.json')), false);
-    const packageJson = JSON.parse(fs.readFileSync(path.join(destination, 'package.json'), 'utf8'));
-    assert.equal(Object.hasOwn(packageJson, 'scripts'), false);
-    assert.equal(Object.hasOwn(packageJson, 'devDependencies'), false);
-  } finally {
-    fs.rmSync(root, { recursive: true, force: true });
-  }
-});
-
-test('clean staging rejects a symlink in a tracked file ancestor before copying bytes', (t) => {
-  const root = repositoryFixture();
-  const destination = path.join(root, 'staged-skill');
-  try {
-    const runtime = path.join(root, 'archify', 'runtime');
-    write(root, 'archify/runtime/payload.txt', 'tracked fixture\n');
-    git(root, ['add', 'archify']);
-    fs.rmSync(runtime, { recursive: true });
-    const external = path.join(root, 'outside-runtime');
-    write(root, 'outside-runtime/payload.txt', 'external secret\n');
-    try {
-      fs.symlinkSync(external, runtime, process.platform === 'win32' ? 'junction' : 'dir');
-    } catch (error) {
-      if (['EPERM', 'EACCES', 'ENOTSUP'].includes(error?.code)) {
-        t.skip(`symlinks unavailable: ${error.code}`);
-        return;
-      }
-      throw error;
-    }
-
-    assert.throws(
-      () => stageCleanSkill({ repoRoot: root, destination }),
-      /refusing to package path through symlink: archify\/runtime/,
-    );
-    assert.equal(fs.existsSync(destination), false);
-  } finally {
-    fs.rmSync(root, { recursive: true, force: true });
-  }
-});
-
-test('clean staging rejects tracked symlinks before reading through them', (t) => {
-  const root = repositoryFixture();
-  const destination = path.join(root, 'staged-skill');
-  try {
-    const external = write(root, 'outside.txt', 'private fixture\n');
-    const linked = path.join(root, 'archify', 'linked.txt');
-    try {
-      fs.symlinkSync(external, linked);
-    } catch (error) {
-      if (['EPERM', 'EACCES', 'ENOTSUP'].includes(error?.code)) {
-        t.skip(`symlinks unavailable: ${error.code}`);
-        return;
-      }
-      throw error;
-    }
-    git(root, ['add', 'archify']);
-
-    assert.throws(
-      () => stageCleanSkill({ repoRoot: root, destination }),
-      /refusing to package tracked symlink: archify\/linked\.txt/,
-    );
-    assert.equal(fs.existsSync(destination), false);
-  } finally {
-    fs.rmSync(root, { recursive: true, force: true });
-  }
-});
-
-test('clean staging snapshots unstaged tracked bytes before a source ancestor can be swapped', (t) => {
-  const root = repositoryFixture();
-  const destination = path.join(root, 'staged-skill');
-  const runtime = path.join(root, 'archify', 'runtime');
-  const external = path.join(root, 'outside-runtime');
-  const originalMkdirSync = fs.mkdirSync;
-  let swapped = false;
-  try {
-    const payload = write(root, 'archify/runtime/payload.txt', 'indexed fixture\n');
-    write(root, 'outside-runtime/payload.txt', 'external secret\n');
-    git(root, ['add', 'archify']);
-    fs.writeFileSync(payload, 'unstaged working-tree fixture\n');
-
-    const probe = path.join(root, 'symlink-probe');
-    try {
-      fs.symlinkSync(external, probe, process.platform === 'win32' ? 'junction' : 'dir');
-      fs.rmSync(probe, { force: true });
-    } catch (error) {
-      if (['EPERM', 'EACCES', 'ENOTSUP'].includes(error?.code)) {
-        t.skip(`symlinks unavailable: ${error.code}`);
-        return;
-      }
-      throw error;
-    }
-
-    fs.mkdirSync = function swapSourceAfterSnapshot(target, ...args) {
-      const result = originalMkdirSync.call(fs, target, ...args);
-      if (!swapped && path.resolve(target) === path.resolve(destination)) {
-        fs.rmSync(runtime, { recursive: true });
-        fs.symlinkSync(external, runtime, process.platform === 'win32' ? 'junction' : 'dir');
-        swapped = true;
-      }
-      return result;
-    };
-
-    stageCleanSkill({ repoRoot: root, destination });
-
-    assert.equal(swapped, true, 'the deterministic ancestor-swap attack must run');
-    assert.equal(
-      fs.readFileSync(path.join(destination, 'runtime', 'payload.txt'), 'utf8'),
-      'unstaged working-tree fixture\n',
-      'staging keeps the tracked working-tree snapshot and never follows the replacement ancestor',
-    );
-  } finally {
-    fs.mkdirSync = originalMkdirSync;
-    fs.rmSync(root, { recursive: true, force: true });
-  }
-});
-
-test('clean staging rejects a source ancestor swapped during preflight traversal', (t) => {
-  const root = repositoryFixture();
-  const destination = path.join(root, 'staged-skill');
-  const runtime = path.join(root, 'archify', 'runtime');
-  const external = path.join(root, 'outside-runtime');
-  const originalLstatSync = fs.lstatSync;
-  let swapped = false;
-  try {
-    write(root, 'archify/runtime/payload.txt', 'tracked fixture\n');
-    write(root, 'outside-runtime/payload.txt', 'external secret\n');
-    git(root, ['add', 'archify']);
-    const canonicalRuntime = path.join(fs.realpathSync(root), 'archify', 'runtime');
-
-    const probe = path.join(root, 'symlink-probe');
-    try {
-      fs.symlinkSync(external, probe, process.platform === 'win32' ? 'junction' : 'dir');
-      fs.rmSync(probe, { force: true });
-    } catch (error) {
-      if (['EPERM', 'EACCES', 'ENOTSUP'].includes(error?.code)) {
-        t.skip(`symlinks unavailable: ${error.code}`);
-        return;
-      }
-      throw error;
-    }
-
-    fs.lstatSync = function swapSourceBetweenAncestorAndLeaf(target, ...args) {
-      const metadata = originalLstatSync.call(fs, target, ...args);
-      if (!swapped && path.resolve(target) === canonicalRuntime) {
-        // Guard before mutation: recursive removal can re-enter the patched
-        // lstatSync implementation on Linux.
-        swapped = true;
-        fs.rmSync(runtime, { recursive: true });
-        fs.symlinkSync(external, runtime, process.platform === 'win32' ? 'junction' : 'dir');
-      }
-      return metadata;
-    };
-
-    assert.throws(
-      () => stageCleanSkill({ repoRoot: root, destination }),
-      /(?:tracked package path changed before it could be read: archify\/|tracked package input is missing or unreadable: archify\/runtime\/payload\.txt)/,
-    );
-    assert.equal(swapped, true, 'the deterministic mid-preflight ancestor swap must run');
-    assert.equal(fs.existsSync(destination), false);
-  } finally {
-    fs.lstatSync = originalLstatSync;
-    fs.rmSync(root, { recursive: true, force: true });
-  }
-});
-
-test('clean staging reports the Git spawn error when Git cannot start', () => {
-  const root = repositoryFixture();
-  const destination = path.join(root, 'staged-skill');
-  try {
-    git(root, ['add', 'archify']);
-    const result = spawnSync(process.execPath, [
-      stagerPath,
-      '--root', root,
-      '--dest', destination,
-    ], {
-      encoding: 'utf8',
-      env: { ...process.env, PATH: '' },
-    });
-    assert.notEqual(result.status, 0);
-    assert.match(result.stderr, /unable to enumerate tracked Archify files: .*ENOENT/);
-    assert.doesNotMatch(result.stderr, /tracked Archify paths must be valid UTF-8/);
-    assert.equal(fs.existsSync(destination), false);
-  } finally {
-    fs.rmSync(root, { recursive: true, force: true });
-  }
-});