@mcptoolshop/a11y-evidence-engine 0.3.0 → 0.3.3

package/site/package.json

@@ -0,0 +1,17 @@
+{
+  "name": "site",
+  "type": "module",
+  "private": true,
+  "version": "0.0.1",
+  "scripts": {
+    "dev": "astro dev",
+    "build": "astro build",
+    "preview": "astro preview"
+  },
+  "dependencies": {
+    "@mcptoolshop/site-theme": "^0.2.4",
+    "@tailwindcss/vite": "^4.2.0",
+    "astro": "^5.17.0",
+    "tailwindcss": "^4.2.0"
+  }
+}

package/site/src/pages/index.astro

@@ -0,0 +1,33 @@
+---
+import '../styles/global.css';
+import BaseLayout from '@mcptoolshop/site-theme/components/BaseLayout.astro';
+import Hero from '@mcptoolshop/site-theme/components/Hero.astro';
+import Section from '@mcptoolshop/site-theme/components/Section.astro';
+import FeatureGrid from '@mcptoolshop/site-theme/components/FeatureGrid.astro';
+import DataTable from '@mcptoolshop/site-theme/components/DataTable.astro';
+import CodeCardGrid from '@mcptoolshop/site-theme/components/CodeCardGrid.astro';
+import ApiList from '@mcptoolshop/site-theme/components/ApiList.astro';
+import { config } from '../site-config';
+---
+
+<BaseLayout
+  title={config.title}
+  description={config.description}
+  logoBadge={config.logoBadge}
+  brandName={config.brandName}
+  repoUrl={config.repoUrl}
+  npmUrl={config.npmUrl}
+  footerText={config.footerText}
+  nav={config.sections.map(s => ({ href: `#${s.id}`, label: s.title }))}
+>
+  <Hero {...config.hero} />
+
+  {config.sections.map((s) => (
+    <Section id={s.id} title={s.title} subtitle={s.subtitle}>
+      {s.kind === 'features' && <FeatureGrid features={s.features} />}
+      {s.kind === 'data-table' && <DataTable columns={s.columns} rows={s.rows} />}
+      {s.kind === 'code-cards' && <CodeCardGrid cards={s.cards} />}
+      {s.kind === 'api' && <ApiList apis={s.apis} />}
+    </Section>
+  ))}
+</BaseLayout>

package/site/src/site-config.ts

@@ -0,0 +1,94 @@
+import type { SiteConfig } from '@mcptoolshop/site-theme';
+
+export const config: SiteConfig = {
+  title: 'a11y-evidence-engine',
+  description: 'Headless accessibility evidence engine with prov-spec provenance',
+  logoBadge: 'AE',
+  brandName: 'a11y-evidence-engine',
+  repoUrl: 'https://github.com/mcp-tool-shop-org/a11y-evidence-engine',
+  npmUrl: 'https://www.npmjs.com/package/@mcptoolshop/a11y-evidence-engine',
+  footerText: 'MIT Licensed \u2014 built by <a href="https://github.com/mcp-tool-shop-org" style="color:var(--color-muted);text-decoration:underline">mcp-tool-shop-org</a>',
+
+  hero: {
+    badge: 'Node.js / CLI',
+    headline: 'a11y-evidence-engine,',
+    headlineAccent: 'findings you can verify.',
+    description: 'Headless accessibility scanner that emits prov-spec provenance records. Every finding includes cryptographically verifiable evidence \u2014 no browser required, deterministic output, CI-ready.',
+    primaryCta: { href: '#quick-start', label: 'Get started' },
+    secondaryCta: { href: '#features', label: 'Learn more' },
+    previews: [
+      { label: 'Install', code: 'npm install -g @mcptoolshop/a11y-evidence-engine' },
+      { label: 'Scan', code: 'a11y-engine scan ./html --out ./results' },
+      { label: 'Verify', code: 'cat results/provenance/finding-0001/digest.json' },
+    ],
+  },
+
+  sections: [
+    {
+      kind: 'features',
+      id: 'features',
+      title: 'Why a11y-evidence-engine?',
+      subtitle: 'Accessibility findings backed by cryptographic proof.',
+      features: [
+        { title: 'Deterministic', desc: 'Same input always produces identical findings and provenance. No randomness, no flaky results.' },
+        { title: 'prov-spec Compatible', desc: 'Every finding includes three provenance records: evidence extraction, SHA-256 digest, and MCP envelope.' },
+        { title: 'No Browser Required', desc: 'Pure static HTML analysis. No Puppeteer, no Playwright, no headless Chrome \u2014 just the HTML.' },
+        { title: 'CI-Friendly', desc: 'Exit codes designed for automation: 0 for clean, 2 for findings, 3 for engine failure.' },
+        { title: 'Pairs with a11y-assist', desc: 'This engine finds issues and captures evidence. a11y-assist turns those findings into fixes.' },
+        { title: 'Verifiable Without Trust', desc: 'Provenance records are independently verifiable. You don\u2019t have to trust the engine to trust the results.' },
+      ],
+    },
+    {
+      kind: 'code-cards',
+      id: 'quick-start',
+      title: 'Quick Start',
+      cards: [
+        {
+          title: 'Scan & review',
+          code: 'npm install -g @mcptoolshop/a11y-evidence-engine\n\n# Scan a file or directory\na11y-engine scan ./path/to/html --out ./results\n\n# View help\na11y-engine --help',
+        },
+        {
+          title: 'Output structure',
+          code: 'results/\n\u251c\u2500\u2500 findings.json                    # All findings with metadata\n\u2514\u2500\u2500 provenance/\n    \u2514\u2500\u2500 finding-0001/\n        \u251c\u2500\u2500 record.json              # evidence extraction\n        \u251c\u2500\u2500 digest.json              # SHA-256 integrity\n        \u2514\u2500\u2500 envelope.json            # MCP envelope',
+        },
+      ],
+    },
+    {
+      kind: 'data-table',
+      id: 'rules',
+      title: 'Rules (v0.1.0)',
+      subtitle: 'Static HTML accessibility checks.',
+      columns: ['Rule ID', 'Description'],
+      rows: [
+        ['html.document.missing_lang', '<html> element missing lang attribute'],
+        ['html.img.missing_alt', '<img> element missing alt attribute'],
+        ['html.form_control.missing_label', 'Form control missing associated label'],
+        ['html.interactive.missing_name', 'Interactive element missing accessible name'],
+      ],
+    },
+    {
+      kind: 'data-table',
+      id: 'exit-codes',
+      title: 'Exit Codes',
+      subtitle: 'Designed for CI pipelines.',
+      columns: ['Code', 'Meaning'],
+      rows: [
+        ['0', 'No findings with severity error'],
+        ['2', 'At least one error finding'],
+        ['3', 'Internal engine failure or invalid input'],
+      ],
+    },
+    {
+      kind: 'data-table',
+      id: 'provenance',
+      title: 'Provenance Records',
+      subtitle: 'Three prov-spec records per finding.',
+      columns: ['Record', 'Method ID', 'Purpose'],
+      rows: [
+        ['record.json', 'engine.extract.evidence.json_pointer', 'Evidence extraction with location pointers'],
+        ['digest.json', 'integrity.digest.sha256', 'SHA-256 hash of canonical evidence'],
+        ['envelope.json', 'adapter.wrap.envelope_v0_1', 'Wrapped result in MCP envelope'],
+      ],
+    },
+  ],
+};

package/site/src/styles/global.css

@@ -0,0 +1,3 @@
+@import "tailwindcss";
+@import "@mcptoolshop/site-theme/styles/theme.css";
+@source "../../node_modules/@mcptoolshop/site-theme";

package/site/tsconfig.json

@@ -0,0 +1,5 @@
+{
+  "extends": "astro/tsconfigs/strict",
+  "include": [".astro/types.d.ts", "**/*"],
+  "exclude": ["dist"]
+}