packages/support/loader-smoke/README.md

# `@deepseek-ai/dsh-loader-smoke`

Shared subprocess harness for tests that boot an app and `cordis.yml` through the Cordis Loader. `resolveExampleLaunch` selects local `src` mode (tsx and root tsconfig paths) or CI `lib` mode (plain Node and package exports) from an explicit mode or `DSH_EXAMPLE_MODE`.

`runLoaderSmoke` owns the isolated cwd, DSH homes, stdin, diagnostics, deadline, termination, and cleanup. It returns both streams after a zero exit and rejects with both streams on failure.

This is support-tier test infrastructure, not product API.

## Model Experience

None, as this test-only harness boots example processes and inspects their streams without changing an assembled model request.

## Known Limitations and Deferred Work

- **Built mode requires a prior build** — the config must also resolve every named package upward through `examples/node_modules`.
- **Captured stdout and stderr are unbounded** — a runaway child can consume memory until the deadline kills it.
- **Timeout kills only the direct child** — a process tree spawned by a faulty fixture can outlive the smoke and needs external cleanup.
refactor: share loader smoke harness 2026-07-14 05:00:54 +08:00			# `@deepseek-ai/dsh-loader-smoke`

ci(examples): run examples / testing from built lib/js 2026-07-17 15:42:35 +08:00			Shared subprocess harness for tests that boot an app and `cordis.yml` through the Cordis Loader. `resolveExampleLaunch` selects local `src` mode (tsx and root tsconfig paths) or CI `lib` mode (plain Node and package exports) from an explicit mode or `DSH_EXAMPLE_MODE`.
refactor: share loader smoke harness 2026-07-14 05:00:54 +08:00
ci(examples): run examples / testing from built lib/js 2026-07-17 15:42:35 +08:00			`runLoaderSmoke` owns the isolated cwd, DSH homes, stdin, diagnostics, deadline, termination, and cleanup. It returns both streams after a zero exit and rejects with both streams on failure.
refactor: share loader smoke harness 2026-07-14 05:00:54 +08:00
ci(examples): run examples / testing from built lib/js 2026-07-17 15:42:35 +08:00			`This is support-tier test infrastructure, not product API.`
docs: classify loader smoke support surface 2026-07-14 16:24:21 +08:00
			`## Model Experience`

			`None, as this test-only harness boots example processes and inspects their streams without changing an assembled model request.`

			`## Known Limitations and Deferred Work`

ci(examples): run examples / testing from built lib/js 2026-07-17 15:42:35 +08:00			- Built mode requires a prior build — the config must also resolve every named package upward through `examples/node_modules`.
docs: classify loader smoke support surface 2026-07-14 16:24:21 +08:00			`- Captured stdout and stderr are unbounded — a runaway child can consume memory until the deadline kills it.`
			`- Timeout kills only the direct child — a process tree spawned by a faulty fixture can outlive the smoke and needs external cleanup.`