1f8a0d8c27
- MASTER_INDEX, NEXT_STEPS_*, TODOS_CONSOLIDATED, OPERATOR_READY_CHECKLIST, SUBMODULE_HYGIENE, REPO_LOCAL_RECOMMENDATIONS_STATUS, E2E_ENDPOINTS_LIST, COMPLETE_REQUIRED_OPTIONAL_RECOMMENDED_INDEX, docs/README, RUNBOOKS_MASTER_INDEX, OPTIONAL_RECOMMENDATIONS_INDEX - Record submodule commits/pushes, submodules-clean gate, public E2E evidence, studio HTTPS warn, DealFlow LAN vs apex DNS Co-authored-by: Cursor <cursoragent@cursor.com>
5.7 KiB
5.7 KiB
Repo-Local Recommendations Status
Last Updated: 2026-05-10
Purpose: Track the recommendations that can be advanced directly in this repo without requiring LAN-only access, private credentials, or third-party approvals.
Canonical sources: ALL_RECOMMENDATIONS_AND_IMPROVEMENTS_LIST.md, ADDITIONAL_RECOMMENDATIONS_TABLE.md, RECOMMENDATIONS_AND_SUGGESTIONS.md.
Interpretation rule: This page is only for repo-local execution. Operator/LAN tasks and external/vendor tasks stay in their own runbooks and checklists.
Recently advanced in this workspace
| Area | Recommendation thread | Repo-local progress |
|---|---|---|
| Submodule / CI hygiene | Clean .gitmodules trees + documented push flow |
2026-05-10: commits on main/master for smom-dbis-138, explorer-monorepo (rebase onto Gitea master), metamask-integration, cross-chain-pmm-lps, atomic-swap-dapp; bash scripts/verify/submodules-clean.sh passes; parent master pushed; see SUBMODULE_HYGIENE.md. |
| Script UX | Progress indicators / execution visibility | scripts/run-completable-tasks-from-anywhere.sh and scripts/verify/run-all-validation.sh now print start time, per-step timing, and total elapsed time. |
| Metrics collection | Machine-readable run summaries | scripts/lib/run-summary.sh now backs optional --json-out summaries for the two main no-LAN runners, writing per-step status/timing JSON under reports/status/ when requested. |
| Wrapper consistency | Shared summary coverage on orchestration entry points | The E2E, Chain 138 next-steps, and LAN operator wrappers now also expose optional --json-out summaries using the same shared helper. |
| Monitoring / health checks | Public non-EVM reachability + lane status | Added scripts/verify/check-non-evm-network-health.sh, scripts/verify/build-non-evm-lane-status.py, and generated outputs under reports/status/. |
| Documentation accuracy | Keep docs aligned with current runner behavior | Stale Step 1/4–4/4 references were refreshed to the current five-step runner behavior. |
| Documentation discoverability | Cross-links from canonical entry points | Added non-EVM health/lane references to MASTER_INDEX.md, NEXT_STEPS_INDEX.md, and scripts/verify/README.md. |
Repo-local recommendation buckets
1. In progress now
| Recommendation | Status | Current repo state |
|---|---|---|
| Progress indicators in scripts | Completed for canonical high-use wrappers | Main no-LAN runners plus the E2E, Chain 138 orchestration, and LAN operator wrappers now show clear execution progress and timing. |
| Improve troubleshooting and quick-reference discoverability | Advanced | Existing quick-reference and troubleshooting docs are present; index coverage is being improved incrementally instead of creating duplicates. |
| Script header consistency | Partially addressed | New scripts follow the header pattern; older scripts still vary. Use SCRIPT_HEADER_TEMPLATE.md when touching them. |
| Documentation accuracy review | Ongoing | Current pass fixed runner-step drift and added new reference links; broader stale-status review remains ongoing. |
2. Ready for more repo-local work
| Recommendation | Why it is still repo-local | Suggested next move |
|---|---|---|
| Script header/template normalization | Completed for touched canonical wrappers | High-use wrapper scripts edited in this pass now follow the current header/help/argument-validation pattern. |
| Input validation in scripts | Completed for touched canonical wrappers | The main wrapper scripts now reject unknown args and validate --wave / --json-out input rather than silently accepting drift. |
| Structured logging for scripts | Advanced | Shared timing/summary behavior is centralized in scripts/lib/run-summary.sh; deeper log-level normalization outside the canonical wrappers is no longer part of the active repo-local backlog. |
| Developer documentation / standards | Completed for current canonical flows | Canonical docs now reflect current five-step/no-LAN flow, current 61-address on-chain checks, and summary JSON support. |
| Metrics collection for script execution | Completed for canonical wrappers | Main no-LAN, E2E, Chain 138, and LAN operator wrappers now support optional --json-out summaries with per-step status/timing. |
3. Not repo-local in this workspace
| Recommendation | Reason |
|---|---|
| Blockscout verification settlement, Proxmox firewall changes, SSH hardening, validator key permissions | Requires LAN/host access and sometimes secrets. |
| CoinGecko / CMC / Ledger / Trust Wallet / Consensys / Chainlist submissions | Requires external accounts, outreach, or third-party review. |
| Real bridge sends, operator backups, Proxmox VM provisioning | Requires private keys, LAN, or live infrastructure changes. |
Current repo-local completion state
The currently identified repo-local recommendation backlog in the canonical trackers has been advanced to completion for the main wrapper scripts, validation runners, and index docs. What remains is either:
- operator/LAN execution,
- secrets-required live actions,
- third-party/vendor follow-through,
- or future maintenance when script behavior changes again.
Pointers
- For all recommendations: ALL_RECOMMENDATIONS_AND_IMPROVEMENTS_LIST.md
- For operator / LAN actions: RECOMMENDATIONS_OPERATOR_CHECKLIST.md
- For next-step routing: NEXT_STEPS_INDEX.md