Files

tegwick 6473fa78d7 Update SCOPE, gap analysis, and propose SAND-WP-0004

Refresh SCOPE.md for v0 operational state after WP-0002/0003/0008.
Add history/ INTENT↔SCOPE assessment and ready workplan for the-custodian
e2e shim to close the e2e-framework migration arc.

2026-06-23 21:40:43 +02:00

3.4 KiB

Raw Blame History

id, type, title, domain, repo, status, owner, topic_slug, created, updated

id	type	title	domain	repo	status	owner	topic_slug	created	updated
SAND-WP-0004	workplan	the-custodian e2e shim and deprecation	infotech	sand-boxer	ready	codex	custodian	2026-06-23	2026-06-23

the-custodian e2e shim and deprecation

Complete the e2e-framework/ migration arc: operators keep make e2e REPO= in the-custodian, but execution delegates to wise-validator (validate run) and sand-boxer (provision via profile.compose-e2e). Retire embedded provision/validation in e2e-framework/ with deprecation notices.

Charter: INTENT.md (lineage), docs/migration-gaps.md
Predecessor: SAND-WP-0003 (wise-validator extraction — finished)
Gap analysis: history/2026-06-23-post-wp0003-intent-scope-gap-analysis.md (P1)

Primary implementation touches the-custodian; sand-boxer owns coordination, doc pointers, and verification runbook updates.

Shim Makefile target

id: SAND-WP-0004-T01
status: todo
priority: high

In the-custodian/Makefile (or documented wrapper), replace e2e target body:

Resolve REPO path (~/REPO or REPO_ROOT/REPO)
Invoke validate run <repo> with env passthrough: HOST → SANDBOXER_HOST, KEEP, WORKSTREAM_ID, SANDBOXER_COMPOSE_CMD
Preserve exit code semantics (0 pass / 1 fail)
Document prerequisites: sandboxer + validate on PATH

Deprecate e2e_framework module

id: SAND-WP-0004-T02
status: todo
priority: high

the-custodian/e2e-framework/:

cli.py / __main__.py: print deprecation warning; delegate to validate run via subprocess (thin wrapper for backward compat)
sandbox.py: mark module deprecated — provision owned by sand-boxer
Keep files until one release cycle; no new features

Runbook and doc migration

id: SAND-WP-0004-T03
status: todo
priority: medium

Update the-custodian/e2e-framework/RUNBOOK.md — banner pointing to wise-validator/docs/runbooks/validate-compose-e2e.md and sand-boxer/docs/runbooks/profile-compose-e2e.md
Update sand-boxer/docs/migration-gaps.md — mark SAND-WP-0004 delivered
Update SCOPE.md "What Is Possible Now" if needed

Verification

id: SAND-WP-0004-T04
status: todo
priority: high

Document verification steps (CoulombCore): make e2e REPO=sand-boxer and make e2e REPO=activity-core with SANDBOXER_HOST + podman-compose
Optional: add scripts/verify-e2e-shim.sh in the-custodian
wise-validator T09 remote smoke can satisfy sand-boxer path; activity-core run is stretch goal (Temporal slow start)

activity-core scheduling pointer (optional)

id: SAND-WP-0004-T05
status: wait
priority: low

Document how activity-core instructions should invoke validate run instead of make e2e — no activity-core code changes in this workplan unless a ready instruction template exists.

Success criteria

make e2e REPO=<repo> from the-custodian uses wise-validator + sand-boxer
No new code paths call e2e_framework.sandbox.provision() directly
Deprecation visible on legacy python -m e2e_framework entry
Migration gaps doc shows e2e-framework arc complete

Follow-ons (from gap analysis)

Item	Workplan
Extension SDK + `ext.vm-packer`	SAND-WP-0005
TTL enforcement + scheduled reap	TBD (extend telemetry or new WP)
SaaS extensions + payments	SAND-WP-0006
Snapshot / restore	SAND-WP-0007

3.4 KiB Raw Blame History