Each package now has a focused README with install, quick example,
and link to full docs. Shows on npmjs.com package pages.

…-then-yield

Shell tool was hanging on CI (Linux) because SIGTERM didn't reliably
terminate sleep commands. Changed to SIGKILL for timeouts/dispose,
and simplified to collect-then-yield pattern instead of streaming
promises that could hang if process close event raced.

1. Extract safeParseArgs to core/primitives — removes duplication from
   controller.ts and runner.ts

2. Extract createToolLifecycle() to core/primitives — shared lazy init
   and dispose-all logic for both ChatController and AgentRunner

3. Add tool lifecycle to ChatController — init() before first tool use,
   disposeAll() on clear() and updateConfig(). Fixes process leak when
   shell tool is used via useChat.

4. Runner now passes onPartialResult to executeToolCall — streaming
   tools (like shell) update toolCall.result incrementally instead of
   silently consuming the AsyncIterable.

5. discovery.ts now derives metadata from actual tool instances instead
   of a static registry. Metadata can never diverge from implementations.

6. Fix safePath dead branch in filesystem — the operator precedence bug
   made the second clause always false. Simplified to a single startsWith
   check against normalized base path.

7. Add retriever support to RuntimeConfig — runner now supports RAG
   context injection, matching ChatController's capability.

Replace spawn+SIGKILL with execSync which handles timeout natively
and exits cleanly on all platforms. Simplifies the tool from
AsyncIterable to a sync execute — the timeout and allow list
guarantees remain identical.