← Back to Kontasks

Investigation Mode Implementation Plan

Quick implementation plan for append-only findings on existing kontasks

✓ Completed
on 7 Jan 2026, 8:06 pm

Output

🔍 Investigation Mode - Implementation Plan

Add append-only findings to existing kontasks

✅ Good News: Foundation Exists!

There's already a type: "progress" kontask with append-only ProgressContext (todos, workingHistory, sequence numbers). We can extend this pattern.

Phase 1: Type & Schema (30 min)

○Add "investigation" to KontaskType in kontask-types.ts
○Create InvestigationContext interface:
interface InvestigationFinding {
  id: string;            // Unique finding ID
  timestamp: string;     // When found
  type: "hypothesis" | "evidence" | "conclusion" | "question";
  title: string;         // Short summary
  content: string;       // Full finding (HTML or markdown)
  confidence?: number;   // 0-100 confidence level
  sources?: string[];    // File paths, URLs, etc.
}

interface InvestigationContext {
  parentKontaskId: string;  // Link to original kontask
  hypothesis?: string;       // Initial hypothesis
  findings: InvestigationFinding[];
  status: "investigating" | "concluded" | "blocked";
  conclusion?: string;
}

Phase 2: MCP Tool (45 min)

○Add konui_add_finding MCP tool:
konui_add_finding({
  kontaskId: string,     // Target kontask (or create new investigation)
  finding: {
    type: "hypothesis" | "evidence" | "conclusion" | "question",
    title: string,
    content: string,
    confidence?: number,
    sources?: string[]
  }
})
○Add to router.ts with append-only logic (never overwrites)
○Add konui_conclude_investigation to mark complete

Phase 3: UI Rendering (45 min)

○Add renderInvestigation() in kontask-templates.ts
○Timeline view of findings (like git log)
○Color-coded by type: 💡hypothesis 📊 evidence ✅conclusion ❓question
○Confidence bars for each finding
○Collapsible source links

Phase 4: Integration (30 min)

○Add to kontask-detail.ts view with investigation renderer
○Add "🔍 Investigate" button on completed kontasks
○Link findings back to parent kontask
○Badge on kontask list: "3 findings"

🎯 Example Workflow

  1. User reports: "Quick Turn not working" → Claude creates kontask
  2. Claude starts investigating: konui_add_finding({type:"hypothesis", title:"SSE connection issue"})
  3. Reads logs: konui_add_finding({type:"evidence", title:"Found 3 timeout errors", sources:["kongate.log:142"]})
  4. Tests fix: konui_add_finding({type:"evidence", title:"Timeout reduced errors", confidence:80})
  5. Concludes: konui_conclude_investigation({conclusion:"Root cause was 5s timeout, fixed by increasing to 30s"})

⏱️ Estimated Total: ~2.5 hours

Phase 1Types & Schema30 min
Phase 2MCP Tool45 min
Phase 3UI Rendering45 min
Phase 4Integration30 min

Quick Actions

Original Request

No layout configured

Details

Type General
Status Completed
Scope vibetools
Tags kontasksinvestigationimplementation
Created 7 Jan 2026, 8:06 pm
Updated 7 Jan 2026, 8:06 pm
Timing
⏱️ 63.9s
0 tools
● TTFE 0% ● Thinking 100% ● Tools 0%
Created By claude

Raw Data

{
  "id": "adf54318-bf74-4620-b0b1-61b38973ac98",
  "type": "general",
  "status": "completed",
  "title": "Investigation Mode Implementation Plan",
  "description": "Quick implementation plan for append-only findings on existing kontasks",
  "context": {
    "output": "<div style=\"background:#1e1e1e;color:#e0e0e0;padding:20px;border-radius:8px;font-family:system-ui,sans-serif;\">\n\n<h2 style=\"color:#fff;margin:0 0 8px 0;\">🔍 Investigation Mode - Implementation Plan</h2>\n<p style=\"color:#7f848e;margin:0 0 20px 0;\">Add append-only findings to existing kontasks</p>\n\n<div style=\"background:#2d4a2d;border:1px solid #22c55e;padding:16px;border-radius:8px;margin-bottom:20px;\">\n<h3 style=\"color:#22c55e;margin:0 0 8px 0;\">✅ Good News: Foundation Exists!</h3>\n<p style=\"color:#e0e0e0;margin:0;\">There's already a <code style=\"background:#1e1e1e;padding:2px 6px;border-radius:4px;\">type: \"progress\"</code> kontask with append-only <code style=\"background:#1e1e1e;padding:2px 6px;border-radius:4px;\">ProgressContext</code> (todos, workingHistory, sequence numbers). We can extend this pattern.</p>\n</div>\n\n<div style=\"background:#2d2d2d;padding:16px;border-radius:8px;margin-bottom:16px;\">\n<h3 style=\"color:#c99542;margin:0 0 12px 0;\">Phase 1: Type & Schema (30 min)</h3>\n<table style=\"width:100%;font-size:0.9rem;\">\n<tr><td style=\"color:#7f848e;width:30px;vertical-align:top;\">○</td><td style=\"color:#e0e0e0;\">Add <code>\"investigation\"</code> to <code>KontaskType</code> in kontask-types.ts</td></tr>\n<tr><td style=\"color:#7f848e;\">○</td><td style=\"color:#e0e0e0;\">Create <code>InvestigationContext</code> interface:</td></tr>\n</table>\n<pre style=\"background:#1e1e1e;padding:12px;border-radius:6px;margin:8px 0;font-size:0.85rem;color:#98c379;overflow-x:auto;\">\ninterface InvestigationFinding {\n  id: string;            // Unique finding ID\n  timestamp: string;     // When found\n  type: \"hypothesis\" | \"evidence\" | \"conclusion\" | \"question\";\n  title: string;         // Short summary\n  content: string;       // Full finding (HTML or markdown)\n  confidence?: number;   // 0-100 confidence level\n  sources?: string[];    // File paths, URLs, etc.\n}\n\ninterface InvestigationContext {\n  parentKontaskId: string;  // Link to original kontask\n  hypothesis?: string;       // Initial hypothesis\n  findings: InvestigationFinding[];\n  status: \"investigating\" | \"concluded\" | \"blocked\";\n  conclusion?: string;\n}\n</pre>\n</div>\n\n<div style=\"background:#2d2d2d;padding:16px;border-radius:8px;margin-bottom:16px;\">\n<h3 style=\"color:#61afef;margin:0 0 12px 0;\">Phase 2: MCP Tool (45 min)</h3>\n<table style=\"width:100%;font-size:0.9rem;\">\n<tr><td style=\"color:#7f848e;width:30px;vertical-align:top;\">○</td><td style=\"color:#e0e0e0;\">Add <code>konui_add_finding</code> MCP tool:</td></tr>\n</table>\n<pre style=\"background:#1e1e1e;padding:12px;border-radius:6px;margin:8px 0;font-size:0.85rem;color:#98c379;overflow-x:auto;\">\nkonui_add_finding({\n  kontaskId: string,     // Target kontask (or create new investigation)\n  finding: {\n    type: \"hypothesis\" | \"evidence\" | \"conclusion\" | \"question\",\n    title: string,\n    content: string,\n    confidence?: number,\n    sources?: string[]\n  }\n})\n</pre>\n<table style=\"width:100%;font-size:0.9rem;\">\n<tr><td style=\"color:#7f848e;width:30px;vertical-align:top;\">○</td><td style=\"color:#e0e0e0;\">Add to router.ts with append-only logic (never overwrites)</td></tr>\n<tr><td style=\"color:#7f848e;\">○</td><td style=\"color:#e0e0e0;\">Add <code>konui_conclude_investigation</code> to mark complete</td></tr>\n</table>\n</div>\n\n<div style=\"background:#2d2d2d;padding:16px;border-radius:8px;margin-bottom:16px;\">\n<h3 style=\"color:#c678dd;margin:0 0 12px 0;\">Phase 3: UI Rendering (45 min)</h3>\n<table style=\"width:100%;font-size:0.9rem;\">\n<tr><td style=\"color:#7f848e;width:30px;vertical-align:top;\">○</td><td style=\"color:#e0e0e0;\">Add <code>renderInvestigation()</code> in kontask-templates.ts</td></tr>\n<tr><td style=\"color:#7f848e;\">○</td><td style=\"color:#e0e0e0;\">Timeline view of findings (like git log)</td></tr>\n<tr><td style=\"color:#7f848e;\">○</td><td style=\"color:#e0e0e0;\">Color-coded by type: 💡hypothesis 📊 evidence ✅conclusion ❓question</td></tr>\n<tr><td style=\"color:#7f848e;\">○</td><td style=\"color:#e0e0e0;\">Confidence bars for each finding</td></tr>\n<tr><td style=\"color:#7f848e;\">○</td><td style=\"color:#e0e0e0;\">Collapsible source links</td></tr>\n</table>\n</div>\n\n<div style=\"background:#2d2d2d;padding:16px;border-radius:8px;margin-bottom:16px;\">\n<h3 style=\"color:#e5c07b;margin:0 0 12px 0;\">Phase 4: Integration (30 min)</h3>\n<table style=\"width:100%;font-size:0.9rem;\">\n<tr><td style=\"color:#7f848e;width:30px;vertical-align:top;\">○</td><td style=\"color:#e0e0e0;\">Add to kontask-detail.ts view with investigation renderer</td></tr>\n<tr><td style=\"color:#7f848e;\">○</td><td style=\"color:#e0e0e0;\">Add \"🔍 Investigate\" button on completed kontasks</td></tr>\n<tr><td style=\"color:#7f848e;\">○</td><td style=\"color:#e0e0e0;\">Link findings back to parent kontask</td></tr>\n<tr><td style=\"color:#7f848e;\">○</td><td style=\"color:#e0e0e0;\">Badge on kontask list: \"3 findings\"</td></tr>\n</table>\n</div>\n\n<div style=\"background:linear-gradient(135deg,#2d3a4a,#1e2d3d);border:1px solid #61afef;padding:16px;border-radius:8px;margin-bottom:20px;\">\n<h3 style=\"color:#61afef;margin:0 0 12px 0;\">🎯 Example Workflow</h3>\n<ol style=\"margin:0;padding-left:20px;color:#e0e0e0;line-height:1.8;\">\n<li>User reports: \"Quick Turn not working\" → Claude creates kontask</li>\n<li>Claude starts investigating: <code>konui_add_finding({type:\"hypothesis\", title:\"SSE connection issue\"})</code></li>\n<li>Reads logs: <code>konui_add_finding({type:\"evidence\", title:\"Found 3 timeout errors\", sources:[\"kongate.log:142\"]})</code></li>\n<li>Tests fix: <code>konui_add_finding({type:\"evidence\", title:\"Timeout reduced errors\", confidence:80})</code></li>\n<li>Concludes: <code>konui_conclude_investigation({conclusion:\"Root cause was 5s timeout, fixed by increasing to 30s\"})</code></li>\n</ol>\n</div>\n\n<div style=\"background:#2d2d2d;padding:16px;border-radius:8px;\">\n<h3 style=\"color:#fff;margin:0 0 12px 0;\">⏱️ Estimated Total: ~2.5 hours</h3>\n<table style=\"width:100%;font-size:0.9rem;\">\n<tr><td style=\"color:#c99542;\">Phase 1</td><td style=\"color:#e0e0e0;\">Types & Schema</td><td style=\"color:#7f848e;text-align:right;\">30 min</td></tr>\n<tr><td style=\"color:#61afef;\">Phase 2</td><td style=\"color:#e0e0e0;\">MCP Tool</td><td style=\"color:#7f848e;text-align:right;\">45 min</td></tr>\n<tr><td style=\"color:#c678dd;\">Phase 3</td><td style=\"color:#e0e0e0;\">UI Rendering</td><td style=\"color:#7f848e;text-align:right;\">45 min</td></tr>\n<tr><td style=\"color:#e5c07b;\">Phase 4</td><td style=\"color:#e0e0e0;\">Integration</td><td style=\"color:#7f848e;text-align:right;\">30 min</td></tr>\n</table>\n</div>\n\n</div>",
    "requestedAt": "2026-01-07T00:03:00Z",
    "requestId": "6f787c31-6433-4edf-b35b-e76d3eb0a1bc",
    "choices": [
      {
        "label": "Start Phase 1",
        "value": "Start implementing Investigation Mode Phase 1: Add the investigation type and InvestigationContext interface to kontask-types.ts",
        "primary": true
      },
      {
        "label": "See UI mockup first",
        "value": "Before coding, show me a visual mockup of what the investigation findings timeline would look like in the kontask detail view"
      },
      {
        "label": "Simplify scope",
        "value": "This seems like a lot - can we do a minimal version that just adds a 'notes' array to existing kontasks instead of a full investigation type?"
      }
    ],
    "turnTiming": {
      "totalMs": 63882,
      "ttfeMs": 49,
      "thinkingMs": 63833,
      "toolExecutionMs": 0,
      "toolCallCount": 0,
      "thinkingPct": 100,
      "toolsPct": 0,
      "ttfePct": 0
    }
  },
  "createdBy": "claude",
  "createdAt": "2026-01-07T10:06:40.976Z",
  "updatedAt": "2026-01-07T10:06:48.558Z",
  "requestId": "6f787c31-6433-4edf-b35b-e76d3eb0a1bc",
  "scope": "vibetools",
  "tags": [
    "kontasks",
    "investigation",
    "implementation"
  ],
  "targetUser": "claude"
}
DashboardReportsKontasksFlowsDecisionsSessionsTelemetryLogs + Go