refactor(root): move root artefacts to their canonical locations (#122)

refactor(root): move root artefacts to their canonical locations

Applies the estate root-shape rollout: files that are not root-level by
necessity move to where their tooling and the estate canon expect them,
and
every reference to them is updated in the same change.

  * .github/hooks/validate-a2ml.sh
      (from .githooks/validate-a2ml.sh)
      ->   .github/hooks/validate-a2ml.sh
  * .github/hooks/validate-k9.sh
      (from .githooks/validate-k9.sh)
      ->   .github/hooks/validate-k9.sh
  * .github/workflows/dogfood-gate.yml
  * QUICKSTART-MAINTAINER.adoc
  * build/guix.scm
      (from guix.scm)
      ->   build/guix.scm
  * .github/CONTRIBUTING.md
      (new)
  * CONTRIBUTING.adoc
      (deleted)
  * docs/accessibility/README.adoc

Verified with `git apply --check` against current main before
committing; no
behaviour change intended, the Justfile entry points keep working.

Author: hyperpolymath

.github/CONTRIBUTING.md

@@ -0,0 +1,122 @@
+# Contributing to RPA Elysium
+
+We welcome contributions! Please read this guide before submitting.
+
+## Development Setup
+
+``` bash
+# Clone the repository
+git clone https://github.com/hyperpolymath/rpa-elysium.git
+cd rpa-elysium
+
+# Build and test
+just check   # fmt + lint + test
+just build   # Release build
+
+# Or individually
+cargo build --workspace
+cargo test --workspace
+cargo clippy --workspace --all-targets -- -D warnings
+```
+
+## Repository Structure
+
+    rpa-elysium/
+    ├── crates/               # Rust workspace crates
+    │   ├── rpa-core/         # Core types, traits, abstractions
+    │   ├── rpa-plugin/       # WASM plugin system
+    │   └── rpa-fs-workflow/  # Filesystem automation CLI (MVP)
+    ├── src/abi/              # Idris2 ABI definitions
+    ├── ffi/zig/              # Zig FFI implementation
+    ├── services/             # Backend services (Gleam)
+    ├── examples/             # Example workflow configs
+    ├── hooks/                # Validation scripts (pre-commit)
+    ├── .github/workflows/    # CI/CD pipelines (18 workflows)
+    ├── .machine_readable/    # A2ML project metadata
+    ├── contractiles/         # Governance contracts (K9, must/trust/dust)
+    └── justfile              # Build automation
+
+## Language Policy
+
+This project follows the [Hyperpolymath Language
+Policy](.claude/CLAUDE.md):
+
+| Allowed      | Use Case                  |
+|--------------|---------------------------|
+| **Rust**     | Core framework, WASM, CLI |
+| **ReScript** | Management console UI     |
+| **Gleam**    | Backend services (BEAM)   |
+| **Deno**     | JS runtime (not Node.js)  |
+| **Idris2**   | ABI definitions           |
+| **Zig**      | FFI implementation        |
+| **Bash**     | Scripts, automation       |
+
+**Banned**: TypeScript, Node.js, npm, Go, Python, Java, Kotlin, Swift.
+
+## Branch Naming
+
+    feat/short-description       # New features
+    fix/issue-number-description # Bug fixes
+    docs/short-description       # Documentation
+    test/what-added              # Test additions
+    refactor/what-changed        # Code improvements
+    security/what-fixed          # Security fixes
+
+## Commit Messages
+
+We follow [Conventional Commits](https://www.conventionalcommits.org/):
+
+    <type>(<scope>): <description>
+
+    [optional body]
+
+    [optional footer]
+
+Types: `feat`, `fix`, `docs`, `test`, `refactor`, `security`, `chore`,
+`ci`
+
+Scopes: `core`, `plugin`, `fs-workflow`, `abi`, `ffi`, `services`, `ci`
+
+## Pull Request Process
+
+1.  Fork the repository and create a feature branch
+
+2.  Ensure `just` `check` passes (fmt, lint, test)
+
+3.  All SPDX headers must be `MPL-2.0`
+
+4.  All GitHub Actions must be SHA-pinned
+
+5.  No banned language code introduced
+
+6.  Submit PR against `main` with descriptive title and body
+
+## Code Standards
+
+- All source files must have SPDX license headers
+
+- All code must pass `cargo` `clippy` `--` `-D` `warnings`
+
+- All code must be formatted with `cargo` `fmt`
+
+- Test coverage target: 80%+
+
+- No hardcoded secrets, credentials, or API keys
+
+- HTTPS only — no HTTP URLs
+
+## Reporting Bugs
+
+Use the [bug report template](.github/ISSUE_TEMPLATE/bug_report.md).
+Include: - Environment details (OS, Rust version, etc.) - Steps to
+reproduce - Expected vs actual behaviour
+
+## Suggesting Features
+
+Use the [feature request
+template](.github/ISSUE_TEMPLATE/feature_request.md). Include: - Problem
+statement - Proposed solution - Which crate/component this affects
+
+## License
+
+All contributions are licensed under MPL-2.0.

.githooks/validate-a2ml.sh .github/hooks/validate-a2ml.sh.githooks/validate-a2ml.sh renamed to .github/hooks/validate-a2ml.sh

@@ -35,7 +35,7 @@ jobs:
           fi
       - name: Validate A2ML manifests
         if: steps.detect.outputs.count > 0
-        run: bash .githooks/validate-a2ml.sh
+        run: bash .github/hooks/validate-a2ml.sh
       - name: Write summary
         run: |
           A2ML_COUNT="${{ steps.detect.outputs.count }}"
@@ -76,7 +76,7 @@ jobs:
           fi
       - name: Validate K9 contracts
         if: steps.detect.outputs.k9_count > 0
-        run: bash .githooks/validate-k9.sh
+        run: bash .github/hooks/validate-k9.sh
       - name: Write summary
         run: |
           K9_COUNT="${{ steps.detect.outputs.k9_count }}"

.githooks/validate-k9.sh .github/hooks/validate-k9.sh.githooks/validate-k9.sh renamed to .github/hooks/validate-k9.sh

@@ -32,7 +32,7 @@ Output: `{{BUILD_OUTPUT_PATH}}`
 
 [source,bash]
 ----
-guix build -f guix.scm
+guix build -f build/guix.scm
 ----
 
 === Nix

.github/workflows/dogfood-gate.yml

@@ -244,7 +244,7 @@ Burble is committed to:
 * Supporting screen readers and other assistive technologies
 * Continuous improvement based on user feedback
 
-We welcome contributions to improve accessibility. See our link:../CONTRIBUTING.adoc[Contributing Guide] for details.
+We welcome contributions to improve accessibility. See our link:../../.github/CONTRIBUTING.md[Contributing Guide] for details.
 
 == Related Documents