Skip to content

hyperpolymath/panoply

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

22 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Panoply

OpenSSF Best Practices License: MPL-2.0 Green Web

An envelope-first language discipline: every safety claim explicit, scoped, inspectable, and mechanically accountable.

What this is

Panoply is not defined by a surface language, a family of faces, or a global claim of safety. It is defined by three artefacts:

  1. a checked core — the Core into which every accepted program projects;

  2. explicit evidence — the witnesses for the claims a program makes;

  3. a safety-envelope manifest — the per-program statement of which guarantees have been earned and which have not.

Panoply’s central rule:

No guarantee without an envelope.
No envelope without evidence.
No composition without a composition rule.

Safety is scoped, inspectable, and parameterised by feature subset, projection, compiler mode, backend contract, and proof/check status — never asserted globally. Surface syntaxes are accountable projections (each must elaborate into Core + evidence + manifest), not "faces"; backends define their own contracts; experimental features may not borrow neighbours' claims.

Panoply is a narrowing of one lesson from AffineScript — that broad language surfaces need explicit trust envelopes — taken as a founding principle. It is not a rejection of AffineScript; AffineScript explores the surface, Panoply disciplines the claim.

The normative statement of all of the above is the charter:

Status

Early. The charter is in place; the mechanisms it names — the Core checker, the evidence formats, the manifest schema, the per-backend contracts, and the projection-equivalence witnesses — are not yet implemented. Per the central rule, this repository asserts no guarantee it cannot yet witness. The repository ships the hyperpolymath standard scaffolding (CI/CD, machine-readable metadata, an AI-agent gatekeeper protocol, a typed ABI/FFI seam, and governance infrastructure) on which those mechanisms will be built.

Repository map

Path What lives there

docs/architecture/

The design discipline charter, topology, threat model.

docs/decisions/

Architecture Decision Records.

0-AI-MANIFEST.a2ml

Universal entry point for AI agents (read first).

.machine_readable/

Project metadata, policies, contractiles, AI configs.

src/

Source pillars (core, aspects, interface ABI/FFI, …).

verification/

Proof scripts (Coq, Agda, Idris2) and verification harness.

build/, Justfile

Task orchestration (just phases delegate to build/just/*.just).

.github/

Workflows + community health files.

tests/, benches/

Test suites and benchmarks.

Where to go next

  • docs/architecture/DESIGN-DISCIPLINE.adoc — the charter (start here).

  • EXPLAINME.adoc — how the scaffolding pieces map to real files.

  • AUDIT.adoc — the release audit gate.

Licence

Released under the Mozilla Public License 2.0 unless a per-file SPDX-License-Identifier says otherwise.

About

envelope-first language discipline

Resources

License

Code of conduct

Contributing

Security policy

Stars

1 star

Watchers

0 watching

Forks

Releases

No releases published

Packages

 
 
 

Contributors