From a025709a485de791c8571e3e3ec9cb35471e4f15 Mon Sep 17 00:00:00 2001 From: prosdev Date: Sat, 14 Mar 2026 01:58:22 -0700 Subject: [PATCH] docs: restructure plans into execution and canvas tracks Split gw-plans into execution/ and canvas/ subdirectories to mirror the monorepo structure. Adds canvas phase roadmap (C1-C6) mapped to proposal versions. Deployment stays at the top level as it spans both layers. Co-Authored-By: Claude Opus 4.6 (1M context) --- .claude/gw-plans/README.md | 26 ++++++++----------- .claude/gw-plans/canvas/README.md | 14 ++++++++++ .claude/gw-plans/execution/README.md | 14 ++++++++++ .../phase-1-db-tools-state-utils.md | 0 .../phase-1.5-execution-auth.md | 0 .../phase-2-graph-schema-langgraph-builder.md | 0 6 files changed, 39 insertions(+), 15 deletions(-) create mode 100644 .claude/gw-plans/canvas/README.md create mode 100644 .claude/gw-plans/execution/README.md rename .claude/gw-plans/{ => execution}/phase-1-db-tools-state-utils.md (100%) rename .claude/gw-plans/{ => execution}/phase-1.5-execution-auth.md (100%) rename .claude/gw-plans/{ => execution}/phase-2-graph-schema-langgraph-builder.md (100%) diff --git a/.claude/gw-plans/README.md b/.claude/gw-plans/README.md index 3d9e19d..1e5e984 100644 --- a/.claude/gw-plans/README.md +++ b/.claude/gw-plans/README.md @@ -1,24 +1,20 @@ -# Execution Layer — Plans +# GraphWeave — Plans -Plans for the GraphWeave execution layer (FastAPI + LangGraph backend). +Plans for the GraphWeave project, organized by layer. Each plan is written before implementation, reviewed, and committed. Implementation deviations are logged at the bottom of each plan file. -## Plans +## Tracks -| Phase | Plan | Status | PR | -|-------|------|--------|----| -| 1 | [DB, Tools, State Utils](phase-1-db-tools-state-utils.md) | ✅ Merged | [#1](https://github.com/prosdevlab/graphweave/pull/1) | -| 1.5 | [Scoped API Key Auth](phase-1.5-execution-auth.md) | ✅ Merged | [#2](https://github.com/prosdevlab/graphweave/pull/2) | -| 2 | [GraphSchema → LangGraph Builder](phase-2-graph-schema-langgraph-builder.md) | 🔧 In progress | — | -| 3 | Executor + SSE streaming | 📋 Not started | — | -| 4 | API routes (run, stream, resume, validate, export) | 📋 Not started | — | -| 5 | Exporter + remaining tools + SSRF transport | 📋 Not started | — | -| 6 | Deployment — Cloud Run + Turso + Vercel + CI/CD | 📋 Not started | — | +| Track | Description | Status | +|-------|-------------|--------| +| [Execution](execution/) | FastAPI + LangGraph backend | Phases 1-2 merged, 3-6 remaining | +| [Canvas](canvas/) | React + React Flow frontend | Not started | +| Deployment | Cloud Run + Vercel + CI/CD | Not started (after both tracks) | ## Status Legend -- ✅ Merged — implemented, tested, merged to main -- 🔧 In progress — implementation underway -- 📋 Not started — plan not yet written +- Merged — implemented, tested, merged to main +- In progress — implementation underway +- Not started — plan not yet written diff --git a/.claude/gw-plans/canvas/README.md b/.claude/gw-plans/canvas/README.md new file mode 100644 index 0000000..bd03a64 --- /dev/null +++ b/.claude/gw-plans/canvas/README.md @@ -0,0 +1,14 @@ +# Canvas Layer — Plans + +React 19 + React Flow frontend phases. Depends on execution phases 3-4 for API surface. + +## Phases + +| Phase | Plan | Proposal version | Status | +|-------|------|-----------------|--------| +| C1 | Canvas core — Start/LLM/End nodes, edge wiring, React Flow setup | v0.1 | Not started | +| C2 | SSE run panel — stream display, node highlighting, reconnection | v0.1 | Not started | +| C3 | Full node set — Tool/Condition/HumanInput nodes, settings page | v0.2 | Not started | +| C4 | Validation, run input modal, state panel | v0.2 | Not started | +| C5 | Error handling, run history, debug panel, JSON schema panel | v0.3 | Not started | +| C6 | Python export, JSON read/write, dark mode, polish | v0.4 | Not started | diff --git a/.claude/gw-plans/execution/README.md b/.claude/gw-plans/execution/README.md new file mode 100644 index 0000000..637929d --- /dev/null +++ b/.claude/gw-plans/execution/README.md @@ -0,0 +1,14 @@ +# Execution Layer — Plans + +FastAPI + LangGraph backend phases. + +## Phases + +| Phase | Plan | Status | PR | +|-------|------|--------|----| +| 1 | [DB, Tools, State Utils](phase-1-db-tools-state-utils.md) | Merged | [#1](https://github.com/prosdevlab/graphweave/pull/1) | +| 1.5 | [Scoped API Key Auth](phase-1.5-execution-auth.md) | Merged | [#2](https://github.com/prosdevlab/graphweave/pull/2) | +| 2 | [GraphSchema -> LangGraph Builder](phase-2-graph-schema-langgraph-builder.md) | Merged | [#3](https://github.com/prosdevlab/graphweave/pull/3) | +| 3 | Executor + SSE streaming | Not started | — | +| 4 | API routes (run, stream, resume, validate, export) | Not started | — | +| 5 | Exporter + remaining tools + SSRF transport | Not started | — | diff --git a/.claude/gw-plans/phase-1-db-tools-state-utils.md b/.claude/gw-plans/execution/phase-1-db-tools-state-utils.md similarity index 100% rename from .claude/gw-plans/phase-1-db-tools-state-utils.md rename to .claude/gw-plans/execution/phase-1-db-tools-state-utils.md diff --git a/.claude/gw-plans/phase-1.5-execution-auth.md b/.claude/gw-plans/execution/phase-1.5-execution-auth.md similarity index 100% rename from .claude/gw-plans/phase-1.5-execution-auth.md rename to .claude/gw-plans/execution/phase-1.5-execution-auth.md diff --git a/.claude/gw-plans/phase-2-graph-schema-langgraph-builder.md b/.claude/gw-plans/execution/phase-2-graph-schema-langgraph-builder.md similarity index 100% rename from .claude/gw-plans/phase-2-graph-schema-langgraph-builder.md rename to .claude/gw-plans/execution/phase-2-graph-schema-langgraph-builder.md