Skip to content

Commit 9346c87

Browse files
committed
docs(e2e): close migration harness review contract gaps
Restore hidden agent-free Oracle definitions, classify pre-migration setup failures consistently, and require complete descendant teardown and installed-copy checks. Make documentation exposure and Oracle-only no-rewrite scope explicit, restrict host agent tools, and require both procedures to converge on the final guide hash. Refs #1540
1 parent 139ae20 commit 9346c87

2 files changed

Lines changed: 17 additions & 14 deletions

File tree

‎e2e/migration-harness/CONTEXT.md‎

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
# Migration Harness
22

3-
A Loop that tests an upgrade guide by having agents follow it. A Migrator upgrades a Protect.js application using only the guide, an Oracle judges the result, and an Editor revises the guide from what went wrong.
3+
A harness that tests an upgrade guide by having agents follow it. A Migrator upgrades a Protect.js application using only the guide, an Oracle judges the result, and an Editor revises the guide from what went wrong.
44

55
## Language
66

@@ -21,11 +21,11 @@ One or more Runs against a single revision of the guide, followed by at most one
2121
_Avoid_: round, cycle
2222

2323
**Migrator**:
24-
The agent responsible for upgrading the Fixture App using the guide.
24+
The agent responsible for upgrading the Fixture App using the guide, without access to the Oracle or Reference Migration.
2525
_Avoid_: subject, worker, executor
2626

2727
**Oracle**:
28-
The deterministic checks of the migrated Fixture App's behaviour, stored data and migration completeness.
28+
The deterministic, agent-free checks of the migrated Fixture App's behaviour, stored data and migration completeness, hidden from the Migrator.
2929
_Avoid_: grader, judge, evaluator
3030

3131
**App Host**:
@@ -37,7 +37,7 @@ The agent that revises the guide from eligible Run Reports in Iteration Results.
3737
_Avoid_: improver, reviewer, author
3838

3939
**Reference Migration**:
40-
A known-correct upgrade of the Fixture App used to establish that the Oracle can be passed.
40+
A known-correct upgrade of the Fixture App used to establish that the Oracle can be passed, hidden from both Migrator and Editor.
4141
_Avoid_: golden app, solution, answer key
4242

4343
**Friction Log**:

0 commit comments

Comments
 (0)