Turn any idea, plan, or codebase into a beautiful interactive diagram. An agent skill for Claude Code, Codex, and more.
HTML agent-skillsai-agentsarchitecture-diagramclaude-codeclaude-skillscodexcoding-agentsdeepseek-harnessdeveloper-toolsdiagramsdiagrams-as-codedsh-pluginflowchartllmmermaidopencodesequence-diagramsoftware-architecturesystem-designvisualization
feat(community): add community package registry v0 with website catalog page
tt-a1i3a24096aff54
diff --git a/archify/test/community-packages.test.mjs b/archify/test/community-packages.test.mjsnew file mode 100644index 00000000..7afd521e--- /dev/null+++ b/archify/test/community-packages.test.mjs@@ -0,0 +1,85 @@+import { test } from 'node:test';+import assert from 'node:assert/strict';+import fs from 'node:fs';+import os from 'node:os';+import path from 'node:path';+import { fileURLToPath } from 'node:url';++import {+ PACKAGE_TYPES,+ REQUIRED_FIELDS,+ validatePackage,+ validateRegistry,+} from '../../scripts/check-community-packages.mjs';++const repoRoot = path.resolve(path.dirname(fileURLToPath(import.meta.url)), '../..');+const schema = JSON.parse(fs.readFileSync(path.join(repoRoot, 'community/package.schema.json'), 'utf8'));++function validPackage() {+ return {+ name: 'demo-pack',+ type: 'skill',+ summary: { en: 'A demo package summary that is long enough.', zh: '一个足够长的演示包简介。' },+ author: { name: 'demo', url: 'https://example.com/demo' },+ repository: 'https://github.com/demo/demo-pack',+ archify: '>=3.0.0 <4.0.0',+ schemaVersions: [1, 2],+ };+}++test('community registry: checked-in packages validate clean', () => {+ const { entries, failures } = validateRegistry(repoRoot);+ assert.deepEqual(failures, []);+ assert.ok(entries.length >= 2, 'registry must seed at least two real packages');+});++test('community registry: validator stays in sync with package.schema.json', () => {+ assert.deepEqual([...schema.required].sort(), [...REQUIRED_FIELDS].sort());+ assert.deepEqual([...schema.properties.type.enum].sort(), [...PACKAGE_TYPES].sort());+ assert.deepEqual(schema.additionalProperties, false);+});++test('community package: accepts a minimal valid entry', () => {+ assert.deepEqual(validatePackage(validPackage()), []);+});++test('community package: rejects malformed entries with specific failures', () => {+ const cases = [+ ['missing required field', (value) => { delete value.repository; }, /missing required field "repository"/],+ ['unknown field', (value) => { value.downloads = 10; }, /unknown field "downloads"/],+ ['bad name case', (value) => { value.name = 'Demo-Pack'; }, /name must be lowercase kebab-case/],+ ['bad type', (value) => { value.type = 'plugin'; }, /type must be one of/],+ ['short en summary', (value) => { value.summary.en = 'short'; }, /summary\.en/],+ ['missing zh summary', (value) => { delete value.summary.zh; }, /summary\.zh/],+ ['non-https repository', (value) => { value.repository = '[email protected]:demo/x.git'; }, /repository must be an https/],+ ['bad archify range', (value) => { value.archify = 'latest'; }, /archify must be a version range/],+ ['empty schemaVersions', (value) => { value.schemaVersions = []; }, /schemaVersions must be a non-empty array/],+ ['non-integer schemaVersions', (value) => { value.schemaVersions = ['1']; }, /positive integers/],+ ['duplicate schemaVersions', (value) => { value.schemaVersions = [1, 1]; }, /unique/],+ ['bad tag', (value) => { value.tags = ['Not A Tag']; }, /tags must be/],+ ['bad evidence url', (value) => { value.evidence = [{ label: 'receipt', url: 'http://insecure.example.com' }]; }, /evidence\[0\]/],+ ];+ for (const [label, mutate, pattern] of cases) {+ const value = validPackage();+ mutate(value);+ const failures = validatePackage(value);+ assert.ok(failures.some((failure) => pattern.test(failure)), `${label}: expected ${pattern}, got ${JSON.stringify(failures)}`);+ }+});++test('community registry: rejects duplicate names and file/name mismatches', () => {+ const root = fs.mkdtempSync(path.join(os.tmpdir(), 'archify-community-'));+ try {+ const dir = path.join(root, 'community', 'packages');+ fs.mkdirSync(dir, { recursive: true });+ const first = validPackage();+ const second = { ...validPackage() };+ fs.writeFileSync(path.join(dir, 'demo-pack.json'), JSON.stringify(first));+ fs.writeFileSync(path.join(dir, 'other-name.json'), JSON.stringify(second));+ const { failures } = validateRegistry(root);+ assert.ok(failures.some((failure) => /file name must match/.test(failure)), JSON.stringify(failures));+ assert.ok(failures.some((failure) => /duplicate package name/.test(failure)), JSON.stringify(failures));+ } finally {+ fs.rmSync(root, { recursive: true, force: true });+ }+});diff --git a/community/README.md b/community/README.mdnew file mode 100644index 00000000..622c0671--- /dev/null+++ b/community/README.md@@ -0,0 +1,48 @@+# Archify Community Packages++A curated registry of **standalone packages that build on Archify**: domain skill packs, recipe libraries, brand kits, locale packs, and CLI wrappers. The catalog is rendered at [tt-a1i.github.io/archify/community.html](https://tt-a1i.github.io/archify/community.html) from the metadata files in [`packages/`](packages/).++Design rationale and non-goals are tracked in [issue #663](https://github.com/tt-a1i/archify/issues/663).++## What a community package is++A community package lives **outside** the Archify core and depends on it — the way the [Hermes](../integrations/hermes-agent/) and [DeepSeek Harness](../integrations/deepseek-harness/) integrations already do: author versioned JSON IR, invoke the Archify CLI, keep everything deterministic and fail-closed.++Archify has **no in-process plugin API, and none is planned for this registry**. Third-party code never executes inside the render pipeline, inside Archify CI, or inside the delivery trust model.++| Type | Contents | Example |+| --- | --- | --- |+| `skill` | Agent skill pack: SKILL.md, reference docs, examples for a domain | "Archify for Kubernetes" |+| `recipe` | Scenario/recipe library (the shape of `archify/recipes/scenarios.mjs`) | E-commerce architecture scenarios |+| `brand-marks` | Brand-mark catalog or visual preset | Corporate identity pack |+| `locale` | `meta.translations` catalog | Community-maintained language |+| `wrapper` | Standalone tool that emits Archify JSON IR and calls the CLI | Terraform state → diagram |++## Submitting a package++1. Publish your package in your own repository (or npm). Archify does not host package content.+2. Fork this repository and add **one metadata file**: `community/packages/<name>.json`, following [`package.schema.json`](package.schema.json). `<name>` is lowercase kebab-case and must equal the `name` field.+3. Validate locally before opening the PR:++ ```bash+ node scripts/check-community-packages.mjs+ ```++4. Open a PR **targeting `dev`** (per [CONTRIBUTING.md](../CONTRIBUTING.md)) that adds only your metadata file. Include evidence links in the `evidence` field — validation receipts, screenshots, rendered example artifacts.++Review follows the tiers in [REVIEWING.md](../REVIEWING.md). Approval criteria:++- Metadata passes `scripts/check-community-packages.mjs`.+- The declared `archify` compatibility range exists and the supported `schemaVersions` are real.+- The package performs what its summary claims, from the evidence you link.+- No telemetry, no hosted-service requirement, no code execution inside Archify.++Listing is **not endorsement**. The catalog marks community packages as community-maintained; the Archify maintainers verify only what can be verified deterministically and never run package code.++## Takedown++Removal is also a PR, on record. Maintainers may remove a listing when the package is malicious, abandoned with a broken source URL, or its compatibility claims become permanently stale. Authors may request removal of their own listing at any time via PR or issue.++## 中文摘要++社区 package 是**独立产物**,依赖并调用 Archify,而不是被 Archify 加载的插件。提交方式:fork 本仓库,按 `package.schema.json` 在 `community/packages/` 下新增一个元数据文件,本地跑 `node scripts/check-community-packages.mjs` 校验,然后向 `dev` 分支提 PR。收录不代表官方背书;下架同样以 PR 形式留痕。diff --git a/community/package.schema.json b/community/package.schema.jsonnew file mode 100644index 00000000..aedcc0cd--- /dev/null+++ b/community/package.schema.json@@ -0,0 +1,79 @@+{+ "$schema": "https://json-schema.org/draft/2020-12/schema",+ "$id": "https://tt-a1i.github.io/archify/community/package.schema.json",+ "title": "Archify Community Package",+ "description": "Registry metadata for a standalone community package that builds on Archify. One file per package under community/packages/. The package content lives in the author's own repository; this file only indexes it.",+ "type": "object",+ "additionalProperties": false,+ "required": ["name", "type", "summary", "author", "repository", "archify", "schemaVersions"],+ "properties": {+ "name": {+ "type": "string",+ "pattern": "^[a-z0-9][a-z0-9-]{1,62}[a-z0-9]$",+ "description": "Lowercase kebab-case identifier, unique across the registry. Also the file name: community/packages/<name>.json."+ },+ "type": {+ "enum": ["skill", "recipe", "brand-marks", "locale", "wrapper"],+ "description": "skill: agent skill pack; recipe: scenario/recipe library; brand-marks: brand-mark catalog or preset; locale: meta.translations catalog; wrapper: standalone tool that emits Archify JSON IR and calls the CLI."+ },+ "summary": {+ "type": "object",+ "additionalProperties": false,+ "required": ["en", "zh"],+ "properties": {+ "en": { "type": "string", "minLength": 10, "maxLength": 160 },+ "zh": { "type": "string", "minLength": 6, "maxLength": 120 }+ }+ },+ "author": {+ "type": "object",+ "additionalProperties": false,+ "required": ["name"],+ "properties": {+ "name": { "type": "string", "minLength": 1, "maxLength": 80 },+ "url": { "type": "string", "pattern": "^https://" }+ }+ },+ "repository": {+ "type": "string",+ "pattern": "^https://",+ "description": "Public URL of the package source (git repository, npm page, or directory inside one)."+ },+ "archify": {+ "type": "string",+ "pattern": "^(\\^|~)\\d+\\.\\d+\\.\\d+$|^\\d+\\.\\d+\\.\\d+$|^>=\\d+\\.\\d+\\.\\d+ <\\d+\\.\\d+\\.\\d+$",+ "description": "Compatible Archify version range, e.g. ^3.0.1 or >=3.0.0 <4.0.0."+ },+ "schemaVersions": {+ "type": "array",+ "items": { "type": "integer", "minimum": 1 },+ "minItems": 1,+ "uniqueItems": true,+ "description": "Archify JSON IR schema_version values the package can author."+ },+ "homepage": {+ "type": "string",+ "pattern": "^https://"+ },+ "tags": {+ "type": "array",+ "items": { "type": "string", "pattern": "^[a-z0-9-]{1,32}$" },+ "maxItems": 6,+ "uniqueItems": true+ },+ "evidence": {+ "type": "array",+ "maxItems": 8,+ "items": {+ "type": "object",+ "additionalProperties": false,+ "required": ["label", "url"],+ "properties": {+ "label": { "type": "string", "minLength": 1, "maxLength": 80 },+ "url": { "type": "string", "pattern": "^https://" }+ }+ },+ "description": "Links to verification evidence: validation receipts, screenshots, rendered example artifacts. Evidence is authored by the submitter; Archify never executes third-party package code."+ }+ }+}diff --git a/community/packages/archify-dsh.json b/community/packages/archify-dsh.jsonnew file mode 100644index 00000000..dd86c058--- /dev/null+++ b/community/packages/archify-dsh.json@@ -0,0 +1,23 @@+{+ "name": "archify-dsh",+ "type": "wrapper",+ "summary": {+ "en": "DeepSeek Harness plugin registering the Archify skill as a filesystem skill provider. Published on npm as @tt-a1i/archify-dsh.",+ "zh": "DeepSeek Harness 插件,将 Archify skill 注册为文件系统 skill provider。以 npm 包 @tt-a1i/archify-dsh 分发;宿主编写 JSON IR 并调用 Archify CLI。"+ },+ "author": {+ "name": "tt-a1i",+ "url": "https://github.com/tt-a1i"+ },+ "repository": "https://github.com/tt-a1i/archify/tree/main/integrations/deepseek-harness",+ "homepage": "https://www.npmjs.com/package/@tt-a1i/archify-dsh",+ "archify": ">=3.0.0 <4.0.0",+ "schemaVersions": [1, 2],+ "tags": ["deepseek-harness", "dsh", "npm", "integration"],+ "evidence": [+ {+ "label": "Pinned skill source commit",+ "url": "https://github.com/tt-a1i/archify/blob/main/integrations/deepseek-harness/release.json"+ }+ ]+}diff --git a/community/packages/archify-hermes.json b/community/packages/archify-hermes.jsonnew file mode 100644index 00000000..eeac2957--- /dev/null+++ b/community/packages/archify-hermes.json@@ -0,0 +1,22 @@+{+ "name": "archify-hermes",+ "type": "skill",+ "summary": {+ "en": "Hermes Agent integration: lets Hermes author Archify JSON IR and render through the Archify CLI — no code loaded into Archify.",+ "zh": "Archify 的 Hermes Agent 集成。以目录插件形式让 Hermes 编写 Archify JSON IR 并通过 Archify CLI 渲染图,不向 Archify 本体加载任何代码。"+ },+ "author": {+ "name": "tt-a1i",+ "url": "https://github.com/tt-a1i"+ },+ "repository": "https://github.com/tt-a1i/archify/tree/main/integrations/hermes-agent",+ "archify": ">=3.0.0 <4.0.0",+ "schemaVersions": [1, 2],+ "tags": ["hermes-agent", "integration", "opt-in"],+ "evidence": [+ {+ "label": "Plugin contract tests",+ "url": "https://github.com/tt-a1i/archify/tree/main/integrations/hermes-agent/test"+ }+ ]+}diff --git a/community/packages/archify-review.json b/community/packages/archify-review.jsonnew file mode 100644index 00000000..a5930b60--- /dev/null+++ b/community/packages/archify-review.json@@ -0,0 +1,16 @@+{+ "name": "archify-review",+ "type": "skill",+ "summary": {+ "en": "Review skill for the Archify repo: triages issues, PRs, and code through value, cost, and impact lenses for evidence-based maintenance.",+ "zh": "面向 Archify 仓库自身的评审 skill:按价值、成本、影响三个维度评审 issue、PR 与代码,支撑循证的维护决策。"+ },+ "author": {+ "name": "tt-a1i",+ "url": "https://github.com/tt-a1i"+ },+ "repository": "https://github.com/tt-a1i/archify/tree/main/.agents/skills/archify-review",+ "archify": ">=3.0.0 <4.0.0",+ "schemaVersions": [1, 2],+ "tags": ["review", "maintenance", "evidence"]+}diff --git a/scripts/check-community-packages.mjs b/scripts/check-community-packages.mjsnew file mode 100644index 00000000..55d0f5fa--- /dev/null+++ b/scripts/check-community-packages.mjs@@ -0,0 +1,158 @@+#!/usr/bin/env node++// Validates community/packages/*.json against the community package contract+// (community/package.schema.json). Dependency-free by design: the registry is+// community-facing and must be checkable without installing anything.++import fs from 'node:fs';+import path from 'node:path';+import { fileURLToPath, pathToFileURL } from 'node:url';++const scriptRoot = path.resolve(path.dirname(fileURLToPath(import.meta.url)), '..');+const rootFlag = process.argv.indexOf('--root');+const repoRoot = rootFlag === -1 ? scriptRoot : path.resolve(process.argv[rootFlag + 1] || '');++export const PACKAGE_TYPES = Object.freeze(['skill', 'recipe', 'brand-marks', 'locale', 'wrapper']);+export const REQUIRED_FIELDS = Object.freeze(['name', 'type', 'summary', 'author', 'repository', 'archify', 'schemaVersions']);+const ALLOWED_FIELDS = new Set([...REQUIRED_FIELDS, 'homepage', 'tags', 'evidence']);+const NAME_PATTERN = /^[a-z0-9][a-z0-9-]{1,62}[a-z0-9]$/;+const HTTPS_PATTERN = /^https:\/\//;+const ARCHIFY_RANGE_PATTERN = /^(\^|~)\d+\.\d+\.\d+$|^\d+\.\d+\.\d+$|^>=\d+\.\d+\.\d+ <\d+\.\d+\.\d+$/;+const TAG_PATTERN = /^[a-z0-9-]{1,32}$/;++function isPlainObject(value) {+ return typeof value === 'object' && value !== null && !Array.isArray(value);+}++function isString(value) {+ return typeof value === 'string';+}++function isHttpsUrl(value) {+ return isString(value) && HTTPS_PATTERN.test(value);+}++export function validatePackage(value) {+ const failures = [];+ const fail = (message) => failures.push(message);++ if (!isPlainObject(value)) {+ return ['entry must be a JSON object.'];+ }+ for (const field of REQUIRED_FIELDS) {+ if (!(field in value)) fail(`missing required field "${field}".`);+ }+ for (const field of Object.keys(value)) {+ if (!ALLOWED_FIELDS.has(field)) fail(`unknown field "${field}" (allowed: ${[...ALLOWED_FIELDS].join(', ')}).`);+ }+ if (failures.length) return failures;++ if (!isString(value.name) || !NAME_PATTERN.test(value.name)) {+ fail('name must be lowercase kebab-case (3-64 chars, letters/digits/hyphens).');+ }+ if (!PACKAGE_TYPES.includes(value.type)) {+ fail(`type must be one of: ${PACKAGE_TYPES.join(', ')}.`);+ }++ if (!isPlainObject(value.summary)) {+ fail('summary must be an object with "en" and "zh" strings.');+ } else {+ const { en, zh } = value.summary;+ if (!isString(en) || en.length < 10 || en.length > 160) fail('summary.en must be 10-160 characters.');+ if (!isString(zh) || zh.length < 6 || zh.length > 120) fail('summary.zh must be 6-120 characters.');+ }++ if (!isPlainObject(value.author) || !isString(value.author.name) || !value.author.name.trim()) {+ fail('author must be an object with a non-empty "name".');+ } else if ('url' in value.author && !isHttpsUrl(value.author.url)) {+ fail('author.url must be an https:// URL.');+ }++ if (!isHttpsUrl(value.repository)) fail('repository must be an https:// URL.');+ if (!isString(value.archify) || !ARCHIFY_RANGE_PATTERN.test(value.archify)) {+ fail('archify must be a version range like ^3.0.1 or >=3.0.0 <4.0.0.');+ }++ if (!Array.isArray(value.schemaVersions) || value.schemaVersions.length === 0) {+ fail('schemaVersions must be a non-empty array of positive integers.');+ } else {+ if (value.schemaVersions.some((entry) => !Number.isInteger(entry) || entry < 1)) {+ fail('schemaVersions entries must be positive integers.');+ }+ if (new Set(value.schemaVersions).size !== value.schemaVersions.length) {+ fail('schemaVersions entries must be unique.');+ }+ }++ if ('homepage' in value && !isHttpsUrl(value.homepage)) fail('homepage must be an https:// URL.');++ if ('tags' in value) {+ if (!Array.isArray(value.tags) || value.tags.length > 6 || value.tags.some((tag) => !isString(tag) || !TAG_PATTERN.test(tag))) {+ fail('tags must be at most 6 lowercase alphanumeric/hyphen strings.');+ } else if (new Set(value.tags).size !== value.tags.length) {+ fail('tags must be unique.');+ }+ }++ if ('evidence' in value) {+ if (!Array.isArray(value.evidence) || value.evidence.length > 8) {+ fail('evidence must be an array of at most 8 {label, url} entries.');+ } else {+ value.evidence.forEach((item, index) => {+ if (!isPlainObject(item) || !isString(item.label) || !item.label.trim() || !isHttpsUrl(item.url)) {+ fail(`evidence[${index}] must be {label: string, url: https:// URL}.`);+ }+ });+ }+ }++ return failures;+}++export function validateRegistry(root = repoRoot) {+ const packagesDir = path.join(root, 'community', 'packages');+ const failures = [];+ const entries = [];+ let files = [];+ try {+ files = fs.readdirSync(packagesDir).filter((entry) => entry.endsWith('.json')).sort();+ } catch {+ failures.push('community/packages/ is missing or unreadable.');+ return { entries, failures };+ }+ if (files.length === 0) failures.push('community/packages/ contains no package metadata files.');++ const seen = new Set();+ for (const file of files) {+ let value;+ try {+ value = JSON.parse(fs.readFileSync(path.join(packagesDir, file), 'utf8'));+ } catch (error) {+ failures.push(`${file}: not valid JSON (${error.message}).`);+ continue;+ }+ for (const failure of validatePackage(value)) failures.push(`${file}: ${failure}`);+ if (isPlainObject(value)) {+ const expectedFile = `${value.name}.json`;+ // path-contract-allow: portable-logical-path -- Registry file names are logical identifiers, not native paths.+ if (isString(value.name) && file !== expectedFile) {+ failures.push(`${file}: file name must match the name field (${expectedFile}).`);+ }+ if (seen.has(value.name)) failures.push(`${file}: duplicate package name "${value.name}".`);+ seen.add(value.name);+ entries.push(value);+ }+ }+ return { entries, failures };+}++if (process.argv[1] && import.meta.url === pathToFileURL(process.argv[1]).href) {+ const { entries, failures } = validateRegistry(repoRoot);+ for (const failure of failures) console.error(`✗ ${failure}`);+ if (failures.length) {+ console.error(`\ncommunity registry: ${failures.length} problem(s) across ${entries.length} package(s).`);+ process.exitCode = 1;+ } else {+ console.log(`community registry: ${entries.length} package(s) OK (${entries.map((entry) => entry.name).join(', ')}).`);+ }+}diff --git a/website/src/components/Navigation.astro b/website/src/components/Navigation.astroindex 6476dbd7..f68b4eca 100644--- a/website/src/components/Navigation.astro+++ b/website/src/components/Navigation.astro@@ -1,12 +1,13 @@---import Brand from './Brand';-interface Props { page: 'index' | 'gallery' | 'guide' | 'start' }+interface Props { page: 'index' | 'gallery' | 'guide' | 'start' | 'community' }const { page } = Astro.props;const home = page === 'index';const identities = {gallery: { en: '/ proof lab', zh: '/ 验证作品集', label: 'Back to Archify home' },guide: { en: '/ guide', zh: '/ 场景指南', label: 'Archify home' },start: { en: '/ start', zh: '/ 快速上手', label: 'Archify project page' },+ community: { en: '/ community', zh: '/ 社区包', label: 'Archify home' },};const identity = home ? undefined : identities[page];const guideKeys: Record<string, string> = { guide: 'navGuide', gallery: 'navProof', start: 'navStart' };@@ -14,7 +15,12 @@ const links = [{ page: 'guide', en: 'Guide', zh: '场景指南' },{ page: 'gallery', en: 'Proof Lab', zh: '验证作品集' },{ page: 'start', en: 'Start', zh: '快速上手' },+ { page: 'community', en: 'Community', zh: '社区包' },];+// gallery/guide/start are deep-compared against the legacy docs/ baselines in+// migration tests, so their navigation cannot change; the community link is+// reachable from the index page and the community page itself.+const visibleLinks = home || page === 'community' ? links : links.filter(link => link.page !== 'community');---<nav class="site-nav" aria-label="Primary navigation"><a class="nav-logo" href={home ? '#' : './'} aria-label={identity?.label}>@@ -22,7 +28,7 @@ const links = [{identity && <span class="nav-logo-path" data-en={identity.en} data-zh={identity.zh}>{identity.en}</span>}</a><div class="nav-right">- {links.map(link => <a class="nav-link" href={`${link.page}.html`} aria-current={page === link.page ? 'page' : undefined} {...(home ? { 'data-i18n': `nav-${link.page}` } : page === 'guide' ? { 'data-i18n': guideKeys[link.page] } : { 'data-en': link.en, 'data-zh': link.zh })}>{link.en}</a>)}+ {visibleLinks.map(link => <a class="nav-link" href={`${link.page}.html`} aria-current={page === link.page ? 'page' : undefined} {...(home ? { 'data-i18n': `nav-${link.page}` } : page === 'guide' ? { 'data-i18n': guideKeys[link.page] } : { 'data-en': link.en, 'data-zh': link.zh })}>{link.en}</a>)}<a class="nav-link" href="https://github.com/tt-a1i/archify" target="_blank" rel="noopener">GitHub</a><button class={home ? 'btn btn-lang' : 'btn-lang'} id={home ? 'btn-lang' : 'language'} type={home ? undefined : 'button'} aria-label={home ? undefined : 'Switch language'}>中文</button><a class="btn btn-primary nav-cta" href={home ? '#quickstart' : page === 'start' ? '#install' : 'start.html'} {...(home ? { 'data-i18n': 'nav-install' } : page === 'guide' ? { 'data-i18n': 'navInstall' } : { 'data-en': 'Install Skill', 'data-zh': '安装技能' })}>Install Skill</a>diff --git a/website/src/data/community-head.html b/website/src/data/community-head.htmlnew file mode 100644index 00000000..03d7428d--- /dev/null+++ b/website/src/data/community-head.html@@ -0,0 +1,12 @@++ <meta charset="UTF-8">+ <meta name="viewport" content="width=device-width, initial-scale=1.0">+ <meta name="generator" content="archify community [[ARCHIFY_VERSION]]">+ <title>Archify Community — Packages Built on Archify</title>+ <meta name="description" content="A curated catalog of standalone community packages that build on Archify: skill packs, recipe libraries, brand kits, locale packs, and CLI wrappers. Submitted by PR, validated deterministically.">+ <meta name="theme-color" content="#eff2f1">+ <link rel="icon" type="image/svg+xml" href="assets/archify-mark.svg">+ <link rel="preconnect" href="https://fonts.googleapis.com">+ <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>+ <link href="https://fonts.googleapis.com/css2?family=Fraunces:ital,opsz,wght@0,9..144,300;0,9..144,400;0,9..144,500;1,9..144,400&family=Inter:wght@400;450;500;600&family=JetBrains+Mono:wght@400;500;600&display=swap" rel="stylesheet">+ <link rel="stylesheet" href="assets/site-navigation.css">diff --git a/website/src/data/community.mjs b/website/src/data/community.mjsnew file mode 100644index 00000000..1ad54101--- /dev/null+++ b/website/src/data/community.mjs@@ -0,0 +1,21 @@+// Derived from the community registry — community/packages/*.json is the+// single source of truth; this page never hand-copies package metadata.+// import.meta.glob is resolved by Vite at build time relative to this source+// file, so the catalog cannot drift from the registry.++const modules = import.meta.glob('../../../community/packages/*.json', { eager: true, import: 'default' });++export const packages = Object.entries(modules)+ .map(([file, value]) => {+ if (!file.endsWith(`/${value.name}.json`)) {+ throw new Error(`community registry: ${file} does not match name "${value.name}"`);+ }+ return value;+ })+ .sort((a, b) => a.name.localeCompare(b.name));++export const typeOrder = ['skill', 'recipe', 'brand-marks', 'locale', 'wrapper'];+export const typeCounts = Object.fromEntries([+ ['all', packages.length],+ ...typeOrder.map((type) => [type, packages.filter((entry) => entry.type === type).length]),+]);diff --git a/website/src/pages/community.astro b/website/src/pages/community.astronew file mode 100644index 00000000..aea5af38--- /dev/null+++ b/website/src/pages/community.astro@@ -0,0 +1,140 @@+---+import { version, versioned } from '../data/site';+import { packages, typeOrder, typeCounts } from '../data/community.mjs';+import SiteLayout from '../layouts/SiteLayout.astro';+import Navigation from '../components/Navigation.astro';+import head from '../data/community-head.html?raw';+import css from '../styles/community.css?raw';+import pageScript from '../scripts/community.js?raw';++const typeLabels: Record<string, { en: string; zh: string }> = {+ skill: { en: 'Skill pack', zh: '技能包' },+ recipe: { en: 'Recipes', zh: '场景配方' },+ 'brand-marks': { en: 'Brand kit', zh: '品牌套件' },+ locale: { en: 'Locale', zh: '语言包' },+ wrapper: { en: 'Wrapper', zh: '命令行封装' },+};+const activeTypes = typeOrder.filter((type) => typeCounts[type] > 0);+---+<SiteLayout head={versioned(head)} css={css}>++ <div class="grid-bg" aria-hidden="true"></div>++ <Navigation page="community" />++ <main>+ <section class="hero">+ <div class="shell hero-grid">+ <div>+ <div class="lead-label" data-en="Community registry / standalone packages" data-zh="社区注册表 / 独立包">Community registry / standalone packages</div>+ <h1 data-en="Built on Archify.<br><em>Shared by everyone.</em>" data-zh="基于 Archify 构建,<br><em>由社区共享。</em>">Built on Archify.<br><em>Shared by everyone.</em></h1>+ <p class="hero-copy" data-en="Community packages are standalone works that wrap the Archify CLI — skill packs, recipe libraries, brand kits, locales, and wrappers. Nothing here is a plugin: no third-party code ever runs inside the renderer." data-zh="社区包是围绕 Archify CLI 构建的独立产物——技能包、场景配方、品牌套件、语言包与命令行封装。这里没有插件:任何第三方代码都不会进入渲染器内部运行。">Community packages are standalone works that wrap the Archify CLI — skill packs, recipe libraries, brand kits, locales, and wrappers. Nothing here is a plugin: no third-party code ever runs inside the renderer.</p>+ </div>+ <div class="proof-board" aria-label="Registry summary">+ <div class="proof-row"><span class="proof-value">{packages.length}</span><span class="proof-label" data-en="packages listed<br>from the registry" data-zh="个已收录包<br>来自注册表">packages listed<br>from the registry</span></div>+ <div class="proof-row"><span class="proof-value">{activeTypes.length}</span><span class="proof-label" data-en="package types<br>in the catalog" data-zh="种包类型<br>收录中">package types<br>in the catalog</span></div>+ <div class="proof-row"><span class="proof-value proof-status">PASS</span><span class="proof-label" data-en="metadata validated<br>deterministically" data-zh="元数据通过<br>确定性校验">metadata validated<br>deterministically</span></div>+ </div>+ </div>+ </section>++ <section class="controls" aria-label="Catalog controls">+ <div class="shell controls-inner">+ <div class="filter-group" role="group" aria-label="Filter packages by type">+ <button class="filter-button" type="button" data-filter="all" aria-pressed="true" data-en={`All / ${typeCounts.all}`} data-zh={`全部 / ${typeCounts.all}`}>All / {typeCounts.all}</button>+ {activeTypes.map((type) => (+ <button class="filter-button" type="button" data-filter={type} aria-pressed="false" data-en={`${typeLabels[type].en} / ${typeCounts[type]}`} data-zh={`${typeLabels[type].zh} / ${typeCounts[type]}`}>{typeLabels[type].en} / {typeCounts[type]}</button>+ ))}+ </div>+ <div class="controls-actions">+ <div class="controls-note" data-en="Submitted by PR · maintained by their authors" data-zh="通过 PR 提交 · 由作者自行维护">Submitted by PR · maintained by their authors</div>+ </div>+ </div>+ </section>++ <section class="catalog-section" id="catalog">+ <div class="shell">+ <div class="section-intro">+ <h2 data-en="The catalog." data-zh="目录。">The catalog.</h2>+ <p data-en="Every entry is a metadata file in the Archify repository, merged by PR and revalidated on every change. Listing is not endorsement — evidence links speak for each package." data-zh="每个条目都是 Archify 仓库中的一个元数据文件,经 PR 合并并在每次变更时重新校验。收录不代表官方背书——证据链接为每个包说话。">Every entry is a metadata file in the Archify repository, merged by PR and revalidated on every change. Listing is not endorsement — evidence links speak for each package.</p>+ </div>+ <div class="type-ledger" role="group" aria-label="Filter by package type">+ {typeOrder.map((type) => (+ <button type="button" class={`ledger-cell badge-${type} ${typeCounts[type] === 0 ? 'is-open' : ''}`} data-filter={type} aria-pressed="false">+ <span class="ledger-label" data-en={typeLabels[type].en} data-zh={typeLabels[type].zh}>{typeLabels[type].en}</span>+ <span class="ledger-count">{typeCounts[type] > 0+ ? typeCounts[type]+ : <em data-en="open" data-zh="虚位以待">open</em>}</span>+ </button>+ ))}+ </div>+ <div class="package-grid" id="package-grid">+ {packages.map((entry, index) => (+ <article class={`package-card badge-${entry.type}`} data-type={entry.type} style={`--stagger:${index}`}>+ <div class="package-card-head">+ <span class="package-index">{String(index + 1).padStart(2, '0')}</span>+ <span class="package-name">{entry.name}</span>+ <span class="type-badge" data-en={typeLabels[entry.type].en} data-zh={typeLabels[entry.type].zh}>{typeLabels[entry.type].en}</span>+ </div>+ <p class="package-summary" data-en={entry.summary.en} data-zh={entry.summary.zh}>{entry.summary.en}</p>+ <div class="package-meta">+ <span class="meta-chip" title="Author">+ <svg viewBox="0 0 16 16" aria-hidden="true"><circle cx="8" cy="5" r="2.6"/><path d="M2.8 13.4c.7-2.6 2.8-4 5.2-4s4.5 1.4 5.2 4"/></svg>+ {entry.author.name}+ </span>+ <span class="meta-chip mono" title="Compatible Archify range">archify {entry.archify}</span>+ <span class="meta-chip mono" title="Supported IR schema versions">IR v{entry.schemaVersions.join(' · v')}</span>+ </div>+ <div class="package-actions">+ <a class="card-link" href={entry.repository} target="_blank" rel="noopener noreferrer" data-en="View source ↗" data-zh="查看源码 ↗">View source ↗</a>+ {entry.evidence?.[0] && (+ <a class="card-link subtle" href={entry.evidence[0].url} target="_blank" rel="noopener noreferrer" data-en={`${entry.evidence[0].label} ↗`} data-zh={`${entry.evidence[0].label} ↗`}>{entry.evidence[0].label} ↗</a>+ )}+ </div>+ </article>+ ))}+ </div>+ <div class="empty-state" id="empty-state" data-en="No packages match this filter." data-zh="当前筛选条件下没有收录包。">No packages match this filter.</div>+ </div>+ </section>++ <section class="method">+ <div class="shell method-grid">+ <div>+ <div class="lead-label" data-en="Join the registry" data-zh="加入注册表">Join the registry</div>+ <h2 data-en="A pull request is the submission." data-zh="一次 PR 就是提交。">A pull request is the submission.</h2>+ <div class="pipeline" aria-label="Submission pipeline">+ <div class="pipeline-step"><span class="pipeline-num">01</span><span class="pipeline-label" data-en="Publish your package in your own repo" data-zh="在你自己的仓库发布你的包">Publish your package in your own repo</span><span class="pipeline-state you">YOU</span></div>+ <div class="pipeline-step"><span class="pipeline-num">02</span><span class="pipeline-label" data-en="Add one metadata file under community/packages/" data-zh="在 community/packages/ 下添加一个元数据文件">Add one metadata file under community/packages/</span><span class="pipeline-state you">YOU</span></div>+ <div class="pipeline-step"><span class="pipeline-num">03</span><span class="pipeline-label" data-en="Validate with check-community-packages.mjs" data-zh="运行 check-community-packages.mjs 校验">Validate with check-community-packages.mjs</span><span class="pipeline-state">PASS</span></div>+ <div class="pipeline-step"><span class="pipeline-num">04</span><span class="pipeline-label" data-en="Open a PR targeting dev — merge means listed" data-zh="向 dev 分支提 PR——合并即收录">Open a PR targeting dev — merge means listed</span><span class="pipeline-state">PASS</span></div>+ </div>+ </div>+ <div class="method-code">+ <div class="method-code-bar"><span>submit locally</span><span>zero dependencies</span></div>+ <pre><span class="accent">$ node scripts/check-community-packages.mjs</span>++community registry: {packages.length} package(s) OK+ {packages.map((entry) => entry.name).join(', ')}++<span class="accent">$ git checkout -b community/my-pack origin/dev</span>++# add community/packages/my-pack.json+# open PR → review → listed here</pre>+ <a class="card-link method-link" href="https://github.com/tt-a1i/archify/tree/main/community" target="_blank" rel="noopener noreferrer" data-en="Read the submission guide ↗" data-zh="阅读提交指南 ↗">Read the submission guide ↗</a>+ </div>+ </div>+ </section>+ </main>++ <footer>+ <div class="shell footer-inner">+ <span data-en="Community packages are maintained by their authors. Listing is not endorsement; Archify never executes package code." data-zh="社区包由各自作者维护。收录不代表官方背书;Archify 绝不执行第三方包的代码。">Community packages are maintained by their authors. Listing is not endorsement; Archify never executes package code.</span>+ <span data-en={`Archify v${version} · stable · MIT`} data-zh={`Archify v${version} · 稳定版 · MIT`}>Archify v{version} · stable · MIT</span>+ </div>+ </footer>++ <script is:inline src="assets/site-language.js"></script>+ <script is:inline set:html={versioned(pageScript)}></script>++</SiteLayout>diff --git a/website/src/scripts/community.js b/website/src/scripts/community.jsnew file mode 100644index 00000000..ab256c71--- /dev/null+++ b/website/src/scripts/community.js@@ -0,0 +1,63 @@++ (function () {+ var cards = Array.prototype.slice.call(document.querySelectorAll('.package-card'));+ var filterButtons = Array.prototype.slice.call(document.querySelectorAll('[data-filter]'));+ var empty = document.getElementById('empty-state');+ var language = ArchifySiteLanguage.read();++ function applyLanguage(next) {+ language = ArchifySiteLanguage.write(next);+ document.documentElement.lang = language === 'zh' ? 'zh-CN' : 'en';+ document.querySelectorAll('[data-en][data-zh]').forEach(function (node) {+ node.innerHTML = node.getAttribute(language === 'zh' ? 'data-zh' : 'data-en');+ });+ var languageButton = document.getElementById('language');+ languageButton.textContent = language === 'zh' ? 'EN' : '中文';+ languageButton.setAttribute('aria-label', language === 'zh' ? 'Switch to English' : '切换到中文');+ }++ function applyFilter(type, updateUrl) {+ var visible = 0;+ cards.forEach(function (card) {+ var match = type === 'all' || card.getAttribute('data-type') === type;+ card.hidden = !match;+ if (match) visible += 1;+ });+ filterButtons.forEach(function (button) {+ button.setAttribute('aria-pressed', button.getAttribute('data-filter') === type ? 'true' : 'false');+ });+ empty.classList.toggle('visible', visible === 0);+ if (updateUrl) {+ var url = new URL(location.href);+ if (type === 'all') url.searchParams.delete('type');+ else url.searchParams.set('type', type);+ history.replaceState(null, '', url.pathname + url.search + url.hash);+ }+ }++ filterButtons.forEach(function (button) {+ button.addEventListener('click', function () { applyFilter(button.getAttribute('data-filter'), true); });+ });+ document.getElementById('language').addEventListener('click', function () { applyLanguage(language === 'en' ? 'zh' : 'en'); });++ var allowed = ['all'].concat(Array.prototype.slice.call(document.querySelectorAll('[data-filter]')).map(function (button) {+ return button.getAttribute('data-filter');+ }).filter(function (type) { return type !== 'all'; }));+ var requested = new URLSearchParams(location.search).get('type') || 'all';+ applyFilter(allowed.indexOf(requested) >= 0 ? requested : 'all', false);+ applyLanguage(language);++ if ('IntersectionObserver' in window) {+ var observer = new IntersectionObserver(function (entries) {+ entries.forEach(function (entry) {+ if (entry.isIntersecting) {+ entry.target.classList.add('visible');+ observer.unobserve(entry.target);+ }+ });+ }, { threshold: 0.08 });+ cards.forEach(function (card) { observer.observe(card); });+ } else {+ cards.forEach(function (card) { card.classList.add('visible'); });+ }+ })();diff --git a/website/src/scripts/index.js b/website/src/scripts/index.jsindex 983788cb..8767748e 100644--- a/website/src/scripts/index.js+++ b/website/src/scripts/index.js@@ -4,7 +4,7 @@══════════════════════════════════════ */const LANGS = {en: {- 'nav-guide':'Guide','nav-gallery':'Proof Lab','nav-start':'Start','nav-install':'Install Skill',+ 'nav-guide':'Guide','nav-gallery':'Proof Lab','nav-start':'Start','nav-community':'Community','nav-install':'Install Skill','hero-badge':'Agent Skill · stable · v[[ARCHIFY_VERSION]]','hero-h1':'From plain English<br>to architecture <em>you can trust.</em>','hero-sub':'Describe your system in chat. Archify generates a polished, explorable HTML diagram — with progressive MAP → READ → FULL detail, a semantic camera, path-aware stories, motion, and ultra-crisp export built in.',@@ -64,7 +64,7 @@'footer-changelog':'Changelog','footer-license':'License'},zh: {- 'nav-guide':'场景指南','nav-gallery':'验证作品集','nav-start':'快速上手','nav-install':'安装技能',+ 'nav-guide':'场景指南','nav-gallery':'验证作品集','nav-start':'快速上手','nav-community':'社区包','nav-install':'安装技能','hero-badge':'Agent 技能 · 稳定版 · v[[ARCHIFY_VERSION]]','hero-h1':'用自然语言,<br>生成<em>可信的架构图。</em>','hero-sub':'在对话中描述你的系统,Archify 生成精美、可探索的 HTML 技术图——信息会按 MAP → READ → FULL 渐进展开,并内置语义镜头、路径故事、动态效果和超清导出。',diff --git a/website/src/styles/community.css b/website/src/styles/community.cssnew file mode 100644index 00000000..56db202e--- /dev/null+++ b/website/src/styles/community.css@@ -0,0 +1,218 @@++ :root {+ /* Drafted-sheet palette — shared with the other site pages */+ --paper-site:#eff2f1; --paper-raised:#f8faf9;+ --ink-site:#15181b; --ink-soft:#363c41; --muted:#60686d; --dim:#929a9e;+ --line:rgba(20,23,26,0.14); --line-hi:rgba(20,23,26,0.3);+ --accent-site:#e14a0e; --accent-soft:rgba(225,74,14,0.08);+ --plate:#0f1216;+ --emerald:#047857;+ --font-display:'Fraunces','Songti SC','STSong',Georgia,serif;+ --font-body:'Inter',-apple-system,BlinkMacSystemFont,'PingFang SC','Hiragino Sans GB','Microsoft YaHei',sans-serif;+ --font-mono:'JetBrains Mono',ui-monospace,SFMono-Regular,Menlo,monospace;+ --ease-out:cubic-bezier(.22,1,.36,1);+ --content: 1320px;+ }+ *,*::before,*::after { margin:0; padding:0; box-sizing:border-box; }+ html { scroll-behavior: smooth; }+ body {+ font-family:var(--font-body);+ -webkit-font-smoothing:antialiased; text-rendering:optimizeLegibility;+ background:var(--paper-site); color:var(--ink-site); min-height:100vh; overflow-x:hidden;+ }+ body::after {+ content:''; position:fixed; inset:0; z-index:1000; pointer-events:none;+ opacity:.05; mix-blend-mode:multiply;+ background-image:url("data:image/svg+xml;utf8,<svg xmlns='http://www.w3.org/2000/svg' width='140' height='140'><filter id='n'><feTurbulence type='fractalNoise' baseFrequency='0.85' numOctaves='2' stitchTiles='stitch'/></filter><rect width='140' height='140' filter='url(%23n)'/></svg>");+ }+ ::selection { background:rgba(225,74,14,.18); color:var(--ink-site); }+ a { color: inherit; }+ button, a { -webkit-tap-highlight-color: transparent; }+ button { font:inherit; }+ :focus-visible { outline: 2px solid var(--accent-site); outline-offset: 3px; border-radius:4px; }++ .grid-bg {+ position:fixed; inset:0; z-index:0; pointer-events:none;+ background-image:linear-gradient(rgba(20,23,26,.045) 1px,transparent 1px),linear-gradient(90deg,rgba(20,23,26,.045) 1px,transparent 1px);+ background-size:56px 56px;+ -webkit-mask-image:radial-gradient(ellipse 95% 62% at 50% -6%, black 12%, transparent 75%);+ mask-image:radial-gradient(ellipse 95% 62% at 50% -6%, black 12%, transparent 75%);+ }+ .shell { position:relative; z-index:1; width: min(var(--content), calc(100% - 48px)); margin: 0 auto; }++ /* HERO */+ .hero { padding: 10rem 0 4.5rem; }+ .hero-grid { display: grid; grid-template-columns: minmax(0, 1.45fr) minmax(310px, 0.55fr); gap: 4.5rem; align-items: end; }+ .lead-label { display:flex; align-items:center; gap:.875rem; margin-bottom:1.5rem; font-family:var(--font-mono); font-size:.625rem; font-weight:500; letter-spacing:.2em; color:var(--muted); text-transform:uppercase; }+ .lead-label::before { content:''; width:2.75rem; height:1px; background:var(--line-hi); }+ .hero h1 {+ max-width: 860px;+ font-family:var(--font-display); font-optical-sizing:auto;+ font-size: clamp(2.75rem, 6vw, 5rem);+ font-weight:400; line-height: 1.02; letter-spacing: -.03em;+ color:var(--ink-site); text-wrap: balance;+ }+ .hero h1 em { font-style:italic; color: var(--accent-site); }+ .hero-copy { margin-top: 1.5rem; max-width: 640px; color: var(--muted); font-size: .9375rem; line-height: 1.72; text-wrap:pretty; }+ .proof-board { border:1px solid var(--line-hi); border-radius:12px; background:var(--paper-raised); overflow:hidden; }+ .proof-row { min-height: 64px; display: grid; grid-template-columns: 88px 1fr; align-items: center; gap:1rem; padding:.9rem 1.25rem; border-bottom: 1px solid var(--line); }+ .proof-row:last-child { border-bottom:0; }+ .proof-value { font-family:var(--font-display); font-style:italic; font-optical-sizing:auto; font-weight:400; font-size: 1.625rem; line-height:1; color: var(--ink-site); }+ .proof-label { color: var(--dim); font-family:var(--font-mono); font-size: .5625rem; line-height: 1.5; letter-spacing: .12em; text-transform: uppercase; }+ .proof-status { display: inline-flex; align-items: center; gap: .5rem; color: var(--emerald); font-style:normal; font-family:var(--font-mono); font-size:.8125rem; font-weight:600; letter-spacing:.08em; }+ .proof-status::before { content: ''; width: 6px; height: 6px; border-radius: 50%; background: var(--emerald); }++ /* CONTROLS */+ .controls { padding: 1.25rem 0; border-top:1px solid var(--line); border-bottom: 1px solid var(--line); }+ .controls-inner { display: flex; align-items: center; justify-content: space-between; gap: 1.5rem; }+ .filter-group { display: flex; align-items: center; flex-wrap: wrap; gap: .45rem; }+ .controls-actions { display:flex; align-items:center; justify-content:flex-end; gap:1rem; }+ .filter-button {+ min-height: 44px;+ padding: 0 .85rem;+ border: 1px solid var(--line-hi);+ border-radius: 999px;+ background: transparent;+ color: var(--muted);+ font-family:var(--font-mono); font-size:.5625rem; font-weight:500; letter-spacing:.12em; text-transform:uppercase;+ cursor: pointer;+ transition:all .18s var(--ease-out);+ }+ .filter-button:hover { color: var(--ink-site); border-color:var(--ink-site); }+ .filter-button[aria-pressed="true"] { color: var(--paper-site); background:var(--ink-site); border-color:var(--ink-site); }+ .controls-note { color: var(--dim); font-family:var(--font-mono); font-size: .5625rem; letter-spacing: .12em; text-align: right; text-transform: uppercase; }++ /* CATALOG */+ .catalog-section { padding: 4rem 0 3.5rem; }+ .section-intro { display: flex; justify-content: space-between; align-items: end; gap: 2rem; margin-bottom: 1.75rem; }+ .section-intro h2 { font-family:var(--font-display); font-optical-sizing:auto; font-size: clamp(1.75rem, 3.4vw, 2.75rem); font-weight:400; letter-spacing: -.026em; color:var(--ink-site); }+ .section-intro p { max-width: 480px; color: var(--muted); font-size: .8125rem; line-height: 1.7; text-align: right; }+ .type-ledger { display: grid; grid-template-columns: repeat(5, minmax(0, 1fr)); gap: 1px; margin-bottom: 14px; background: var(--line); border: 1px solid var(--line-hi); border-radius: 10px; overflow: hidden; }+ .ledger-cell { display: flex; align-items: center; justify-content: space-between; gap: .75rem; padding: .7rem .95rem; border: 0; background: var(--paper-raised); cursor: pointer; text-align: left; transition: background .18s var(--ease-out); }+ .ledger-cell:hover { background: var(--accent-soft); }+ .ledger-cell[aria-pressed="true"] { background: var(--ink-site); }+ .ledger-cell[aria-pressed="true"] .ledger-label { color: var(--paper-site); }+ .ledger-cell[aria-pressed="true"] .ledger-count { color: var(--paper-site); }+ .ledger-cell[aria-pressed="true"].is-open .ledger-count em { color: var(--dim); }+ .ledger-label { display: inline-flex; align-items: center; gap: .5rem; color: var(--ink-soft); font-family: var(--font-mono); font-size: .5625rem; font-weight: 600; letter-spacing: .12em; text-transform: uppercase; }+ .ledger-label::before { content:''; width: 5px; height: 5px; border-radius: 50%; background: var(--badge); }+ .ledger-count { font-family: var(--font-display); font-style: italic; font-optical-sizing: auto; font-size: .9375rem; color: var(--ink-site); }+ .ledger-cell.is-open .ledger-label { color: var(--dim); }+ .ledger-cell.is-open .ledger-label::before { background: transparent; box-shadow: inset 0 0 0 1px var(--line-hi); }+ .ledger-cell.is-open .ledger-count em { font-style: italic; font-family: var(--font-mono); font-size: .5625rem; letter-spacing: .12em; text-transform: uppercase; color: var(--dim); }+ .package-grid { display: grid; grid-template-columns: repeat(3, minmax(0, 1fr)); gap: 14px; }+ .package-card {+ --badge: var(--accent-site);+ min-width: 0;+ position: relative;+ display: flex;+ flex-direction: column;+ border: 1px solid var(--line-hi);+ border-radius: 14px;+ background: var(--paper-raised);+ overflow: hidden;+ opacity: 0;+ transform: translateY(18px);+ transition: opacity .5s var(--ease-out), transform .5s var(--ease-out), border-color .2s var(--ease-out), box-shadow .2s var(--ease-out);+ transition-delay: calc(var(--stagger, 0) * 60ms), calc(var(--stagger, 0) * 60ms), 0s, 0s;+ }+ .package-card::before {+ content:''; position:absolute; top:0; left:0; right:0; height:2px;+ background: var(--badge); opacity:.85;+ }+ .package-card.visible { opacity: 1; transform: translateY(0); transition-delay: 0s; }+ .package-card.visible:hover { transform: translateY(-4px); }+ .package-card:hover { border-color: var(--ink-site); box-shadow:0 22px 54px rgba(20,23,26,.12); }+ .package-card[hidden] { display: none; }+ .badge-skill { --badge: #e14a0e; }+ .badge-recipe { --badge: #047857; }+ .badge-brand-marks { --badge: #7c3aed; }+ .badge-locale { --badge: #2563eb; }+ .badge-wrapper { --badge: #475569; }+ .package-card-head { display: flex; align-items: center; gap: .875rem; padding: 1.375rem 1.5rem 0; }+ .package-index { font-family: var(--font-display); font-style: italic; font-optical-sizing: auto; font-size: 1rem; color: var(--dim); }+ .package-name { flex: 1; min-width: 0; font-family:var(--font-mono); font-size: .9375rem; font-weight:600; letter-spacing:-.01em; color: var(--ink-site); white-space: nowrap; overflow: hidden; text-overflow: ellipsis; }+ .type-badge {+ flex-shrink: 0;+ display: inline-flex; align-items: center; gap: .45rem;+ padding: .34rem .6rem;+ border: 1px solid color-mix(in srgb, var(--badge) 38%, transparent);+ border-radius: 999px;+ background: color-mix(in srgb, var(--badge) 7%, transparent);+ color: var(--badge);+ font-family:var(--font-mono); font-size: .5625rem; font-weight:600; letter-spacing: .12em; text-transform: uppercase;+ }+ .type-badge::before { content:''; width: 5px; height: 5px; border-radius: 50%; background: currentColor; }+ .package-summary { flex: 1; padding: .9rem 1.5rem 1.25rem; color: var(--muted); font-size: .8125rem; line-height: 1.7; text-wrap:pretty; }+ .package-meta { display: flex; align-items: center; flex-wrap: wrap; gap: .4rem; padding: 0 1.5rem 1.125rem; }+ .meta-chip {+ display: inline-flex; align-items: center; gap: .4rem;+ padding: .34rem .55rem;+ border: 1px solid var(--line);+ border-radius: 6px;+ color: var(--dim);+ font-size: .625rem; font-weight: 500;+ }+ .meta-chip svg { width: 11px; height: 11px; fill: none; stroke: currentColor; stroke-width: 1.5; stroke-linecap: round; }+ .meta-chip.mono { font-family: var(--font-mono); font-size: .5625rem; letter-spacing: .04em; }+ .package-actions { display: flex; align-items: center; flex-wrap: wrap; gap: .55rem; margin-top: auto; padding: 1.125rem 1.5rem; border-top: 1px solid var(--line); }+ .card-link { min-height: 40px; display: inline-flex; align-items: center; justify-content: center; gap: .5rem; padding: 0 .9rem; border: 1px solid var(--line-hi); border-radius: 8px; color: var(--ink-soft); font-size: .75rem; font-weight: 500; text-decoration: none; transition: all .2s var(--ease-out); }+ .card-link:hover { color: var(--ink-site); border-color: var(--ink-site); }+ .card-link.subtle { border-color: var(--line); color: var(--muted); }+ .card-link.subtle:hover { color: var(--ink-site); border-color: var(--ink-site); }+ .empty-state { display: none; margin-top:14px; padding: 4rem 1.5rem; border: 1px dashed var(--line-hi); border-radius:14px; color: var(--muted); text-align: center; font-size: .8125rem; }+ .empty-state.visible { display: block; }++ /* METHOD */+ .method { border-top: 1px solid var(--line); padding: 4.5rem 0; }+ .method-grid { display: grid; grid-template-columns: 0.8fr 1.2fr; gap: 4.5rem; }+ .method h2 { font-family:var(--font-display); font-optical-sizing:auto; font-size: clamp(1.5rem,2.6vw,2.25rem); font-weight:400; letter-spacing: -.026em; color:var(--ink-site); }+ .pipeline { margin-top: 1.75rem; display: grid; gap: 1px; background: var(--line); border: 1px solid var(--line-hi); border-radius:12px; overflow:hidden; }+ .pipeline-step { display: grid; grid-template-columns: 44px 1fr auto; align-items: center; gap: 1rem; min-height: 56px; padding: 0 1.125rem; background: var(--paper-raised); }+ .pipeline-num { color: var(--accent-site); font-family:var(--font-mono); font-size: .625rem; font-weight:600; }+ .pipeline-label { font-size: .8125rem; color:var(--ink-soft); }+ .pipeline-state { color: var(--emerald); font-family:var(--font-mono); font-size: .5625rem; font-weight:600; letter-spacing: .12em; text-transform: uppercase; }+ .pipeline-state.you { color: var(--dim); }+ .method-code { border: 1px solid var(--ink-site); border-radius:12px; overflow:hidden; background: var(--plate); align-self:start; }+ .method-code-bar { display: flex; justify-content: space-between; padding: .7rem 1rem; border-bottom: 1px solid rgba(232,237,242,.1); color: #7d8894; font-family:var(--font-mono); font-size: .5625rem; letter-spacing: .14em; text-transform: uppercase; }+ .method-code pre { margin: 0; padding: 1.5rem; color: #aab3bb; font: 500 .6875rem/1.9 var(--font-mono); white-space: pre-wrap; }+ .method-code pre::after { content: '▍'; color: var(--accent-site); animation: caret-blink 1.1s steps(1) infinite; }+ @keyframes caret-blink { 50% { opacity: 0; } }+ .method-code .accent { color: var(--accent-site); }+ .method-link { margin: 0 1.5rem 1.5rem; border-color: rgba(232,237,242,.22); color: #aab3bb; }+ .method-link:hover { border-color: #e8edf2; color: #e8edf2; }++ footer { border-top: 1px solid var(--line); padding: 1.75rem 0 2.5rem; color: var(--dim); font-family:var(--font-mono); font-size: .625rem; letter-spacing:.04em; }+ .footer-inner { display: flex; justify-content: space-between; gap: 1.5rem; }++ @media (max-width: 1100px) {+ .package-grid { grid-template-columns: repeat(2, minmax(0, 1fr)); }+ .type-ledger { grid-template-columns: repeat(3, minmax(0, 1fr)); }+ }+ @media (max-width: 960px) {+ .hero-grid, .method-grid { grid-template-columns: 1fr; gap: 2.5rem; }+ .proof-board { display: grid; grid-template-columns: repeat(3, 1fr); }+ .proof-row { grid-template-columns: 1fr; align-content: center; gap: .35rem; border-bottom:0; border-right: 1px solid var(--line); }+ .proof-row:last-child { border-right:0; }+ }+ @media (max-width: 640px) {+ .shell { width: min(100% - 28px, var(--content)); }+ .hero { padding: 7.5rem 0 3rem; }+ .hero h1 { font-size: clamp(2.25rem, 11vw, 3rem); }+ .proof-board { grid-template-columns: 1fr; }+ .proof-row { grid-template-columns: 72px 1fr; min-height: 54px; border-right: 0; border-bottom:1px solid var(--line); }+ .proof-row:last-child { border-bottom:0; }+ .controls-inner, .section-intro { align-items: flex-start; flex-direction: column; }+ .controls-actions { width:100%; justify-content:space-between; }+ .controls-note, .section-intro p { text-align: left; }+ .filter-group { width: 100%; overflow-x: auto; flex-wrap: nowrap; padding-bottom: 4px; }+ .package-grid { grid-template-columns: 1fr; }+ .type-ledger { grid-template-columns: repeat(2, minmax(0, 1fr)); }+ .method { padding: 3.25rem 0; }+ .footer-inner { flex-direction: column; }+ }+ @media (prefers-reduced-motion: reduce) {+ html { scroll-behavior: auto; }+ .package-card { opacity:1; transform:none; transition:none; }+ .method-code pre::after { animation: none; }+ }diff --git a/website/test/community.test.mjs b/website/test/community.test.mjsnew file mode 100644index 00000000..f84e62d6--- /dev/null+++ b/website/test/community.test.mjs@@ -0,0 +1,81 @@+import { test } from 'node:test';+import assert from 'node:assert/strict';+import fs from 'node:fs';+import path from 'node:path';+import { fileURLToPath } from 'node:url';+import { parse } from 'parse5';++const root = fileURLToPath(new URL('../', import.meta.url));+const repoRoot = path.resolve(root, '..');+const registryDir = path.join(repoRoot, 'community', 'packages');+const dist = path.join(root, 'dist');++const registry = fs.readdirSync(registryDir).filter((entry) => entry.endsWith('.json')).sort()+ .map((file) => JSON.parse(fs.readFileSync(path.join(registryDir, file), 'utf8')));++function elements(node, tag) {+ return [...(node.tagName === tag ? [node] : []), ...(node.childNodes || []).flatMap((child) => elements(child, tag))];+}+function attr(node, name) {+ return node?.attrs?.find((attribute) => attribute.name === name)?.value;+}+function hasClass(node, name) {+ return (attr(node, 'class') || '').split(/\s+/).includes(name);+}++function communityDom() {+ const file = path.join(dist, 'community.html');+ assert.ok(fs.existsSync(file), 'dist/community.html must exist — run npm run build first');+ return parse(fs.readFileSync(file, 'utf8'));+}++test('community catalog: renders one card per registry package, derived not hand-pasted', () => {+ const dom = communityDom();+ const cards = elements(dom, 'article').filter((node) => hasClass(node, 'package-card'));+ assert.equal(cards.length, registry.length, 'card count must match community/packages/*.json');++ const names = cards.map((card) => {+ const nameNode = elements(card, 'span').find((node) => hasClass(node, 'package-name'));+ return nameNode.childNodes.map((child) => child.value || '').join('').trim();+ }).sort();+ assert.deepEqual(names, registry.map((entry) => entry.name).sort());++ for (const card of cards) {+ const type = attr(card, 'data-type');+ assert.ok(['skill', 'recipe', 'brand-marks', 'locale', 'wrapper'].includes(type), `card type ${type}`);+ const summary = elements(card, 'p').find((node) => hasClass(node, 'package-summary'));+ assert.ok(attr(summary, 'data-en') && attr(summary, 'data-zh'), 'summary must carry both locales');+ const link = elements(card, 'a').find((node) => hasClass(node, 'card-link'));+ assert.ok((attr(link, 'href') || '').startsWith('https://'), 'card must link to the package repository');+ }+});++test('community catalog: filter buttons cover the types present in the registry', () => {+ const dom = communityDom();+ const pillButtons = elements(dom, 'button').filter((node) => attr(node, 'data-filter') && hasClass(node, 'filter-button'));+ const filters = pillButtons.map((node) => attr(node, 'data-filter'));+ assert.ok(filters.includes('all'));+ for (const type of new Set(registry.map((entry) => entry.type))) {+ assert.ok(filters.includes(type), `missing filter for type ${type}`);+ }+ assert.ok(pillButtons.every((node) => attr(node, 'data-en') && attr(node, 'data-zh')), 'filter buttons must be bilingual');++ const ledgerButtons = elements(dom, 'button').filter((node) => attr(node, 'data-filter') && hasClass(node, 'ledger-cell'));+ assert.deepEqual(+ ledgerButtons.map((node) => attr(node, 'data-filter')),+ ['skill', 'recipe', 'brand-marks', 'locale', 'wrapper'],+ 'type ledger must offer every package type as a filter',+ );+});++test('community catalog: navigation, language toggle and disclaimer are present', () => {+ const dom = communityDom();+ const links = elements(dom, 'a').map((node) => attr(node, 'href'));+ assert.ok(links.includes('community.html'), 'primary navigation must link to community.html');+ const languageButton = elements(dom, 'button').find((node) => attr(node, 'id') === 'language');+ assert.ok(languageButton, 'language toggle must be present');+ const html = fs.readFileSync(path.join(dist, 'community.html'), 'utf8');+ assert.match(html, /Listing is not endorsement/, 'must carry the no-endorsement disclaimer');+ const submission = elements(dom, 'a').find((node) => (attr(node, 'href') || '').includes('github.com/tt-a1i/archify/tree/main/community'));+ assert.ok(submission, 'must link to the submission guide');+});