chore(docs): consolidate markdown under docs/ + distill audits into changelog (PSA-48) #417

Merged

vas2000-work merged 2 commits from chore/PSA-48-docs-sanitize into main

2026-07-01 06:45:05 +02:00

vas2000-work commented

2026-07-01 06:33:05 +02:00

Owner

Phase 1 (docs reorg) of PSA-48 for mokosh-server. Reversible content change; the irreversible history rewrite is a separate follow-up.

What changed

Every markdown file except root README.md/CLAUDE.md now lives under docs/ (public / how-to) or docs/dev-docs/ (internal working notes). README files stay colocated with their code.
Repointed all references: CLAUDE.md (incl. the doc-tree line), source comments, three migration comments, the e2e specs. The verification query that lived under the audit tree was preserved (moved to docs/dev-docs/pms-263-verify-no-comingled-business-rows.sql) and its two callers updated.
Removed the platform-audit tree, the June security-audit triage, the RLS/URL field audits, and the milestone-1 handoff; distilled name-free into docs/dev-docs/CHANGELOG.md.
Kept codebase-state.md (live per-module status / F1..F14 tracker), moved to docs/dev-docs/.
Renamed the auth test fixtures off a real person's name to a fictitious one; gitignored the local-only For AI/ dir.

Not in this PR

The git-history rewrite (purging removed docs from history, stripping names from commit messages, keeping author fields) is the separate Phase 2.

Verification

fmt + clippy -D warnings + cargo check --all-targets + cargo test --lib (239 tests) green in the pinned rust-builder image.

#PSA-48

Phase 1 (docs reorg) of PSA-48 for mokosh-server. Reversible content change; the irreversible history rewrite is a separate follow-up. ## What changed - Every markdown file except root `README.md`/`CLAUDE.md` now lives under `docs/` (public / how-to) or `docs/dev-docs/` (internal working notes). README files stay colocated with their code. - Repointed all references: `CLAUDE.md` (incl. the doc-tree line), source comments, three migration comments, the e2e specs. The verification query that lived under the audit tree was preserved (moved to `docs/dev-docs/pms-263-verify-no-comingled-business-rows.sql`) and its two callers updated. - Removed the platform-audit tree, the June security-audit triage, the RLS/URL field audits, and the milestone-1 handoff; distilled name-free into `docs/dev-docs/CHANGELOG.md`. - Kept `codebase-state.md` (live per-module status / F1..F14 tracker), moved to `docs/dev-docs/`. - Renamed the auth test fixtures off a real person's name to a fictitious one; gitignored the local-only `For AI/` dir. ## Not in this PR - The git-history rewrite (purging removed docs from history, stripping names from commit messages, keeping author fields) is the separate Phase 2. ## Verification fmt + clippy `-D warnings` + `cargo check --all-targets` + `cargo test --lib` (239 tests) green in the pinned rust-builder image. #PSA-48

vas2000-work added 1 commit

2026-07-01 06:33:05 +02:00

chore(docs): consolidate markdown under docs/, distill audits + handoff into changelog

Check / fmt + clippy + build + tests (pull_request) Failing after 14s

Details

E2E / Playwright against staging (pull_request) Successful in 36s

Details

Integration / integration tests (pull_request) Has been cancelled

Details

12c3fc56d4

Move every non-README/CLAUDE markdown file into docs/ (public how-to) and docs/dev-docs/ (internal working notes). README and CLAUDE stay at the root, README files stay colocated with their code. References in CLAUDE.md, source comments, migration comments, and the e2e specs were repointed; the moved verification query docs/dev-docs/pms-263-verify-no-comingled-business-rows.sql keeps its two callers valid.

Remove the platform-audit tree, the June security-audit triage, the RLS/URL field audits, and the 2026-05 milestone-1 handoff; distill them name-free into docs/dev-docs/CHANGELOG.md at varying depth. codebase-state.md is the live per-module status / F1..F14 tracker and was kept (moved to docs/dev-docs/), not folded.

Rename the auth test fixtures off a real person's name to a fictitious one. Gitignore the local-only For AI/ scratch dir. A follow-up history rewrite purges the removed docs from git history and strips contributor names from commit messages.

#PSA-48

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

vas2000-work added 1 commit

2026-07-01 06:35:24 +02:00

revert(migrations): restore immutable applied migrations

E2E / Playwright against staging (pull_request) Successful in 47s

Details

Check / fmt + clippy + build + tests (pull_request) Successful in 1m57s

Details

Integration / integration tests (pull_request) Successful in 9m2s

Details

Create release / Gate (release-branch merges only) (pull_request) Successful in 1s

Details

Create release / Create release from merged PR (pull_request) Has been skipped

Details

7536741484

The docs-reorg reference sweep edited doc-path comments inside three applied
migrations. Migrations are checksum-immutable (sqlx verifies each file on
startup), so any edit, even to a comment, makes deployed databases refuse to
boot. Restore the three files to their committed state; their comments keep the
original dev-docs/ paths, which is correct for a frozen artifact. The live docs
still moved under docs/; only the immutable migration comments stay as-is.

#PSA-48

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