Files
dc/.agents/docs/testing.md
T
dc ad061946c3
Build / Build-and-ng-test (pull_request) Successful in 6m56s
Lighthouse Checks / lighthouse (pull_request) Canceled after 19m45s
Build / Build-and-test-development (pull_request) Canceled after 16m16s
docs(skills): add the estate deploy-and-test procedure
The shared-estate cycle is two npm scripts and sasjs test, but the seed in
npm run server is load-bearing: without it testsetup 404s settings.sas and
59 of the 64 test programs fail to complete, which reads like a broken
deployment. Record the targets, the token-pair credentials, the ADMIN group
the estate actually uses, how to read the results, and the frontend
passphrase steps as a repo-local skill, and point the testing doc at it.
2026-10-28 22:03:34 +00:00

1.3 KiB

Testing

Backend (SAS) tests are run with the sasjs CLI from the sas/ directory. For a deploy-and-run on the shared state see the dc-estate-testing skill (.agents/skills/dc-estate-testing/SKILL.md), which covers the credentials, the makedata seed the suite needs and the estate's group name.

Commands

  • Full deploy + test cycle: npm run 4gl (compiles, deploys to the 4gl target, runs makedata) then sasjs test -t 4gl.
  • The shared estate under its server target: npm run server (compile, deploy, seed) then sasjs test -t server.
  • Run tests only (no rebuild/redeploy): sasjs test -t 4gl.
  • Run a subset of tests: sasjs test -t 4gl SOMESTRING — the positional argument filters to matching tests (e.g. sasjs test -t 4gl stagedata.test.3).

Results

  • Test results: sas/sasjsresults/testResults.json / .csv / .xml
  • Individual test logs: sas/sasjsresults/logs/<testsuite>.log (e.g. services_editors_stagedata.test.3.log)
  • Coverage: sas/sasjsresults/coverage.lcov

Notes

  • Test source files live in sas/sasjs/**; sas/sasjsbuild/ is generated build output — do not hand-edit it.
  • sasjs test executes tests against the deployed app, so run npm run 4gl first after changing any service/hook/test code.
  • Assertions are made with %mp_assert(); results are written to work.test_results.