← Back to Kontasks
Schema Documentation Update for Thread Detection
Updated all flow, graph, and related schema documentation for the new thread detection design
Output
š Schema Documentation Updated
All flow, graph, and related documentation has been updated to reflect the new thread detection design.
Files Updated
gv/docs/ āāā gvGraphSchema.md v1.4 - Thread detection docs ā āāā Weighted signal algorithm (40/30/15/15%) ā āāā Auto-link threshold (70/100) ā āāā ThreadChain & ThreadSummary types ā āāā REST API endpoints documentation ā āāā gvKontaskSchema.md v1.1 - Thread fields ā āāā continuesFrom?: string ā āāā continuesTo?: string[] ā āāā isPartOfThread?: boolean ā /konnectvol/ āāā CLAUDE.md Edge count 18ā21 āāā MUST-READ-FIRST.md v2.2 - Thread section added ā gv/ āāā VIBE.md v3.3 - Thread detection complete
Thread Detection Summary
| Signal | Weight | Description |
|---|---|---|
| Keywords | 40% | "still broken", "try again", "regression" |
| Same Files | 30% | Overlapping filesChanged arrays |
| Bug Tags | 15% | Both kontasks have bug-related tags |
| Temporal | 15% | < 30 min apart, closer = higher |
Thread API Endpoints
GET /api/gv/threads/kontask/{id} Get full thread chain GET /api/gv/threads/roots All thread roots GET /api/gv/threads/detect/{id} Auto-detect continuation POST /api/gv/threads/link Create continues edge
Edge Type Count
Updated edge type count: 21 types (was 18)
- 10 kontask-flow edges (genesis, evidence, decision, output, spawned, reference, contains, produces, triggers, continues)
- 4 temporal edges (within_5h, within_7d, exhausted_by, spans)
- 3 topic edges (belongs_to, touches, cross_topic)
- 3 domain edges (belongs_to_domain, touches_domain, cross_domain)
ā Commit:
15989c49
All documentation has been committed and is ready.
Quick Actions
Original Request
No layout configured
Details
Type
General
Status
Completed
Scope
greatvibe
Tags
documentationschemathreads
Created
11 Jan 2026, 10:00 am
Updated
11 Jan 2026, 10:01 am
Timing
ā±ļø 260.8s
0 tools
ā TTFE 0%
ā Thinking 100%
ā Tools 0%
Created By
claude
š Claude's Context
Session
ses_40728090...
š Git Commit
15989c49
š 5 files changed
gv/docs/gvGraphSchema.mdgv/docs/gvKontaskSchema.mdgv/VIBE.mdCLAUDE.mdMUST-READ-FIRST.md
Raw Data
{
"id": "ee2ed457-cb4f-4244-ad70-db9ec7fc5586",
"type": "general",
"status": "completed",
"title": "Schema Documentation Update for Thread Detection",
"description": "Updated all flow, graph, and related schema documentation for the new thread detection design",
"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;\">š Schema Documentation Updated</h2>\n\n<p style=\"color:#98c379;font-size:16px;margin-bottom:16px;\">All flow, graph, and related documentation has been updated to reflect the new thread detection design.</p>\n\n<h3 style=\"font-family:sans-serif;color:#61afef;margin:16px 0 8px 0;\">Files Updated</h3>\n<pre style=\"background:#2d2d2d;padding:16px;border-radius:6px;overflow-x:auto;line-height:1.8;color:#e0e0e0;\">\n<span style=\"color:#98c379;font-weight:bold;\">gv/docs/</span>\nāāā <span style=\"color:#e5c07b;\">gvGraphSchema.md</span> <span style=\"color:#7f848e;\">v1.4 - Thread detection docs</span>\nā āāā Weighted signal algorithm (40/30/15/15%)\nā āāā Auto-link threshold (70/100)\nā āāā ThreadChain & ThreadSummary types\nā āāā REST API endpoints documentation\nā\nāāā <span style=\"color:#e5c07b;\">gvKontaskSchema.md</span> <span style=\"color:#7f848e;\">v1.1 - Thread fields</span>\nā āāā continuesFrom?: string\nā āāā continuesTo?: string[]\nā āāā isPartOfThread?: boolean\nā\n<span style=\"color:#56b6c2;font-weight:bold;\">/konnectvol/</span>\nāāā <span style=\"color:#e5c07b;\">CLAUDE.md</span> <span style=\"color:#7f848e;\">Edge count 18ā21</span>\nāāā <span style=\"color:#e5c07b;\">MUST-READ-FIRST.md</span> <span style=\"color:#7f848e;\">v2.2 - Thread section added</span>\nā\n<span style=\"color:#98c379;font-weight:bold;\">gv/</span>\nāāā <span style=\"color:#e5c07b;\">VIBE.md</span> <span style=\"color:#7f848e;\">v3.3 - Thread detection complete</span>\n</pre>\n\n<h3 style=\"font-family:sans-serif;color:#61afef;margin:16px 0 8px 0;\">Thread Detection Summary</h3>\n<div style=\"background:#2d2d2d;padding:16px;border-radius:6px;margin-bottom:16px;\">\n<table style=\"width:100%;border-collapse:collapse;color:#e0e0e0;\">\n<tr style=\"border-bottom:1px solid #444;\">\n<th style=\"text-align:left;padding:8px;color:#c678dd;\">Signal</th>\n<th style=\"text-align:center;padding:8px;color:#c678dd;\">Weight</th>\n<th style=\"text-align:left;padding:8px;color:#c678dd;\">Description</th>\n</tr>\n<tr><td style=\"padding:8px;\">Keywords</td><td style=\"text-align:center;padding:8px;\">40%</td><td style=\"padding:8px;color:#7f848e;\">\"still broken\", \"try again\", \"regression\"</td></tr>\n<tr><td style=\"padding:8px;\">Same Files</td><td style=\"text-align:center;padding:8px;\">30%</td><td style=\"padding:8px;color:#7f848e;\">Overlapping filesChanged arrays</td></tr>\n<tr><td style=\"padding:8px;\">Bug Tags</td><td style=\"text-align:center;padding:8px;\">15%</td><td style=\"padding:8px;color:#7f848e;\">Both kontasks have bug-related tags</td></tr>\n<tr><td style=\"padding:8px;\">Temporal</td><td style=\"text-align:center;padding:8px;\">15%</td><td style=\"padding:8px;color:#7f848e;\">< 30 min apart, closer = higher</td></tr>\n</table>\n</div>\n\n<h3 style=\"font-family:sans-serif;color:#61afef;margin:16px 0 8px 0;\">Thread API Endpoints</h3>\n<pre style=\"background:#2d2d2d;padding:16px;border-radius:6px;overflow-x:auto;line-height:1.6;\">\n<span style=\"color:#c678dd;\">GET</span> <span style=\"color:#98c379;\">/api/gv/threads/kontask/{id}</span> <span style=\"color:#7f848e;\">Get full thread chain</span>\n<span style=\"color:#c678dd;\">GET</span> <span style=\"color:#98c379;\">/api/gv/threads/roots</span> <span style=\"color:#7f848e;\">All thread roots</span>\n<span style=\"color:#c678dd;\">GET</span> <span style=\"color:#98c379;\">/api/gv/threads/detect/{id}</span> <span style=\"color:#7f848e;\">Auto-detect continuation</span>\n<span style=\"color:#c678dd;\">POST</span> <span style=\"color:#98c379;\">/api/gv/threads/link</span> <span style=\"color:#7f848e;\">Create continues edge</span>\n</pre>\n\n<h3 style=\"font-family:sans-serif;color:#61afef;margin:16px 0 8px 0;\">Edge Type Count</h3>\n<p style=\"color:#e0e0e0;\">Updated edge type count: <span style=\"color:#e5c07b;font-weight:bold;\">21 types</span> (was 18)</p>\n<ul style=\"color:#7f848e;margin-left:20px;\">\n<li>10 kontask-flow edges (genesis, evidence, decision, output, spawned, reference, contains, produces, triggers, <span style=\"color:#98c379;\">continues</span>)</li>\n<li>4 temporal edges (within_5h, within_7d, exhausted_by, spans)</li>\n<li>3 topic edges (belongs_to, touches, cross_topic)</li>\n<li>3 domain edges (belongs_to_domain, touches_domain, cross_domain)</li>\n</ul>\n\n<div style=\"background:#22c55e22;border:1px solid #22c55e;border-radius:6px;padding:12px;margin-top:16px;\">\n<span style=\"color:#22c55e;font-weight:bold;\">ā Commit:</span> <code style=\"color:#e5c07b;\">15989c49</code>\n<p style=\"color:#98c379;margin:8px 0 0 0;\">All documentation has been committed and is ready.</p>\n</div>\n\n</div>",
"requestedAt": "2026-01-11T09:00:00.000Z",
"requestId": "3a4f5b08-b892-42b9-bdf4-f644a9062e7e",
"commitSha": "15989c49",
"filesChanged": [
"gv/docs/gvGraphSchema.md",
"gv/docs/gvKontaskSchema.md",
"gv/VIBE.md",
"CLAUDE.md",
"MUST-READ-FIRST.md"
],
"choices": [
{
"label": "View gvGraphSchema",
"value": "Read /konnectvol/gv/docs/gvGraphSchema.md and show me the thread detection section",
"primary": true
},
{
"label": "View VIBE.md",
"value": "Read /konnectvol/gv/VIBE.md and show me the session notes"
},
{
"label": "Check git log",
"value": "Show me the recent git commits"
}
],
"turnTiming": {
"totalMs": 260750,
"ttfeMs": 128,
"thinkingMs": 260620,
"toolExecutionMs": 0,
"toolCallCount": 0,
"thinkingPct": 100,
"toolsPct": 0,
"ttfePct": 0
}
},
"createdBy": "claude",
"createdAt": "2026-01-11T00:00:55.116Z",
"updatedAt": "2026-01-11T00:01:00.851Z",
"requestId": "3a4f5b08-b892-42b9-bdf4-f644a9062e7e",
"scope": "greatvibe",
"tags": [
"documentation",
"schema",
"threads"
],
"sessionId": "ses_40728090-b86"
}