From a6038cb49aa6d2b422e45213f4255314a6e12e37 Mon Sep 17 00:00:00 2001 From: Ed_ Date: Thu, 18 Jun 2026 18:27:13 -0400 Subject: [PATCH] docs(tier2): reconcile guide with Tier 2's project-relative paths Three path updates in docs/guide_tier2_autonomous.md to match the actual code defaults (project-relative, in tests/artifacts/): - Bootstrap callout block: scripts/tier2/state/ and scripts/tier2/failures/ -> tests/artifacts/tier2_state/ and tests/artifacts/tier2_failures/ - 'The failure report' section: scripts/tier2/failures/ -> tests/artifacts/tier2_failures/ - Troubleshooting: 'Failcount state not found' and 'Tier 2 ran out of context' both point at the right path now. Refs: conductor/tracks/tier2_no_appdata_20260618 (post-merge followup) --- docs/guide_tier2_autonomous.md | 10 +++++----- 1 file changed, 5 insertions(+), 5 deletions(-) diff --git a/docs/guide_tier2_autonomous.md b/docs/guide_tier2_autonomous.md index 1fc8e0ce..a928589e 100644 --- a/docs/guide_tier2_autonomous.md +++ b/docs/guide_tier2_autonomous.md @@ -23,7 +23,7 @@ The bootstrap: 4. Installs the git hooks (`pre-push` refuses all pushes; `post-checkout` logs checkouts) 5. Creates a "Tier 2 (Sandboxed)" desktop shortcut -**As of 2026-06-18:** the bootstrap no longer creates any directory on AppData. Tier 2 state and failure reports live inside the clone at `scripts/tier2/state//state.json` and `scripts/tier2/failures/_.md`. The user directive is "NEVER USE APPDATA" — enforced by the OpenCode `*AppData\\*` bash deny rule. +**As of 2026-06-18:** the bootstrap no longer creates any directory on AppData. Tier 2 state and failure reports live at `tests/artifacts/tier2_state//state.json` and `tests/artifacts/tier2_failures/_.md` (project-relative; inside the project tree under the already-gitignored `tests/artifacts/`). The user directive is "NEVER USE APPDATA" — enforced by the OpenCode `*AppData\\*` bash deny rule. ## Per-track invocation @@ -70,7 +70,7 @@ Override via `scripts/tier2/failcount.toml`. ## The failure report -Written to `scripts/tier2/failures/_.md` (inside the Tier 2 clone, relative to the clone root) with 7 sections: +Written to `tests/artifacts/tier2_failures/_.md` (project-relative; inside `tests/artifacts/` which is gitignored) with 7 sections: 1. Header (track, branch, started, stopped, duration, give-up signal) 2. Tasks completed 3. Current task (where it stopped) @@ -117,9 +117,9 @@ And verify allowed operations work: - **"Permission denied" on file access inside the sandbox**: the Windows ACL may be too restrictive. Re-run the bootstrap (`setup_tier2_clone.ps1` is idempotent). -- **"Failcount state not found"**: the `scripts/tier2/state//` +- **"Failcount state not found"**: the `tests/artifacts/tier2_state//` dir may be missing. The failcount module creates it on first save; - check that the Tier 2 clone's working directory is correct. + check that the Tier 2 clone's project root is correct. - **"Pre-push hook not firing"**: check that `.git/hooks/pre-push` is executable. On Windows, Git Bash runs the hook; check `git config core.hooksPath` if you have a custom hooks dir. @@ -127,6 +127,6 @@ And verify allowed operations work: `no_progress_minutes` in `scripts/tier2/failcount.toml`. - **"Tier 2 ran out of context"**: the model stopped mid-track. The user (interactive Tier 1) should `cd` to the Tier 2 clone, inspect - `scripts/tier2/state//state.json` for the last completed task, + `tests/artifacts/tier2_state//state.json` for the last completed task, and re-invoke with `/tier-2-auto-execute --resume` to continue. The state file persists across runs.