From f625cf5c6e38c1abb98491b4e1b8ce63c57b8712 Mon Sep 17 00:00:00 2001
From: Craig Jennings <c@cjennings.net>
Date: Mon, 20 Jul 2026 07:53:05 -0500
Subject: feat: track working/ from creation, gitignore temp/ in both modes

working/ is the tracked home of in-progress work, version-controlled from creation rather than staged locally until it graduates. Filing on completion reorganizes durable artifacts into permanent homes. It doesn't mark when they became durable. Ephemeral, disposable artifacts go in a gitignored temp/ (or /tmp), never working/.

install-ai.sh emits a temp/ ignore in both track and gitignore modes. Ephemerality is independent of whether a project tracks its .ai/ tooling, so temp/ rides neither the track .gitkeep step nor the gitignore-only tooling block. working/ is never ignored, on purpose. sweep-gitignore-tooling.sh backfills temp/ as a separate mode-independent pass, not an IGNORE_SET member: folding it into that set would skip every track-mode project, the set that most needs it.

While implementing I confirmed the canonical machinery never ignored working/ (the tooling set is only .ai/ .claude/ CLAUDE.md AGENTS.md), so a project that ignored working/ did so as a local deviation.

Documents the convention in working-files.md and mirrors it in protocols.org. 7 new bats cover temp/ in both modes, never working/, and idempotency.
---
 scripts/tests/install-ai.bats              | 36 ++++++++++++++++++++++++++
 scripts/tests/sweep-gitignore-tooling.bats | 41 ++++++++++++++++++++++++++++++
 2 files changed, 77 insertions(+)

(limited to 'scripts/tests')

diff --git a/scripts/tests/install-ai.bats b/scripts/tests/install-ai.bats
index 9c6040c..14f1152 100644
--- a/scripts/tests/install-ai.bats
+++ b/scripts/tests/install-ai.bats
@@ -200,3 +200,39 @@ LAUNCHER="$REAL_REPO/claude-templates/bin/install-ai"
   [ "$status" -eq 0 ]
   [[ "$output" == *"Bootstrap .ai/"* ]]
 }
+
+# --- temp/ ephemeral-artifacts ignore (working/ tracked-from-creation ruling) ---
+
+@test "install-ai --gitignore: ignores temp/ but never working/" {
+  mkdir -p "$TEST_HOME/code/fresh"
+  (cd "$TEST_HOME/code/fresh" && git init -q)
+
+  run bash "$INSTALL_AI" --gitignore "$TEST_HOME/code/fresh"
+
+  [ "$status" -eq 0 ]
+  grep -qFx "temp/" "$TEST_HOME/code/fresh/.gitignore"
+  # working/ is the tracked home of in-progress work — it must never be ignored.
+  ! grep -qEx "/?working/?" "$TEST_HOME/code/fresh/.gitignore"
+}
+
+@test "install-ai --track: ignores temp/ even in track mode" {
+  mkdir -p "$TEST_HOME/code/tracked"
+  (cd "$TEST_HOME/code/tracked" && git init -q)
+
+  run bash "$INSTALL_AI" --track "$TEST_HOME/code/tracked"
+
+  [ "$status" -eq 0 ]
+  # temp/ is ephemeral regardless of whether the project tracks its .ai/ tooling.
+  grep -qFx "temp/" "$TEST_HOME/code/tracked/.gitignore"
+}
+
+@test "install-ai: temp/ ignore is idempotent (not re-added)" {
+  mkdir -p "$TEST_HOME/code/fresh"
+  (cd "$TEST_HOME/code/fresh" && git init -q)
+  printf 'temp/\n' > "$TEST_HOME/code/fresh/.gitignore"
+
+  run bash "$INSTALL_AI" --gitignore "$TEST_HOME/code/fresh"
+
+  [ "$status" -eq 0 ]
+  [ "$(grep -cFx 'temp/' "$TEST_HOME/code/fresh/.gitignore")" -eq 1 ]
+}
diff --git a/scripts/tests/sweep-gitignore-tooling.bats b/scripts/tests/sweep-gitignore-tooling.bats
index f18eac5..240c3be 100644
--- a/scripts/tests/sweep-gitignore-tooling.bats
+++ b/scripts/tests/sweep-gitignore-tooling.bats
@@ -190,3 +190,44 @@ make_project() {
   [ "$status" -eq 0 ]
   [[ "$output" != *"publicly reachable"* ]]
 }
+
+# --- temp/ ephemeral-artifacts backfill (mode-independent) ---
+
+@test "sweep: adds temp/ to a gitignore-mode project" {
+  make_project gimode $'.ai/\n'
+
+  run bash "$SWEEP" "$ROOT"
+
+  [ "$status" -eq 0 ]
+  grep -qFx "temp/" "$ROOT/gimode/.gitignore"
+}
+
+@test "sweep: adds temp/ to a TRACK-mode project too (temp/ is mode-independent)" {
+  make_project trackmode $'# build\nout/\n'
+
+  run bash "$SWEEP" "$ROOT"
+
+  [ "$status" -eq 0 ]
+  # The tooling set is skipped in track mode, but temp/ is not.
+  grep -qFx "temp/" "$ROOT/trackmode/.gitignore"
+  ! grep -qFx ".ai/" "$ROOT/trackmode/.gitignore"
+}
+
+@test "sweep: never adds working/" {
+  make_project gimode $'.ai/\n'
+
+  run bash "$SWEEP" "$ROOT"
+
+  [ "$status" -eq 0 ]
+  ! grep -qEx "/?working/?" "$ROOT/gimode/.gitignore"
+}
+
+@test "sweep: temp/ backfill is idempotent" {
+  make_project gimode $'.ai/\ntemp/\n'
+  bash "$SWEEP" "$ROOT" >/dev/null
+
+  run bash "$SWEEP" "$ROOT"
+
+  [ "$status" -eq 0 ]
+  [ "$(grep -cFx 'temp/' "$ROOT/gimode/.gitignore")" -eq 1 ]
+}
-- 
cgit v1.2.3