Skip to content

docs: reflect platform-agnostic architecture, usage, and structure - #11

Merged
papismurf merged 1 commit into
mainfrom
docs/platform-agnostic-refresh
Jul 8, 2026
Merged

papismurf merged 1 commit into
mainfrom
docs/platform-agnostic-refresh

Conversation

@papismurf

Copy link
Copy Markdown
Owner

Summary

Refreshes the README and docs now that the orchestrator core is platform-agnostic (ports-and-adapters) with two runtimes and pluggable LLM providers. Documentation-only — no code changes.

  • README
    • Dual-runtime overview: Cloudflare edge vs local Node (no Cloudflare account needed).
    • LLM Providers table + config env vars (LLM_PROVIDER, LLM_API_KEY, LLM_MODEL, LLM_BASE_URL).
    • Local npm run dev:local quick start; SSE-vs-WebSocket streaming note.
    • Refreshed Project Structure (core/, providers/llm/, runtime/, local/, examples), Scripts, Documentation table, and a new Examples section.
    • Fixed the logo path (backslashes → forward slashes).
  • docs/architecture.md
    • New Portable Architecture (Ports & Adapters) section: the three ports (AgentRuntime, StateStore, LlmProvider) and adapters, a two-runtime comparison table, bounded-concurrency note, and a Pluggable LLM Providers section.
    • Component map extended with the core/providers/runtime/local components.
  • docs/technical-summary.md

Verification

  • All documented env vars, provider ids, npm scripts, routes, and file paths fact-checked against the source.
  • All internal doc links and anchors verified to resolve.
  • Independent review-agent gate (principal-software-engineer skill): APPROVE.
  • Excludes unrelated .wolf/ session-metadata churn.

Test plan

  • Reviewer skims README + docs/architecture.md for accuracy and rendering.

Made with Cursor

Update the README and docs now that the orchestrator core is platform-agnostic
(ports-and-adapters) with two runtimes and pluggable LLM providers.

- README: dual-runtime overview (Cloudflare edge vs local Node, no account
  needed), LLM provider table + config env vars, local `dev:local` quick start,
  SSE-vs-WebSocket streaming note, refreshed project structure, scripts, docs
  table, and an Examples section (crypto-payments, fastapi client, task UI).
- architecture.md: add "Portable Architecture (Ports & Adapters)" — the three
  ports (AgentRuntime, StateStore, LlmProvider) and their adapters, a two-runtime
  comparison, bounded-concurrency note, and a pluggable-LLM-providers section;
  extend the component map with the core/providers/runtime/local components.
- technical-summary.md: mark the root typecheck (PR #9) and test-environment
  (PR #10) follow-ups as resolved.

Co-authored-by: Cursor <cursoragent@cursor.com>

@papismurf papismurf left a comment

Copy link
Copy Markdown
Owner Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

approved

@papismurf
papismurf merged commit bfe973c into main Jul 8, 2026
1 check passed
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.

1 participant