KI-Konzil/_bmad-output/implementation-artifacts/stories/3-3-blueprint-parser-react-flow-json.md

Story 3.3: Blueprint-Parser (React Flow → JSON)

Status: done

Story

Als System, möchte ich eine parseGraphToBlueprint()-Funktion, so dass sie den Canvas-State in ein valides Blueprint-JSON konvertiert.

Acceptance Criteria

1. Nodes + Edges → CouncilBlueprint mit version, name, nodes[], edges[]
2. Bedingte Edge → type: "conditional" und condition: "<label>" im Edge-JSON
3. Lineare Edge → type: "linear" ohne condition-Feld
4. version: 1 als Startwert
5. Tests: Alle drei Fälle (linear, conditional, gemischt)

Tasks / Subtasks

• Task 1: utils/blueprint-parser.ts implementieren (AC: 1–4)
  • Subtask 1.1: Nodes-Mapping: id, label, systemPrompt, model, tools, position
  • Subtask 1.2: Edges-Mapping: id, source, target, type, optional condition
  • Subtask 1.3: Rückgabe: CouncilBlueprint mit version: 1
• Task 2: types/council.ts — CouncilBlueprint, BlueprintNode, BlueprintEdge (AC: 1)
• Task 3: Vitest-Tests (AC: 1–5)
  • Subtask 3.1: Test lineares Blueprint
  • Subtask 3.2: Test bedingte Edge
  • Subtask 3.3: Test leeres Canvas (0 Nodes/Edges)

Dev Notes

• existingId?: string Parameter für Updates (PUT vs POST)
• Tool-Mapping: webSearch, pdfReader (camelCase im Frontend, snake_case im Backend)
• EdgeType = "linear" | "conditional" als Union-Typ

Project Structure Notes

• frontend/app/utils/blueprint-parser.ts
• frontend/app/types/council.ts
• frontend/app/__tests__/blueprint-parser.test.ts

References

• [Source: _bmad-output/planning-artifacts/architecture.md#Blueprint-JSON-Schema]

Dev Agent Record

Agent Model Used

Amelia (💻 BMAD Dev Agent)

Completion Notes List

• position-Feld wird mitgespeichert, damit Blueprint-Reload die Node-Positionen wiederherstellt.
• existingId ermöglicht PUT-Updates ohne neue ID-Generierung.

File List

• frontend/app/utils/blueprint-parser.ts
• frontend/app/types/council.ts
• frontend/app/__tests__/blueprint-parser.test.ts
• frontend/app/__tests__/types.test.ts