create-yss-spec 3.3.1 → 3.3.3

package/template/.claude/skills/archify/test/golden.mjs

@@ -1,207 +0,0 @@
-// Golden-file harness for the archify renderers. No test framework needed:
-// renderers are deterministic, so fresh renders must match both checked-in
-// development and packaged example HTML aside from platform checkout line endings. Also covers schema enforcement (negative cases),
-// template freshness of the architecture-mode example, and version sync.
-//
-// Run from the skill folder: npm test
-
-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-test-'));
-
-let failures = 0;
-
-function check(name, ok, detail) {
-  if (ok) {
-    console.log(`  ok    ${name}`);
-  } else {
-    failures += 1;
-    console.error(`  FAIL  ${name}${detail ? ` — ${detail}` : ''}`);
-  }
-}
-
-function render(mode, inputPath, outPath) {
-  execFileSync('node', [
-    path.join(skillRoot, `renderers/${mode}/render-${mode}.mjs`),
-    inputPath,
-    outPath,
-  ], { stdio: ['ignore', 'ignore', 'pipe'] });
-}
-
-function normalizeNewlines(text) {
-  return text.replace(/\r\n?/g, '\n');
-}
-
-function shieldsBadgeMessages(source, label) {
-  const marker = `/badge/${label}-`;
-  const messages = [];
-  let searchFrom = 0;
-  while (searchFrom < source.length) {
-    const start = source.indexOf(marker, searchFrom);
-    if (start === -1) break;
-    let cursor = start + marker.length;
-    let message = '';
-    while (cursor < source.length) {
-      const character = source[cursor];
-      const next = source[cursor + 1];
-      if (character === '-' && next === '-') {
-        message += '-';
-        cursor += 2;
-      } else if (character === '_' && next === '_') {
-        message += '_';
-        cursor += 2;
-      } else if (character === '-') {
-        break;
-      } else {
-        message += character;
-        cursor += 1;
-      }
-    }
-    try { messages.push(decodeURIComponent(message)); } catch { messages.push(message); }
-    searchFrom = cursor + 1;
-  }
-  return messages;
-}
-
-// ---------------------------------------------------------------------------
-console.log('golden renders (renderer output must match checked-in examples)');
-
-const GOLDEN = [
-  ['workflow', 'agent-tool-call.workflow.json', 'workflow-agent-tool-call-rendered.html'],
-  ['sequence', 'cache-miss-request.sequence.json', 'sequence-cache-miss-request.html'],
-  ['dataflow', 'product-analytics.dataflow.json', 'dataflow-product-analytics.html'],
-  ['lifecycle', 'agent-run.lifecycle.json', 'lifecycle-agent-run.html'],
-  ['architecture', 'web-app.architecture.json', 'web-app-rendered.html'],
-];
-
-for (const [mode, input, golden] of GOLDEN) {
-  const out = path.join(tmp, golden);
-  try {
-    render(mode, path.join(skillRoot, 'examples', input), out);
-    const fresh = fs.readFileSync(out, 'utf8');
-    const checked = fs.readFileSync(path.join(repoRoot, 'examples', golden), 'utf8');
-    const packaged = fs.readFileSync(path.join(skillRoot, 'examples', golden), 'utf8');
-    check(`${mode}: ${golden}`, normalizeNewlines(fresh) === normalizeNewlines(checked),
-      `fresh render differs from examples/${golden}; if the change is intentional, re-render the examples and commit them`);
-    check(`${mode}: packaged ${golden}`, normalizeNewlines(fresh) === normalizeNewlines(packaged),
-      `fresh render differs from archify/examples/${golden}; re-render the packaged examples and rebuild archify.zip`);
-  } catch (err) {
-    check(`${mode}: ${golden}`, false, String(err.stderr || err.message).slice(0, 300));
-  }
-}
-
-// ---------------------------------------------------------------------------
-console.log('schema enforcement (invalid JSON must fail with a path-prefixed message)');
-
-function expectFailure(name, mode, mutate, expectInMessage) {
-  const base = JSON.parse(fs.readFileSync(
-    path.join(skillRoot, 'examples', GOLDEN.find(([m]) => m === mode)[1]), 'utf8'));
-  mutate(base);
-  const input = path.join(tmp, `neg-${name.replace(/[^a-z0-9]+/gi, '-')}.json`);
-  fs.writeFileSync(input, JSON.stringify(base));
-  try {
-    render(mode, input, path.join(tmp, 'neg-out.html'));
-    check(name, false, 'renderer exited 0 on invalid input');
-  } catch (err) {
-    const message = String(err.stderr || err.message);
-    check(name, message.includes(expectInMessage),
-      `expected "${expectInMessage}" in:\n${message.slice(0, 300)}`);
-  }
-}
-
-expectFailure('card dot outside enum', 'workflow',
-  (d) => { d.cards[0].dot = 'pink'; }, '/cards/0/dot');
-expectFailure('node id starting with a digit', 'workflow',
-  (d) => { d.nodes[0].id = '1user'; }, 'pattern');
-expectFailure('extra property rejected', 'workflow',
-  (d) => { d.nodes[0].colour = 'red'; }, 'additional properties');
-expectFailure('column beyond layout maximum', 'workflow',
-  (d) => { d.nodes[0].col = 7; }, '<= 5');
-expectFailure('missing schema_version', 'sequence',
-  (d) => { delete d.schema_version; }, 'schema_version');
-expectFailure('cross-lane state overlap', 'lifecycle',
-  (d) => {
-    const approval = d.states.find((s) => s.id === 'approval');
-    const failed = d.states.find((s) => s.id === 'failed');
-    delete failed.yOffset;
-    failed.col = approval.col;
-  }, 'less than 10px apart');
-expectFailure('zero component width rejected by schema', 'architecture',
-  (d) => { d.components[0].size = [0, 60]; }, '/components/0/size/0');
-expectFailure('zero component height rejected by schema', 'architecture',
-  (d) => { d.components[0].size = [120, 0]; }, '/components/0/size/1');
-expectFailure('negative component width rejected by schema', 'architecture',
-  (d) => { d.components[0].size = [-1, 60]; }, '/components/0/size/0');
-
-// ---------------------------------------------------------------------------
-console.log('template freshness (architecture example must carry the current template)');
-
-function blocks(html, tag) {
-  const re = new RegExp(`<${tag}[^>]*>[\\s\\S]*?<\\/${tag}>`, 'g');
-  return html.match(re) || [];
-}
-
-const template = fs.readFileSync(path.join(skillRoot, 'assets/template.html'), 'utf8');
-const webApp = fs.readFileSync(path.join(repoRoot, 'examples/web-app.html'), 'utf8');
-// <style> and <script> blocks pass through applyTemplate untouched, so the
-// architecture-mode example must contain them verbatim or it has drifted.
-for (const tag of ['style', 'script']) {
-  // The guided-view JSON script is generated from meta.views; compare only
-  // template-owned executable scripts, not per-diagram data payloads.
-  const isTemplateOwned = (block) => !block.includes('type="application/json"');
-  const t = blocks(template, tag).filter((b) => !b.includes('[PROJECT NAME]') && isTemplateOwned(b));
-  const w = blocks(webApp, tag).filter((b) => !b.includes('Sample Web App') && isTemplateOwned(b));
-  check(`web-app.html ${tag} blocks match template`,
-    JSON.stringify(t) === JSON.stringify(w),
-    'examples/web-app.html was generated from a stale template — re-derive it');
-}
-
-// ---------------------------------------------------------------------------
-console.log('version sync');
-
-const pkg = JSON.parse(fs.readFileSync(path.join(skillRoot, 'package.json'), 'utf8'));
-check('template generator meta matches package.json version',
-  template.includes(`<meta name="generator" content="archify ${pkg.version}">`),
-  `package.json says ${pkg.version}`);
-
-const lock = JSON.parse(fs.readFileSync(path.join(skillRoot, 'package-lock.json'), 'utf8'));
-check('package-lock.json version matches package.json',
-  lock.version === pkg.version && lock.packages?.['']?.version === pkg.version,
-  `lockfile says ${lock.version} — run npm install and rebuild the zip`);
-
-const skillMd = fs.readFileSync(path.join(skillRoot, 'SKILL.md'), 'utf8');
-const skillVersion = (skillMd.match(/^\s*version:\s*"([^"]+)"/m) || [])[1];
-const packageMajorMinor = pkg.version.match(/^(\d+\.\d+)\./)?.[1];
-check('SKILL.md metadata version matches package.json major.minor',
-  !!packageMajorMinor && skillVersion === packageMajorMinor,
-  `SKILL.md says ${skillVersion}, package.json says ${pkg.version}`);
-
-for (const readmeName of ['README.md', 'README_EN.md', 'README_ZH.md']) {
-  const readme = fs.readFileSync(path.join(repoRoot, readmeName), 'utf8');
-  const badgeVersions = shieldsBadgeMessages(readme, 'version');
-  check(`${readmeName} badge matches package.json version`,
-    badgeVersions.length > 0 && badgeVersions.every((version) => version === pkg.version),
-    `${readmeName} badge says ${[...new Set(badgeVersions)].join(', ') || '(missing)'} instead of ${pkg.version}`);
-}
-
-const landingPage = fs.readFileSync(path.join(repoRoot, 'docs/index.html'), 'utf8');
-const landingVersions = [...landingPage.matchAll(/\bv\d+\.\d+\.\d+(?:-[0-9A-Za-z-]+(?:\.[0-9A-Za-z-]+)*)?\b/g)]
-  .map((match) => match[0]);
-check('GitHub Pages version labels match package.json',
-  landingVersions.length > 0 && landingVersions.every((v) => v === `v${pkg.version}`),
-  `landing page says ${[...new Set(landingVersions)].join(', ') || '(no version)'}`);
-
-// ---------------------------------------------------------------------------
-fs.rmSync(tmp, { recursive: true, force: true });
-if (failures) {
-  console.error(`\n${failures} check(s) failed`);
-  process.exit(1);
-}
-console.log('\nall checks passed');

package/template/.claude/skills/archify/test/grid.test.mjs

@@ -1,47 +0,0 @@
-import { test } from 'node:test';
-import assert from 'node:assert/strict';
-import { gridLayout, resolveComponentPos, validateGridPlacement } from '../renderers/architecture/grid.mjs';
-
-test('gridLayout returns null for free placement', () => {
-  assert.equal(gridLayout({}), null);
-  assert.equal(gridLayout({ layout: undefined }), null);
-});
-
-test('resolveComponentPos prefers explicit pos over row/col', () => {
-  const grid = gridLayout({ layout: { mode: 'grid' } });
-  assert.deepEqual(resolveComponentPos({ pos: [9, 8], row: 0, col: 0 }, grid), [9, 8]);
-});
-
-test('resolveComponentPos maps row/col to pixel origin', () => {
-  const grid = gridLayout({
-    layout: { mode: 'grid', origin: [40, 80], gapX: 30, gapY: 40, cellW: 130, cellH: 64 },
-  });
-  assert.deepEqual(resolveComponentPos({ row: 0, col: 0 }, grid), [40, 80]);
-  assert.deepEqual(resolveComponentPos({ row: 1, col: 2 }, grid), [40 + 2 * 160, 80 + 104]);
-});
-
-test('validateGridPlacement rejects duplicate cells and missing row/col', () => {
-  const grid = gridLayout({ layout: { mode: 'grid', cols: 4 } });
-  const problems = [];
-  validateGridPlacement({
-    components: [
-      { id: 'a', row: 0, col: 0 },
-      { id: 'b', row: 0, col: 0 },
-      { id: 'c' },
-    ],
-  }, grid, problems);
-  assert.ok(problems.some((p) => p.includes('share grid cell')));
-  assert.ok(problems.some((p) => p.includes('"c" needs pos')));
-});
-
-test('validateGridPlacement ignores explicit pos overrides without row/col', () => {
-  const grid = gridLayout({ layout: { mode: 'grid', cols: 4 } });
-  const problems = [];
-  validateGridPlacement({
-    components: [
-      { id: 'a', pos: [40, 80] },
-      { id: 'b', pos: [200, 80] },
-    ],
-  }, grid, problems);
-  assert.deepEqual(problems, []);
-});

package/template/.claude/skills/archify/test/guide-page.test.mjs

@@ -1,59 +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 vm from 'node:vm';
-import { fileURLToPath } from 'node:url';
-
-const __dirname = path.dirname(fileURLToPath(import.meta.url));
-const skillRoot = path.resolve(__dirname, '..');
-const repoRoot = path.resolve(skillRoot, '..');
-
-test('guide page: checked-in HTML is reproducible from the shared recipe source', () => {
-  const tmp = fs.mkdtempSync(path.join(os.tmpdir(), 'archify-guide-page-'));
-  const generated = path.join(tmp, 'guide.html');
-  try {
-    execFileSync(process.execPath, [path.join(repoRoot, 'scripts/build-guide.mjs'), generated]);
-    assert.equal(
-      fs.readFileSync(generated, 'utf8'),
-      fs.readFileSync(path.join(repoRoot, 'docs/guide.html'), 'utf8'),
-    );
-  } finally {
-    fs.rmSync(tmp, { recursive: true, force: true });
-  }
-});
-
-test('guide page: ships bilingual recipes and syntactically valid interaction code', () => {
-  const html = fs.readFileSync(path.join(repoRoot, 'docs/guide.html'), 'utf8');
-  const packageVersion = JSON.parse(
-    fs.readFileSync(path.join(skillRoot, 'package.json'), 'utf8'),
-  ).version;
-  const releaseIdentity = packageVersion.includes('-') ? 'development' : 'stable';
-  const staticVersionLabel = html.match(
-    /<span data-i18n="versionLabel">([^<]+)<\/span>/,
-  );
-  assert.doesNotMatch(html, /\[\[[A-Z0-9_]+\]\]/);
-  assert.equal(
-    staticVersionLabel?.[1],
-    `Scenario guide / ${releaseIdentity} / v${packageVersion}`,
-  );
-  assert.match(html, /Question-first diagramming/);
-  assert.match(html, /先问题，后图表/);
-  assert.match(html, /archify guide &quot;your scenario&quot;|archify guide "your scenario"/);
-
-  const dataMatch = html.match(/<script id="guide-data" type="application\/json">([\s\S]*?)<\/script>/);
-  assert.ok(dataMatch);
-  const data = JSON.parse(dataMatch[1]);
-  assert.equal(data.length, 11);
-  assert.equal(data.filter((recipe) => recipe.type === 'workflow').length, 3);
-  assert.ok(data.every((recipe) => recipe.en.prompt && recipe.zh.prompt && recipe.proof));
-  assert.match(html, /gallery\.html#proof-/);
-  assert.match(html, /Open verified example/);
-  assert.match(html, /打开验证成品/);
-
-  const scriptMatch = html.match(/<script>\n([\s\S]*?)\n  <\/script>\n<\/body>/);
-  assert.ok(scriptMatch);
-  assert.doesNotThrow(() => new vm.Script(scriptMatch[1]));
-});

package/template/.claude/skills/archify/test/guide.test.mjs

@@ -1,81 +0,0 @@
-import { test } from 'node:test';
-import assert from 'node:assert/strict';
-import {
-  SCENARIO_RECIPES,
-  detectGuideLanguage,
-  listScenarioRecipes,
-  publicGuideData,
-  recommendScenario,
-} from '../recipes/scenarios.mjs';
-
-test('guide: exposes 11 unique recipes across every diagram type', () => {
-  assert.equal(SCENARIO_RECIPES.length, 11);
-  assert.equal(new Set(SCENARIO_RECIPES.map((recipe) => recipe.id)).size, 11);
-  assert.deepEqual(
-    Object.fromEntries(['architecture', 'workflow', 'sequence', 'dataflow', 'lifecycle'].map((type) => [
-      type,
-      SCENARIO_RECIPES.filter((recipe) => recipe.type === type).length,
-    ])),
-    { architecture: 2, workflow: 3, sequence: 2, dataflow: 2, lifecycle: 2 },
-  );
-});
-
-test('guide: every recipe has complete English and Chinese decision copy', () => {
-  for (const recipe of SCENARIO_RECIPES) {
-    assert.match(recipe.id, /^[a-z0-9]+(?:-[a-z0-9]+)*$/);
-    assert.ok(recipe.signals.length >= 8, recipe.id);
-    assert.ok(['classic', 'signal-flow', 'blueprint', 'editorial'].includes(recipe.presentation.preset), recipe.id);
-    for (const lang of ['en', 'zh']) {
-      const copy = recipe[lang];
-      assert.ok(copy.title.length >= 4, `${recipe.id}.${lang}.title`);
-      for (const field of ['question', 'summary', 'useWhen', 'avoidWhen', 'prompt']) {
-        assert.ok(copy[field].length > 10, `${recipe.id}.${lang}.${field}`);
-      }
-      assert.equal(copy.include.length, 4, `${recipe.id}.${lang}.include`);
-    }
-  }
-});
-
-test('guide: language detection and localization are deterministic', () => {
-  assert.equal(detectGuideLanguage('show an API request'), 'en');
-  assert.equal(detectGuideLanguage('展示 API 请求'), 'zh');
-  assert.equal(listScenarioRecipes('zh')[0].title, '系统总览');
-  assert.equal(listScenarioRecipes('en')[0].title, 'System overview');
-});
-
-test('guide: representative scenarios map to specialized recipes', () => {
-  const cases = [
-    ['Show an API request with Redis cache miss', 'api-request'],
-    ['Show CI/CD build deploy rollback', 'delivery-workflow'],
-    ['展示 Kafka topic 消费者组和死信队列', 'event-stream'],
-    ['梳理 ETL 数仓 PII 数据血缘', 'data-lineage'],
-    ['deployment lifecycle approval rollback state', 'deployment-lifecycle'],
-    ['agent tool call approval gate MCP', 'agent-tool-call'],
-  ];
-
-  for (const [query, expected] of cases) {
-    assert.equal(recommendScenario(query).recommendation.id, expected, query);
-  }
-});
-
-test('guide: exact ids win and unknown questions fall back honestly', () => {
-  const exact = recommendScenario('incident-runbook');
-  assert.equal(exact.recommendation.id, 'incident-runbook');
-  assert.equal(exact.confidence, 'high');
-
-  const unknown = recommendScenario('make it delightful');
-  assert.equal(unknown.recommendation.id, 'system-overview');
-  assert.equal(unknown.confidence, 'low');
-  assert.deepEqual(unknown.matchedSignals, []);
-});
-
-test('guide: public data includes both languages and weighted signals', () => {
-  const data = publicGuideData();
-  assert.equal(data.length, 11);
-  for (const recipe of data) {
-    assert.ok(recipe.en.title);
-    assert.ok(recipe.zh.title);
-    assert.ok(recipe.proof, `${recipe.id}: verified proof is required`);
-    assert.ok(recipe.signals.every(([signal, weight]) => typeof signal === 'string' && weight > 0));
-  }
-});

package/template/.claude/skills/archify/test/guided-views.test.mjs

@@ -1,144 +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 __dirname = path.dirname(fileURLToPath(import.meta.url));
-const skillRoot = path.resolve(__dirname, '..');
-const tmp = fs.mkdtempSync(path.join(os.tmpdir(), 'archify-guided-views-'));
-
-const CASES = {
-  architecture: { example: 'web-app.architecture.json', collection: 'components' },
-  workflow: { example: 'agent-tool-call.workflow.json', collection: 'nodes' },
-  sequence: { example: 'cache-miss-request.sequence.json', collection: 'participants' },
-  dataflow: { example: 'product-analytics.dataflow.json', collection: 'nodes' },
-  lifecycle: { example: 'agent-run.lifecycle.json', collection: 'states' },
-};
-
-function run(mode, doc, suffix) {
-  const input = path.join(tmp, `${mode}-${suffix}.json`);
-  const output = path.join(tmp, `${mode}-${suffix}.html`);
-  fs.writeFileSync(input, JSON.stringify(doc));
-  const result = spawnSync(process.execPath, [
-    path.join(skillRoot, `renderers/${mode}/render-${mode}.mjs`), input, output,
-  ], { encoding: 'utf8' });
-  return { result, output, html: fs.existsSync(output) ? fs.readFileSync(output, 'utf8') : '' };
-}
-
-function fixture(mode) {
-  return JSON.parse(fs.readFileSync(path.join(skillRoot, 'examples', CASES[mode].example), 'utf8'));
-}
-
-function svg(html) {
-  return html.match(/<svg\b[\s\S]*?<\/svg>/)?.[0] || '';
-}
-
-for (const [mode, config] of Object.entries(CASES)) {
-  test(`${mode}: guided views preserve base SVG geometry`, () => {
-    const withViews = fixture(mode);
-    const ids = withViews[config.collection].slice(0, 2).map((item) => item.id);
-    withViews.meta.views = [{
-      id: 'reader-path',
-      label: 'Reader path',
-      focus: ids,
-      note: 'A safe note with </script><script> text.',
-    }];
-    const withoutViews = structuredClone(withViews);
-    delete withoutViews.meta.views;
-
-    const guided = run(mode, withViews, 'guided');
-    const plain = run(mode, withoutViews, 'plain');
-    assert.equal(guided.result.status, 0, guided.result.stderr);
-    assert.equal(plain.result.status, 0, plain.result.stderr);
-    assert.equal(svg(guided.html), svg(plain.html));
-    assert.match(guided.html, /id="guided-views" hidden/);
-    assert.match(guided.html, /Archify\.guidedViews = \(function \(\)/);
-    assert.match(guided.html, /#view=/);
-    assert.match(guided.html, /addEventListener\('hashchange', syncViewFromHash\)/);
-    assert.match(guided.html, /id="guided-view-play"/);
-    assert.match(guided.html, /VIEW_INTERVAL_MS = 3200/);
-    assert.match(guided.html, /visibilitychange/);
-    assert.match(guided.html, /play: startPlayback/);
-    assert.match(guided.html, /playCurrent: startCurrentViewPlayback/);
-    assert.match(guided.html, /URLSearchParams\(location\.search\)\.get\('play'\) === '1'/);
-    assert.match(guided.html, /data-autoplay/);
-    assert.match(guided.html, /prefers-reduced-motion: reduce/);
-    assert.match(guided.html, /pausePlayback\(\{ complete: true \}\)/);
-    assert.match(guided.html, /html\[data-embed="true"\] svg\[data-animation="trace"\] \[data-animate\],[\s\S]*?html\[data-share-playback="true"\][\s\S]*?animation: none !important;[\s\S]*?stroke-dashoffset: 0/);
-    assert.match(guided.html, /document\.documentElement\.setAttribute\('data-share-playback', 'true'\)/);
-    assert.match(guided.html, /document\.documentElement\.removeAttribute\('data-share-playback'\)/);
-    const oneShot = guided.html.match(/function startCurrentViewPlayback\(\) \{([\s\S]*?)\n      function maybeStartSharePlayback/);
-    assert.ok(oneShot, 'one-shot share playback implementation missing');
-    assert.match(oneShot[1], /storyPlaybackScope = 'chapter'/);
-    assert.match(oneShot[1], /scheduleStoryPlayback\(\)/);
-    assert.doesNotMatch(oneShot[1], /scheduleNextView/);
-    assert.match(guided.html, /id="share-chapter-cue" hidden role="status" aria-live="polite"/);
-    assert.match(guided.html, /data-share-playback="true"\] \.share-chapter-cue:not\(\[hidden\]\)/);
-    assert.match(guided.html, /data-share-playback="true"\] \.diagram-container \{\s*padding-top: 4\.25rem/);
-    assert.match(guided.html, /function renderShareCue\(\)/);
-    assert.match(guided.html, /function shareCueBeatCopy\(state, view, stops\)/);
-    assert.match(guided.html, /viewerText\('viewer\.guided\.share\.step'/);
-    assert.match(guided.html, /shareCue\.setAttribute\('aria-live', state === 'playing' \? 'off' : 'polite'\)/);
-    assert.match(guided.html, /function scheduleStoryPlayback\(\)/);
-    assert.match(guided.html, /storyBeatTimer = setTimeout/);
-    assert.match(guided.html, /generation !== storyPlaybackGeneration/);
-    assert.match(guided.html, /settleStoryBeats\(\);/);
-    assert.match(guided.html, /kind === 'multiple' \? '\\u21c4' : '\\u00b7'/);
-    assert.match(guided.html, /currentStoryProgress\(\)/);
-    assert.match(guided.html, /setShareCueProgress\(progress\)/);
-    assert.match(guided.html, /startShareCueProgress\(progress, remainingChapter\)/);
-    assert.match(guided.html, /data-wide-diagram/);
-    assert.match(guided.html, /min-width: 720px/);
-    assert.match(guided.html, /reveal: reveal/);
-    assert.match(guided.html, /container\.addEventListener\('scroll', onScroll, \{ passive: true \}\)/);
-    assert.match(guided.html, /--archify-scroll-x/);
-    assert.match(guided.html, /focus: function \(\) \{ return activeIndex < 0 \? \[\] : views\[activeIndex\]\.focus\.slice\(\); \}/);
-    assert.doesNotMatch(guided.html, /<p class="footer">/);
-    assert.doesNotMatch(guided.html, /<kbd>P<\/kbd> play story/);
-    assert.doesNotMatch(plain.html, /<kbd>P<\/kbd> play story/);
-    assert.match(guided.html, /\\u003c\/script\\u003e\\u003cscript\\u003e/);
-    assert.doesNotMatch(guided.html, /A safe note with <\/script><script>/);
-  });
-}
-
-test('guided views reject duplicate view ids', () => {
-  const doc = fixture('workflow');
-  doc.meta.views = [
-    { id: 'same', label: 'First', focus: ['user'] },
-    { id: 'same', label: 'Second', focus: ['chat'] },
-  ];
-  const { result } = run('workflow', doc, 'duplicate-view-id');
-  assert.notEqual(result.status, 0);
-  assert.match(result.stderr, /duplicates view id "same"/);
-});
-
-test('guided views reject dangling semantic ids', () => {
-  const doc = fixture('sequence');
-  doc.meta.views = [{ id: 'broken', label: 'Broken', focus: ['ghost'] }];
-  const { result } = run('sequence', doc, 'dangling-id');
-  assert.notEqual(result.status, 0);
-  assert.match(result.stderr, /references unknown semantic id "ghost"/);
-});
-
-test('guided views schema enforces collection and focus bounds', () => {
-  const tooMany = fixture('architecture');
-  tooMany.meta.views = Array.from({ length: 6 }, (_, index) => ({
-    id: `view-${index}`,
-    label: `View ${index}`,
-    focus: [tooMany.components[0].id],
-  }));
-  const overLimit = run('architecture', tooMany, 'too-many');
-  assert.notEqual(overLimit.result.status, 0);
-  assert.match(overLimit.result.stderr, /must NOT have more than 5 items/);
-
-  const duplicateFocus = fixture('dataflow');
-  duplicateFocus.meta.views = [{ id: 'duplicate', label: 'Duplicate', focus: ['web', 'web'] }];
-  const duplicate = run('dataflow', duplicateFocus, 'duplicate-focus');
-  assert.notEqual(duplicate.result.status, 0);
-  assert.match(duplicate.result.stderr, /duplicates semantic id "web"/);
-});
-
-process.on('exit', () => fs.rmSync(tmp, { recursive: true, force: true }));

package/template/.claude/skills/archify/test/helpers/xml.mjs

@@ -1,37 +0,0 @@
-import { parse, parseFragment } from 'parse5';
-import { SaxesParser } from 'saxes';
-
-function visit(node, callback, insideSvg = false) {
-  callback(node, insideSvg);
-  const childInsideSvg = insideSvg || node.tagName === 'svg';
-  for (const child of node.childNodes || []) visit(child, callback, childInsideSvg);
-  if (node.content) visit(node.content, callback, childInsideSvg);
-}
-
-export function parseXml(source) {
-  return new SaxesParser({ xmlns: true }).write(source).close();
-}
-
-export function extractSvgs(markup, fragment = false) {
-  const document = fragment
-    ? parseFragment(markup, { sourceCodeLocationInfo: true })
-    : parse(markup, { sourceCodeLocationInfo: true });
-  const direct = [];
-  const srcdocs = [];
-
-  visit(document, (node, insideSvg) => {
-    if (node.tagName === 'svg' && !insideSvg && node.sourceCodeLocation) {
-      direct.push(markup.slice(node.sourceCodeLocation.startOffset, node.sourceCodeLocation.endOffset));
-    }
-    const srcdoc = node.attrs?.find((attribute) => attribute.name === 'srcdoc');
-    if (srcdoc) srcdocs.push(srcdoc.value);
-  });
-
-  return {
-    direct,
-    embedded: srcdocs.flatMap((srcdoc) => {
-      const nested = extractSvgs(srcdoc, true);
-      return [...nested.direct, ...nested.embedded];
-    }),
-  };
-}