How eliware/test works
@eliware/test is a Node.js CLI and reusable validation framework for Eliware repositories. A user invokes the CLI with a validation mode or focused test path; the CLI parses the request, acquires a repository lock, and delegates to validation orchestration. Orchestration prepares a repository context and plan, discovers and selects checks, executes them, and returns results for CLI output. Checks span repository conventions and documentation, profiles, tests and coverage, and packaging. The README documents these capabilities; sampled sources confirm key orchestration and inventory links, but not every check’s runtime wiring.
Main entry points: execute-validation-plan.mjs Plan execution · run-validation.mjs Validation runner · run-cli.mjs CLI runner · eliware-test.mjs CLI entrypoint
Components 19
CLI
- CLI entrypoint
bin/eliware-test.mjs - Argument handling
src/cli/read-diagnostic-options.mjs - CLI runner
src/cli/run-cli.mjs
Validation orchestration
- Validation runner
src/orchestrators/run-validation.mjs - Plan preparation
src/orchestrators/prepare-validation-plan.mjs - Check discovery
src/orchestrators/discover-checks.mjs - Plan execution
src/orchestrators/execute-validation-plan.mjs
Repository inventory
- Validation context
src/orchestrators/create-validation-context.mjs - Repository inventory
src/checks/create-repository-inventory.mjs - File discovery
src/checks/general/E-0.1/find-repository-files.mjs
Validation checks
- Repository conventions
src/checks/general - Documentation validation
src/checks/general/E-0.1/E-0.1.1 - Profile checks
src/checks/application - Tests and coverage
src/checks/general/E-0.1/E-0.1.20 - Coverage evidence
src/checks/general/E-0.1/E-0.1.20/E-0.1.20.10/validate-coverage-file-evidence.mjs - Tool modes
src/checks/general/E-0.1/E-0.1.20
Results and diagnostics
- Run finalization
src/orchestrators/finalize-validation-run.mjs - CLI output
src/cli/write-validation-results.mjs
Other components
- Repository maintainer
Connections 19
- Repository maintainer → CLI entrypoint: invokes
README.md - CLI entrypoint → CLI runner: starts
bin/eliware-test.mjs - CLI runner → Argument handling: parses options
src/cli/run-cli.mjs - CLI runner → Validation runner: runs validation
src/cli/run-cli.mjs - Validation runner → Plan preparation: prepares plan
src/orchestrators/run-validation.mjs - Validation runner → Check discovery: discovers checks
src/orchestrators/run-validation.mjs - Validation runner → Plan execution: executes plan
src/orchestrators/run-validation.mjs - Validation runner → Run finalization: finalizes run
src/orchestrators/run-validation.mjs - Plan preparation → Validation context: creates context
src/orchestrators/prepare-validation-plan.mjs - Validation context → Repository inventory: creates inventory
src/orchestrators/create-validation-context.mjs - Repository inventory → File discovery: discovers entries
src/checks/create-repository-inventory.mjs - Plan execution → Repository conventions: runs checks
- Plan execution → Documentation validation: runs checks
- Plan execution → Profile checks: runs checks
- Plan execution → Tests and coverage: runs checks
- Tests and coverage → Coverage evidence: assesses coverage
src/checks/general/E-0.1/E-0.1.20/run-coverage-check.mjs - Plan execution → Tool modes: runs selected mode
- Run finalization → CLI output: returns results
- CLI runner → CLI output: writes output
src/cli/run-cli.mjs