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.
2026-08-31 11:31:29 +07:00
parent 050fafd731
commit 166e0d40ac
221 changed files with 191228 additions and 1 deletions
@@ -0,0 +1,59 @@
+import { test } from 'node:test';
+import assert from 'node:assert/strict';
+import { spawnSync } from 'node:child_process';
+import fs from 'node:fs';
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { workflow as validateWorkflow } from '../renderers/shared/generated-validators.mjs';
+
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+const skillRoot = path.resolve(__dirname, '..');
+
+function workflowDocument(schemaVersion) {
+  return {
+    schema_version: schemaVersion,
+    diagram_type: 'workflow',
+    meta: { title: 'Schema compatibility' },
+    lanes: [{ id: 'main', label: 'Main' }],
+    nodes: [{ id: 'step', lane: 'main', col: 0, type: 'backend', label: 'Step' }],
+    edges: [],
+  };
+}
+
+test('generated workflow validator accepts schema versions 1 and 2 only', () => {
+  assert.equal(validateWorkflow(workflowDocument(1)), true, JSON.stringify(validateWorkflow.errors));
+  assert.equal(validateWorkflow(workflowDocument(2)), true, JSON.stringify(validateWorkflow.errors));
+  assert.equal(validateWorkflow(workflowDocument(3)), false);
+  assert.deepEqual(validateWorkflow.errors?.[0]?.params.allowedValues, [1, 2]);
+});
+
+test('validator freshness check accepts CRLF checkouts', () => {
+  const scratch = fs.mkdtempSync(path.join(skillRoot, '.validator-check-'));
+  try {
+    fs.mkdirSync(path.join(scratch, 'scripts'));
+    fs.mkdirSync(path.join(scratch, 'renderers', 'shared'), { recursive: true });
+    fs.cpSync(path.join(skillRoot, 'schemas'), path.join(scratch, 'schemas'), { recursive: true });
+    fs.copyFileSync(
+      path.join(skillRoot, 'scripts', 'generate-validators.mjs'),
+      path.join(scratch, 'scripts', 'generate-validators.mjs'),
+    );
+
+    const validator = fs.readFileSync(
+      path.join(skillRoot, 'renderers', 'shared', 'generated-validators.mjs'),
+      'utf8',
+    );
+    fs.writeFileSync(
+      path.join(scratch, 'renderers', 'shared', 'generated-validators.mjs'),
+      validator.replace(/\r\n?|\n/g, '\r\n'),
+    );
+
+    const result = spawnSync(process.execPath, [
+      path.join(scratch, 'scripts', 'generate-validators.mjs'),
+      '--check',
+    ], { encoding: 'utf8' });
+
+    assert.equal(result.status, 0, result.stderr);
+  } finally {
+    fs.rmSync(scratch, { recursive: true, force: true });
+  }
+});