refactor: migrate Markdown to AsciiDoc

ARCHITECTURE.adoc

@@ -0,0 +1,48 @@
+== Architecture
+
+=== Overview
+
+This repository follows a modular, maintainable architecture designed
+for clarity, scalability, and long-term sustainability.
+
+=== Directory Structure
+
+....
+.
+├── src/           # Source code
+├── tests/        # Test suites
+├── docs/         # Documentation
+├── scripts/      # Utility scripts
+├── config/       # Configuration files
+├── LICENSE       # License file
+├── LICENSES/     # Full license texts
+└── README.adoc   # Project documentation
+....
+
+=== Design Principles
+
+* *Separation of Concerns*: Each module has a single responsibility
+* *Testability*: Code is written to be easily testable
+* *Documentation*: All public APIs are documented
+* *Configuration*: Environment-specific settings are externalized
+
+=== Dependencies
+
+* External dependencies are minimized and clearly declared
+* Version pinning is used for reproducibility
+
+=== Security Considerations
+
+* Sensitive data is never committed to the repository
+* Secrets are managed through environment variables or secure vaults
+* Regular dependency audits are performed
+
+=== Maintainability
+
+* Code follows consistent style guidelines
+* Pull requests require review and CI checks
+* Issues and discussions are tracked transparently
+
+'''''
+
+_Last updated: 2026-07-18_

CHANGELOG.adoc

@@ -1,41 +1,69 @@
-// SPDX-License-Identifier: CC-BY-SA-4.0
-// Copyright (c) Jonathan D.A. Jewell <j.d.a.jewell@open.ac.uk>
-= Changelog
+== Changelog
 
-All notable changes to this project will be documented in this file.
+All notable changes to `+thejeffparadox+` will be documented in this
+file.
 
-The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
-and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+This file is generated from conventional commits by the
+https://github.com/hyperpolymath/standards/blob/main/.github/workflows/changelog-reusable.yml[`+changelog-reusable.yml+`]
+workflow (`+hyperpolymath/standards#206+`). Adopt the workflow in this
+repo’s CI to keep this file in sync automatically — see
+https://github.com/hyperpolymath/standards/blob/main/templates/cliff.toml[`+templates/cliff.toml+`]
+for the canonical config.
 
-== [Unreleased]
+The format follows https://keepachangelog.com/en/1.1.0/[Keep a
+Changelog]; this project aims to follow
+https://semver.org/spec/v2.0.0.html[Semantic Versioning].
 
-=== Added
+=== [Unreleased]
 
-- Initial Julia game engine with anti-convergence mechanisms
-- Hugo sites for orchestrator, node-alpha, node-beta
-- GitHub Actions CI/CD with SHA-pinned actions
-- Containerfile for Wolfi-based deployment
-- Comprehensive documentation (claude.adoc, whitepaper)
-- RSR compliance infrastructure
+==== Added
 
-=== Fixed
+* feat(engine): improve LLM client error handling and recovery
+* feat: implement metrics_trend/detect_emergent_patterns, add SPDX
+headers
+* feat: add CRG Grade B test suite (6 targets)
 
-- JeffEngine module exports and include order
-- GitHub Actions SHA pinning for all dependencies
-- Hugo theme configuration
+==== Fixed
 
-== [0.1.0] - 2025-11-29
+* fix(ci): sync hypatia-scan.yml to canonical (kill cd-scanner build
+drift) (#28)
+* fix(ci): build Hypatia escript from repo root (estate dogfood drift)
+* fix(ci): Phase-2 fleet submission must not fail the security gate
+(#25)
+* fix(ci): rsr-antipattern.yml duplicate heredoc (#24)
+* fix: remove boilerplate README, fix ABI template, harden CI (#2)
+* fix: remove boilerplate README, fix ABI template, harden CI
+* fix: create missing metrics.jl, fix README, rate limiter, and Ada
+parser (#1)
 
-=== Added
+==== Changed
 
-- Initial project structure
-- Core game mechanics (chaos, exposure, faction)
-- Anti-convergence system (conceptors)
-- LLM client abstraction (Anthropic, Mistral, local)
-- Metrics collection framework
-- Accessibility-first Hugo layouts
+* refactor: split llm_client, wire aperture control, expand tests
 
----
+==== Documentation
 
-Based on the original [The Jeff Paradox](https://criticalkit.us/products/the-jeff-paradox)
-TTRPG by Tim Roberts / Critical Kit LLC.
+* docs(readme): add SPDX header, OSSF and GWF badges
+* docs(explainme): add EXPLAINME.adoc
+* docs: remove conflicting placeholder README and fix license
+declarations
+
+==== CI
+
+* ci: bump actions/upload-artifact SHA to current v4 (#23)
+* ci(antipattern): fix top-level dir matching + benchmarks/lsp/bench
+filename allowlists (#17)
+* ci(antipattern): TS check reads .claude/CLAUDE.md exemption table
+(#16)
+* ci(antipattern): broaden TS allowlist (cli/, mod.ts, lsp-server,
+_vscode_, deno-*) (#15)
+* ci(antipattern): allowlist legit TS bridge/adapter paths (#14)
+
+=== Pre-history
+
+Prior commits to this file’s introduction are recorded in git history
+but not formally classified into Keep-a-Changelog sections. To backfill,
+run `+git cliff -o CHANGELOG.md+` locally using the canonical
+https://github.com/hyperpolymath/standards/blob/main/templates/cliff.toml[`+cliff.toml+`]
+— this is one-shot mechanical work.
+
+'''''

CODE_OF_CONDUCT.adoc

@@ -0,0 +1,45 @@
+== Code of Conduct
+
+=== Our Pledge
+
+We pledge to make participation in The Jeff Paradox project a
+harassment-free experience for everyone, regardless of age, body size,
+disability, ethnicity, sex characteristics, gender identity and
+expression, level of experience, education, socio-economic status,
+nationality, personal appearance, race, religion, or sexual identity and
+orientation.
+
+=== Our Standards
+
+*Positive behaviours include:*
+
+* Using welcoming and inclusive language
+* Being respectful of differing viewpoints and experiences
+* Gracefully accepting constructive criticism
+* Focusing on what is best for the community
+* Showing empathy towards other community members
+
+*Unacceptable behaviours include:*
+
+* Trolling, insulting/derogatory comments, and personal or political
+attacks
+* Public or private harassment
+* Publishing others’ private information without explicit permission
+* Other conduct which could reasonably be considered inappropriate
+
+=== Enforcement
+
+Project maintainers are responsible for clarifying standards and will
+take appropriate and fair corrective action in response to any
+unacceptable behaviour.
+
+Instances of abusive, harassing, or otherwise unacceptable behaviour may
+be reported to the project team. All complaints will be reviewed and
+investigated.
+
+=== Attribution
+
+This Code of Conduct is adapted from the
+https://www.contributor-covenant.org[Contributor Covenant], version 2.1,
+available at
+https://www.contributor-covenant.org/version/2/1/code_of_conduct.html