docs: past-present-future doctrine (STATUS + PROOF-NEEDS rewrite + README banner + L3 diagram + .v signposts)

[hyperpolymath]

Summary

Single-PR landing of the orientation doctrine that prevents future sessions from "redoing the old stuff". Seven coordinated artefacts so the doctrine catches every reader at every entry point — human or machine.

Files

Type	File	Purpose
NEW	STATUS.adoc	Single-page past / present / future map at repo root. The doc that answers "where are we?" with a top-of-document disambiguation banner (ephapax ≠ AffineScript).
REWRITE	PROOF-NEEDS.md	Per-sublanguage proof debt audit, separated for ephapax-linear and ephapax-affine. Sections: done / todo / banned (6 anti-pattern categories) / counts. Replaces the prior version which still carried the pre-discovery legacy-preservation closure plan as viable.
PATCH	README.adoc	Foundational-redesign-in-progress banner; replaces pre-discovery "12 admits / 910 closed" Coq narrative with post-discovery per-layer picture; adds "Three superpowers" section with the NOT-a-tracing-GC-replacement caveat; adds "What this enables" (GDPR / verified resource management / policy enforcement); doc-map updated.
PATCH	formal/PRESERVATION-DESIGN.md §6	One-sentence anchor + ASCII diagram + 3-point explanation of L3 architecture (one type former, two observation disciplines, one-way Linear→Affine via degrade).
BANNER	formal/Semantics.v	🛑 ARCHAEOLOGY — do not extend
BANNER	formal/Typing.v	🛑 ARCHAEOLOGY — Counterexample.v depends on falsity
BANNER	formal/Semantics_L1.v	✅ ACTIVE — 9 admits are L2-integration debt
BANNER	formal/TypingL1.v	✅ ACTIVE — judgment 100%, modality-indexed
BANNER	formal/Modality.v	✅ ACTIVE — L2 (thin poset); L3 must not pattern-match
BANNER	formal/Echo.v	✅ ACTIVE — ONE type former; do not split LinearEcho/AffineEcho
BANNER	formal/Counterexample.v	📌 PINNED REGRESSION WITNESS — do not weaken

Disambiguation reinforced

STATUS.adoc opens with a CAUTION callout aimed at both human + machine readers: Ephapax ≠ AffineScript; ephapax-affine (the sublanguage inside this repo) ≠ AffineScript. The lexical overlap of "affine" is a coincidence of substructural-logic terminology, not a project relationship. PROOF-NEEDS.md leads with the same disambiguation. The README's existing IMPORTANT callout is strengthened with the cross-repo lesson-warning.

Safety envelope

• No .v semantic changes.
• No new Admitted or Axiom introduced.
• No legacy code touched (Semantics.v, Typing.v) except top-of-file banner comments.
• L1, L2, L3 calculi unchanged.
• Counterexample.v unchanged.

Closes

This PR is the canonical post-discovery doctrine landing. It supersedes the in-flight #154 (filed 2026-05-26 with pre-consolidated framing). #154 will be closed in a follow-up after this lands; any unique linguistically-safe file-additions from #154 (EXPLAINME.adoc, EPHAPAX-VISION.adoc, spec/SPEC.md, site/index.md, ephapax-linear/README.md, TOPOLOGY.md) can be ported in a smaller follow-up with the current framing.

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

[github-actions]

🔍 Hypatia Security Scan

Findings: 51 issues detected

Severity	Count
🔴 Critical	9
🟠 High	9
🟡 Medium	33

⚠️ 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