Timeline MCP Tools Assessment

Details

Raw Data

{
  "id": "dcc2af51-0e3b-4db7-9eac-075c324f7896",
  "type": "general",
  "status": "completed",
  "title": "Timeline MCP Tools Assessment",
  "description": "Analysis of existing MCP tools for timeline search and session orientation",
  "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;\">Timeline MCP Tools Assessment</h2>\n\n<h3 style=\"color:#98c379;margin:16px 0 8px 0;\">1. Timeline Search Tool</h3>\n<table style=\"width:100%;border-collapse:collapse;margin:12px 0;\">\n<tr style=\"background:#2d2d2d;\">\n  <th style=\"text-align:left;padding:8px;color:#56b6c2;border-bottom:1px solid #3d3d3d;\">Tool</th>\n  <th style=\"text-align:left;padding:8px;color:#56b6c2;border-bottom:1px solid #3d3d3d;\">Status</th>\n  <th style=\"text-align:left;padding:8px;color:#56b6c2;border-bottom:1px solid #3d3d3d;\">Notes</th>\n</tr>\n<tr>\n  <td style=\"padding:8px;border-bottom:1px solid #3d3d3d;\"><code style=\"color:#e5c07b;\">konui_search_turn</code></td>\n  <td style=\"padding:8px;border-bottom:1px solid #3d3d3d;\"><span style=\"background:#f97316;color:#fff;padding:2px 8px;border-radius:4px;font-size:12px;\">Partial</span></td>\n  <td style=\"padding:8px;border-bottom:1px solid #3d3d3d;\">Searches within a <strong>single turn</strong> only. Requires requestId.</td>\n</tr>\n<tr>\n  <td style=\"padding:8px;border-bottom:1px solid #3d3d3d;\"><code style=\"color:#e5c07b;\">konui_get_turn_history</code></td>\n  <td style=\"padding:8px;border-bottom:1px solid #3d3d3d;\"><span style=\"background:#f97316;color:#fff;padding:2px 8px;border-radius:4px;font-size:12px;\">Partial</span></td>\n  <td style=\"padding:8px;border-bottom:1px solid #3d3d3d;\">Lists recent turns with timing/tokens, but no search capability.</td>\n</tr>\n<tr>\n  <td style=\"padding:8px;border-bottom:1px solid #3d3d3d;\"><code style=\"color:#e5c07b;\">konui_list_system_events</code></td>\n  <td style=\"padding:8px;border-bottom:1px solid #3d3d3d;\"><span style=\"background:#22c55e;color:#fff;padding:2px 8px;border-radius:4px;font-size:12px;\">Exists</span></td>\n  <td style=\"padding:8px;border-bottom:1px solid #3d3d3d;\">Lists service restarts, account switches, alerts.</td>\n</tr>\n</table>\n\n<div style=\"background:#2d2d2d;padding:12px;border-radius:6px;border-left:3px solid #f97316;margin:12px 0;\">\n<strong style=\"color:#f97316;\">❌ Gap:</strong> No tool to search across ALL kontasks/turns by keyword.\n<p style=\"color:#7f848e;margin:8px 0 0 0;\">e.g., \"find all kontasks mentioning 'authentication'\" is not possible.</p>\n</div>\n\n<h3 style=\"color:#98c379;margin:20px 0 8px 0;\">2. Recent Activity for Session Orientation</h3>\n<table style=\"width:100%;border-collapse:collapse;margin:12px 0;\">\n<tr style=\"background:#2d2d2d;\">\n  <th style=\"text-align:left;padding:8px;color:#56b6c2;border-bottom:1px solid #3d3d3d;\">Tool</th>\n  <th style=\"text-align:left;padding:8px;color:#56b6c2;border-bottom:1px solid #3d3d3d;\">Status</th>\n  <th style=\"text-align:left;padding:8px;color:#56b6c2;border-bottom:1px solid #3d3d3d;\">Notes</th>\n</tr>\n<tr>\n  <td style=\"padding:8px;border-bottom:1px solid #3d3d3d;\"><code style=\"color:#e5c07b;\">konui_get_recent_kontasks</code></td>\n  <td style=\"padding:8px;border-bottom:1px solid #3d3d3d;\"><span style=\"background:#22c55e;color:#fff;padding:2px 8px;border-radius:4px;font-size:12px;\">Exists</span></td>\n  <td style=\"padding:8px;border-bottom:1px solid #3d3d3d;\">Returns 1-5 kontasks with summaries. <strong>Max 5.</strong></td>\n</tr>\n<tr>\n  <td style=\"padding:8px;border-bottom:1px solid #3d3d3d;\"><code style=\"color:#e5c07b;\">konui_get_turn_context</code></td>\n  <td style=\"padding:8px;border-bottom:1px solid #3d3d3d;\"><span style=\"background:#22c55e;color:#fff;padding:2px 8px;border-radius:4px;font-size:12px;\">Exists</span></td>\n  <td style=\"padding:8px;border-bottom:1px solid #3d3d3d;\">Full context: kontasks, flows, backlog, approved tasks.</td>\n</tr>\n</table>\n\n<div style=\"background:#2d2d2d;padding:12px;border-radius:6px;border-left:3px solid #f97316;margin:12px 0;\">\n<strong style=\"color:#f97316;\">❌ Gap:</strong> <code>konui_get_recent_kontasks</code> maxes out at 5 items.\n<p style=\"color:#7f848e;margin:8px 0 0 0;\">You asked for 10 activities - would need to increase the limit.</p>\n</div>\n\n<h3 style=\"color:#98c379;margin:20px 0 8px 0;\">Recommendations</h3>\n<ol style=\"color:#e0e0e0;margin:0;padding-left:20px;line-height:1.8;\">\n  <li><strong>Increase <code>konui_get_recent_kontasks</code> limit</strong> from 5 → 10 (or 15)</li>\n  <li><strong>Add a new tool: <code>konui_search_kontasks</code></strong>\n    <ul style=\"margin:4px 0;\">\n      <li>Search across all kontasks by keyword, date range, scope, tags</li>\n      <li>Would solve the \"find all work about X\" problem</li>\n    </ul>\n  </li>\n  <li><strong>Format for session orientation:</strong> Consider a dedicated <code>konui_get_session_briefing</code> that returns:\n    <ul style=\"margin:4px 0;\">\n      <li>Last 10 kontasks with 1-line summaries</li>\n      <li>Active flows</li>\n      <li>Any pending/approved tasks</li>\n      <li>Git status summary</li>\n    </ul>\n  </li>\n</ol>\n\n<h3 style=\"color:#98c379;margin:20px 0 8px 0;\">Current Workaround for Orientation</h3>\n<pre style=\"background:#2d2d2d;padding:12px;border-radius:6px;color:#98c379;font-size:12px;\">\n// In the newSessionPrompt, could add:\nkonui_get_recent_kontasks({ count: 5 })  // Max available today\nkonui_get_turn_context()                  // Gets flows + approved tasks\n</pre>\n\n<p style=\"color:#7f848e;margin-top:16px;font-size:13px;\">The existing tools cover 80% of the need. A small enhancement to increase the limit and add cross-kontask search would complete the picture.</p>\n</div>",
    "requestedAt": "2026-01-12T00:00:00.000Z",
    "requestId": "51c14d0d-38b8-463a-abb0-db2f5160c71f",
    "choices": [
      {
        "label": "Increase limit to 10",
        "value": "Update konui_get_recent_kontasks to allow count up to 10 instead of 5",
        "primary": true
      },
      {
        "label": "Add search tool",
        "value": "Create a new konui_search_kontasks MCP tool that can search across all kontasks by keyword, date range, scope, and tags"
      },
      {
        "label": "Create briefing tool",
        "value": "Create a dedicated konui_get_session_briefing tool that returns everything a new session needs in one call"
      }
    ],
    "turnTiming": {
      "totalMs": 78289,
      "ttfeMs": 58,
      "thinkingMs": 78231,
      "toolExecutionMs": 0,
      "toolCallCount": 0,
      "thinkingPct": 100,
      "toolsPct": 0,
      "ttfePct": 0
    }
  },
  "createdBy": "claude",
  "createdAt": "2026-01-11T18:05:02.946Z",
  "updatedAt": "2026-01-11T18:05:10.503Z",
  "requestId": "51c14d0d-38b8-463a-abb0-db2f5160c71f",
  "scope": "greatvibe",
  "tags": [
    "mcp",
    "timeline",
    "session-orientation"
  ],
  "sessionId": "ses_286e2e28-97c"
}