T-HQ5L-relax-the-task-contract-files-to-touch-to-areas-today-to
State: closed/done · Impact: high · Complexity: large
The task implementation-ready contract’s “Files to touch” table
(exact paths, a new/modify/delete Kind, a mandatory
delete-reference-enumeration rule) and its “Today”
| Location | Role today | table both resolved against the
filesystem, disqualifying a task whose cited path had moved even when
the task’s substance was still sound — busywork that fought the plan’s
own goal of a mostly-autonomous overnight loop.
TaskSchema/TaskReadyContract were at schema version 6. “Files to
touch” was a required-shape table with path-existence resolution;
“Today” required a | Location | Role today | table. Both were
routinely the first thing to go stale as code moved.
Proposed
Section titled “Proposed”Schema version 7: “Files to touch” becomes “Areas”
(| Area | Note |, advisory, no resolution disqualifier — a cited
area never has to resolve to an existing path); “Today” becomes
optional free-form prose with no required shape and no
path-existence check. The claim resolver for collision avoidance works
at area/directory granularity. Goal, acceptance criteria, and
out-of-scope stay strict. A v6-to-v7 migration transform reshapes
every existing task.
Approach
Section titled “Approach”- Added
v6-to-v7.tstolib/model/entities/task/migrations/, converting a “Files to touch” table into “Areas” and relaxing “Today“‘s required shape. - Updated
TASK_BODYinschema.ts(schema version 7) and the birth/ready contracts to reflect the renamed, relaxed sections. - Ran
entities-migrateacross the task corpus, touching 814 files. - Finished the rename across tests, docs, and the local task-work skill/hook that referenced the old section name.
| Area | Note |
|---|---|
solutions/ontological/lib/model/entities/task/ | Schema v7, TASK_BODY, v6-to-v7 migration |
docs/planning/tasks/ | Corpus-wide migration (814 files) |
solutions/ontological/skills/task-work/ | Areas rename in the local hook/skill prose |
Acceptance criteria
Section titled “Acceptance criteria”- AC-1:
TaskSchema.SCHEMA_VERSIONis'7'andTASK_BODYnames the areas section “Areas”, not “Files to touch”. - AC-2: No task file under
docs/planning/tasks/contains a “Files to touch” heading. - AC-3:
sdlc entities audit --strictreports zero schema-version-drift findings on the task corpus.
Out of scope
Section titled “Out of scope”- none
Dependencies
Section titled “Dependencies”- none