docs: record tech-debt audit findings (2026-05-26)

[hyperpolymath]

Adds docs/tech-debt-2026-05-26.md with this repo's findings from the estate-wide tech-debt scan: proof debt, licence debt, documentation debt.

This file records the findings only — it does not close the debt.

Cross-references:

• docs(audits): estate-wide proof-debt audit 2026-05-26 standards#195 (estate proof-debt audit)
• docs(audits): estate-wide licence-debt audit 2026-05-26 standards#196 (estate licence-debt audit)
• docs(audits): estate-wide documentation-debt audit 2026-05-26 standards#197 (estate documentation-debt audit)

Summary

Closes #

Type of change

• 🐛 Bug fix (non-breaking change that fixes an issue)
• ✨ New feature (non-breaking change that adds functionality)
• 💥 Breaking change (would change existing behaviour)
• 🕳️ Soundness fix (fixes a checker/proof false-negative)
• 📖 Documentation
• 🧹 Refactor / tech debt (behaviour-preserving)
• ⚡ Performance
• 🔧 Build / CI / tooling

How has this been verified?

Checklist

• My commits are signed (git commit -S).
• I ran the project's own checks/tests locally and they pass.
• New files carry the correct SPDX-License-Identifier (code/config MPL-2.0,
  prose CC-BY-SA-4.0); I did not relicense existing files.
• Docs are updated, and no public claim now overstates what the code does.
• I have not introduced a soundness hole (or I have flagged where I might have).

Notes for reviewers

[github-actions]

🔍 Hypatia Security Scan

Findings: 9 issues detected

Severity	Count
🔴 Critical	0
🟠 High	3
🟡 Medium	6

View findings

[
  {
    "reason": "Nominal-only SAST in git-reticulator: 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/git-reticulator/git-reticulator",
    "action": "auto_fix",
    "rule_module": "scorecard",
    "severity": "medium",
    "remediation": "Add CodeQL or equivalent SAST workflow.",
    "scorecard_check": "SAST"
  },
  {
    "reason": "Repository has 4 non-main remote branch(es). Policy: single main branch only.",
    "type": "GS007",
    "file": ".",
    "action": "delete_remote_branches",
    "rule_module": "git_state",
    "severity": "medium"
  },
  {
    "reason": "Code scanning (Hypatia): hypatia/structural_drift/SD009 -- Hypatia structural_drift: SD009 -- 36 day(s) old [STALE]",
    "type": "CSA001",
    "file": "src/api/app.rs",
    "action": "update",
    "rule_module": "code_scanning_alerts",
    "severity": "medium"
  },
  {
    "reason": "Code scanning (Hypatia): hypatia/git_state/GS007 -- Hypatia git_state: GS007 -- 36 day(s) old [STALE]",
    "type": "CSA001",
    "file": ".",
    "action": "update",
    "rule_module": "code_scanning_alerts",
    "severity": "medium"
  },
  {
    "reason": "Code scanning (Hypatia): hypatia/scorecard/StaticAnalysis -- Hypatia scorecard: StaticAnalysis -- 36 day(s) old [STALE]",
    "type": "CSA001",
    "file": "git-reticulator",
    "action": "update",
    "rule_module": "code_scanning_alerts",
    "severity": "medium"
  },
  {
    "reason": "Code-scanning alert hypatia/structural_drift/SD009 (medium) at src/api/app.rs is 36 days old (threshold: 30 days) -- overdue for remediation",
    "type": "CSA003",
    "file": "src/api/app.rs",
    "action": "escalate",
    "rule_module": "code_scanning_alerts",
    "severity": "high"
  },
  {
    "reason": "Code-scanning alert hypatia/git_state/GS007 (medium) at . is 36 days old (threshold: 30 days) -- overdue for remediation",
    "type": "CSA003",
    "file": ".",
    "action": "escalate",
    "rule_module": "code_scanning_alerts",
    "severity": "high"
  },
  {
    "reason": "Code-scanning alert hypatia/scorecard/StaticAnalysis (medium) at git-reticulator is 36 days old (threshold: 30 days) -- overdue for remediation",
    "type": "CSA003",
    "file": "git-reticulator",
    "action": "escalate",
    "rule_module": "code_scanning_alerts",
    "severity": "high"
  },
  {
    "reason": "Source file missing SPDX-License-Identifier header",
    "type": "SD009",
    "file": "src/api/app.rs",
    "action": "add_spdx_header",
    "rule_module": "structural_drift",
    "severity": "medium"
  }
]

Powered by Hypatia Neurosymbolic CI/CD Intelligence