Skip to content

docs(machine-readable): update STATE + META for F1/F3/earn-back closure#93

Merged
hyperpolymath merged 2 commits into
mainfrom
machine-readable-tidy
May 20, 2026
Merged

docs(machine-readable): update STATE + META for F1/F3/earn-back closure#93
hyperpolymath merged 2 commits into
mainfrom
machine-readable-tidy

Conversation

@hyperpolymath
Copy link
Copy Markdown
Owner

Summary

Brings .machine_readable/6a2/STATE.a2ml and META.a2ml in line
with the prose docs after this session's Pillar F earn-back closure
and §"Theory work" closing.

META.a2ml — three new ADRs (append-only)

No existing ADR is edited. Three appended after adr-006:

  • adr-007 — F1 earn-back via monoid-graded iterated-residue
    construction. EchoGradedComonadF1.agda at (ℕ, +, 0) with
    Echo as grade-unit object, nested δ, all three comonad laws,
    D2-nontrivial separating witness. (PR F1 PASSED: gc-coassoc closed (earn-back gate, R-2026-05-18 follow-up) #86 merged 2026-05-20.)
  • adr-008 — F3 earn-back via two non-isomorphic-grade-monoid
    instances of an abstract GradedComonadStructure interface. No
    ⊑-prop-equivalent field. nat-instance at commutative
    (ℕ, +, 0); list-instance at non-commutative (List Tag, ++, []).
    (PR F3 PASSED: GradedComonadStructure + two non-isomorphic-grade-monoid instances #88 open.)
  • adr-009 — Retraction-discipline succeeded: the R-2026-05-18
    reframing converted into four earn-back gate passes (F4, F2, F1,
    F3); one retraction stays retracted (conservativity metatheorem,
    finding 5); none silently re-inflated.

Each ADR carries the strict scope qualifier — F1/F3 earn back claims
for a separate side-construction; EchoGraded itself remains a
thin-poset reindexing modality per R-2026-05-18, and paper.adoc /
types-abstract.adoc / conservativity.adoc are intentionally not
moved.

STATE.a2mlnext-actions pruned + two closure sections appended

Pruned: 3 of 5 April next-actions were stale and are resolved
in the prose:

Remaining + added: q2-1 (echo-not-prop generalisation, still
high), q2-3 (RoleGraded as N5, still low), new
owner-gated-paper-update entry, new ordinal-track-path-1 entry
(in-flight in other session), and the original v0-2-recipe-extension
parked entry.

Two new closure sections at the end of STATE.a2ml:

  • earn-back-summary — closure record for all four gates with
    module paths, claim wording, retraction-followup citations, and a
    forbidden-rebrandings list to prevent later mis-framing.
  • theory-work-summary — closure record for §"Theory work — no
    proof assistant needed": axes fully mechanised list, ruled-out
    items, refreshed items, canonical examples cluster.

Test plan

  • Pure machine-readable data; no Agda touched
  • agda proofs/agda/All.agda exit 0
  • agda proofs/agda/Smoke.agda exit 0
  • Append-only ADR discipline preserved (adr-001 through adr-006
    unchanged; new ADRs at the end)
  • No retracted claim moved; no earned-back claim overclaimed
  • (owner) confirm a2ml schema validation if you run a validator
    against the standards/state-a2ml + meta-a2ml specs

Scope

Pure machine-readable data update. Disjoint from all currently-open
PRs (#88 F3, #90 partition-dec, #91 generic-codomain, #92 docs tidy).
paper.adoc / types-abstract.adoc / conservativity.adoc are
intentionally not touched.

🤖 Generated with Claude Code

Brings the .machine_readable/6a2/ files in line with the prose docs
following the Pillar F earn-back programme closure and the §"Theory
work" section closing in this session.

META.a2ml — three new ADRs appended (append-only discipline preserved;
no existing ADR edited):

* adr-007 F1 earn-back via monoid-graded iterated-residue construction
  (proofs/agda/EchoGradedComonadF1.agda; PR #86 merged 2026-05-20)
* adr-008 F3 earn-back via two non-isomorphic-grade-monoid instances
  of an abstract interface (EchoGradedComonadInterface +
  Instance1/Instance2; PR #88 open)
* adr-009 Retraction-discipline succeeded: R-2026-05-18 reframing
  converted into four earn-back gate passes (F4, F2, F1, F3); one
  retraction stays retracted (conservativity metatheorem, finding 5);
  none silently re-inflated

Each ADR includes the strict scope qualifier — F1/F3 earn back claims
FOR A SEPARATE SIDE-CONSTRUCTION; EchoGraded itself remains a
thin-poset reindexing modality per R-2026-05-18, and the paper/
types-abstract/conservativity bodies are intentionally not moved.

STATE.a2ml — next-actions list pruned (5 stale April items resolved),
two new sections appended:

* `earn-back-summary` — closure record for all four gates with module
  paths, claim wording, retraction-followup citation, and a
  forbidden-rebrandings list to prevent later mis-framing
* `theory-work-summary` — closure record for §"Theory work — no
  proof assistant needed": axes fully mechanised, ruled-out items,
  refreshed items, canonical examples cluster

next-actions cleaned of long-completed items (the "Apply the
seven-commit integration sequence" entry from April; the t-3 and q2-4
items superseded by intervening work). What remains: q2-1
echo-not-prop generalisation (high), q2-3 RoleGraded as N5 (low),
the new owner-gated-paper-update entry, the in-flight ordinal-track
Path-1 entry (other session), and the parked v0.2 recipe extension.

Pure machine-readable data; no Agda touched. agda proofs/agda/All.agda
and agda proofs/agda/Smoke.agda exit 0 (confirms the schema/format
load with no side-effects on the proof modules).

Refs the closure side of the entire session: #84 / #86 / #88 / #90 /
#91 / #92.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
@hyperpolymath hyperpolymath marked this pull request as ready for review May 20, 2026 20:28
@hyperpolymath hyperpolymath merged commit 52d5b03 into main May 20, 2026
7 of 10 checks passed
@hyperpolymath hyperpolymath deleted the machine-readable-tidy branch May 20, 2026 20:29
@github-actions
Copy link
Copy Markdown

🔍 Hypatia Security Scan

Findings: 10 issues detected

Severity Count
🔴 Critical 0
🟠 High 5
🟡 Medium 5
View findings
[
  {
    "reason": "No test directory or test files found",
    "type": "no_tests",
    "file": "/home/runner/work/echo-types/echo-types",
    "action": "flag",
    "rule_module": "honest_completion",
    "severity": "high",
    "deduction": 20
  },
  {
    "reason": "Issue in quality.yml",
    "type": "missing_workflow",
    "file": "quality.yml",
    "action": "create",
    "rule_module": "workflow_audit",
    "severity": "high"
  },
  {
    "reason": "Issue in security-policy.yml",
    "type": "missing_workflow",
    "file": "security-policy.yml",
    "action": "create",
    "rule_module": "workflow_audit",
    "severity": "medium"
  },
  {
    "reason": "Issue in secret-scanner.yml",
    "type": "missing_workflow",
    "file": "secret-scanner.yml",
    "action": "create",
    "rule_module": "workflow_audit",
    "severity": "high"
  },
  {
    "reason": "Action actions/cache@v4 needs attention",
    "type": "unpinned_action",
    "file": "agda.yml",
    "action": "pin_sha",
    "rule_module": "workflow_audit",
    "severity": "medium"
  },
  {
    "reason": "Action hyperpolymath/standards/.github/workflows/governance-reusable.yml@main needs attention",
    "type": "unpinned_action",
    "file": "governance.yml",
    "action": "pin_sha",
    "rule_module": "workflow_audit",
    "severity": "high"
  },
  {
    "reason": "No dependabot.yml or renovate.json found in echo-types",
    "type": "DependencyUpdate",
    "file": "/home/runner/work/echo-types/echo-types",
    "action": "auto_fix",
    "rule_module": "scorecard",
    "severity": "high",
    "remediation": "Add .github/dependabot.yml or renovate.json configuration.",
    "scorecard_check": "Dependency-Update-Tool"
  },
  {
    "reason": "Nominal-only SAST in echo-types: codeql.yml language matrix contains no language present in the repo and lacks `actions`, so CodeQL records zero results on every commit. Remediation: set the CodeQL matrix to `language: actions`.",
    "type": "StaticAnalysis",
    "file": "/home/runner/work/echo-types/echo-types",
    "action": "auto_fix",
    "rule_module": "scorecard",
    "severity": "medium",
    "remediation": "Add CodeQL or equivalent SAST workflow.",
    "scorecard_check": "SAST"
  },
  {
    "reason": "1 workflow(s) with tag-pinned (not SHA-pinned) actions in echo-types",
    "type": "DependencyPinning",
    "file": "/home/runner/work/echo-types/echo-types",
    "action": "auto_fix",
    "rule_module": "scorecard",
    "severity": "medium",
    "remediation": "Pin GitHub Actions and Docker base images by SHA hash.",
    "scorecard_check": "Pinned-Dependencies"
  },
  {
    "reason": "Repository has 1 non-main remote branch(es). Policy: single main branch only.",
    "type": "GS007",
    "file": ".",
    "action": "delete_remote_branches",
    "rule_module": "git_state",
    "severity": "medium"
  }
]

Powered by Hypatia Neurosymbolic CI/CD Intelligence

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