From 28d6c9626e8b848c72ae0af4f8fe97a16c3cec34 Mon Sep 17 00:00:00 2001
From: nathan <nathan@pacificao.com>
Date: Thu, 14 May 2026 10:13:14 -0700
Subject: [PATCH] Decide branch and storage foundation policy

---
 AGRARIAN_DEVELOPMENT_ROADMAP.md |  8 ++++----
 Scripts/audit_repo_storage.sh   | 18 ++++++++++++++----
 2 files changed, 18 insertions(+), 8 deletions(-)

diff --git a/AGRARIAN_DEVELOPMENT_ROADMAP.md b/AGRARIAN_DEVELOPMENT_ROADMAP.md
index 3316f58..2b4d4cb 100644
--- a/AGRARIAN_DEVELOPMENT_ROADMAP.md
+++ b/AGRARIAN_DEVELOPMENT_ROADMAP.md
@@ -169,7 +169,7 @@ Remaining version 0.01 cleanup before moving deeper into new gameplay:
 
 - [ ] Decide whether to keep current Unreal template variants or remove unused starter variants.
 - [!] Create protected `main` branch. Blocked while the repo remains private on the current GitHub plan; GitHub API reports this requires GitHub Pro or making the repository public.
-- [?] Decide whether to create/use a long-lived `dev` branch.
+- [x] Decide whether to create/use a long-lived `dev` branch. Decision: do not use one yet; use `main` plus short-lived task branches until team size or release channels require a staging branch.
 - [~] Finish branch naming and commit message conventions.
 - [x] Define GitHub/LFS free-tier storage guardrails.
 - [ ] Define backup expectations for NAS and repository.
@@ -193,7 +193,7 @@ Goal: Prepare the project so all future development is controlled, recoverable,
 - [x] Ensure `Binaries/`, `Intermediate/`, `Saved/`, and `DerivedDataCache/` are excluded unless intentionally needed.
 - [x] Commit clean baseline project.
 - [!] Create protected `main` branch. Blocked while the repo remains private on the current GitHub plan; GitHub API reports this requires GitHub Pro or making the repository public.
-- [?] Create `dev` branch if we want staging before main.
+- [x] Create `dev` branch if we want staging before main. Decision: do not create a long-lived `dev` branch yet.
 - [~] Define branch naming conventions.
 - [~] Define commit message conventions.
 - [x] Define GitHub/LFS free-tier storage guardrails.
@@ -1400,7 +1400,7 @@ Current version: `0.01 Foundation Baseline`
 Earliest incomplete foundation items:
 
 - [!] Create protected `main` branch. Blocked while the repo remains private on the current GitHub plan; GitHub API reports this requires GitHub Pro or making the repository public.
-- [?] Decide whether to create/use a long-lived `dev` branch.
+- [x] Decide whether to create/use a long-lived `dev` branch. Decision: no long-lived `dev` branch yet.
 - [~] Finish branch naming conventions.
 - [~] Finish commit message conventions.
 - [x] Define GitHub/LFS free-tier storage guardrails.
@@ -1421,4 +1421,4 @@ Earliest incomplete foundation items:
 
 Immediate next item:
 
-- [?] Decide whether to create/use a long-lived `dev` branch.
+- [~] Finish branch naming conventions.
diff --git a/Scripts/audit_repo_storage.sh b/Scripts/audit_repo_storage.sh
index 30c4799..36211d6 100644
--- a/Scripts/audit_repo_storage.sh
+++ b/Scripts/audit_repo_storage.sh
@@ -8,8 +8,16 @@ echo "Agrarian repository storage audit"
 echo "Repository: $repo_root"
 echo
 
-echo "Working tree size:"
-du -sh . 2>/dev/null || true
+echo "Project directory sizes:"
+du -sh .git Content Source Config Docs Scripts Data 2>/dev/null || true
+if [ "${AGRARIAN_AUDIT_FULL_TREE:-0}" = "1" ]; then
+  echo
+  echo "Full working tree size:"
+  du -sh . 2>/dev/null || true
+else
+  echo
+  echo "Full working tree size skipped. Set AGRARIAN_AUDIT_FULL_TREE=1 to include generated folders."
+fi
 echo
 
 echo "Git object database:"
@@ -26,8 +34,10 @@ echo
 if git lfs version >/dev/null 2>&1; then
   echo "Largest Git LFS objects:"
   largest_lfs="$(mktemp)"
-  git lfs ls-files -s | sed -E 's/^.*\\(([^)]*)\\)$/\\1 &/' | sort -hr > "$largest_lfs"
-  head -n 25 "$largest_lfs"
+  git lfs ls-files -s |
+    sed -E 's/^.*\(([0-9.]+) ([KMGT]?B)\)$/\1\2 &/' |
+    sort -hr > "$largest_lfs"
+  head -n 25 "$largest_lfs" | sed -E 's/^[0-9.]+[KMGT]?B //'
   rm -f "$largest_lfs"
 else
   echo "Git LFS is not installed."