Group existing sample links in samples/index.html by phase using current paths only.

Author: DavidQ

docs/dev/CODEX_COMMANDS.md

@@ -2,7 +2,8 @@ MODEL: GPT-5.4-codex
 REASONING: high
 
 COMMAND:
-Execute docs/pr/BUILD_PR_SAMPLES_72_PHASE_STRUCTURE_INDEX_NORMALIZATION_FIXED.md exactly.
+Execute docs/pr/BUILD_PR_SAMPLES_73_PHASE_GROUPING_INDEX_ONLY_FIXED.md exactly.
 Modify only samples/index.html.
+Do not create or move any files or directories.
 Package to:
-<project folder>/tmp/BUILD_PR_SAMPLES_72_PHASE_STRUCTURE_INDEX_NORMALIZATION_FIXED_delta.zip
+<project folder>/tmp/BUILD_PR_SAMPLES_73_PHASE_GROUPING_INDEX_ONLY_FIXED_delta.zip

docs/dev/COMMIT_COMMENT.txt

@@ -1 +1 @@
-Fix samples index to align with phase structure (no new files)
+Group existing sample links in samples/index.html by phase using current paths only.

docs/dev/NEXT_COMMAND.txt

@@ -1 +1 @@
-Next: BUILD_PR_SAMPLES_73_PHASE_FOLDER_ALIGNMENT_PARTIAL
+Next: inspect exact sample file paths before issuing any folder-alignment BUILD.

docs/dev/reports/change_summary.txt

@@ -1 +1,3 @@
-fixed invalid target file; narrowed scope
+- replaced invalid folder-alignment BUILD with an index-only grouping BUILD
+- narrowed scope to existing file and existing resolving links only
+- removed all implied directory creation/move assumptions

docs/dev/reports/file_tree.txt

@@ -1 +1,8 @@
+docs/pr/BUILD_PR_SAMPLES_73_PHASE_GROUPING_INDEX_ONLY_FIXED.md
+docs/dev/codex_commands.md
+docs/dev/commit_comment.txt
+docs/dev/next_command.txt
+docs/dev/reports/file_tree.txt
+docs/dev/reports/change_summary.txt
+docs/dev/reports/validation_checklist.txt
 samples/index.html

docs/dev/reports/validation_checklist.txt

@@ -1 +1,5 @@
-existing file only; no creation
+- single PR purpose only
+- exact target file only
+- no file or directory creation
+- no file moves or renames
+- all links still resolve

docs/pr/BUILD_PR_SAMPLES_73_PHASE_GROUPING_INDEX_ONLY_FIXED.md

@@ -0,0 +1,35 @@
+# BUILD PR — Samples Phase Grouping (Index Only, FIXED)
+
+## Purpose
+Continue samples phase normalization without creating or moving directories.
+This PR is limited to organizing the existing samples index presentation only.
+
+## Exact Target Files
+- `samples/index.html`
+
+## Required Code Changes
+- update `samples/index.html` to group existing sample links into phase sections using the current existing paths only
+- preserve all currently resolving links
+- do not introduce references to non-existent `samples/phase-*` directories
+- do not rename or move any sample files or folders
+
+## Hard Constraints
+- exact file only
+- do not create directories
+- do not create new files
+- do not move or rename sample files
+- do not change sample content
+- do not add links that do not already resolve
+- no scope expansion beyond index presentation/grouping
+
+## Validation Steps
+- confirm only `samples/index.html` changed
+- confirm all sample links in the updated index still resolve
+- confirm no `samples/phase-*` directory references were introduced unless they already exist
+- confirm no file creation or file moves occurred
+
+## Acceptance Criteria
+- `samples/index.html` presents existing samples in clearer phase-grouped sections
+- all links continue to resolve
+- no non-existent phase directories are referenced
+- no file-system changes were made