ed/manual_slop
Private
Public Access
0
0
Fork 0
Code Activity

docs(tier2): reconcile guide with Tier 2's project-relative paths

Browse Source 
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)
This commit is contained in:
Edward R. Gonzalez
2026-06-18 18:27:13 -04:00
parent cf8e0ea8f3
commit a6038cb49a
1 changed files with 5 additions and 5 deletions
Download Patch File Download Diff File Expand all files Collapse all files
docs/guide_tier2_autonomous.md
+5 -5
View File
@@ -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/<track>/state.json` and `scripts/tier2/failures/<track>_<ts>.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/<track>/state.json` and `tests/artifacts/tier2_failures/<track>_<ts>.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/<track>_<timestamp>.md` (inside the Tier 2 clone, relative to the clone root) with 7 sections:
Written to `tests/artifacts/tier2_failures/<track>_<timestamp>.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/<track>/`
- **"Failcount state not found"**: the `tests/artifacts/tier2_state/<track>/`
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/<track>/state.json` for the last completed task,
`tests/artifacts/tier2_state/<track>/state.json` for the last completed task,
and re-invoke with `/tier-2-auto-execute <track-name> --resume`
to continue. The state file persists across runs.