← Back to Kontasks

gvDecision & gvFlow Implementation Plan

Implementation plan for adding gvDecision and gvFlow to konui

✓ Completed
on 9 Jan 2026, 2:49 pm

Output

gvDecision & gvFlow Implementation Plan

Overview

Add decision tracking and flow management to konui. This enables tracking architectural decisions, action choices, and deferred questions across Claude sessions.

Phase 1: Type Definitions

konui/src/
├── gv-decision-types.ts    # gvDecision interface + supporting types
├── gv-flow-types.ts        # gvFlow, gvTurn, gvSession interfaces
└── gv-types.ts             # Re-exports for convenience

TypeScript types from schema docs, no business logic

Phase 2: Storage Layer

konui/
├── data/
│   ├── gvdecisions.jsonl   # Append-only decision journal
│   └── gvflows.jsonl       # Flow metadata
└── src/
    ├── gv-decision-store.ts # CRUD + index + query
    └── gv-flow-store.ts     # Flow lifecycle management

JSONL append-only storage with in-memory indexes

Phase 3: API Endpoints

POST   /api/gv/decisions              # Create decision
GET    /api/gv/decisions              # List (filter by flow/turn/category)
GET    /api/gv/decisions/:id          # Get single
PATCH  /api/gv/decisions/:id/review   # Mark reviewed
PATCH  /api/gv/decisions/:id/approve  # Approve

POST   /api/gv/flows                  # Create flow
GET    /api/gv/flows                  # List flows
GET    /api/gv/flows/:id              # Get flow + decisions
PATCH  /api/gv/flows/:id              # Update status

Add routes to router.ts

Phase 4: MCP Tools

konui_create_decision    # Claude records decisions during turns
konui_list_decisions     # Query decisions by flow/category
konui_create_flow        # Start a new flow
konui_update_flow        # Update flow status
konui_get_flow_summary   # Flow + all decisions summary

Extend konsole MCP server

Phase 5: UI Views

konui/src/views/
├── gv-decisions.ts     # Decision list view with filters
├── gv-decision-detail.ts # Single decision with review actions
├── gv-flows.ts         # Flow list view
└── gv-flow-detail.ts   # Flow detail with decision timeline

New nav items: /gv/decisions, /gv/flows

Key Design Decisions

Storage JSONL append-only (matches schema)
Indexing In-memory indexes rebuilt on startup
Immutability Decisions never modified, supersedes creates new
Status Computed from timestamps (not stored)

Estimated Scope

Phase 1 (Types) ~200 lines
Phase 2 (Storage) ~400 lines
Phase 3 (API) ~300 lines
Phase 4 (MCP) ~200 lines
Phase 5 (UI) ~600 lines
Total ~1,700 lines

Recommendation

Start with Phase 1 + 2 (types + storage) to establish the foundation, then add API and UI incrementally. This allows testing the data model before building the full UI.

Quick Actions

Original Request

No layout configured

Details

Type General
Status Completed
Scope vibetools
Tags gvDecisiongvFlowarchitectureplanning
Created 9 Jan 2026, 2:49 pm
Updated 9 Jan 2026, 2:49 pm
Timing
⏱️ 64.8s
0 tools
● TTFE 0% ● Thinking 100% ● Tools 0%
Created By claude

Raw Data

{
  "id": "879890dc-80bb-4fa5-bb3a-a0e21a6bb3d3",
  "type": "general",
  "status": "completed",
  "title": "gvDecision & gvFlow Implementation Plan",
  "description": "Implementation plan for adding gvDecision and gvFlow to konui",
  "context": {
    "output": "<div style=\"background:#1e1e1e;color:#e0e0e0;padding:20px;border-radius:8px;font-family:'Consolas','Monaco',monospace;\">\n<h2 style=\"font-family:sans-serif;color:#fff;margin:0 0 16px 0;\">gvDecision & gvFlow Implementation Plan</h2>\n\n<div style=\"background:#2d2d2d;padding:16px;border-radius:6px;margin-bottom:16px;\">\n<h3 style=\"color:#61afef;margin:0 0 12px 0;font-size:14px;\">Overview</h3>\n<p style=\"margin:0;color:#e0e0e0;line-height:1.6;\">Add decision tracking and flow management to konui. This enables tracking architectural decisions, action choices, and deferred questions across Claude sessions.</p>\n</div>\n\n<div style=\"background:#2d2d2d;padding:16px;border-radius:6px;margin-bottom:16px;\">\n<h3 style=\"color:#98c379;margin:0 0 12px 0;font-size:14px;\">Phase 1: Type Definitions</h3>\n<pre style=\"background:#3d3d3d;padding:12px;border-radius:4px;overflow-x:auto;line-height:1.6;color:#e0e0e0;margin:0;\">\n<span style=\"color:#56b6c2;\">konui/src/</span>\n├── <span style=\"color:#e5c07b;\">gv-decision-types.ts</span>    <span style=\"color:#7f848e;\"># gvDecision interface + supporting types</span>\n├── <span style=\"color:#e5c07b;\">gv-flow-types.ts</span>        <span style=\"color:#7f848e;\"># gvFlow, gvTurn, gvSession interfaces</span>\n└── <span style=\"color:#e5c07b;\">gv-types.ts</span>             <span style=\"color:#7f848e;\"># Re-exports for convenience</span>\n</pre>\n<p style=\"margin:12px 0 0 0;color:#7f848e;font-size:12px;\">TypeScript types from schema docs, no business logic</p>\n</div>\n\n<div style=\"background:#2d2d2d;padding:16px;border-radius:6px;margin-bottom:16px;\">\n<h3 style=\"color:#98c379;margin:0 0 12px 0;font-size:14px;\">Phase 2: Storage Layer</h3>\n<pre style=\"background:#3d3d3d;padding:12px;border-radius:4px;overflow-x:auto;line-height:1.6;color:#e0e0e0;margin:0;\">\n<span style=\"color:#56b6c2;\">konui/</span>\n├── <span style=\"color:#98c379;font-weight:bold;\">data/</span>\n│   ├── <span style=\"color:#e5c07b;\">gvdecisions.jsonl</span>   <span style=\"color:#7f848e;\"># Append-only decision journal</span>\n│   └── <span style=\"color:#e5c07b;\">gvflows.jsonl</span>       <span style=\"color:#7f848e;\"># Flow metadata</span>\n└── <span style=\"color:#56b6c2;\">src/</span>\n    ├── <span style=\"color:#e5c07b;\">gv-decision-store.ts</span> <span style=\"color:#7f848e;\"># CRUD + index + query</span>\n    └── <span style=\"color:#e5c07b;\">gv-flow-store.ts</span>     <span style=\"color:#7f848e;\"># Flow lifecycle management</span>\n</pre>\n<p style=\"margin:12px 0 0 0;color:#7f848e;font-size:12px;\">JSONL append-only storage with in-memory indexes</p>\n</div>\n\n<div style=\"background:#2d2d2d;padding:16px;border-radius:6px;margin-bottom:16px;\">\n<h3 style=\"color:#98c379;margin:0 0 12px 0;font-size:14px;\">Phase 3: API Endpoints</h3>\n<pre style=\"background:#3d3d3d;padding:12px;border-radius:4px;overflow-x:auto;line-height:1.6;color:#e0e0e0;margin:0;\">\n<span style=\"color:#c678dd;\">POST</span>   <span style=\"color:#e5c07b;\">/api/gv/decisions</span>              <span style=\"color:#7f848e;\"># Create decision</span>\n<span style=\"color:#61afef;\">GET</span>    <span style=\"color:#e5c07b;\">/api/gv/decisions</span>              <span style=\"color:#7f848e;\"># List (filter by flow/turn/category)</span>\n<span style=\"color:#61afef;\">GET</span>    <span style=\"color:#e5c07b;\">/api/gv/decisions/:id</span>          <span style=\"color:#7f848e;\"># Get single</span>\n<span style=\"color:#f97316;\">PATCH</span>  <span style=\"color:#e5c07b;\">/api/gv/decisions/:id/review</span>   <span style=\"color:#7f848e;\"># Mark reviewed</span>\n<span style=\"color:#f97316;\">PATCH</span>  <span style=\"color:#e5c07b;\">/api/gv/decisions/:id/approve</span>  <span style=\"color:#7f848e;\"># Approve</span>\n\n<span style=\"color:#c678dd;\">POST</span>   <span style=\"color:#e5c07b;\">/api/gv/flows</span>                  <span style=\"color:#7f848e;\"># Create flow</span>\n<span style=\"color:#61afef;\">GET</span>    <span style=\"color:#e5c07b;\">/api/gv/flows</span>                  <span style=\"color:#7f848e;\"># List flows</span>\n<span style=\"color:#61afef;\">GET</span>    <span style=\"color:#e5c07b;\">/api/gv/flows/:id</span>              <span style=\"color:#7f848e;\"># Get flow + decisions</span>\n<span style=\"color:#f97316;\">PATCH</span>  <span style=\"color:#e5c07b;\">/api/gv/flows/:id</span>              <span style=\"color:#7f848e;\"># Update status</span>\n</pre>\n<p style=\"margin:12px 0 0 0;color:#7f848e;font-size:12px;\">Add routes to router.ts</p>\n</div>\n\n<div style=\"background:#2d2d2d;padding:16px;border-radius:6px;margin-bottom:16px;\">\n<h3 style=\"color:#98c379;margin:0 0 12px 0;font-size:14px;\">Phase 4: MCP Tools</h3>\n<pre style=\"background:#3d3d3d;padding:12px;border-radius:4px;overflow-x:auto;line-height:1.6;color:#e0e0e0;margin:0;\">\n<span style=\"color:#e5c07b;\">konui_create_decision</span>    <span style=\"color:#7f848e;\"># Claude records decisions during turns</span>\n<span style=\"color:#e5c07b;\">konui_list_decisions</span>     <span style=\"color:#7f848e;\"># Query decisions by flow/category</span>\n<span style=\"color:#e5c07b;\">konui_create_flow</span>        <span style=\"color:#7f848e;\"># Start a new flow</span>\n<span style=\"color:#e5c07b;\">konui_update_flow</span>        <span style=\"color:#7f848e;\"># Update flow status</span>\n<span style=\"color:#e5c07b;\">konui_get_flow_summary</span>   <span style=\"color:#7f848e;\"># Flow + all decisions summary</span>\n</pre>\n<p style=\"margin:12px 0 0 0;color:#7f848e;font-size:12px;\">Extend konsole MCP server</p>\n</div>\n\n<div style=\"background:#2d2d2d;padding:16px;border-radius:6px;margin-bottom:16px;\">\n<h3 style=\"color:#98c379;margin:0 0 12px 0;font-size:14px;\">Phase 5: UI Views</h3>\n<pre style=\"background:#3d3d3d;padding:12px;border-radius:4px;overflow-x:auto;line-height:1.6;color:#e0e0e0;margin:0;\">\n<span style=\"color:#56b6c2;\">konui/src/views/</span>\n├── <span style=\"color:#e5c07b;\">gv-decisions.ts</span>     <span style=\"color:#7f848e;\"># Decision list view with filters</span>\n├── <span style=\"color:#e5c07b;\">gv-decision-detail.ts</span> <span style=\"color:#7f848e;\"># Single decision with review actions</span>\n├── <span style=\"color:#e5c07b;\">gv-flows.ts</span>         <span style=\"color:#7f848e;\"># Flow list view</span>\n└── <span style=\"color:#e5c07b;\">gv-flow-detail.ts</span>   <span style=\"color:#7f848e;\"># Flow detail with decision timeline</span>\n</pre>\n<p style=\"margin:12px 0 0 0;color:#7f848e;font-size:12px;\">New nav items: /gv/decisions, /gv/flows</p>\n</div>\n\n<div style=\"background:#2d2d2d;padding:16px;border-radius:6px;margin-bottom:16px;\">\n<h3 style=\"color:#61afef;margin:0 0 12px 0;font-size:14px;\">Key Design Decisions</h3>\n<table style=\"width:100%;border-collapse:collapse;font-size:13px;\">\n<tr style=\"border-bottom:1px solid #444;\">\n<td style=\"padding:8px 0;color:#98c379;\">Storage</td>\n<td style=\"padding:8px 0;\">JSONL append-only (matches schema)</td>\n</tr>\n<tr style=\"border-bottom:1px solid #444;\">\n<td style=\"padding:8px 0;color:#98c379;\">Indexing</td>\n<td style=\"padding:8px 0;\">In-memory indexes rebuilt on startup</td>\n</tr>\n<tr style=\"border-bottom:1px solid #444;\">\n<td style=\"padding:8px 0;color:#98c379;\">Immutability</td>\n<td style=\"padding:8px 0;\">Decisions never modified, supersedes creates new</td>\n</tr>\n<tr>\n<td style=\"padding:8px 0;color:#98c379;\">Status</td>\n<td style=\"padding:8px 0;\">Computed from timestamps (not stored)</td>\n</tr>\n</table>\n</div>\n\n<div style=\"background:#2d2d2d;padding:16px;border-radius:6px;margin-bottom:16px;\">\n<h3 style=\"color:#e5c07b;margin:0 0 12px 0;font-size:14px;\">Estimated Scope</h3>\n<table style=\"width:100%;border-collapse:collapse;font-size:13px;\">\n<tr style=\"border-bottom:1px solid #444;\">\n<td style=\"padding:8px 0;\">Phase 1 (Types)</td>\n<td style=\"padding:8px 0;text-align:right;\">~200 lines</td>\n</tr>\n<tr style=\"border-bottom:1px solid #444;\">\n<td style=\"padding:8px 0;\">Phase 2 (Storage)</td>\n<td style=\"padding:8px 0;text-align:right;\">~400 lines</td>\n</tr>\n<tr style=\"border-bottom:1px solid #444;\">\n<td style=\"padding:8px 0;\">Phase 3 (API)</td>\n<td style=\"padding:8px 0;text-align:right;\">~300 lines</td>\n</tr>\n<tr style=\"border-bottom:1px solid #444;\">\n<td style=\"padding:8px 0;\">Phase 4 (MCP)</td>\n<td style=\"padding:8px 0;text-align:right;\">~200 lines</td>\n</tr>\n<tr style=\"border-bottom:1px solid #444;\">\n<td style=\"padding:8px 0;\">Phase 5 (UI)</td>\n<td style=\"padding:8px 0;text-align:right;\">~600 lines</td>\n</tr>\n<tr style=\"font-weight:bold;\">\n<td style=\"padding:8px 0;\">Total</td>\n<td style=\"padding:8px 0;text-align:right;\">~1,700 lines</td>\n</tr>\n</table>\n</div>\n\n<div style=\"background:#1a3a1a;border:1px solid #2d5a2d;padding:16px;border-radius:6px;\">\n<h3 style=\"color:#98c379;margin:0 0 8px 0;font-size:14px;\">Recommendation</h3>\n<p style=\"margin:0;color:#e0e0e0;line-height:1.6;\">Start with <strong>Phase 1 + 2</strong> (types + storage) to establish the foundation, then add API and UI incrementally. This allows testing the data model before building the full UI.</p>\n</div>\n\n</div>",
    "requestedAt": "2026-01-09T12:02:00.000Z",
    "requestId": "54eadce6-8164-48a1-bb68-668fca9d1ce1",
    "choices": [
      {
        "label": "Start Phase 1",
        "value": "Start implementing Phase 1: Create gv-decision-types.ts and gv-flow-types.ts with all TypeScript interfaces from the schema docs",
        "primary": true
      },
      {
        "label": "All phases at once",
        "value": "Implement all 5 phases in sequence - types, storage, API, MCP tools, and UI views"
      },
      {
        "label": "Just types + storage",
        "value": "Implement Phase 1 and Phase 2 only - types and storage layer, then review before continuing"
      }
    ],
    "turnTiming": {
      "totalMs": 64791,
      "ttfeMs": 55,
      "thinkingMs": 64736,
      "toolExecutionMs": 0,
      "toolCallCount": 0,
      "thinkingPct": 100,
      "toolsPct": 0,
      "ttfePct": 0
    }
  },
  "createdBy": "claude",
  "createdAt": "2026-01-09T04:49:20.831Z",
  "updatedAt": "2026-01-09T04:49:26.274Z",
  "requestId": "54eadce6-8164-48a1-bb68-668fca9d1ce1",
  "scope": "vibetools",
  "tags": [
    "gvDecision",
    "gvFlow",
    "architecture",
    "planning"
  ],
  "targetUser": "claude"
}
DashboardReportsKontasksFlowsDecisionsSessionsTelemetryLogs + Go