Added session context to graph and dashboard md

Author: patrickkidd

.claude/settings.json

@@ -0,0 +1,7 @@
+{
+  "permissions": {
+    "additionalDirectories": [
+      "/Users/patrick/ccmemory"
+    ]
+  }
+}

CLAUDE.md

@@ -31,6 +31,7 @@ The vision doc synthesizes these articles with Patrick's thinking. If vision doc
 - Only rebuild/redeploy docker images when debugging container-specific issues
 - Use `uv` for all Python commands (e.g., `uv run pytest`, `uv pip install`)
 - **AS_BUILT.md**: Read `doc/AS_BUILT.md` before making changes. **ALWAYS update it after completing implementation work** — this is mandatory, not optional
+- **DASHBOARD.md**: Update `doc/DASHBOARD.md` when work queue items change status (completed, new items discovered, priorities shift). This is the user's return-to-project reference.
 
 ## Session Startup Requirement
 

dashboard/app.py

@@ -635,6 +635,161 @@ def retrievals():
         return jsonify([serialize_node(dict(r["r"])) for r in result])
 
 
+@app.route("/api/session-context")
+def session_context():
+    project = request.args.get("project", "")
+    if not project:
+        return jsonify({"error": "Project required"}), 400
+
+    driver = getDriver()
+    parts = []
+    ids = []
+
+    with driver.session() as session:
+        # Project Facts
+        facts_result = session.run(
+            """
+            MATCH (pf:ProjectFact {project: $project})
+            RETURN pf ORDER BY pf.timestamp DESC LIMIT 15
+            """,
+            project=project,
+        )
+        facts = [dict(r["pf"]) for r in facts_result]
+
+        if facts:
+            parts.append(
+                "## Project Rules (from context graph — treat as custom instructions)"
+            )
+            parts.append("")
+
+            by_category = {}
+            for f in facts:
+                if f.get("id"):
+                    ids.append(f["id"])
+                cat = f.get("category", "general")
+                if cat not in by_category:
+                    by_category[cat] = []
+                by_category[cat].append(f.get("fact", ""))
+
+            for cat, items in by_category.items():
+                parts.append(f"### {cat.title()}")
+                for item in items[:5]:
+                    parts.append(f"- {item[:120]}")
+                parts.append("")
+
+        # Recent items (union query)
+        recent_result = session.run(
+            """
+            CALL {
+                MATCH (n:Decision {project: $project})
+                RETURN n, 'Decision' as node_type, n.timestamp as ts
+                UNION ALL
+                MATCH (n:Correction {project: $project})
+                RETURN n, 'Correction' as node_type, n.timestamp as ts
+                UNION ALL
+                MATCH (n:Insight {project: $project})
+                RETURN n, 'Insight' as node_type, n.timestamp as ts
+                UNION ALL
+                MATCH (n:Exception {project: $project})
+                RETURN n, 'Exception' as node_type, n.timestamp as ts
+                UNION ALL
+                MATCH (n:FailedApproach {project: $project})
+                RETURN n, 'FailedApproach' as node_type, n.timestamp as ts
+            }
+            RETURN n, node_type ORDER BY ts DESC LIMIT 15
+            """,
+            project=project,
+        )
+        recent = [{"n": dict(r["n"]), "node_type": r["node_type"]} for r in recent_result]
+
+        if recent:
+            parts.append("## Recent Decisions")
+            for item in recent[:10]:
+                node = item.get("n", {})
+                node_type = item.get("node_type", "")
+                if not node:
+                    continue
+                if node.get("id"):
+                    ids.append(node["id"])
+
+                topics = node.get("topics", [])
+                topic_str = f"[{', '.join(topics[:2])}] " if topics else ""
+
+                if node_type == "Decision":
+                    parts.append(
+                        f"- {topic_str}{str(node.get('description', ''))[:100]}"
+                    )
+                elif node_type == "Correction":
+                    parts.append(
+                        f"- CORRECTION: {topic_str}{str(node.get('right_belief', ''))[:100]}"
+                    )
+                elif node_type == "Insight":
+                    parts.append(
+                        f"- Insight: {topic_str}{str(node.get('summary', ''))[:100]}"
+                    )
+                elif node_type == "Exception":
+                    parts.append(
+                        f"- Exception to '{node.get('rule_broken', '')[:40]}': {str(node.get('justification', ''))[:60]}"
+                    )
+            parts.append("")
+
+        # Failed approaches
+        failed_result = session.run(
+            """
+            MATCH (f:FailedApproach {project: $project})
+            RETURN f ORDER BY f.timestamp DESC LIMIT 5
+            """,
+            project=project,
+        )
+        failed = [dict(r["f"]) for r in failed_result]
+
+        if failed:
+            parts.append("## Things That Didn't Work (Don't Repeat)")
+            for f in failed[:5]:
+                if f.get("id"):
+                    ids.append(f["id"])
+                approach = str(f.get("approach", ""))[:50]
+                lesson = str(f.get("lesson", ""))[:60]
+                parts.append(f"- **{approach}**: {lesson}")
+            parts.append("")
+
+        # Stale decisions
+        stale_result = session.run(
+            """
+            MATCH (d:Decision {project: $project})
+            WHERE d.status = 'developmental'
+              AND d.timestamp < datetime() - duration({days: 30})
+            RETURN d ORDER BY d.timestamp DESC LIMIT 3
+            """,
+            project=project,
+        )
+        stale = [dict(r["d"]) for r in stale_result]
+
+        if stale:
+            parts.append("## Decisions Needing Review")
+            for d in stale[:3]:
+                if d.get("id"):
+                    ids.append(d["id"])
+                desc = str(d.get("description", ""))[:80]
+                parts.append(f"- {desc} *(developmental, may need revisit)*")
+            parts.append("")
+
+        # Empty state
+        if not facts and not recent and not stale and not failed:
+            parts.append("# Context Graph")
+            parts.append(f"Project: {project}")
+            parts.append("")
+            parts.append(
+                "No prior context. Project facts, decisions, and corrections will be captured automatically."
+            )
+
+    context_text = "\n".join(parts)
+    return jsonify({
+        "context": context_text,
+        "retrieved_count": len(ids),
+    })
+
+
 @app.route("/api/projects")
 def projects():
     driver = getDriver()

dashboard/templates/dashboard.html

@@ -61,6 +61,9 @@
         #node-detail { max-height: 200px; overflow-y: auto; display: none; }
         #node-detail.is-visible { display: block; }
         .node-detail-label { font-weight: 600; }
+        .msg-compact { padding: 0.75rem; }
+        #context-preview-content { white-space: pre-wrap; word-break: break-word; }
+        #context-preview-box { max-height: 400px; overflow-y: auto; }
     </style>
     <script src="https://unpkg.com/cytoscape@3.28.1/dist/cytoscape.min.js"></script>
 </head>
@@ -210,6 +213,34 @@ <h2 class="title is-4">Knowledge Graph</h2>
                                 </div>
                             </div>
                         </div>
+                        <!-- Session Context Preview (collapsible) -->
+                        <details class="mt-4" id="context-preview-details">
+                            <summary class="is-clickable has-text-weight-semibold">
+                                Session Context Preview
+                                <span class="tag is-info is-light ml-2" id="context-item-count">0 items</span>
+                            </summary>
+                            <div class="mt-3">
+                                <article class="message is-info is-small">
+                                    <div class="message-body msg-compact">
+                                        <strong>When is this injected?</strong> This context is automatically injected at the start of every Claude Code session via the <code>session_start.sh</code> hook. Claude receives this as additional system context before your first message.
+                                    </div>
+                                </article>
+                                <article class="message is-small">
+                                    <div class="message-body msg-compact">
+                                        <strong>How is it synthesized?</strong> The context is assembled from the graph in priority order:
+                                        <ol class="ml-4 mt-1 is-size-7">
+                                            <li><strong>Project Facts</strong> (up to 15) — grouped by category, treated as binding instructions</li>
+                                            <li><strong>Recent Items</strong> (up to 10) — Decisions, Corrections, Insights, Exceptions sorted by timestamp</li>
+                                            <li><strong>Failed Approaches</strong> (up to 5) — explicitly surfaced to prevent repeated mistakes</li>
+                                            <li><strong>Stale Decisions</strong> (up to 3) — developmental decisions older than 30 days flagged for review</li>
+                                        </ol>
+                                    </div>
+                                </article>
+                                <div class="box" id="context-preview-box">
+                                    <pre id="context-preview-content" class="is-size-7">Loading...</pre>
+                                </div>
+                            </div>
+                        </details>
                     </div>
                 </div>
             </div>
@@ -654,6 +685,25 @@ <h2 class="title is-5 mb-0">Developer Console</h2>
             if (e.key === 'Enter') doSearch();
         });
 
+        async function loadContextPreview() {
+            try {
+                const response = await fetch(`/api/session-context?project=${project}`);
+                const data = await response.json();
+                document.getElementById('context-preview-content').textContent = data.context || 'No context available';
+                document.getElementById('context-item-count').textContent = `${data.retrieved_count || 0} items`;
+            } catch (error) {
+                console.error('Failed to load context preview:', error);
+                document.getElementById('context-preview-content').textContent = 'Failed to load context';
+            }
+        }
+
+        // Load context when details is opened (lazy load)
+        document.getElementById('context-preview-details').addEventListener('toggle', function() {
+            if (this.open) {
+                loadContextPreview();
+            }
+        });
+
         loadMetrics();
         updateLegend();
         initGraph();
@@ -719,6 +769,18 @@ <h2 class="title is-5 mb-0">Developer Console</h2>
                 try {
                     const log = JSON.parse(e.data);
                     const cat = log.cat || 'mcp';
+
+                    // Auto-refresh graph/context when nodes are created for this project
+                    if (log.event === 'node_created' && log.project === project) {
+                        initGraph();
+                        loadMetrics();
+                        // Refresh context preview if it's open
+                        const details = document.getElementById('context-preview-details');
+                        if (details.open) {
+                            loadContextPreview();
+                        }
+                    }
+
                     if (!filters[cat]) return;
 
                     const div = document.createElement('div');