PR_26180_OWNER_022-delete-remaining-root-src-files

dev/reports/PR_26180_OWNER_022-delete-remaining-root-src-files_branch-validation.md

@@ -0,0 +1,8 @@
+# PR_26180_OWNER_022-delete-remaining-root-src-files Branch Validation
+
+- Expected branch: `PR_26180_OWNER_022-delete-remaining-root-src-files`
+- Actual branch: `PR_26180_OWNER_022-delete-remaining-root-src-files`
+- Branch validation: PASS
+- Worktree at branch start: clean after removal of previous PR022 hard-stop artifacts
+- Current action: HARD STOP report artifacts only
+- Source files modified: none

dev/reports/PR_26180_OWNER_022-delete-remaining-root-src-files_manual-validation-notes.md

@@ -0,0 +1,13 @@
+# PR_26180_OWNER_022-delete-remaining-root-src-files Manual Validation Notes
+
+- Reviewed current Project Instructions version `2026.06.28.021`.
+- Confirmed canonical report path is `dev/reports/` and ZIP path is `dev/workspace/zips/`.
+- Confirmed current branch is `PR_26180_OWNER_022-delete-remaining-root-src-files`.
+- Confirmed 65 tracked root `src` files remain before attempted deletion.
+- Confirmed active references still point to root `src/shared` from dev tests, validation scripts, and tooling baselines.
+- No runtime, UI, API, database, product, `www/`, `api/`, or source files were modified.
+- Manual recommendation: create a follow-up migration PR that updates the active tests/scripts/tooling baselines away from root `src/shared` before deleting the remaining files.
+
+- Final `git diff --check` and `git diff --cached --check`: PASS.
+- Final `npm run validate:canonical-structure`: PASS.
+- Targeted root `src` scan still reports active references and remains the hard-stop blocker.

dev/reports/PR_26180_OWNER_022-delete-remaining-root-src-files_report.md

@@ -0,0 +1,66 @@
+# PR_26180_OWNER_022-delete-remaining-root-src-files Hard Stop Report
+
+## Outcome
+
+HARD STOP. No root `src/` files were deleted, archived, or moved.
+
+## Reason
+
+The required root `src/` reference audit found active current validation/test/tooling references that still require root `src/shared` files. The task explicitly requires a hard stop if runtime, test, package, or CI references still require root `src`.
+
+## Branch
+
+- Branch: `PR_26180_OWNER_022-delete-remaining-root-src-files`
+- HEAD: `2e38e9e31cf0b9a2718681ea95a6b8054f4a7a93`
+- Worktree before reports: clean
+- Base requested: `PR_26180_OWNER_021-archive-legacy-games-samples-teardown`
+
+## Root Src Count
+
+- Before: 65 tracked files under `src/`
+- After: 65 tracked files under `src/`
+- Active reference scan matches: 1284
+
+## High-Signal Evidence
+
+- `dev\tests\shared\InMemoryProjectDataStore.test.mjs:14:} from "../../../src/shared/contracts/projectDataStoreContract.js";`
+- `dev\tests\tools\ToolManifestBoundary.test.mjs:11:    "www/src/shared/schemas/tools/palette-browser.schema.json",`
+- `dev\scripts\validate-json-contracts.mjs:499:  return `www/src/shared/schemas/tools/${normalized}.schema.json`;`
+- `dev\tools\toolbox-dev\checkSharedExtractionGuard.baseline.json:3100:      "file": "www/src/shared/color/color.js",`
+- `dev\tools\toolbox-dev\checkBoundaryHardeningGuard.mjs:16:  ['src/shared/', 'shared'],`
+- `dev\tests\shared\ContractIndexValidation.test.mjs:59:  const actualRootContractFiles = fs.readdirSync(resolvePath("src/shared/contracts"))`
+- `dev\tests\validation\samples.shared.boundaries.report.json:2:  "$schema": "../../../src/shared/schemas/samples/sample.tool-payload.schema.json",`
+- `dev\scripts\validate-json-contracts.mjs:653:  const gameManifestSchemaPath = "src/shared/schemas/game.manifest.schema.json";`
+- `dev\scripts\validate-json-contracts.mjs:665:        errors.push("src/shared/schemas/game.manifest.schema.json not found");`
+- `dev\scripts\validate-json-contracts.mjs:706:    if (!schemaPath.startsWith("www/src/shared/schemas/tools/") || !schemaPath.endsWith(".schema.json")) {`
+- `dev\tests\validation\samples.runtime.validation.report.json:2:  "$schema": "../../../src/shared/schemas/samples/sample.tool-payload.schema.json",`
+- `dev\tests\validation\samples.curriculum.validation.json:2:  "$schema": "../../../src/shared/schemas/samples/sample.tool-payload.schema.json",`
+- `dev\tests\fixtures\workspace-v2\uat.manifest.json:2:  "$schema": "src/shared/schemas/game.manifest.schema.json",`
+- `dev\tests\fixtures\workspace-v2\uat.manifest.json:17:      "$schema": "src/shared/schemas/tools/palette-manager-v2.schema.json",`
+- `dev\tests\fixtures\workspace-v2\uat.manifest.json:59:      "$schema": "src/shared/schemas/tools/asset-manager-v2.schema.json",`
+- `dev\tools\toolbox-dev\checkSharedExtractionGuard.baseline.json:3105:      "file": "src/shared/contracts/auditEventContract.js",`
+- `dev\tools\toolbox-dev\checkSharedExtractionGuard.baseline.json:3110:      "file": "src/shared/contracts/backupSnapshotContract.js",`
+- `dev\tools\toolbox-dev\checkSharedExtractionGuard.baseline.json:3115:      "file": "src/shared/contracts/collaborationRoleContract.js",`
+- `dev\tools\toolbox-dev\checkSharedExtractionGuard.baseline.json:3120:      "file": "src/shared/contracts/creatorProfileContract.js",`
+- `dev\tools\toolbox-dev\checkSharedExtractionGuard.baseline.json:3125:      "file": "src/shared/contracts/downloadGrantContract.js",`
+- `dev\tools\toolbox-dev\checkSharedExtractionGuard.baseline.json:3130:      "file": "src/shared/contracts/entitlementContract.js",`
+- `dev\tools\toolbox-dev\checkSharedExtractionGuard.baseline.json:3135:      "file": "src/shared/contracts/installReceiptContract.js",`
+- `dev\tools\toolbox-dev\checkSharedExtractionGuard.baseline.json:3140:      "file": "src/shared/contracts/libraryItemContract.js",`
+- `dev\tools\toolbox-dev\checkSharedExtractionGuard.baseline.json:3145:      "file": "src/shared/contracts/marketplaceListingContract.js",`
+
+## Targeted Validation Evidence
+
+- `git diff --check`: PASS before report generation.
+- `npm run validate:canonical-structure`: PASS.
+- `node ./dev/scripts/run-node-test-files.mjs dev/tests/shared/InMemoryProjectDataStore.test.mjs dev/tests/tools/ToolManifestBoundary.test.mjs dev/tests/shared/ContractIndexValidation.test.mjs`: FAILED.
+  - `InMemoryProjectDataStore.test.mjs`: PASS.
+  - `ToolManifestBoundary.test.mjs`: PASS.
+  - `ContractIndexValidation.test.mjs`: FAILS on missing legacy `src/shared/contracts/replayContracts.js`.
+
+## Decision
+
+The PR stopped before deleting or archiving remaining root `src` files. The next scoped PR should first migrate or retire the active validation/test/tooling dependencies that still point at root `src/shared`, then retry root `src` deletion only after `git ls-files -- src` and active reference scans prove it is safe.
+
+## Files Changed By This Outcome
+
+Reports only. No runtime, API, UI, database, or product files were modified.

dev/reports/PR_26180_OWNER_022-delete-remaining-root-src-files_requirement-checklist.md

@@ -0,0 +1,13 @@
+# PR_26180_OWNER_022-delete-remaining-root-src-files Requirement Checklist
+
+| Requirement | Status | Notes |
+|---|---:|---|
+| Work only on remaining tracked files under root `src/` | PASS | Audit inspected tracked `src/` files only. |
+| Do not touch `dev/workspace/generated/tool-images/**` | PASS | Protected developer workspace path was not touched. |
+| Preserve no root `src` file unless active refs prove it required | HARD STOP | Active refs still prove current validation/test dependencies require root `src`. |
+| Delete definitely obsolete files instead of archiving | BLOCKED | Deletion would occur while active test/tooling refs remain. |
+| Required reference audit before delete/archive | PASS | Scan found 1284 matches. |
+| Stop on active runtime/test/package/CI refs requiring root `src` | PASS | Hard stop triggered. |
+| Report `git ls-files -- src` count before and after | PASS | Before 65, after 65. |
+| Produce reports under `dev/reports/` | PASS | This checklist and companion reports were generated. |
+| Produce ZIP under `dev/workspace/zips/` | PASS | Hard-stop ZIP generated for this outcome. |

dev/reports/PR_26180_OWNER_022-delete-remaining-root-src-files_validation-report.md

@@ -0,0 +1,14 @@
+# PR_26180_OWNER_022-delete-remaining-root-src-files Validation Report
+
+## Commands
+
+| Command | Result | Notes |
+|---|---:|---|
+| `git diff --check` and `git diff --cached --check` | PASS | Ran after report generation against unstaged and staged changes. |
+| `npm run validate:canonical-structure` | PASS | Canonical repository structure guardrail passed after report generation. |
+| Targeted root `src` reference scan | HARD STOP | Found 1284 active matches outside archive/report/workspace paths. |
+| `node ./dev/scripts/run-node-test-files.mjs dev/tests/shared/InMemoryProjectDataStore.test.mjs dev/tests/tools/ToolManifestBoundary.test.mjs dev/tests/shared/ContractIndexValidation.test.mjs` | FAIL | First two tests passed; `ContractIndexValidation` failed on missing legacy `replayContracts.js`. |
+
+## Validation Decision
+
+No source deletion/archive was performed because the hard-stop condition was met before implementation.

dev/reports/codex_changed_files.txt

@@ -1,72 +1,8 @@
-D	dev/archive/v1-v2/tools/old_Parallax Scene Studio/README.md
-D	dev/archive/v1-v2/tools/old_Parallax Scene Studio/how_to_use.html
-D	dev/archive/v1-v2/tools/old_Parallax Scene Studio/index.html
-D	dev/archive/v1-v2/tools/old_Parallax Scene Studio/main.js
-D	dev/archive/v1-v2/tools/old_Parallax Scene Studio/parallaxEditor.css
-D	dev/archive/v1-v2/tools/old_Parallax Scene Studio/samples/images/cloud-bands.svg
-D	dev/archive/v1-v2/tools/old_Parallax Scene Studio/samples/images/foreground-occluder.svg
-D	dev/archive/v1-v2/tools/old_Parallax Scene Studio/samples/images/hero-proxy.svg
-D	dev/archive/v1-v2/tools/old_Parallax Scene Studio/samples/images/mountain-ridge-short.svg
-D	dev/archive/v1-v2/tools/old_Parallax Scene Studio/samples/images/mountain-ridge-tall.svg
-D	dev/archive/v1-v2/tools/old_Parallax Scene Studio/samples/images/mountain-ridge.svg
-D	dev/archive/v1-v2/tools/old_Parallax Scene Studio/samples/images/sky-gradient.svg
-D	dev/archive/v1-v2/tools/old_Parallax Scene Studio/samples/mario_style_bushes_foreground.svg
-D	dev/archive/v1-v2/tools/old_Parallax Scene Studio/samples/mario_style_clouds.svg
-D	dev/archive/v1-v2/tools/old_Parallax Scene Studio/samples/mario_style_hills.svg
-D	dev/archive/v1-v2/tools/old_Parallax Scene Studio/samples/mario_style_leaf_overlay.svg
-D	dev/archive/v1-v2/tools/old_Parallax Scene Studio/samples/mario_style_learning_level_parallax.json
-D	dev/archive/v1-v2/tools/old_Parallax Scene Studio/samples/mario_style_mountains.svg
-D	dev/archive/v1-v2/tools/old_Parallax Scene Studio/samples/mario_style_sky.svg
-D	dev/archive/v1-v2/tools/old_Parallax Scene Studio/samples/parallax_sample.json
-D	dev/archive/v1-v2/tools/old_Parallax Scene Studio/samples/sample-manifest.json
-D	dev/archive/v1-v2/tools/old_Parallax Scene Studio/samples/tilemap_parallax_sample.json
-D	dev/archive/v1-v2/tools/old_object-vector-studio-v2/README.md
-D	dev/archive/v1-v2/tools/old_object-vector-studio-v2/docs/BATCH_GUARDRAIL_CONTRACT.md
-D	dev/archive/v1-v2/tools/old_object-vector-studio-v2/docs/CONTROL_SERVICE_CONTRACTS.md
-D	dev/archive/v1-v2/tools/old_object-vector-studio-v2/docs/OBJECT_VECTOR_STUDIO_V2_REQUIREMENTS.md
-D	dev/archive/v1-v2/tools/old_object-vector-studio-v2/how_to_use.html
-D	dev/archive/v1-v2/tools/old_object-vector-studio-v2/index.html
-D	dev/archive/v1-v2/tools/old_object-vector-studio-v2/js/ToolStarterApp.js
-D	dev/archive/v1-v2/tools/old_object-vector-studio-v2/js/bootstrap.js
-D	dev/archive/v1-v2/tools/old_object-vector-studio-v2/js/controls/AccordionSection.js
-D	dev/archive/v1-v2/tools/old_object-vector-studio-v2/js/controls/ActionNavControl.js
-D	dev/archive/v1-v2/tools/old_object-vector-studio-v2/js/controls/InspectorControl.js
-D	dev/archive/v1-v2/tools/old_object-vector-studio-v2/js/controls/PreviewPanelControl.js
-D	dev/archive/v1-v2/tools/old_object-vector-studio-v2/js/controls/SourceInputControl.js
-D	dev/archive/v1-v2/tools/old_object-vector-studio-v2/js/controls/StatusLogControl.js
-D	dev/archive/v1-v2/tools/old_object-vector-studio-v2/js/controls/ToolStarterShellControl.js
-D	dev/archive/v1-v2/tools/old_object-vector-studio-v2/js/services/ObjectVectorStudioV2SchemaService.js
-D	dev/archive/v1-v2/tools/old_object-vector-studio-v2/js/services/ToolStateSerializer.js
-D	dev/archive/v1-v2/tools/old_object-vector-studio-v2/playwright.config.mjs
-D	dev/archive/v1-v2/tools/old_object-vector-studio-v2/possible.future.adds.txt
-D	dev/archive/v1-v2/tools/old_object-vector-studio-v2/styles/toolStarter.css
-D	dev/archive/v1-v2/tools/old_object-vector-studio-v2/vector-native-arcade/README.md
-D	dev/archive/v1-v2/tools/old_object-vector-studio-v2/vector-native-arcade/assets/data/palettes/vector-native-primary.palette.json
-D	dev/archive/v1-v2/tools/old_object-vector-studio-v2/vector-native-arcade/assets/data/parallax/template-backdrop.parallax.json
-D	dev/archive/v1-v2/tools/old_object-vector-studio-v2/vector-native-arcade/assets/data/parallax/template-backdrop.svg
-D	dev/archive/v1-v2/tools/old_object-vector-studio-v2/vector-native-arcade/assets/data/tilemaps/template-arena.tilemap.json
-D	dev/archive/v1-v2/tools/old_object-vector-studio-v2/vector-native-arcade/assets/data/tilemaps/template-ui.tileset.json
-D	dev/archive/v1-v2/tools/old_object-vector-studio-v2/vector-native-arcade/assets/data/vectors/template-hud.vector.json
-D	dev/archive/v1-v2/tools/old_object-vector-studio-v2/vector-native-arcade/assets/data/vectors/template-obstacle-large.vector.json
-D	dev/archive/v1-v2/tools/old_object-vector-studio-v2/vector-native-arcade/assets/data/vectors/template-obstacle-small.vector.json
-D	dev/archive/v1-v2/tools/old_object-vector-studio-v2/vector-native-arcade/assets/data/vectors/template-player.vector.json
-D	dev/archive/v1-v2/tools/old_object-vector-studio-v2/vector-native-arcade/assets/data/vectors/template-title.vector.json
-D	dev/archive/v1-v2/tools/old_object-vector-studio-v2/vector-native-arcade/config/template.project.json
-D	dev/archive/v1-v2/tools/old_object-vector-studio-v2/vector-native-arcade/docs/ROLLBACK_NOTES.md
-D	dev/archive/v1-v2/tools/old_object-vector-studio-v2/vector-native-arcade/docs/STARTER_GUIDE.md
-D	dev/archive/v1-v2/tools/old_object-vector-studio-v2/vector-native-arcade/runtime/bootstrap.runtime.json
-M	dev/build/ProjectInstructions/PROJECT_INSTRUCTIONS.md
-M	dev/build/ProjectInstructions/PROJECT_INSTRUCTIONS_VERSION.md
-M	dev/build/ProjectInstructions/PROJECT_STATE.md
-M	dev/build/ProjectInstructions/backlog/BACKLOG_MASTER.md
-M	dev/build/ProjectInstructions/repository/canonical_repository_structure.md
-A	dev/reports/PR_26180_OWNER_021-archive-legacy-games-samples-teardown_branch-validation.md
-A	dev/reports/PR_26180_OWNER_021-archive-legacy-games-samples-teardown_manual-validation-notes.md
-A	dev/reports/PR_26180_OWNER_021-archive-legacy-games-samples-teardown_report.md
-A	dev/reports/PR_26180_OWNER_021-archive-legacy-games-samples-teardown_requirement-checklist.md
-A	dev/reports/PR_26180_OWNER_021-archive-legacy-games-samples-teardown_validation-report.md
-M	dev/tools/toolbox-dev/checkSharedExtractionGuard.baseline.json
-D	www/src/tools/common/GameManifestLoader.js
-D	www/src/tools/common/WorkspaceDirtyNotifier.js
-M	dev/reports/codex_review.diff
-M	dev/reports/codex_changed_files.txt
+dev/reports/PR_26180_OWNER_022-delete-remaining-root-src-files_branch-validation.md
+dev/reports/PR_26180_OWNER_022-delete-remaining-root-src-files_manual-validation-notes.md
+dev/reports/PR_26180_OWNER_022-delete-remaining-root-src-files_report.md
+dev/reports/PR_26180_OWNER_022-delete-remaining-root-src-files_requirement-checklist.md
+dev/reports/PR_26180_OWNER_022-delete-remaining-root-src-files_validation-report.md
+dev/reports/codex_changed_files.txt
+dev/reports/codex_review.diff
+dev/workspace/zips/PR_26180_OWNER_022-delete-remaining-root-src-files_HARD_STOP.zip