Skip to content

docs(cleanup): residual pre-discovery framing in secondary docs#186

Merged
hyperpolymath merged 1 commit into
mainfrom
docs/cleanup-residual-pre-discovery-framing
May 27, 2026
Merged

docs(cleanup): residual pre-discovery framing in secondary docs#186
hyperpolymath merged 1 commit into
mainfrom
docs/cleanup-residual-pre-discovery-framing

Conversation

@hyperpolymath
Copy link
Copy Markdown
Owner

Follow-up to #184 + #185. Aligns 5 secondary entry surfaces (EXPLAINME, TOPOLOGY, docs/vision, ephapax-linear/README, .machine_readable/META.a2ml) with the post-counterexample doctrine. ROADMAP.adoc + .gitignore + .gitattributes + wiki deferred (not blocking proof work). See commit body for per-file detail.

Co-Authored-By: Claude Opus 4.7 (1M context) noreply@anthropic.com

…AINME / TOPOLOGY / vision / ephapax-linear README / META.a2ml)

Follow-up to #184 + #185 — closing the secondary-surface gaps so
every entry point lands a reader on the post-counterexample doctrine,
not the pre-discovery framing.

- EXPLAINME.adoc: replaces the 'Mechanically Proved Soundness / Coq'
  section's pre-discovery 910 → 29 → 22 → 12 reduction narrative
  with a per-layer table (L1 / L2 / L3 / L4) and a post-counterexample
  IMPORTANT callout pointing at STATUS.adoc / PRESERVATION-DESIGN.md
  / PROOF-NEEDS.md. Closes the 'show me the receipts' doc carrying
  stale framing.

- TOPOLOGY.md: adds a post-counterexample-doctrine banner with the
  layer mapping table (L1 / L2 / L3 / L4 + 🛑 legacy) at the top.
  Last-updated marker bumped to 2026-05-27.

- docs/vision/EPHAPAX-VISION.adoc: adds two callouts at the top —
  (a) post-counterexample reorientation (intent survives, mechanisation
  is layered; read order STATUS → PRESERVATION-DESIGN → PROOF-NEEDS)
  and (b) the ephapax ≠ AffineScript disambiguation.

- ephapax-linear/README.md: adds the AffineScript-disambiguation
  callout up front. Important entry-surface because LLMs have been
  conflating the affine grammar in this crate with AffineScript at
  hyperpolymath/affinescript purely on lexical overlap.

- .machine_readable/6a2/META.a2ml: adr-002 'Fully closed proofs
  (67 Qed)' consequences updated to reflect the 2026-05-26
  counterexample; new adr-005 codifies the four-layer redesign as
  the post-discovery architectural decision.

ROADMAP.adoc line 188 left as-is (it already labels the 910 → 11
narrative as archaeology — correct post-discovery framing).
.gitignore + .gitattributes audit deferred (no issue surfaced).
Wiki (separate repo) untouched.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
@hyperpolymath hyperpolymath merged commit 3b5b92d into main May 27, 2026
@hyperpolymath hyperpolymath deleted the docs/cleanup-residual-pre-discovery-framing branch May 27, 2026 15:40
@github-actions
Copy link
Copy Markdown

🔍 Hypatia Security Scan

Findings: 50 issues detected

Severity Count
🔴 Critical 9
🟠 High 9
🟡 Medium 32

⚠️ Action Required: Critical security issues found!

View findings
[
  {
    "reason": "Issue in abi-verify.yml",
    "type": "unknown",
    "file": "abi-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 codeql.yml",
    "type": "unknown",
    "file": "codeql.yml",
    "action": "flag",
    "rule_module": "workflow_audit",
    "severity": "medium"
  },
  {
    "reason": "Issue in governance.yml",
    "type": "unknown",
    "file": "governance.yml",
    "action": "flag",
    "rule_module": "workflow_audit",
    "severity": "medium"
  },
  {
    "reason": "Issue in hypatia-scan.yml",
    "type": "unknown",
    "file": "hypatia-scan.yml",
    "action": "flag",
    "rule_module": "workflow_audit",
    "severity": "medium"
  },
  {
    "reason": "Issue in instant-sync.yml",
    "type": "unknown",
    "file": "instant-sync.yml",
    "action": "flag",
    "rule_module": "workflow_audit",
    "severity": "medium"
  },
  {
    "reason": "Issue in mirror.yml",
    "type": "unknown",
    "file": "mirror.yml",
    "action": "flag",
    "rule_module": "workflow_audit",
    "severity": "medium"
  },
  {
    "reason": "Issue in rust-ci.yml",
    "type": "unknown",
    "file": "rust-ci.yml",
    "action": "flag",
    "rule_module": "workflow_audit",
    "severity": "medium"
  },
  {
    "reason": "Issue in rust-ci.yml",
    "type": "unknown",
    "file": "rust-ci.yml",
    "action": "flag",
    "rule_module": "workflow_audit",
    "severity": "medium"
  },
  {
    "reason": "Issue in scorecard-enforcer.yml",
    "type": "unknown",
    "file": "scorecard-enforcer.yml",
    "action": "flag",
    "rule_module": "workflow_audit",
    "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