32 lines
2.1 KiB
Markdown
32 lines
2.1 KiB
Markdown
|
# Project Scoping Enforcement
|
||
|
|
|
||
|
|
## Goal
|
||
|
|
|
||
|
|
Fix scoping issues that arise when working on the automaton framework and another project using the framework simultaneously on the same machine. Also close the gap where pre-v2.0 tasks (without `.state` files) could be operated on by all commands, bypassing state enforcement entirely.
|
||
|
|
|
||
|
|
## Requirements
|
||
|
|
|
||
|
|
1. `status.py` must error (not silently fall back) when no project is detected and `--project` is not specified
|
||
|
|
2. `status.py --scope-check` must mark framework files as OUT_OF_SCOPE when working on a project (not IN_SCOPE)
|
||
|
|
3. Dashboard handler methods must use stored `project_root` instead of re-detecting from CWD
|
||
|
|
4. All status.py command invocations in prompts and config files must include `--project {project}`
|
||
|
|
5. `_infer_state_from_artifacts` must NOT be used as a silent fallback in operational commands — only `--upgrade`, `--audit`, and `--validate-folder` may use it
|
||
|
|
6. All operational commands (`--transition`, `--can-edit`, `--task`, `--approve`, `--claim`) must refuse tasks without `.state` files
|
||
|
|
7. `--list` must show tasks without `.state` as UNTRACKED, not silently bootstrap them
|
||
|
|
8. New `--upgrade` command must bootstrap `.state` files for pre-v2.0 tasks
|
||
|
|
9. `upgrade.sh` must call `status.py --upgrade` instead of manual shell heuristic bootstrapping
|
||
|
|
10. All documentation and prompts must reference `--upgrade` for pre-v2.0 tasks
|
||
|
|
|
||
|
|
## Acceptance Criteria
|
||
|
|
|
||
|
|
- [x] `status.py` errors when run from `/tmp/` without `--project`
|
||
|
|
- [x] Framework files are OUT_OF_SCOPE when `--project` points to a project
|
||
|
|
- [x] Dashboard uses stored `project_root` for all handler methods
|
||
|
|
- [x] Every status.py command reference in prompts includes `--project {project}`
|
||
|
|
- [x] `_find_project_dir` no longer has `cwd.name == ".automaton"` false positive
|
||
|
|
- [x] `_find_project_dir` errors instead of silently falling back
|
||
|
|
- [x] `--transition`, `--can-edit`, `--task`, `--claim` refuse untracked tasks
|
||
|
|
- [x] `--list` shows UNTRACKED for tasks without `.state`
|
||
|
|
- [x] `--upgrade --task {name}` bootstraps `.state` for a single task
|
||
|
|
- [x] `--upgrade` (no --task) bootstraps all tasks missing `.state`
|
||
|
|
- [x] All 192 tests pass
|