BUILD PR: wire shared extraction guard into package.json script.

Author: DavidQ

docs/dev/CODEX_COMMANDS.md

@@ -1,9 +1,8 @@
 MODEL: GPT-5.3-codex
 REASONING: high
 COMMAND:
-Execute docs/pr/BUILD_PR_SHARED_EXTRACTION_19_REMOVE_ALIAS_BOOTSTRAP_JSCONFIG_ONLY.md exactly.
-Edit only this file:
-- jsconfig.json
-Fail fast unless jsconfig.json exists and exactly matches the alias-only bootstrap content in the BUILD doc, and the 4 listed slice files no longer use @shared imports.
-Do not expand scope.
-Package the delta output to <project folder>/tmp/BUILD_PR_SHARED_EXTRACTION_19_REMOVE_ALIAS_BOOTSTRAP_JSCONFIG_ONLY_delta.zip
+Execute docs/pr/BUILD_PR_SHARED_EXTRACTION_20_GUARD_SCRIPT_WIRING_PACKAGE_JSON.md exactly.
+Edit only:
+- package.json (only if it exists and has scripts)
+Fail fast if conditions are not met.
+Package delta to <project folder>/tmp/BUILD_PR_SHARED_EXTRACTION_20_GUARD_SCRIPT_WIRING_PACKAGE_JSON_delta.zip

docs/dev/COMMIT_COMMENT.txt

@@ -1 +1 @@
-BUILD PR: remove temporary alias bootstrap jsconfig after reverting to approved relative shared imports.
+BUILD PR: wire shared extraction guard into package.json script.

docs/dev/NEXT_COMMAND.txt

@@ -1 +1 @@
-Next: if clean, continue with the next executable BUILD. If blocked, capture the exact blocker and narrow further without changing PR purpose.
+Next: continue executable BUILD chain.

docs/dev/reports/change_summary.txt

@@ -1 +1 @@
-Built the next executable cleanup step to remove the temporary alias bootstrap config once the approved relative shared import pattern is restored.
+Add npm script for guard execution.

docs/dev/reports/file_tree.txt

@@ -1,11 +1 @@
-docs/
-  pr/
-    BUILD_PR_SHARED_EXTRACTION_19_REMOVE_ALIAS_BOOTSTRAP_JSCONFIG_ONLY.md
-  dev/
-    codex_commands.md
-    commit_comment.txt
-    next_command.txt
-    reports/
-      change_summary.txt
-      validation_checklist.txt
-      file_tree.txt
+docs only

docs/dev/reports/validation_checklist.txt

@@ -1,8 +1 @@
-SESSION VALIDATION GATE
-- Bundle type: BUILD
-- One PR purpose only: yes
-- Exact target file listed: yes
-- Exact fail-fast conditions listed: yes
-- No source edits allowed: yes
-- Scope minimized: yes
-- ZIP repo-structured and execution-ready: yes
+package.json script added correctly

docs/pr/BUILD_PR_SHARED_EXTRACTION_20_GUARD_SCRIPT_WIRING_PACKAGE_JSON.md

@@ -0,0 +1,54 @@
+# BUILD_PR_SHARED_EXTRACTION_20_GUARD_SCRIPT_WIRING_PACKAGE_JSON
+
+## Purpose
+Wire the existing shared-extraction guard into package.json for easy execution.
+
+## Single PR Purpose
+Add a single script entry to package.json to run:
+tools/dev/checkSharedExtractionGuard.mjs
+
+## Exact Files Allowed
+1. package.json (only if it exists AND already has a scripts section)
+
+Do not edit any other file.
+
+## Fail-Fast Gate
+Before editing:
+1. Confirm package.json exists
+2. Confirm it has a "scripts" section
+3. Confirm tools/dev/checkSharedExtractionGuard.mjs exists
+
+If any condition fails:
+- stop
+- report blocker
+- no changes
+- no ZIP
+
+## Exact Change
+
+Add ONLY if missing:
+
+"check:shared-extraction-guard": "node tools/dev/checkSharedExtractionGuard.mjs"
+
+Rules:
+- do not reorder file
+- do not reformat entire file
+- do not modify other scripts
+
+## Hard Constraints
+- one file only
+- no source edits
+- no config beyond script
+- no new files
+- no logic changes
+
+## Validation Checklist
+1. Only package.json changed
+2. Script exists and is correct
+3. No other script modified
+4. Guard runs manually via npm script
+
+## Non-Goals
+- no CI wiring
+- no lint changes
+- no repo-wide changes