OpenSearch Dashboards Validation Protocol
Required Commands
- •
yarn osd bootstrap- Install and link dependencies- •Required when: Modified
package.json,yarn.lock, orpackages/directory - •Skip when: Only changing application code
- •Required when: Modified
- •
os optimize- Build optimizer bundles- •Required when: Code changes made and server is not running
- •Avoid
--no-cacheunless absolutely necessary
- •
os run -e- Start development server on localhost:5601- •Use this (NOT
yarn start) unless user specifies otherwise - •
os runis a wrapper with feature flags - •Server runs optimizer with file watcher automatically
- •If server already running: Skip step 2
- •Use this (NOT
Situational Validation
- •Build artifact errors:
yarn build-platform --linux --skip-os-packages - •Runtime artifact errors:
./build/opensearch-dashboards/bin/opensearch-dashboards(after build) - •Browser console errors: Use chrome-devtools MCP to access localhost:5601
Validation Rules
After every fix:
- •Run applicable steps based on changes
- •Verify each step completes with NO errors
- •If errors occur, investigate and fix
- •Repeat until all validation passes