Local Workspace Hygiene

Date: 2026-06-14. Scope: local repository root only. This document does not change ECS or Dell production paths.

Purpose

The local checkout is a monorepo plus generated artifacts, local runtime data, remote mirrors, and historical archives. It is not a 1:1 copy of ECS or Dell.

When preparing backend structure work, treat the directories below differently instead of judging by visual clutter.

Source Of Truth

Path	Role
src/, docs/, blog/, static/figcode, static/img, static/scripts	Site source and committed static assets.
platform-server/	ECS platform entry. Currently a thin wrapper around r-server/server.js; see platform-server/README.md.
r-server/	Historical shared backend tree plus R compute. Do not assume the name means R-only.
py-server/	Python compute API and worker.
scripts/, deploy/, infra/, deploy.sh	Operational scripts and deploy/config sources.
test/	Local tests and smoke helpers.
.kiro/steering/	Project memory and working rules.
docs/ops/	Current architecture and operations records.

Generated Or Local-Only Directories

These are intentionally ignored or local-only. They are not source ownership signals.

Path	Size at audit	Classification	Notes
build/	755M	generated site build	Recreated by npm run build.
.docusaurus/	1.4M	generated site cache	Recreated by Docusaurus.
exports/	466M	generated export artifacts	Recreated by export scripts; ignored.
static/exports/	586M	generated static export artifacts	Recreated by export scripts; ignored.
.waline-data/	20K	local Waline runtime data	Local development only; ignored.
r-server/.tmp/	4K	local upload/runtime scratch	Ignored as runtime data. One previously tracked temporary CSV was removed from git tracking on 2026-06-14.
scripts/_dev/	varies	local diagnostic scripts	Ignored; not production source.

Mirrors And Archives

Path	Classification	Rule
..r-server-remote/	deprecated remote mirror	Not source of truth. It predates the PG/platform split and must not be copied into production. Keep only as historical comparison material.
.r-server-remote/, ..py-server-remote/	ignored remote mirrors if present	Not source of truth. Recreate only for a deliberate pull/compare task.
_archive/	historical notes and old server patch scripts	Not active source. Search for context if needed, but do not deploy from it.
.kiro/drafts/_archive/	historical specs	Product planning history only.

Current Cleanup Actions

2026-06-14:

• Added r-server/.tmp/ to .gitignore.
• Removed the already-tracked r-server/.tmp/uploads/*.csv temporary upload from git tracking without reading its contents.
• Left generated directories and archives in place; no local artifact deletion was required for this phase.

Practical Rules

• Do not infer production ownership from local visual size.
• Do not deploy from generated, mirror, or archive directories.
• Do not use ..r-server-remote/ as a merge base for current backend work.
• Before backend extraction, use docs/ops/BACKEND_STRUCTURE_CONVERGENCE_PLAN_2026-06-14.md and create route ownership inventory first.
• If a local directory is kept only for generated output or history, prefer a README/DEPRECATED marker over leaving it unexplained.

Verification

Useful checks:

git status --short --ignored
git check-ignore -v exports static/exports build .docusaurus .waline-data ..r-server-remote _archive r-server/.tmp
du -sh exports static/exports build .docusaurus .waline-data ..r-server-remote _archive r-server/.tmp 2>/dev/null