docs: same smoke-vs-shape claim fixed at its two remaining sites
The stdio app's module doc and its unit suite's doc carried the claim the review already corrected elsewhere: an inject-less app boots past a collapsed export shape, so the smoke proves the tree runs while the unwrapExports assertion in the unit suite pins the shape.
This commit is contained in:
@@ -30,8 +30,10 @@
|
|||||||
* Plugin export shape: named `name`/`Config`/`apply`, NO default export — the
|
* Plugin export shape: named `name`/`Config`/`apply`, NO default export — the
|
||||||
* cordis Loader's `unwrapExports` does `exports.default ?? exports`, so a stray
|
* cordis Loader's `unwrapExports` does `exports.default ?? exports`, so a stray
|
||||||
* default would collapse the module to the bare `apply` and drop the `Config`
|
* default would collapse the module to the bare `apply` and drop the `Config`
|
||||||
* namespace (see docs/postmortem/0001). The keyless Loader-path smoke in the
|
* namespace (see docs/postmortem/0001). This app carries no `inject`, so a
|
||||||
* echo example guards this end-to-end.
|
* collapsed shape would BOOT rather than crash a smoke — the shape is pinned by
|
||||||
|
* the explicit `unwrapExports` assertion in this package's unit suite, and the
|
||||||
|
* keyless echo smoke proves the composed tree runs through the real Loader.
|
||||||
*
|
*
|
||||||
* @module @deepseek-ai/dsh-stdio-agent
|
* @module @deepseek-ai/dsh-stdio-agent
|
||||||
*/
|
*/
|
||||||
|
|||||||
@@ -12,9 +12,11 @@ import * as stdioAgent from '../src/index.ts'
|
|||||||
* agent; `persistenceRoot`/`welcome`/`resumeSessionId` route to their backends.
|
* agent; `persistenceRoot`/`welcome`/`resumeSessionId` route to their backends.
|
||||||
*
|
*
|
||||||
* `hmr` is NOT part of this plugin (it is a leaf entry — a Loader-only dev
|
* `hmr` is NOT part of this plugin (it is a leaf entry — a Loader-only dev
|
||||||
* plugin the in-process tier cannot import); the REAL Loader-path guard (export
|
* plugin the in-process tier cannot import); the keyless echo smoke in
|
||||||
* shape, `unwrapExports`, the whole subprocess tree incl. `hmr`) is the keyless
|
* `examples/echo-agent` proves the whole subprocess tree (incl. `hmr`) boots
|
||||||
* echo smoke in `examples/echo-agent`. Here we assert the composition + config
|
* through the real Loader, while the export SHAPE is pinned by this suite's
|
||||||
|
* explicit `unwrapExports` assertion (an inject-less app would boot past a
|
||||||
|
* stray default rather than crash). Here we assert the composition + config
|
||||||
* forwarding the unit tier can reach.
|
* forwarding the unit tier can reach.
|
||||||
*/
|
*/
|
||||||
async function mount(config: stdioAgent.Config): Promise<Context> {
|
async function mount(config: stdioAgent.Config): Promise<Context> {
|
||||||
|
|||||||
Reference in New Issue
Block a user