hybridlabor-api BDB Ecosystem Health Skill
This skill monitors and maintains 100% operational integrity across all 8 repositories in the BDB Ecosystem.
Overview
Autonomous verification and remediation skill for maintaining 100% operational integrity across all 8 repositories in the BDB Ecosystem.
When to Use
- Use when auditing the ecosystem for NPM version drift or Git staleness.
- Use when running CI/CD health checks across multiple linked repositories.
- Do NOT use when fixing logic bugs in specific application code (use standard engineering skills).
Core Process
- Run the ecosystem health audit script (
ecosystem-health-audit.js). - Confirm zero CI failures and zero version drift before reporting green.
- Execute the autonomous remediation protocol (bumping versions, publishing) if discrepancies are found.
- Present the HTML dashboard to the user for final review.
Common Rationalizations
| Rationalization | Reality |
|---|---|
| "The audit script reported a failure, but nothing was touched recently, so it's a false positive." | Environmental drift, dependency updates, or upstream API changes can break CI without local commits. |
| "I'll just fix this one repo and ignore the others since it's a minor change." | The BDB Ecosystem is tightly coupled; a change in one module often requires version bumps in dependent modules. |
| "I'm skipping the changelog update because I only changed a comment." | All releases must be documented to maintain strict ecosystem versioning transparency. |
Red Flags
- Exiting the audit early because the first few repositories look healthy.
- Bumping NPM versions without pushing the corresponding Git tags.
- Ignoring
1exit codes from the health check script.
Verification
- Health check script
ecosystem-health-audit.jsrun completed with exit code0. - HTML report generated and verifiable at
~/bdb-dev/marketing-intern/reports/ecosystem_health_latest.html. - Git working trees for all 8 repositories are clean.
- NPM versions are fully synchronized with remote packages.
Modules Under Audit
- Kernel:
@hybridlabor-api/bdb-dev-optimized-agent-skills - Tool Installer:
@hybridlabor-api/bdb-dev-tool-installer - Synapse 3D:
@hybridlabor-api/bdb-synapse - memB Vector Engine:
@hybridlabor-api/memb - Heimdall Token Saver:
@hybridlabor-api/heimdall-token-saver - BDB OS Remote:
@hybridlabor-api/bdb-os-remote - OS Agent Workspace:
@hybridlabor-api/bdb-os-agent-workspace - Creator Extension:
@hybridlabor-api/bdb-dev-creator-extension
Automated Health Check Script
Run the automated audit at any time:
~/bdb-dev/scripts/ecosystem-health-audit.js
Script Output:
- HTML Dashboard:
~/bdb-dev/marketing-intern/reports/ecosystem_health_latest.html - Browser Launch: Automatically opens the report in Chrome / Default Browser.
- Exit Code: Returns
0if all healthy,1if attention/remediation is required.
Autonomous Remediation Protocol
If the audit detects any issues:
- Version Drift (Local != NPM): Bump
package.json, update changelog, push tag or runnpm publish --access public. - Dirty Git Tree: Review modified/untracked files, commit with semantic commit message or stash.
- CI/CD Workflow Failure: Check logs with
gh run view <id> --log-failed, resolve missing secrets/version guards, re-trigger viagh run rerun <id>.