docs: rebalance prose cleanup and add trimming skill

examples/echo-agent/cordis.yml

@@ -1,9 +1,5 @@
-# The echo-agent plugin tree: the stdio chat app with its LLM backend swapped to
-# the local `mock-echo` mock and the local `echo` tool added. The clean
-# demonstration of "swap the backend, keep the app" — every service the agent
-# needs lives in @deepseek-ai/dsh-stdio-agent (which bundles @deepseek-ai/dsh-
-# agent-core); this leaf only picks the backends, `hmr`, and the app config.
-#
+# Stdio agent with the network-free `mock-echo` adapter and example-local `echo`
+# tool. The app bundle supplies the spine; this leaf selects backends, HMR, and app config.
 # No API key: the `mock-echo` adapter never touches the network.
 
 # Hot-module reload for the dev/demo loop (a leaf entry, not baked into
@@ -13,8 +9,7 @@
   config:
     root: ['.']
 
-# The mock model (registers the `mock-echo` adapter) and the demo `echo` tool —
-# example-local teaching plugins, resolved relative to THIS file's directory.
+# Example-local model and tool plugins resolve relative to this file.
 - id: mock-llm
   name: './src/mock-llm.ts'
 
@@ -27,8 +22,7 @@
 - id: bash
   name: '@deepseek-ai/dsh-bash-local'
 
-# The stdio chat app: console logger + the agent-core spine (pre-creating the
-# `main` agent on the mock model) + JSONL persistence + the readline UI.
+# The app pre-creates `main` on the mock model and supplies logging, persistence, and readline UI.
 - id: stdio-agent
   name: '@deepseek-ai/dsh-stdio-agent'
   config:

examples/echo-agent/tests/echo.e2e.ts

@@ -9,17 +9,19 @@ import { afterEach, describe, expect, it } from 'vitest'
  * Keyless Loader-path smoke for examples/echo-agent: boot the real example through the
  * `@deepseek-ai/dsh-stdio-agent` bin against this example's `cordis.yml` (the cordis Loader,
  * `unwrapExports`, the whole plugin tree), pipe a script of stdin lines, and assert the
- * rendered stdout.
+ * rendered stdout. The mock adapter is network-free, making this the complete
+ * smoke; inputs cover both the echo-tool round trip and direct-reply branch.
  */
 
-// The dsh-stdio-agent bin (the demo:echo entry) and this example's cordis.yml.
+// The temp-cwd child needs absolute bin and config paths.
 const binScript = fileURLToPath(new URL('../../../packages/ui/stdio-agent/src/bin.ts', import.meta.url))
 const configPath = fileURLToPath(new URL('../cordis.yml', import.meta.url))
 const tsxLoader = fileURLToPath(import.meta.resolve('tsx'))
-// Dev/test run UNBUILT: `@deepseek-ai/dsh-*` imports resolve through the root tsconfig `paths`
-// map, which tsx finds by searching UP from cwd.
+// The temp cwd is outside the repo, so point tsx at the root config that resolves
+// unbuilt workspace packages through `paths`.
 const repoTsconfig = fileURLToPath(new URL('../../../tsconfig.json', import.meta.url))
-// The real-API workflow runs up to 14 e2e files at once.
+// Under parallel e2e load, cold tsx/Loader startup can exceed a tight deadline;
+// 30s still detects a wedged child.
 const PROCESS_TIMEOUT_MS = 30_000
 // Leave enough room for the process-owned timeout to report captured output
 // before Vitest aborts the test itself.