Done Work Item
Test suite refactor Phase 1: shared harness extraction
Implement Phase 1 of BUILD_FACTORY_TEST_SUITE_REFACTOR_EXECUTION_PLAN_V1. Create the shared test harness module that all future typed suite scripts will import. No behavior changes — the monolithic run-factory-tests.ps1 must import and use the shared helpers with identical outcomes to the pre-extraction baseline. Deliverables: (1) scripts/tests/shared/factory-test-harness.psm1 — shared setup, teardown, test context, and result aggregation. (2) scripts/tests/shared/factory-test-assert.ps1 — shared assertion helpers used across test types. (3) scripts/tests/shared/factory-test-json.ps1 — shared JSON contract helpers (Invoke-JsonScript, Convert-JsonTextToObject, etc., currently embedded or repeated across the monolith). Update run-factory-tests.ps1 to import these modules; confirm all existing tests still pass. Parity proof required: run full factory tests before and after and show identical pass counts. Touch-once policy: no semantic changes to test logic during extraction.
Execution Context
- ID
- wi-BF-184
- Branch
- bf/BF-184-test-phase1-shared-harness
- Validation
- ./scripts/validate-local.ps1
- PR
- https://github.com/SingletonTheory/build-factory-bootstrap/pull/195
Lifecycle Metadata
- Lane
- Done
- Work type
- implementation
- Source
- done
- Status
- done
- State
- done
- Done criteria
- 2
Queue Truth
Freshness: Fresh (snapshot age 0s)
Drift: none.
Reconciliation Guidance
- No reconciliation required; item truth signals are consistent.
Prompt Context
./work-items/prompts/wi-BF-184.prompt.md
Implement Phase 1 of BUILD_FACTORY_TEST_SUITE_REFACTOR_EXECUTION_PLAN_V1. Create the shared test harness module that all future typed suite scripts will import. No behavior changes — the monolithic run-factory-tests.ps1 must import and use the shared helpers with identical outcomes to the pre-extraction baseline. Deliverables: (1) scripts/tests/shared/factory-test-harness.psm1 — shared setup, teardown, test context, and result aggregation. (2) scripts/tests/shared/factory-test-assert.ps1 — shared assertion helpers used across test types. (3) scripts/tests/shared/factory-test-json.ps1 — shared JSON contract helpers (Invoke-JsonScript, Convert-JsonTextToObject, etc., currently embedded or repeated across the monolith). Update run-factory-tests.ps1 to import these modules; confirm all existing tests still pass. Parity proof required: run full factory tests before and after and show identical pass counts. Touch-once policy: no semantic changes to test logic during extraction.
Available Actions
- Start executionBlocked
Queue execution handoff for this work item.
Recovery guidance
- Cause
- Done items stay closed; Start execution cannot move them backward.
- Policy context
- Lane transition policy blocks Start execution when the item is already Done.
- Next step
- Create a net-new work item if more delivery is needed instead of reopening this one.
- Safe retry
- Do not retry Start execution on a done item.
identity: start-execution
permission: factory.work-item.execute
policy gate lane-transition: blocked (Done items stay closed; Start execution cannot move them backward.)
POST /api/control-plane/items/wi-BF-184/actions/start-execution
- Request reviewBlocked
Mark this item ready for review lane handoff.
Recovery guidance
- Cause
- Done items stay closed; Request review cannot move them backward.
- Policy context
- Lane transition policy blocks Request review when the item is already Done.
- Next step
- Create a net-new work item if more delivery is needed instead of reopening this one.
- Safe retry
- Do not retry Request review on a done item.
identity: request-review
permission: factory.work-item.request-review
policy gate lane-transition: blocked (Done items stay closed; Request review cannot move them backward.)
POST /api/control-plane/items/wi-BF-184/actions/request-review
- Prepare releaseEnabled
Run release-preparation checks for the work item.
identity: prepare-release
permission: factory.work-item.prepare-release
policy gate lane-eligibility: pass
policy gate pull-request: pass
POST /api/control-plane/items/wi-BF-184/actions/prepare-release
- Record historyEnabled
Capture history snapshots for audit and validation views.
identity: record-history
permission: factory.work-item.record-history
policy gate context-visibility: pass
POST /api/control-plane/items/wi-BF-184/actions/record-history