Skip to content

History / architecture

Revisions

  • wiki(travel): finish Round 03 cleanup — drop stale gatewaySubscriptions refs Round 03 of noetl/ai-meta#23 deleted src/api/gatewaySubscriptions.ts in noetl/travel#57 but two pages still listed it as a current SPA module: - architecture.md: in the "Gateway integration" three-module list. Replaced with calendarSubscription.ts and a parenthetical noting the historical gatewaySubscriptions.ts + POST /api/subscriptions/firestore path was removed in Round 03. - Home.md: the "Layer / In this repo" table for "Gateway integration" listed gatewaySubscriptions.ts. Switched to calendarSubscription.ts; updated the role description to "playbook-mediated live calendar refresh". gateway-integration.md is left as-is — Codex's earlier 4356945 commit on this wiki already converted it to the Round 03 migration record, which intentionally retains events_path + gatewaySubscriptions references in the "what changed" sections. Refs noetl/ai-meta#23 (Round 03 wiki finish).

    @kadyapam kadyapam committed May 29, 2026
  • wiki: bootstrap travel-as-NoETL-reference-SPA developer coverage This wiki frames the travel repository as the operational example of how a domain-specific single-page application is built on top of NoETL — not "the travel app" in isolation. Adds eight pages totaling ~1500 lines of developer-facing documentation: - Home.md: overview, what the repo demonstrates, table of pages. - _Sidebar.md: navigation. - architecture.md: the four layers (SPA shell / widgets / playbooks / gateway integration) and how they fit. Diagram of browser -> gateway -> noetl-server -> worker-pool flow. - widget-contract.md: schema-driven contract between playbook outputs and SPA UI. Five-step recipe for adding a new widget. - playbook-itinerary-planner.md: walkthrough of the orchestrator playbook (~16 steps). Workload contract, where each pattern lives (LLM extractor / provider abstraction via MCP / slot-state projection / render-decision in playbook), and performance notes. - gateway-integration.md: wire protocol the SPA speaks (executePlaybook GraphQL, SSE frame families playbook/result + playbook/state + subscription/event, POST/DELETE /api/subscriptions/firestore). - auth-and-session.md: Auth0-to-gateway-session model and how to swap the identity provider. - deployment.md: Vite build, Docker container, nginx config, Cloudflare Pages, Wrangler. - adapting-for-your-domain.md: fork-and-replace checklist covering six phases — naming, widget set, orchestrator playbook, MCP providers, auth re-branding, deployment. Cross-links to the ephemeral_blueprints architecture doc in noetl/docs (the foundational compute-data boundary that this repo enforces concretely by removing the Firebase SDK from the SPA in #50). Every page sources from real files in repos/travel and links back via absolute GitHub URLs into main.

    @kadyapam kadyapam committed May 24, 2026