Import heron-polyfeed-reader M0–M6 and mint it from the RSR template

.cicd-hygiene-allow

@@ -10,3 +10,11 @@
 # these paths, resolve or issue-link it there — do not widen this list.
 build/container/entrypoint.sh
 tests/e2e.sh
+#
+# heron-polyfeed-reader: THIRD-PARTY VENDORED CODE. Its TODO/FIXME/XXX markers
+# are upstream's (SQLite amalgamation; a patched copy of Zig std's TLS client,
+# see src/vendor/NOTICE), not this repo's debt, and estate policy makes
+# third-party code untouchable. Excluded by exact path; nothing else here.
+vendor/sqlite/sqlite3.c
+vendor/sqlite/sqlite3.h
+src/vendor/tls_client.zig

.clinerules

@@ -1,5 +1,5 @@
 # SPDX-License-Identifier: MPL-2.0
-# Copyright (c) {{CURRENT_YEAR}} {{AUTHOR}} ({{OWNER}}) <{{AUTHOR_EMAIL}}>
+# Copyright (c) 2026 Jonathan D.A. Jewell (hyperpolymath) <j.d.a.jewell@open.ac.uk>
 # Authoritative source: docs/practice/AI-CONVENTIONS.adoc
 
 # STARTUP: Read the repo deed (*_chora.deed at the repo root) first, then docs/status/ROADMAP.adoc.
@@ -8,7 +8,7 @@
 # All original code: MPL-2.0.
 # Never AGPL-3.0. MPL-2.0 only as platform-required fallback.
 # SPDX header required on every source file.
-# Copyright: {{AUTHOR}} ({{OWNER}}) <{{AUTHOR_EMAIL}}>
+# Copyright: Jonathan D.A. Jewell (hyperpolymath) <j.d.a.jewell@open.ac.uk>
 
 # STATE FILES
 # No .a2ml file may exist anywhere: the format is retired. State, metadata,

.cursorrules

@@ -1,13 +1,13 @@
 # SPDX-License-Identifier: MPL-2.0
-# Copyright (c) {{CURRENT_YEAR}} {{AUTHOR}} ({{OWNER}}) <{{AUTHOR_EMAIL}}>
+# Copyright (c) 2026 Jonathan D.A. Jewell (hyperpolymath) <j.d.a.jewell@open.ac.uk>
 # Authoritative source: docs/practice/AI-CONVENTIONS.adoc
 
 # Read the repo deed (*_chora.deed in the repo root) FIRST: canonical file locations
 # live in its (ply ...) canonical-locations clauses.
 
 # LICENSE
 # All original code: MPL-2.0 (SPDX header required on every file).
-# Copyright: {{AUTHOR}} ({{OWNER}}) <{{AUTHOR_EMAIL}}>
+# Copyright: Jonathan D.A. Jewell (hyperpolymath) <j.d.a.jewell@open.ac.uk>
 
 # STATE FILES
 # No .a2ml file may exist anywhere: the format is retired. State, metadata,

.devcontainer/Containerfile

@@ -1,9 +1,9 @@
 # SPDX-License-Identifier: MPL-2.0
-# Copyright (c) {{CURRENT_YEAR}} {{AUTHOR}} ({{OWNER}}) <{{AUTHOR_EMAIL}}>
+# Copyright (c) 2026 Jonathan D.A. Jewell (hyperpolymath) <j.d.a.jewell@open.ac.uk>
 #
-# Dev Container image for {{PROJECT_NAME}}
+# Dev Container image for heron-polyfeed-reader
 # Base: Chainguard Wolfi (minimal, supply-chain-secure)
-# Build: podman build -t {{PROJECT_NAME}}-dev -f .devcontainer/Containerfile .
+# Build: podman build -t heron-polyfeed-reader-dev -f .devcontainer/Containerfile .
 # `:latest` suits a dev container (rebuilt daily); pin by digest
 # (...@sha256:<digest>) if you need a reproducible dev environment.
 #
@@ -44,7 +44,7 @@ RUN set -eu; \
 # devcontainer.json maps your host user onto it with --userns=keep-id.
 
 # Set workspace directory
-WORKDIR /workspaces/{{PROJECT_NAME}}
+WORKDIR /workspaces/heron-polyfeed-reader
 
 # Default shell
 ENV SHELL=/bin/bash

.devcontainer/README.adoc

@@ -1,7 +1,7 @@
 // SPDX-License-Identifier: CC-BY-SA-4.0
 // Copyright (c) Jonathan D.A. Jewell <j.d.a.jewell@open.ac.uk>
 = Dev Container Usage
-:author: {{AUTHOR}} <{{AUTHOR_EMAIL}}>
+:author: Jonathan D.A. Jewell <j.d.a.jewell@open.ac.uk>
 
 == Overview
 
@@ -35,7 +35,7 @@ There are two configurations for the same image:
 . Install the *Dev Containers* extension (`ms-vscode-remote.remote-containers`).
 . Set `dev.containers.dockerPath` to `podman` in VS Code settings.
 . Open the repo folder, then choose **Reopen in Container** and pick
-  **{{PROJECT_NAME}} (Podman)**.
+  **heron-polyfeed-reader (Podman)**.
 
 == devcontainer CLI (Podman)
 
@@ -47,7 +47,7 @@ bunx @devcontainers/cli up --workspace-folder . --docker-path podman
 == GitHub Codespaces
 
 . From the repository on GitHub, click **Code > Codespaces > ... > New with options**.
-. Choose the **{{PROJECT_NAME}} (Docker / Codespaces)** configuration.
+. Choose the **heron-polyfeed-reader (Docker / Codespaces)** configuration.
 
 == Gitpod
 
@@ -56,6 +56,6 @@ bunx @devcontainers/cli up --workspace-folder . --docker-path podman
 
 == Customization
 
-Replace the `{{PROJECT_NAME}}` placeholders in both `devcontainer.json` files and
+Replace the `heron-polyfeed-reader` placeholders in both `devcontainer.json` files and
 the `Containerfile` with your actual project name. `just deps` runs automatically
 after the container is created. Run it again to check the environment.

.devcontainer/devcontainer.json

@@ -1,13 +1,13 @@
 // SPDX-License-Identifier: MPL-2.0
-// Copyright (c) {{CURRENT_YEAR}} {{AUTHOR}} ({{OWNER}}) <{{AUTHOR_EMAIL}}>
+// Copyright (c) 2026 Jonathan D.A. Jewell (hyperpolymath) <j.d.a.jewell@open.ac.uk>
 //
-// Dev Container configuration for {{PROJECT_NAME}} — rootless Podman (default).
+// Dev Container configuration for heron-polyfeed-reader — rootless Podman (default).
 // Works with: VS Code Dev Containers with `dev.containers.dockerPath` = podman,
 // and the devcontainer CLI (`devcontainer up --docker-path podman`).
 // Docker, GitHub Codespaces and Gitpod: use .devcontainer/docker/devcontainer.json
 // instead — Docker rejects the Podman-only `--userns=keep-id` below.
 {
-  "name": "{{PROJECT_NAME}} (Podman)",
+  "name": "heron-polyfeed-reader (Podman)",
 
   "build": {
     "dockerfile": "Containerfile",

.devcontainer/docker/devcontainer.json

@@ -1,12 +1,12 @@
 // SPDX-License-Identifier: MPL-2.0
-// Copyright (c) {{CURRENT_YEAR}} {{AUTHOR}} ({{OWNER}}) <{{AUTHOR_EMAIL}}>
+// Copyright (c) 2026 Jonathan D.A. Jewell (hyperpolymath) <j.d.a.jewell@open.ac.uk>
 //
-// Dev Container configuration for {{PROJECT_NAME}} — Docker engines.
+// Dev Container configuration for heron-polyfeed-reader — Docker engines.
 // Works with: GitHub Codespaces, Gitpod, and VS Code Dev Containers on Docker.
 // The estate default is rootless Podman: .devcontainer/devcontainer.json.
 // Same image (../Containerfile); only the user-namespace settings differ.
 {
-  "name": "{{PROJECT_NAME}} (Docker / Codespaces)",
+  "name": "heron-polyfeed-reader (Docker / Codespaces)",
 
   "build": {
     "dockerfile": "../Containerfile",

.dockerignore

@@ -0,0 +1,15 @@
+.zig-cache
+zig-out
+.git
+*.db*
+# Estate scaffolding that the Zig build does not read (build.zig.zon .paths lists what the package is)
+.github
+.machine_readable
+archetypes
+ci
+docs
+features
+session
+tests
+verification
+www

.editorconfig

@@ -1,6 +1,6 @@
 # SPDX-License-Identifier: MPL-2.0
 # Hyperpolymath estate canonical .editorconfig  (standards#343 phase 1)
-# Canon lives in rsr-template-repo; do not add a per-repo name to this header.
+# Canon lives in heron-polyfeed-reader; do not add a per-repo name to this header.
 # https://editorconfig.org
 
 root = true

.envrc

@@ -13,7 +13,7 @@ if has guix && [ -f build/manifest.scm ]; then
 fi
 
 # Project environment variables
-export PROJECT_NAME="{{PROJECT_NAME}}"
+export PROJECT_NAME="heron-polyfeed-reader"
 export RSR_TIER="infrastructure"
 # Add non-secret project env vars above (e.g. DATABASE_URL, service endpoints).
 # Real secrets belong in .env (gitignored) — never commit them to .envrc.

.gitattributes

@@ -1,6 +1,6 @@
 # SPDX-License-Identifier: MPL-2.0
 # Hyperpolymath estate canonical .gitattributes  (standards#343 phase 1)
-# Canon lives in rsr-template-repo; do not add a per-repo name to this header.
+# Canon lives in heron-polyfeed-reader; do not add a per-repo name to this header.
 #
 # Only diff drivers that git actually ships are used here. MEASURED on git
 # 2.47.3: diff=go and diff=zig are NOT drivers (git silently falls back to the

.github/CODEOWNERS

@@ -2,14 +2,14 @@
 # CODEOWNERS - Define code review assignments
 # See: https://docs.github.com/en/repositories/managing-your-repositorys-settings-and-features/customizing-your-repository/about-code-owners
 #
-# Replace {{OWNER}} with your GitHub username or team
+# Replace hyperpolymath with your GitHub username or team
 
 # Default owners for everything
-* @{{OWNER}}
+* @hyperpolymath
 
 # Security-sensitive files require explicit review
-SECURITY.md @{{OWNER}}
-.github/workflows/ @{{OWNER}}
-.machine_readable/contractiles/trust/ @{{OWNER}}
-*_chora.deed @{{OWNER}}
-.machine_readable/ @{{OWNER}}
+SECURITY.md @hyperpolymath
+.github/workflows/ @hyperpolymath
+.machine_readable/contractiles/trust/ @hyperpolymath
+*_chora.deed @hyperpolymath
+.machine_readable/ @hyperpolymath

.github/CODE_OF_CONDUCT.md

@@ -4,29 +4,9 @@ Copyright (c) Jonathan D.A. Jewell <j.d.a.jewell@open.ac.uk>
 -->
 # Code of Conduct
 
-<!-- 
-============================================================================
-TEMPLATE INSTRUCTIONS (delete this block before publishing)
-============================================================================
-Replace all {{PLACEHOLDER}} values:
-  rsr-template-repo     - Your project name
-  hyperpolymath            - GitHub/GitLab username or org
-  rsr-template-repo             - Repository name
-  {{CONDUCT_EMAIL}}    - Email for conduct reports
-  {{CONDUCT_TEAM}}     - Name of conduct team/committee
-  {{RESPONSE_TIME}}    - Initial response SLA (e.g., 48 hours)
-  {{CURRENT_YEAR}}     - Current year
-
-Review and customise:
-- Adjust enforcement ladder for your community size
-- Add/remove examples based on your context
-- Ensure contact methods work for your team
-============================================================================
--->
-
 ## Our Pledge
 
-We as members, contributors, and leaders pledge to make participation in rsr-template-repo a harassment-free experience for everyone, regardless of age, body size, visible or invisible disability, ethnicity, sex characteristics, gender identity and expression, level of experience, education, socio-economic status, nationality, personal appearance, race, caste, colour, religion, or sexual identity and orientation.
+We as members, contributors, and leaders pledge to make participation in heron-polyfeed-reader a harassment-free experience for everyone, regardless of age, body size, visible or invisible disability, ethnicity, sex characteristics, gender identity and expression, level of experience, education, socio-economic status, nationality, personal appearance, race, caste, colour, religion, or sexual identity and orientation.
 
 We pledge to act and interact in ways that contribute to an open, welcoming, diverse, inclusive, and healthy community.
 
@@ -140,7 +120,7 @@ If you experience or witness unacceptable behaviour, or have any other concerns,
 
 | Method | Details | Best For |
 |--------|---------|----------|
-| **Email** | {{CONDUCT_EMAIL}} | Detailed reports, sensitive matters |
+| **Email** | j.d.a.jewell@open.ac.uk | Detailed reports, sensitive matters |
 | **Private Message** | Contact any maintainer directly | Quick questions, minor issues |
 
 **What to Include**
@@ -155,8 +135,8 @@ If you experience or witness unacceptable behaviour, or have any other concerns,
 
 **What Happens Next**
 
-1. You will receive acknowledgment within **{{RESPONSE_TIME}}**
-2. The {{CONDUCT_TEAM}} will review the report
+1. You will receive acknowledgment within **48 hours**
+2. The Code of Conduct Committee will review the report
 3. We may ask for additional information
 4. We will determine appropriate action
 5. We will inform you of the outcome (respecting others' privacy)
@@ -172,7 +152,7 @@ All reports will be handled with discretion:
 
 ### Conflicts of Interest
 
-If the {{CONDUCT_TEAM}} are themselves involved in an incident:
+If the Code of Conduct Committee are themselves involved in an incident:
 
 - They will recuse themselves from the process
 - Another maintainer or external party will handle the report
@@ -182,7 +162,7 @@ If the {{CONDUCT_TEAM}} are themselves involved in an incident:
 
 ## Enforcement Guidelines
 
-The {{CONDUCT_TEAM}} will follow these guidelines in determining consequences:
+The Code of Conduct Committee will follow these guidelines in determining consequences:
 
 ### 1. Correction
 
@@ -242,13 +222,13 @@ For contributors with elevated access (Perimeter 2 or 1):
 If you believe an enforcement decision was made in error:
 
 1. **Wait 7 days** after the decision (cooling-off period)
-2. **Email** {{CONDUCT_EMAIL}} with subject line "Appeal: [Original Report ID]"
+2. **Email** j.d.a.jewell@open.ac.uk with subject line "Appeal: [Original Report ID]"
 3. **Explain** why you believe the decision should be reconsidered
 4. **Provide** any new information not previously available
 
 **Appeals Process**
 
-- Appeals are reviewed by the {{CONDUCT_TEAM}}, excluding anyone involved in the original
+- Appeals are reviewed by the Code of Conduct Committee, excluding anyone involved in the original
 - You will receive a response within 14 days
 - The appeals decision is final
 - You may only appeal once per incident
@@ -321,8 +301,8 @@ We thank these communities for their leadership in creating welcoming spaces.
 
 If you have questions about this Code of Conduct:
 
-- Open a [Discussion](https://github.com/hyperpolymath/rsr-template-repo/discussions) (for general questions)
-- Email {{CONDUCT_EMAIL}} (for private questions)
+- Open a [Discussion](https://github.com/hyperpolymath/heron-polyfeed-reader/discussions) (for general questions)
+- Email j.d.a.jewell@open.ac.uk (for private questions)
 - Contact any maintainer directly
 
 ---
@@ -335,4 +315,4 @@ We're all here because we care about this project. Let's make it a place where e
 
 ---
 
-<sub>Last updated: {{CURRENT_YEAR}} · Based on Contributor Covenant 2.1</sub>
+<sub>Last updated: 2026 · Based on Contributor Covenant 2.1</sub>

.github/CONTRIBUTING.md

@@ -4,15 +4,15 @@ Copyright (c) Jonathan D.A. Jewell <j.d.a.jewell@open.ac.uk>
 -->
 ```
 # Clone the repository
-git clone https://github.com/hyperpolymath/rsr-template-repo.git
-cd rsr-template-repo
+git clone https://github.com/hyperpolymath/heron-polyfeed-reader.git
+cd heron-polyfeed-reader
 
 # Using Guix (recommended for reproducibility)
 guix shell -D -f build/guix.scm
 
 # Or using toolbox/distrobox
-toolbox create rsr-template-repo-dev
-toolbox enter rsr-template-repo-dev
+toolbox create heron-polyfeed-reader-dev
+toolbox enter heron-polyfeed-reader-dev
 # Install dependencies manually
 
 # Verify setup
@@ -39,7 +39,7 @@ which is precisely why the map is now generated rather than typed.
 
 **Before reporting**:
 1. Search existing issues
-2. Check if it's already fixed in `{{MAIN_BRANCH}}`
+2. Check if it's already fixed in `main`
 3. Determine which perimeter the bug affects
 
 **When reporting**:
@@ -72,10 +72,10 @@ Use the [feature request template](.github/ISSUE_TEMPLATE/feature_request.md) an
 
 Look for issues labelled:
 
-- [`good first issue`](https://github.com/hyperpolymath/rsr-template-repo/labels/good%20first%20issue) — Simple Perimeter 3 tasks
-- [`help wanted`](https://github.com/hyperpolymath/rsr-template-repo/labels/help%20wanted) — Community help needed
-- [`documentation`](https://github.com/hyperpolymath/rsr-template-repo/labels/documentation) — Docs improvements
-- [`perimeter-3`](https://github.com/hyperpolymath/rsr-template-repo/labels/perimeter-3) — Community sandbox scope
+- [`good first issue`](https://github.com/hyperpolymath/heron-polyfeed-reader/labels/good%20first%20issue) — Simple Perimeter 3 tasks
+- [`help wanted`](https://github.com/hyperpolymath/heron-polyfeed-reader/labels/help%20wanted) — Community help needed
+- [`documentation`](https://github.com/hyperpolymath/heron-polyfeed-reader/labels/documentation) — Docs improvements
+- [`perimeter-3`](https://github.com/hyperpolymath/heron-polyfeed-reader/labels/perimeter-3) — Community sandbox scope
 
 ---
 

.github/GOVERNANCE.md

@@ -4,13 +4,13 @@ Copyright (c) Jonathan D.A. Jewell <j.d.a.jewell@open.ac.uk>
 -->
 # Project Governance
 
-This document describes the governance model for **{{PROJECT_NAME}}**.
+This document describes the governance model for **heron-polyfeed-reader**.
 
 ---
 
 ## Project Governance Model
 
-{{PROJECT_NAME}} follows a **Benevolent Dictator For Life (BDFL)** governance model.
+heron-polyfeed-reader follows a **Benevolent Dictator For Life (BDFL)** governance model.
 This model is well-suited for solo maintainers and small project teams where rapid,
 consistent decision-making is more valuable than formal consensus processes.
 
@@ -157,4 +157,4 @@ with the community before adoption, even though the BDFL retains final authority
 
 ---
 
-<sub>Copyright (c) {{CURRENT_YEAR}} {{OWNER}}. Licensed under MPL-2.0.</sub>
+<sub>Copyright (c) 2026 hyperpolymath. Licensed under MPL-2.0.</sub>

.github/ISSUE_TEMPLATE/config.yml

@@ -6,8 +6,8 @@
 blank_issues_enabled: true
 contact_links:
   - name: Security vulnerability
-    url: https://{{FORGE}}/{{OWNER}}/{{REPO}}/security/advisories/new
+    url: https://github.com/hyperpolymath/heron-polyfeed-reader/security/advisories/new
     about: Report privately via a security advisory. Do NOT open a public issue.
   - name: Question or support request
-    url: https://{{FORGE}}/{{OWNER}}/{{REPO}}/discussions
+    url: https://github.com/hyperpolymath/heron-polyfeed-reader/discussions
     about: Ask a question. See .github/SUPPORT.md for what to expect.