create-yss-spec 3.0.0 → 3.1.0

package/template/.hermes/skills/archify/test/story-carrier.test.mjs

@@ -1,90 +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 template = fs.readFileSync(path.join(skillRoot, 'assets', 'template.html'), 'utf8');
-const tmp = fs.mkdtempSync(path.join(os.tmpdir(), 'archify-story-carrier-'));
-
-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 viewer-only Semantic Story Carrier', () => {
-  for (const [mode, example] of Object.entries(CASES)) {
-    const html = render(mode, example);
-    assert.match(html, /Archify\.flowTokens = \{/, mode);
-    assert.match(html, /className: 'story-flow-token'/, mode);
-    assert.match(html, /data-story-carrier-token/, mode);
-    assert.match(html, /animation: archify-relationship-token-life 0\.78s linear 1 both/, mode);
-    assert.doesNotMatch(canonicalSvg(html), /story-flow-token|story-carrier-token|semantic-flow-token/, mode);
-  }
-});
-
-test('Story deduplicates SVG path and label fragments by stable authored edge key', () => {
-  assert.match(template, /function uniqueStoryEdges\(edgeList\)/);
-  assert.match(template, /var key = storyEdgeKey\(edge\)/);
-  assert.match(template, /Object\.prototype\.hasOwnProperty\.call\(positions, key\)/);
-  assert.match(template, /!storyGeometry\(unique\[index\]\)\.length && storyGeometry\(edge\)\.length/);
-  assert.match(template, /forward = uniqueStoryEdges\(forward\)/);
-  assert.match(template, /reverse = uniqueStoryEdges\(reverse\)/);
-  assert.match(template, /edges\.length === 1 && forward\.length === 1 \? 'forward'/);
-});
-
-test('Story reuses the exact semantic token vocabulary on its existing finite edge pulse', () => {
-  assert.match(template, /function createSemanticFlowToken\(edge, shape, options\)/);
-  assert.match(template, /relationshipTokenGeometry\(shape, relationshipTokenKind\(edge\), key, options\)/);
-  assert.match(template, /Archify\.flowTokens\.create\(edge, shapes\[0\], \{/);
-  assert.match(template, /className: 'story-flow-token'/);
-  assert.match(template, /duration: '0\.78s'/);
-  assert.match(template, /carrier\.setAttribute\('data-story-beat-step', String\(step\.index\)\)/);
-  assert.match(template, /carrierOverlay\.setAttribute\('data-story-carrier-overlay', ''\)/);
-  assert.match(template, /carrierWrapper\.appendChild\(carrier\)/);
-  assert.match(template, /svg\.insertBefore\(carrierOverlay, firstNode\)/);
-  assert.match(template, /semantic-flow-token-halo/);
-  assert.doesNotMatch(template, /story-flow-token[^}]+infinite/);
-});
-
-test('only explicit play=1 embeds may show the finite carrier', () => {
-  assert.match(template, /data-embed'\) === 'true' &&\s*document\.documentElement\.getAttribute\('data-share-playback'\) !== 'true'/);
-  assert.match(template, /autoplayPending = sharePlaybackRequested\(\)/);
-  assert.match(template, /document\.documentElement\.setAttribute\('data-share-playback', 'true'\)/);
-  assert.match(template, /html\[data-motion="still"\] \.story-carrier-overlay/);
-  assert.match(template, /html\[data-document-hidden="true"\] \.story-carrier-overlay/);
-  assert.match(template, /@media \(prefers-reduced-motion: reduce\)[\s\S]+\.story-carrier-overlay \{ display: none !important; \}/);
-});
-
-test('Story Carrier cleanup and export remain owned by Story Trail', () => {
-  assert.match(template, /svg\.querySelectorAll\('\[data-story-carrier-overlay\]'\)/);
-  assert.match(template, /overlay\.remove\(\)/);
-  assert.match(template, /var pulseGeneration = storyPulseGeneration/);
-  assert.match(template, /if \(pulseGeneration === storyPulseGeneration\) clearStoryPulse\(\)/);
-  assert.equal((template.match(/storyPulseOwnerToken = Archify\.motionGovernor\.claim\('story'/g) || []).length, 1);
-  assert.match(template, /clone\.querySelectorAll\('\[data-story-overlay\], \[data-story-carrier-overlay\]'\)/);
-  assert.match(template, /@media print \{[\s\S]+\.story-trail-overlay,[\s\S]+\.story-carrier-overlay \{ display: none !important; \}/);
-});
-
-process.on('exit', () => fs.rmSync(tmp, { recursive: true, force: true }));

package/template/.hermes/skills/archify/test/story-director-strip.test.mjs

@@ -1,91 +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 template = fs.readFileSync(path.join(skillRoot, 'assets', 'template.html'), 'utf8');
-const tmp = fs.mkdtempSync(path.join(os.tmpdir(), 'archify-story-director-strip-'));
-
-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 viewer-only Story Director Strip', () => {
-  for (const [mode, example] of Object.entries(CASES)) {
-    const html = render(mode, example);
-    assert.match(html, /id="guided-story-caption" hidden aria-live="polite" aria-atomic="true"/, mode);
-    assert.match(html, /function renderStoryCaption\(step, total, nextStep\)/, mode);
-    assert.match(html, /storyCaptionRoute\.textContent = storyCaptionRouteCopy\(step\)/, mode);
-    assert.match(html, /storyCaptionDetail\.textContent = storyCaptionDetailCopy\(step\)/, mode);
-    assert.doesNotMatch(canonicalSvg(html), /guided-story-caption|data-story-caption/, mode);
-  }
-});
-
-test('captions derive only authored edge labels and existing node facts', () => {
-  assert.match(template, /edgeLabels: edges\.map\(function \(edge\) \{ return edge\.getAttribute\('data-edge-label'\) \|\| ''; \}\)/);
-  assert.match(template, /responsibility: node \? \(node\.getAttribute\('data-node-sublabel'\) \|\| ''\) : ''/);
-  assert.match(template, /context: node \? \(node\.getAttribute\('data-node-context'\) \|\| ''\) : ''/);
-  assert.match(template, /step\.edgeLabels\.slice\(0, 3\)\.join\(' \+ '\)/);
-  assert.match(template, /viewerText\('viewer\.guided\.caption\.grouped'\)/);
-  assert.match(template, /if \(!facts\.length\) facts\.push\(viewerText\('viewer\.guided\.caption\.starting'\)\)/);
-  assert.match(template, /viewerText\('viewer\.guided\.caption\.direction'/);
-  assert.doesNotMatch(template, /inferred relationship|likely transition|calls service/);
-});
-
-test('route copy preserves start, forward, reverse, multiple, and grouped semantics', () => {
-  assert.match(template, /viewerText\('viewer\.guided\.beat\.start'/);
-  assert.match(template, /viewerText\('viewer\.guided\.beat\.forward'/);
-  assert.match(template, /viewerText\('viewer\.guided\.beat\.reverse'/);
-  assert.match(template, /viewerText\('viewer\.guided\.beat\.multiple'/);
-  assert.match(template, /viewerText\('viewer\.guided\.beat\.group'/);
-});
-
-test('playback announcements and motion remain reader-controlled', () => {
-  assert.match(template, /storyCaption\.setAttribute\('aria-live', playing \? 'off' : 'polite'\)/);
-  assert.match(template, /html\[data-motion="still"\] \.guided-story-caption/);
-  assert.match(template, /@media \(prefers-reduced-motion: reduce\) \{\s*\.guided-story-caption \{ animation: none !important; \}/);
-  assert.match(template, /animation: archify-story-caption-in 140ms/);
-});
-
-test('Presentation playback removes secondary chrome without hiding Pause or navigation', () => {
-  assert.match(template, /\.guided-views\[data-story-beat\] \.guided-view-copy > #guided-view-label/);
-  assert.match(template, /@media \(min-width: 721px\)[\s\S]*\.guided-views\[data-playing="true"\] \.guided-view-index/);
-  assert.match(template, /\.guided-views\[data-playing="true"\] \.guided-view-beat-link/);
-  assert.match(template, /\.guided-views\[data-playing="true"\] \.guided-view-all/);
-  const presentationRule = template.match(/@media \(min-width: 721px\) \{([\s\S]*?)\n    \}/)?.[1] || '';
-  assert.doesNotMatch(presentationRule, /guided-view-play/);
-  assert.doesNotMatch(presentationRule, /guided-view-prev|guided-view-next/);
-  assert.match(template, /@media \(max-width: 720px\)[\s\S]*\.guided-views > #guided-view-prev,[\s\S]*height: 2\.75rem/);
-  assert.match(template, /@media \(max-width: 720px\)[\s\S]*\.guided-view-play,[\s\S]*\.guided-view-beat-link \{ min-height: 2\.75rem; \}/);
-});
-
-test('embed, print, and canonical export boundaries stay clean', () => {
-  assert.match(template, /html\[data-embed="true"\] \.guided-views \{ display: none !important; \}/);
-  assert.match(template, /@media print[\s\S]*\.guided-views/);
-  assert.doesNotMatch(canonicalSvg(render('workflow', CASES.workflow)), /Story Director|guided-story-caption|data-story-caption/);
-});
-
-process.on('exit', () => fs.rmSync(tmp, { recursive: true, force: true }));

package/template/.hermes/skills/archify/test/story-follow-camera.test.mjs

@@ -1,103 +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 template = fs.readFileSync(path.join(skillRoot, 'assets', 'template.html'), 'utf8');
-const tmp = fs.mkdtempSync(path.join(os.tmpdir(), 'archify-story-follow-camera-'));
-
-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 viewer-only Story Follow Camera', () => {
-  for (const [mode, example] of Object.entries(CASES)) {
-    const html = render(mode, example);
-    assert.match(html, /function followStoryStep\(step, options\)/, mode);
-    assert.match(html, /panel\.setAttribute\('data-story-follow', 'moving'\)/, mode);
-    assert.match(html, /panel\.setAttribute\('data-story-follow-node', step\.nodeId\)/, mode);
-    assert.doesNotMatch(canonicalSvg(html), /data-story-follow/, mode);
-  }
-});
-
-test('Story Follow frames the exact previous, current, and next authored stops through the shared camera', () => {
-  assert.match(template, /function storyFrameIds\(step\)/);
-  assert.match(template, /step\.index > 0 && storySteps\[step\.index - 1\]/);
-  assert.match(template, /ids\.push\(step\.nodeId\)/);
-  assert.match(template, /step\.index \+ 1 < storySteps\.length/);
-  assert.match(template, /var ids = storyFrameIds\(step\)/);
-  assert.match(template, /Archify\.view\.reveal\(ids, \{/);
-  assert.match(template, /reason: options\.manual === true \? 'story-beat' : 'story-follow'/);
-  assert.match(template, /padding: 64/);
-  assert.match(template, /maxScale: 1\.65/);
-  assert.match(template, /duration: STORY_FOLLOW_DURATION_MS/);
-  assert.match(template, /storyFollowGeneration/);
-  assert.match(template, /generation !== storyFollowGeneration \|\| storyBeatIndex !== step\.index/);
-});
-
-test('playback and deliberate beat activation follow while stable moment restoration stays calm', () => {
-  assert.match(template, /setStoryBeat\(0, \{ pulse: true, follow: true \}\)/);
-  assert.match(template, /setStoryBeat\(storyBeatIndex \+ 1, \{ pulse: true, follow: true \}\)/);
-  assert.match(template, /if \(storyBeatIndex >= 0\) followStoryStep\(storySteps\[storyBeatIndex\]\)/);
-  assert.match(template, /setStoryBeat\(index, \{ manual: true, center: true, pulse: true, follow: true \}\)/);
-  assert.match(template, /follow: options\.follow === true/);
-  assert.match(template, /selectStoryBeatById\(requestedBeat, \{ linked: true, follow: true, followInstant: true \}\)/);
-  assert.match(template, /if \(embed && !explicitEmbedPlayback && options\.linked !== true\) return false/);
-  assert.match(template, /var deferredGeneration = \+\+storyFollowGeneration/);
-  assert.match(template, /requestAnimationFrame\(function \(\) \{[\s\S]*?storyBeatIndex !== deferredIndex[\s\S]*?followStoryStep\(step, options\)/);
-});
-
-test('adaptive dwell, Still, reduced motion, hidden pages, and print keep camera motion bounded', () => {
-  assert.match(template, /var STORY_FOLLOW_MIN_DWELL_MS = 1100/);
-  assert.match(template, /var STORY_FOLLOW_DURATION_MS = 320/);
-  assert.match(template, /Math\.max\(STORY_FOLLOW_MIN_DWELL_MS, VIEW_INTERVAL_MS \/ Math\.max\(1, total\)\)/);
-  assert.match(template, /storyBeatDwellMs = storyBeatDwell\(total\)/);
-  assert.match(template, /if \(!step \|\| document\.hidden/);
-  assert.match(template, /window\.matchMedia\('print'\)\.matches/);
-  assert.match(template, /instant: options\.instant === true \|\| reducedMotion\(\) \|\| document\.documentElement\.getAttribute\('data-motion'\) !== 'live'/);
-  assert.match(template, /function storyAutomaticPlaybackAllowed\(\)/);
-  assert.match(template, /Archify\.motionGovernor && Archify\.motionGovernor\.capable\) return !Archify\.motionGovernor\.isPaused\(\)/);
-  assert.match(template, /play\.disabled = !playing && !automaticPlaybackAllowed/);
-  assert.match(template, /'viewer\.guided\.motionUnavailable'/);
-  assert.match(template, /function startPlayback\(\) \{[\s\S]*?if \(!storyAutomaticPlaybackAllowed\(\)\)/);
-  assert.match(template, /if \(shouldPlay && svg\.getAttribute\('data-story-playing'\) !== 'true'\)/);
-  assert.match(template, /else if \(!shouldPlay && svg\.hasAttribute\('data-story-playing'\)\)/);
-  assert.doesNotMatch(template, /storyFollowTimer = setInterval/);
-});
-
-test('pause, settle, overview, and manual camera takeover cancel Story Follow state', () => {
-  assert.match(template, /function clearStoryFollow\(\)/);
-  assert.match(template, /svg\.removeAttribute\('data-story-follow'\)/);
-  assert.match(template, /panel\.removeAttribute\('data-story-follow'\)/);
-  assert.match(template, /function pausePlayback\(options\)[\s\S]*?clearStoryFollow\(\)/);
-  assert.match(template, /function settleStoryBeats\(\)[\s\S]*?clearStoryFollow\(\)/);
-  assert.match(template, /function clearStoryTrail\(\)[\s\S]*?clearStoryFollow\(\)/);
-  assert.match(template, /function interruptCamera\(reason\)[\s\S]*?Archify\.guidedViews\.pause\(\)/);
-  assert.match(template, /clone\.removeAttribute\('data-story-follow'\)/);
-  assert.match(template, /!clone\.hasAttribute\('data-story-follow'\)/);
-});
-
-process.on('exit', () => fs.rmSync(tmp, { recursive: true, force: true }));

package/template/.hermes/skills/archify/test/story-horizon.test.mjs

@@ -1,89 +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 template = fs.readFileSync(path.join(skillRoot, 'assets', 'template.html'), 'utf8');
-const tmp = fs.mkdtempSync(path.join(os.tmpdir(), 'archify-story-horizon-'));
-
-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`);
-  const result = spawnSync(process.execPath, [
-    path.join(skillRoot, `renderers/${mode}/render-${mode}.mjs`),
-    path.join(skillRoot, 'examples', example),
-    output,
-  ], { encoding: 'utf8' });
-  return { result, html: fs.existsSync(output) ? fs.readFileSync(output, 'utf8') : '' };
-}
-
-test('all five renderers inherit one viewer-only Story Horizon', () => {
-  for (const [mode, example] of Object.entries(CASES)) {
-    const { result, html } = render(mode, example);
-    assert.equal(result.status, 0, result.stderr);
-    assert.match(html, /data-story-beat-state="next"/, mode);
-    assert.match(html, /step === storyBeatIndex \+ 1/, mode);
-    assert.match(html, /svg\.setAttribute\('data-story-next', nextStep\.nodeId\)/, mode);
-    assert.match(html, /panel\.setAttribute\('data-story-next', nextStep\.nodeId\)/, mode);
-    assert.match(html, /id="guided-story-caption-next" hidden aria-hidden="true"/, mode);
-    const generatedSvg = html.match(/<svg\b[\s\S]*?<\/svg>/)?.[0] || '';
-    assert.doesNotMatch(generatedSvg, /data-story-next|data-story-beat-state="next"/, mode);
-  }
-});
-
-test('the temporal hierarchy has one bounded next state and a clean final beat', () => {
-  assert.match(template, /if \(step < storyBeatIndex\) return 'past'/);
-  assert.match(template, /if \(step === storyBeatIndex\) return 'active'/);
-  assert.match(template, /if \(step === storyBeatIndex \+ 1\) return 'next'/);
-  assert.match(template, /return 'pending'/);
-  assert.match(template, /storyBeatIndex \+ 1 < storySteps\.length \? storySteps\[storyBeatIndex \+ 1\] : null/);
-  assert.match(template, /else \{\s*svg\.removeAttribute\('data-story-next'\);\s*panel\.removeAttribute\('data-story-next'\)/);
-  assert.match(template, /storyCaptionNext\.hidden = !nextStep/);
-});
-
-test('next edges reuse exact authored step membership without synthesizing topology', () => {
-  assert.match(template, /storySteps\.forEach\(function \(step\) \{\s*step\.edges\.forEach/);
-  assert.match(template, /edge\.setAttribute\('data-story-beat-step', String\(edgeBeat\)\)/);
-  assert.match(template, /edge\.setAttribute\('data-story-beat-state', storyBeatState\(step\)\)/);
-  assert.match(template, /index === 0 \? 'start' : \(!edges\.length \? 'group'/);
-  assert.match(template, /edges\.length === 1 && forward\.length === 1 \? 'forward'/);
-  assert.match(template, /edges\.length === 1 && reverse\.length === 1 \? 'reverse' : 'multiple'/);
-  assert.doesNotMatch(template, /createElementNS\([^\n]+story-horizon|data-story-horizon-edge/);
-});
-
-test('next remains static, subordinate, preset-safe, and mobile-height neutral', () => {
-  assert.match(template, /data-story-step\]\[data-story-beat-state="next"\] \{\s*opacity: 0\.5;\s*filter: saturate\(0\.66\)/);
-  assert.match(template, /data-story-beat-state="past"\] \{\s*opacity: 0\.72/);
-  assert.match(template, /data-edge-from\]\[data-story-beat-step\]\[data-story-beat-state="next"\] \{ opacity: 0\.34; \}/);
-  assert.match(template, /guided-view-stop\[data-story-beat-state="next"\][\s\S]*border-style: dashed/);
-  assert.match(template, /@media \(max-width: 720px\)[\s\S]*\.guided-story-caption-next \{ display: none; \}/);
-  const nextRules = template.match(/[^\n{]*data-story-beat-state="next"[^\n{]*\{[^}]*\}/g)?.join('\n') || '';
-  assert.doesNotMatch(nextRules, /animation:|drop-shadow|stroke-dasharray/);
-});
-
-test('Still, accessibility, teardown, and export preserve the product boundary', () => {
-  assert.match(template, /id="guided-story-caption-next" hidden aria-hidden="true"/);
-  assert.match(template, /storyCaption\.setAttribute\('aria-live', playing \? 'off' : 'polite'\)/);
-  assert.doesNotMatch(template, /storyCaptionNext\.setAttribute\('aria-live'/);
-  assert.match(template, /html\[data-motion="still"\] \[data-story-step\]/);
-  assert.match(template, /html\[data-motion="still"\] svg \[data-node-id\][\s\S]*transition: none !important/);
-  assert.match(template, /@media \(prefers-reduced-motion: reduce\)[\s\S]*\.story-trail-flow/);
-  assert.ok((template.match(/svg\.removeAttribute\('data-story-next'\)/g) || []).length >= 3);
-  assert.ok((template.match(/panel\.removeAttribute\('data-story-next'\)/g) || []).length >= 2);
-  assert.match(template, /clone\.removeAttribute\('data-story-next'\)/);
-  assert.match(template, /canonicalStateClean[\s\S]*!clone\.hasAttribute\('data-story-next'\)/);
-});
-
-process.on('exit', () => fs.rmSync(tmp, { recursive: true, force: true }));

package/template/.hermes/skills/archify/test/story-moment-link.test.mjs

@@ -1,93 +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 template = fs.readFileSync(path.join(skillRoot, 'assets', 'template.html'), 'utf8');
-const tmp = fs.mkdtempSync(path.join(os.tmpdir(), 'archify-story-moment-link-'));
-
-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`);
-  const result = spawnSync(process.execPath, [
-    path.join(skillRoot, `renderers/${mode}/render-${mode}.mjs`),
-    path.join(skillRoot, 'examples', example),
-    output,
-  ], { encoding: 'utf8' });
-  return { result, html: fs.existsSync(output) ? fs.readFileSync(output, 'utf8') : '' };
-}
-
-function canonicalSvg(html) {
-  return html.match(/<svg\b[\s\S]*?<\/svg>/)?.[0] || '';
-}
-
-test('all five renderers inherit one viewer-only Story Moment Link control', () => {
-  for (const [mode, example] of Object.entries(CASES)) {
-    const { result, html } = render(mode, example);
-    assert.equal(result.status, 0, result.stderr);
-    assert.match(html, /id="guided-view-beat-link"[^>]+aria-label="Select a Story Beat to copy its exact link"[^>]+disabled/);
-    assert.match(html, /id="guided-view-beat-link-label">Copy moment<\/span>/);
-    assert.doesNotMatch(canonicalSvg(html), /data-story-moment|guided-view-beat-link|#view=/);
-  }
-});
-
-test('moment links use exact stable view and node ids without mutating manual selection URLs', () => {
-  assert.match(template, /function storyMomentLink\(\)/);
-  assert.match(template, /url\.searchParams\.delete\('play'\)/);
-  assert.match(template, /url\.hash = 'view=' \+ encodeURIComponent\(view\.id\) \+ '&beat=' \+ encodeURIComponent\(step\.nodeId\)/);
-  assert.match(template, /function selectStoryBeatById\(id, options\)/);
-  assert.match(template, /storySteps\.findIndex\(function \(step\) \{ return step\.nodeId === id; \}\)/);
-  assert.match(template, /var requestedBeat = params\.get\('beat'\)/);
-  assert.match(template, /var restoreGeneration = \+\+momentRestoreGeneration/);
-  assert.match(template, /afterHandoff\(function \(\) \{[\s\S]*restoreGeneration !== momentRestoreGeneration[\s\S]*selectStoryBeatById\(requestedBeat, \{ linked: true, follow: true, followInstant: true \}\)/);
-  const manualSelection = template.match(/function selectStoryBeat\(index\) \{([\s\S]*?)\n      function updateUrl/)?.[1] || '';
-  assert.doesNotMatch(manualSelection, /history\.|location\.|updateUrl\(/);
-});
-
-test('invalid or cross-chapter beat ids fail closed while the public receipt stays read-only', () => {
-  assert.match(template, /if \(index < 0\) return false/);
-  assert.doesNotMatch(template, /Number\(params\.get\('beat'\)\)/);
-  assert.match(template, /setStoryBeat\(index, \{[\s\S]*?manual: false,[\s\S]*?center: true,[\s\S]*?pulse: false,[\s\S]*?follow: options\.follow === true,[\s\S]*?linked: options\.linked === true,[\s\S]*?followInstant: options\.followInstant === true/);
-  assert.match(template, /beatLink: storyMomentLink/);
-  assert.match(template, /copyBeatLink: copyStoryMomentLink/);
-  assert.match(template, /beat: function \(\)[\s\S]*nodeId: step\.nodeId/);
-});
-
-test('copy feedback, one-shot playback, and reduced motion preserve the requested moment', () => {
-  assert.match(template, /navigator\.clipboard && typeof navigator\.clipboard\.writeText === 'function'/);
-  assert.match(template, /navigator\.clipboard\.writeText\(value\)/);
-  assert.match(template, /document\.execCommand\('copy'\)/);
-  assert.match(template, /beatLinkLabel\.textContent = viewerText\(copied \? 'viewer\.guided\.copied' : 'viewer\.guided\.copyFailed'\)/);
-  assert.match(template, /viewerText\(copied \? 'viewer\.guided\.momentCopied' : 'viewer\.guided\.momentCopyFailed'\)/);
-  assert.match(template, /function hashBeatMatchesCurrent\(\)/);
-  assert.match(template, /if \(!storyAutomaticPlaybackAllowed\(\)\)[\s\S]*hashBeatMatchesCurrent\(\)[\s\S]*setAutoplayState\('reduced-motion'\)/);
-  assert.match(template, /storyPlaybackScope = 'chapter'/);
-  assert.match(template, /if \(storyBeatIndex < 0\)[\s\S]*setStoryBeat\(0, \{ pulse: true, follow: true \}\)/);
-});
-
-test('the control keeps stable desktop/mobile geometry and existing viewer boundaries', () => {
-  assert.match(template, /\.guided-view-beat-link \{[\s\S]*min-height: 1\.5rem/);
-  assert.match(template, /@media \(max-width: 720px\)[\s\S]*\.guided-view-actions \{[\s\S]*grid-template-columns: repeat\(3, minmax\(0, 1fr\)\)/);
-  assert.match(template, /@media \(max-width: 720px\)[\s\S]*\.guided-view-beat-link \{[\s\S]*min-height: 2\.75rem/);
-  assert.match(template, /html\[data-embed="true"\][\s\S]*\.guided-views \{ display: none !important; \}/);
-  assert.match(template, /html\[data-embed="true"\]\[data-share-moment="true"\] \.share-chapter-cue:not\(\[hidden\]\)/);
-  assert.match(template, /pinnedMode = !shareMode && embedMode && hashBeatMatchesCurrent\(\)/);
-  assert.match(template, /pinned: viewerText\('viewer\.guided\.state\.pinned'\)/);
-  assert.match(template, /@media print[\s\S]*\.guided-views/);
-  assert.match(template, /syncStoryControlsDisabled\(\)[\s\S]*beatLink\.disabled =/);
-  assert.match(template, /clone\.querySelectorAll\('\[data-story-overlay\], \[data-story-carrier-overlay\]'\)/);
-});
-
-process.on('exit', () => fs.rmSync(tmp, { recursive: true, force: true }));

package/template/.hermes/skills/archify/test/story-shelf.test.mjs

@@ -1,84 +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 template = fs.readFileSync(path.join(skillRoot, 'assets/template.html'), 'utf8');
-const tmp = fs.mkdtempSync(path.join(os.tmpdir(), 'archify-story-shelf-'));
-
-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 compact cold-open Story Shelf', () => {
-  for (const mode of Object.keys(CASES)) {
-    const html = render(mode);
-    assert.match(html, /\.guided-views\[data-active-view="all"\]\s*\{/, mode);
-    assert.match(html, /panel\.setAttribute\('data-active-view', view \? view\.id : 'all'\)/, mode);
-    assert.doesNotMatch(canonicalSvg(html), /Story Shelf|data-active-view|guided-view-index/, mode);
-  }
-});
-
-test('cold shelf keeps chapter identity and Play while removing only unavailable duplicate controls', () => {
-  assert.match(template, /\.guided-views\[data-active-view="all"\] > #guided-view-prev,[\s\S]*#guided-view-next,[\s\S]*\.guided-view-beat-link,[\s\S]*\.guided-view-all\s*\{\s*display: none;\s*\}/);
-  assert.doesNotMatch(template, /\.guided-views\[data-active-view="all"\][^{]*(?:\.guided-view-play|\.guided-view-index)[^{]*\{\s*display:\s*none/);
-  assert.match(template, /<button class="guided-view-play"/);
-  assert.match(template, /<nav class="guided-view-index"/);
-});
-
-test('desktop shelf follows DOM order and returns vertical space to the diagram', () => {
-  const rule = template.match(/\.guided-views\[data-active-view="all"\]\s*\{([^}]*)\}/)?.[1] || '';
-  assert.match(rule, /grid-template-columns:\s*minmax\(11rem,\s*\.72fr\)\s+auto\s+minmax\(0,\s*2fr\)/);
-  assert.match(template, /\.guided-views\[data-active-view="all"\] \.guided-view-copy\s*\{[^}]*grid-column:\s*1/);
-  assert.match(template, /\.guided-views\[data-active-view="all"\] \.guided-view-actions\s*\{[^}]*grid-column:\s*2/);
-  assert.match(template, /\.guided-views\[data-active-view="all"\] \.guided-view-index\s*\{[^}]*grid-column:\s*3/);
-  assert.match(template, /\.guided-views\[data-active-view="all"\] \.guided-view-copy > #guided-view-note\s*\{\s*display:\s*none/);
-});
-
-test('mobile shelf preserves 44px controls, horizontal chapters, and honest expansion', () => {
-  assert.match(template, /@media \(max-width: 720px\)[\s\S]*\.guided-views\[data-active-view="all"\][\s\S]*grid-template-columns:\s*minmax\(0,\s*1fr\)\s+auto/);
-  assert.match(template, /\.guided-views\[data-active-view="all"\] \.guided-view-index\s*\{[^}]*grid-column:\s*1 \/ -1;[^}]*grid-row:\s*2/);
-  assert.match(template, /\.guided-views\[data-active-view="all"\] \.guided-view-play\s*\{[^}]*min-height:\s*2\.75rem/);
-  assert.match(template, /\.guided-view-chapters\s*\{[^}]*overflow-x:\s*auto/);
-  assert.match(template, /\.guided-view-chapter\s*\{[^}]*min-height:\s*2\.75rem/);
-});
-
-test('active stories expand through existing state without storage or a second interaction owner', () => {
-  assert.match(template, /panel\.setAttribute\('data-active-view', 'all'\);\s*panel\.hidden = false/);
-  assert.match(template, /data-active-view', view \? view\.id : 'all'/);
-  assert.match(template, /if \(activeIndex < 0\) activate\(0, \{ playback: true \}\)/);
-  assert.match(template, /showAll\([\s\S]*activeIndex = -1;[\s\S]*render\(\)/);
-  assert.doesNotMatch(template, /storyShelf(?:Open|Expanded|Storage)|archify-story-shelf|localStorage[^\n]*shelf/i);
-});
-
-test('Story Shelf remains viewer-only, embed-safe, print-safe, and motion-neutral', () => {
-  assert.match(template, /html\[data-embed="true"\] \.guided-views \{ display: none !important; \}/);
-  assert.match(template, /\.toolbar, \.diagram-nav, \.focus-chip, \.guided-views, \.archify-toast, \.no-print \{ display: none !important; \}/);
-  assert.doesNotMatch(canonicalSvg(render('workflow')), /Story Shelf|guided-view|data-active-view/);
-  assert.doesNotMatch(template, /@keyframes\s+archify-story-shelf|animation:[^;]*story-shelf/i);
-});
-
-process.on('exit', () => fs.rmSync(tmp, { recursive: true, force: true }));

package/template/.hermes/skills/archify/test/story-trail.test.mjs

@@ -1,81 +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-story-trail-'));
-
-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`);
-  const result = spawnSync(process.execPath, [
-    path.join(skillRoot, `renderers/${mode}/render-${mode}.mjs`),
-    path.join(skillRoot, 'examples', example),
-    output,
-  ], { encoding: 'utf8' });
-  return { result, html: fs.existsSync(output) ? fs.readFileSync(output, 'utf8') : '' };
-}
-
-for (const [mode, example] of Object.entries(CASES)) {
-  test(`${mode}: guided paths expose a viewer-only Story Trail`, () => {
-    const { result, html } = render(mode, example);
-    assert.equal(result.status, 0, result.stderr);
-    assert.match(html, /id="guided-view-trail" hidden role="group" aria-label="Story trail"/);
-    assert.match(html, /function renderStoryTrail\(view\)/);
-    assert.match(html, /document\.createElement\('button'\)/);
-    assert.match(html, /stop\.type = 'button'/);
-    assert.match(html, /data-story-node/);
-    assert.match(html, /data-story-link/);
-    assert.match(html, /edges\.length === 1 && forward\.length === 1 \? 'forward'/);
-    assert.match(html, /data-story-overlay/);
-    assert.match(html, /data-story-playing/);
-    assert.match(html, /data-story-beat/);
-    assert.match(html, /data-story-beat-state/);
-    assert.match(html, /data-story-beat-step/);
-    assert.match(html, /storySteps\.forEach\(function \(step\)/);
-    assert.match(html, /step\.edges\.forEach\(function \(edge\)/);
-    assert.match(html, /edge\.setAttribute\('data-story-beat-step', String\(edgeBeat\)\)/);
-    assert.match(html, /svg\[data-story-beat\] \[data-edge-from\]\[data-story-beat-step\]/);
-    assert.match(html, /story-trail-flow/);
-    assert.match(html, /function scheduleStoryPlayback\(\)/);
-    assert.match(html, /storyBeatTimer = setTimeout/);
-    assert.match(html, /storyBeatDwellMs = storyBeatDwell\(total\)/);
-    assert.match(html, /Math\.max\(STORY_FOLLOW_MIN_DWELL_MS, VIEW_INTERVAL_MS \/ Math\.max\(1, total\)\)/);
-    assert.match(html, /function storyStep\(view, index, edgeList, byId\)/);
-    assert.match(html, /prefers-reduced-motion: reduce/);
-    assert.match(html, /from === previousId && to === id/);
-    assert.match(html, /from === id && to === previousId/);
-    assert.match(html, /firstEdge\.parentNode\.insertBefore\(overlay, firstEdge\)/);
-    assert.doesNotMatch(html, /content: '\\2192';\s*font-size: 0\.65rem/);
-
-    const generatedSvg = html.match(/<svg\b[\s\S]*?<\/svg>/)?.[0] || '';
-    assert.doesNotMatch(generatedSvg, /data-story-(?:active|playing|beat|step|overlay|carrier)/);
-  });
-}
-
-test('Story Trail state is removed from every export clone', () => {
-  const template = fs.readFileSync(path.join(skillRoot, 'assets', 'template.html'), 'utf8');
-  assert.match(template, /clone\.removeAttribute\('data-story-active'\)/);
-  assert.match(template, /clone\.removeAttribute\('data-story-playing'\)/);
-  assert.match(template, /clone\.removeAttribute\('data-story-beat'\)/);
-  assert.match(template, /clone\.querySelectorAll\('\[data-story-overlay\], \[data-story-carrier-overlay\]'\)/);
-  assert.match(template, /clone\.querySelectorAll\('\[data-story-step\], \[data-story-beat-state\], \[data-story-beat-step\]'\)/);
-  assert.match(template, /el\.removeAttribute\('data-story-beat-state'\)/);
-  assert.match(template, /el\.removeAttribute\('data-story-beat-step'\)/);
-  assert.match(template, /el\.style\.removeProperty\('--story-step'\)/);
-  assert.match(template, /canonicalStateClean[\s\S]*data-story-beat-state/);
-});
-
-process.on('exit', () => fs.rmSync(tmp, { recursive: true, force: true }));