create-yss-spec 2.2.10 → 3.0.1

package/template/.hermes/skills/archify/test/real-repository-proof.test.mjs

@@ -1,209 +0,0 @@
-import { test } from 'node:test';
-import assert from 'node:assert/strict';
-import { execFileSync, 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';
-import { verifyRepositoryEvidence } from '../renderers/shared/repository-evidence.mjs';
-
-const __dirname = path.dirname(fileURLToPath(import.meta.url));
-const skillRoot = path.resolve(__dirname, '..');
-const repoRoot = path.resolve(skillRoot, '..');
-const sourcePath = path.join(repoRoot, 'docs', 'cases', 'mco-runtime.architecture.json');
-const artifactPath = path.join(repoRoot, 'docs', 'cases', 'mco-runtime.architecture.html');
-const shareCardPath = path.join(repoRoot, 'docs', 'assets', 'mco-runtime-share-card.png');
-const experimentSourcePath = path.join(repoRoot, 'experiments', 'mco-showcase', 'mco-runtime.architecture.json');
-const experimentArtifactPath = path.join(repoRoot, 'experiments', 'mco-showcase', 'mco-runtime.html');
-const cli = path.join(skillRoot, 'bin', 'archify.mjs');
-const pinnedSource = JSON.parse(fs.readFileSync(sourcePath, 'utf8'));
-const pinnedRepository = pinnedSource.meta.repository;
-
-function evidencePayload(html) {
-  const match = html.match(/<script id="archify-source-evidence-data" type="application\/json">([\s\S]*?)<\/script>/);
-  assert.ok(match, 'checked-in MCO proof is missing verified repository evidence');
-  return JSON.parse(match[1]);
-}
-
-function connectionLabelGeometry(html) {
-  return Object.fromEntries([...html.matchAll(
-    /<g data-detail="context"[^>]*data-edge-id="([^"]+)"[^>]*>[\s\S]*?<text x="([^"]+)" y="([^"]+)"/g,
-  )].map((match) => [match[1], { x: Number(match[2]), y: Number(match[3]) }]));
-}
-
-function automaticMcoRoot() {
-  const candidate = path.resolve(repoRoot, '..', 'mco');
-  if (!fs.existsSync(path.join(candidate, '.git'))) return null;
-  try {
-    verifyRepositoryEvidence('architecture', pinnedSource, candidate);
-    return candidate;
-  } catch {
-    return null;
-  }
-}
-
-const pinnedMcoRoot = process.env.ARCHIFY_MCO_REPO_ROOT
-  ? path.resolve(process.env.ARCHIFY_MCO_REPO_ROOT)
-  : automaticMcoRoot();
-
-test('MCO showcase preserves checked-in connection-label geometry', () => {
-  const tmp = fs.mkdtempSync(path.join(os.tmpdir(), 'archify-mco-showcase-layout-'));
-  try {
-    const source = JSON.parse(fs.readFileSync(experimentSourcePath, 'utf8'));
-    assert.deepEqual(
-      source.meta.repository,
-      pinnedRepository,
-      'MCO case and experiment must pin the same repository revision',
-    );
-    delete source.meta.repository;
-    for (const component of source.components) delete component.sources;
-    const input = path.join(tmp, 'mco-runtime.architecture.json');
-    const output = path.join(tmp, 'mco-runtime.html');
-    fs.writeFileSync(input, `${JSON.stringify(source, null, 2)}\n`);
-
-    const rendered = spawnSync(process.execPath, [
-      cli,
-      'render',
-      'architecture',
-      input,
-      output,
-      '--quality',
-      'showcase',
-    ], { encoding: 'utf8' });
-    assert.equal(rendered.status, 0, `${rendered.stdout}\n${rendered.stderr}`);
-
-    const renderedHtml = fs.readFileSync(output, 'utf8');
-    const checkedInHtml = fs.readFileSync(experimentArtifactPath, 'utf8');
-    const renderedLabels = connectionLabelGeometry(renderedHtml);
-    assert.ok(Object.keys(renderedLabels).length >= 8, 'expected the authored MCO connection labels');
-    assert.deepEqual(
-      connectionLabelGeometry(checkedInHtml),
-      renderedLabels,
-      'checked-in MCO connection-label geometry drifted from its typed source',
-    );
-
-  } finally {
-    fs.rmSync(tmp, { recursive: true, force: true });
-  }
-});
-
-test('checked-in MCO artifacts are byte-reproducible from the pinned repository revision', {
-  skip: pinnedMcoRoot
-    ? false
-    : `Set ARCHIFY_MCO_REPO_ROOT to a matching ${pinnedRepository.url} clone containing revision ${pinnedRepository.revision.slice(0, 7)}.`,
-}, () => {
-  const tmp = fs.mkdtempSync(path.join(os.tmpdir(), 'archify-mco-byte-reproduction-'));
-  try {
-    const experimentOutput = path.join(tmp, 'mco-runtime.experiment.html');
-    const experiment = spawnSync(process.execPath, [
-      cli,
-      'render',
-      'architecture',
-      experimentSourcePath,
-      experimentOutput,
-      '--quality',
-      'showcase',
-      '--repo-root',
-      pinnedMcoRoot,
-    ], { encoding: 'utf8' });
-    assert.equal(experiment.status, 0, `${experiment.stdout}\n${experiment.stderr}`);
-    assert.equal(
-      fs.readFileSync(experimentOutput, 'utf8'),
-      fs.readFileSync(experimentArtifactPath, 'utf8'),
-      'checked-in MCO showcase drifted from its typed source and verified repository',
-    );
-
-    const caseOutput = path.join(tmp, 'mco-runtime.case.html');
-    const delivered = spawnSync(process.execPath, [
-      cli,
-      'deliver',
-      'architecture',
-      sourcePath,
-      caseOutput,
-      '--quality',
-      'showcase',
-      '--repo-root',
-      pinnedMcoRoot,
-      '--json',
-    ], { encoding: 'utf8' });
-    assert.equal(delivered.status, 0, `${delivered.stdout}\n${delivered.stderr}`);
-    assert.equal(JSON.parse(delivered.stdout).ok, true);
-    assert.equal(
-      fs.readFileSync(caseOutput, 'utf8'),
-      fs.readFileSync(artifactPath, 'utf8'),
-      'checked-in MCO case drifted from its typed source and verified repository',
-    );
-  } finally {
-    fs.rmSync(tmp, { recursive: true, force: true });
-  }
-});
-
-test('MCO public proof is source-backed, valid, and linked from every README', () => {
-  const source = JSON.parse(fs.readFileSync(sourcePath, 'utf8'));
-  assert.equal(source.meta.title, 'MCO Runtime Architecture');
-  assert.equal(source.meta.quality_profile, 'showcase');
-  assert.equal(source.meta.animation, 'trace');
-  assert.deepEqual(source.meta.views.map(view => view.id), [
-    'dispatch-path',
-    'answer-evidence',
-    'durable-sessions',
-  ]);
-  assert.equal(source.components.length, 13);
-  assert.equal(source.connections.length, 12);
-  assert.match(source.components.find((component) => component.id === 'router')?.sublabel || '', /\bdoctor\b/);
-  assert.match(source.components.find((component) => component.id === 'adapters')?.sublabel || '', /\bdetect\b/);
-  assert.match(source.meta.repository.url, /^https:\/\/github\.com\/[^/]+\/[^/]+$/);
-  assert.match(source.meta.repository.revision, /^[0-9a-f]{40}$/);
-  const references = source.components.reduce((count, component) => count + (component.sources?.length || 0), 0);
-  assert.equal(references, 13);
-  const cardCopy = JSON.stringify(source.cards);
-  assert.ok(cardCopy.includes(`main @ ${source.meta.repository.revision.slice(0, 7)}`));
-  assert.ok(cardCopy.includes(new URL(source.meta.repository.url).host + new URL(source.meta.repository.url).pathname));
-
-  const checkedInHtml = fs.readFileSync(artifactPath, 'utf8');
-  const evidence = evidencePayload(checkedInHtml);
-  assert.equal(evidence.verified, true);
-  assert.equal(evidence.repository.url, source.meta.repository.url);
-  assert.equal(evidence.repository.revision, source.meta.repository.revision);
-  assert.equal(evidence.repository.shortRevision, source.meta.repository.revision.slice(0, 7));
-  assert.equal(evidence.referenceCount, references);
-  assert.match(checkedInHtml, /Archify\.sourceEvidence\.installBeacons\(\)/);
-  execFileSync(process.execPath, [cli, 'check', artifactPath], { encoding: 'utf8' });
-
-  const noRootTmp = fs.mkdtempSync(path.join(os.tmpdir(), 'archify-mco-proof-no-root-'));
-  try {
-    const output = path.join(noRootTmp, 'mco-runtime.html');
-    const result = spawnSync(process.execPath, [
-      cli,
-      'deliver',
-      'architecture',
-      sourcePath,
-      output,
-      '--quality',
-      'showcase',
-      '--json',
-    ], { encoding: 'utf8' });
-    assert.equal(result.status, 1);
-    assert.match(JSON.parse(result.stdout).error, /Pass --repo-root/);
-    assert.equal(fs.existsSync(output), false);
-  } finally {
-    fs.rmSync(noRootTmp, { recursive: true, force: true });
-  }
-
-  const png = fs.readFileSync(shareCardPath);
-  assert.equal(png.subarray(0, 8).toString('hex'), '89504e470d0a1a0a');
-  assert.equal(png.readUInt32BE(16), 1200);
-  assert.equal(png.readUInt32BE(20), 630);
-  assert.ok(png.byteLength > 20_000, 'MCO Share Card is unexpectedly small');
-
-  const repositorySlug = new URL(source.meta.repository.url).pathname.replace(/^\/|\/$/g, '');
-  const shortRevision = source.meta.repository.revision.slice(0, 7);
-  for (const filename of ['README.md', 'README_EN.md', 'README_ZH.md']) {
-    const readme = fs.readFileSync(path.join(repoRoot, filename), 'utf8');
-    assert.match(readme, /docs\/assets\/mco-runtime-share-card\.png/);
-    assert.match(readme, /cases\/mco-runtime\.architecture\.html\?theme=dark&present=1#view=dispatch-path/);
-    assert.match(readme, /docs\/cases\/mco-runtime\.architecture\.json/);
-    assert.ok(readme.includes(`[\`${repositorySlug}\`](${source.meta.repository.url})`), `${filename}: repository link drifted`);
-    assert.ok(readme.includes(`\`${shortRevision}\``), `${filename}: repository revision drifted`);
-  }
-});

package/template/.hermes/skills/archify/test/relationship-direct-explorer.test.mjs

@@ -1,115 +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-relationship-direct-explorer-'));
-
-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 Direct Relationship Explorer', () => {
-  for (const [mode, example] of Object.entries(CASES)) {
-    const { result, html } = render(mode, example);
-    assert.equal(result.status, 0, result.stderr);
-    assert.match(html, /function installRelationshipHitTargets\(\)/, mode);
-    assert.match(html, /data-relationship-hit-overlay/, mode);
-    assert.match(html, /className \|\| 'relationship-hit-rail'/, mode);
-    assert.doesNotMatch(canonicalSvg(html), /relationship-hit-(?:overlay|target|rail)|data-relationship-direct-active/, mode);
-  }
-});
-
-test('one roving target represents each exact stable edge key and authored direction', () => {
-  assert.match(template, /function relationshipHitRecords\(\)/);
-  assert.match(template, /var recordsByKey = \{\}/);
-  assert.match(template, /existing\.invalid = true/);
-  assert.match(template, /filter\(function \(record\) \{ return !record\.invalid/);
-  assert.match(template, /data-relationship-key/);
-  assert.match(template, /data-relationship-from/);
-  assert.match(template, /data-relationship-to/);
-  assert.match(template, /target\.setAttribute\('role', 'button'\)/);
-  assert.match(template, /relationshipHitOverlay\.setAttribute\('role', 'group'\)/);
-  assert.match(template, /target\.setAttribute\('aria-describedby', relationshipHelp\.id\)/);
-  assert.match(template, /target\.setAttribute\('tabindex', index === 0 \? '0' : '-1'\)/);
-  assert.match(template, /viewerText\('viewer\.passport\.relationship\.inspect'/);
-  assert.match(template, /relationshipEdgeShapes\(edge\)/);
-  assert.match(template, /shape\.cloneNode\(false\)/);
-  assert.match(template, /\.relationship-hit-rail \{[\s\S]*stroke: transparent;[\s\S]*stroke-width: 24/);
-});
-
-test('fine-pointer and keyboard intent preview the exact edge before activation', () => {
-  assert.match(template, /function directRelationshipBlocked\(\)/);
-  assert.match(template, /function scheduleDirectRelationshipPreview\(target\)/);
-  assert.match(template, /if \(pinnedRelationshipKey \|\| hoveredRelationship !== target/);
-  assert.match(template, /previewRelationship\(target, \{ direct: true \}\)/);
-  assert.match(template, /event\.pointerType === 'touch'/);
-  assert.match(template, /finePointerQuery && !finePointerQuery\.matches/);
-  assert.match(template, /addEventListener\('pointerover'/);
-  assert.match(template, /addEventListener\('pointerout'/);
-  assert.match(template, /addEventListener\('focusin'/);
-  assert.match(template, /addEventListener\('focusout'/);
-  assert.match(template, /data-relationship-direct-active/);
-  assert.match(template, /\.relationship-hit-target:focus-visible \.relationship-focus-rail/);
-});
-
-test('activation opens the existing source passport and pins its exact relationship row', () => {
-  assert.match(template, /function inspectRelationship\(key, options\)/);
-  assert.match(template, /if \(directPreviewTimer\) window\.clearTimeout\(directPreviewTimer\)/);
-  assert.match(template, /if \(pinnedRelationshipKey === key\)/);
-  assert.match(template, /set\(record\.from, \{ toggle: false, updateUrl: false \}\)/);
-  assert.match(template, /relationshipList\.querySelectorAll\('\[data-relationship-key\]'\)/);
-  assert.match(template, /pinnedRelationship = row/);
-  assert.match(template, /pinnedRelationshipKey = key/);
-  assert.match(template, /data-relationship-pin-active/);
-  assert.match(template, /function clearRelationshipPreview\(options\)/);
-  assert.match(template, /clearRelationshipPreview\(\{ clearPin: true \}\)/);
-  assert.match(template, /copyBtn\.textContent = viewerText\('viewer\.passport\.copyNode'\)/);
-  assert.match(template, /previewRelationship\(row\)/);
-  assert.match(template, /inspectRelationship: inspectRelationship/);
-  assert.match(template, /event\.key !== 'ArrowRight'/);
-  assert.match(template, /event\.key !== 'ArrowLeft'/);
-  assert.match(template, /event\.key !== 'Home'/);
-  assert.match(template, /event\.key !== 'End'/);
-  assert.match(template, /event\.key === 'Enter' \|\| event\.key === ' '/);
-});
-
-test('direct relationship targets support one-tap touch, yield to stronger states, and stay export-clean', () => {
-  assert.match(template, /html\.getAttribute\('data-embed'\) === 'true'/);
-  assert.match(template, /svg\.hasAttribute\('data-story-active'\)/);
-  assert.match(template, /svg\.hasAttribute\('data-route-active'\)/);
-  assert.match(template, /svg\.hasAttribute\('data-lens-active'\)/);
-  assert.match(template, /event\.target\.closest\('\[data-relationship-hit-key\]'\)/);
-  assert.match(template, /@media \(hover: none\), \(pointer: coarse\)[\s\S]*\.relationship-hit-rail \{ stroke-width: 24/);
-  assert.match(template, /@media print \{[\s\S]*\.relationship-hit-overlay/);
-  assert.match(template, /clone\.removeAttribute\('data-relationship-direct-active'\)/);
-  assert.match(template, /clone\.removeAttribute\('data-relationship-pin-active'\)/);
-  assert.match(template, /clone\.querySelectorAll\('\[data-relationship-hit-overlay\]'\)/);
-  assert.match(template, /\[data-relationship-hit-overlay\][^']*\[data-relationship-pulse-overlay\]/);
-});
-
-process.on('exit', () => fs.rmSync(tmp, { recursive: true, force: true }));

package/template/.hermes/skills/archify/test/relationship-lens.test.mjs

@@ -1,128 +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-relationship-lens-'));
-
-const CASES = {
-  architecture: { example: 'web-app.architecture.json', collection: 'connections' },
-  workflow: { example: 'agent-tool-call.workflow.json', collection: 'edges' },
-  sequence: { example: 'cache-miss-request.sequence.json', collection: 'messages' },
-  dataflow: { example: 'product-analytics.dataflow.json', collection: 'flows' },
-  lifecycle: { example: 'agent-run.lifecycle.json', collection: 'transitions' },
-};
-
-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 svg(html) {
-  return html.match(/<svg\b[\s\S]*?<\/svg>/)?.[0] || '';
-}
-
-function escapeAttr(value) {
-  return String(value)
-    .replaceAll('&', '&amp;')
-    .replaceAll('<', '&lt;')
-    .replaceAll('>', '&gt;')
-    .replaceAll('"', '&quot;')
-    .replaceAll("'", '&#39;');
-}
-
-test('all typed renderers expose named, stable relationships without changing geometry', () => {
-  for (const [mode, config] of Object.entries(CASES)) {
-    const html = render(mode, config.example);
-    const source = JSON.parse(fs.readFileSync(path.join(skillRoot, 'examples', config.example), 'utf8'));
-    const relationships = source[config.collection];
-    const diagram = svg(html);
-    const keys = new Set(Array.from(diagram.matchAll(/data-edge-key="(\d+)"/g), (match) => match[1]));
-
-    assert.equal(keys.size, relationships.length, `${mode} keeps one stable key per source relationship`);
-    relationships.forEach((relationship, index) => {
-      const expectedKey = source.schema_version === 2 ? '\\d+' : String(index);
-      assert.match(diagram, new RegExp(`data-edge-from="${escapeAttr(relationship.from)}"[^>]+data-edge-to="${escapeAttr(relationship.to)}"[^>]+data-edge-key="${expectedKey}"`), `${mode} relationship ${index}`);
-      if (relationship.label) {
-        assert.match(diagram, new RegExp(`data-edge-label="${escapeAttr(relationship.label).replace(/[.*+?^${}()|[\]\\]/g, '\\$&')}"`), `${mode} named relationship ${index}`);
-      }
-    });
-    assert.match(diagram, /data-node-id="[^"]+" data-node-label="[^"]+" tabindex="0"/, mode);
-  }
-});
-
-test('relationship lens groups incoming, outgoing, and self-loop paths and follows neighbors', () => {
-  const html = render('architecture', CASES.architecture.example);
-  assert.match(html, /id="focus-chip" hidden role="region" aria-labelledby="relationship-lens-title"/);
-  assert.match(html, /id="relationship-lens-list" aria-label="Connected relationships"/);
-  assert.match(html, /function relationshipsFor\(id, byId\)/);
-  assert.match(html, /direction = from === id && to === id \? 'loop' : \(from === id \? 'out' : 'in'\)/);
-  assert.match(html, /\{ id: 'out', label: viewerText\('viewer\.passport\.relationship\.group\.out'\) \}/);
-  assert.match(html, /\{ id: 'in', label: viewerText\('viewer\.passport\.relationship\.group\.in'\) \}/);
-  assert.match(html, /data-relationship-target/);
-  assert.match(html, /data-relationship-key/);
-  assert.match(html, /data-relationship-from/);
-  assert.match(html, /data-relationship-to/);
-  assert.match(html, /set\(id, \{ toggle: false \}\)/);
-  assert.match(html, /Archify\.view\.reveal\(\[id\], \{ includeNeighbors: true, reason: 'relationship' \}\)/);
-  assert.doesNotMatch(svg(html), /relationship-lens|Connected relationships/);
-});
-
-test('relationship preview precisely links pointer and keyboard rows to an edge and its endpoints', () => {
-  const html = render('sequence', CASES.sequence.example);
-  const diagram = svg(html);
-  assert.match(html, /function previewRelationship\(button, options\)/);
-  assert.match(html, /edge\.getAttribute\('data-edge-key'\) === key/);
-  assert.match(html, /data-relationship-preview-source/);
-  assert.match(html, /data-relationship-preview-target/);
-  assert.match(html, /addEventListener\('pointerover'/);
-  assert.match(html, /addEventListener\('pointerout'/);
-  assert.match(html, /addEventListener\('focusin'/);
-  assert.match(html, /addEventListener\('focusout'/);
-  assert.match(html, /pinnedRelationship \|\| focusedRelationship \|\| hoveredRelationship/);
-  assert.doesNotMatch(diagram, /data-relationship-preview(?:-active|-node|-source|-target)?=/);
-});
-
-test('relationship preview is export-clean and visually geometry-neutral', () => {
-  const html = render('dataflow', CASES.dataflow.example);
-  assert.match(html, /clone\.removeAttribute\('data-relationship-preview-active'\)/);
-  assert.match(html, /clone\.querySelectorAll\('\[data-relationship-preview\], \[data-relationship-preview-node\], \[data-relationship-preview-source\], \[data-relationship-preview-target\]'\)/);
-  assert.match(html, /!clone\.hasAttribute\('data-relationship-preview-active'\)/);
-  assert.match(html, /Relationship Preview is temporary exploration state layered on top of/);
-  assert.doesNotMatch(html, /data-relationship-preview[^\n{]*\{[^}]*\b(?:x|y|transform)\s*:/);
-});
-
-test('relationship lens is keyboard navigable, mobile-pinned, and excluded from embed and print', () => {
-  const html = render('workflow', CASES.workflow.example);
-  assert.match(html, /event\.key !== 'ArrowDown'/);
-  assert.match(html, /event\.key !== 'ArrowUp'/);
-  assert.match(html, /event\.key !== 'Home'/);
-  assert.match(html, /event\.key !== 'End'/);
-  assert.match(html, /buttons\[index\]\.focus\(\)/);
-  assert.match(html, /data-wide-diagram="true"\] \.focus-chip/);
-  assert.match(html, /\.focus-chip\[data-relationship-previewing="true"\] \.relationship-lens-list/);
-  assert.match(html, /\.relationship-lens-row:not\(\[data-preview-active="true"\]\)/);
-  assert.match(html, /var mobile = window\.innerWidth <= 720/);
-  assert.match(html, /previewingOnMobile = mobile && chip\.getAttribute\('data-relationship-previewing'\) === 'true'/);
-  assert.match(html, /nodeCenter < \(visibleTop \+ visibleBottom\) \/ 2 \? pinnedBottom : pinnedTop/);
-  assert.match(html, /html\[data-embed="true"\] \.focus-chip/);
-  assert.match(html, /\.toolbar, \.diagram-nav, \.focus-chip, \.guided-views/);
-  assert.match(html, /chip\.hidden = options\.hideChip === true \|\| normalized\.length !== 1 \|\| selectionMode/);
-  assert.match(html, /event\.target\.closest\('\.diagram-nav, \.focus-chip, \.node-finder, \.diagram-guide, \.overview-map, \.route-probe, \.semantic-lens'\)/);
-  assert.match(html, /function placeRelationshipLens\(\)/);
-  assert.match(html, /visibleTop = Math\.max\(padding, -containerRect\.top \+ padding\)/);
-  assert.match(html, /window\.addEventListener\('scroll', requestLensPlacement, \{ passive: true \}\)/);
-  assert.match(html, /container\.addEventListener\('scroll', requestLensPlacement, \{ passive: true \}\)/);
-});
-
-process.on('exit', () => fs.rmSync(tmp, { recursive: true, force: true }));

package/template/.hermes/skills/archify/test/relationship-permalink.test.mjs

@@ -1,130 +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-relationship-permalink-'));
-
-const CASES = {
-  architecture: { example: 'web-app.architecture.json', collection: 'connections' },
-  workflow: { example: 'agent-tool-call.workflow.json', collection: 'edges' },
-  sequence: { example: 'cache-miss-request.sequence.json', collection: 'messages' },
-  dataflow: { example: 'product-analytics.dataflow.json', collection: 'flows' },
-  lifecycle: { example: 'agent-run.lifecycle.json', collection: 'transitions' },
-};
-
-function fixture(mode) {
-  return JSON.parse(fs.readFileSync(path.join(skillRoot, 'examples', CASES[mode].example), 'utf8'));
-}
-
-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, html: fs.existsSync(output) ? fs.readFileSync(output, 'utf8') : '' };
-}
-
-function canonicalSvg(html) {
-  return html.match(/<svg\b[\s\S]*?<\/svg>/)?.[0] || '';
-}
-
-function relationshipKey(html, id) {
-  return html.match(new RegExp(`data-edge-key="(\\d+)" data-edge-id="${id}"`))?.[1] ?? null;
-}
-
-test('all typed renderers preserve optional authored relationship ids beside runtime keys', () => {
-  for (const mode of Object.keys(CASES)) {
-    const doc = fixture(mode);
-    doc[CASES[mode].collection][0].id = 'shareable-relation';
-    const { result, html } = run(mode, doc, 'stable-id');
-    assert.equal(result.status, 0, `${mode}: ${result.stderr}`);
-    assert.match(html, /data-edge-key="\d+" data-edge-id="shareable-relation"/, mode);
-    assert.match(canonicalSvg(html), /data-edge-id="shareable-relation"/, mode);
-  }
-});
-
-test('authored relationship identity and readable-v2 compiler keys survive source-order changes', () => {
-  const original = fixture('workflow');
-  const reordered = fixture('workflow');
-  const moved = reordered.edges.shift();
-  reordered.edges.splice(1, 0, moved);
-
-  const first = run('workflow', original, 'original-order');
-  const second = run('workflow', reordered, 'reordered');
-  assert.equal(first.result.status, 0, first.result.stderr);
-  assert.equal(second.result.status, 0, second.result.stderr);
-  assert.notEqual(relationshipKey(first.html, 'request-chat'), null);
-  assert.equal(
-    relationshipKey(second.html, 'request-chat'),
-    relationshipKey(first.html, 'request-chat'),
-  );
-  assert.match(first.html, /'#relation=' \+ encodeURIComponent\(record\.id\)/);
-  assert.match(second.html, /'#relation=' \+ encodeURIComponent\(record\.id\)/);
-});
-
-test('relationship ids stay optional and duplicate ids fail closed in the shared zero-install path', () => {
-  for (const mode of Object.keys(CASES)) {
-    const idless = fixture(mode);
-    delete idless[CASES[mode].collection][0].id;
-    const plain = run(mode, idless, 'idless');
-    assert.equal(plain.result.status, 0, `${mode}: ${plain.result.stderr}`);
-    const keyZeroTags = Array.from(plain.html.matchAll(/<(?:path|g)\b[^>]*data-edge-key="0"[^>]*>/g), (match) => match[0]);
-    assert.ok(keyZeroTags.length > 0, `${mode} emits runtime key zero`);
-    assert.ok(keyZeroTags.every((tag) => !tag.includes('data-edge-id=')), `${mode} does not invent a durable id`);
-
-    const duplicate = fixture(mode);
-    duplicate[CASES[mode].collection][1].id = duplicate[CASES[mode].collection][0].id;
-    const rejected = run(mode, duplicate, 'duplicate');
-    assert.notEqual(rejected.result.status, 0, mode);
-    assert.match(rejected.result.stderr, /Relationship identity validation failed/);
-    assert.match(rejected.result.stderr, /duplicates relationship id/);
-  }
-});
-
-test('relationship id syntax is schema-checked before viewer output is written', () => {
-  const doc = fixture('workflow');
-  doc.edges[0].id = 'not a stable id';
-  const { result, html } = run('workflow', doc, 'invalid-id');
-  assert.notEqual(result.status, 0);
-  assert.match(result.stderr, /\/edges\/0\/id/);
-  assert.match(result.stderr, /must match pattern/);
-  assert.equal(html, '');
-});
-
-test('the viewer restores and copies stable relation links without exposing numeric keys', () => {
-  const { result, html } = run('workflow', fixture('workflow'), 'viewer');
-  assert.equal(result.status, 0, result.stderr);
-  assert.match(html, /var edgeId = edge\.getAttribute\('data-edge-id'\) \|\| ''/);
-  assert.match(html, /target\.setAttribute\('data-relationship-id', record\.id\)/);
-  assert.match(html, /button\.setAttribute\('data-relationship-id', relationship\.id\)/);
-  assert.match(html, /copyBtn\.textContent = viewerText\('viewer\.passport\.copyRelation'\)/);
-  assert.match(html, /'#relation=' \+ encodeURIComponent\(record\.id\)/);
-  assert.match(html, /var relation = params\.get\('relation'\)/);
-  assert.match(html, /inspectRelationshipById\(relation, \{ updateUrl: false, toggle: false \}\)/);
-  assert.match(html, /if \(html\.getAttribute\('data-embed'\) === 'true'\) return false/);
-  assert.match(html, /if \(html\.getAttribute\('data-embed'\) === 'true' \|\|\s*!inspectRelationshipById/);
-  assert.match(html, /params\.get\('focus'\) \|\| params\.get\('relation'\)/);
-  assert.match(html, /if \(!reveal\(\)\) requestAnimationFrame\(reveal\)/);
-  assert.match(html, /inspectRelationshipById: inspectRelationshipById/);
-  assert.match(html, /id: record\.id \|\| null, key: record\.key/);
-  assert.doesNotMatch(html, /'#relation=' \+ encodeURIComponent\(record\.key\)/);
-});
-
-test('runtime overlays drop durable edge ids while canonical SVG keeps authored identity', () => {
-  const { result, html } = run('architecture', fixture('architecture'), 'export-boundary');
-  assert.equal(result.status, 0, result.stderr);
-  assert.match(canonicalSvg(html), /data-edge-id="users-to-cdn"/);
-  assert.doesNotMatch(canonicalSvg(html), /data-relationship-hit-overlay|data-relationship-id=/);
-  assert.ok((html.match(/clone\.removeAttribute\('data-edge-id'\)/g) || []).length >= 6);
-  assert.match(html, /querySelectorAll\('\[data-relationship-hit-overlay\]'\)/);
-});
-
-process.on('exit', () => fs.rmSync(tmp, { recursive: true, force: true }));