Add shared port registry workflow and improve scaffold tooling

docs/operations.md

@@ -22,6 +22,31 @@ install/verify.ps1
 
 Scheduled sync will be added on top of the same update and verify entrypoints.
 
+## Port Registry
+
+Session start hooks append events and also synchronize project-local port
+declarations into the machine-wide registry.
+
+Source-of-truth file:
+
+- `~/.copilot-resources-state/project-ports-registry.json`
+
+Project-local declaration file:
+
+- `.local/project-ports.json`
+
+Manual sync for the current workspace:
+
+```bash
+node ~/.copilot-resources/resources/scripts/update-port-registry.mjs
+```
+
+Conflict report:
+
+```bash
+node ~/.copilot-resources/resources/scripts/update-port-registry.mjs --report
+```
+
 ## Audit
 
 ```bash