feat: introduce archify skill for generating architecture diagrams

- Added a new Archify skill, enabling users to create polished architecture, workflow, sequence, data-flow, and lifecycle diagrams.
- Implemented comprehensive functionality including rendering, validation, and delivery of diagrams in various formats.
- Integrated a user-friendly command-line interface for generating and previewing diagrams.
- Developed supporting files including package.json, LICENSE, and SKILL.md for documentation and licensing.
- Added unit tests to ensure reliability and functionality of the new skill.

These changes enhance the application by providing a structured approach to visualizing system architecture and workflows, improving user experience and data representation.

.agents/skills/archify/test/finder.test.mjs

@@ -0,0 +1,104 @@
+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-finder-'));
+
+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 svg(html) {
+  return html.match(/<svg\b[\s\S]*?<\/svg>/)?.[0] || '';
+}
+
+test('all typed renderers ship the same geometry-neutral node finder', () => {
+  for (const [mode, example] of Object.entries(CASES)) {
+    const html = render(mode, example);
+    assert.match(html, /id="btn-node-finder"[^>]+aria-label="Find a node"[^>]+aria-haspopup="dialog"/, mode);
+    assert.match(html, /id="node-finder" hidden role="dialog" aria-modal="false"/, mode);
+    assert.match(html, /id="node-finder-input" type="search"/, mode);
+    assert.match(html, /Archify\.finder = \(function \(\)/, mode);
+    assert.match(html, /svg\.querySelectorAll\('\[data-node-id\]'\)/, mode);
+    assert.doesNotMatch(svg(html), /node-finder|Archify\.finder|Find a node/, mode);
+  }
+});
+
+test('finder searches semantic ids and labels, then delegates to focus and reveal', () => {
+  const html = render('architecture', CASES.architecture);
+  assert.match(html, /search: \(id \+ ' ' \+ label \+ ' ' \+ type \+ ' ' \+ sublabel \+ ' ' \+ context \+ ' ' \+ tag \+ ' ' \+ sourceSearch \+ ' ' \+ text\)\.toLowerCase\(\)/);
+  assert.match(html, /item\.search\.indexOf\(query\) !== -1/);
+  assert.match(html, /Archify\.guidedViews\.showAll\(\{ clearFocus: false, updateUrl: false \}\)/);
+  assert.match(html, /Archify\.view\.reset\(\{ automatic: true \}\)/);
+  assert.match(html, /Archify\.focus\.set\(id, \{ toggle: false \}\)/);
+  assert.match(html, /Archify\.view\.reveal\(\[id\], \{ includeNeighbors: true, reason: 'finder' \}\)/);
+  assert.match(html, /item\.node\.focus\(\{ preventScroll: true \}\)/);
+  assert.match(html, /var key = from \+ '\\u0000' \+ to/);
+});
+
+test('finder presents one focused search control and a structured result list', () => {
+  const html = render('architecture', CASES.architecture);
+  assert.match(html, /id="node-finder-input"[^>]+aria-label="Search diagram nodes"/);
+  assert.match(html, /\.node-finder-search:focus-within\s*\{/);
+  assert.match(html, /\.node-finder-input:focus-visible\s*\{\s*outline:\s*none;/);
+  assert.match(html, /\.node-finder\s*\{[\s\S]*?display:\s*flex;[\s\S]*?max-height:\s*calc\(100% - 2rem\);/);
+  assert.match(html, /\.node-finder-results\s*\{[\s\S]*?flex:\s*1 1 auto;[\s\S]*?min-height:\s*0;/);
+  assert.match(html, /\.node-finder-result:not\(:last-child\)\s*\{/);
+  assert.match(html, /context\.kind === 'focus'\s*\? viewerCount\('viewer\.finder\.link', item\.links\)/);
+  assert.match(html, /\[viewerKindLabel\(item\.type\), item\.id, item\.sublabel, item\.tag\]/);
+  assert.doesNotMatch(html, /\[item\.type, item\.context, item\.sublabel, item\.tag, item\.id\]/);
+  assert.match(html, /viewerText\('viewer\.finder\.status\.filtered'/);
+});
+
+test('finder becomes a contextual Route Probe endpoint picker without changing semantic focus', () => {
+  const html = render('workflow', CASES.workflow);
+  assert.match(html, /function resolveContext\(options\)/);
+  assert.match(html, /Archify\.routeProbe\.finderContext\(\)/);
+  assert.match(html, /context\.allowedIds\.indexOf\(item\.id\) !== -1/);
+  assert.match(html, /context\.kind === 'route-source' \|\| context\.kind === 'route-target'/);
+  assert.match(html, /Archify\.routeProbe\.choose\(id\)/);
+  assert.match(html, /reason: 'route-pick'/);
+  assert.match(html, /data-context="route-source"/);
+  assert.match(html, /data-context="route-target"/);
+  assert.match(html, /viewerText\('viewer\.finder\.result\.routeTarget'/);
+  assert.match(html, /links: badge/);
+  assert.match(html, /viewerText\('viewer\.finder\.status\.all'/);
+});
+
+test('finder is keyboard accessible, mobile-pinned, and subordinate to embed mode', () => {
+  const html = render('workflow', CASES.workflow);
+  assert.match(html, /e\.key === '\/'/);
+  assert.match(html, /Archify\.finder\.open\(\)/);
+  assert.match(html, /event\.key === 'ArrowDown'/);
+  assert.match(html, /event\.key === 'ArrowUp'/);
+  assert.match(html, /event\.key === 'Escape'/);
+  assert.match(html, /event\.stopPropagation\(\)/);
+  assert.match(html, /Archify\.exportMenu\.isOpen\(\)\) Archify\.exportMenu\.close\(false\)/);
+  assert.match(html, /data-wide-diagram="true"\] \.node-finder/);
+  assert.match(html, /html\[data-embed="true"\] \.node-finder/);
+  assert.match(html, /html\.getAttribute\('data-embed'\) === 'true'/);
+  assert.match(html, /data-node-finder-trigger/);
+  assert.match(html, /!event\.target\.closest\('\[data-node-finder-trigger\]'\)/);
+});
+
+process.on('exit', () => fs.rmSync(tmp, { recursive: true, force: true }));