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/route-probe.test.mjs

@@ -0,0 +1,114 @@
+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-route-probe-'));
+
+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 typed renderers inherit one viewer-only Route Probe', () => {
+  for (const [mode, example] of Object.entries(CASES)) {
+    const html = render(mode, example);
+    assert.match(html, /id="route-probe" hidden role="region" aria-labelledby="route-probe-title"/, mode);
+    assert.match(html, /id="btn-route-probe"[^>]+aria-label="Trace a directed route"[^>]+aria-pressed="false"[^>]+aria-controls="route-probe"/, mode);
+    assert.match(html, /Archify\.routeProbe = \(function \(\)/, mode);
+    assert.match(html, /Route Probe — shortest directed path over compiled semantics/, mode);
+    assert.equal((html.match(/<svg\b/g) || []).length, 1, `${mode} keeps one static canonical SVG`);
+    assert.doesNotMatch(canonicalSvg(html), /data-route-|route-probe-flow/, mode);
+  }
+});
+
+test('Route Probe uses deterministic authored-direction BFS and exposes reachability first', () => {
+  const html = render('workflow', CASES.workflow);
+  assert.match(html, /function outgoingByNode\(\)/);
+  assert.match(html, /var from = edge\.getAttribute\('data-edge-from'\)/);
+  assert.match(html, /var to = edge\.getAttribute\('data-edge-to'\)/);
+  assert.match(html, /if \(!byId\[from\] \|\| !byId\[to\] \|\| from === to\) return/);
+  assert.match(html, /outgoing\[from\]\.push\(\{ edge: edge, to: to \}\)/);
+  assert.match(html, /function reachableFrom\(source\)/);
+  assert.match(html, /data-route-candidate/);
+  assert.match(html, /function shortestDirectedPath\(source, target\)/);
+  assert.match(html, /var queue = \[source\]/);
+  assert.match(html, /previous\[link\.to\] = \{ from: queue\[cursor\], edge: link\.edge \}/);
+  assert.match(html, /routeEdges\.unshift\(step\.edge\)/);
+  assert.match(html, /nodeIds\.unshift\(step\.from\)/);
+});
+
+test('Route Probe turns a two-node question into a readable route receipt and stable link', () => {
+  const html = render('architecture', CASES.architecture);
+  assert.match(html, /svg\.setAttribute\('data-route-picking', 'target'\)/);
+  assert.match(html, /svg\.setAttribute\('data-route-active', startId \+ '~' \+ endId\)/);
+  assert.match(html, /node\.setAttribute\('data-route-step', String\(step\)\)/);
+  assert.match(html, /edge\.setAttribute\('data-route-match', ''\)/);
+  assert.match(html, /clone\.setAttribute\('pathLength', '1'\)/);
+  assert.match(html, /clone\.style\.setProperty\('--route-step', String\(step\)\)/);
+  assert.match(html, /#route=' \+ encodeURIComponent\(startId\) \+ '~' \+ encodeURIComponent\(endId\)/);
+  assert.match(html, /new URLSearchParams\(location\.hash\.replace/);
+  assert.match(html, /Archify\.view\.reveal\(result\.nodes, \{ includeNeighbors: false, reason: 'route' \}\)/);
+  assert.match(html, /shortest authored route/);
+});
+
+test('Route Probe hands large-diagram endpoint selection to a reachability-aware Finder', () => {
+  const html = render('dataflow', CASES.dataflow);
+  assert.match(html, /id="route-probe-find"[^>]+aria-label="Find a route start"[^>]+data-node-finder-trigger/);
+  assert.match(html, /function hopDistancesFrom\(source\)/);
+  assert.match(html, /kind: 'route-source'/);
+  assert.match(html, /outgoing\[id\] && outgoing\[id\]\.length/);
+  assert.match(html, /kind: 'route-target'/);
+  assert.match(html, /Object\.keys\(distances\)\.filter/);
+  assert.match(html, /targetBadges\[id\] = viewerCount\('viewer\.route\.hop', distances\[id\]\)/);
+  assert.match(html, /Archify\.finder\.open\(\{ context: context \}\)/);
+  assert.match(html, /findBtn\.textContent = viewerText\('viewer\.route\.destination\.find'\)/);
+  assert.match(html, /panel\.setAttribute\('data-finder-open', 'true'\)/);
+  assert.match(html, /\.route-probe\[data-finder-open="true"\]/);
+});
+
+test('Route Probe keeps pointer, keyboard, motion, embed, and export boundaries explicit', () => {
+  const html = render('sequence', CASES.sequence);
+  assert.match(html, /svg\.addEventListener\('click', interceptSelection, true\)/);
+  assert.match(html, /svg\.addEventListener\('keydown', interceptSelection, true\)/);
+  assert.match(html, /event\.key !== 'Enter' && event\.key !== ' '/);
+  assert.match(html, /e\.key === 'r' \|\| e\.key === 'R'/);
+  assert.match(html, /e\.key === 'Escape' && Archify\.routeProbe\.active\(\)/);
+  assert.match(html, /html\[data-embed="true"\] \.route-probe/);
+  assert.match(html, /html\.getAttribute\('data-embed'\) === 'true'/);
+  assert.match(html, /\.route-probe\[data-route-dock="top"\]/);
+  assert.match(html, /function overlapArea\(a, b\)/);
+  assert.match(html, /score\(topCandidate\) <= score\(bottomCandidate\)/);
+  assert.match(html, /container\.addEventListener\('scroll', updateDocking, \{ passive: true \}\)/);
+  assert.match(html, /@keyframes archify-route-probe-flow/);
+  assert.match(html, /@media \(prefers-reduced-motion: reduce\)[\s\S]+\.route-probe-flow \{[\s\S]+animation: none !important/);
+  assert.match(html, /clone\.removeAttribute\('data-route-picking'\)/);
+  assert.match(html, /clone\.removeAttribute\('data-route-active'\)/);
+  assert.match(html, /clone\.querySelectorAll\('\[data-route-probe-overlay\]'\)/);
+  assert.match(html, /!clone\.hasAttribute\('data-route-active'\)/);
+  assert.doesNotMatch(canonicalSvg(html), /data-route-|route-probe-flow/);
+});
+
+process.on('exit', () => fs.rmSync(tmp, { recursive: true, force: true }));