131 lines
4.9 KiB
Markdown
131 lines
4.9 KiB
Markdown
# 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.
|