Skip to content

About

AURA Pattern Library — 1,550 signed, gate-verified reference files across six languages (Python · C++ · Go · Rust · R · JavaScript). 1,074 unique pattern IDs; each file carries its own self-test, visible attribution mark, and Ed25519 signature. Apache-2.0.

Resources

Code of conduct

Contributing

Security policy

Stars

1 star

Watchers

0 watching

Forks

Latest commit

 

History

129 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

AURA Pattern Library

Verified, attributed, multi-language reference patterns. Every file runs; every file is marked and signed. © Reality Optimizer.

The AURA Pattern Library is a curated set of implementation patterns across languages and spheres. Its distinguishing discipline: verification is the entry criterion — every pattern is independently run-gated, and nothing that fails the honesty gate ships. Each file carries a visible attribution mark, invisible tracing channels, and a cryptographic signature.

What's inside

Language / sphere Patterns Gate Signature
python/programming 99 run-gated Ed25519 signed
python/data-science 377 run-gated Ed25519 signed
python/system-administration 200 run-gated Ed25519 signed
r/ 60 run-gated Ed25519 signed
cpp/ 420 g++ and clang, -std=c++17 -pedantic Ed25519 signed
rust/ 200 rustc -O -D warnings Ed25519 signed
go/programming 45 go build + run + 3× determinism Ed25519 signed
go/system-administration 58 go build + run + 3× determinism Ed25519 signed
javascript/ 91 node (exit 0) Ed25519 signed

1,550 verified files across six languages · 1,074 unique pattern IDs · nine shelves, 145 categories. (Each stem that lives in two or more spheres — e.g. circuit_breaker in programming, sysadmin and rust-systems — counts once in unique IDs and once per sphere in the raw file count; CATALOG.md is the ID-keyed master.) Re-counted from disk by build_patterns_index.py 2026-10-17; the catalog is being regenerated to reflect this same recount — the row-table trails the file count on disk. JavaScript, like Python and R, is a source lane — its patterns were written directly in the language and have no twins, which is why the two-or-more-languages count is unchanged. Language twins are strictly downstream of their Python/R source: each carries the source's proven claims (same assert, same tolerance) and is coupling-pinned to the source's hash. Four data-science patterns are excluded from the tree entirely (assert-linter REJECTs, listed in _quarantine/QUARANTINE.md) and are not shipped.

Browse every pattern

PATTERNS_INDEX.md — a direct link and a description for every one of the 1,550 files, grouped by shelf and category, with each pattern's language twins named. Descriptions are extracted from the files themselves at generation time, so the index cannot drift from the code; regenerate with python3 build_patterns_index.py.

JavaScript lane — measured limits. Every JS pattern has a companion .md recording what its self-test actually proves and its known defects, plus javascript/ROBUSTNESS.md — the measured behaviour of all 91 patterns on six input classes beyond their own fixtures. This sweep has been run on the JavaScript lane only; the other lanes carry generated verification evidence and have not been measured this way.

Layout

python/{programming,data-science,system-administration}/<category>/<pattern>.py
r/<category>/<pattern>.R
cpp/data-science/<category>/<pattern>.cpp      # language twins, final-approved only
rust/<category>/<pattern>.rs
go/<shelf>/<category>/<pattern>.go
javascript/<category>/<pattern>.js
_quarantine/                   # excluded, with reason + date
PATTERNS_INDEX.md              # every pattern: direct link + description + twins
CATALOG.md                     # ID-keyed master: pattern ID -> languages + category
MANIFEST.json                  # machine-readable index
library_verify.py              # the library's CI (run it)
build_patterns_index.py        # regenerates PATTERNS_INDEX.md from the files themselves
tag_folders.py                 # semantic identity: a .folder-nature in every folder
SYNC.md                        # how the snapshot re-pulls from its sources

Every folder also carries a .folder-nature — machine-readable semantic identity (being / purpose / tags) — enforced tree-wide by .folder-nature-root.yaml (require_nature: true), so the full folder-nature stack is live here: identity + mark + signature.

The basename is the canonical pattern ID: cpp/data-science/streaming_and_sketches/hyperloglog_distinct.cpp shares the ID of python/data-science/streaming_and_sketches/hyperloglog_distinct.py.

Attribution, not prevention (the honest boundary)

  • The watermark answers who holds this copy — visible mark + invisible redundant channels that survive reformatting, for leak-tracing.
  • The signature answers whether files are genuinely ours and unaltered.
  • Neither prevents copying — you cannot prevent copying on someone's own disk. They make a copy checkable. That is the whole claim, and the only one.

Marks and signatures are produced by folder-nature.

Verify it yourself

python3 library_verify.py            # signatures + watermarks + catalog parity
python3 library_verify.py --gate     # also compile/run every file (slow)
folder-nature verify . --root --pubkey aura-signing.pub   # one-verdict tree self-check

Adjacent trees

../aura-pattern-library-pending/ — an unsigned queue of patterns salvaged from harvest-workspace dup folders that (a) are not in this library and (b) have real value worth review before ingest. Each candidate carries its own .md note explaining tier (A = ingest-ready modulo review; B = needs listed fixes), origin folder, and the specific defects blocking canonical entry. When a pattern there is fixed + reviewer-approved, it enters this library via ingest.py / ingest_cpp_native.py (the maintainer's yes only) and gets signed here.

License

Apache-2.0 (see LICENSE). Attribution required; the trademark/owner mark is reserved (Apache §6 grants no trademark rights).

About

AURA Pattern Library — 1,550 signed, gate-verified reference files across six languages (Python · C++ · Go · Rust · R · JavaScript). 1,074 unique pattern IDs; each file carries its own self-test, visible attribution mark, and Ed25519 signature. Apache-2.0.

Resources

Code of conduct

Contributing

Security policy

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages