Skip to content

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

Closed
hyperpolymath wants to merge 1 commit into
mainfrom
arg-frg-framework-landing
Closed

feat(standards): add ARG + FRG language-maturation framework#226
hyperpolymath wants to merge 1 commit into
mainfrom
arg-frg-framework-landing

Conversation

@hyperpolymath
Copy link
Copy Markdown
Owner

Summary

Adds two sibling-tier standards to the existing TRG/CRG family, completing the four-axis language-maturation grading framework.

  • ARG (Adoption Readiness Grades) at adoption-readiness-grades/ — real-world adoption readiness: community, ergonomics, tooling polish, docs, deployment story
  • FRG (Foundations Readiness Grades) at foundations-readiness-grades/ — 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).

What's in each subtree

adoption-readiness-grades/ (ARG):

  • ADOPTION-READINESS-GRADES.adoc — normative spec
  • ADOPTION-READINESS-GRADES.a2ml — machine-readable counterpart
  • README.adoc — entry point
  • SELF-ASSESSMENT.adoc — self-grade for the standards repo
  • AUDIT-FINDINGS-2026-05-28.adoc — 2026-05-28 audit
  • templates/ARG-PROFILE-TEMPLATE.adoc — per-language profile template

foundations-readiness-grades/ (FRG): same shape, no audit doc.

Follow-ups (separate PRs)

  • affinescript: per-language ARG/FRG profile
  • ephapax: per-language ARG/FRG profile
  • my-lang: per-language ARG/FRG profile
  • nextgen-languages: dashboard + tracker wiring (TOOLING-STATUS.adoc + language-status-tracker.jl)

Test plan

  • CI passes
  • .adoc + .a2ml render cleanly
  • No SPDX-header lint complaints

🤖 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 enabled auto-merge (squash) May 28, 2026 10:06
@github-actions
Copy link
Copy Markdown

🔍 Hypatia Security Scan

Findings: 196 issues detected

Severity Count
🔴 Critical 65
🟠 High 39
🟡 Medium 92

⚠️ 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 to hyperpolymath/ephapax that referenced this pull request May 28, 2026
## Summary

Adds the per-language Adoption + Foundations Readiness Grade profiles
for Ephapax, scored against the framework being introduced in
hyperpolymath/standards#226 (ARG + FRG companion spec).

- `spec/ARG-PROFILE.adoc` — adoption readiness profile
- `spec/FRG-PROFILE.adoc` — foundations readiness profile

**Grade**:
- **ARG-E**: research artefact, narrow adopter base, working compiler
- **FRG-D**: active mechanised-proof line in `formal/`, multi-layer
redesign (L1 regions / L2 modality / L3 echo / L4 dyadic),
counterexample-verified preservation invariants

Cross-axis: this is the inverse of the AffineScript shape
(research-strong / adoption-narrow vs. adoption-pragmatic /
research-light), and is consistent with Ephapax's positioning as a
foundational vehicle.

## Test plan

- [ ] CI passes
- [ ] `.adoc` renders cleanly
- [ ] 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>
hyperpolymath added a commit to hyperpolymath/nextgen-languages that referenced this pull request May 28, 2026
## Summary

Extends the language status dashboard with ARG (Adoption Readiness
Grades) + FRG (Foundations Readiness Grades) wiring, implementing the
dashboard side of the framework being introduced in
hyperpolymath/standards#226.

- **TOOLING-STATUS.adoc** — adds a Language Grades Matrix section
- **language-status-tracker.jl** — adds `LanguageGrades` struct + grade
extraction

Reads per-language `ARG-PROFILE.adoc` + `FRG-PROFILE.adoc` from each
tracked language repo (where present) and surfaces the `X | F | E | D |
C | B | A` grade across all four maturity axes (ARG / TRG / FRG / CRG)
plus RSR.

Companion per-language profile PRs:
- affinescript: ARG-D + FRG-E
- ephapax: ARG-E + FRG-D
- my-lang: ARG-D-leaning-E + FRG-X

## Test plan

- [ ] CI passes
- [ ] `.adoc` renders cleanly
- [ ] `language-status-tracker.jl` parses/runs cleanly
- [ ] 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>
hyperpolymath added a commit that referenced this pull request May 28, 2026
## Summary

Fills a gap in the existing TRG/CRG standards: both standards permit
per-language profiles (TRG §1.1, CRG §4.6) that tighten the baseline,
but neither shipped a profile template.

- **`toolchain-readiness-grades/templates/TRG-PROFILE-TEMPLATE.adoc`** —
mirrors the per-component breakdown from TRG §3 (F1-F7 front-end, M1-M5
middle-end, B1-B6 back-end, T1-T9 tool surface), each with its own grade
column and evidence column
- **`component-readiness-grades/templates/CRG-PROFILE-TEMPLATE.adoc`** —
mirrors the released-component shape from CRG §3; one row per released
artefact, plus a grade-clause rationale table per CRG §4

Both templates use the same outer structure as the ARG/FRG templates
introduced in #226 (metadata header, axes recap, language-specific
tightening, honest-gaps, path-to-next-grade, demotion risk, iteration
history, review cycle, VeriSimDB attestation footer).

## Follow-ups (separate PRs)

Per-language TRG + CRG profiles to land in:

- `affinescript`
- `ephapax`
- `my-lang`
- `typed-wasm` (compilation target treated as a language-shaped artefact
— has grammar, AST, semantics, type system, runtime)

## Test plan

- [ ] CI passes
- [ ] `.adoc` renders cleanly
- [ ] 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>
auto-merge was automatically disabled May 28, 2026 11:27

Pull request was closed

@hyperpolymath hyperpolymath deleted the arg-frg-framework-landing branch May 28, 2026 11:27
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