Skip to content

Integration guide: spawn-ts ↔ truffle-ts (#29) - #36

Merged
scttfrdmn merged 1 commit into
mainfrom
docs/integration
Jul 21, 2026
Merged

Integration guide: spawn-ts ↔ truffle-ts (#29)#36
scttfrdmn merged 1 commit into
mainfrom
docs/integration

Conversation

@scttfrdmn

Copy link
Copy Markdown
Contributor

Adds docs/integration.md — a single guide to how the two browser-native tools compose. Closes #29 (the truffle-ts cross-link is a small follow-up PR in that repo).

Covers:

  • The find → launch → spored flow (truffle-ts picks the type, spawn-ts launches it, spored enforces lifecycle), and how the dashboard picker embodies it.
  • The load-bearing tag-emit vs execution boundary, as a 3-tier table (browser-native / tag-emit-only / not-portable) — why a spawn-ts launch is wire-compatible with the Go tool.
  • Why truffle-ts's catalog is offline (creds/CORS) and where live data goes (the Finder seam).
  • The spored relationship in one line: browser = launcher + viewer, spored = enforcer.

Linked from docs/README.md and the top-level README. No code changes.

Add docs/integration.md — how the launcher/lifecycle (spawn-ts) and instance-
discovery (truffle-ts) tools compose: the find→launch→spored flow, the
tag-emit-vs-execution boundary (browser-native / tag-emit-only / not-portable),
why the catalog is offline, and the spored relationship. Linked from the docs
index + README. truffle-ts cross-link follows in its own repo.
@scttfrdmn
scttfrdmn merged commit 97eddad into main Jul 21, 2026
1 check passed
@scttfrdmn
scttfrdmn deleted the docs/integration branch July 21, 2026 21:30
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Combined architecture / integration doc (spawn-ts + truffle-ts)

1 participant