Skip to content

Public GitHub Cleanup Archive

Status

Complete as of 2026-06-05.

Scope

This maintenance pass prepared the repository for a safer public GitHub footprint without changing service data, search behavior, authentication, schema contracts, or runtime business logic.

Completed work:

  1. Replaced public deployment and operations docs with public-safe summaries.
  2. Removed exact deployment commands, private host-path examples, alert-routing examples, and maintainer-only runtime procedures from public prose docs.
  3. Replaced the public platform contract with platform-ops-contract.example.yaml, preserving schema shape with fake values only.
  4. Added a sanitized platform-ops-contract.yaml tombstone at the legacy path so stale raw/CDN requests receive harmless example content.
  5. Migrated durable private originals to the private/shared operations source of truth while preserving ignored local copies for convenience.
  6. Replaced the admissions-focused v21 planning track with a public-interest external-validation backlog.
  7. Softened legal, privacy, accessibility, and compliance wording to avoid unsupported formal-compliance claims.
  8. Kept AGENTS.md as the canonical contributor instruction file and verified CLAUDE.md and GEMINI.md are relative symlinks.
  9. Updated tests and scripts so public docs and release helpers rely on boundary-safe contracts.
  10. Added ADR-022 to make the public documentation boundary explicit.
  11. Follow-up cleanup removed production-like observability dataset defaults from public code/config examples.

Verification

Completed local checks:

  1. Focused public-boundary scans for private deployment coordinates, live host-path patterns, alert-routing examples, and removed admissions-plan wording.
  2. Focused AI-authorship scan for contributor/author attribution patterns.
  3. WSL Git status review to avoid staging Windows symlink and line-ending noise.
  4. bash -n for updated release helper scripts.
  5. npm run type-check.
  6. npm run i18n-audit.
  7. npm run format:check.
  8. npm run lint.
  9. npm run check:refs.
  10. npm run check:root.
  11. npm test -- --run.
  12. Targeted docs, alerting, and Slack integration Vitest files.
  13. Public-boundary scans for exact private paths, real platform-contract filenames, compliance overclaims, and production-like observability placeholders.
  14. git diff --check.

Validation limitations:

  1. Playwright was intentionally not run locally under the current free-tier CI posture.

Remaining Roadmap Items

No new product roadmap item was created by this cleanup.

The normal active follow-ups remain:

  1. Close v22 Gate 0 C1 legal/API evidence.
  2. Close v22 Gate 0 D4 partner-operations evidence.
  3. Keep authenticated dashboard/admin visual QA tracked until a valid local Supabase environment and signed-in sessions are available.
  4. Resolve dependency-audit findings through bounded maintenance.

References