# Generated Scene Runtime Semantics Offline Validation Bundle Refresh Plan

Date: 2026-04-21

Design:

- `docs/superpowers/specs/2026-04-21-generated-scene-runtime-semantics-offline-validation-bundle-refresh-design.md`

Upstream plans:

- `docs/superpowers/plans/2026-04-21-generated-scene-runtime-semantics-rematerialization-execution-plan.md`
- `docs/superpowers/plans/2026-04-21-generated-scene-runtime-semantics-validation-refresh-execution-plan.md`

## Intent

Build a refreshed offline validation bundle from the 2026-04-21 runtime-semantics rematerialized 102-skill set and refreshed validation handoff assets.

This plan only prepares the portable bundle. It does not run pseudo-production validation.

## Fixed Inputs

1. `examples/scene_skill_102_runtime_semantics_rematerialization_2026-04-21`
2. `tests/fixtures/generated_scene/generated_scene_runtime_semantics_rematerialization_manifest_2026-04-21.json`
3. `tests/fixtures/generated_scene/generated_scene_runtime_semantics_rematerialization_failures_2026-04-21.json`
4. `tests/fixtures/generated_scene/scene_skill_102_runtime_semantics_deterministic_invocation_readiness_2026-04-21.json`
5. `tests/fixtures/generated_scene/scene_skill_102_runtime_semantics_natural_language_parameter_readiness_2026-04-21.json`
6. `tests/fixtures/generated_scene/scene_skill_102_runtime_semantics_natural_language_invocation_samples_2026-04-21.json`
7. `tests/fixtures/generated_scene/scene_skill_102_runtime_semantics_pseudoprod_execution_handoff_2026-04-21.json`
8. `tests/fixtures/generated_scene/scene_skill_102_runtime_semantics_pseudoprod_evidence_checklist_2026-04-21.json`
9. `tests/fixtures/generated_scene/scene_skill_102_runtime_semantics_pseudoprod_execution_record_template_2026-04-21.json`
10. `tests/fixtures/generated_scene/scene_skill_102_runtime_semantics_full_direct_mock_execution_2026-04-21.json`
11. `target/debug/sg_claw.exe` or an equivalent current local `sg_claw.exe`
12. Optional rule assets:
    - `resources/rules-102-business-targets-candidate.json`
    - `resources/rules-102-business-targets-merged.json`
    - `resources/rules-102-business-targets.patch`

## Output Directory

Create:

- `dist/sgclaw_102_runtime_semantics_validation_bundle_2026-04-21`

Do not delete or mutate:

- `dist/sgclaw_102_pseudoprod_validation_bundle_2026-04-20`

## Phases

### Phase 0: Input Verification

1. Confirm the 2026-04-21 rematerialization directory exists.
2. Confirm it contains 102 skill directories.
3. Confirm the 2026-04-21 rematerialization failures asset reports zero failures.
4. Confirm the 2026-04-21 validation refresh assets exist.
5. Confirm the pseudo-production handoff contains the refreshed selected batch.

### Phase 1: Bundle Directory Preparation

1. Create the target `dist/` bundle directory.
2. Create subdirectories:
   - `skills/`
   - `docs/`
   - `handoff/`
   - `resources/`
   - `results/`
   - `evidence/`
3. Copy `sg_claw.exe` into the bundle root.
4. Copy the 2026-04-21 rematerialized `skills/` content into the bundle.

### Phase 2: Documentation And Handoff Copy

1. Copy `SCENE_INDEX.md` and `scene_skill_102_index.json` from the 2026-04-21 rematerialization output into `docs/`.
2. Copy refreshed validation/handoff assets into `handoff/`.
3. Copy rule candidate assets into `resources/` when present.
4. Generate `README.md` with:
   - config sample using `skillsDir`
   - browser WebSocket reminder
   - service console execution notes
   - credential safety warning
   - page URL guidance
5. Generate `BATCH_001.md` from the refreshed pseudo-production handoff selected batch.
6. Generate `BUNDLE_MANIFEST.json`.

### Phase 3: Bundle Validation

1. Confirm `skills/` contains 102 scene directories.
2. Confirm every skill directory contains:
   - `SKILL.toml`
   - `SKILL.md`
   - `scene.toml`
   - `scripts/`
3. Confirm critical JSON files parse.
4. Confirm `BATCH_001.md` includes the same selected batch count as the handoff.
5. Confirm no credentials or tokens are introduced by the generated bundle docs.

### Phase 4: Report

Publish:

- `docs/superpowers/reports/2026-04-21-generated-scene-runtime-semantics-offline-validation-bundle-refresh-report.md`

The report must include:

1. bundle path
2. copied skill count
3. selected batch count
4. copied handoff assets
5. validation result
6. explicit statement that no pseudo-production execution was run

## Allowed Files

1. `dist/sgclaw_102_runtime_semantics_validation_bundle_2026-04-21/**`
2. `docs/superpowers/reports/2026-04-21-generated-scene-runtime-semantics-offline-validation-bundle-refresh-report.md`

## Forbidden Files

1. No `src/` changes
2. No `examples/scene_skill_102_runtime_semantics_rematerialization_2026-04-21/**` edits
3. No validation asset edits under `tests/fixtures/generated_scene/`
4. No official board updates
5. No old bundle deletion
6. No credentials or secret material

## Stop Statement

Stop after the refreshed offline validation bundle and report are generated and validated.

Do not run browser, inner-network, or pseudo-production validation inside this plan.