Skip to content

feat(standards): add ARG + FRG language-maturation framework#232

Merged
hyperpolymath merged 1 commit into
mainfrom
arg-frg-framework-landing-rebased
May 28, 2026
Merged

feat(standards): add ARG + FRG language-maturation framework#232
hyperpolymath merged 1 commit into
mainfrom
arg-frg-framework-landing-rebased

Conversation

@hyperpolymath
Copy link
Copy Markdown
Owner

Summary

Lands the ARG/FRG (Adoption-Readiness Grades + Foundations-Readiness Grades) language-maturation framework as a new top-level spec pair under standards/. Companion to the existing CRG/TRG framework family.

This is a rebased version of the original arg-frg-framework-landing branch from a parallel session, brought current with main (which now carries the V-lang→Zig migration completion in LANGUAGE-POLICY.adoc and CARTRIDGE-FORMAT.adoc — those edits are preserved by this rebase, not reverted).

What lands (11 new files, +3315 lines)

adoption-readiness-grades/
├── ADOPTION-READINESS-GRADES.a2ml           # machine-readable spec
├── ADOPTION-READINESS-GRADES.adoc           # human spec
├── README.adoc                              # entry doc
├── SELF-ASSESSMENT.adoc                     # how to assess your own language
├── AUDIT-FINDINGS-2026-05-28.adoc           # Phase 6 audit (X-A grades for 17 languages)
└── templates/
    └── ARG-PROFILE-TEMPLATE.adoc            # per-language template

foundations-readiness-grades/
├── FOUNDATIONS-READINESS-GRADES.a2ml
├── FOUNDATIONS-READINESS-GRADES.adoc
├── README.adoc
├── SELF-ASSESSMENT.adoc
└── templates/
    └── FRG-PROFILE-TEMPLATE.adoc

Cross-axis invariants (codified in the framework)

  • ARG ≤ TRG always — a language can't be more adoptable than its toolchain is ready
  • ARG-A requires FRG ≥ B — top-tier adoption needs foundational rigour

Relationship to the dashboard

nextgen-languages PR #58 (already merged) added the Language Grades Matrix and a regex-based grade extractor in language-status-tracker.jl that reads per-language spec/{ARG,FRG,TRG}-PROFILE.adoc files following the templates landed here.

Test plan

  • adoption-readiness-grades/README.adoc renders
  • foundations-readiness-grades/README.adoc renders
  • Templates copy-pasteable into a language repo's spec/ dir
  • No regression on the V-lang→Zig migration text in LANGUAGE-POLICY.adoc (rebase preserved standards#227)

🤖 Generated with Claude Code

Adds two sibling-tier standards to the existing TRG/CRG family:

- adoption-readiness-grades/ — ARG: real-world adoption readiness
  (community, ergonomics, tooling polish, docs, deployment story)
- foundations-readiness-grades/ — FRG: foundational research surfaces
  (mechanised proofs, papers, verification harnesses, formal artefacts)

Estate grade vocabulary X | F | E | D | C | B | A with worst-of aggregation.
Cross-axis rule: ARG <= TRG always; ARG-A requires FRG >= B.

Includes audit findings doc AUDIT-FINDINGS-2026-05-28.adoc with §7 prover-CI
hygiene addendum and §7.5 calibration lessons (~67% sub-agent false-positive
rate on the 2026-05-28 sweep).

Per-language profiles to land separately in affinescript / ephapax / my-lang.
Dashboard wiring to land separately in nextgen-languages.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
@hyperpolymath hyperpolymath merged commit f0c5ef1 into main May 28, 2026
18 checks passed
@hyperpolymath hyperpolymath deleted the arg-frg-framework-landing-rebased branch May 28, 2026 11:27
@github-actions
Copy link
Copy Markdown

🔍 Hypatia Security Scan

Findings: 187 issues detected

Severity Count
🔴 Critical 65
🟠 High 32
🟡 Medium 90

⚠️ Action Required: Critical security issues found!

View findings
[
  {
    "reason": "Issue in affinescript-verify.yml",
    "type": "unknown",
    "file": "affinescript-verify.yml",
    "action": "flag",
    "rule_module": "workflow_audit",
    "severity": "medium"
  },
  {
    "reason": "Issue in boj-build.yml",
    "type": "unknown",
    "file": "boj-build.yml",
    "action": "flag",
    "rule_module": "workflow_audit",
    "severity": "medium"
  },
  {
    "reason": "Issue in casket-pages.yml",
    "type": "unknown",
    "file": "casket-pages.yml",
    "action": "flag",
    "rule_module": "workflow_audit",
    "severity": "medium"
  },
  {
    "reason": "Issue in casket-pages.yml",
    "type": "unknown",
    "file": "casket-pages.yml",
    "action": "flag",
    "rule_module": "workflow_audit",
    "severity": "medium"
  },
  {
    "reason": "Issue in changelog-reusable.yml",
    "type": "unknown",
    "file": "changelog-reusable.yml",
    "action": "flag",
    "rule_module": "workflow_audit",
    "severity": "medium"
  },
  {
    "reason": "Issue in codeql-reusable.yml",
    "type": "unknown",
    "file": "codeql-reusable.yml",
    "action": "flag",
    "rule_module": "workflow_audit",
    "severity": "medium"
  },
  {
    "reason": "Issue in codeql.yml",
    "type": "unknown",
    "file": "codeql.yml",
    "action": "flag",
    "rule_module": "workflow_audit",
    "severity": "medium"
  },
  {
    "reason": "Issue in deno-ci-reusable.yml",
    "type": "unknown",
    "file": "deno-ci-reusable.yml",
    "action": "flag",
    "rule_module": "workflow_audit",
    "severity": "medium"
  },
  {
    "reason": "Issue in doc-format.yml",
    "type": "unknown",
    "file": "doc-format.yml",
    "action": "flag",
    "rule_module": "workflow_audit",
    "severity": "medium"
  },
  {
    "reason": "Issue in echidna-verify.yml",
    "type": "unknown",
    "file": "echidna-verify.yml",
    "action": "flag",
    "rule_module": "workflow_audit",
    "severity": "medium"
  }
]

Powered by Hypatia Neurosymbolic CI/CD Intelligence

hyperpolymath added a commit that referenced this pull request May 28, 2026
…#234)

- **README.adoc** Overview: add Language-Maturation Grades bullet
(ARG/FRG with TRG/CRG templates, pointer to nextgen-languages
dashboard).
- **ROADMAP.adoc**: bump Current State date 2026-04-04 → 2026-05-28; add
ARG/FRG Language-Maturation Framework row to Core Standards table
(Complete, PRs #229 + #232 landed 2026-05-28).

Doc-only. CHANGELOG.md auto-syncs via git-cliff workflow on conventional
commits — no manual update needed.

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-authored-by: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
hyperpolymath added a commit to hyperpolymath/typed-wasm that referenced this pull request May 28, 2026
## Summary

Adds the four-axis maturation grading for typed-wasm, scored against the
framework introduced in hyperpolymath/standards#232 (ARG + FRG) and the
templates introduced in hyperpolymath/standards#229 (TRG + CRG profile
templates).

typed-wasm is treated as a **language-shaped compilation target**: it
has a defined grammar (binary + textual per `spec/grammar.ebnf`),
instruction AST, operational semantics (per
`spec/type-safety-levels-for-wasm.adoc`), a layered type system (L1-L17
per `LEVEL-STATUS.md`), and a runtime contract. "Adoption" means
*downstream languages targeting it as a compilation backend* (ephapax,
AffineScript).

## Grades

| Axis | Grade | Headline reason |
|------|-------|-----------------|
| ARG | **D** | README/EXPLAINME/QUICKSTART + 6 example `.twasm` + 3
consumer-feature surfaces. No public playground / error-code index /
educator curriculum. |
| TRG | **C** | Front-end + middle-end + back-end strong; T1-T5 N/A
(target, not compiler). 88/88 parser tests pass at v1.5. |
| FRG | **C** | 22 Idris2 files at `src/abi/` with QTT linearity +
dependent types, zero `believe_me`/`assert_total` in ABI files, A10
closure landed PR #79. Gated below B by absence of explicit L1-L10
preservation lemmas per `PROOF-NEEDS.md`. |
| CRG | **D** | `typed-wasm-verify` v0.1.0 (workspace-internal, not yet
on crates.io). Idris2 ABI surface at C (consumed as source). |

Cross-axis rule: ARG ≤ TRG holds (TRG = C ≥ ARG = D). typed-wasm becomes
the **strongest of the audit cohort on FRG** (versus ephapax-D,
AffineScript-E, my-lang-X) and ties ephapax at TRG-C.

## Honest gaps for grade promotion

- **B** for TRG/FRG requires per-level preservation lemmas for L1-L10
(currently structural only); L11/L12 still draft.
- **C** for ARG requires a published error-code index + web playground +
VeriSimDB attestation.
- **C** for CRG requires `audits/audit-typed-wasm-verify.md` + VeriSimDB
attestation.

## Test plan

- [ ] CI passes
- [ ] `.adoc` renders cleanly
- [ ] Grade-line regex from
`nextgen-languages/language-status-tracker.jl` matches each `*<GRADE>*`
correctly
- [ ] No SPDX-header lint complaints

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-authored-by: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant