@timo9378/flow2code 0.1.2 → 0.1.3

package/CHANGELOG.md

@@ -1,56 +1,56 @@
-# Changelog
-
-All notable changes to this project will be documented in this file.
-
-The format is based on [Keep a Changelog](https://keepachangelog.com/),
-and this project adheres to [Semantic Versioning](https://semver.org/).
-
-## [0.1.0] — 2026-02-27
-
-### Added
-
-#### Core
-- **Visual AST Compiler** — Flow-based IR → production-ready TypeScript
-- **Headless compiler** — `import { compile } from "@timo9378/flow2code/compiler"` can be used standalone
-- **CLI** — `flow2code compile`, `flow2code watch`, `flow2code migrate` commands
-- **Standalone dev server** — Zero-dependency HTTP server (`flow2code serve`)
-- **Plugin system** — `NodePlugin` interface + `PluginRegistry` factory pattern
-- **15 built-in node types** — HTTP Webhook, Cron Job, Fetch API, SQL Query, Redis Cache, Custom Code, If/Else, For Loop, Try/Catch, Return Response, Declare Variable, Transform, Call Subflow, Manual Trigger
-
-#### Platforms
-- **Next.js** platform adapter (App Router)
-- **Express** platform adapter
-- **Cloudflare Workers** platform adapter
-- Extensible `PlatformAdapter` interface, supports third-party platform registration
-
-#### AI Features
-- AI Flow Generator (OpenAI-compatible endpoints)
-- Streaming support (SSE) + retry mechanism + token budget management
-- Custom AI endpoint management (copilot-api / Gemini / Ollama)
-- AI Code Review (automatic audit of generated IR)
-- **IR Security Validator** — Scans AI-generated code for malicious patterns (eval, child_process, fs, etc.)
-
-#### DX Improvements
-- **Runtime Error Tracer** — Reverse-lookup from Error.stack via Source Map to canvas node
-- **Git-Native Split Storage** — YAML directory format, supports git diff
-- **Edit-Time Type Inference** — Real-time inference of upstream node flowState types
-- **Dynamic Node Registry** — Extensible node definition system
-- **Expression Autocomplete** — Expression input auto-completion (flowState fields + methods)
-- **Decompiler** — TypeScript → FlowIR reverse parser (ts-morph AST analysis)
-
-#### Quality
-- TypeScript strict mode
-- ESLint v10 flat config (0 errors)
-- 354 tests / 31 test files (vitest)
-- GitHub Actions CI (Node.js 20/22 matrix)
-- `.husky/pre-push` CI guard
-- Content-Security-Policy headers
-- TypeDoc API reference generation
-- Zustand undo/redo isolated slice
-
-### Security
-- IR Security Validator (`validateIRSecurity()`) three-tier threat detection
-- Custom Code dangerous API compile-time warnings
-- CSP / X-Content-Type-Options / X-Frame-Options / X-XSS-Protection headers
-- 2MB body size limit
-- IR structural validation (cycle detection, orphan node detection)
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/),
+and this project adheres to [Semantic Versioning](https://semver.org/).
+
+## [0.1.0] — 2026-02-27
+
+### Added
+
+#### Core
+- **Visual AST Compiler** — Flow-based IR → production-ready TypeScript
+- **Headless compiler** — `import { compile } from "@timo9378/flow2code/compiler"` can be used standalone
+- **CLI** — `flow2code compile`, `flow2code watch`, `flow2code migrate` commands
+- **Standalone dev server** — Zero-dependency HTTP server (`flow2code serve`)
+- **Plugin system** — `NodePlugin` interface + `PluginRegistry` factory pattern
+- **15 built-in node types** — HTTP Webhook, Cron Job, Fetch API, SQL Query, Redis Cache, Custom Code, If/Else, For Loop, Try/Catch, Return Response, Declare Variable, Transform, Call Subflow, Manual Trigger
+
+#### Platforms
+- **Next.js** platform adapter (App Router)
+- **Express** platform adapter
+- **Cloudflare Workers** platform adapter
+- Extensible `PlatformAdapter` interface, supports third-party platform registration
+
+#### AI Features
+- AI Flow Generator (OpenAI-compatible endpoints)
+- Streaming support (SSE) + retry mechanism + token budget management
+- Custom AI endpoint management (copilot-api / Gemini / Ollama)
+- AI Code Review (automatic audit of generated IR)
+- **IR Security Validator** — Scans AI-generated code for malicious patterns (eval, child_process, fs, etc.)
+
+#### DX Improvements
+- **Runtime Error Tracer** — Reverse-lookup from Error.stack via Source Map to canvas node
+- **Git-Native Split Storage** — YAML directory format, supports git diff
+- **Edit-Time Type Inference** — Real-time inference of upstream node flowState types
+- **Dynamic Node Registry** — Extensible node definition system
+- **Expression Autocomplete** — Expression input auto-completion (flowState fields + methods)
+- **Decompiler** — TypeScript → FlowIR reverse parser (ts-morph AST analysis)
+
+#### Quality
+- TypeScript strict mode
+- ESLint v10 flat config (0 errors)
+- 354 tests / 31 test files (vitest)
+- GitHub Actions CI (Node.js 20/22 matrix)
+- `.husky/pre-push` CI guard
+- Content-Security-Policy headers
+- TypeDoc API reference generation
+- Zustand undo/redo isolated slice
+
+### Security
+- IR Security Validator (`validateIRSecurity()`) three-tier threat detection
+- Custom Code dangerous API compile-time warnings
+- CSP / X-Content-Type-Options / X-Frame-Options / X-XSS-Protection headers
+- 2MB body size limit
+- IR structural validation (cycle detection, orphan node detection)

package/LICENSE

@@ -1,21 +1,21 @@
-MIT License
-
-Copyright (c) 2025-2026 flow2code contributors
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.
+MIT License
+
+Copyright (c) 2025-2026 flow2code contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,223 +1,230 @@
-# Flow2Code
-
-**The Visual AST Compiler & Code Audit Tool for Backend APIs.**
-
-> AI generates the code, Flow2Code decompiles it into a visual flow for you to audit, or compiles your visual flow into production-ready TypeScript.
-
-[![CI](https://github.com/timo9378/flow2code/actions/workflows/ci.yml/badge.svg)](https://github.com/timo9378/flow2code/actions/workflows/ci.yml)
-[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)
-[![npm version](https://img.shields.io/npm/v/@timo9378/flow2code.svg)](https://www.npmjs.com/package/@timo9378/flow2code)
-[![npm downloads](https://img.shields.io/npm/dm/@timo9378/flow2code.svg)](https://www.npmjs.com/package/@timo9378/flow2code)
-
-```
-            ┌──────────────────────────────────┐
-            │         flow2code                │
-            │                                  │
-  TS Code ──┤►  decompile() → FlowIR → Canvas  │  ← AI Code Audit
-            │                                  │
-  Canvas  ──┤►  FlowIR → compile() → TS Code   │  ← Visual Compiler
-            └──────────────────────────────────┘
-```
-
-## Why Flow2Code?
-
-| Traditional Low-Code | Flow2Code |
-|---|---|
-| Vendor-locked Runtime | **Zero-dependency** — outputs native TypeScript, deploy anywhere |
-| Black-box nodes | **AST Compilation** — ts-morph generates syntactically correct code |
-| Single platform | **Multi-platform** — Next.js, Express, Cloudflare Workers |
-| Can't version control | **Git-friendly** — IR is JSON/YAML, diffable in PRs |
-| Developers don't trust it | **Visual Audit** — bidirectional canvas ↔ code mapping |
-
-## Core Features
-
-- **AST Compilation, not interpretation** — Uses ts-morph to generate syntactically correct TypeScript. No string concatenation.
-- **Zero-dependency output** — Generated code has no runtime dependency. Deploy directly to Vercel / AWS Lambda / Cloudflare.
-- **Multi-platform output** — Same flow compiles to Next.js, Express, or Cloudflare Workers.
-- **Per-instance Plugin System** — Node logic is extensible via plugins. Compile sessions are isolated.
-- **flowState + Type Inference** — Cross-node data passing with TypeScript type safety.
-- **Auto concurrency detection** — Topological sort identifies independent nodes, auto-generates `Promise.allSettled`.
-- **Environment variable protection** — Secrets auto-converted to `process.env.XXX`.
-- **Expression Parser** — Recursive Descent Parser for `$input` / `$trigger` / `$node.xxx` template syntax.
-- **Decompiler** — TypeScript → FlowIR reverse parser for code auditing.
-- **Semantic Diff** — Structural comparison of two IR versions.
-
-## Tech Stack
-
-| Layer | Technology |
-|-------|-----------|
-| Visual Canvas | Next.js 16 + React 19 + React Flow (@xyflow/react v12) |
-| State Management | Zustand 5 |
-| IR Specification | Custom JSON Schema + TypeScript Types |
-| AST Engine | ts-morph 27 (TypeScript Compiler API Wrapper) |
-| Platform Adapters | NextjsPlatform / ExpressPlatform / CloudflarePlatform |
-| Plugin System | `createPluginRegistry()` factory (per-instance) |
-| CLI | Commander.js + Chokidar |
-| Testing | Vitest 4 — 354 tests across 31 test files |
-| CI | GitHub Actions (Node 20/22 matrix) |
-
-## Quick Start
-
-### Install
-
-```bash
-npm install @timo9378/flow2code
-```
-
-### CLI Usage
-
-```bash
-# Initialize flow2code in your project
-npx @timo9378/flow2code init
-
-# Compile a .flow.json to TypeScript
-npx @timo9378/flow2code compile .flow2code/flows/hello.flow.json --dry-run
-
-# Compile with output
-npx @timo9378/flow2code compile .flow2code/flows/hello.flow.json -o src/app/api/hello/route.ts
-
-# Audit (decompile) any TypeScript file into a visual FlowIR
-npx @timo9378/flow2code audit src/app/api/users/route.ts
-
-# Start the visual editor
-npx @timo9378/flow2code dev
-
-# Watch mode (auto-compile on file change)
-npx @timo9378/flow2code watch .flow2code/flows/
-
-# Source Map trace — find which canvas node generated a line
-npx @timo9378/flow2code trace src/app/api/hello/route.ts 15
-```
-
-### Library Usage
-
-```ts
-import { compile, validate, decompile } from "@timo9378/flow2code";
-
-// Compile: FlowIR → TypeScript
-const result = compile(ir, { platform: "nextjs" });
-
-// Validate: Check IR structure
-const check = validate(ir);
-
-// Decompile: TypeScript → FlowIR (code audit)
-const audit = decompile(code);
-```
-
-## Development
-
-```bash
-# Clone and install
-git clone https://github.com/timo9378/flow2code.git
-cd flow2code && pnpm install
-
-# Start dev server (visual canvas)
-pnpm dev
-
-# Run tests
-pnpm test:run
-```
-
-## Headless Usage (No UI Required)
-
-```ts
-import { compile } from "@timo9378/flow2code/compiler";
-
-const ir = JSON.parse(fs.readFileSync("my-api.flow.json", "utf-8"));
-const result = compile(ir, { platform: "express" });
-
-if (result.success) {
-  fs.writeFileSync(result.filePath!, result.code!);
-}
-```
-
-## Decompiler (TypeScript → Visual Flow)
-
-```ts
-import { decompile } from "@timo9378/flow2code/compiler";
-
-const code = fs.readFileSync("route.ts", "utf-8");
-const result = decompile(code);
-
-if (result.success) {
-  console.log(JSON.stringify(result.ir, null, 2));
-  console.log(`Confidence: ${result.confidence}`);
-}
-```
-
-## Project Structure
-
-```
-flow2code/
-├── src/
-│   ├── app/                         # Next.js App Router (UI)
-│   ├── components/                  # Visual canvas components
-│   ├── store/                       # Zustand canvas state management
-│   ├── lib/
-│   │   ├── index.ts                 # Headless Compiler public API
-│   │   ├── ir/
-│   │   │   ├── types.ts             # IR Schema + TypeScript types
-│   │   │   ├── validator.ts         # IR validator
-│   │   │   └── topological-sort.ts  # Topological sort + concurrency detection
-│   │   ├── compiler/
-│   │   │   ├── compiler.ts          # AST compiler core
-│   │   │   ├── decompiler.ts        # TS → FlowIR reverse parser
-│   │   │   ├── expression-parser.ts # Recursive Descent Parser
-│   │   │   ├── type-inference.ts    # Type inference engine
-│   │   │   ├── symbol-table.ts      # Human-readable variable naming
-│   │   │   ├── plugins/             # Plugin system (extensible)
-│   │   │   │   ├── index.ts          # Plugin registry factory + exports
-│   │   │   │   ├── types.ts          # PluginRegistry interface
-│   │   │   │   └── builtin.ts        # 15 built-in plugins
-│   │   │   └── platforms/           # Platform adapters
-│   │   │       ├── types.ts         # PlatformAdapter interface
-│   │   │       ├── nextjs.ts        # Next.js App Router
-│   │   │       ├── express.ts       # Express.js
-│   │   │       └── cloudflare.ts    # Cloudflare Workers
-│   │   ├── diff/                    # Semantic Diff
-│   │   └── storage/                 # .flow.json split/merge
-│   ├── cli/                         # CLI (compile/watch/init)
-│   └── server/                      # Standalone HTTP Server
-├── tests/                           # 354 tests (Vitest)
-├── .github/workflows/ci.yml         # GitHub Actions CI
-├── CONTRIBUTING.md
-└── vitest.config.ts
-```
-
-## Node Types
-
-| Category | Node | Compiled Output |
-|----------|------|-----------------|
-| ⚡ Trigger | HTTP Webhook | `export async function POST(req)` |
-| ⚡ Trigger | Cron Job | Scheduled function |
-| ⚡ Trigger | Manual | Exported async function |
-| 🔧 Action | Fetch API | `await fetch(...)` + try/catch |
-| 🔧 Action | SQL Query | Drizzle / Prisma / Raw SQL |
-| 🔧 Action | Redis Cache | Redis get/set/del |
-| 🔧 Action | Custom Code | Inline TypeScript |
-| 🔧 Action | Call Subflow | `await importedFunction(...)` |
-| 🔀 Logic | If/Else | `if (...) { } else { }` |
-| 🔀 Logic | For Loop | `for (const item of ...)` |
-| 🔀 Logic | Try/Catch | `try { } catch (e) { }` |
-| 🔀 Logic | Promise.all | `await Promise.allSettled([...])` |
-| 📦 Variable | Declare | `const x = ...` |
-| 📦 Variable | Transform | Expression transform |
-| 📤 Output | Return Response | Platform-specific Response |
-
-## Platform Support
-
-| Platform | Trigger Init | Response | CLI Flag |
-|----------|-------------|----------|----------|
-| **Next.js** (default) | `req.nextUrl.searchParams` / `req.json()` | `NextResponse.json()` | `--platform nextjs` |
-| **Express** | `req.query` / `req.body` | `res.status().json()` | `--platform express` |
-| **Cloudflare Workers** | `new URL(request.url)` / `request.json()` | `new Response()` | `--platform cloudflare` |
-
-## Contributing
-
-See [CONTRIBUTING.md](CONTRIBUTING.md).
-
-For detailed usage examples and workflows, see [USAGE.md](USAGE.md).
-
-## License
-
-MIT
+# Flow2Code
+
+**The Visual AST Compiler & Code Audit Tool for Backend APIs.**
+
+> AI generates the code, Flow2Code decompiles it into a visual flow for you to audit, or compiles your visual flow into production-ready TypeScript.
+
+[![CI](https://github.com/timo9378/flow2code/actions/workflows/ci.yml/badge.svg)](https://github.com/timo9378/flow2code/actions/workflows/ci.yml)
+[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)
+[![npm version](https://img.shields.io/npm/v/@timo9378/flow2code.svg)](https://www.npmjs.com/package/@timo9378/flow2code)
+[![npm downloads](https://img.shields.io/npm/dm/@timo9378/flow2code.svg)](https://www.npmjs.com/package/@timo9378/flow2code)
+
+```
+            ┌──────────────────────────────────┐
+            │         flow2code                │
+            │                                  │
+  TS Code ──┤►  decompile() → FlowIR → Canvas  │  ← AI Code Audit
+            │                                  │
+  Canvas  ──┤►  FlowIR → compile() → TS Code   │  ← Visual Compiler
+            └──────────────────────────────────┘
+```
+
+## Why Flow2Code?
+
+| Traditional Low-Code | Flow2Code |
+|---|---|
+| Vendor-locked Runtime | **Zero-dependency** — outputs native TypeScript, deploy anywhere |
+| Black-box nodes | **AST Compilation** — ts-morph generates syntactically correct code |
+| Single platform | **Multi-platform** — Next.js, Express, Cloudflare Workers |
+| Can't version control | **Git-friendly** — IR is JSON/YAML, diffable in PRs |
+| Developers don't trust it | **Visual Audit** — bidirectional canvas ↔ code mapping |
+
+## Core Features
+
+- **AST Compilation, not interpretation** — Uses ts-morph to generate syntactically correct TypeScript. No string concatenation.
+- **Zero-dependency output** — Generated code has no runtime dependency. Deploy directly to Vercel / AWS Lambda / Cloudflare.
+- **Multi-platform output** — Same flow compiles to Next.js, Express, or Cloudflare Workers.
+- **Per-instance Plugin System** — Node logic is extensible via plugins. Compile sessions are isolated.
+- **flowState + Type Inference** — Cross-node data passing with TypeScript type safety.
+- **Auto concurrency detection** — Topological sort identifies independent nodes, auto-generates `Promise.allSettled`.
+- **Environment variable protection** — Secrets auto-converted to `process.env.XXX`.
+- **Expression Parser** — Recursive Descent Parser for `$input` / `$trigger` / `$node.xxx` template syntax.
+- **Decompiler** — TypeScript → FlowIR reverse parser for code auditing.
+- **Semantic Diff** — Structural comparison of two IR versions.
+
+## Tech Stack
+
+| Layer | Technology |
+|-------|-----------|
+| Visual Canvas | Next.js 16 + React 19 + React Flow (@xyflow/react v12) |
+| State Management | Zustand 5 |
+| IR Specification | Custom JSON Schema + TypeScript Types |
+| AST Engine | ts-morph 27 (TypeScript Compiler API Wrapper) |
+| Platform Adapters | NextjsPlatform / ExpressPlatform / CloudflarePlatform |
+| Plugin System | `createPluginRegistry()` factory (per-instance) |
+| CLI | Commander.js + Chokidar |
+| Testing | Vitest 4 — 354 tests across 31 test files |
+| CI | GitHub Actions (Node 20/22 matrix) |
+
+## Quick Start
+
+### Install
+
+```bash
+# npm
+npm install @timo9378/flow2code
+
+# pnpm
+pnpm add @timo9378/flow2code
+
+# yarn
+yarn add @timo9378/flow2code
+```
+
+### CLI Usage
+
+```bash
+# Initialize flow2code in your project
+npx @timo9378/flow2code init
+
+# Compile a .flow.json to TypeScript
+npx @timo9378/flow2code compile .flow2code/flows/hello.flow.json --dry-run
+
+# Compile with output
+npx @timo9378/flow2code compile .flow2code/flows/hello.flow.json -o src/app/api/hello/route.ts
+
+# Audit (decompile) any TypeScript file into a visual FlowIR
+npx @timo9378/flow2code audit src/app/api/users/route.ts
+
+# Start the visual editor
+npx @timo9378/flow2code dev
+
+# Watch mode (auto-compile on file change)
+npx @timo9378/flow2code watch .flow2code/flows/
+
+# Source Map trace — find which canvas node generated a line
+npx @timo9378/flow2code trace src/app/api/hello/route.ts 15
+```
+
+### Library Usage
+
+```ts
+import { compile, validate, decompile } from "@timo9378/flow2code";
+
+// Compile: FlowIR → TypeScript
+const result = compile(ir, { platform: "nextjs" });
+
+// Validate: Check IR structure
+const check = validate(ir);
+
+// Decompile: TypeScript → FlowIR (code audit)
+const audit = decompile(code);
+```
+
+## Development
+
+```bash
+# Clone and install
+git clone https://github.com/timo9378/flow2code.git
+cd flow2code && pnpm install
+
+# Start dev server (visual canvas)
+pnpm dev
+
+# Run tests
+pnpm test:run
+```
+
+## Headless Usage (No UI Required)
+
+```ts
+import { compile } from "@timo9378/flow2code/compiler";
+
+const ir = JSON.parse(fs.readFileSync("my-api.flow.json", "utf-8"));
+const result = compile(ir, { platform: "express" });
+
+if (result.success) {
+  fs.writeFileSync(result.filePath!, result.code!);
+}
+```
+
+## Decompiler (TypeScript → Visual Flow)
+
+```ts
+import { decompile } from "@timo9378/flow2code/compiler";
+
+const code = fs.readFileSync("route.ts", "utf-8");
+const result = decompile(code);
+
+if (result.success) {
+  console.log(JSON.stringify(result.ir, null, 2));
+  console.log(`Confidence: ${result.confidence}`);
+}
+```
+
+## Project Structure
+
+```
+flow2code/
+├── src/
+│   ├── app/                         # Next.js App Router (UI)
+│   ├── components/                  # Visual canvas components
+│   ├── store/                       # Zustand canvas state management
+│   ├── lib/
+│   │   ├── index.ts                 # Headless Compiler public API
+│   │   ├── ir/
+│   │   │   ├── types.ts             # IR Schema + TypeScript types
+│   │   │   ├── validator.ts         # IR validator
+│   │   │   └── topological-sort.ts  # Topological sort + concurrency detection
+│   │   ├── compiler/
+│   │   │   ├── compiler.ts          # AST compiler core
+│   │   │   ├── decompiler.ts        # TS → FlowIR reverse parser
+│   │   │   ├── expression-parser.ts # Recursive Descent Parser
+│   │   │   ├── type-inference.ts    # Type inference engine
+│   │   │   ├── symbol-table.ts      # Human-readable variable naming
+│   │   │   ├── plugins/             # Plugin system (extensible)
+│   │   │   │   ├── index.ts          # Plugin registry factory + exports
+│   │   │   │   ├── types.ts          # PluginRegistry interface
+│   │   │   │   └── builtin.ts        # 15 built-in plugins
+│   │   │   └── platforms/           # Platform adapters
+│   │   │       ├── types.ts         # PlatformAdapter interface
+│   │   │       ├── nextjs.ts        # Next.js App Router
+│   │   │       ├── express.ts       # Express.js
+│   │   │       └── cloudflare.ts    # Cloudflare Workers
+│   │   ├── diff/                    # Semantic Diff
+│   │   └── storage/                 # .flow.json split/merge
+│   ├── cli/                         # CLI (compile/watch/init)
+│   └── server/                      # Standalone HTTP Server
+├── tests/                           # 354 tests (Vitest)
+├── .github/workflows/ci.yml         # GitHub Actions CI
+├── CONTRIBUTING.md
+└── vitest.config.ts
+```
+
+## Node Types
+
+| Category | Node | Compiled Output |
+|----------|------|-----------------|
+| ⚡ Trigger | HTTP Webhook | `export async function POST(req)` |
+| ⚡ Trigger | Cron Job | Scheduled function |
+| ⚡ Trigger | Manual | Exported async function |
+| 🔧 Action | Fetch API | `await fetch(...)` + try/catch |
+| 🔧 Action | SQL Query | Drizzle / Prisma / Raw SQL |
+| 🔧 Action | Redis Cache | Redis get/set/del |
+| 🔧 Action | Custom Code | Inline TypeScript |
+| 🔧 Action | Call Subflow | `await importedFunction(...)` |
+| 🔀 Logic | If/Else | `if (...) { } else { }` |
+| 🔀 Logic | For Loop | `for (const item of ...)` |
+| 🔀 Logic | Try/Catch | `try { } catch (e) { }` |
+| 🔀 Logic | Promise.all | `await Promise.allSettled([...])` |
+| 📦 Variable | Declare | `const x = ...` |
+| 📦 Variable | Transform | Expression transform |
+| 📤 Output | Return Response | Platform-specific Response |
+
+## Platform Support
+
+| Platform | Trigger Init | Response | CLI Flag |
+|----------|-------------|----------|----------|
+| **Next.js** (default) | `req.nextUrl.searchParams` / `req.json()` | `NextResponse.json()` | `--platform nextjs` |
+| **Express** | `req.query` / `req.body` | `res.status().json()` | `--platform express` |
+| **Cloudflare Workers** | `new URL(request.url)` / `request.json()` | `new Response()` | `--platform cloudflare` |
+
+## Contributing
+
+See [CONTRIBUTING.md](CONTRIBUTING.md).
+
+For detailed usage examples and workflows, see [USAGE.md](USAGE.md).
+
+## License
+
+MIT