chore(docs): convert README.md to README.adoc — adoc is estate standard

Author: hyperpolymath

README.adoc

@@ -0,0 +1,58 @@
+// SPDX-License-Identifier: MPL-2.0
+// (PMPL-1.0-or-later preferred; MPL-2.0 required for Hex.pm ecosystem)
+
+= a2ml_gleam
+:toc: preamble
+:icons: font
+
+image:https://api.securityscorecards.dev/projects/github.com/hyperpolymath/a2ml_gleam/badge[OpenSSF Scorecard,link="https://securityscorecards.dev/viewer/?uri=github.com/hyperpolymath/a2ml_gleam"]
+
+A2ML (AI Attestation Markup Language) parser and renderer for Gleam.
+
+== Overview
+
+A pure Gleam library for parsing, manipulating, and rendering A2ML documents.
+A2ML is a lightweight markup language for expressing AI attestations, trust
+levels, and verification metadata.
+
+== Features
+
+* Full A2ML parser with error reporting
+* Renderer for A2ML document output
+* Trust level handling (Unverified, Automated, Reviewed, Verified)
+* Attestation and directive support
+* Manifest extraction
+* Roundtrip fidelity (parse then render preserves structure)
+
+== Installation
+
+[source,sh]
+----
+gleam add a2ml_gleam
+----
+
+== Usage
+
+[source,gleam]
+----
+import a2ml_gleam/parser
+import a2ml_gleam/renderer
+
+let assert Ok(doc) = parser.parse("# My Document\n\n@version 1.0")
+let output = renderer.render(doc)
+----
+
+== Testing
+
+[source,sh]
+----
+gleam test
+----
+
+Wondering how this works? See link:EXPLAINME.adoc[].
+
+== License
+
+SPDX-License-Identifier: MPL-2.0 +
+(PMPL-1.0-or-later preferred; MPL-2.0 required for Hex.pm ecosystem) +
+See link:LICENSE[LICENSE].