[System] DeepChat → GitHub Discussions Integration Pipeline

[rwnq8]

Purpose

Every DeepChat LLM session is recorded as a GitHub Discussion, providing:

• Full provenance: conversation → decision → commit → issue, all traceable
• Audit trail: every sprint, every decision, every file change searchable
• Handoff continuity: next agent reads Discussions to understand prior context

How It Works

DeepChat Session
  → Export conversation (user: DeepChat → Export)
  → Save to sessions/YYYY/MM/DD-session-topic.md
  → Post Discussion summary (auto: GraphQL API)
  → Cross-link: Issues, Commits, Milestones

Session Record Format

Every session gets a Discussion with:

Section	Content
Metadata	Date, branch, agent, model
What Was Executed	Tasks completed, deliverables
Key Decisions	Architecture choices, blockers identified
Files Changed	Created, modified, deleted
Git Commits	Hash range, commit count
Cross-References	Issues, Milestones, PRs
Next Steps	Blockers, upcoming tasks

Categories

Category	Use
Q&A	Session records (this is the default — user should create custom categories via Settings → Discussions)
Announcements	Sprint reports, major milestones
Show and tell	Demo releases, artifact deployments
Ideas	Research directions, feature proposals

Full Export Storage

Complete conversation exports are stored in sessions/ directory:

sessions/
  2026/
    05/
      23-sprint-18-review.md
      24-sprint-19-execution.md
      24-sprint-20-refactor.md

Discussions link to full exports for detailed audit.

Cross-Reference Convention

Element	Convention	Example
Issues	#N	Fixed in #4
Commits	owner/repo@hash	QNFO/QWAV@10fe48b
Discussions	#N	See #12 for session context
Milestones	Named reference	Targeting Sprint 21

Enabling for Your Repo

1. Enable Discussions: Settings → Features → Discussions
2. Create categories: Settings → Discussions → Categories → New Category
   • Session Records (📓) — LLM session logs
   • Sprint Reports (📊) — Sprint completion reports
   • Decisions (📝) — Architectural decisions
3. Move sessions from Q&A to Session Records after category is created

Current State (2026-05-24)

• Discussions enabled
• First session posted ([Session] 2026-05-24: Sprint 19-20 Execution & GitHub Integration #12)
• Custom categories (needs web UI)
• Session export directory (needs first export)
• Historical exports posted (3 in Downloads/)
• Automated post-session workflow

---

Part of QWAV audit trail. All sessions recorded for full provenance.