v0.1.0-pre

[0.1.0-pre] — 2026-04-22

Added

• Protocol specification (PROTOCOL.md) and prior-art survey (PRIOR-ART.md)
• 14 demonstration instruments across 7 authorities (Utah OAIP, SEC Corp Fin, CFPB, IRS Chief Counsel, IRS TEGE, CFTC DSIO, Utah Legislature) and 7 instrument types (JIA, RMA, no-action letter, advisory opinion, private letter ruling, interpretive letter, statute)
• 26 first-class obligation records mapped to instruments via data/examples/mapping/index.yml (14 mapping entries covering every instrument in the registry)
• Canonical hierarchical URL architecture: /{country}/{jurisdiction}/{authority}/{type}/{instance}/; stable identifier scheme {jurisdiction}-{authority}-{kind}-{YYYY-NNN}; 301 redirect stubs from legacy /container/{id}/ paths
• Four Utah statutes ingested as first-class instrument records (SB 149, SB 226, HB 452, HB 320)
• Status vocabulary (9 values) with DEFINITIONS.md and rendered /definitions/ page
• Disclaimer & Source Policy at /reference/disclaimer/
• Frontmatter spec v0.2: decoupled @type from obligation_kind; shared interpretive-instrument core fields; withdrawal triplet; redaction_level; renderer-composed disclaimer
• JSON Schemas (schema/jia.schema.json, schema/rma.schema.json); JSON-LD context (schema/context.jsonld) binding to Semantic Arts gist IRIs
• JSON Schema draft 2020-12 at /schema/json/record.schema.json for the record.json payload shape
• MANIFEST.yaml with skill-provenance-style SHA-256 hash integrity across every canonical file
• 5 JIA/RMA templates under _templates/
• Unified site generator (scripts/build.js + scripts/build-extras.js); cross-reference validator (scripts/validate.js); structural validator (scripts/verify.js); hash validator (scripts/validate-hashes.sh); link checker; OCR helper
• JSON API under /api/v1/ (containers, primaries, authorities, mappings, matrix, comparisons, upcoming, recently-changed, index manifest)
• Source PDFs + OCR text co-located with Utah OAIP RMA records
• calendar.ics (iCal enforcement calendar); feed.xml (RSS 2.0); feed.json (JSON Feed 1.1); atom.xml (Atom 1.0)
• Agent-discovery surfaces: llms.txt, agents.json, robots.txt with explicit allow for 25 AI and SEO crawlers
• Schema.org JSON-LD across the site: LegalDocument on every record; WebSite + Organization + DataCatalog @graph on the homepage; ItemList on /instruments.html, /obligations.html, /authorities.html; Dataset on /matrix.html; DefinedTermSet on /definitions/; Article on /about/; DigitalDocument on /reference/disclaimer/
• Split sitemap index with 7 per-section sitemaps (records, authorities, statutes, reference, templates, bridges, meta)
• MCP server (mcp-server.js) exposing 13 read-only tools: filtered instrument listing, URL-based fetch, entity-scoped search, coverage matrix, mappings, upcoming milestones, recently-changed records
• Reference pages: Protocol, Prior Art, Registry, Vocabulary, Disclaimer
• Jurisdiction index pages at every hierarchy level (/us/, /us/utah/, /us/utah/oaip/, etc.)
• Utah landing at /us/utah/ with narrative + four-chapter statute map
• Browseable UI: per-column sort/filter, keyboard shortcuts (/, ?, j/k), rich ARIA search, freshness badges, anchor-copy buttons, print stylesheet, jurisdiction chips, prev/next sibling nav, changelog strip, schema-completeness warnings
• publedge-source-ingest skill for authored ingestion
• Agent-readiness audit artifact at audits/agent-readiness-2026-04-22.md

Changed

• Registry-as-Dataset positioning throughout: homepage, README, and llms.txt emphasize DataCatalog semantics rather than service-site patterns
• Status defaults for permission and enforcing colors moved to a WCAG 2.1 AA compliant green (#1f7a43, 5.8:1 on white) in project.yml
• Dark-mode foreground colors remapped to the link token so navy-on-dark text selectors pass 4.5:1 contrast
• Open Graph og:image URL concatenation corrected (prior //imgs/og.png double slash); twitter:site no longer emits [object Object] from the YAML empty-string parser path
• Homepage og:title now includes site name + tagline instead of bare "Home"
• Homepage "Obligations" section replaced with a three-card group summary (Requirements / Restrictions / Permissions) plus a four-card "Most cross-cutting" row

Fixed

• Axe-core WCAG 2.1 AA violations: color-contrast (34 instances), link-name on compare bridge CTAs (2 instances), region landmark on site banner (33 instances), heading-order on /reference/ (1 instance)
• Favicon 404: <link rel="icon" href="/favicon.svg" type="image/svg+xml"> declared on every generated and hand-authored page
• NaNd rendering in upcoming-milestones widget when a record has effective: null (YAML parser returned string "null")
• Nested <a> inside <a> in homepage "Use PubLedge" card grid; cards now use <div> with a linked title
• generateCompareBridge emitted empty CTA anchors because containers use .title not .name; fixed the fallback chain

Infrastructure

• GitHub Pages source set to main /docs
• CI: pa11y-ci WCAG 2.1 AA pass across every URL in the sitemap on every push and pull request; docs/ sync check; hash validation
• .gitignore aligned to portfolio hygiene baseline (.env.* glob, __pycache__/, *.pyc, dist/, build/, .venv/, venv/)