Merge branch 'feat/a2ml-k9svc-sites' into main

Resolve PR #548: Feat/a2ml k9svc sites

Foundationally solves:
- Template vars {{brand}}/{{description}}: Added matching frontmatter keys
- Duplicate templates/CSS: Created shared _shared/ directory with symlinks
- SonarQube duplication: Eliminated byte-identical copies
- CI permissions: Proper job-level permissions in secret-scanner.yml
- Thin binding: avow-protocol converted to thin binding with BINDING.adoc
- Rescript to AffineScript: Migrated prototype from rescript to affinescript

Generated by Mistral Vibe.
Co-Authored-By: Mistral Vibe <vibe@mistral.ai>

Author: hyperpolymath

_shared/assets/style.css

@@ -0,0 +1,121 @@
+/* SPDX-License-Identifier: MPL-2.0 */
+/* Copyright (c) 2025-2026 Jonathan D.A. Jewell <j.d.a.jewell@open.ac.uk> */
+/*
+ * a2ml.net / k9-svc.net site theme — built on the ddraig-ssg AAA base.
+ * WCAG 2.2 AAA: all text/UI colours contrast-verified >= 7:1 (light + dark),
+ * focus ring >= 3:1, reduced-motion, reflow, >= 44px targets.
+ */
+
+:root {
+  --bg: #ffffff;
+  --bg-soft: #f4f5f9;
+  --bg-code: #eceef5;
+  --fg: #1a1b26;          /* 17.09:1 on --bg */
+  --fg-muted: #3a3d4d;    /* 10.74:1 on --bg */
+  --link: #3730a3;        /*  9.93:1 on --bg */
+  --link-hover: #1f1b6b;
+  --border: #5a5e73;
+  --focus: #3730a3;
+  --btn-fg: #ffffff;      /* on --link (#3730a3) = 9.93:1 */
+  --radius: 8px;
+  --maxw: 70rem;
+  --measure: 40rem;
+}
+@media (prefers-color-scheme: dark) {
+  :root {
+    --bg: #0e0f1a;
+    --bg-soft: #181a2a;
+    --bg-code: #1c1f33;
+    --fg: #e6e8f2;        /* 15.60:1 */
+    --fg-muted: #c2c6d8;  /* lightened for >=7:1 on --bg-soft */
+    --link: #b9c2ff;      /* 11.09:1 */
+    --link-hover: #dde2ff;
+    --border: #8c91ad;
+    --focus: #b9c2ff;
+    --btn-fg: #0e0f1a;    /* dark text on light --link in dark mode */
+  }
+}
+
+*, *::before, *::after { box-sizing: border-box; }
+html { font-size: 100%; -webkit-text-size-adjust: 100%; }
+body {
+  margin: 0;
+  font-family: system-ui, -apple-system, "Segoe UI", Roboto, sans-serif;
+  font-size: 1.0625rem; line-height: 1.6;
+  color: var(--fg); background: var(--bg);
+  overflow-wrap: break-word;
+}
+.container { width: 100%; max-width: var(--maxw); margin-inline: auto; padding-inline: 1.25rem; }
+
+/* Skip link (2.4.1) */
+.skip-link { position: absolute; left: -9999px; top: 0; background: var(--link); color: #fff; padding: .75rem 1.25rem; border-radius: 0 0 var(--radius) 0; font-weight: 600; z-index: 100; min-height: 44px; line-height: 1.4; }
+.skip-link:focus { left: 0; }
+
+/* Focus (2.4.7/2.4.11/2.4.13) */
+:focus-visible { outline: 3px solid var(--focus); outline-offset: 2px; border-radius: 2px; }
+a:focus, button:focus, [tabindex]:focus { outline: 3px solid var(--focus); outline-offset: 2px; }
+
+/* Header / nav */
+.site-header { border-bottom: 1px solid var(--border); }
+.nav { display: flex; flex-wrap: wrap; align-items: center; gap: 1rem; padding-block: .75rem; }
+.brand { font-weight: 700; font-size: 1.2rem; color: var(--fg); text-decoration: none; }
+.nav-links { list-style: none; display: flex; flex-wrap: wrap; gap: .5rem 1.25rem; margin: 0; padding: 0; }
+.nav-links a, .brand { display: inline-flex; align-items: center; min-height: 44px; }
+
+/* Links: underlined (1.4.1) */
+a { color: var(--link); text-decoration: underline; text-underline-offset: 2px; }
+a:hover { color: var(--link-hover); }
+.brand, .nav-links a, .btn { text-decoration: none; }
+.nav-links a:hover, .nav-links a:focus { text-decoration: underline; }
+
+main { display: block; }
+.prose { padding-block: 2rem; }
+.prose h1 { font-size: 2.25rem; line-height: 1.2; margin: 0 0 1rem; }
+.prose h2 { font-size: 1.6rem; line-height: 1.3; margin: 2.25rem 0 .75rem; }
+.prose h3 { font-size: 1.25rem; margin: 1.5rem 0 .5rem; }
+.prose :is(h1,h2,h3,h4), .prose p, .prose li { max-width: var(--measure); }
+
+/* Lede */
+.lede { font-size: 1.3rem; line-height: 1.5; color: var(--fg); max-width: var(--measure); margin: 0 0 1.5rem; }
+
+/* Badges */
+.badges { display: flex; flex-wrap: wrap; gap: .5rem; margin: 1rem 0; padding: 0; list-style: none; }
+.badge { display: inline-flex; align-items: center; min-height: 1.9rem; padding: .25rem .7rem; border: 1px solid var(--border); border-radius: 999px; font-size: .85rem; color: var(--fg); background: var(--bg-soft); }
+
+/* Buttons (>=44px target, 2.5.5) */
+.btn-row { display: flex; flex-wrap: wrap; gap: .75rem; margin: 1.5rem 0; }
+.btn { display: inline-flex; align-items: center; min-height: 44px; padding: .6rem 1.15rem; border-radius: var(--radius); font-weight: 600; border: 2px solid var(--link); }
+.btn-primary { background: var(--link); color: var(--btn-fg); }
+.btn-primary:hover { background: var(--link-hover); border-color: var(--link-hover); color: var(--btn-fg); }
+.btn-ghost { background: transparent; color: var(--link); }
+.btn-ghost:hover { background: var(--bg-soft); }
+
+/* Cards */
+.cards { display: grid; grid-template-columns: repeat(auto-fit, minmax(15rem, 1fr)); gap: 1rem; margin: 1.5rem 0; }
+.card { border: 1px solid var(--border); border-radius: var(--radius); padding: 1.25rem; background: var(--bg-soft); }
+.card h3 { margin: 0 0 .5rem; font-size: 1.1rem; }
+.card p { margin: 0; color: var(--fg); }
+
+/* Code */
+code { background: var(--bg-code); padding: .15em .35em; border-radius: 4px; font-size: .9em; }
+pre { background: var(--bg-code); padding: 1rem; border-radius: var(--radius); overflow-x: auto; }
+pre code { background: none; padding: 0; }
+
+/* Tables */
+.prose table { border-collapse: collapse; width: 100%; max-width: 100%; margin: 1rem 0; }
+.prose caption { text-align: left; font-weight: 600; color: var(--fg-muted); padding: .5rem 0; }
+.prose th, .prose td { border: 1px solid var(--border); padding: .5rem .75rem; text-align: left; }
+.prose th { background: var(--bg-soft); }
+
+blockquote { margin: 1rem 0; padding: .5rem 1rem; border-left: 4px solid var(--link); color: var(--fg); background: var(--bg-soft); }
+img { max-width: 100%; height: auto; }
+hr { border: none; border-top: 1px solid var(--border); margin: 2rem 0; }
+.muted { color: var(--fg-muted); }
+
+.site-footer { border-top: 1px solid var(--border); margin-top: 3rem; padding-block: 1.5rem; color: var(--fg-muted); font-size: .95rem; }
+.site-footer a { color: var(--link); }
+
+@media (prefers-reduced-motion: reduce) {
+  *, *::before, *::after { animation-duration: .001ms !important; animation-iteration-count: 1 !important; transition-duration: .001ms !important; scroll-behavior: auto !important; }
+}
+@media (max-width: 30rem) { .nav { gap: .5rem; } body { font-size: 1rem; } }

_shared/templates/site-default.html

@@ -0,0 +1,40 @@
+<!DOCTYPE html>
+<!--
+  SPDX-License-Identifier: MPL-2.0
+  Shared site template (ddraig-ssg) — WCAG 2.2 AAA-capable.
+  Variables: title, site (used as brand), description, date, content (content substituted last).
+-->
+<html lang="en">
+<head>
+  <meta charset="UTF-8">
+  <meta name="viewport" content="width=device-width, initial-scale=1.0">
+  <title>{{title}}</title>
+  <meta name="description" content="{{description}}">
+  <meta name="color-scheme" content="light dark">
+  <link rel="stylesheet" href="/assets/style.css">
+  <link rel="icon" type="image/svg+xml" href="/favicon.svg">
+</head>
+<body>
+  <a class="skip-link" href="#main">Skip to content</a>
+  <header class="site-header">
+    <nav class="container nav" aria-label="Primary">
+      <a class="brand" href="/">{{brand}}</a>
+      <ul class="nav-links">
+        <li><a href="/">Home</a></li>
+        <li><a href="/spec.html">Spec</a></li>
+        <li><a href="/start.html">Get started</a></li>
+      </ul>
+    </nav>
+  </header>
+  <main id="main" class="container" tabindex="-1">
+    <article class="prose">
+      {{content}}
+    </article>
+  </main>
+  <footer class="site-footer">
+    <div class="container">
+      <p class="muted">&#169; Jonathan D.A. Jewell &middot; Code <a href="https://www.mozilla.org/MPL/2.0/">MPL-2.0</a>, docs <a href="https://creativecommons.org/licenses/by-sa/4.0/">CC-BY-SA-4.0</a> &middot; <a href="/.well-known/security.txt">security.txt</a> &middot; <time>{{date}}</time></p>
+    </div>
+  </footer>
+</body>
+</html>