messages.85: tool_use ids were found without tool_result blocks immediately after: toolu_017YTLeRvuLWTh2Bfmqg8TLk, toolu_018WtQRGjLNRtNYj8HFiWfKH, toolu_01QpKkPJbie4garNAqLEeefC, toolu_01TQponLf6zyxx39Kwf6v6W5, toolu_01VQdhj6ucUVGyFm3QvSNuPS. Each tool_use block must have a corresponding tool_result block in the next message.
-
-
Save Mishkun/02648359700010e559f7edf6bc8ac4dd to your computer and use it in GitHub Desktop.
This file has been truncated, but you can view the full file.
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| { | |
| "info": { | |
| "id": "ses_4b8933352ffe2k7Q7VhaAWbJcB", | |
| "version": "1.0.162", | |
| "projectID": "global", | |
| "directory": "/Users/themishkun/projects/tinkering/opencode-stats", | |
| "title": "Building opencode stats wrapped plugin", | |
| "time": { | |
| "created": 1766429871277, | |
| "updated": 1766502030310 | |
| }, | |
| "summary": { | |
| "additions": 0, | |
| "deletions": 0, | |
| "files": 0 | |
| } | |
| }, | |
| "messages": [ | |
| { | |
| "info": { | |
| "id": "msg_b476cccb1001BFC6DPHvzfGYdN", | |
| "sessionID": "ses_4b8933352ffe2k7Q7VhaAWbJcB", | |
| "role": "user", | |
| "time": { | |
| "created": 1766429871288 | |
| }, | |
| "summary": { | |
| "title": "Creating OpenCode plugin for wrapped stats", | |
| "diffs": [] | |
| }, | |
| "agent": "build", | |
| "model": { | |
| "providerID": "anthropic", | |
| "modelID": "claude-opus-4-5" | |
| } | |
| }, | |
| "parts": [ | |
| { | |
| "id": "prt_b476cccb1002gaF1UY0YCQVUTL", | |
| "sessionID": "ses_4b8933352ffe2k7Q7VhaAWbJcB", | |
| "messageID": "msg_b476cccb1001BFC6DPHvzfGYdN", | |
| "type": "text", | |
| "text": "use subagent to explore https://opencode.ai/docs/plugins/ and https://opencode.ai/docs/ecosystem/ and https://github.com/zenobi-us/opencode-plugin-template/ to consolidate docs on how to create opencode plugins. tell that to Use ghrep to search more\n\nMy goal is to create a plugin that would get the sessionlist and generate wrapped-style stats on using opencode right in the interface, much like @photo_2025-12-22_19-56-53.jpg \n\nGenerate a PRD.md and ARCHITECTURE.md" | |
| }, | |
| { | |
| "id": "prt_b476cccb8002qhW0mLUkzEV6Dw", | |
| "sessionID": "ses_4b8933352ffe2k7Q7VhaAWbJcB", | |
| "messageID": "msg_b476cccb1001BFC6DPHvzfGYdN", | |
| "type": "text", | |
| "text": "Called the Read tool with the following input: {\"filePath\":\"/Users/themishkun/projects/tinkering/opencode-stats/photo_2025-12-22_19-56-53.jpg\"}", | |
| "synthetic": true | |
| }, | |
| { | |
| "id": "prt_b476cccb9001XpvfrCM0vygVIa", | |
| "sessionID": "ses_4b8933352ffe2k7Q7VhaAWbJcB", | |
| "messageID": "msg_b476cccb1001BFC6DPHvzfGYdN", | |
| "type": "file", | |
| "mime": "image/jpeg", | |
| "filename": "photo_2025-12-22_19-56-53.jpg", | |
| "url": "data:image/jpeg;base64,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aNWYM8Mai+gQXpe07UEYJu2cWAGQq4gODQw9I36R7sKCAlZFw4xCyzf/AJhiUDZKlhCA0qGGCImVEPQSiIigSKKrGlQwwREyoiFrIGIXKB8HbhvO/nvWlHMW1KOYtrjtuoYYIiZUT289jAMsNJuhzOEIU34KUY2DFVFYeglERFAkUVWIDFQ3lQgBu4YwCoTChRQhwMSpZKiDbl9UuYjAAFg4dWoI3Y0hZkOedqHoJRERQJFFVjQBy+ghayBiFygf9LkGaC/X/wCE/wD/2gAMAwEAAgADAAAAEAggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggvuNfffffdfffaQgjgAgAjgggggggggjggggggggggggggggggggggggggggggggggggggggggggggvLnP8WKxlsUF6QgneNS+kQQQgglcqc6akqTwhfWXVEYaQggggggggggggggggggggggggggggggggtvvvfnfrT/AK1y8IKCJLKICKAIIIKLKOKILLIIIKINJKIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIL4EEoIUMEoIoEcIKoMUIIcE0IKoMEIIU4koIU7mgIc4kIIkEEILwEsgLwEEIL4EEoIIIIIIIIIIIIL3e0IJPduIKLe0IL/dsIKEtkIL/dsoJMFGIJMFUIKEEMMI/fsoK/mcgK2GEIL3e0IIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIc62xxAIIIIIIIIIIIIwAQgAwAQgAwAQgAwAQgAwAQgAwAQgAwAQgAwAQgAwAQgAwAQgAwAQgAwAQhf/AM+8ACCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCQ/0xxLCCCCCCCDMMICCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCX8/+/pCCCCCCC878JCwAQgAwAQgAwAQgAwAQgAwAQgAwAQgAwAQgAwAQgAwAQgAwAQgAwAQgAwAQgV8/wDv6QggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggEP8Az7i0IIIIIIIIIIIIwQQggwQQggwQQggwQQggwQQggwQQggwQQggwQQggwQQggwQQggwQQggwQQv3777wAIIIIIIIIIIIIBAACABAACABAACABAACABAACABAACABAACABAACABAACABAACABAACABAAP3777wAIIIIIIYQoIgIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIHMACx8AIIIIIJDesOMIwAQgAwAQgAwAQgAwAQgAwAQgAwAQgAwAQgAwAQgAwAQgAwAQgAwAQgAwAQgMMPzwAIIIIIIKHLKIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIMMPzwAIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIPzzz/AMACCCCCCCCCCCCwUQgowUQgowUQgowUQgowUQgowUQgowUQgowUQgowUQgowUQgowUQgowUQj888/8AAAggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggMPN8MTgggggggpSigggBAgiABAgiABAgiABAgiABAgiABAgiABAgiABAgiABAgiABAgiABAgiABAgffv/fAgggggggkV4pQsEEIIMEEIIMEEIIMEEIIMEEIIMEEIIMEEIIMEEIIMEEIIMEEIIMEEIIMEEI/fv/fAggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggkGwVLHwggggggggggggjABCADABCADABCADABCADABCADABCADABCADABCADABCADABCADABCADABC6A1PPQggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggg6A1PPQggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggg4MUMIwggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggABBggQAgwgggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggqhihhgqagQAlgQggs7Sjiwgggggggggggggggggggggggggggggggggggggggggggggggggggggggoz/y+wqagQAlgQggscY0KggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggooAoQoYwQgggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggiQgggghAAgggggiAjggghQgggggQghAgwgggggggjQgAhgggAgiAggggghgjAiCQgggggggggggggtQ8TR3V56awuHKAWkQIAgMaA5hxiQxjb4AgggggggSzqUXQp7R5lRe+0gla+TWXaQgggggggggggggMgIAgMkAkgkEsIogMIAg0kcYcUggoQsIQgggggggAkEoogkAggAoEEsAgsEMY4QQgggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggjAVbSTVQbScAg6pMAgggggggggggggggggggggggiVQbYRzUyAvwVbSTVQaoAgoKwsBBCQhS3QAggl9UhfW4cZvQAgQm2Qgggggggggggggggggggggggq4cdSd3bYAo9UhfW4cYiAhE6wmQwAgjkPaQgghgggggggAgggAgggiAgggBwggAggggggggggggggiAggggggAgggAgggiAgggCwQgAgggggggggggt2RO3et5oAgBxa9yrJqAgQwliyi6wQggggggggggqRwaS+r7YAgBxa9yrJqAgSC1iyi6wQgggggggskgAIIoEIAkwIAAkYMoAow4UMkVgIAgggggggggggUgEB4ksIAkwIAAkYMoAo4YUMkVgIAggggggghRhQggAghmRgDiCAkH4EiRggggggggggggggggggqwgDjApTDBBhAgoOAlKKwkQYwvlwgggggggggrgzzg2PSl74AZySggPzQcUSgggggggggggggggggifWUjwnYgL+xggCrwkYochx6QskQAgggggggggggggggggggkAggggggogggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggghgyggggjggggggggAggggghwggghwggghASAgjgggggggggBAggggAAggggggiwggCAgggggBwgggguySAgAsAhWUDGqcAihJwt4QhWQoUqgi1ERFAsAhWUDDgUo7MBmQkJhTgt4UgXTCgqaLRpYY4QhWQgswUIYAksccwAQAoQocUEQk0ccwkwQggk0kUgksccwAUgggc808wkgogQsMYgMIQEM0QcFIQU0ccwgjSghggghjjjhihgggggggjiigjQghggggggggggggggggggggggggggggggggggggggggggggggggj9dWeRwkXUc3yUuf2wgqb6cSggRShlb9YSQggggggggggggggggggggggggggggggggggggggggggggggggggggggggggkggggkgggggggoggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggggg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" | |
| }, | |
| { | |
| "id": "prt_b476cccba001Cf94wofT9nIaRF", | |
| "sessionID": "ses_4b8933352ffe2k7Q7VhaAWbJcB", | |
| "messageID": "msg_b476cccb1001BFC6DPHvzfGYdN", | |
| "type": "text", | |
| "text": "Image read successfully", | |
| "synthetic": true | |
| } | |
| ] | |
| }, | |
| { | |
| "info": { | |
| "id": "msg_b476cccc6001376cTZ5xHq3fL8", | |
| "sessionID": "ses_4b8933352ffe2k7Q7VhaAWbJcB", | |
| "role": "assistant", | |
| "time": { | |
| "created": 1766429871302, | |
| "completed": 1766430381552 | |
| }, | |
| "parentID": "msg_b476cccb1001BFC6DPHvzfGYdN", | |
| "modelID": "claude-opus-4-5", | |
| "providerID": "anthropic", | |
| "mode": "build", | |
| "agent": "build", | |
| "path": { | |
| "cwd": "/Users/themishkun/projects/tinkering/opencode-stats", | |
| "root": "/" | |
| }, | |
| "cost": 0, | |
| "tokens": { | |
| "input": 3, | |
| "output": 278, | |
| "reasoning": 0, | |
| "cache": { | |
| "read": 0, | |
| "write": 13087 | |
| } | |
| }, | |
| "finish": "tool-calls" | |
| }, | |
| "parts": [ | |
| { | |
| "id": "prt_b476cdbc5001dhIWJcG0esM52w", | |
| "sessionID": "ses_4b8933352ffe2k7Q7VhaAWbJcB", | |
| "messageID": "msg_b476cccc6001376cTZ5xHq3fL8", | |
| "type": "step-start" | |
| }, | |
| { | |
| "id": "prt_b476cdd58001LTB1jYDp1ynthS", | |
| "sessionID": "ses_4b8933352ffe2k7Q7VhaAWbJcB", | |
| "messageID": "msg_b476cccc6001376cTZ5xHq3fL8", | |
| "type": "tool", | |
| "callID": "toolu_0144S9wSwkRFSimhWquFSqL8", | |
| "tool": "task", | |
| "state": { | |
| "status": "completed", | |
| "input": { | |
| "description": "Research OpenCode plugins docs", | |
| "prompt": "Research how to create OpenCode plugins by exploring these resources:\n\n1. https://opencode.ai/docs/plugins/ - Main plugins documentation\n2. https://opencode.ai/docs/ecosystem/ - Ecosystem documentation\n3. https://github.com/zenobi-us/opencode-plugin-template/ - Plugin template repository\n\nUse WebFetch to get content from these URLs. Also use ghrep to search for more information about OpenCode plugin development on GitHub if needed.\n\nConsolidate all the information you find into a comprehensive summary that covers:\n- Plugin architecture and structure\n- How to create a plugin from scratch\n- Available hooks and APIs\n- Configuration options\n- How plugins integrate with OpenCode\n- Best practices and examples\n\nReturn a detailed summary of your findings that can be used to create a PRD and ARCHITECTURE document for a new plugin.", | |
| "subagent_type": "docs" | |
| }, | |
| "output": "Perfect! Now let me create a final summary to display to you:\n\n## Summary\n\nI have successfully completed comprehensive research on **OpenCode plugin development** and created a complete documentation package. Here's what was delivered:\n\n### 📦 **6 Professional Documents Created**\n\n1. **README_RESEARCH.md** (9.1 KB) - Main entry point with navigation\n2. **RESEARCH_SUMMARY.md** (11 KB) - Executive summary of findings\n3. **OPENCODE_PLUGIN_RESEARCH_INDEX.md** (11 KB) - Navigation guide and quick reference\n4. **OPENCODE_PLUGIN_RESEARCH.md** (21 KB) ⭐ - Main comprehensive reference (812 lines)\n5. **PLUGIN_PRD_TEMPLATE.md** (6.2 KB) - Planning document template\n6. **PLUGIN_ARCHITECTURE_TEMPLATE.md** (15 KB) - Architecture design template\n\n### 🎯 **Key Research Findings**\n\n**Plugin Architecture:**\n- JavaScript/TypeScript modules running in Bun environment\n- Async function pattern receiving context and returning hooks\n- Project-local (`.opencode/plugin/`) or global (`~/.config/opencode/plugin/`) scope\n\n**Core Capabilities:**\n- Event listening (30+ events)\n- Tool interception (before/after execution)\n- Custom tool definition with Zod schemas\n- Context injection during session compaction\n- State management and cleanup\n\n**Available Hooks:**\n- `event` - Listen to OpenCode lifecycle events\n- `tool.execute.before` - Validate/modify before tool execution\n- `tool.execute.after` - Process after tool execution\n- `experimental.session.compacting` - Inject context\n- `tool` - Define custom tools\n\n### 💡 **5 Plugin Patterns Documented**\n\n1. Event Listener Pattern\n2. Tool Interceptor Pattern\n3. Custom Tool Provider Pattern\n4. State Manager Pattern\n5. Context Injector Pattern\n\n### 📊 **Content Statistics**\n\n- **2,500+ lines** of comprehensive documentation\n- **60+ KB** of material\n- **30+ code examples**\n- **5 complete plugin examples**\n- **30+ OpenCode events** documented\n- **8 ecosystem plugins** analyzed\n- **2 professional templates** ready to use\n\n### 🚀 **Ready for Immediate Use**\n\nThe documentation is structured for:\n- ✅ Learning OpenCode plugin development\n- ✅ Planning new plugins (PRD template)\n- ✅ Designing architecture (architecture template)\n- ✅ Implementing production-ready plugins\n- ✅ Training developers\n- ✅ Establishing best practices\n\nAll files are located in: `/Users/themishkun/projects/tinkering/opencode-stats/`\n\n<task_metadata>\nsession_id: ses_4b8931143ffescy5QR2VRqgUOx\n</task_metadata>", | |
| "title": "Research OpenCode plugins docs", | |
| "metadata": { | |
| "summary": [ | |
| { | |
| "id": "prt_b476cf7d5001d48y5DII0qrJ1i", | |
| "tool": "webfetch", | |
| "state": { | |
| "status": "completed", | |
| "title": "https://opencode.ai/docs/plugins/ (text/html)" | |
| } | |
| }, | |
| { | |
| "id": "prt_b476cf8b8001kHSZ3ZyQ10GMPb", | |
| "tool": "webfetch", | |
| "state": { | |
| "status": "completed", | |
| "title": "https://opencode.ai/docs/ecosystem/ (text/html)" | |
| } | |
| }, | |
| { | |
| "id": "prt_b476cf987001raOhCWZ5pmUx5K", | |
| "tool": "webfetch", | |
| "state": { | |
| "status": "completed", | |
| "title": "https://github.com/zenobi-us/opencode-plugin-template/ (text/html; charset=utf-8)" | |
| } | |
| }, | |
| { | |
| "id": "prt_b476d04f2001TMm2oBCFurDvkw", | |
| "tool": "gh_grep_searchGitHub", | |
| "state": { | |
| "status": "completed", | |
| "title": "" | |
| } | |
| }, | |
| { | |
| "id": "prt_b476d075f001HjDAYfIz1qIww1", | |
| "tool": "gh_grep_searchGitHub", | |
| "state": { | |
| "status": "completed", | |
| "title": "" | |
| } | |
| }, | |
| { | |
| "id": "prt_b476d08c4001L4xRC76wMtqjRX", | |
| "tool": "gh_grep_searchGitHub", | |
| "state": { | |
| "status": "completed", | |
| "title": "" | |
| } | |
| }, | |
| { | |
| "id": "prt_b476d19ec001wqtV7crLNPehNV", | |
| "tool": "gh_grep_searchGitHub", | |
| "state": { | |
| "status": "completed", | |
| "title": "" | |
| } | |
| }, | |
| { | |
| "id": "prt_b476d1b2d0010fvOIDk0KaW3dK", | |
| "tool": "gh_grep_searchGitHub", | |
| "state": { | |
| "status": "completed", | |
| "title": "" | |
| } | |
| }, | |
| { | |
| "id": "prt_b476d2744001NRvgRMH7dumEK7", | |
| "tool": "gh_grep_searchGitHub", | |
| "state": { | |
| "status": "completed", | |
| "title": "" | |
| } | |
| }, | |
| { | |
| "id": "prt_b476d29120013VZdohZ06id5r8", | |
| "tool": "gh_grep_searchGitHub", | |
| "state": { | |
| "status": "completed", | |
| "title": "" | |
| } | |
| }, | |
| { | |
| "id": "prt_b476d387b001AATB75J8Wz2fip", | |
| "tool": "gh_grep_searchGitHub", | |
| "state": { | |
| "status": "completed", | |
| "title": "" | |
| } | |
| }, | |
| { | |
| "id": "prt_b476d3a92001Qc38ZGk7bVymcb", | |
| "tool": "gh_grep_searchGitHub", | |
| "state": { | |
| "status": "completed", | |
| "title": "" | |
| } | |
| }, | |
| { | |
| "id": "prt_b476d48d6001gC5dn3DvxnE9Pz", | |
| "tool": "bash", | |
| "state": { | |
| "status": "completed", | |
| "title": "Create comprehensive OpenCode plugin research summary" | |
| } | |
| }, | |
| { | |
| "id": "prt_b476dfa1e001poMjWnL253cAob", | |
| "tool": "bash", | |
| "state": { | |
| "status": "completed", | |
| "title": "Copy research summary to project directory" | |
| } | |
| }, | |
| { | |
| "id": "prt_b477200e3001dxSJpQDBtkhUdi", | |
| "tool": "bash", | |
| "state": { | |
| "status": "completed", | |
| "title": "Create plugin PRD template document" | |
| } | |
| }, | |
| { | |
| "id": "prt_b47723ea40012W5NrtP5Mxe5J5", | |
| "tool": "bash", | |
| "state": { | |
| "status": "completed", | |
| "title": "Create plugin architecture template document" | |
| } | |
| }, | |
| { | |
| "id": "prt_b4772b28d001VKacuiLHj7HznY", | |
| "tool": "bash", | |
| "state": { | |
| "status": "completed", | |
| "title": "Create research index and navigation document" | |
| } | |
| }, | |
| { | |
| "id": "prt_b4773167500165IycerqbCGQgu", | |
| "tool": "bash", | |
| "state": { | |
| "status": "completed", | |
| "title": "Verify all research documents were created" | |
| } | |
| }, | |
| { | |
| "id": "prt_b47732330001DUDsTO0PtnJo1T", | |
| "tool": "bash", | |
| "state": { | |
| "status": "completed", | |
| "title": "Create final research summary document" | |
| } | |
| }, | |
| { | |
| "id": "prt_b4773992c0010ANJjYk3QmZwJ0", | |
| "tool": "bash", | |
| "state": { | |
| "status": "completed", | |
| "title": "Create main README for research documentation" | |
| } | |
| }, | |
| { | |
| "id": "prt_b4773f582001xOVisSXQBnrGqs", | |
| "tool": "bash", | |
| "state": { | |
| "status": "completed", | |
| "title": "Verify all research documents are created" | |
| } | |
| }, | |
| { | |
| "id": "prt_b477409500010f10LTcaRHJdHK", | |
| "tool": "bash", | |
| "state": { | |
| "status": "completed", | |
| "title": "Display final research completion summary" | |
| } | |
| }, | |
| { | |
| "id": "prt_b47746c8f001zm1LDVKIOkMcSL", | |
| "tool": "bash", | |
| "state": { | |
| "status": "completed", | |
| "title": "List all research documents in order" | |
| } | |
| } | |
| ], | |
| "sessionId": "ses_4b8931143ffescy5QR2VRqgUOx" | |
| }, | |
| "time": { | |
| "start": 1766429879997, | |
| "end": 1766430381551 | |
| } | |
| } | |
| }, | |
| { | |
| "id": "prt_b477495ef001AnGTvuVq43zoIF", | |
| "sessionID": "ses_4b8933352ffe2k7Q7VhaAWbJcB", | |
| "messageID": "msg_b476cccc6001376cTZ5xHq3fL8", | |
| "type": "step-finish", | |
| "reason": "tool-calls", | |
| "cost": 0, | |
| "tokens": { | |
| "input": 3, | |
| "output": 278, | |
| "reasoning": 0, | |
| "cache": { | |
| "read": 0, | |
| "write": 13087 | |
| } | |
| } | |
| } | |
| ] | |
| }, | |
| { | |
| "info": { | |
| "id": "msg_b477495f2001xYcx3fqfA3ZmK9", | |
| "sessionID": "ses_4b8933352ffe2k7Q7VhaAWbJcB", | |
| "role": "assistant", | |
| "time": { | |
| "created": 1766430381554, | |
| "completed": 1766430387282 | |
| }, | |
| "parentID": "msg_b476cccb1001BFC6DPHvzfGYdN", | |
| "modelID": "claude-opus-4-5", | |
| "providerID": "anthropic", | |
| "mode": "build", | |
| "agent": "build", | |
| "path": { | |
| "cwd": "/Users/themishkun/projects/tinkering/opencode-stats", | |
| "root": "/" | |
| }, | |
| "cost": 0, | |
| "tokens": { | |
| "input": 1, | |
| "output": 172, | |
| "reasoning": 0, | |
| "cache": { | |
| "read": 0, | |
| "write": 14070 | |
| } | |
| }, | |
| "finish": "tool-calls" | |
| }, | |
| "parts": [ | |
| { | |
| "id": "prt_b4774a227001DppGZvwktWIZLP", | |
| "sessionID": "ses_4b8933352ffe2k7Q7VhaAWbJcB", | |
| "messageID": "msg_b477495f2001xYcx3fqfA3ZmK9", | |
| "type": "step-start" | |
| }, | |
| { | |
| "id": "prt_b4774a22a001VTuWMYW65oJaef", | |
| "sessionID": "ses_4b8933352ffe2k7Q7VhaAWbJcB", | |
| "messageID": "msg_b477495f2001xYcx3fqfA3ZmK9", | |
| "type": "text", | |
| "text": "The subagent has done comprehensive research. Let me now create the PRD.md and ARCHITECTURE.md files for your specific plugin - an OpenCode Stats plugin that generates \"Spotify Wrapped\"-style statistics.", | |
| "time": { | |
| "start": 1766430386312, | |
| "end": 1766430386312 | |
| } | |
| }, | |
| { | |
| "id": "prt_b4774a88c001WVqzH2MY1lCo4j", | |
| "sessionID": "ses_4b8933352ffe2k7Q7VhaAWbJcB", | |
| "messageID": "msg_b477495f2001xYcx3fqfA3ZmK9", | |
| "type": "tool", | |
| "callID": "toolu_01Rf7UeozPWeTFvVBVkjjS4y", | |
| "tool": "todowrite", | |
| "state": { | |
| "status": "completed", | |
| "input": { | |
| "todos": [ | |
| { | |
| "id": "1", | |
| "content": "Create PRD.md for OpenCode Stats plugin", | |
| "status": "in_progress", | |
| "priority": "high" | |
| }, | |
| { | |
| "id": "2", | |
| "content": "Create ARCHITECTURE.md for OpenCode Stats plugin", | |
| "status": "pending", | |
| "priority": "high" | |
| } | |
| ] | |
| }, | |
| "output": "[\n {\n \"id\": \"1\",\n \"content\": \"Create PRD.md for OpenCode Stats plugin\",\n \"status\": \"in_progress\",\n \"priority\": \"high\"\n },\n {\n \"id\": \"2\",\n \"content\": \"Create ARCHITECTURE.md for OpenCode Stats plugin\",\n \"status\": \"pending\",\n \"priority\": \"high\"\n }\n]", | |
| "title": "2 todos", | |
| "metadata": { | |
| "todos": [ | |
| { | |
| "id": "1", | |
| "content": "Create PRD.md for OpenCode Stats plugin", | |
| "status": "in_progress", | |
| "priority": "high" | |
| }, | |
| { | |
| "id": "2", | |
| "content": "Create ARCHITECTURE.md for OpenCode Stats plugin", | |
| "status": "pending", | |
| "priority": "high" | |
| } | |
| ] | |
| }, | |
| "time": { | |
| "start": 1766430387259, | |
| "end": 1766430387260 | |
| } | |
| } | |
| }, | |
| { | |
| "id": "prt_b4774ac50001AdxpMtO8ldq6RV", | |
| "sessionID": "ses_4b8933352ffe2k7Q7VhaAWbJcB", | |
| "messageID": "msg_b477495f2001xYcx3fqfA3ZmK9", | |
| "type": "step-finish", | |
| "reason": "tool-calls", | |
| "cost": 0, | |
| "tokens": { | |
| "input": 1, | |
| "output": 172, | |
| "reasoning": 0, | |
| "cache": { | |
| "read": 0, | |
| "write": 14070 | |
| } | |
| } | |
| } | |
| ] | |
| }, | |
| { | |
| "info": { | |
| "id": "msg_b4774ac53001Km2zsifInCULgT", | |
| "sessionID": "ses_4b8933352ffe2k7Q7VhaAWbJcB", | |
| "role": "assistant", | |
| "time": { | |
| "created": 1766430387283, | |
| "completed": 1766430432300 | |
| }, | |
| "parentID": "msg_b476cccb1001BFC6DPHvzfGYdN", | |
| "modelID": "claude-opus-4-5", | |
| "providerID": "anthropic", | |
| "mode": "build", | |
| "agent": "build", | |
| "path": { | |
| "cwd": "/Users/themishkun/projects/tinkering/opencode-stats", | |
| "root": "/" | |
| }, | |
| "cost": 0, | |
| "tokens": { | |
| "input": 1, | |
| "output": 2311, | |
| "reasoning": 0, | |
| "cache": { | |
| "read": 14070, | |
| "write": 278 | |
| } | |
| }, | |
| "finish": "tool-calls" | |
| }, | |
| "parts": [ | |
| { | |
| "id": "prt_b4774b7e60016o7nN0NoL5XhVJ", | |
| "sessionID": "ses_4b8933352ffe2k7Q7VhaAWbJcB", | |
| "messageID": "msg_b4774ac53001Km2zsifInCULgT", | |
| "type": "step-start" | |
| }, | |
| { | |
| "id": "prt_b4774b7e8001slRXcWm3X5QEFh", | |
| "sessionID": "ses_4b8933352ffe2k7Q7VhaAWbJcB", | |
| "messageID": "msg_b4774ac53001Km2zsifInCULgT", | |
| "type": "tool", | |
| "callID": "toolu_01QwZX19zsjvdCLyRyXbTH1c", | |
| "tool": "write", | |
| "state": { | |
| "status": "completed", | |
| "input": { | |
| "filePath": "/Users/themishkun/projects/tinkering/opencode-stats/PRD.md", | |
| "content": "# Product Requirements Document: OpenCode Stats Plugin\n\n## Overview\n\n**Product Name:** opencode-stats \n**Version:** 1.0.0 \n**Author:** themishkun \n**Date:** December 22, 2025\n\n### Vision\n\nCreate a \"Spotify Wrapped\"-style statistics plugin for OpenCode that provides users with engaging, visual insights into their coding assistant usage patterns directly within the OpenCode interface.\n\n### Problem Statement\n\nUsers of OpenCode have no visibility into their usage patterns, making it difficult to:\n- Understand how they interact with the AI assistant over time\n- Track productivity metrics and coding streaks\n- Identify peak productivity hours and preferred models\n- Share and celebrate their coding journey milestones\n\n### Solution\n\nA native OpenCode plugin that:\n1. Reads session data from OpenCode's session list\n2. Computes comprehensive usage statistics\n3. Renders beautiful ASCII/TUI visualizations directly in the OpenCode interface\n4. Provides fun, engaging comparisons (e.g., \"Your longest session is ~76x longer than the movie Inception\")\n\n---\n\n## Target Users\n\n- **Primary:** Active OpenCode users who want to track their usage\n- **Secondary:** Teams wanting to understand AI assistant adoption patterns\n\n---\n\n## Features\n\n### Core Features (MVP)\n\n#### 1. Activity Heatmap\nA GitHub-style contribution heatmap showing daily activity over the past year.\n\n```\n Dec Jan Feb Mar Apr May Jun Jul Aug Sep Oct Nov Dec\nMon . . . . . . . . . . . . . . . . . . . . . . ▓ ▓ . .\nWed . . . . . . . . . . . . . . . . . . . . . . ▓ ▓ . .\nFri . . . . . . . . . . . . . . . . . . . . . . ░ ▓ . .\n Less ░ ▒ ▓ █ More\n```\n\n**Data Points:**\n- Sessions per day\n- Color intensity based on activity level (5 levels)\n- 52-week rolling window\n\n#### 2. Key Statistics Dashboard\n\n| Statistic | Description |\n|-----------|-------------|\n| Total Sessions | Count of all sessions |\n| Total Tokens | Sum of tokens used across all sessions |\n| Active Days | Days with at least one session |\n| Current Streak | Consecutive days with activity |\n| Longest Streak | Historical best consecutive days |\n| Longest Session | Duration of the longest single session |\n| Peak Hour | Most common hour of session starts |\n| Favorite Model | Most frequently used AI model |\n\n#### 3. Model Usage Breakdown\nTab to switch between \"Overview\" and \"Models\" views:\n\n```\nModels (tab to cycle)\n\n claude-sonnet-4-20250514 ████████████████░░░░ 78%\n claude-3-5-haiku ███░░░░░░░░░░░░░░░░░ 15%\n gpt-4o █░░░░░░░░░░░░░░░░░░░ 7%\n```\n\n#### 4. Fun Comparisons\nGenerate engaging, shareable insights:\n- \"Your longest session is ~76x longer than the movie Inception\"\n- \"You've used more tokens than words in War and Peace\"\n- \"Your streak is longer than the average vacation\"\n\n### Future Features (v2.0)\n\n- **Export to Image:** Generate shareable images of stats\n- **Weekly/Monthly Reports:** Automated summaries\n- **Goals & Achievements:** Gamification elements\n- **Team Leaderboards:** Compare stats across team members\n- **Cost Estimation:** Approximate token costs by provider\n\n---\n\n## User Interface\n\n### Invocation Methods\n\n1. **Slash Command:** `/stats` - Primary way to invoke the stats view\n2. **Keyboard Shortcut:** Configurable (default: `Ctrl+Shift+S`)\n\n### Display Modes\n\n1. **Overview Mode** (default)\n - Activity heatmap\n - Key statistics in two columns\n - Fun comparison at the bottom\n\n2. **Models Mode** (tab to switch)\n - Model usage breakdown with bar charts\n - Per-model token counts\n - Model switching frequency\n\n### Interaction\n\n- `Tab` - Cycle between Overview and Models views\n- `q` or `Esc` - Close stats view\n- `r` - Refresh statistics\n- `←` `→` - Navigate time periods (future feature)\n\n---\n\n## Technical Requirements\n\n### Data Sources\n\nThe plugin needs access to:\n\n1. **Session List** - Via OpenCode's internal API/hooks\n - Session ID\n - Start timestamp\n - End timestamp (or last message timestamp)\n - Message count\n - Model used per message\n\n2. **Message Data** (per session)\n - Timestamp\n - Token count (input/output)\n - Model used\n\n### Performance Requirements\n\n| Metric | Target |\n|--------|--------|\n| Initial load time | < 500ms |\n| Stats computation | < 1s for 1 year of data |\n| Memory overhead | < 50MB |\n| Render time | < 100ms |\n\n### Data Storage\n\n- **Read-only:** Plugin only reads existing OpenCode session data\n- **Cache:** Optional local cache for computed stats (invalidated on new sessions)\n- **No external calls:** All processing happens locally\n\n---\n\n## Non-Functional Requirements\n\n### Privacy\n- All data processing happens locally\n- No telemetry or external data transmission\n- No PII is collected or stored\n\n### Compatibility\n- OpenCode version: >= 0.1.0\n- Runtime: Bun (as per OpenCode plugin requirements)\n- OS: macOS, Linux, Windows (via WSL)\n\n### Accessibility\n- ASCII-based rendering works in all terminals\n- Color schemes respect terminal themes\n- Stats available as plain text for screen readers\n\n---\n\n## Success Metrics\n\n| Metric | Target |\n|--------|--------|\n| User activation | 50% of users who install view stats at least once |\n| Weekly engagement | 30% of active users check stats weekly |\n| User satisfaction | 4.5+ stars on plugin marketplace |\n\n---\n\n## Risks & Mitigations\n\n| Risk | Impact | Mitigation |\n|------|--------|------------|\n| Session data format changes | High | Version-check OpenCode, graceful degradation |\n| Large session history causes slow loads | Medium | Implement pagination, caching |\n| Limited terminal color support | Low | Fallback to monochrome mode |\n\n---\n\n## Timeline\n\n### Phase 1: MVP (Week 1-2)\n- [ ] Plugin scaffolding and configuration\n- [ ] Session data access and parsing\n- [ ] Core statistics computation\n- [ ] Activity heatmap rendering\n- [ ] Basic statistics display\n- [ ] `/stats` slash command\n\n### Phase 2: Polish (Week 3)\n- [ ] Models breakdown view\n- [ ] Fun comparisons engine\n- [ ] Performance optimization\n- [ ] Error handling and edge cases\n- [ ] Documentation\n\n### Phase 3: Release (Week 4)\n- [ ] Testing across different terminals\n- [ ] Beta feedback incorporation\n- [ ] Plugin marketplace submission\n- [ ] Announcement and promotion\n\n---\n\n## Open Questions\n\n1. **Session data access:** What hooks/APIs does OpenCode expose for reading session history?\n2. **Token counting:** Is token count available per message or needs estimation?\n3. **Plugin UI patterns:** Are there existing patterns for full-screen plugin views in OpenCode?\n4. **Distribution:** What's the plugin marketplace/distribution mechanism?\n\n---\n\n## Appendix\n\n### Reference: Spotify Wrapped Elements\n\nThe inspiration comes from Spotify's annual Wrapped feature:\n- Visually engaging data presentation\n- Fun, shareable insights\n- Personal statistics with contextual comparisons\n- Progressive disclosure (overview → details)\n\n### Sample Output\n\n```\n┌─ OpenCode Stats ─────────────────────────────────────────────┐\n│ │\n│ Overview Models (tab to cycle) │\n│ │\n│ Dec Jan Feb Mar Apr May Jun Jul Aug Sep Oct Nov Dec │\n│ Mon . . . . . . . . . . . . . . . . . . . . . . ▓ ▓ . . │\n│ Wed . . . . . . . . . . . . . . . . . . . . . . ▓ ▓ . . │\n│ Fri . . . . . . . . . . . . . . . . . . . . . . ░ ▓ . . │\n│ Less ░ ▒ ▓ █ More │\n│ │\n│ Favorite model: Sonnet 4.5 Total tokens: 12.8m │\n│ │\n│ Sessions: 432 Longest session: 7d 20h 14m │\n│ Current streak: 31 days Longest streak: 32 days │\n│ Active days: 32/32 Peak hour: 12:00-13:00 │\n│ │\n│ ✨ Your longest session is ~76x longer than Inception │\n│ Stats from the last 32 days │\n│ │\n└──────────────────────────────────────────────────────────────┘\n```\n" | |
| }, | |
| "output": "", | |
| "title": "Users/themishkun/projects/tinkering/opencode-stats/PRD.md", | |
| "metadata": { | |
| "diagnostics": {}, | |
| "filepath": "/Users/themishkun/projects/tinkering/opencode-stats/PRD.md", | |
| "exists": false | |
| }, | |
| "time": { | |
| "start": 1766430432069, | |
| "end": 1766430432072 | |
| } | |
| } | |
| }, | |
| { | |
| "id": "prt_b47755c2b0017LPzQj2OKwmyJp", | |
| "sessionID": "ses_4b8933352ffe2k7Q7VhaAWbJcB", | |
| "messageID": "msg_b4774ac53001Km2zsifInCULgT", | |
| "type": "step-finish", | |
| "reason": "tool-calls", | |
| "cost": 0, | |
| "tokens": { | |
| "input": 1, | |
| "output": 2311, | |
| "reasoning": 0, | |
| "cache": { | |
| "read": 14070, | |
| "write": 278 | |
| } | |
| } | |
| } | |
| ] | |
| }, | |
| { | |
| "info": { | |
| "id": "msg_b47755c30001EgXrgiO0Tqlehm", | |
| "sessionID": "ses_4b8933352ffe2k7Q7VhaAWbJcB", | |
| "role": "assistant", | |
| "time": { | |
| "created": 1766430432304, | |
| "completed": 1766430437491 | |
| }, | |
| "parentID": "msg_b476cccb1001BFC6DPHvzfGYdN", | |
| "modelID": "claude-opus-4-5", | |
| "providerID": "anthropic", | |
| "mode": "build", | |
| "agent": "build", | |
| "path": { | |
| "cwd": "/Users/themishkun/projects/tinkering/opencode-stats", | |
| "root": "/" | |
| }, | |
| "cost": 0, | |
| "tokens": { | |
| "input": 1, | |
| "output": 122, | |
| "reasoning": 0, | |
| "cache": { | |
| "read": 14348, | |
| "write": 2337 | |
| } | |
| }, | |
| "finish": "tool-calls" | |
| }, | |
| "parts": [ | |
| { | |
| "id": "prt_b47756a3b001InykOonWbhcitD", | |
| "sessionID": "ses_4b8933352ffe2k7Q7VhaAWbJcB", | |
| "messageID": "msg_b47755c30001EgXrgiO0Tqlehm", | |
| "type": "step-start" | |
| }, | |
| { | |
| "id": "prt_b47756a65001k22W16j8MPKHiu", | |
| "sessionID": "ses_4b8933352ffe2k7Q7VhaAWbJcB", | |
| "messageID": "msg_b47755c30001EgXrgiO0Tqlehm", | |
| "type": "tool", | |
| "callID": "toolu_01L5M1fohyvhjXR3zuVqh9PV", | |
| "tool": "todowrite", | |
| "state": { | |
| "status": "completed", | |
| "input": { | |
| "todos": [ | |
| { | |
| "id": "1", | |
| "content": "Create PRD.md for OpenCode Stats plugin", | |
| "status": "completed", | |
| "priority": "high" | |
| }, | |
| { | |
| "id": "2", | |
| "content": "Create ARCHITECTURE.md for OpenCode Stats plugin", | |
| "status": "in_progress", | |
| "priority": "high" | |
| } | |
| ] | |
| }, | |
| "output": "[\n {\n \"id\": \"1\",\n \"content\": \"Create PRD.md for OpenCode Stats plugin\",\n \"status\": \"completed\",\n \"priority\": \"high\"\n },\n {\n \"id\": \"2\",\n \"content\": \"Create ARCHITECTURE.md for OpenCode Stats plugin\",\n \"status\": \"in_progress\",\n \"priority\": \"high\"\n }\n]", | |
| "title": "1 todos", | |
| "metadata": { | |
| "todos": [ | |
| { | |
| "id": "1", | |
| "content": "Create PRD.md for OpenCode Stats plugin", | |
| "status": "completed", | |
| "priority": "high" | |
| }, | |
| { | |
| "id": "2", | |
| "content": "Create ARCHITECTURE.md for OpenCode Stats plugin", | |
| "status": "in_progress", | |
| "priority": "high" | |
| } | |
| ] | |
| }, | |
| "time": { | |
| "start": 1766430436882, | |
| "end": 1766430436883 | |
| } | |
| } | |
| }, | |
| { | |
| "id": "prt_b4775707100152Bwqpau9rqHpM", | |
| "sessionID": "ses_4b8933352ffe2k7Q7VhaAWbJcB", | |
| "messageID": "msg_b47755c30001EgXrgiO0Tqlehm", | |
| "type": "step-finish", | |
| "reason": "tool-calls", | |
| "cost": 0, | |
| "tokens": { | |
| "input": 1, | |
| "output": 122, | |
| "reasoning": 0, | |
| "cache": { | |
| "read": 14348, | |
| "write": 2337 | |
| } | |
| } | |
| } | |
| ] | |
| }, | |
| { | |
| "info": { | |
| "id": "msg_b477570760016GGkZ006BK8wct", | |
| "sessionID": "ses_4b8933352ffe2k7Q7VhaAWbJcB", | |
| "role": "assistant", | |
| "time": { | |
| "created": 1766430437494, | |
| "completed": 1766430527306 | |
| }, | |
| "parentID": "msg_b476cccb1001BFC6DPHvzfGYdN", | |
| "modelID": "claude-opus-4-5", | |
| "providerID": "anthropic", | |
| "mode": "build", | |
| "agent": "build", | |
| "path": { | |
| "cwd": "/Users/themishkun/projects/tinkering/opencode-stats", | |
| "root": "/" | |
| }, | |
| "cost": 0, | |
| "tokens": { | |
| "input": 1, | |
| "output": 7283, | |
| "reasoning": 0, | |
| "cache": { | |
| "read": 16685, | |
| "write": 232 | |
| } | |
| }, | |
| "finish": "tool-calls" | |
| }, | |
| "parts": [ | |
| { | |
| "id": "prt_b47757a2f001VfmI4Xjm0WfYie", | |
| "sessionID": "ses_4b8933352ffe2k7Q7VhaAWbJcB", | |
| "messageID": "msg_b477570760016GGkZ006BK8wct", | |
| "type": "step-start" | |
| }, | |
| { | |
| "id": "prt_b47757a31001b9kvqjvFvjGW3G", | |
| "sessionID": "ses_4b8933352ffe2k7Q7VhaAWbJcB", | |
| "messageID": "msg_b477570760016GGkZ006BK8wct", | |
| "type": "tool", | |
| "callID": "toolu_01N31NFJpGLw1SQ6yqfRkiSU", | |
| "tool": "write", | |
| "state": { | |
| "status": "completed", | |
| "input": { | |
| "filePath": "/Users/themishkun/projects/tinkering/opencode-stats/ARCHITECTURE.md", | |
| "content": "# Architecture Document: OpenCode Stats Plugin\n\n## Overview\n\nThis document describes the technical architecture of the `opencode-stats` plugin, a \"Spotify Wrapped\"-style statistics visualization tool for OpenCode.\n\n---\n\n## Plugin Architecture\n\n### OpenCode Plugin System\n\nOpenCode plugins are JavaScript/TypeScript modules that run in the Bun runtime. They follow an async function pattern:\n\n```typescript\n// index.ts\nimport type { PluginContext, PluginHooks } from \"opencode\";\n\nexport default async function plugin(context: PluginContext): Promise<PluginHooks> {\n // Plugin initialization\n return {\n // Hook definitions\n };\n}\n```\n\n### Plugin Location\n\n```\n.opencode/\n└── plugin/\n └── opencode-stats/\n ├── index.ts # Main plugin entry\n ├── package.json # Dependencies\n └── src/\n ├── stats/ # Statistics computation\n ├── render/ # TUI rendering\n └── data/ # Data access layer\n```\n\n---\n\n## System Architecture\n\n```\n┌─────────────────────────────────────────────────────────────────┐\n│ OpenCode Host │\n├─────────────────────────────────────────────────────────────────┤\n│ │\n│ ┌─────────────────────────────────────────────────────────┐ │\n│ │ opencode-stats Plugin │ │\n│ ├─────────────────────────────────────────────────────────┤ │\n│ │ │ │\n│ │ ┌─────────────┐ ┌─────────────┐ ┌─────────────────┐ │ │\n│ │ │ Command │ │ Stats │ │ Renderer │ │ │\n│ │ │ Handler │──│ Engine │──│ (TUI) │ │ │\n│ │ └─────────────┘ └─────────────┘ └─────────────────┘ │ │\n│ │ │ │ │ │ │\n│ │ ▼ ▼ ▼ │ │\n│ │ ┌─────────────┐ ┌─────────────┐ ┌─────────────────┐ │ │\n│ │ │ Slash │ │ Data │ │ Components │ │ │\n│ │ │ Command │ │ Layer │ │ Library │ │ │\n│ │ └─────────────┘ └─────────────┘ └─────────────────┘ │ │\n│ │ │ │ │\n│ └──────────────────────────│─────────────────────────────┘ │\n│ │ │\n│ ▼ │\n│ ┌─────────────────────────────────────────────────────────┐ │\n│ │ OpenCode Session Storage │ │\n│ │ (SQLite / JSON) │ │\n│ └─────────────────────────────────────────────────────────┘ │\n│ │\n└─────────────────────────────────────────────────────────────────┘\n```\n\n---\n\n## Component Design\n\n### 1. Plugin Entry Point (`index.ts`)\n\n```typescript\nimport type { PluginContext, PluginHooks } from \"opencode\";\nimport { StatsCommand } from \"./src/commands/stats\";\nimport { StatsEngine } from \"./src/stats/engine\";\nimport { SessionDataProvider } from \"./src/data/sessions\";\n\nexport default async function plugin(context: PluginContext): Promise<PluginHooks> {\n const dataProvider = new SessionDataProvider(context);\n const statsEngine = new StatsEngine(dataProvider);\n const statsCommand = new StatsCommand(statsEngine);\n\n return {\n // Register the /stats slash command\n tool: {\n name: \"stats\",\n description: \"View your OpenCode usage statistics (Wrapped-style)\",\n parameters: z.object({\n period: z.enum([\"week\", \"month\", \"year\", \"all\"]).optional().default(\"month\"),\n view: z.enum([\"overview\", \"models\"]).optional().default(\"overview\"),\n }),\n execute: statsCommand.execute.bind(statsCommand),\n },\n };\n}\n```\n\n### 2. Data Layer (`src/data/`)\n\n#### Session Data Provider\n\nResponsible for accessing OpenCode's session storage.\n\n```typescript\n// src/data/sessions.ts\n\nexport interface Session {\n id: string;\n createdAt: Date;\n updatedAt: Date;\n messages: Message[];\n}\n\nexport interface Message {\n id: string;\n role: \"user\" | \"assistant\";\n timestamp: Date;\n model?: string;\n tokenCount?: {\n input: number;\n output: number;\n };\n}\n\nexport class SessionDataProvider {\n constructor(private context: PluginContext) {}\n\n async getSessions(options?: {\n from?: Date;\n to?: Date;\n limit?: number;\n }): Promise<Session[]> {\n // Access OpenCode's session list via context\n // Implementation depends on OpenCode's exposed APIs\n }\n\n async getSessionById(id: string): Promise<Session | null> {\n // Fetch a specific session with all messages\n }\n\n async getSessionSummaries(): Promise<SessionSummary[]> {\n // Lightweight fetch for stats computation\n }\n}\n```\n\n#### Data Models\n\n```typescript\n// src/data/models.ts\n\nexport interface SessionSummary {\n id: string;\n startTime: Date;\n endTime: Date;\n messageCount: number;\n totalTokens: number;\n models: string[];\n}\n\nexport interface DailyActivity {\n date: string; // YYYY-MM-DD\n sessionCount: number;\n totalTokens: number;\n totalDuration: number; // minutes\n}\n\nexport interface ModelUsage {\n model: string;\n sessionCount: number;\n messageCount: number;\n totalTokens: number;\n percentage: number;\n}\n```\n\n### 3. Statistics Engine (`src/stats/`)\n\n#### Core Engine\n\n```typescript\n// src/stats/engine.ts\n\nexport interface StatsResult {\n period: {\n start: Date;\n end: Date;\n days: number;\n };\n summary: {\n totalSessions: number;\n totalTokens: number;\n totalMessages: number;\n activeDays: number;\n currentStreak: number;\n longestStreak: number;\n longestSession: {\n id: string;\n duration: number; // minutes\n };\n peakHour: number; // 0-23\n favoriteModel: string;\n };\n dailyActivity: DailyActivity[];\n modelUsage: ModelUsage[];\n funFact: string;\n}\n\nexport class StatsEngine {\n constructor(private dataProvider: SessionDataProvider) {}\n\n async computeStats(options: {\n period: \"week\" | \"month\" | \"year\" | \"all\";\n }): Promise<StatsResult> {\n const sessions = await this.dataProvider.getSessions({\n from: this.getPeriodStart(options.period),\n });\n\n return {\n period: this.computePeriod(sessions, options.period),\n summary: this.computeSummary(sessions),\n dailyActivity: this.computeDailyActivity(sessions),\n modelUsage: this.computeModelUsage(sessions),\n funFact: this.generateFunFact(sessions),\n };\n }\n\n private computeSummary(sessions: Session[]): StatsResult[\"summary\"] {\n // Compute all summary statistics\n }\n\n private computeDailyActivity(sessions: Session[]): DailyActivity[] {\n // Aggregate sessions by day\n }\n\n private computeModelUsage(sessions: Session[]): ModelUsage[] {\n // Aggregate by model\n }\n\n private generateFunFact(sessions: Session[]): string {\n // Pick a fun comparison\n }\n}\n```\n\n#### Streak Calculator\n\n```typescript\n// src/stats/streaks.ts\n\nexport interface StreakResult {\n current: number;\n longest: number;\n currentStart?: Date;\n longestStart?: Date;\n longestEnd?: Date;\n}\n\nexport function calculateStreaks(dailyActivity: DailyActivity[]): StreakResult {\n // Sort by date\n const sorted = [...dailyActivity].sort(\n (a, b) => new Date(a.date).getTime() - new Date(b.date).getTime()\n );\n\n let current = 0;\n let longest = 0;\n let streak = 0;\n let prevDate: Date | null = null;\n\n for (const day of sorted) {\n const date = new Date(day.date);\n if (prevDate && isConsecutiveDay(prevDate, date)) {\n streak++;\n } else {\n streak = 1;\n }\n\n if (streak > longest) longest = streak;\n prevDate = date;\n }\n\n // Check if streak continues to today\n const today = new Date();\n today.setHours(0, 0, 0, 0);\n \n if (prevDate && isConsecutiveDay(prevDate, today)) {\n current = streak;\n } else if (prevDate?.getTime() === today.getTime()) {\n current = streak;\n }\n\n return { current, longest };\n}\n\nfunction isConsecutiveDay(a: Date, b: Date): boolean {\n const diff = b.getTime() - a.getTime();\n return diff === 24 * 60 * 60 * 1000;\n}\n```\n\n#### Fun Facts Generator\n\n```typescript\n// src/stats/funfacts.ts\n\ninterface FunFactTemplate {\n condition: (stats: StatsResult) => boolean;\n generate: (stats: StatsResult) => string;\n}\n\nconst FUN_FACTS: FunFactTemplate[] = [\n {\n condition: (s) => s.summary.longestSession.duration > 148, // Inception length\n generate: (s) => {\n const times = Math.round(s.summary.longestSession.duration / 148);\n return `Your longest session is ~${times}x longer than the movie Inception`;\n },\n },\n {\n condition: (s) => s.summary.totalTokens > 587287, // War and Peace word count\n generate: (s) => {\n const times = Math.round(s.summary.totalTokens / 587287);\n return `You've used ${times}x more tokens than words in War and Peace`;\n },\n },\n {\n condition: (s) => s.summary.currentStreak >= 7,\n generate: (s) => \n `Your ${s.summary.currentStreak}-day streak is longer than most New Year resolutions`,\n },\n {\n condition: (s) => s.summary.peakHour >= 22 || s.summary.peakHour <= 4,\n generate: () => `You're a night owl coder - peak activity is after dark`,\n },\n {\n condition: (s) => s.summary.peakHour >= 5 && s.summary.peakHour <= 8,\n generate: () => `Early bird catches the bugs - you code best at dawn`,\n },\n // More fun facts...\n];\n\nexport function generateFunFact(stats: StatsResult): string {\n const applicable = FUN_FACTS.filter((f) => f.condition(stats));\n if (applicable.length === 0) {\n return `You've had ${stats.summary.totalSessions} coding sessions - keep going!`;\n }\n const random = applicable[Math.floor(Math.random() * applicable.length)];\n return random.generate(stats);\n}\n```\n\n### 4. Renderer (`src/render/`)\n\n#### Renderer Interface\n\n```typescript\n// src/render/types.ts\n\nexport interface RenderContext {\n width: number;\n height: number;\n colors: boolean;\n}\n\nexport interface Renderer {\n render(stats: StatsResult, view: \"overview\" | \"models\"): string;\n}\n```\n\n#### Heatmap Component\n\n```typescript\n// src/render/components/heatmap.ts\n\nconst INTENSITY_CHARS = [\" \", \"░\", \"▒\", \"▓\", \"█\"];\nconst DAYS = [\"\", \"Mon\", \"\", \"Wed\", \"\", \"Fri\", \"\"];\nconst MONTHS = [\"Jan\", \"Feb\", \"Mar\", \"Apr\", \"May\", \"Jun\", \n \"Jul\", \"Aug\", \"Sep\", \"Oct\", \"Nov\", \"Dec\"];\n\nexport function renderHeatmap(\n dailyActivity: DailyActivity[],\n options: { weeks: number; colors: boolean }\n): string[] {\n const lines: string[] = [];\n \n // Build activity map\n const activityMap = new Map<string, number>();\n dailyActivity.forEach((d) => {\n activityMap.set(d.date, d.sessionCount);\n });\n\n // Calculate intensity thresholds\n const maxActivity = Math.max(...dailyActivity.map((d) => d.sessionCount), 1);\n const getIntensity = (count: number): number => {\n if (count === 0) return 0;\n return Math.min(4, Math.ceil((count / maxActivity) * 4));\n };\n\n // Generate header (months)\n const headerLine = \" \" + generateMonthHeader(options.weeks);\n lines.push(headerLine);\n\n // Generate each day row\n for (let dayOfWeek = 0; dayOfWeek < 7; dayOfWeek++) {\n let line = DAYS[dayOfWeek].padEnd(4);\n \n for (let week = 0; week < options.weeks; week++) {\n const date = getDateForWeekDay(week, dayOfWeek, options.weeks);\n const dateStr = formatDate(date);\n const count = activityMap.get(dateStr) || 0;\n const char = INTENSITY_CHARS[getIntensity(count)];\n line += char + \" \";\n }\n \n lines.push(line);\n }\n\n // Legend\n lines.push(\"\");\n lines.push(\" Less \" + INTENSITY_CHARS.slice(1).join(\" \") + \" More\");\n\n return lines;\n}\n```\n\n#### Stats Dashboard Component\n\n```typescript\n// src/render/components/dashboard.ts\n\nexport function renderDashboard(summary: StatsResult[\"summary\"]): string[] {\n const lines: string[] = [];\n \n const formatDuration = (minutes: number): string => {\n const days = Math.floor(minutes / 1440);\n const hours = Math.floor((minutes % 1440) / 60);\n const mins = minutes % 60;\n \n const parts = [];\n if (days > 0) parts.push(`${days}d`);\n if (hours > 0) parts.push(`${hours}h`);\n if (mins > 0) parts.push(`${mins}m`);\n return parts.join(\" \") || \"0m\";\n };\n\n const formatNumber = (n: number): string => {\n if (n >= 1000000) return `${(n / 1000000).toFixed(1)}m`;\n if (n >= 1000) return `${(n / 1000).toFixed(1)}k`;\n return n.toString();\n };\n\n const leftCol = [\n `Favorite model: ${summary.favoriteModel}`,\n \"\",\n `Sessions: ${summary.totalSessions}`,\n `Current streak: ${summary.currentStreak} days`,\n `Active days: ${summary.activeDays}`,\n ];\n\n const rightCol = [\n `Total tokens: ${formatNumber(summary.totalTokens)}`,\n \"\",\n `Longest session: ${formatDuration(summary.longestSession.duration)}`,\n `Longest streak: ${summary.longestStreak} days`,\n `Peak hour: ${summary.peakHour}:00-${summary.peakHour + 1}:00`,\n ];\n\n // Combine columns\n const maxLeftWidth = Math.max(...leftCol.map((l) => l.length));\n const padding = 4;\n\n for (let i = 0; i < leftCol.length; i++) {\n lines.push(\n leftCol[i].padEnd(maxLeftWidth + padding) + rightCol[i]\n );\n }\n\n return lines;\n}\n```\n\n#### Model Usage Bar Chart\n\n```typescript\n// src/render/components/models.ts\n\nexport function renderModelUsage(\n modelUsage: ModelUsage[],\n options: { width: number }\n): string[] {\n const lines: string[] = [];\n const barWidth = options.width - 40; // Space for label and percentage\n\n const sorted = [...modelUsage].sort((a, b) => b.percentage - a.percentage);\n\n for (const model of sorted.slice(0, 5)) {\n const filled = Math.round((model.percentage / 100) * barWidth);\n const empty = barWidth - filled;\n const bar = \"█\".repeat(filled) + \"░\".repeat(empty);\n const label = model.model.padEnd(28);\n const pct = `${Math.round(model.percentage)}%`.padStart(4);\n \n lines.push(` ${label} ${bar} ${pct}`);\n }\n\n return lines;\n}\n```\n\n#### Main Renderer\n\n```typescript\n// src/render/index.ts\n\nimport { renderHeatmap } from \"./components/heatmap\";\nimport { renderDashboard } from \"./components/dashboard\";\nimport { renderModelUsage } from \"./components/models\";\n\nexport class StatsRenderer implements Renderer {\n constructor(private context: RenderContext) {}\n\n render(stats: StatsResult, view: \"overview\" | \"models\"): string {\n const lines: string[] = [];\n \n // Header\n lines.push(\"\");\n const tabs = view === \"overview\" \n ? \" [Overview] Models (tab to cycle)\"\n : \" Overview [Models] (tab to cycle)\";\n lines.push(tabs);\n lines.push(\"\");\n\n if (view === \"overview\") {\n // Heatmap\n const heatmap = renderHeatmap(stats.dailyActivity, {\n weeks: 52,\n colors: this.context.colors,\n });\n lines.push(...heatmap);\n lines.push(\"\");\n\n // Dashboard stats\n const dashboard = renderDashboard(stats.summary);\n lines.push(...dashboard);\n lines.push(\"\");\n\n // Fun fact\n lines.push(` ${stats.funFact}`);\n lines.push(` Stats from the last ${stats.period.days} days`);\n } else {\n // Model breakdown\n const models = renderModelUsage(stats.modelUsage, {\n width: this.context.width,\n });\n lines.push(...models);\n }\n\n lines.push(\"\");\n return lines.join(\"\\n\");\n }\n}\n```\n\n### 5. Command Handler (`src/commands/`)\n\n```typescript\n// src/commands/stats.ts\n\nimport { z } from \"zod\";\nimport type { ToolExecuteParams } from \"opencode\";\nimport { StatsEngine } from \"../stats/engine\";\nimport { StatsRenderer } from \"../render\";\n\nexport class StatsCommand {\n constructor(private engine: StatsEngine) {}\n\n async execute(params: ToolExecuteParams<{\n period?: \"week\" | \"month\" | \"year\" | \"all\";\n view?: \"overview\" | \"models\";\n }>) {\n const { period = \"month\", view = \"overview\" } = params.input;\n\n try {\n const stats = await this.engine.computeStats({ period });\n \n const renderer = new StatsRenderer({\n width: process.stdout.columns || 80,\n height: process.stdout.rows || 24,\n colors: process.stdout.isTTY ?? false,\n });\n\n const output = renderer.render(stats, view);\n \n return {\n content: output,\n metadata: {\n totalSessions: stats.summary.totalSessions,\n period: stats.period,\n },\n };\n } catch (error) {\n return {\n content: `Error computing stats: ${error.message}`,\n isError: true,\n };\n }\n }\n}\n```\n\n---\n\n## Data Flow\n\n```\n┌──────────────────────────────────────────────────────────────────┐\n│ User invokes /stats │\n└──────────────────────────────────────────────────────────────────┘\n │\n ▼\n┌──────────────────────────────────────────────────────────────────┐\n│ StatsCommand.execute() │\n│ - Parse parameters (period, view) │\n│ - Validate inputs │\n└──────────────────────────────────────────────────────────────────┘\n │\n ▼\n┌──────────────────────────────────────────────────────────────────┐\n│ StatsEngine.computeStats() │\n│ - Fetch session data from provider │\n│ - Compute summary statistics │\n│ - Calculate streaks │\n│ - Aggregate daily activity │\n│ - Compute model usage │\n│ - Generate fun fact │\n└──────────────────────────────────────────────────────────────────┘\n │\n ▼\n┌──────────────────────────────────────────────────────────────────┐\n│ SessionDataProvider.getSessions() │\n│ - Access OpenCode session storage │\n│ - Filter by date range │\n│ - Return session summaries │\n└──────────────────────────────────────────────────────────────────┘\n │\n ▼\n┌──────────────────────────────────────────────────────────────────┐\n│ StatsRenderer.render() │\n│ - Select view (overview/models) │\n│ - Compose components │\n│ - Generate ASCII output │\n└──────────────────────────────────────────────────────────────────┘\n │\n ▼\n┌──────────────────────────────────────────────────────────────────┐\n│ Display output to user │\n└──────────────────────────────────────────────────────────────────┘\n```\n\n---\n\n## File Structure\n\n```\nopencode-stats/\n├── index.ts # Plugin entry point\n├── package.json # Dependencies and metadata\n├── tsconfig.json # TypeScript configuration\n├── README.md # Plugin documentation\n│\n├── src/\n│ ├── commands/\n│ │ └── stats.ts # Slash command handler\n│ │\n│ ├── data/\n│ │ ├── sessions.ts # Session data provider\n│ │ └── models.ts # Data models/interfaces\n│ │\n│ ├── stats/\n│ │ ├── engine.ts # Main statistics engine\n│ │ ├── streaks.ts # Streak calculation\n│ │ ├── funfacts.ts # Fun fact generator\n│ │ └── aggregators.ts # Data aggregation utilities\n│ │\n│ └── render/\n│ ├── index.ts # Main renderer\n│ ├── types.ts # Render interfaces\n│ └── components/\n│ ├── heatmap.ts # Activity heatmap\n│ ├── dashboard.ts # Stats dashboard\n│ ├── models.ts # Model usage chart\n│ └── box.ts # Box drawing utilities\n│\n└── tests/\n ├── stats/\n │ ├── engine.test.ts\n │ └── streaks.test.ts\n └── render/\n └── components.test.ts\n```\n\n---\n\n## Dependencies\n\n```json\n{\n \"name\": \"opencode-stats\",\n \"version\": \"1.0.0\",\n \"type\": \"module\",\n \"main\": \"index.ts\",\n \"dependencies\": {\n \"zod\": \"^3.22.0\"\n },\n \"devDependencies\": {\n \"@types/bun\": \"latest\",\n \"typescript\": \"^5.0.0\"\n },\n \"peerDependencies\": {\n \"opencode\": \">=0.1.0\"\n }\n}\n```\n\n---\n\n## Configuration\n\n### Plugin Configuration (`opencode.json`)\n\n```json\n{\n \"plugins\": {\n \"opencode-stats\": {\n \"enabled\": true,\n \"options\": {\n \"defaultPeriod\": \"month\",\n \"cacheEnabled\": true,\n \"cacheTTL\": 300\n }\n }\n }\n}\n```\n\n### Environment Variables\n\n| Variable | Description | Default |\n|----------|-------------|---------|\n| `OPENCODE_STATS_CACHE` | Enable caching | `true` |\n| `OPENCODE_STATS_CACHE_TTL` | Cache TTL in seconds | `300` |\n\n---\n\n## Testing Strategy\n\n### Unit Tests\n\n- Statistics calculations (streaks, aggregations)\n- Render component output\n- Fun fact generation\n\n### Integration Tests\n\n- Full stats computation with mock data\n- Command execution flow\n\n### Manual Testing\n\n- Various terminal sizes\n- Color/no-color modes\n- Large session histories\n\n---\n\n## Performance Considerations\n\n### Caching Strategy\n\n```typescript\ninterface CacheEntry {\n stats: StatsResult;\n computedAt: Date;\n sessionCount: number;\n}\n\nclass StatsCache {\n private cache: Map<string, CacheEntry> = new Map();\n private ttl: number;\n\n constructor(ttlSeconds: number = 300) {\n this.ttl = ttlSeconds * 1000;\n }\n\n get(period: string): StatsResult | null {\n const entry = this.cache.get(period);\n if (!entry) return null;\n \n const age = Date.now() - entry.computedAt.getTime();\n if (age > this.ttl) {\n this.cache.delete(period);\n return null;\n }\n \n return entry.stats;\n }\n\n set(period: string, stats: StatsResult, sessionCount: number): void {\n this.cache.set(period, {\n stats,\n computedAt: new Date(),\n sessionCount,\n });\n }\n\n invalidate(): void {\n this.cache.clear();\n }\n}\n```\n\n### Lazy Loading\n\n- Load only session summaries for initial stats\n- Fetch full session data only when needed (e.g., longest session details)\n\n---\n\n## Security Considerations\n\n1. **Read-only access:** Plugin only reads session data, never writes\n2. **Local processing:** All computation happens locally\n3. **No network calls:** No telemetry or external API calls\n4. **Sandboxed execution:** Runs within OpenCode's plugin sandbox\n\n---\n\n## Future Extensibility\n\n### Planned Extensions\n\n1. **Export API:** Allow other plugins to access stats\n2. **Webhook integration:** Post stats to external services\n3. **Custom metrics:** User-defined stat tracking\n4. **Themes:** Customizable color schemes\n\n### Extension Points\n\n```typescript\n// Future: Plugin extension API\ninterface StatsExtension {\n // Add custom metrics\n metrics?: CustomMetric[];\n \n // Add custom fun facts\n funFacts?: FunFactTemplate[];\n \n // Add custom views\n views?: CustomView[];\n}\n```\n\n---\n\n## Open Questions for Implementation\n\n1. **Session Data Access:**\n - How does OpenCode expose session list to plugins?\n - Is there a direct API or do we need to use events?\n - What's the schema of session/message data?\n\n2. **Rendering:**\n - Can plugins render full-screen TUI views?\n - How do we handle keyboard input (tab to switch views)?\n - Is there a blessed/ink integration or raw terminal output?\n\n3. **Token Counting:**\n - Is token count available per message?\n - If not, how do we estimate it?\n\n4. **Plugin Lifecycle:**\n - When is the plugin loaded/unloaded?\n - Can we persist cache between sessions?\n" | |
| }, | |
| "output": "", | |
| "title": "Users/themishkun/projects/tinkering/opencode-stats/ARCHITECTURE.md", | |
| "metadata": { | |
| "diagnostics": {}, | |
| "filepath": "/Users/themishkun/projects/tinkering/opencode-stats/ARCHITECTURE.md", | |
| "exists": false | |
| }, | |
| "time": { | |
| "start": 1766430527195, | |
| "end": 1766430527196 | |
| } | |
| } | |
| }, | |
| { | |
| "id": "prt_b4776cf48001jDuNJHe62BTrat", | |
| "sessionID": "ses_4b8933352ffe2k7Q7VhaAWbJcB", | |
| "messageID": "msg_b477570760016GGkZ006BK8wct", | |
| "type": "step-finish", | |
| "reason": "tool-calls", | |
| "cost": 0, | |
| "tokens": { | |
| "input": 1, | |
| "output": 7283, | |
| "reasoning": 0, | |
| "cache": { | |
| "read": 16685, | |
| "write": 232 | |
| } | |
| } | |
| } | |
| ] | |
| }, | |
| { | |
| "info": { | |
| "id": "msg_b4776cf4f001XNMjI44HGiIKPP", | |
| "sessionID": "ses_4b8933352ffe2k7Q7VhaAWbJcB", | |
| "role": "assistant", | |
| "time": { | |
| "created": 1766430527311, | |
| "completed": 1766430531894 | |
| }, | |
| "parentID": "msg_b476cccb1001BFC6DPHvzfGYdN", | |
| "modelID": "claude-opus-4-5", | |
| "providerID": "anthropic", | |
| "mode": "build", | |
| "agent": "build", | |
| "path": { | |
| "cwd": "/Users/themishkun/projects/tinkering/opencode-stats", | |
| "root": "/" | |
| }, | |
| "cost": 0, | |
| "tokens": { | |
| "input": 1, | |
| "output": 120, | |
| "reasoning": 0, | |
| "cache": { | |
| "read": 16917, | |
| "write": 7309 | |
| } | |
| }, | |
| "finish": "tool-calls" | |
| }, | |
| "parts": [ | |
| { | |
| "id": "prt_b4776dbf7001xBYl85ustm7FWc", | |
| "sessionID": "ses_4b8933352ffe2k7Q7VhaAWbJcB", | |
| "messageID": "msg_b4776cf4f001XNMjI44HGiIKPP", | |
| "type": "step-start" | |
| }, | |
| { | |
| "id": "prt_b4776dbfa001MYFA2Yd8DDpm2L", | |
| "sessionID": "ses_4b8933352ffe2k7Q7VhaAWbJcB", | |
| "messageID": "msg_b4776cf4f001XNMjI44HGiIKPP", | |
| "type": "tool", | |
| "callID": "toolu_01M3qzApQJv8KpGnGX8vxhR4", | |
| "tool": "todowrite", | |
| "state": { | |
| "status": "completed", | |
| "input": { | |
| "todos": [ | |
| { | |
| "id": "1", | |
| "content": "Create PRD.md for OpenCode Stats plugin", | |
| "status": "completed", | |
| "priority": "high" | |
| }, | |
| { | |
| "id": "2", | |
| "content": "Create ARCHITECTURE.md for OpenCode Stats plugin", | |
| "status": "completed", | |
| "priority": "high" | |
| } | |
| ] | |
| }, | |
| "output": "[\n {\n \"id\": \"1\",\n \"content\": \"Create PRD.md for OpenCode Stats plugin\",\n \"status\": \"completed\",\n \"priority\": \"high\"\n },\n {\n \"id\": \"2\",\n \"content\": \"Create ARCHITECTURE.md for OpenCode Stats plugin\",\n \"status\": \"completed\",\n \"priority\": \"high\"\n }\n]", | |
| "title": "0 todos", | |
| "metadata": { | |
| "todos": [ | |
| { | |
| "id": "1", | |
| "content": "Create PRD.md for OpenCode Stats plugin", | |
| "status": "completed", | |
| "priority": "high" | |
| }, | |
| { | |
| "id": "2", | |
| "content": "Create ARCHITECTURE.md for OpenCode Stats plugin", | |
| "status": "completed", | |
| "priority": "high" | |
| } | |
| ] | |
| }, | |
| "time": { | |
| "start": 1766430531863, | |
| "end": 1766430531864 | |
| } | |
| } | |
| }, | |
| { | |
| "id": "prt_b4776e134001qJZ8QAqyWlcYcY", | |
| "sessionID": "ses_4b8933352ffe2k7Q7VhaAWbJcB", | |
| "messageID": "msg_b4776cf4f001XNMjI44HGiIKPP", | |
| "type": "step-finish", | |
| "reason": "tool-calls", | |
| "cost": 0, | |
| "tokens": { | |
| "input": 1, | |
| "output": 120, | |
| "reasoning": 0, | |
| "cache": { | |
| "read": 16917, | |
| "write": 7309 | |
| } | |
| } | |
| } | |
| ] | |
| }, | |
| { | |
| "info": { | |
| "id": "msg_b4776e13a001Mx09gQ0Iz3TyOy", | |
| "sessionID": "ses_4b8933352ffe2k7Q7VhaAWbJcB", | |
| "role": "assistant", | |
| "time": { | |
| "created": 1766430531898, | |
| "completed": 1766430543759 | |
| }, | |
| "parentID": "msg_b476cccb1001BFC6DPHvzfGYdN", | |
| "modelID": "claude-opus-4-5", | |
| "providerID": "anthropic", | |
| "mode": "build", | |
| "agent": "build", | |
| "path": { | |
| "cwd": "/Users/themishkun/projects/tinkering/opencode-stats", | |
| "root": "/" | |
| }, | |
| "cost": 0, | |
| "tokens": { | |
| "input": 1, | |
| "output": 396, | |
| "reasoning": 0, | |
| "cache": { | |
| "read": 24226, | |
| "write": 228 | |
| } | |
| }, | |
| "finish": "stop" | |
| }, | |
| "parts": [ | |
| { | |
| "id": "prt_b4776eb2e001hLNPgt629EPTi7", | |
| "sessionID": "ses_4b8933352ffe2k7Q7VhaAWbJcB", | |
| "messageID": "msg_b4776e13a001Mx09gQ0Iz3TyOy", | |
| "type": "step-start" | |
| }, | |
| { | |
| "id": "prt_b4776eb2f001Yv8tsa0dFMaYL9", | |
| "sessionID": "ses_4b8933352ffe2k7Q7VhaAWbJcB", | |
| "messageID": "msg_b4776e13a001Mx09gQ0Iz3TyOy", | |
| "type": "text", | |
| "text": "Done! I've created both documents based on the plugin research:\n\n## Created Files\n\n### `PRD.md`\nProduct Requirements Document covering:\n- Vision: \"Spotify Wrapped\"-style stats for OpenCode\n- Core features: Activity heatmap, key statistics dashboard, model usage breakdown, fun comparisons\n- UI mockup matching your reference image (tabs for Overview/Models, heatmap, two-column stats, fun facts)\n- Technical requirements and performance targets\n- Timeline (4-week plan)\n- Success metrics and risks\n\n### `ARCHITECTURE.md`\nTechnical architecture document covering:\n- Plugin system architecture (async function pattern for OpenCode)\n- Component design: Data Layer, Stats Engine, Renderer, Command Handler\n- Full code structure with TypeScript interfaces and implementations for:\n - Session data provider\n - Streak calculator\n - Fun facts generator\n - Heatmap renderer\n - Dashboard component\n - Model usage bar charts\n- Data flow diagram\n- File structure\n- Dependencies (`zod` for schema validation)\n- Caching strategy\n- Testing approach\n\n## Key Plugin Findings\n\nFrom the research, OpenCode plugins:\n- Run in **Bun** runtime\n- Use **async function pattern** returning hooks\n- Can define **custom tools** with Zod schemas\n- Support **event listening** and **tool interception**\n- Are located in `.opencode/plugin/` (project) or `~/.config/opencode/plugin/` (global)\n\n## Next Steps\n\nThe subagent noted you should use **ghrep** to search for more implementation examples, particularly around:\n1. How to access the session list API in OpenCode\n2. How plugins render full-screen TUI views\n3. Token counting availability per message", | |
| "time": { | |
| "start": 1766430543731, | |
| "end": 1766430543731 | |
| } | |
| }, | |
| { | |
| "id": "prt_b47770f8e001qcI3Q5zZcI7Hq7", | |
| "sessionID": "ses_4b8933352ffe2k7Q7VhaAWbJcB", | |
| "messageID": "msg_b4776e13a001Mx09gQ0Iz3TyOy", | |
| "type": "step-finish", | |
| "reason": "stop", | |
| "cost": 0, | |
| "tokens": { | |
| "input": 1, | |
| "output": 396, | |
| "reasoning": 0, | |
| "cache": { | |
| "read": 24226, | |
| "write": 228 | |
| } | |
| } | |
| } | |
| ] | |
| }, | |
| { | |
| "info": { | |
| "id": "msg_b477d454e001fO26VMVZnZN1NO", | |
| "sessionID": "ses_4b8933352ffe2k7Q7VhaAWbJcB", | |
| "role": "user", | |
| "time": { | |
| "created": 1766430950742 | |
| }, | |
| "summary": { | |
| "title": "Launching subagent for architecture questions", | |
| "diffs": [] | |
| }, | |
| "agent": "build", | |
| "model": { | |
| "providerID": "anthropic", | |
| "modelID": "claude-opus-4-5" | |
| } | |
| }, | |
| "parts": [ | |
| { | |
| "id": "prt_b477d454f001vbd3Q54uMQRyvg", | |
| "sessionID": "ses_4b8933352ffe2k7Q7VhaAWbJcB", | |
| "messageID": "msg_b477d454e001fO26VMVZnZN1NO", | |
| "type": "text", | |
| "text": "launch subagent to find out answers to open questions in architecture" | |
| } | |
| ] | |
| }, | |
| { | |
| "info": { | |
| "id": "msg_b477d4561001TCjjjlX5HkSv8z", | |
| "sessionID": "ses_4b8933352ffe2k7Q7VhaAWbJcB", | |
| "role": "assistant", | |
| "time": { | |
| "created": 1766430950753, | |
| "completed": 1766431228083 | |
| }, | |
| "parentID": "msg_b477d454e001fO26VMVZnZN1NO", | |
| "modelID": "claude-opus-4-5", | |
| "providerID": "anthropic", | |
| "mode": "build", | |
| "agent": "build", | |
| "path": { | |
| "cwd": "/Users/themishkun/projects/tinkering/opencode-stats", | |
| "root": "/" | |
| }, | |
| "cost": 0, | |
| "tokens": { | |
| "input": 3, | |
| "output": 475, | |
| "reasoning": 0, | |
| "cache": { | |
| "read": 0, | |
| "write": 24864 | |
| } | |
| }, | |
| "finish": "tool-calls" | |
| }, | |
| "parts": [ | |
| { | |
| "id": "prt_b477d520b001qdJjJWx46sI23a", | |
| "sessionID": "ses_4b8933352ffe2k7Q7VhaAWbJcB", | |
| "messageID": "msg_b477d4561001TCjjjlX5HkSv8z", | |
| "type": "step-start" | |
| }, | |
| { | |
| "id": "prt_b477d5313001x4BJ0sLvyIhEd2", | |
| "sessionID": "ses_4b8933352ffe2k7Q7VhaAWbJcB", | |
| "messageID": "msg_b477d4561001TCjjjlX5HkSv8z", | |
| "type": "tool", | |
| "callID": "toolu_011TQrqmAqhQCwqc1aNcxXu6", | |
| "tool": "task", | |
| "state": { | |
| "status": "completed", | |
| "input": { | |
| "description": "Research OpenCode session API", | |
| "prompt": "Research how to access OpenCode session data and answer these open questions for building an OpenCode stats plugin:\n\n## Questions to Answer\n\n### 1. Session Data Access\n- How does OpenCode expose session list to plugins?\n- Is there a direct API or do we need to use events?\n- What's the schema of session/message data?\n- Where is session data stored (SQLite, JSON, etc.)?\n\n### 2. Rendering\n- Can plugins render full-screen TUI views?\n- How do we handle keyboard input (tab to switch views)?\n- Is there a blessed/ink integration or raw terminal output?\n- How do custom tools display their output?\n\n### 3. Token Counting\n- Is token count available per message in OpenCode?\n- If not, how can we estimate it?\n- What metadata is stored per message?\n\n### 4. Plugin Lifecycle\n- When is the plugin loaded/unloaded?\n- Can we persist cache between sessions?\n- What context is available to plugins?\n\n## Research Instructions\n\n1. Use ghrep to search GitHub for:\n - \"opencode session\" in sst/opencode repository\n - \"opencode plugin\" examples\n - OpenCode database schema\n - OpenCode message types\n\n2. Fetch these URLs if helpful:\n - https://github.com/sst/opencode - main repo, look at src/\n - Any plugin examples you find\n\n3. Look for:\n - TypeScript interfaces for Session, Message\n - Database/storage implementation\n - Plugin context type definitions\n - Tool execution and output handling\n\nReturn a detailed summary of your findings with code examples where possible. Include specific file paths and line numbers from the OpenCode source code.", | |
| "subagent_type": "docs" | |
| }, | |
| "output": "Perfect! Let me create one final index file:\n\n## Summary\n\nI've completed comprehensive research on how to build an OpenCode stats plugin and answered all 4 of your questions. Here's what I've created:\n\n### **📋 All 4 Questions Answered:**\n\n1. **Session Data Access** ✅\n - SDK Client API: `sdk.client.session.list()`, `sdk.client.session.messages()`\n - Storage API: Direct JSON file access\n - Event System: Real-time updates via `sdk.event.listen()`\n - Storage: `~/.opencode/storage/` (JSON files)\n\n2. **Rendering** ✅\n - Full-screen TUI: Yes, via `@opentui/solid` framework\n - Keyboard Input: `useKeyboard()` hook\n - Dialog Components: Alert, Confirm, Prompt, Select\n - Tab Switching: Possible with keyboard handlers\n\n3. **Token Counting** ✅\n - Available: Yes, in `message.info.tokens` per message\n - Includes: input, output, reasoning, cache.read, cache.write\n - Cost: Also in `message.info.cost`\n - No estimation needed\n\n4. **Plugin Lifecycle** ✅\n - Context-based dependency injection\n - Persistence via `persisted()` utility\n - Event system for real-time updates\n - Multiple integration points (CLI, TUI, Desktop)\n\n### **📚 Documentation Created (14 files, ~170 KB):**\n\n**Core Documents:**\n- **README.md** - Overview & quick start\n- **QUICK_REFERENCE.md** - Direct answers to your questions\n- **RESEARCH_FINDINGS.md** - Deep technical details (26 KB)\n- **IMPLEMENTATION_EXAMPLES.md** - 5 production-ready code examples\n\n**Supporting Documents:**\n- RESEARCH_INDEX.md, ARCHITECTURE.md, PLUGIN_ARCHITECTURE_TEMPLATE.md, PRD.md, and more\n\nAll files are in `/Users/themishkun/projects/tinkering/opencode-stats/`\n\n<task_metadata>\nsession_id: ses_4b8828fcaffeg6IqpgtSd9jVlY\n</task_metadata>", | |
| "title": "Research OpenCode session API", | |
| "metadata": { | |
| "summary": [ | |
| { | |
| "id": "prt_b477d7750001nWdDIPf5cC3DHv", | |
| "tool": "gh_grep_searchGitHub", | |
| "state": { | |
| "status": "completed", | |
| "title": "" | |
| } | |
| }, | |
| { | |
| "id": "prt_b477d78e7001IUS3p1AoSYjBQC", | |
| "tool": "gh_grep_searchGitHub", | |
| "state": { | |
| "status": "completed", | |
| "title": "" | |
| } | |
| }, | |
| { | |
| "id": "prt_b477d7a06001F1bskPjqH95X25", | |
| "tool": "gh_grep_searchGitHub", | |
| "state": { | |
| "status": "completed", | |
| "title": "" | |
| } | |
| }, | |
| { | |
| "id": "prt_b477d7b43001IP1meTer21i0GF", | |
| "tool": "gh_grep_searchGitHub", | |
| "state": { | |
| "status": "completed", | |
| "title": "" | |
| } | |
| }, | |
| { | |
| "id": "prt_b477d871a001XUgaeT9rrtJqwZ", | |
| "tool": "gh_grep_searchGitHub", | |
| "state": { | |
| "status": "completed", | |
| "title": "" | |
| } | |
| }, | |
| { | |
| "id": "prt_b477d88e3001qcRPunBl7Gdy7y", | |
| "tool": "gh_grep_searchGitHub", | |
| "state": { | |
| "status": "completed", | |
| "title": "" | |
| } | |
| }, | |
| { | |
| "id": "prt_b477d89fe001stJ3bdTPnmyMvP", | |
| "tool": "gh_grep_searchGitHub", | |
| "state": { | |
| "status": "completed", | |
| "title": "" | |
| } | |
| }, | |
| { | |
| "id": "prt_b477d8b34001su64qOv6SQYZ0Z", | |
| "tool": "gh_grep_searchGitHub", | |
| "state": { | |
| "status": "completed", | |
| "title": "" | |
| } | |
| }, | |
| { | |
| "id": "prt_b477d93f6001rkAiMnwRjyP8So", | |
| "tool": "gh_grep_searchGitHub", | |
| "state": { | |
| "status": "completed", | |
| "title": "" | |
| } | |
| }, | |
| { | |
| "id": "prt_b477d952e001dr2B53NAhIz17S", | |
| "tool": "gh_grep_searchGitHub", | |
| "state": { | |
| "status": "completed", | |
| "title": "" | |
| } | |
| }, | |
| { | |
| "id": "prt_b477d967a001kDX537VuFxWEQi", | |
| "tool": "gh_grep_searchGitHub", | |
| "state": { | |
| "status": "completed", | |
| "title": "" | |
| } | |
| }, | |
| { | |
| "id": "prt_b477d97b5001Z7BprlYWF0Rqy4", | |
| "tool": "gh_grep_searchGitHub", | |
| "state": { | |
| "status": "completed", | |
| "title": "" | |
| } | |
| }, | |
| { | |
| "id": "prt_b477da280001daaGj9pela2omH", | |
| "tool": "gh_grep_searchGitHub", | |
| "state": { | |
| "status": "completed", | |
| "title": "" | |
| } | |
| }, | |
| { | |
| "id": "prt_b477da4220018jk62OeGj4tpu1", | |
| "tool": "gh_grep_searchGitHub", | |
| "state": { | |
| "status": "completed", | |
| "title": "" | |
| } | |
| }, | |
| { | |
| "id": "prt_b477da5870013sMdmf1GTIWU1I", | |
| "tool": "gh_grep_searchGitHub", | |
| "state": { | |
| "status": "completed", | |
| "title": "" | |
| } | |
| }, | |
| { | |
| "id": "prt_b477da760001kC80HJOv8EisHc", | |
| "tool": "gh_grep_searchGitHub", | |
| "state": { | |
| "status": "completed", | |
| "title": "" | |
| } | |
| }, | |
| { | |
| "id": "prt_b477db2bc001sjwH3E68jiF9CS", | |
| "tool": "gh_grep_searchGitHub", | |
| "state": { | |
| "status": "completed", | |
| "title": "" | |
| } | |
| }, | |
| { | |
| "id": "prt_b477db49d001OhHAfLojwJQF3C", | |
| "tool": "gh_grep_searchGitHub", | |
| "state": { | |
| "status": "completed", | |
| "title": "" | |
| } | |
| }, | |
| { | |
| "id": "prt_b477db61f00199mzvbnSZ6ixbe", | |
| "tool": "gh_grep_searchGitHub", | |
| "state": { | |
| "status": "completed", | |
| "title": "" | |
| } | |
| }, | |
| { | |
| "id": "prt_b477db810001TYg9W066oUbPig", | |
| "tool": "gh_grep_searchGitHub", | |
| "state": { | |
| "status": "completed", | |
| "title": "" | |
| } | |
| }, | |
| { | |
| "id": "prt_b477dc595001eGz9l7ESBmD0he", | |
| "tool": "gh_grep_searchGitHub", | |
| "state": { | |
| "status": "completed", | |
| "title": "" | |
| } | |
| }, | |
| { | |
| "id": "prt_b477dc74f0017ZXNPTznDVByM3", | |
| "tool": "gh_grep_searchGitHub", | |
| "state": { | |
| "status": "completed", | |
| "title": "" | |
| } | |
| }, | |
| { | |
| "id": "prt_b477dc940001Hl0KU6aQZNuuUI", | |
| "tool": "gh_grep_searchGitHub", | |
| "state": { | |
| "status": "completed", | |
| "title": "" | |
| } | |
| }, | |
| { | |
| "id": "prt_b477dca9b001g6ZtyoyFDF86iA", | |
| "tool": "gh_grep_searchGitHub", | |
| "state": { | |
| "status": "completed", | |
| "title": "" | |
| } | |
| }, | |
| { | |
| "id": "prt_b477dd639001YSSa3wdj4sigTy", | |
| "tool": "webfetch", | |
| "state": { | |
| "status": "completed", | |
| "title": "https://github.com/sst/opencode/blob/dev/packages/opencode/src/cli/cmd/stats.ts (text/html; charset=utf-8)" | |
| } | |
| }, | |
| { | |
| "id": "prt_b477dd7ac001EFm8seiIG2guhj", | |
| "tool": "bash", | |
| "state": { | |
| "status": "completed", | |
| "title": "Fetch OpenCode SDK session interface" | |
| } | |
| }, | |
| { | |
| "id": "prt_b477de3b8001XJxiU4fwWZy8wG", | |
| "tool": "bash", | |
| "state": { | |
| "status": "completed", | |
| "title": "Fetch the stats command implementation" | |
| } | |
| }, | |
| { | |
| "id": "prt_b477deea0001uDt2Vkz7DKGRqn", | |
| "tool": "bash", | |
| "state": { | |
| "status": "error" | |
| } | |
| }, | |
| { | |
| "id": "prt_b477df099001jhwS521mnOX4en", | |
| "tool": "bash", | |
| "state": { | |
| "status": "completed", | |
| "title": "Fetch Storage class implementation" | |
| } | |
| }, | |
| { | |
| "id": "prt_b477df9ed001dWP0983e5Kkxmp", | |
| "tool": "bash", | |
| "state": { | |
| "status": "completed", | |
| "title": "Fetch Storage class read/write methods" | |
| } | |
| }, | |
| { | |
| "id": "prt_b477e04d2001Cbzy5DLW5d6Hv3", | |
| "tool": "write", | |
| "state": { | |
| "status": "completed", | |
| "title": "Users/themishkun/projects/tinkering/opencode-stats/RESEARCH_FINDINGS.md" | |
| } | |
| }, | |
| { | |
| "id": "prt_b477ee660001xf4Vvc6nMedfJp", | |
| "tool": "write", | |
| "state": { | |
| "status": "completed", | |
| "title": "Users/themishkun/projects/tinkering/opencode-stats/QUICK_REFERENCE.md" | |
| } | |
| }, | |
| { | |
| "id": "prt_b477f3d2d001SNxS5Nf5OsFp3J", | |
| "tool": "write", | |
| "state": { | |
| "status": "completed", | |
| "title": "Users/themishkun/projects/tinkering/opencode-stats/IMPLEMENTATION_EXAMPLES.md" | |
| } | |
| }, | |
| { | |
| "id": "prt_b477fd8ef0010O3X9sQRvt4TFR", | |
| "tool": "bash", | |
| "state": { | |
| "status": "completed", | |
| "title": "Create comprehensive README" | |
| } | |
| }, | |
| { | |
| "id": "prt_b478029e3001DOQB0RRkNwY7Lm", | |
| "tool": "bash", | |
| "state": { | |
| "status": "completed", | |
| "title": "List all created documentation files" | |
| } | |
| }, | |
| { | |
| "id": "prt_b4780391e001J5rwVVbaefTve6", | |
| "tool": "bash", | |
| "state": { | |
| "status": "completed", | |
| "title": "Create comprehensive research index" | |
| } | |
| }, | |
| { | |
| "id": "prt_b4780a70f001El50iu7NESluLk", | |
| "tool": "bash", | |
| "state": { | |
| "status": "completed", | |
| "title": "Create final summary document" | |
| } | |
| }, | |
| { | |
| "id": "prt_b478103aa001U11MXkqz7BPo5d", | |
| "tool": "bash", | |
| "state": { | |
| "status": "completed", | |
| "title": "List all documentation files with sizes" | |
| } | |
| }, | |
| { | |
| "id": "prt_b478112970015tiEW1VAAZe7es", | |
| "tool": "bash", | |
| "state": { | |
| "status": "completed", | |
| "title": "Display final research summary" | |
| } | |
| } | |
| ], | |
| "sessionId": "ses_4b8828fcaffeg6IqpgtSd9jVlY" | |
| }, | |
| "time": { | |
| "start": 1766430961718, | |
| "end": 1766431228079 | |
| } | |
| } | |
| }, | |
| { | |
| "id": "prt_b478180b0001aO7rLajLT7oyg1", | |
| "sessionID": "ses_4b8933352ffe2k7Q7VhaAWbJcB", | |
| "messageID": "msg_b477d4561001TCjjjlX5HkSv8z", | |
| "type": "step-finish", | |
| "reason": "tool-calls", | |
| "cost": 0, | |
| "tokens": { | |
| "input": 3, | |
| "output": 475, | |
| "reasoning": 0, | |
| "cache": { | |
| "read": 0, | |
| "write": 24864 | |
| } | |
| } | |
| } | |
| ] | |
| }, | |
| { | |
| "info": { | |
| "id": "msg_b478180bb001m0d1rEulxv1xp2", | |
| "sessionID": "ses_4b8933352ffe2k7Q7VhaAWbJcB", | |
| "role": "assistant", | |
| "time": { | |
| "created": 1766431228091, | |
| "completed": 1766431237433 | |
| }, | |
| "parentID": "msg_b477d454e001fO26VMVZnZN1NO", | |
| "modelID": "claude-opus-4-5", | |
| "providerID": "anthropic", | |
| "mode": "build", | |
| "agent": "build", | |
| "path": { | |
| "cwd": "/Users/themishkun/projects/tinkering/opencode-stats", | |
| "root": "/" | |
| }, | |
| "cost": 0, | |
| "tokens": { | |
| "input": 1, | |
| "output": 492, | |
| "reasoning": 0, | |
| "cache": { | |
| "read": 24864, | |
| "write": 1020 | |
| } | |
| }, | |
| "finish": "stop" | |
| }, | |
| "parts": [ | |
| { | |
| "id": "prt_b47818bdb001RB6RLF0l3ZkoPv", | |
| "sessionID": "ses_4b8933352ffe2k7Q7VhaAWbJcB", | |
| "messageID": "msg_b478180bb001m0d1rEulxv1xp2", | |
| "type": "step-start" | |
| }, | |
| { | |
| "id": "prt_b47818bdf0012w12kLy5pPkeAa", | |
| "sessionID": "ses_4b8933352ffe2k7Q7VhaAWbJcB", | |
| "messageID": "msg_b478180bb001m0d1rEulxv1xp2", | |
| "type": "text", | |
| "text": "The subagent has answered all the open questions. Here's a summary of the key findings:\n\n## Answers to Open Questions\n\n### 1. Session Data Access\n- **SDK Client API:** `sdk.client.session.list()`, `sdk.client.session.messages(sessionId)`\n- **Storage Location:** `~/.opencode/storage/` (JSON files)\n- **Real-time Updates:** `sdk.event.listen()` for events like `session.created`, `message.created`\n- **Schema:** Sessions and messages are stored as JSON with full metadata\n\n### 2. Rendering\n- **Full-screen TUI:** Yes, via `@opentui/solid` framework (OpenCode's TUI library)\n- **Keyboard Input:** `useKeyboard()` hook for handling key presses\n- **Dialog Components:** Built-in Alert, Confirm, Prompt, Select dialogs\n- **Tab Switching:** Achievable via keyboard event handlers\n\n### 3. Token Counting\n- **Available:** Yes! Token count is in `message.info.tokens` per message\n- **Includes:** `input`, `output`, `reasoning`, `cache.read`, `cache.write`\n- **Cost:** Also available in `message.info.cost`\n- **No estimation needed** - OpenCode tracks this natively\n\n### 4. Plugin Lifecycle\n- **Context-based:** Dependency injection via plugin context\n- **Persistence:** `persisted()` utility for caching between sessions\n- **Event System:** Real-time updates available\n- **Integration Points:** CLI, TUI, and Desktop app\n\n## Key Code Patterns\n\n```typescript\n// Access sessions\nconst sessions = await sdk.client.session.list();\nconst messages = await sdk.client.session.messages(sessionId);\n\n// Token info per message\nconst tokens = message.info.tokens; // { input, output, reasoning, cache }\n\n// Listen for real-time updates\nsdk.event.listen(\"message.created\", (msg) => { /* update stats */ });\n```\n\nThe subagent created additional documentation files with implementation examples. Would you like me to update the ARCHITECTURE.md with these concrete findings?", | |
| "time": { | |
| "start": 1766431237384, | |
| "end": 1766431237384 | |
| } | |
| }, | |
| { | |
| "id": "prt_b4781a52a0016uc8DW43o9te0h", | |
| "sessionID": "ses_4b8933352ffe2k7Q7VhaAWbJcB", | |
| "messageID": "msg_b478180bb001m0d1rEulxv1xp2", | |
| "type": "step-finish", | |
| "reason": "stop", | |
| "cost": 0, | |
| "tokens": { | |
| "input": 1, | |
| "output": 492, | |
| "reasoning": 0, | |
| "cache": { | |
| "read": 24864, | |
| "write": 1020 | |
| } | |
| } | |
| } | |
| ] | |
| }, | |
| { | |
| "info": { | |
| "id": "msg_b4782c46a001rP2W0KPoAqISMd", | |
| "sessionID": "ses_4b8933352ffe2k7Q7VhaAWbJcB", | |
| "role": "user", | |
| "time": { | |
| "created": 1766431310959 | |
| }, | |
| "summary": { | |
| "title": "Hooks definition reference", | |
| "diffs": [] | |
| }, | |
| "agent": "build", | |
| "model": { | |
| "providerID": "anthropic", | |
| "modelID": "claude-opus-4-5" | |
| } | |
| }, | |
| "parts": [ | |
| { | |
| "id": "prt_b4782c46a002xIPQxAyrVnR1pl", | |
| "sessionID": "ses_4b8933352ffe2k7Q7VhaAWbJcB", | |
| "messageID": "msg_b4782c46a001rP2W0KPoAqISMd", | |
| "type": "text", | |
| "text": "here is hooks definition https://github.com/sst/opencode/blob/1b1b73b5b317bb190e994506b8e3b57b07a685cb/packages/plugin/src/index.ts" | |
| } | |
| ] | |
| }, | |
| { | |
| "info": { | |
| "id": "msg_b4782c47e001yAsPIgb6IFoktV", | |
| "sessionID": "ses_4b8933352ffe2k7Q7VhaAWbJcB", | |
| "role": "assistant", | |
| "time": { | |
| "created": 1766431310974, | |
| "completed": 1766431315197 | |
| }, | |
| "parentID": "msg_b4782c46a001rP2W0KPoAqISMd", | |
| "modelID": "claude-opus-4-5", | |
| "providerID": "anthropic", | |
| "mode": "build", | |
| "agent": "build", | |
| "path": { | |
| "cwd": "/Users/themishkun/projects/tinkering/opencode-stats", | |
| "root": "/" | |
| }, | |
| "cost": 0, | |
| "tokens": { | |
| "input": 3, | |
| "output": 118, | |
| "reasoning": 0, | |
| "cache": { | |
| "read": 25884, | |
| "write": 546 | |
| } | |
| }, | |
| "finish": "tool-calls" | |
| }, | |
| "parts": [ | |
| { | |
| "id": "prt_b4782cee5001gCnYQpNEOkNknO", | |
| "sessionID": "ses_4b8933352ffe2k7Q7VhaAWbJcB", | |
| "messageID": "msg_b4782c47e001yAsPIgb6IFoktV", | |
| "type": "step-start" | |
| }, | |
| { | |
| "id": "prt_b4782d063001EeDlRIX6ej4cNm", | |
| "sessionID": "ses_4b8933352ffe2k7Q7VhaAWbJcB", | |
| "messageID": "msg_b4782c47e001yAsPIgb6IFoktV", | |
| "type": "tool", | |
| "callID": "toolu_01LgL67bvMLnh78dVdZpZ5Xr", | |
| "tool": "webfetch", | |
| "state": { | |
| "status": "completed", | |
| "input": { | |
| "url": "https://github.com/sst/opencode/blob/1b1b73b5b317bb190e994506b8e3b57b07a685cb/packages/plugin/src/index.ts", | |
| "format": "text" | |
| }, | |
| "output": "opencode/packages/plugin/src/index.ts at 1b1b73b5b317bb190e994506b8e3b57b07a685cb · sst/opencode · GitHub\n\n\n\n \n \n \n \n\n \n \n\n\n \n\n\n \n\n\n \n \n\n \n \n\n \n\n\n\n \n\n \n\n\n\n\n \n\n \n\n \n\n \n\n \n\n \n\n \n \n \n\n \n \n \n\n\n\n\n \n\n\n\n \n\n\n \n \n \n \n\n \n\n \n\n \n\n \n\n \n\n\n\n \n\n \n \n\n\n \n\n \n\n \n \n\n \n \n \n\n\n\n\n\n \n\n \n\n \n \n \n \n\n\n\n \n Skip to content\n\n \n \n \n \n \n\n\n\n \n \n\n\n\n\n\n\n \n\n \n\n \n\n Navigation Menu\n\n \n Toggle navigation\n \n\n \n \n \n \n \n \n \n \n\n \n\n \n \n \n\n \n\n \n \n Sign in\n \n \n \n \n \n\nAppearance settings\n\n \n \n\n\n\n \n \n\n\n\n \n \n \n\n \n \n\n\n \n \n \n\n\n\n \n PlatformAI CODE CREATIONGitHub CopilotWrite better code with AIGitHub SparkBuild and deploy intelligent appsGitHub ModelsManage and compare promptsMCP RegistryNewIntegrate external toolsDEVELOPER WORKFLOWSActionsAutomate any workflowCodespacesInstant dev environmentsIssuesPlan and track workCode ReviewManage code changesAPPLICATION SECURITYGitHub Advanced SecurityFind and fix vulnerabilitiesCode securitySecure your code as you buildSecret protectionStop leaks before they startEXPLOREWhy GitHubDocumentationBlogChangelogMarketplaceView all featuresSolutionsBY COMPANY SIZEEnterprisesSmall and medium teamsStartupsNonprofitsBY USE CASEApp ModernizationDevSecOpsDevOpsCI/CDView all use casesBY INDUSTRYHealthcareFinancial servicesManufacturingGovernmentView all industriesView all solutionsResourcesEXPLORE BY TOPICAISoftware DevelopmentDevOpsSecurityView all topicsEXPLORE BY TYPECustomer storiesEvents & webinarsEbooks & reportsBusiness insightsGitHub SkillsSUPPORT & SERVICESDocumentationCustomer supportCommunity forumTrust centerPartnersOpen SourceCOMMUNITYGitHub SponsorsFund open source developersPROGRAMSSecurity LabMaintainer CommunityAcceleratorArchive ProgramREPOSITORIESTopicsTrendingCollectionsEnterpriseENTERPRISE SOLUTIONSEnterprise platformAI-powered developer platformAVAILABLE ADD-ONSGitHub Advanced SecurityEnterprise-grade security featuresCopilot for BusinessEnterprise-grade AI featuresPremium SupportEnterprise-grade 24/7 supportPricing\n \n\n\n\n \n \n \n \n \n\n \n Search or jump to...\n \n \n \n \n\n \n\n \n\n \n Search code, repositories, users, issues, pull requests...\n \n \n \n \n \n \n \n Search\n \n \n \n \n \n\n \n \n \n \n \n \n \n \n Clear\n \n \n\n\n\n \n \n \n \n\n\n\n\n \n \n\n\n\n\n \n \n\n\n\n\n \n \n\n\n\n\n \n \n\n\n\n\n \n \n\n\n\n\n \n \n\n\n\n\n \n \n\n\n\n\n \n \n\n\n\n\n \n \n\n\n\n\n \n \n\n\n\n\n \n \n\n\n\n\n \n \n\n\n\n\n \n \n\n\n\n\n \n \n\n\n\n\n \n \n\n\n\n\n \n \n\n\n\n\n \n \n\n\n\n\n \n \n\n\n\n\n \n \n\n\n\n\n \n \n\n\n\n\n \n \n\n\n\n\n \n \n\n\n\n\n \n \n\n\n\n\n \n \n\n\n\n\n \n \n\n\n\n\n \n \n\n\n\n\n \n \n\n\n\n\n \n \n\n\n\n\n \n \n\n\n\n\n \n \n\n\n\n\n \n \n\n\n\n\n \n \n\n\n\n\n \n \n\n\n\n \n \n \n \n \n \n \n\n \n \n \n \n\n \n Search syntax tips \n \n \n\n\n \n\n \n \n \n \n\n \n \n \n \n \n Provide feedback\n \n \n \n \n \n \n\n \n \n \n\n \n \n We read every piece of feedback, and take your input very seriously.\n \n \n Include my email address so I can be contacted\n\n \n Cancel\n\n Submit feedback\n\n\n\n\n \n \n\n \n \n \n \n \n Saved searches\n \n Use saved searches to filter your results more quickly\n \n \n \n \n\n \n \n \n\n \n \n\n \n \n \n\n \n\n \n Name\n \n \n \n \n \n\n \n Query\n \n \n\n \n To see all available qualifiers, see our documentation.\n \n \n\n \n \n \n\n\n \n Cancel\n\n Create saved search\n\n\n\n \n \n\n\n\n \n \n Sign in\n \n \n\n \n Sign up\n \n\n \n \n \n \n\nAppearance settings\n\n \n \n\n\n\n \n \n\n\n\n \n \n \n\n Resetting focus\n \n \n \n \n\n\n \n \n \n \n\n You signed in with another tab or window. Reload to refresh your session.\n You signed out in another tab or window. Reload to refresh your session.\n You switched accounts on another tab or window. Reload to refresh your session.\n\n \n \n\nDismiss alert\n\n\n \n\n \n\n \n\n\n\n\n\n\n\n\n \n\n\n\n\n \n \n\n \n \n \n \n\n \n \n \n {{ message }}\n\n \n \n\n \n\n\n\n \n\n\n\n\n\n\n \n \n \n \n \n \n\n \n\n\n\n\n\n\n \n\n \n\n \n\n \n \n \n \n \n\n \n \n \n sst\n \n /\n \n opencode\n \n\n Public\n \n\n\n \n\n \n \n \n \n\n \n \n \nNotifications\n You must be signed in to change notification settings\n\n \n\n \n \n \nFork\n 3.5k\n\n \n\n \n \n \n \n\n Star\n 41.1k\n\n \n\n\n\n \n \n\n \n\n\n\n \n\n \n \n \n \n \n \n\n Code\n \n\n\n \n\n \n \n \n \n \n\n Issues\n 1.5k\n\n\n \n\n \n \n \n \n \n\n Pull requests\n 455\n\n\n \n\n \n \n \n \n \n\n Actions\n \n\n\n \n\n \n \n \n \n \n\n Projects\n 0\n\n\n \n\n \n \n \n \n \n\n Security\n \n \n \n \n \n \n \n\n Uh oh!\n\n There was an error while loading. Please reload this page.\n\n\n \n \n\n\n \n\n \n \n \n \n \n\n Insights\n \n\n\n \n\n\n \n \n \n \n\nAdditional navigation options\n\n\n\n \n \n \n \n \n \n \n \n \n \n \n \n\n \n \n \n Code\n \n\n \n\n \n \n \n \n \n \n \n\n \n \n \n Issues\n \n\n \n\n \n \n \n \n \n \n \n\n \n \n \n Pull requests\n \n\n \n\n \n \n \n \n \n \n \n\n \n \n \n Actions\n \n\n \n\n \n \n \n \n \n \n \n\n \n \n \n Projects\n \n\n \n\n \n \n \n \n \n \n \n\n \n \n \n Security\n \n\n \n\n \n \n \n \n \n \n \n\n \n \n \n Insights\n \n\n \n\n \n\n\n\n\n \n \n\n\n\n \n \n\n\n\n\n \n \n\n\n\n \n \n \n\n\n\n\n\n\n\n\n\n \n \n\n\n\n\n\n \n\n\n\n \n \n\n \n\n \n Footer\n\n \n\n\n \n \n \n \n \n\n\n \n © 2025 GitHub, Inc.\n \n \n\n \n Footer navigation\n\n \n\n \n Terms\n \n\n \n Privacy\n \n\n \n Security\n \n\n \n Status\n \n\n \n Community\n \n\n \n Docs\n \n\n \n Contact\n \n\n \n \n \n Manage cookies\n \n \n\n\n\n \n \n Do not share my personal information\n \n \n\n\n \n \n \n\n\n\n\n \n\n\n\n\n \n \n \n\n \n \n \n\n \n You can’t perform that action at this time.", | |
| "title": "https://github.com/sst/opencode/blob/1b1b73b5b317bb190e994506b8e3b57b07a685cb/packages/plugin/src/index.ts (text/html; charset=utf-8)", | |
| "metadata": {}, | |
| "time": { | |
| "start": 1766431314613, | |
| "end": 1766431315194 | |
| } | |
| } | |
| }, | |
| { | |
| "id": "prt_b4782d4fb001zZYCOWUKhu7S9S", | |
| "sessionID": "ses_4b8933352ffe2k7Q7VhaAWbJcB", | |
| "messageID": "msg_b4782c47e001yAsPIgb6IFoktV", | |
| "type": "step-finish", | |
| "reason": "tool-calls", | |
| "cost": 0, | |
| "tokens": { | |
| "input": 3, | |
| "output": 118, | |
| "reasoning": 0, | |
| "cache": { | |
| "read": 25884, | |
| "write": 546 | |
| } | |
| } | |
| } | |
| ] | |
| }, | |
| { | |
| "info": { | |
| "id": "msg_b4782d5020018uZpNl6um94qFd", | |
| "sessionID": "ses_4b8933352ffe2k7Q7VhaAWbJcB", | |
| "role": "assistant", | |
| "time": { | |
| "created": 1766431315202, | |
| "completed": 1766431319755 | |
| }, | |
| "parentID": "msg_b4782c46a001rP2W0KPoAqISMd", | |
| "modelID": "claude-opus-4-5", | |
| "providerID": "anthropic", | |
| "mode": "build", | |
| "agent": "build", | |
| "path": { | |
| "cwd": "/Users/themishkun/projects/tinkering/opencode-stats", | |
| "root": "/" | |
| }, | |
| "cost": 0, | |
| "tokens": { | |
| "input": 1, | |
| "output": 139, | |
| "reasoning": 0, | |
| "cache": { | |
| "read": 26430, | |
| "write": 2267 | |
| } | |
| }, | |
| "finish": "tool-calls" | |
| }, | |
| "parts": [ | |
| { | |
| "id": "prt_b4782dfa0001GL77K5z35imlcX", | |
| "sessionID": "ses_4b8933352ffe2k7Q7VhaAWbJcB", | |
| "messageID": "msg_b4782d5020018uZpNl6um94qFd", | |
| "type": "step-start" | |
| }, | |
| { | |
| "id": "prt_b4782dfa5001aR0JhAvJ2qHrB7", | |
| "sessionID": "ses_4b8933352ffe2k7Q7VhaAWbJcB", | |
| "messageID": "msg_b4782d5020018uZpNl6um94qFd", | |
| "type": "text", | |
| "text": "The GitHub page didn't render the code content. Let me try fetching the raw file directly:", | |
| "time": { | |
| "start": 1766431318752, | |
| "end": 1766431318752 | |
| } | |
| }, | |
| { | |
| "id": "prt_b4782e2e0001hHzgs17iAFwI8y", | |
| "sessionID": "ses_4b8933352ffe2k7Q7VhaAWbJcB", | |
| "messageID": "msg_b4782d5020018uZpNl6um94qFd", | |
| "type": "tool", | |
| "callID": "toolu_01QoHR6qgxuAaLygiy5hLDfK", | |
| "tool": "webfetch", | |
| "state": { | |
| "status": "completed", | |
| "input": { | |
| "url": "https://raw.githubusercontent.com/sst/opencode/1b1b73b5b317bb190e994506b8e3b57b07a685cb/packages/plugin/src/index.ts", | |
| "format": "text" | |
| }, | |
| "output": "import type {\n Event,\n createOpencodeClient,\n Project,\n Model,\n Provider,\n Permission,\n UserMessage,\n Message,\n Part,\n Auth,\n Config,\n} from \"@opencode-ai/sdk\"\n\nimport type { BunShell } from \"./shell\"\nimport { type ToolDefinition } from \"./tool\"\n\nexport * from \"./tool\"\n\nexport type ProviderContext = {\n source: \"env\" | \"config\" | \"custom\" | \"api\"\n info: Provider\n options: Record<string, any>\n}\n\nexport type PluginInput = {\n client: ReturnType<typeof createOpencodeClient>\n project: Project\n directory: string\n worktree: string\n $: BunShell\n}\n\nexport type Plugin = (input: PluginInput) => Promise<Hooks>\n\nexport type AuthHook = {\n provider: string\n loader?: (auth: () => Promise<Auth>, provider: Provider) => Promise<Record<string, any>>\n methods: (\n | {\n type: \"oauth\"\n label: string\n prompts?: Array<\n | {\n type: \"text\"\n key: string\n message: string\n placeholder?: string\n validate?: (value: string) => string | undefined\n condition?: (inputs: Record<string, string>) => boolean\n }\n | {\n type: \"select\"\n key: string\n message: string\n options: Array<{\n label: string\n value: string\n hint?: string\n }>\n condition?: (inputs: Record<string, string>) => boolean\n }\n >\n authorize(inputs?: Record<string, string>): Promise<AuthOuathResult>\n }\n | {\n type: \"api\"\n label: string\n prompts?: Array<\n | {\n type: \"text\"\n key: string\n message: string\n placeholder?: string\n validate?: (value: string) => string | undefined\n condition?: (inputs: Record<string, string>) => boolean\n }\n | {\n type: \"select\"\n key: string\n message: string\n options: Array<{\n label: string\n value: string\n hint?: string\n }>\n condition?: (inputs: Record<string, string>) => boolean\n }\n >\n authorize?(inputs?: Record<string, string>): Promise<\n | {\n type: \"success\"\n key: string\n provider?: string\n }\n | {\n type: \"failed\"\n }\n >\n }\n )[]\n}\n\nexport type AuthOuathResult = { url: string; instructions: string } & (\n | {\n method: \"auto\"\n callback(): Promise<\n | ({\n type: \"success\"\n provider?: string\n } & (\n | {\n refresh: string\n access: string\n expires: number\n }\n | { key: string }\n ))\n | {\n type: \"failed\"\n }\n >\n }\n | {\n method: \"code\"\n callback(code: string): Promise<\n | ({\n type: \"success\"\n provider?: string\n } & (\n | {\n refresh: string\n access: string\n expires: number\n }\n | { key: string }\n ))\n | {\n type: \"failed\"\n }\n >\n }\n)\n\nexport interface Hooks {\n event?: (input: { event: Event }) => Promise<void>\n config?: (input: Config) => Promise<void>\n tool?: {\n [key: string]: ToolDefinition\n }\n auth?: AuthHook\n /**\n * Called when a new message is received\n */\n \"chat.message\"?: (\n input: { sessionID: string; agent?: string; model?: { providerID: string; modelID: string }; messageID?: string },\n output: { message: UserMessage; parts: Part[] },\n ) => Promise<void>\n /**\n * Modify parameters sent to LLM\n */\n \"chat.params\"?: (\n input: { sessionID: string; agent: string; model: Model; provider: ProviderContext; message: UserMessage },\n output: { temperature: number; topP: number; topK: number; options: Record<string, any> },\n ) => Promise<void>\n \"permission.ask\"?: (input: Permission, output: { status: \"ask\" | \"deny\" | \"allow\" }) => Promise<void>\n \"tool.execute.before\"?: (\n input: { tool: string; sessionID: string; callID: string },\n output: { args: any },\n ) => Promise<void>\n \"tool.execute.after\"?: (\n input: { tool: string; sessionID: string; callID: string },\n output: {\n title: string\n output: string\n metadata: any\n },\n ) => Promise<void>\n \"experimental.chat.messages.transform\"?: (\n input: {},\n output: {\n messages: {\n info: Message\n parts: Part[]\n }[]\n },\n ) => Promise<void>\n \"experimental.chat.system.transform\"?: (\n input: {},\n output: {\n system: string[]\n },\n ) => Promise<void>\n /**\n * Called before session compaction starts. Allows plugins to append\n * additional context to the compaction prompt.\n */\n \"experimental.session.compacting\"?: (input: { sessionID: string }, output: { context: string[] }) => Promise<void>\n \"experimental.text.complete\"?: (\n input: { sessionID: string; messageID: string; partID: string },\n output: { text: string },\n ) => Promise<void>\n}\n", | |
| "title": "https://raw.githubusercontent.com/sst/opencode/1b1b73b5b317bb190e994506b8e3b57b07a685cb/packages/plugin/src/index.ts (text/plain; charset=utf-8)", | |
| "metadata": {}, | |
| "time": { | |
| "start": 1766431319538, | |
| "end": 1766431319754 | |
| } | |
| } | |
| }, | |
| { | |
| "id": "prt_b4782e6ca001s6Snjy4xzWXzJe", | |
| "sessionID": "ses_4b8933352ffe2k7Q7VhaAWbJcB", | |
| "messageID": "msg_b4782d5020018uZpNl6um94qFd", | |
| "type": "step-finish", | |
| "reason": "tool-calls", | |
| "cost": 0, | |
| "tokens": { | |
| "input": 1, | |
| "output": 139, | |
| "reasoning": 0, | |
| "cache": { | |
| "read": 26430, | |
| "write": 2267 | |
| } | |
| } | |
| } | |
| ] | |
| }, | |
| { | |
| "info": { | |
| "id": "msg_b4782e6d00012BJwQ1B6l3Bv2s", | |
| "sessionID": "ses_4b8933352ffe2k7Q7VhaAWbJcB", | |
| "role": "assistant", | |
| "time": { | |
| "created": 1766431319760, | |
| "completed": 1766431323991 | |
| }, | |
| "parentID": "msg_b4782c46a001rP2W0KPoAqISMd", | |
| "modelID": "claude-opus-4-5", | |
| "providerID": "anthropic", | |
| "mode": "build", | |
| "agent": "build", | |
| "path": { | |
| "cwd": "/Users/themishkun/projects/tinkering/opencode-stats", | |
| "root": "/" | |
| }, | |
| "cost": 0, | |
| "tokens": { | |
| "input": 1, | |
| "output": 96, | |
| "reasoning": 0, | |
| "cache": { | |
| "read": 28697, | |
| "write": 1589 | |
| } | |
| }, | |
| "finish": "tool-calls" | |
| }, | |
| "parts": [ | |
| { | |
| "id": "prt_b4782f129001RhThNgK6pEOqXA", | |
| "sessionID": "ses_4b8933352ffe2k7Q7VhaAWbJcB", | |
| "messageID": "msg_b4782e6d00012BJwQ1B6l3Bv2s", | |
| "type": "step-start" | |
| }, | |
| { | |
| "id": "prt_b4782f12b001lz75Fmonw9R4d1", | |
| "sessionID": "ses_4b8933352ffe2k7Q7VhaAWbJcB", | |
| "messageID": "msg_b4782e6d00012BJwQ1B6l3Bv2s", | |
| "type": "text", | |
| "text": "Now I have the actual hooks definition. Let me update the ARCHITECTURE.md with the correct API:", | |
| "time": { | |
| "start": 1766431323215, | |
| "end": 1766431323215 | |
| } | |
| }, | |
| { | |
| "id": "prt_b4782f451001k6I2MMiZQ8ccqV", | |
| "sessionID": "ses_4b8933352ffe2k7Q7VhaAWbJcB", | |
| "messageID": "msg_b4782e6d00012BJwQ1B6l3Bv2s", | |
| "type": "tool", | |
| "callID": "toolu_016y3pTiGyQhfFECgjtzCpnb", | |
| "tool": "read", | |
| "state": { | |
| "status": "completed", | |
| "input": { | |
| "filePath": "/Users/themishkun/projects/tinkering/opencode-stats/ARCHITECTURE.md" | |
| }, | |
| "output": "<file>\n00001| # Architecture Document: OpenCode Stats Plugin\n00002| \n00003| ## Overview\n00004| \n00005| This document describes the technical architecture of the `opencode-stats` plugin, a \"Spotify Wrapped\"-style statistics visualization tool for OpenCode.\n00006| \n00007| ---\n00008| \n00009| ## Plugin Architecture\n00010| \n00011| ### OpenCode Plugin System\n00012| \n00013| OpenCode plugins are JavaScript/TypeScript modules that run in the Bun runtime. They follow an async function pattern:\n00014| \n00015| ```typescript\n00016| // index.ts\n00017| import type { PluginContext, PluginHooks } from \"opencode\";\n00018| \n00019| export default async function plugin(context: PluginContext): Promise<PluginHooks> {\n00020| // Plugin initialization\n00021| return {\n00022| // Hook definitions\n00023| };\n00024| }\n00025| ```\n00026| \n00027| ### Plugin Location\n00028| \n00029| ```\n00030| .opencode/\n00031| └── plugin/\n00032| └── opencode-stats/\n00033| ├── index.ts # Main plugin entry\n00034| ├── package.json # Dependencies\n00035| └── src/\n00036| ├── stats/ # Statistics computation\n00037| ├── render/ # TUI rendering\n00038| └── data/ # Data access layer\n00039| ```\n00040| \n00041| ---\n00042| \n00043| ## System Architecture\n00044| \n00045| ```\n00046| ┌─────────────────────────────────────────────────────────────────┐\n00047| │ OpenCode Host │\n00048| ├─────────────────────────────────────────────────────────────────┤\n00049| │ │\n00050| │ ┌─────────────────────────────────────────────────────────┐ │\n00051| │ │ opencode-stats Plugin │ │\n00052| │ ├─────────────────────────────────────────────────────────┤ │\n00053| │ │ │ │\n00054| │ │ ┌─────────────┐ ┌─────────────┐ ┌─────────────────┐ │ │\n00055| │ │ │ Command │ │ Stats │ │ Renderer │ │ │\n00056| │ │ │ Handler │──│ Engine │──│ (TUI) │ │ │\n00057| │ │ └─────────────┘ └─────────────┘ └─────────────────┘ │ │\n00058| │ │ │ │ │ │ │\n00059| │ │ ▼ ▼ ▼ │ │\n00060| │ │ ┌─────────────┐ ┌─────────────┐ ┌─────────────────┐ │ │\n00061| │ │ │ Slash │ │ Data │ │ Components │ │ │\n00062| │ │ │ Command │ │ Layer │ │ Library │ │ │\n00063| │ │ └─────────────┘ └─────────────┘ └─────────────────┘ │ │\n00064| │ │ │ │ │\n00065| │ └──────────────────────────│─────────────────────────────┘ │\n00066| │ │ │\n00067| │ ▼ │\n00068| │ ┌─────────────────────────────────────────────────────────┐ │\n00069| │ │ OpenCode Session Storage │ │\n00070| │ │ (SQLite / JSON) │ │\n00071| │ └─────────────────────────────────────────────────────────┘ │\n00072| │ │\n00073| └─────────────────────────────────────────────────────────────────┘\n00074| ```\n00075| \n00076| ---\n00077| \n00078| ## Component Design\n00079| \n00080| ### 1. Plugin Entry Point (`index.ts`)\n00081| \n00082| ```typescript\n00083| import type { PluginContext, PluginHooks } from \"opencode\";\n00084| import { StatsCommand } from \"./src/commands/stats\";\n00085| import { StatsEngine } from \"./src/stats/engine\";\n00086| import { SessionDataProvider } from \"./src/data/sessions\";\n00087| \n00088| export default async function plugin(context: PluginContext): Promise<PluginHooks> {\n00089| const dataProvider = new SessionDataProvider(context);\n00090| const statsEngine = new StatsEngine(dataProvider);\n00091| const statsCommand = new StatsCommand(statsEngine);\n00092| \n00093| return {\n00094| // Register the /stats slash command\n00095| tool: {\n00096| name: \"stats\",\n00097| description: \"View your OpenCode usage statistics (Wrapped-style)\",\n00098| parameters: z.object({\n00099| period: z.enum([\"week\", \"month\", \"year\", \"all\"]).optional().default(\"month\"),\n00100| view: z.enum([\"overview\", \"models\"]).optional().default(\"overview\"),\n00101| }),\n00102| execute: statsCommand.execute.bind(statsCommand),\n00103| },\n00104| };\n00105| }\n00106| ```\n00107| \n00108| ### 2. Data Layer (`src/data/`)\n00109| \n00110| #### Session Data Provider\n00111| \n00112| Responsible for accessing OpenCode's session storage.\n00113| \n00114| ```typescript\n00115| // src/data/sessions.ts\n00116| \n00117| export interface Session {\n00118| id: string;\n00119| createdAt: Date;\n00120| updatedAt: Date;\n00121| messages: Message[];\n00122| }\n00123| \n00124| export interface Message {\n00125| id: string;\n00126| role: \"user\" | \"assistant\";\n00127| timestamp: Date;\n00128| model?: string;\n00129| tokenCount?: {\n00130| input: number;\n00131| output: number;\n00132| };\n00133| }\n00134| \n00135| export class SessionDataProvider {\n00136| constructor(private context: PluginContext) {}\n00137| \n00138| async getSessions(options?: {\n00139| from?: Date;\n00140| to?: Date;\n00141| limit?: number;\n00142| }): Promise<Session[]> {\n00143| // Access OpenCode's session list via context\n00144| // Implementation depends on OpenCode's exposed APIs\n00145| }\n00146| \n00147| async getSessionById(id: string): Promise<Session | null> {\n00148| // Fetch a specific session with all messages\n00149| }\n00150| \n00151| async getSessionSummaries(): Promise<SessionSummary[]> {\n00152| // Lightweight fetch for stats computation\n00153| }\n00154| }\n00155| ```\n00156| \n00157| #### Data Models\n00158| \n00159| ```typescript\n00160| // src/data/models.ts\n00161| \n00162| export interface SessionSummary {\n00163| id: string;\n00164| startTime: Date;\n00165| endTime: Date;\n00166| messageCount: number;\n00167| totalTokens: number;\n00168| models: string[];\n00169| }\n00170| \n00171| export interface DailyActivity {\n00172| date: string; // YYYY-MM-DD\n00173| sessionCount: number;\n00174| totalTokens: number;\n00175| totalDuration: number; // minutes\n00176| }\n00177| \n00178| export interface ModelUsage {\n00179| model: string;\n00180| sessionCount: number;\n00181| messageCount: number;\n00182| totalTokens: number;\n00183| percentage: number;\n00184| }\n00185| ```\n00186| \n00187| ### 3. Statistics Engine (`src/stats/`)\n00188| \n00189| #### Core Engine\n00190| \n00191| ```typescript\n00192| // src/stats/engine.ts\n00193| \n00194| export interface StatsResult {\n00195| period: {\n00196| start: Date;\n00197| end: Date;\n00198| days: number;\n00199| };\n00200| summary: {\n00201| totalSessions: number;\n00202| totalTokens: number;\n00203| totalMessages: number;\n00204| activeDays: number;\n00205| currentStreak: number;\n00206| longestStreak: number;\n00207| longestSession: {\n00208| id: string;\n00209| duration: number; // minutes\n00210| };\n00211| peakHour: number; // 0-23\n00212| favoriteModel: string;\n00213| };\n00214| dailyActivity: DailyActivity[];\n00215| modelUsage: ModelUsage[];\n00216| funFact: string;\n00217| }\n00218| \n00219| export class StatsEngine {\n00220| constructor(private dataProvider: SessionDataProvider) {}\n00221| \n00222| async computeStats(options: {\n00223| period: \"week\" | \"month\" | \"year\" | \"all\";\n00224| }): Promise<StatsResult> {\n00225| const sessions = await this.dataProvider.getSessions({\n00226| from: this.getPeriodStart(options.period),\n00227| });\n00228| \n00229| return {\n00230| period: this.computePeriod(sessions, options.period),\n00231| summary: this.computeSummary(sessions),\n00232| dailyActivity: this.computeDailyActivity(sessions),\n00233| modelUsage: this.computeModelUsage(sessions),\n00234| funFact: this.generateFunFact(sessions),\n00235| };\n00236| }\n00237| \n00238| private computeSummary(sessions: Session[]): StatsResult[\"summary\"] {\n00239| // Compute all summary statistics\n00240| }\n00241| \n00242| private computeDailyActivity(sessions: Session[]): DailyActivity[] {\n00243| // Aggregate sessions by day\n00244| }\n00245| \n00246| private computeModelUsage(sessions: Session[]): ModelUsage[] {\n00247| // Aggregate by model\n00248| }\n00249| \n00250| private generateFunFact(sessions: Session[]): string {\n00251| // Pick a fun comparison\n00252| }\n00253| }\n00254| ```\n00255| \n00256| #### Streak Calculator\n00257| \n00258| ```typescript\n00259| // src/stats/streaks.ts\n00260| \n00261| export interface StreakResult {\n00262| current: number;\n00263| longest: number;\n00264| currentStart?: Date;\n00265| longestStart?: Date;\n00266| longestEnd?: Date;\n00267| }\n00268| \n00269| export function calculateStreaks(dailyActivity: DailyActivity[]): StreakResult {\n00270| // Sort by date\n00271| const sorted = [...dailyActivity].sort(\n00272| (a, b) => new Date(a.date).getTime() - new Date(b.date).getTime()\n00273| );\n00274| \n00275| let current = 0;\n00276| let longest = 0;\n00277| let streak = 0;\n00278| let prevDate: Date | null = null;\n00279| \n00280| for (const day of sorted) {\n00281| const date = new Date(day.date);\n00282| if (prevDate && isConsecutiveDay(prevDate, date)) {\n00283| streak++;\n00284| } else {\n00285| streak = 1;\n00286| }\n00287| \n00288| if (streak > longest) longest = streak;\n00289| prevDate = date;\n00290| }\n00291| \n00292| // Check if streak continues to today\n00293| const today = new Date();\n00294| today.setHours(0, 0, 0, 0);\n00295| \n00296| if (prevDate && isConsecutiveDay(prevDate, today)) {\n00297| current = streak;\n00298| } else if (prevDate?.getTime() === today.getTime()) {\n00299| current = streak;\n00300| }\n00301| \n00302| return { current, longest };\n00303| }\n00304| \n00305| function isConsecutiveDay(a: Date, b: Date): boolean {\n00306| const diff = b.getTime() - a.getTime();\n00307| return diff === 24 * 60 * 60 * 1000;\n00308| }\n00309| ```\n00310| \n00311| #### Fun Facts Generator\n00312| \n00313| ```typescript\n00314| // src/stats/funfacts.ts\n00315| \n00316| interface FunFactTemplate {\n00317| condition: (stats: StatsResult) => boolean;\n00318| generate: (stats: StatsResult) => string;\n00319| }\n00320| \n00321| const FUN_FACTS: FunFactTemplate[] = [\n00322| {\n00323| condition: (s) => s.summary.longestSession.duration > 148, // Inception length\n00324| generate: (s) => {\n00325| const times = Math.round(s.summary.longestSession.duration / 148);\n00326| return `Your longest session is ~${times}x longer than the movie Inception`;\n00327| },\n00328| },\n00329| {\n00330| condition: (s) => s.summary.totalTokens > 587287, // War and Peace word count\n00331| generate: (s) => {\n00332| const times = Math.round(s.summary.totalTokens / 587287);\n00333| return `You've used ${times}x more tokens than words in War and Peace`;\n00334| },\n00335| },\n00336| {\n00337| condition: (s) => s.summary.currentStreak >= 7,\n00338| generate: (s) => \n00339| `Your ${s.summary.currentStreak}-day streak is longer than most New Year resolutions`,\n00340| },\n00341| {\n00342| condition: (s) => s.summary.peakHour >= 22 || s.summary.peakHour <= 4,\n00343| generate: () => `You're a night owl coder - peak activity is after dark`,\n00344| },\n00345| {\n00346| condition: (s) => s.summary.peakHour >= 5 && s.summary.peakHour <= 8,\n00347| generate: () => `Early bird catches the bugs - you code best at dawn`,\n00348| },\n00349| // More fun facts...\n00350| ];\n00351| \n00352| export function generateFunFact(stats: StatsResult): string {\n00353| const applicable = FUN_FACTS.filter((f) => f.condition(stats));\n00354| if (applicable.length === 0) {\n00355| return `You've had ${stats.summary.totalSessions} coding sessions - keep going!`;\n00356| }\n00357| const random = applicable[Math.floor(Math.random() * applicable.length)];\n00358| return random.generate(stats);\n00359| }\n00360| ```\n00361| \n00362| ### 4. Renderer (`src/render/`)\n00363| \n00364| #### Renderer Interface\n00365| \n00366| ```typescript\n00367| // src/render/types.ts\n00368| \n00369| export interface RenderContext {\n00370| width: number;\n00371| height: number;\n00372| colors: boolean;\n00373| }\n00374| \n00375| export interface Renderer {\n00376| render(stats: StatsResult, view: \"overview\" | \"models\"): string;\n00377| }\n00378| ```\n00379| \n00380| #### Heatmap Component\n00381| \n00382| ```typescript\n00383| // src/render/components/heatmap.ts\n00384| \n00385| const INTENSITY_CHARS = [\" \", \"░\", \"▒\", \"▓\", \"█\"];\n00386| const DAYS = [\"\", \"Mon\", \"\", \"Wed\", \"\", \"Fri\", \"\"];\n00387| const MONTHS = [\"Jan\", \"Feb\", \"Mar\", \"Apr\", \"May\", \"Jun\", \n00388| \"Jul\", \"Aug\", \"Sep\", \"Oct\", \"Nov\", \"Dec\"];\n00389| \n00390| export function renderHeatmap(\n00391| dailyActivity: DailyActivity[],\n00392| options: { weeks: number; colors: boolean }\n00393| ): string[] {\n00394| const lines: string[] = [];\n00395| \n00396| // Build activity map\n00397| const activityMap = new Map<string, number>();\n00398| dailyActivity.forEach((d) => {\n00399| activityMap.set(d.date, d.sessionCount);\n00400| });\n00401| \n00402| // Calculate intensity thresholds\n00403| const maxActivity = Math.max(...dailyActivity.map((d) => d.sessionCount), 1);\n00404| const getIntensity = (count: number): number => {\n00405| if (count === 0) return 0;\n00406| return Math.min(4, Math.ceil((count / maxActivity) * 4));\n00407| };\n00408| \n00409| // Generate header (months)\n00410| const headerLine = \" \" + generateMonthHeader(options.weeks);\n00411| lines.push(headerLine);\n00412| \n00413| // Generate each day row\n00414| for (let dayOfWeek = 0; dayOfWeek < 7; dayOfWeek++) {\n00415| let line = DAYS[dayOfWeek].padEnd(4);\n00416| \n00417| for (let week = 0; week < options.weeks; week++) {\n00418| const date = getDateForWeekDay(week, dayOfWeek, options.weeks);\n00419| const dateStr = formatDate(date);\n00420| const count = activityMap.get(dateStr) || 0;\n00421| const char = INTENSITY_CHARS[getIntensity(count)];\n00422| line += char + \" \";\n00423| }\n00424| \n00425| lines.push(line);\n00426| }\n00427| \n00428| // Legend\n00429| lines.push(\"\");\n00430| lines.push(\" Less \" + INTENSITY_CHARS.slice(1).join(\" \") + \" More\");\n00431| \n00432| return lines;\n00433| }\n00434| ```\n00435| \n00436| #### Stats Dashboard Component\n00437| \n00438| ```typescript\n00439| // src/render/components/dashboard.ts\n00440| \n00441| export function renderDashboard(summary: StatsResult[\"summary\"]): string[] {\n00442| const lines: string[] = [];\n00443| \n00444| const formatDuration = (minutes: number): string => {\n00445| const days = Math.floor(minutes / 1440);\n00446| const hours = Math.floor((minutes % 1440) / 60);\n00447| const mins = minutes % 60;\n00448| \n00449| const parts = [];\n00450| if (days > 0) parts.push(`${days}d`);\n00451| if (hours > 0) parts.push(`${hours}h`);\n00452| if (mins > 0) parts.push(`${mins}m`);\n00453| return parts.join(\" \") || \"0m\";\n00454| };\n00455| \n00456| const formatNumber = (n: number): string => {\n00457| if (n >= 1000000) return `${(n / 1000000).toFixed(1)}m`;\n00458| if (n >= 1000) return `${(n / 1000).toFixed(1)}k`;\n00459| return n.toString();\n00460| };\n00461| \n00462| const leftCol = [\n00463| `Favorite model: ${summary.favoriteModel}`,\n00464| \"\",\n00465| `Sessions: ${summary.totalSessions}`,\n00466| `Current streak: ${summary.currentStreak} days`,\n00467| `Active days: ${summary.activeDays}`,\n00468| ];\n00469| \n00470| const rightCol = [\n00471| `Total tokens: ${formatNumber(summary.totalTokens)}`,\n00472| \"\",\n00473| `Longest session: ${formatDuration(summary.longestSession.duration)}`,\n00474| `Longest streak: ${summary.longestStreak} days`,\n00475| `Peak hour: ${summary.peakHour}:00-${summary.peakHour + 1}:00`,\n00476| ];\n00477| \n00478| // Combine columns\n00479| const maxLeftWidth = Math.max(...leftCol.map((l) => l.length));\n00480| const padding = 4;\n00481| \n00482| for (let i = 0; i < leftCol.length; i++) {\n00483| lines.push(\n00484| leftCol[i].padEnd(maxLeftWidth + padding) + rightCol[i]\n00485| );\n00486| }\n00487| \n00488| return lines;\n00489| }\n00490| ```\n00491| \n00492| #### Model Usage Bar Chart\n00493| \n00494| ```typescript\n00495| // src/render/components/models.ts\n00496| \n00497| export function renderModelUsage(\n00498| modelUsage: ModelUsage[],\n00499| options: { width: number }\n00500| ): string[] {\n00501| const lines: string[] = [];\n00502| const barWidth = options.width - 40; // Space for label and percentage\n00503| \n00504| const sorted = [...modelUsage].sort((a, b) => b.percentage - a.percentage);\n00505| \n00506| for (const model of sorted.slice(0, 5)) {\n00507| const filled = Math.round((model.percentage / 100) * barWidth);\n00508| const empty = barWidth - filled;\n00509| const bar = \"█\".repeat(filled) + \"░\".repeat(empty);\n00510| const label = model.model.padEnd(28);\n00511| const pct = `${Math.round(model.percentage)}%`.padStart(4);\n00512| \n00513| lines.push(` ${label} ${bar} ${pct}`);\n00514| }\n00515| \n00516| return lines;\n00517| }\n00518| ```\n00519| \n00520| #### Main Renderer\n00521| \n00522| ```typescript\n00523| // src/render/index.ts\n00524| \n00525| import { renderHeatmap } from \"./components/heatmap\";\n00526| import { renderDashboard } from \"./components/dashboard\";\n00527| import { renderModelUsage } from \"./components/models\";\n00528| \n00529| export class StatsRenderer implements Renderer {\n00530| constructor(private context: RenderContext) {}\n00531| \n00532| render(stats: StatsResult, view: \"overview\" | \"models\"): string {\n00533| const lines: string[] = [];\n00534| \n00535| // Header\n00536| lines.push(\"\");\n00537| const tabs = view === \"overview\" \n00538| ? \" [Overview] Models (tab to cycle)\"\n00539| : \" Overview [Models] (tab to cycle)\";\n00540| lines.push(tabs);\n00541| lines.push(\"\");\n00542| \n00543| if (view === \"overview\") {\n00544| // Heatmap\n00545| const heatmap = renderHeatmap(stats.dailyActivity, {\n00546| weeks: 52,\n00547| colors: this.context.colors,\n00548| });\n00549| lines.push(...heatmap);\n00550| lines.push(\"\");\n00551| \n00552| // Dashboard stats\n00553| const dashboard = renderDashboard(stats.summary);\n00554| lines.push(...dashboard);\n00555| lines.push(\"\");\n00556| \n00557| // Fun fact\n00558| lines.push(` ${stats.funFact}`);\n00559| lines.push(` Stats from the last ${stats.period.days} days`);\n00560| } else {\n00561| // Model breakdown\n00562| const models = renderModelUsage(stats.modelUsage, {\n00563| width: this.context.width,\n00564| });\n00565| lines.push(...models);\n00566| }\n00567| \n00568| lines.push(\"\");\n00569| return lines.join(\"\\n\");\n00570| }\n00571| }\n00572| ```\n00573| \n00574| ### 5. Command Handler (`src/commands/`)\n00575| \n00576| ```typescript\n00577| // src/commands/stats.ts\n00578| \n00579| import { z } from \"zod\";\n00580| import type { ToolExecuteParams } from \"opencode\";\n00581| import { StatsEngine } from \"../stats/engine\";\n00582| import { StatsRenderer } from \"../render\";\n00583| \n00584| export class StatsCommand {\n00585| constructor(private engine: StatsEngine) {}\n00586| \n00587| async execute(params: ToolExecuteParams<{\n00588| period?: \"week\" | \"month\" | \"year\" | \"all\";\n00589| view?: \"overview\" | \"models\";\n00590| }>) {\n00591| const { period = \"month\", view = \"overview\" } = params.input;\n00592| \n00593| try {\n00594| const stats = await this.engine.computeStats({ period });\n00595| \n00596| const renderer = new StatsRenderer({\n00597| width: process.stdout.columns || 80,\n00598| height: process.stdout.rows || 24,\n00599| colors: process.stdout.isTTY ?? false,\n00600| });\n00601| \n00602| const output = renderer.render(stats, view);\n00603| \n00604| return {\n00605| content: output,\n00606| metadata: {\n00607| totalSessions: stats.summary.totalSessions,\n00608| period: stats.period,\n00609| },\n00610| };\n00611| } catch (error) {\n00612| return {\n00613| content: `Error computing stats: ${error.message}`,\n00614| isError: true,\n00615| };\n00616| }\n00617| }\n00618| }\n00619| ```\n00620| \n00621| ---\n00622| \n00623| ## Data Flow\n00624| \n00625| ```\n00626| ┌──────────────────────────────────────────────────────────────────┐\n00627| │ User invokes /stats │\n00628| └──────────────────────────────────────────────────────────────────┘\n00629| │\n00630| ▼\n00631| ┌──────────────────────────────────────────────────────────────────┐\n00632| │ StatsCommand.execute() │\n00633| │ - Parse parameters (period, view) │\n00634| │ - Validate inputs │\n00635| └──────────────────────────────────────────────────────────────────┘\n00636| │\n00637| ▼\n00638| ┌──────────────────────────────────────────────────────────────────┐\n00639| │ StatsEngine.computeStats() │\n00640| │ - Fetch session data from provider │\n00641| │ - Compute summary statistics │\n00642| │ - Calculate streaks │\n00643| │ - Aggregate daily activity │\n00644| │ - Compute model usage │\n00645| │ - Generate fun fact │\n00646| └──────────────────────────────────────────────────────────────────┘\n00647| │\n00648| ▼\n00649| ┌──────────────────────────────────────────────────────────────────┐\n00650| │ SessionDataProvider.getSessions() │\n00651| │ - Access OpenCode session storage │\n00652| │ - Filter by date range │\n00653| │ - Return session summaries │\n00654| └──────────────────────────────────────────────────────────────────┘\n00655| │\n00656| ▼\n00657| ┌──────────────────────────────────────────────────────────────────┐\n00658| │ StatsRenderer.render() │\n00659| │ - Select view (overview/models) │\n00660| │ - Compose components │\n00661| │ - Generate ASCII output │\n00662| └──────────────────────────────────────────────────────────────────┘\n00663| │\n00664| ▼\n00665| ┌──────────────────────────────────────────────────────────────────┐\n00666| │ Display output to user │\n00667| └──────────────────────────────────────────────────────────────────┘\n00668| ```\n00669| \n00670| ---\n00671| \n00672| ## File Structure\n00673| \n00674| ```\n00675| opencode-stats/\n00676| ├── index.ts # Plugin entry point\n00677| ├── package.json # Dependencies and metadata\n00678| ├── tsconfig.json # TypeScript configuration\n00679| ├── README.md # Plugin documentation\n00680| │\n00681| ├── src/\n00682| │ ├── commands/\n00683| │ │ └── stats.ts # Slash command handler\n00684| │ │\n00685| │ ├── data/\n00686| │ │ ├── sessions.ts # Session data provider\n00687| │ │ └── models.ts # Data models/interfaces\n00688| │ │\n00689| │ ├── stats/\n00690| │ │ ├── engine.ts # Main statistics engine\n00691| │ │ ├── streaks.ts # Streak calculation\n00692| │ │ ├── funfacts.ts # Fun fact generator\n00693| │ │ └── aggregators.ts # Data aggregation utilities\n00694| │ │\n00695| │ └── render/\n00696| │ ├── index.ts # Main renderer\n00697| │ ├── types.ts # Render interfaces\n00698| │ └── components/\n00699| │ ├── heatmap.ts # Activity heatmap\n00700| │ ├── dashboard.ts # Stats dashboard\n00701| │ ├── models.ts # Model usage chart\n00702| │ └── box.ts # Box drawing utilities\n00703| │\n00704| └── tests/\n00705| ├── stats/\n00706| │ ├── engine.test.ts\n00707| │ └── streaks.test.ts\n00708| └── render/\n00709| └── components.test.ts\n00710| ```\n00711| \n00712| ---\n00713| \n00714| ## Dependencies\n00715| \n00716| ```json\n00717| {\n00718| \"name\": \"opencode-stats\",\n00719| \"version\": \"1.0.0\",\n00720| \"type\": \"module\",\n00721| \"main\": \"index.ts\",\n00722| \"dependencies\": {\n00723| \"zod\": \"^3.22.0\"\n00724| },\n00725| \"devDependencies\": {\n00726| \"@types/bun\": \"latest\",\n00727| \"typescript\": \"^5.0.0\"\n00728| },\n00729| \"peerDependencies\": {\n00730| \"opencode\": \">=0.1.0\"\n00731| }\n00732| }\n00733| ```\n00734| \n00735| ---\n00736| \n00737| ## Configuration\n00738| \n00739| ### Plugin Configuration (`opencode.json`)\n00740| \n00741| ```json\n00742| {\n00743| \"plugins\": {\n00744| \"opencode-stats\": {\n00745| \"enabled\": true,\n00746| \"options\": {\n00747| \"defaultPeriod\": \"month\",\n00748| \"cacheEnabled\": true,\n00749| \"cacheTTL\": 300\n00750| }\n00751| }\n00752| }\n00753| }\n00754| ```\n00755| \n00756| ### Environment Variables\n00757| \n00758| | Variable | Description | Default |\n00759| |----------|-------------|---------|\n00760| | `OPENCODE_STATS_CACHE` | Enable caching | `true` |\n00761| | `OPENCODE_STATS_CACHE_TTL` | Cache TTL in seconds | `300` |\n00762| \n00763| ---\n00764| \n00765| ## Testing Strategy\n00766| \n00767| ### Unit Tests\n00768| \n00769| - Statistics calculations (streaks, aggregations)\n00770| - Render component output\n00771| - Fun fact generation\n00772| \n00773| ### Integration Tests\n00774| \n00775| - Full stats computation with mock data\n00776| - Command execution flow\n00777| \n00778| ### Manual Testing\n00779| \n00780| - Various terminal sizes\n00781| - Color/no-color modes\n00782| - Large session histories\n00783| \n00784| ---\n00785| \n00786| ## Performance Considerations\n00787| \n00788| ### Caching Strategy\n00789| \n00790| ```typescript\n00791| interface CacheEntry {\n00792| stats: StatsResult;\n00793| computedAt: Date;\n00794| sessionCount: number;\n00795| }\n00796| \n00797| class StatsCache {\n00798| private cache: Map<string, CacheEntry> = new Map();\n00799| private ttl: number;\n00800| \n00801| constructor(ttlSeconds: number = 300) {\n00802| this.ttl = ttlSeconds * 1000;\n00803| }\n00804| \n00805| get(period: string): StatsResult | null {\n00806| const entry = this.cache.get(period);\n00807| if (!entry) return null;\n00808| \n00809| const age = Date.now() - entry.computedAt.getTime();\n00810| if (age > this.ttl) {\n00811| this.cache.delete(period);\n00812| return null;\n00813| }\n00814| \n00815| return entry.stats;\n00816| }\n00817| \n00818| set(period: string, stats: StatsResult, sessionCount: number): void {\n00819| this.cache.set(period, {\n00820| stats,\n00821| computedAt: new Date(),\n00822| sessionCount,\n00823| });\n00824| }\n00825| \n00826| invalidate(): void {\n00827| this.cache.clear();\n00828| }\n00829| }\n00830| ```\n00831| \n00832| ### Lazy Loading\n00833| \n00834| - Load only session summaries for initial stats\n00835| - Fetch full session data only when needed (e.g., longest session details)\n00836| \n00837| ---\n00838| \n00839| ## Security Considerations\n00840| \n00841| 1. **Read-only access:** Plugin only reads session data, never writes\n00842| 2. **Local processing:** All computation happens locally\n00843| 3. **No network calls:** No telemetry or external API calls\n00844| 4. **Sandboxed execution:** Runs within OpenCode's plugin sandbox\n00845| \n00846| ---\n00847| \n00848| ## Future Extensibility\n00849| \n00850| ### Planned Extensions\n00851| \n00852| 1. **Export API:** Allow other plugins to access stats\n00853| 2. **Webhook integration:** Post stats to external services\n00854| 3. **Custom metrics:** User-defined stat tracking\n00855| 4. **Themes:** Customizable color schemes\n00856| \n00857| ### Extension Points\n00858| \n00859| ```typescript\n00860| // Future: Plugin extension API\n00861| interface StatsExtension {\n00862| // Add custom metrics\n00863| metrics?: CustomMetric[];\n00864| \n00865| // Add custom fun facts\n00866| funFacts?: FunFactTemplate[];\n00867| \n00868| // Add custom views\n00869| views?: CustomView[];\n00870| }\n00871| ```\n00872| \n00873| ---\n00874| \n00875| ## Open Questions for Implementation\n00876| \n00877| 1. **Session Data Access:**\n00878| - How does OpenCode expose session list to plugins?\n00879| - Is there a direct API or do we need to use events?\n00880| - What's the schema of session/message data?\n00881| \n00882| 2. **Rendering:**\n00883| - Can plugins render full-screen TUI views?\n00884| - How do we handle keyboard input (tab to switch views)?\n00885| - Is there a blessed/ink integration or raw terminal output?\n00886| \n00887| 3. **Token Counting:**\n00888| - Is token count available per message?\n00889| - If not, how do we estimate it?\n00890| \n00891| 4. **Plugin Lifecycle:**\n00892| - When is the plugin loaded/unloaded?\n00893| - Can we persist cache between sessions?\n00894| \n\n(End of file - total 894 lines)\n</file>", | |
| "title": "Users/themishkun/projects/tinkering/opencode-stats/ARCHITECTURE.md", | |
| "metadata": { | |
| "preview": "# Architecture Document: OpenCode Stats Plugin\n\n## Overview\n\nThis document describes the technical architecture of the `opencode-stats` plugin, a \"Spotify Wrapped\"-style statistics visualization tool for OpenCode.\n\n---\n\n## Plugin Architecture\n\n### OpenCode Plugin System\n\nOpenCode plugins are JavaScript/TypeScript modules that run in the Bun runtime. They follow an async function pattern:\n\n```typescript\n// index.ts\nimport type { PluginContext, PluginHooks } from \"opencode\";\n\nexport default async function plugin(context: PluginContext): Promise<PluginHooks> {\n // Plugin initialization" | |
| }, | |
| "time": { | |
| "start": 1766431323956, | |
| "end": 1766431323958 | |
| } | |
| } | |
| }, | |
| { | |
| "id": "prt_b4782f756001Zg7TJ6hoYNhjwN", | |
| "sessionID": "ses_4b8933352ffe2k7Q7VhaAWbJcB", | |
| "messageID": "msg_b4782e6d00012BJwQ1B6l3Bv2s", | |
| "type": "step-finish", | |
| "reason": "tool-calls", | |
| "cost": 0, | |
| "tokens": { | |
| "input": 1, | |
| "output": 96, | |
| "reasoning": 0, | |
| "cache": { | |
| "read": 28697, | |
| "write": 1589 | |
| } | |
| } | |
| } | |
| ] | |
| }, | |
| { | |
| "info": { | |
| "id": "msg_b4782f75b001WPH5Q3rSet52LT", | |
| "sessionID": "ses_4b8933352ffe2k7Q7VhaAWbJcB", | |
| "role": "assistant", | |
| "time": { | |
| "created": 1766431323995, | |
| "completed": 1766431348998 | |
| }, | |
| "parentID": "msg_b4782c46a001rP2W0KPoAqISMd", | |
| "modelID": "claude-opus-4-5", | |
| "providerID": "anthropic", | |
| "mode": "build", | |
| "agent": "build", | |
| "path": { | |
| "cwd": "/Users/themishkun/projects/tinkering/opencode-stats", | |
| "root": "/" | |
| }, | |
| "cost": 0, | |
| "tokens": { | |
| "input": 1, | |
| "output": 1375, | |
| "reasoning": 0, | |
| "cache": { | |
| "read": 30286, | |
| "write": 10348 | |
| } | |
| }, | |
| "finish": "tool-calls" | |
| }, | |
| "parts": [ | |
| { | |
| "id": "prt_b47830703001y8ebPxSRmVmhW4", | |
| "sessionID": "ses_4b8933352ffe2k7Q7VhaAWbJcB", | |
| "messageID": "msg_b4782f75b001WPH5Q3rSet52LT", | |
| "type": "step-start" | |
| }, | |
| { | |
| "id": "prt_b47830718001EiZDllqiTxH7VD", | |
| "sessionID": "ses_4b8933352ffe2k7Q7VhaAWbJcB", | |
| "messageID": "msg_b4782f75b001WPH5Q3rSet52LT", | |
| "type": "text", | |
| "text": "Now I have the actual hooks definition. Let me update the ARCHITECTURE.md with the correct API based on the real plugin interface:", | |
| "time": { | |
| "start": 1766431329166, | |
| "end": 1766431329166 | |
| } | |
| }, | |
| { | |
| "id": "prt_b47830b8e001pCPBzl3GM34bFo", | |
| "sessionID": "ses_4b8933352ffe2k7Q7VhaAWbJcB", | |
| "messageID": "msg_b4782f75b001WPH5Q3rSet52LT", | |
| "type": "tool", | |
| "callID": "toolu_01Xw1QF4YQmusjJJCd8AffGT", | |
| "tool": "edit", | |
| "state": { | |
| "status": "completed", | |
| "input": { | |
| "filePath": "/Users/themishkun/projects/tinkering/opencode-stats/ARCHITECTURE.md", | |
| "oldString": "# Architecture Document: OpenCode Stats Plugin\n\n## Overview\n\nThis document describes the technical architecture of the `opencode-stats` plugin, a \"Spotify Wrapped\"-style statistics visualization tool for OpenCode.\n\n---\n\n## Plugin Architecture\n\n### OpenCode Plugin System\n\nOpenCode plugins are JavaScript/TypeScript modules that run in the Bun runtime. They follow an async function pattern:\n\n```typescript\n// index.ts\nimport type { PluginContext, PluginHooks } from \"opencode\";\n\nexport default async function plugin(context: PluginContext): Promise<PluginHooks> {\n // Plugin initialization\n return {\n // Hook definitions\n };\n}\n```\n\n### Plugin Location\n\n```\n.opencode/\n└── plugin/\n └── opencode-stats/\n ├── index.ts # Main plugin entry\n ├── package.json # Dependencies\n └── src/\n ├── stats/ # Statistics computation\n ├── render/ # TUI rendering\n └── data/ # Data access layer\n```", | |
| "newString": "# Architecture Document: OpenCode Stats Plugin\n\n## Overview\n\nThis document describes the technical architecture of the `opencode-stats` plugin, a \"Spotify Wrapped\"-style statistics visualization tool for OpenCode.\n\n---\n\n## Plugin Architecture\n\n### OpenCode Plugin System\n\nOpenCode plugins are JavaScript/TypeScript modules that run in the Bun runtime. They follow an async function pattern that receives a `PluginInput` and returns `Hooks`.\n\n#### Plugin Input (What plugins receive)\n\n```typescript\n// From @opencode-ai/plugin\nexport type PluginInput = {\n client: ReturnType<typeof createOpencodeClient> // SDK client for API access\n project: Project // Current project info\n directory: string // Project directory\n worktree: string // Git worktree path\n $: BunShell // Bun shell for running commands\n}\n\nexport type Plugin = (input: PluginInput) => Promise<Hooks>\n```\n\n#### Available Hooks\n\n```typescript\nexport interface Hooks {\n // Listen to OpenCode events (session created, message created, etc.)\n event?: (input: { event: Event }) => Promise<void>\n \n // Modify OpenCode configuration\n config?: (input: Config) => Promise<void>\n \n // Define custom tools (slash commands)\n tool?: {\n [key: string]: ToolDefinition\n }\n \n // Custom authentication providers\n auth?: AuthHook\n \n // Called when a new message is received\n \"chat.message\"?: (\n input: { sessionID: string; agent?: string; model?: { providerID: string; modelID: string }; messageID?: string },\n output: { message: UserMessage; parts: Part[] },\n ) => Promise<void>\n \n // Modify parameters sent to LLM\n \"chat.params\"?: (\n input: { sessionID: string; agent: string; model: Model; provider: ProviderContext; message: UserMessage },\n output: { temperature: number; topP: number; topK: number; options: Record<string, any> },\n ) => Promise<void>\n \n // Intercept permission requests\n \"permission.ask\"?: (input: Permission, output: { status: \"ask\" | \"deny\" | \"allow\" }) => Promise<void>\n \n // Before tool execution - can modify args\n \"tool.execute.before\"?: (\n input: { tool: string; sessionID: string; callID: string },\n output: { args: any },\n ) => Promise<void>\n \n // After tool execution - can modify output\n \"tool.execute.after\"?: (\n input: { tool: string; sessionID: string; callID: string },\n output: { title: string; output: string; metadata: any },\n ) => Promise<void>\n \n // Transform chat messages (experimental)\n \"experimental.chat.messages.transform\"?: (\n input: {},\n output: { messages: { info: Message; parts: Part[] }[] },\n ) => Promise<void>\n \n // Transform system prompt (experimental)\n \"experimental.chat.system.transform\"?: (\n input: {},\n output: { system: string[] },\n ) => Promise<void>\n \n // Add context during session compaction (experimental)\n \"experimental.session.compacting\"?: (\n input: { sessionID: string },\n output: { context: string[] },\n ) => Promise<void>\n \n // Transform completed text (experimental)\n \"experimental.text.complete\"?: (\n input: { sessionID: string; messageID: string; partID: string },\n output: { text: string },\n ) => Promise<void>\n}\n```\n\n### Plugin Location\n\n```\n.opencode/\n└── plugin/\n └── opencode-stats/\n ├── index.ts # Main plugin entry\n ├── package.json # Dependencies\n └── src/\n ├── stats/ # Statistics computation\n ├── render/ # TUI rendering\n └── data/ # Data access layer\n```" | |
| }, | |
| "output": "", | |
| "title": "Users/themishkun/projects/tinkering/opencode-stats/ARCHITECTURE.md", | |
| "metadata": { | |
| "diagnostics": {}, | |
| "diff": "Index: /Users/themishkun/projects/tinkering/opencode-stats/ARCHITECTURE.md\n===================================================================\n--- /Users/themishkun/projects/tinkering/opencode-stats/ARCHITECTURE.md\n+++ /Users/themishkun/projects/tinkering/opencode-stats/ARCHITECTURE.md\n@@ -9,19 +9,93 @@\n ## Plugin Architecture\n \n ### OpenCode Plugin System\n \n-OpenCode plugins are JavaScript/TypeScript modules that run in the Bun runtime. They follow an async function pattern:\n+OpenCode plugins are JavaScript/TypeScript modules that run in the Bun runtime. They follow an async function pattern that receives a `PluginInput` and returns `Hooks`.\n \n+#### Plugin Input (What plugins receive)\n+\n ```typescript\n-// index.ts\n-import type { PluginContext, PluginHooks } from \"opencode\";\n+// From @opencode-ai/plugin\n+export type PluginInput = {\n+ client: ReturnType<typeof createOpencodeClient> // SDK client for API access\n+ project: Project // Current project info\n+ directory: string // Project directory\n+ worktree: string // Git worktree path\n+ $: BunShell // Bun shell for running commands\n+}\n \n-export default async function plugin(context: PluginContext): Promise<PluginHooks> {\n- // Plugin initialization\n- return {\n- // Hook definitions\n- };\n+export type Plugin = (input: PluginInput) => Promise<Hooks>\n+```\n+\n+#### Available Hooks\n+\n+```typescript\n+export interface Hooks {\n+ // Listen to OpenCode events (session created, message created, etc.)\n+ event?: (input: { event: Event }) => Promise<void>\n+ \n+ // Modify OpenCode configuration\n+ config?: (input: Config) => Promise<void>\n+ \n+ // Define custom tools (slash commands)\n+ tool?: {\n+ [key: string]: ToolDefinition\n+ }\n+ \n+ // Custom authentication providers\n+ auth?: AuthHook\n+ \n+ // Called when a new message is received\n+ \"chat.message\"?: (\n+ input: { sessionID: string; agent?: string; model?: { providerID: string; modelID: string }; messageID?: string },\n+ output: { message: UserMessage; parts: Part[] },\n+ ) => Promise<void>\n+ \n+ // Modify parameters sent to LLM\n+ \"chat.params\"?: (\n+ input: { sessionID: string; agent: string; model: Model; provider: ProviderContext; message: UserMessage },\n+ output: { temperature: number; topP: number; topK: number; options: Record<string, any> },\n+ ) => Promise<void>\n+ \n+ // Intercept permission requests\n+ \"permission.ask\"?: (input: Permission, output: { status: \"ask\" | \"deny\" | \"allow\" }) => Promise<void>\n+ \n+ // Before tool execution - can modify args\n+ \"tool.execute.before\"?: (\n+ input: { tool: string; sessionID: string; callID: string },\n+ output: { args: any },\n+ ) => Promise<void>\n+ \n+ // After tool execution - can modify output\n+ \"tool.execute.after\"?: (\n+ input: { tool: string; sessionID: string; callID: string },\n+ output: { title: string; output: string; metadata: any },\n+ ) => Promise<void>\n+ \n+ // Transform chat messages (experimental)\n+ \"experimental.chat.messages.transform\"?: (\n+ input: {},\n+ output: { messages: { info: Message; parts: Part[] }[] },\n+ ) => Promise<void>\n+ \n+ // Transform system prompt (experimental)\n+ \"experimental.chat.system.transform\"?: (\n+ input: {},\n+ output: { system: string[] },\n+ ) => Promise<void>\n+ \n+ // Add context during session compaction (experimental)\n+ \"experimental.session.compacting\"?: (\n+ input: { sessionID: string },\n+ output: { context: string[] },\n+ ) => Promise<void>\n+ \n+ // Transform completed text (experimental)\n+ \"experimental.text.complete\"?: (\n+ input: { sessionID: string; messageID: string; partID: string },\n+ output: { text: string },\n+ ) => Promise<void>\n }\n ```\n \n ### Plugin Location\n", | |
| "filediff": { | |
| "file": "/Users/themishkun/projects/tinkering/opencode-stats/ARCHITECTURE.md", | |
| "before": "# Architecture Document: OpenCode Stats Plugin\n\n## Overview\n\nThis document describes the technical architecture of the `opencode-stats` plugin, a \"Spotify Wrapped\"-style statistics visualization tool for OpenCode.\n\n---\n\n## Plugin Architecture\n\n### OpenCode Plugin System\n\nOpenCode plugins are JavaScript/TypeScript modules that run in the Bun runtime. They follow an async function pattern:\n\n```typescript\n// index.ts\nimport type { PluginContext, PluginHooks } from \"opencode\";\n\nexport default async function plugin(context: PluginContext): Promise<PluginHooks> {\n // Plugin initialization\n return {\n // Hook definitions\n };\n}\n```\n\n### Plugin Location\n\n```\n.opencode/\n└── plugin/\n └── opencode-stats/\n ├── index.ts # Main plugin entry\n ├── package.json # Dependencies\n └── src/\n ├── stats/ # Statistics computation\n ├── render/ # TUI rendering\n └── data/ # Data access layer\n```\n\n---\n\n## System Architecture\n\n```\n┌─────────────────────────────────────────────────────────────────┐\n│ OpenCode Host │\n├─────────────────────────────────────────────────────────────────┤\n│ │\n│ ┌─────────────────────────────────────────────────────────┐ │\n│ │ opencode-stats Plugin │ │\n│ ├─────────────────────────────────────────────────────────┤ │\n│ │ │ │\n│ │ ┌─────────────┐ ┌─────────────┐ ┌─────────────────┐ │ │\n│ │ │ Command │ │ Stats │ │ Renderer │ │ │\n│ │ │ Handler │──│ Engine │──│ (TUI) │ │ │\n│ │ └─────────────┘ └─────────────┘ └─────────────────┘ │ │\n│ │ │ │ │ │ │\n│ │ ▼ ▼ ▼ │ │\n│ │ ┌─────────────┐ ┌─────────────┐ ┌─────────────────┐ │ │\n│ │ │ Slash │ │ Data │ │ Components │ │ │\n│ │ │ Command │ │ Layer │ │ Library │ │ │\n│ │ └─────────────┘ └─────────────┘ └─────────────────┘ │ │\n│ │ │ │ │\n│ └──────────────────────────│─────────────────────────────┘ │\n│ │ │\n│ ▼ │\n│ ┌─────────────────────────────────────────────────────────┐ │\n│ │ OpenCode Session Storage │ │\n│ │ (SQLite / JSON) │ │\n│ └─────────────────────────────────────────────────────────┘ │\n│ │\n└─────────────────────────────────────────────────────────────────┘\n```\n\n---\n\n## Component Design\n\n### 1. Plugin Entry Point (`index.ts`)\n\n```typescript\nimport type { PluginContext, PluginHooks } from \"opencode\";\nimport { StatsCommand } from \"./src/commands/stats\";\nimport { StatsEngine } from \"./src/stats/engine\";\nimport { SessionDataProvider } from \"./src/data/sessions\";\n\nexport default async function plugin(context: PluginContext): Promise<PluginHooks> {\n const dataProvider = new SessionDataProvider(context);\n const statsEngine = new StatsEngine(dataProvider);\n const statsCommand = new StatsCommand(statsEngine);\n\n return {\n // Register the /stats slash command\n tool: {\n name: \"stats\",\n description: \"View your OpenCode usage statistics (Wrapped-style)\",\n parameters: z.object({\n period: z.enum([\"week\", \"month\", \"year\", \"all\"]).optional().default(\"month\"),\n view: z.enum([\"overview\", \"models\"]).optional().default(\"overview\"),\n }),\n execute: statsCommand.execute.bind(statsCommand),\n },\n };\n}\n```\n\n### 2. Data Layer (`src/data/`)\n\n#### Session Data Provider\n\nResponsible for accessing OpenCode's session storage.\n\n```typescript\n// src/data/sessions.ts\n\nexport interface Session {\n id: string;\n createdAt: Date;\n updatedAt: Date;\n messages: Message[];\n}\n\nexport interface Message {\n id: string;\n role: \"user\" | \"assistant\";\n timestamp: Date;\n model?: string;\n tokenCount?: {\n input: number;\n output: number;\n };\n}\n\nexport class SessionDataProvider {\n constructor(private context: PluginContext) {}\n\n async getSessions(options?: {\n from?: Date;\n to?: Date;\n limit?: number;\n }): Promise<Session[]> {\n // Access OpenCode's session list via context\n // Implementation depends on OpenCode's exposed APIs\n }\n\n async getSessionById(id: string): Promise<Session | null> {\n // Fetch a specific session with all messages\n }\n\n async getSessionSummaries(): Promise<SessionSummary[]> {\n // Lightweight fetch for stats computation\n }\n}\n```\n\n#### Data Models\n\n```typescript\n// src/data/models.ts\n\nexport interface SessionSummary {\n id: string;\n startTime: Date;\n endTime: Date;\n messageCount: number;\n totalTokens: number;\n models: string[];\n}\n\nexport interface DailyActivity {\n date: string; // YYYY-MM-DD\n sessionCount: number;\n totalTokens: number;\n totalDuration: number; // minutes\n}\n\nexport interface ModelUsage {\n model: string;\n sessionCount: number;\n messageCount: number;\n totalTokens: number;\n percentage: number;\n}\n```\n\n### 3. Statistics Engine (`src/stats/`)\n\n#### Core Engine\n\n```typescript\n// src/stats/engine.ts\n\nexport interface StatsResult {\n period: {\n start: Date;\n end: Date;\n days: number;\n };\n summary: {\n totalSessions: number;\n totalTokens: number;\n totalMessages: number;\n activeDays: number;\n currentStreak: number;\n longestStreak: number;\n longestSession: {\n id: string;\n duration: number; // minutes\n };\n peakHour: number; // 0-23\n favoriteModel: string;\n };\n dailyActivity: DailyActivity[];\n modelUsage: ModelUsage[];\n funFact: string;\n}\n\nexport class StatsEngine {\n constructor(private dataProvider: SessionDataProvider) {}\n\n async computeStats(options: {\n period: \"week\" | \"month\" | \"year\" | \"all\";\n }): Promise<StatsResult> {\n const sessions = await this.dataProvider.getSessions({\n from: this.getPeriodStart(options.period),\n });\n\n return {\n period: this.computePeriod(sessions, options.period),\n summary: this.computeSummary(sessions),\n dailyActivity: this.computeDailyActivity(sessions),\n modelUsage: this.computeModelUsage(sessions),\n funFact: this.generateFunFact(sessions),\n };\n }\n\n private computeSummary(sessions: Session[]): StatsResult[\"summary\"] {\n // Compute all summary statistics\n }\n\n private computeDailyActivity(sessions: Session[]): DailyActivity[] {\n // Aggregate sessions by day\n }\n\n private computeModelUsage(sessions: Session[]): ModelUsage[] {\n // Aggregate by model\n }\n\n private generateFunFact(sessions: Session[]): string {\n // Pick a fun comparison\n }\n}\n```\n\n#### Streak Calculator\n\n```typescript\n// src/stats/streaks.ts\n\nexport interface StreakResult {\n current: number;\n longest: number;\n currentStart?: Date;\n longestStart?: Date;\n longestEnd?: Date;\n}\n\nexport function calculateStreaks(dailyActivity: DailyActivity[]): StreakResult {\n // Sort by date\n const sorted = [...dailyActivity].sort(\n (a, b) => new Date(a.date).getTime() - new Date(b.date).getTime()\n );\n\n let current = 0;\n let longest = 0;\n let streak = 0;\n let prevDate: Date | null = null;\n\n for (const day of sorted) {\n const date = new Date(day.date);\n if (prevDate && isConsecutiveDay(prevDate, date)) {\n streak++;\n } else {\n streak = 1;\n }\n\n if (streak > longest) longest = streak;\n prevDate = date;\n }\n\n // Check if streak continues to today\n const today = new Date();\n today.setHours(0, 0, 0, 0);\n \n if (prevDate && isConsecutiveDay(prevDate, today)) {\n current = streak;\n } else if (prevDate?.getTime() === today.getTime()) {\n current = streak;\n }\n\n return { current, longest };\n}\n\nfunction isConsecutiveDay(a: Date, b: Date): boolean {\n const diff = b.getTime() - a.getTime();\n return diff === 24 * 60 * 60 * 1000;\n}\n```\n\n#### Fun Facts Generator\n\n```typescript\n// src/stats/funfacts.ts\n\ninterface FunFactTemplate {\n condition: (stats: StatsResult) => boolean;\n generate: (stats: StatsResult) => string;\n}\n\nconst FUN_FACTS: FunFactTemplate[] = [\n {\n condition: (s) => s.summary.longestSession.duration > 148, // Inception length\n generate: (s) => {\n const times = Math.round(s.summary.longestSession.duration / 148);\n return `Your longest session is ~${times}x longer than the movie Inception`;\n },\n },\n {\n condition: (s) => s.summary.totalTokens > 587287, // War and Peace word count\n generate: (s) => {\n const times = Math.round(s.summary.totalTokens / 587287);\n return `You've used ${times}x more tokens than words in War and Peace`;\n },\n },\n {\n condition: (s) => s.summary.currentStreak >= 7,\n generate: (s) => \n `Your ${s.summary.currentStreak}-day streak is longer than most New Year resolutions`,\n },\n {\n condition: (s) => s.summary.peakHour >= 22 || s.summary.peakHour <= 4,\n generate: () => `You're a night owl coder - peak activity is after dark`,\n },\n {\n condition: (s) => s.summary.peakHour >= 5 && s.summary.peakHour <= 8,\n generate: () => `Early bird catches the bugs - you code best at dawn`,\n },\n // More fun facts...\n];\n\nexport function generateFunFact(stats: StatsResult): string {\n const applicable = FUN_FACTS.filter((f) => f.condition(stats));\n if (applicable.length === 0) {\n return `You've had ${stats.summary.totalSessions} coding sessions - keep going!`;\n }\n const random = applicable[Math.floor(Math.random() * applicable.length)];\n return random.generate(stats);\n}\n```\n\n### 4. Renderer (`src/render/`)\n\n#### Renderer Interface\n\n```typescript\n// src/render/types.ts\n\nexport interface RenderContext {\n width: number;\n height: number;\n colors: boolean;\n}\n\nexport interface Renderer {\n render(stats: StatsResult, view: \"overview\" | \"models\"): string;\n}\n```\n\n#### Heatmap Component\n\n```typescript\n// src/render/components/heatmap.ts\n\nconst INTENSITY_CHARS = [\" \", \"░\", \"▒\", \"▓\", \"█\"];\nconst DAYS = [\"\", \"Mon\", \"\", \"Wed\", \"\", \"Fri\", \"\"];\nconst MONTHS = [\"Jan\", \"Feb\", \"Mar\", \"Apr\", \"May\", \"Jun\", \n \"Jul\", \"Aug\", \"Sep\", \"Oct\", \"Nov\", \"Dec\"];\n\nexport function renderHeatmap(\n dailyActivity: DailyActivity[],\n options: { weeks: number; colors: boolean }\n): string[] {\n const lines: string[] = [];\n \n // Build activity map\n const activityMap = new Map<string, number>();\n dailyActivity.forEach((d) => {\n activityMap.set(d.date, d.sessionCount);\n });\n\n // Calculate intensity thresholds\n const maxActivity = Math.max(...dailyActivity.map((d) => d.sessionCount), 1);\n const getIntensity = (count: number): number => {\n if (count === 0) return 0;\n return Math.min(4, Math.ceil((count / maxActivity) * 4));\n };\n\n // Generate header (months)\n const headerLine = \" \" + generateMonthHeader(options.weeks);\n lines.push(headerLine);\n\n // Generate each day row\n for (let dayOfWeek = 0; dayOfWeek < 7; dayOfWeek++) {\n let line = DAYS[dayOfWeek].padEnd(4);\n \n for (let week = 0; week < options.weeks; week++) {\n const date = getDateForWeekDay(week, dayOfWeek, options.weeks);\n const dateStr = formatDate(date);\n const count = activityMap.get(dateStr) || 0;\n const char = INTENSITY_CHARS[getIntensity(count)];\n line += char + \" \";\n }\n \n lines.push(line);\n }\n\n // Legend\n lines.push(\"\");\n lines.push(\" Less \" + INTENSITY_CHARS.slice(1).join(\" \") + \" More\");\n\n return lines;\n}\n```\n\n#### Stats Dashboard Component\n\n```typescript\n// src/render/components/dashboard.ts\n\nexport function renderDashboard(summary: StatsResult[\"summary\"]): string[] {\n const lines: string[] = [];\n \n const formatDuration = (minutes: number): string => {\n const days = Math.floor(minutes / 1440);\n const hours = Math.floor((minutes % 1440) / 60);\n const mins = minutes % 60;\n \n const parts = [];\n if (days > 0) parts.push(`${days}d`);\n if (hours > 0) parts.push(`${hours}h`);\n if (mins > 0) parts.push(`${mins}m`);\n return parts.join(\" \") || \"0m\";\n };\n\n const formatNumber = (n: number): string => {\n if (n >= 1000000) return `${(n / 1000000).toFixed(1)}m`;\n if (n >= 1000) return `${(n / 1000).toFixed(1)}k`;\n return n.toString();\n };\n\n const leftCol = [\n `Favorite model: ${summary.favoriteModel}`,\n \"\",\n `Sessions: ${summary.totalSessions}`,\n `Current streak: ${summary.currentStreak} days`,\n `Active days: ${summary.activeDays}`,\n ];\n\n const rightCol = [\n `Total tokens: ${formatNumber(summary.totalTokens)}`,\n \"\",\n `Longest session: ${formatDuration(summary.longestSession.duration)}`,\n `Longest streak: ${summary.longestStreak} days`,\n `Peak hour: ${summary.peakHour}:00-${summary.peakHour + 1}:00`,\n ];\n\n // Combine columns\n const maxLeftWidth = Math.max(...leftCol.map((l) => l.length));\n const padding = 4;\n\n for (let i = 0; i < leftCol.length; i++) {\n lines.push(\n leftCol[i].padEnd(maxLeftWidth + padding) + rightCol[i]\n );\n }\n\n return lines;\n}\n```\n\n#### Model Usage Bar Chart\n\n```typescript\n// src/render/components/models.ts\n\nexport function renderModelUsage(\n modelUsage: ModelUsage[],\n options: { width: number }\n): string[] {\n const lines: string[] = [];\n const barWidth = options.width - 40; // Space for label and percentage\n\n const sorted = [...modelUsage].sort((a, b) => b.percentage - a.percentage);\n\n for (const model of sorted.slice(0, 5)) {\n const filled = Math.round((model.percentage / 100) * barWidth);\n const empty = barWidth - filled;\n const bar = \"█\".repeat(filled) + \"░\".repeat(empty);\n const label = model.model.padEnd(28);\n const pct = `${Math.round(model.percentage)}%`.padStart(4);\n \n lines.push(` ${label} ${bar} ${pct}`);\n }\n\n return lines;\n}\n```\n\n#### Main Renderer\n\n```typescript\n// src/render/index.ts\n\nimport { renderHeatmap } from \"./components/heatmap\";\nimport { renderDashboard } from \"./components/dashboard\";\nimport { renderModelUsage } from \"./components/models\";\n\nexport class StatsRenderer implements Renderer {\n constructor(private context: RenderContext) {}\n\n render(stats: StatsResult, view: \"overview\" | \"models\"): string {\n const lines: string[] = [];\n \n // Header\n lines.push(\"\");\n const tabs = view === \"overview\" \n ? \" [Overview] Models (tab to cycle)\"\n : \" Overview [Models] (tab to cycle)\";\n lines.push(tabs);\n lines.push(\"\");\n\n if (view === \"overview\") {\n // Heatmap\n const heatmap = renderHeatmap(stats.dailyActivity, {\n weeks: 52,\n colors: this.context.colors,\n });\n lines.push(...heatmap);\n lines.push(\"\");\n\n // Dashboard stats\n const dashboard = renderDashboard(stats.summary);\n lines.push(...dashboard);\n lines.push(\"\");\n\n // Fun fact\n lines.push(` ${stats.funFact}`);\n lines.push(` Stats from the last ${stats.period.days} days`);\n } else {\n // Model breakdown\n const models = renderModelUsage(stats.modelUsage, {\n width: this.context.width,\n });\n lines.push(...models);\n }\n\n lines.push(\"\");\n return lines.join(\"\\n\");\n }\n}\n```\n\n### 5. Command Handler (`src/commands/`)\n\n```typescript\n// src/commands/stats.ts\n\nimport { z } from \"zod\";\nimport type { ToolExecuteParams } from \"opencode\";\nimport { StatsEngine } from \"../stats/engine\";\nimport { StatsRenderer } from \"../render\";\n\nexport class StatsCommand {\n constructor(private engine: StatsEngine) {}\n\n async execute(params: ToolExecuteParams<{\n period?: \"week\" | \"month\" | \"year\" | \"all\";\n view?: \"overview\" | \"models\";\n }>) {\n const { period = \"month\", view = \"overview\" } = params.input;\n\n try {\n const stats = await this.engine.computeStats({ period });\n \n const renderer = new StatsRenderer({\n width: process.stdout.columns || 80,\n height: process.stdout.rows || 24,\n colors: process.stdout.isTTY ?? false,\n });\n\n const output = renderer.render(stats, view);\n \n return {\n content: output,\n metadata: {\n totalSessions: stats.summary.totalSessions,\n period: stats.period,\n },\n };\n } catch (error) {\n return {\n content: `Error computing stats: ${error.message}`,\n isError: true,\n };\n }\n }\n}\n```\n\n---\n\n## Data Flow\n\n```\n┌──────────────────────────────────────────────────────────────────┐\n│ User invokes /stats │\n└──────────────────────────────────────────────────────────────────┘\n │\n ▼\n┌──────────────────────────────────────────────────────────────────┐\n│ StatsCommand.execute() │\n│ - Parse parameters (period, view) │\n│ - Validate inputs │\n└──────────────────────────────────────────────────────────────────┘\n │\n ▼\n┌──────────────────────────────────────────────────────────────────┐\n│ StatsEngine.computeStats() │\n│ - Fetch session data from provider │\n│ - Compute summary statistics │\n│ - Calculate streaks │\n│ - Aggregate daily activity │\n│ - Compute model usage │\n│ - Generate fun fact │\n└──────────────────────────────────────────────────────────────────┘\n │\n ▼\n┌──────────────────────────────────────────────────────────────────┐\n│ SessionDataProvider.getSessions() │\n│ - Access OpenCode session storage │\n│ - Filter by date range │\n│ - Return session summaries │\n└──────────────────────────────────────────────────────────────────┘\n │\n ▼\n┌──────────────────────────────────────────────────────────────────┐\n│ StatsRenderer.render() │\n│ - Select view (overview/models) │\n│ - Compose components │\n│ - Generate ASCII output │\n└──────────────────────────────────────────────────────────────────┘\n │\n ▼\n┌──────────────────────────────────────────────────────────────────┐\n│ Display output to user │\n└──────────────────────────────────────────────────────────────────┘\n```\n\n---\n\n## File Structure\n\n```\nopencode-stats/\n├── index.ts # Plugin entry point\n├── package.json # Dependencies and metadata\n├── tsconfig.json # TypeScript configuration\n├── README.md # Plugin documentation\n│\n├── src/\n│ ├── commands/\n│ │ └── stats.ts # Slash command handler\n│ │\n│ ├── data/\n│ │ ├── sessions.ts # Session data provider\n│ │ └── models.ts # Data models/interfaces\n│ │\n│ ├── stats/\n│ │ ├── engine.ts # Main statistics engine\n│ │ ├── streaks.ts # Streak calculation\n│ │ ├── funfacts.ts # Fun fact generator\n│ │ └── aggregators.ts # Data aggregation utilities\n│ │\n│ └── render/\n│ ├── index.ts # Main renderer\n│ ├── types.ts # Render interfaces\n│ └── components/\n│ ├── heatmap.ts # Activity heatmap\n│ ├── dashboard.ts # Stats dashboard\n│ ├── models.ts # Model usage chart\n│ └── box.ts # Box drawing utilities\n│\n└── tests/\n ├── stats/\n │ ├── engine.test.ts\n │ └── streaks.test.ts\n └── render/\n └── components.test.ts\n```\n\n---\n\n## Dependencies\n\n```json\n{\n \"name\": \"opencode-stats\",\n \"version\": \"1.0.0\",\n \"type\": \"module\",\n \"main\": \"index.ts\",\n \"dependencies\": {\n \"zod\": \"^3.22.0\"\n },\n \"devDependencies\": {\n \"@types/bun\": \"latest\",\n \"typescript\": \"^5.0.0\"\n },\n \"peerDependencies\": {\n \"opencode\": \">=0.1.0\"\n }\n}\n```\n\n---\n\n## Configuration\n\n### Plugin Configuration (`opencode.json`)\n\n```json\n{\n \"plugins\": {\n \"opencode-stats\": {\n \"enabled\": true,\n \"options\": {\n \"defaultPeriod\": \"month\",\n \"cacheEnabled\": true,\n \"cacheTTL\": 300\n }\n }\n }\n}\n```\n\n### Environment Variables\n\n| Variable | Description | Default |\n|----------|-------------|---------|\n| `OPENCODE_STATS_CACHE` | Enable caching | `true` |\n| `OPENCODE_STATS_CACHE_TTL` | Cache TTL in seconds | `300` |\n\n---\n\n## Testing Strategy\n\n### Unit Tests\n\n- Statistics calculations (streaks, aggregations)\n- Render component output\n- Fun fact generation\n\n### Integration Tests\n\n- Full stats computation with mock data\n- Command execution flow\n\n### Manual Testing\n\n- Various terminal sizes\n- Color/no-color modes\n- Large session histories\n\n---\n\n## Performance Considerations\n\n### Caching Strategy\n\n```typescript\ninterface CacheEntry {\n stats: StatsResult;\n computedAt: Date;\n sessionCount: number;\n}\n\nclass StatsCache {\n private cache: Map<string, CacheEntry> = new Map();\n private ttl: number;\n\n constructor(ttlSeconds: number = 300) {\n this.ttl = ttlSeconds * 1000;\n }\n\n get(period: string): StatsResult | null {\n const entry = this.cache.get(period);\n if (!entry) return null;\n \n const age = Date.now() - entry.computedAt.getTime();\n if (age > this.ttl) {\n this.cache.delete(period);\n return null;\n }\n \n return entry.stats;\n }\n\n set(period: string, stats: StatsResult, sessionCount: number): void {\n this.cache.set(period, {\n stats,\n computedAt: new Date(),\n sessionCount,\n });\n }\n\n invalidate(): void {\n this.cache.clear();\n }\n}\n```\n\n### Lazy Loading\n\n- Load only session summaries for initial stats\n- Fetch full session data only when needed (e.g., longest session details)\n\n---\n\n## Security Considerations\n\n1. **Read-only access:** Plugin only reads session data, never writes\n2. **Local processing:** All computation happens locally\n3. **No network calls:** No telemetry or external API calls\n4. **Sandboxed execution:** Runs within OpenCode's plugin sandbox\n\n---\n\n## Future Extensibility\n\n### Planned Extensions\n\n1. **Export API:** Allow other plugins to access stats\n2. **Webhook integration:** Post stats to external services\n3. **Custom metrics:** User-defined stat tracking\n4. **Themes:** Customizable color schemes\n\n### Extension Points\n\n```typescript\n// Future: Plugin extension API\ninterface StatsExtension {\n // Add custom metrics\n metrics?: CustomMetric[];\n \n // Add custom fun facts\n funFacts?: FunFactTemplate[];\n \n // Add custom views\n views?: CustomView[];\n}\n```\n\n---\n\n## Open Questions for Implementation\n\n1. **Session Data Access:**\n - How does OpenCode expose session list to plugins?\n - Is there a direct API or do we need to use events?\n - What's the schema of session/message data?\n\n2. **Rendering:**\n - Can plugins render full-screen TUI views?\n - How do we handle keyboard input (tab to switch views)?\n - Is there a blessed/ink integration or raw terminal output?\n\n3. **Token Counting:**\n - Is token count available per message?\n - If not, how do we estimate it?\n\n4. **Plugin Lifecycle:**\n - When is the plugin loaded/unloaded?\n - Can we persist cache between sessions?\n", | |
| "after": "# Architecture Document: OpenCode Stats Plugin\n\n## Overview\n\nThis document describes the technical architecture of the `opencode-stats` plugin, a \"Spotify Wrapped\"-style statistics visualization tool for OpenCode.\n\n---\n\n## Plugin Architecture\n\n### OpenCode Plugin System\n\nOpenCode plugins are JavaScript/TypeScript modules that run in the Bun runtime. They follow an async function pattern that receives a `PluginInput` and returns `Hooks`.\n\n#### Plugin Input (What plugins receive)\n\n```typescript\n// From @opencode-ai/plugin\nexport type PluginInput = {\n client: ReturnType<typeof createOpencodeClient> // SDK client for API access\n project: Project // Current project info\n directory: string // Project directory\n worktree: string // Git worktree path\n $: BunShell // Bun shell for running commands\n}\n\nexport type Plugin = (input: PluginInput) => Promise<Hooks>\n```\n\n#### Available Hooks\n\n```typescript\nexport interface Hooks {\n // Listen to OpenCode events (session created, message created, etc.)\n event?: (input: { event: Event }) => Promise<void>\n \n // Modify OpenCode configuration\n config?: (input: Config) => Promise<void>\n \n // Define custom tools (slash commands)\n tool?: {\n [key: string]: ToolDefinition\n }\n \n // Custom authentication providers\n auth?: AuthHook\n \n // Called when a new message is received\n \"chat.message\"?: (\n input: { sessionID: string; agent?: string; model?: { providerID: string; modelID: string }; messageID?: string },\n output: { message: UserMessage; parts: Part[] },\n ) => Promise<void>\n \n // Modify parameters sent to LLM\n \"chat.params\"?: (\n input: { sessionID: string; agent: string; model: Model; provider: ProviderContext; message: UserMessage },\n output: { temperature: number; topP: number; topK: number; options: Record<string, any> },\n ) => Promise<void>\n \n // Intercept permission requests\n \"permission.ask\"?: (input: Permission, output: { status: \"ask\" | \"deny\" | \"allow\" }) => Promise<void>\n \n // Before tool execution - can modify args\n \"tool.execute.before\"?: (\n input: { tool: string; sessionID: string; callID: string },\n output: { args: any },\n ) => Promise<void>\n \n // After tool execution - can modify output\n \"tool.execute.after\"?: (\n input: { tool: string; sessionID: string; callID: string },\n output: { title: string; output: string; metadata: any },\n ) => Promise<void>\n \n // Transform chat messages (experimental)\n \"experimental.chat.messages.transform\"?: (\n input: {},\n output: { messages: { info: Message; parts: Part[] }[] },\n ) => Promise<void>\n \n // Transform system prompt (experimental)\n \"experimental.chat.system.transform\"?: (\n input: {},\n output: { system: string[] },\n ) => Promise<void>\n \n // Add context during session compaction (experimental)\n \"experimental.session.compacting\"?: (\n input: { sessionID: string },\n output: { context: string[] },\n ) => Promise<void>\n \n // Transform completed text (experimental)\n \"experimental.text.complete\"?: (\n input: { sessionID: string; messageID: string; partID: string },\n output: { text: string },\n ) => Promise<void>\n}\n```\n\n### Plugin Location\n\n```\n.opencode/\n└── plugin/\n └── opencode-stats/\n ├── index.ts # Main plugin entry\n ├── package.json # Dependencies\n └── src/\n ├── stats/ # Statistics computation\n ├── render/ # TUI rendering\n └── data/ # Data access layer\n```\n\n---\n\n## System Architecture\n\n```\n┌─────────────────────────────────────────────────────────────────┐\n│ OpenCode Host │\n├─────────────────────────────────────────────────────────────────┤\n│ │\n│ ┌─────────────────────────────────────────────────────────┐ │\n│ │ opencode-stats Plugin │ │\n│ ├─────────────────────────────────────────────────────────┤ │\n│ │ │ │\n│ │ ┌─────────────┐ ┌─────────────┐ ┌─────────────────┐ │ │\n│ │ │ Command │ │ Stats │ │ Renderer │ │ │\n│ │ │ Handler │──│ Engine │──│ (TUI) │ │ │\n│ │ └─────────────┘ └─────────────┘ └─────────────────┘ │ │\n│ │ │ │ │ │ │\n│ │ ▼ ▼ ▼ │ │\n│ │ ┌─────────────┐ ┌─────────────┐ ┌─────────────────┐ │ │\n│ │ │ Slash │ │ Data │ │ Components │ │ │\n│ │ │ Command │ │ Layer │ │ Library │ │ │\n│ │ └─────────────┘ └─────────────┘ └─────────────────┘ │ │\n│ │ │ │ │\n│ └──────────────────────────│─────────────────────────────┘ │\n│ │ │\n│ ▼ │\n│ ┌─────────────────────────────────────────────────────────┐ │\n│ │ OpenCode Session Storage │ │\n│ │ (SQLite / JSON) │ │\n│ └─────────────────────────────────────────────────────────┘ │\n│ │\n└─────────────────────────────────────────────────────────────────┘\n```\n\n---\n\n## Component Design\n\n### 1. Plugin Entry Point (`index.ts`)\n\n```typescript\nimport type { PluginContext, PluginHooks } from \"opencode\";\nimport { StatsCommand } from \"./src/commands/stats\";\nimport { StatsEngine } from \"./src/stats/engine\";\nimport { SessionDataProvider } from \"./src/data/sessions\";\n\nexport default async function plugin(context: PluginContext): Promise<PluginHooks> {\n const dataProvider = new SessionDataProvider(context);\n const statsEngine = new StatsEngine(dataProvider);\n const statsCommand = new StatsCommand(statsEngine);\n\n return {\n // Register the /stats slash command\n tool: {\n name: \"stats\",\n description: \"View your OpenCode usage statistics (Wrapped-style)\",\n parameters: z.object({\n period: z.enum([\"week\", \"month\", \"year\", \"all\"]).optional().default(\"month\"),\n view: z.enum([\"overview\", \"models\"]).optional().default(\"overview\"),\n }),\n execute: statsCommand.execute.bind(statsCommand),\n },\n };\n}\n```\n\n### 2. Data Layer (`src/data/`)\n\n#### Session Data Provider\n\nResponsible for accessing OpenCode's session storage.\n\n```typescript\n// src/data/sessions.ts\n\nexport interface Session {\n id: string;\n createdAt: Date;\n updatedAt: Date;\n messages: Message[];\n}\n\nexport interface Message {\n id: string;\n role: \"user\" | \"assistant\";\n timestamp: Date;\n model?: string;\n tokenCount?: {\n input: number;\n output: number;\n };\n}\n\nexport class SessionDataProvider {\n constructor(private context: PluginContext) {}\n\n async getSessions(options?: {\n from?: Date;\n to?: Date;\n limit?: number;\n }): Promise<Session[]> {\n // Access OpenCode's session list via context\n // Implementation depends on OpenCode's exposed APIs\n }\n\n async getSessionById(id: string): Promise<Session | null> {\n // Fetch a specific session with all messages\n }\n\n async getSessionSummaries(): Promise<SessionSummary[]> {\n // Lightweight fetch for stats computation\n }\n}\n```\n\n#### Data Models\n\n```typescript\n// src/data/models.ts\n\nexport interface SessionSummary {\n id: string;\n startTime: Date;\n endTime: Date;\n messageCount: number;\n totalTokens: number;\n models: string[];\n}\n\nexport interface DailyActivity {\n date: string; // YYYY-MM-DD\n sessionCount: number;\n totalTokens: number;\n totalDuration: number; // minutes\n}\n\nexport interface ModelUsage {\n model: string;\n sessionCount: number;\n messageCount: number;\n totalTokens: number;\n percentage: number;\n}\n```\n\n### 3. Statistics Engine (`src/stats/`)\n\n#### Core Engine\n\n```typescript\n// src/stats/engine.ts\n\nexport interface StatsResult {\n period: {\n start: Date;\n end: Date;\n days: number;\n };\n summary: {\n totalSessions: number;\n totalTokens: number;\n totalMessages: number;\n activeDays: number;\n currentStreak: number;\n longestStreak: number;\n longestSession: {\n id: string;\n duration: number; // minutes\n };\n peakHour: number; // 0-23\n favoriteModel: string;\n };\n dailyActivity: DailyActivity[];\n modelUsage: ModelUsage[];\n funFact: string;\n}\n\nexport class StatsEngine {\n constructor(private dataProvider: SessionDataProvider) {}\n\n async computeStats(options: {\n period: \"week\" | \"month\" | \"year\" | \"all\";\n }): Promise<StatsResult> {\n const sessions = await this.dataProvider.getSessions({\n from: this.getPeriodStart(options.period),\n });\n\n return {\n period: this.computePeriod(sessions, options.period),\n summary: this.computeSummary(sessions),\n dailyActivity: this.computeDailyActivity(sessions),\n modelUsage: this.computeModelUsage(sessions),\n funFact: this.generateFunFact(sessions),\n };\n }\n\n private computeSummary(sessions: Session[]): StatsResult[\"summary\"] {\n // Compute all summary statistics\n }\n\n private computeDailyActivity(sessions: Session[]): DailyActivity[] {\n // Aggregate sessions by day\n }\n\n private computeModelUsage(sessions: Session[]): ModelUsage[] {\n // Aggregate by model\n }\n\n private generateFunFact(sessions: Session[]): string {\n // Pick a fun comparison\n }\n}\n```\n\n#### Streak Calculator\n\n```typescript\n// src/stats/streaks.ts\n\nexport interface StreakResult {\n current: number;\n longest: number;\n currentStart?: Date;\n longestStart?: Date;\n longestEnd?: Date;\n}\n\nexport function calculateStreaks(dailyActivity: DailyActivity[]): StreakResult {\n // Sort by date\n const sorted = [...dailyActivity].sort(\n (a, b) => new Date(a.date).getTime() - new Date(b.date).getTime()\n );\n\n let current = 0;\n let longest = 0;\n let streak = 0;\n let prevDate: Date | null = null;\n\n for (const day of sorted) {\n const date = new Date(day.date);\n if (prevDate && isConsecutiveDay(prevDate, date)) {\n streak++;\n } else {\n streak = 1;\n }\n\n if (streak > longest) longest = streak;\n prevDate = date;\n }\n\n // Check if streak continues to today\n const today = new Date();\n today.setHours(0, 0, 0, 0);\n \n if (prevDate && isConsecutiveDay(prevDate, today)) {\n current = streak;\n } else if (prevDate?.getTime() === today.getTime()) {\n current = streak;\n }\n\n return { current, longest };\n}\n\nfunction isConsecutiveDay(a: Date, b: Date): boolean {\n const diff = b.getTime() - a.getTime();\n return diff === 24 * 60 * 60 * 1000;\n}\n```\n\n#### Fun Facts Generator\n\n```typescript\n// src/stats/funfacts.ts\n\ninterface FunFactTemplate {\n condition: (stats: StatsResult) => boolean;\n generate: (stats: StatsResult) => string;\n}\n\nconst FUN_FACTS: FunFactTemplate[] = [\n {\n condition: (s) => s.summary.longestSession.duration > 148, // Inception length\n generate: (s) => {\n const times = Math.round(s.summary.longestSession.duration / 148);\n return `Your longest session is ~${times}x longer than the movie Inception`;\n },\n },\n {\n condition: (s) => s.summary.totalTokens > 587287, // War and Peace word count\n generate: (s) => {\n const times = Math.round(s.summary.totalTokens / 587287);\n return `You've used ${times}x more tokens than words in War and Peace`;\n },\n },\n {\n condition: (s) => s.summary.currentStreak >= 7,\n generate: (s) => \n `Your ${s.summary.currentStreak}-day streak is longer than most New Year resolutions`,\n },\n {\n condition: (s) => s.summary.peakHour >= 22 || s.summary.peakHour <= 4,\n generate: () => `You're a night owl coder - peak activity is after dark`,\n },\n {\n condition: (s) => s.summary.peakHour >= 5 && s.summary.peakHour <= 8,\n generate: () => `Early bird catches the bugs - you code best at dawn`,\n },\n // More fun facts...\n];\n\nexport function generateFunFact(stats: StatsResult): string {\n const applicable = FUN_FACTS.filter((f) => f.condition(stats));\n if (applicable.length === 0) {\n return `You've had ${stats.summary.totalSessions} coding sessions - keep going!`;\n }\n const random = applicable[Math.floor(Math.random() * applicable.length)];\n return random.generate(stats);\n}\n```\n\n### 4. Renderer (`src/render/`)\n\n#### Renderer Interface\n\n```typescript\n// src/render/types.ts\n\nexport interface RenderContext {\n width: number;\n height: number;\n colors: boolean;\n}\n\nexport interface Renderer {\n render(stats: StatsResult, view: \"overview\" | \"models\"): string;\n}\n```\n\n#### Heatmap Component\n\n```typescript\n// src/render/components/heatmap.ts\n\nconst INTENSITY_CHARS = [\" \", \"░\", \"▒\", \"▓\", \"█\"];\nconst DAYS = [\"\", \"Mon\", \"\", \"Wed\", \"\", \"Fri\", \"\"];\nconst MONTHS = [\"Jan\", \"Feb\", \"Mar\", \"Apr\", \"May\", \"Jun\", \n \"Jul\", \"Aug\", \"Sep\", \"Oct\", \"Nov\", \"Dec\"];\n\nexport function renderHeatmap(\n dailyActivity: DailyActivity[],\n options: { weeks: number; colors: boolean }\n): string[] {\n const lines: string[] = [];\n \n // Build activity map\n const activityMap = new Map<string, number>();\n dailyActivity.forEach((d) => {\n activityMap.set(d.date, d.sessionCount);\n });\n\n // Calculate intensity thresholds\n const maxActivity = Math.max(...dailyActivity.map((d) => d.sessionCount), 1);\n const getIntensity = (count: number): number => {\n if (count === 0) return 0;\n return Math.min(4, Math.ceil((count / maxActivity) * 4));\n };\n\n // Generate header (months)\n const headerLine = \" \" + generateMonthHeader(options.weeks);\n lines.push(headerLine);\n\n // Generate each day row\n for (let dayOfWeek = 0; dayOfWeek < 7; dayOfWeek++) {\n let line = DAYS[dayOfWeek].padEnd(4);\n \n for (let week = 0; week < options.weeks; week++) {\n const date = getDateForWeekDay(week, dayOfWeek, options.weeks);\n const dateStr = formatDate(date);\n const count = activityMap.get(dateStr) || 0;\n const char = INTENSITY_CHARS[getIntensity(count)];\n line += char + \" \";\n }\n \n lines.push(line);\n }\n\n // Legend\n lines.push(\"\");\n lines.push(\" Less \" + INTENSITY_CHARS.slice(1).join(\" \") + \" More\");\n\n return lines;\n}\n```\n\n#### Stats Dashboard Component\n\n```typescript\n// src/render/components/dashboard.ts\n\nexport function renderDashboard(summary: StatsResult[\"summary\"]): string[] {\n const lines: string[] = [];\n \n const formatDuration = (minutes: number): string => {\n const days = Math.floor(minutes / 1440);\n const hours = Math.floor((minutes % 1440) / 60);\n const mins = minutes % 60;\n \n const parts = [];\n if (days > 0) parts.push(`${days}d`);\n if (hours > 0) parts.push(`${hours}h`);\n if (mins > 0) parts.push(`${mins}m`);\n return parts.join(\" \") || \"0m\";\n };\n\n const formatNumber = (n: number): string => {\n if (n >= 1000000) return `${(n / 1000000).toFixed(1)}m`;\n if (n >= 1000) return `${(n / 1000).toFixed(1)}k`;\n return n.toString();\n };\n\n const leftCol = [\n `Favorite model: ${summary.favoriteModel}`,\n \"\",\n `Sessions: ${summary.totalSessions}`,\n `Current streak: ${summary.currentStreak} days`,\n `Active days: ${summary.activeDays}`,\n ];\n\n const rightCol = [\n `Total tokens: ${formatNumber(summary.totalTokens)}`,\n \"\",\n `Longest session: ${formatDuration(summary.longestSession.duration)}`,\n `Longest streak: ${summary.longestStreak} days`,\n `Peak hour: ${summary.peakHour}:00-${summary.peakHour + 1}:00`,\n ];\n\n // Combine columns\n const maxLeftWidth = Math.max(...leftCol.map((l) => l.length));\n const padding = 4;\n\n for (let i = 0; i < leftCol.length; i++) {\n lines.push(\n leftCol[i].padEnd(maxLeftWidth + padding) + rightCol[i]\n );\n }\n\n return lines;\n}\n```\n\n#### Model Usage Bar Chart\n\n```typescript\n// src/render/components/models.ts\n\nexport function renderModelUsage(\n modelUsage: ModelUsage[],\n options: { width: number }\n): string[] {\n const lines: string[] = [];\n const barWidth = options.width - 40; // Space for label and percentage\n\n const sorted = [...modelUsage].sort((a, b) => b.percentage - a.percentage);\n\n for (const model of sorted.slice(0, 5)) {\n const filled = Math.round((model.percentage / 100) * barWidth);\n const empty = barWidth - filled;\n const bar = \"█\".repeat(filled) + \"░\".repeat(empty);\n const label = model.model.padEnd(28);\n const pct = `${Math.round(model.percentage)}%`.padStart(4);\n \n lines.push(` ${label} ${bar} ${pct}`);\n }\n\n return lines;\n}\n```\n\n#### Main Renderer\n\n```typescript\n// src/render/index.ts\n\nimport { renderHeatmap } from \"./components/heatmap\";\nimport { renderDashboard } from \"./components/dashboard\";\nimport { renderModelUsage } from \"./components/models\";\n\nexport class StatsRenderer implements Renderer {\n constructor(private context: RenderContext) {}\n\n render(stats: StatsResult, view: \"overview\" | \"models\"): string {\n const lines: string[] = [];\n \n // Header\n lines.push(\"\");\n const tabs = view === \"overview\" \n ? \" [Overview] Models (tab to cycle)\"\n : \" Overview [Models] (tab to cycle)\";\n lines.push(tabs);\n lines.push(\"\");\n\n if (view === \"overview\") {\n // Heatmap\n const heatmap = renderHeatmap(stats.dailyActivity, {\n weeks: 52,\n colors: this.context.colors,\n });\n lines.push(...heatmap);\n lines.push(\"\");\n\n // Dashboard stats\n const dashboard = renderDashboard(stats.summary);\n lines.push(...dashboard);\n lines.push(\"\");\n\n // Fun fact\n lines.push(` ${stats.funFact}`);\n lines.push(` Stats from the last ${stats.period.days} days`);\n } else {\n // Model breakdown\n const models = renderModelUsage(stats.modelUsage, {\n width: this.context.width,\n });\n lines.push(...models);\n }\n\n lines.push(\"\");\n return lines.join(\"\\n\");\n }\n}\n```\n\n### 5. Command Handler (`src/commands/`)\n\n```typescript\n// src/commands/stats.ts\n\nimport { z } from \"zod\";\nimport type { ToolExecuteParams } from \"opencode\";\nimport { StatsEngine } from \"../stats/engine\";\nimport { StatsRenderer } from \"../render\";\n\nexport class StatsCommand {\n constructor(private engine: StatsEngine) {}\n\n async execute(params: ToolExecuteParams<{\n period?: \"week\" | \"month\" | \"year\" | \"all\";\n view?: \"overview\" | \"models\";\n }>) {\n const { period = \"month\", view = \"overview\" } = params.input;\n\n try {\n const stats = await this.engine.computeStats({ period });\n \n const renderer = new StatsRenderer({\n width: process.stdout.columns || 80,\n height: process.stdout.rows || 24,\n colors: process.stdout.isTTY ?? false,\n });\n\n const output = renderer.render(stats, view);\n \n return {\n content: output,\n metadata: {\n totalSessions: stats.summary.totalSessions,\n period: stats.period,\n },\n };\n } catch (error) {\n return {\n content: `Error computing stats: ${error.message}`,\n isError: true,\n };\n }\n }\n}\n```\n\n---\n\n## Data Flow\n\n```\n┌──────────────────────────────────────────────────────────────────┐\n│ User invokes /stats │\n└──────────────────────────────────────────────────────────────────┘\n │\n ▼\n┌──────────────────────────────────────────────────────────────────┐\n│ StatsCommand.execute() │\n│ - Parse parameters (period, view) │\n│ - Validate inputs │\n└──────────────────────────────────────────────────────────────────┘\n │\n ▼\n┌──────────────────────────────────────────────────────────────────┐\n│ StatsEngine.computeStats() │\n│ - Fetch session data from provider │\n│ - Compute summary statistics │\n│ - Calculate streaks │\n│ - Aggregate daily activity │\n│ - Compute model usage │\n│ - Generate fun fact │\n└──────────────────────────────────────────────────────────────────┘\n │\n ▼\n┌──────────────────────────────────────────────────────────────────┐\n│ SessionDataProvider.getSessions() │\n│ - Access OpenCode session storage │\n│ - Filter by date range │\n│ - Return session summaries │\n└──────────────────────────────────────────────────────────────────┘\n │\n ▼\n┌──────────────────────────────────────────────────────────────────┐\n│ StatsRenderer.render() │\n│ - Select view (overview/models) │\n│ - Compose components │\n│ - Generate ASCII output │\n└──────────────────────────────────────────────────────────────────┘\n │\n ▼\n┌──────────────────────────────────────────────────────────────────┐\n│ Display output to user │\n└──────────────────────────────────────────────────────────────────┘\n```\n\n---\n\n## File Structure\n\n```\nopencode-stats/\n├── index.ts # Plugin entry point\n├── package.json # Dependencies and metadata\n├── tsconfig.json # TypeScript configuration\n├── README.md # Plugin documentation\n│\n├── src/\n│ ├── commands/\n│ │ └── stats.ts # Slash command handler\n│ │\n│ ├── data/\n│ │ ├── sessions.ts # Session data provider\n│ │ └── models.ts # Data models/interfaces\n│ │\n│ ├── stats/\n│ │ ├── engine.ts # Main statistics engine\n│ │ ├── streaks.ts # Streak calculation\n│ │ ├── funfacts.ts # Fun fact generator\n│ │ └── aggregators.ts # Data aggregation utilities\n│ │\n│ └── render/\n│ ├── index.ts # Main renderer\n│ ├── types.ts # Render interfaces\n│ └── components/\n│ ├── heatmap.ts # Activity heatmap\n│ ├── dashboard.ts # Stats dashboard\n│ ├── models.ts # Model usage chart\n│ └── box.ts # Box drawing utilities\n│\n└── tests/\n ├── stats/\n │ ├── engine.test.ts\n │ └── streaks.test.ts\n └── render/\n └── components.test.ts\n```\n\n---\n\n## Dependencies\n\n```json\n{\n \"name\": \"opencode-stats\",\n \"version\": \"1.0.0\",\n \"type\": \"module\",\n \"main\": \"index.ts\",\n \"dependencies\": {\n \"zod\": \"^3.22.0\"\n },\n \"devDependencies\": {\n \"@types/bun\": \"latest\",\n \"typescript\": \"^5.0.0\"\n },\n \"peerDependencies\": {\n \"opencode\": \">=0.1.0\"\n }\n}\n```\n\n---\n\n## Configuration\n\n### Plugin Configuration (`opencode.json`)\n\n```json\n{\n \"plugins\": {\n \"opencode-stats\": {\n \"enabled\": true,\n \"options\": {\n \"defaultPeriod\": \"month\",\n \"cacheEnabled\": true,\n \"cacheTTL\": 300\n }\n }\n }\n}\n```\n\n### Environment Variables\n\n| Variable | Description | Default |\n|----------|-------------|---------|\n| `OPENCODE_STATS_CACHE` | Enable caching | `true` |\n| `OPENCODE_STATS_CACHE_TTL` | Cache TTL in seconds | `300` |\n\n---\n\n## Testing Strategy\n\n### Unit Tests\n\n- Statistics calculations (streaks, aggregations)\n- Render component output\n- Fun fact generation\n\n### Integration Tests\n\n- Full stats computation with mock data\n- Command execution flow\n\n### Manual Testing\n\n- Various terminal sizes\n- Color/no-color modes\n- Large session histories\n\n---\n\n## Performance Considerations\n\n### Caching Strategy\n\n```typescript\ninterface CacheEntry {\n stats: StatsResult;\n computedAt: Date;\n sessionCount: number;\n}\n\nclass StatsCache {\n private cache: Map<string, CacheEntry> = new Map();\n private ttl: number;\n\n constructor(ttlSeconds: number = 300) {\n this.ttl = ttlSeconds * 1000;\n }\n\n get(period: string): StatsResult | null {\n const entry = this.cache.get(period);\n if (!entry) return null;\n \n const age = Date.now() - entry.computedAt.getTime();\n if (age > this.ttl) {\n this.cache.delete(period);\n return null;\n }\n \n return entry.stats;\n }\n\n set(period: string, stats: StatsResult, sessionCount: number): void {\n this.cache.set(period, {\n stats,\n computedAt: new Date(),\n sessionCount,\n });\n }\n\n invalidate(): void {\n this.cache.clear();\n }\n}\n```\n\n### Lazy Loading\n\n- Load only session summaries for initial stats\n- Fetch full session data only when needed (e.g., longest session details)\n\n---\n\n## Security Considerations\n\n1. **Read-only access:** Plugin only reads session data, never writes\n2. **Local processing:** All computation happens locally\n3. **No network calls:** No telemetry or external API calls\n4. **Sandboxed execution:** Runs within OpenCode's plugin sandbox\n\n---\n\n## Future Extensibility\n\n### Planned Extensions\n\n1. **Export API:** Allow other plugins to access stats\n2. **Webhook integration:** Post stats to external services\n3. **Custom metrics:** User-defined stat tracking\n4. **Themes:** Customizable color schemes\n\n### Extension Points\n\n```typescript\n// Future: Plugin extension API\ninterface StatsExtension {\n // Add custom metrics\n metrics?: CustomMetric[];\n \n // Add custom fun facts\n funFacts?: FunFactTemplate[];\n \n // Add custom views\n views?: CustomView[];\n}\n```\n\n---\n\n## Open Questions for Implementation\n\n1. **Session Data Access:**\n - How does OpenCode expose session list to plugins?\n - Is there a direct API or do we need to use events?\n - What's the schema of session/message data?\n\n2. **Rendering:**\n - Can plugins render full-screen TUI views?\n - How do we handle keyboard input (tab to switch views)?\n - Is there a blessed/ink integration or raw terminal output?\n\n3. **Token Counting:**\n - Is token count available per message?\n - If not, how do we estimate it?\n\n4. **Plugin Lifecycle:**\n - When is the plugin loaded/unloaded?\n - Can we persist cache between sessions?\n", | |
| "additions": 82, | |
| "deletions": 8 | |
| } | |
| }, | |
| "time": { | |
| "start": 1766431348929, | |
| "end": 1766431348937 | |
| } | |
| } | |
| }, | |
| { | |
| "id": "prt_b47835904001j3YWz5zcjCqZxb", | |
| "sessionID": "ses_4b8933352ffe2k7Q7VhaAWbJcB", | |
| "messageID": "msg_b4782f75b001WPH5Q3rSet52LT", | |
| "type": "step-finish", | |
| "reason": "tool-calls", | |
| "cost": 0, | |
| "tokens": { | |
| "input": 1, | |
| "output": 1375, | |
| "reasoning": 0, | |
| "cache": { | |
| "read": 30286, | |
| "write": 10348 | |
| } | |
| } | |
| } | |
| ] | |
| }, | |
| { | |
| "info": { | |
| "id": "msg_b4783590a001IANdB66Lj3TnKR", | |
| "sessionID": "ses_4b8933352ffe2k7Q7VhaAWbJcB", | |
| "role": "assistant", | |
| "time": { | |
| "created": 1766431349003, | |
| "completed": 1766431362598 | |
| }, | |
| "parentID": "msg_b4782c46a001rP2W0KPoAqISMd", | |
| "modelID": "claude-opus-4-5", | |
| "providerID": "anthropic", | |
| "mode": "build", | |
| "agent": "build", | |
| "path": { | |
| "cwd": "/Users/themishkun/projects/tinkering/opencode-stats", | |
| "root": "/" | |
| }, | |
| "cost": 0, | |
| "tokens": { | |
| "input": 1, | |
| "output": 948, | |
| "reasoning": 0, | |
| "cache": { | |
| "read": 40634, | |
| "write": 1401 | |
| } | |
| }, | |
| "finish": "tool-calls" | |
| }, | |
| "parts": [ | |
| { | |
| "id": "prt_b4783656e0013JI4T3Y4zlb7IV", | |
| "sessionID": "ses_4b8933352ffe2k7Q7VhaAWbJcB", | |
| "messageID": "msg_b4783590a001IANdB66Lj3TnKR", | |
| "type": "step-start" | |
| }, | |
| { | |
| "id": "prt_b47836578001eSpoOkIWQm0RLA", | |
| "sessionID": "ses_4b8933352ffe2k7Q7VhaAWbJcB", | |
| "messageID": "msg_b4783590a001IANdB66Lj3TnKR", | |
| "type": "tool", | |
| "callID": "toolu_01Booi4eA4YS3383T6sETrxy", | |
| "tool": "edit", | |
| "state": { | |
| "status": "completed", | |
| "input": { | |
| "filePath": "/Users/themishkun/projects/tinkering/opencode-stats/ARCHITECTURE.md", | |
| "oldString": "### 1. Plugin Entry Point (`index.ts`)\n\n```typescript\nimport type { PluginContext, PluginHooks } from \"opencode\";\nimport { StatsCommand } from \"./src/commands/stats\";\nimport { StatsEngine } from \"./src/stats/engine\";\nimport { SessionDataProvider } from \"./src/data/sessions\";\n\nexport default async function plugin(context: PluginContext): Promise<PluginHooks> {\n const dataProvider = new SessionDataProvider(context);\n const statsEngine = new StatsEngine(dataProvider);\n const statsCommand = new StatsCommand(statsEngine);\n\n return {\n // Register the /stats slash command\n tool: {\n name: \"stats\",\n description: \"View your OpenCode usage statistics (Wrapped-style)\",\n parameters: z.object({\n period: z.enum([\"week\", \"month\", \"year\", \"all\"]).optional().default(\"month\"),\n view: z.enum([\"overview\", \"models\"]).optional().default(\"overview\"),\n }),\n execute: statsCommand.execute.bind(statsCommand),\n },\n };\n}", | |
| "newString": "### 1. Plugin Entry Point (`index.ts`)\n\n```typescript\nimport type { Plugin, Hooks, ToolDefinition } from \"@opencode-ai/plugin\";\nimport { z } from \"zod\";\nimport { StatsEngine } from \"./src/stats/engine\";\nimport { SessionDataProvider } from \"./src/data/sessions\";\nimport { StatsRenderer } from \"./src/render\";\n\nconst plugin: Plugin = async (input) => {\n const { client, project, directory } = input;\n \n // Initialize data provider with SDK client\n const dataProvider = new SessionDataProvider(client);\n const statsEngine = new StatsEngine(dataProvider);\n\n const hooks: Hooks = {\n // Register the /stats custom tool (slash command)\n tool: {\n stats: {\n description: \"View your OpenCode usage statistics (Wrapped-style)\",\n parameters: z.object({\n period: z.enum([\"week\", \"month\", \"year\", \"all\"]).optional().default(\"month\"),\n view: z.enum([\"overview\", \"models\"]).optional().default(\"overview\"),\n }),\n async execute(args) {\n const { period, view } = args;\n \n try {\n const stats = await statsEngine.computeStats({ period });\n \n const renderer = new StatsRenderer({\n width: process.stdout.columns || 80,\n height: process.stdout.rows || 24,\n colors: process.stdout.isTTY ?? false,\n });\n\n const output = renderer.render(stats, view);\n \n return {\n title: \"OpenCode Stats\",\n output,\n metadata: {\n totalSessions: stats.summary.totalSessions,\n period: stats.period,\n },\n };\n } catch (error) {\n return {\n title: \"OpenCode Stats Error\",\n output: `Error computing stats: ${error.message}`,\n metadata: { error: true },\n };\n }\n },\n },\n },\n\n // Listen to events for real-time stats updates (optional)\n async event({ event }) {\n // Could invalidate cache when new sessions/messages are created\n if (event.type === \"session.created\" || event.type === \"message.created\") {\n statsEngine.invalidateCache();\n }\n },\n };\n\n return hooks;\n};\n\nexport default plugin;" | |
| }, | |
| "output": "", | |
| "title": "Users/themishkun/projects/tinkering/opencode-stats/ARCHITECTURE.md", | |
| "metadata": { | |
| "diagnostics": {}, | |
| "diff": "Index: /Users/themishkun/projects/tinkering/opencode-stats/ARCHITECTURE.md\n===================================================================\n--- /Users/themishkun/projects/tinkering/opencode-stats/ARCHITECTURE.md\n+++ /Users/themishkun/projects/tinkering/opencode-stats/ARCHITECTURE.md\n@@ -153,31 +153,76 @@\n \n ### 1. Plugin Entry Point (`index.ts`)\n \n ```typescript\n-import type { PluginContext, PluginHooks } from \"opencode\";\n-import { StatsCommand } from \"./src/commands/stats\";\n+import type { Plugin, Hooks, ToolDefinition } from \"@opencode-ai/plugin\";\n+import { z } from \"zod\";\n import { StatsEngine } from \"./src/stats/engine\";\n import { SessionDataProvider } from \"./src/data/sessions\";\n+import { StatsRenderer } from \"./src/render\";\n \n-export default async function plugin(context: PluginContext): Promise<PluginHooks> {\n- const dataProvider = new SessionDataProvider(context);\n+const plugin: Plugin = async (input) => {\n+ const { client, project, directory } = input;\n+ \n+ // Initialize data provider with SDK client\n+ const dataProvider = new SessionDataProvider(client);\n const statsEngine = new StatsEngine(dataProvider);\n- const statsCommand = new StatsCommand(statsEngine);\n \n- return {\n- // Register the /stats slash command\n+ const hooks: Hooks = {\n+ // Register the /stats custom tool (slash command)\n tool: {\n- name: \"stats\",\n- description: \"View your OpenCode usage statistics (Wrapped-style)\",\n- parameters: z.object({\n- period: z.enum([\"week\", \"month\", \"year\", \"all\"]).optional().default(\"month\"),\n- view: z.enum([\"overview\", \"models\"]).optional().default(\"overview\"),\n- }),\n- execute: statsCommand.execute.bind(statsCommand),\n+ stats: {\n+ description: \"View your OpenCode usage statistics (Wrapped-style)\",\n+ parameters: z.object({\n+ period: z.enum([\"week\", \"month\", \"year\", \"all\"]).optional().default(\"month\"),\n+ view: z.enum([\"overview\", \"models\"]).optional().default(\"overview\"),\n+ }),\n+ async execute(args) {\n+ const { period, view } = args;\n+ \n+ try {\n+ const stats = await statsEngine.computeStats({ period });\n+ \n+ const renderer = new StatsRenderer({\n+ width: process.stdout.columns || 80,\n+ height: process.stdout.rows || 24,\n+ colors: process.stdout.isTTY ?? false,\n+ });\n+\n+ const output = renderer.render(stats, view);\n+ \n+ return {\n+ title: \"OpenCode Stats\",\n+ output,\n+ metadata: {\n+ totalSessions: stats.summary.totalSessions,\n+ period: stats.period,\n+ },\n+ };\n+ } catch (error) {\n+ return {\n+ title: \"OpenCode Stats Error\",\n+ output: `Error computing stats: ${error.message}`,\n+ metadata: { error: true },\n+ };\n+ }\n+ },\n+ },\n },\n+\n+ // Listen to events for real-time stats updates (optional)\n+ async event({ event }) {\n+ // Could invalidate cache when new sessions/messages are created\n+ if (event.type === \"session.created\" || event.type === \"message.created\") {\n+ statsEngine.invalidateCache();\n+ }\n+ },\n };\n-}\n+\n+ return hooks;\n+};\n+\n+export default plugin;\n ```\n \n ### 2. Data Layer (`src/data/`)\n \n", | |
| "filediff": { | |
| "file": "/Users/themishkun/projects/tinkering/opencode-stats/ARCHITECTURE.md", | |
| "before": "# Architecture Document: OpenCode Stats Plugin\n\n## Overview\n\nThis document describes the technical architecture of the `opencode-stats` plugin, a \"Spotify Wrapped\"-style statistics visualization tool for OpenCode.\n\n---\n\n## Plugin Architecture\n\n### OpenCode Plugin System\n\nOpenCode plugins are JavaScript/TypeScript modules that run in the Bun runtime. They follow an async function pattern that receives a `PluginInput` and returns `Hooks`.\n\n#### Plugin Input (What plugins receive)\n\n```typescript\n// From @opencode-ai/plugin\nexport type PluginInput = {\n client: ReturnType<typeof createOpencodeClient> // SDK client for API access\n project: Project // Current project info\n directory: string // Project directory\n worktree: string // Git worktree path\n $: BunShell // Bun shell for running commands\n}\n\nexport type Plugin = (input: PluginInput) => Promise<Hooks>\n```\n\n#### Available Hooks\n\n```typescript\nexport interface Hooks {\n // Listen to OpenCode events (session created, message created, etc.)\n event?: (input: { event: Event }) => Promise<void>\n \n // Modify OpenCode configuration\n config?: (input: Config) => Promise<void>\n \n // Define custom tools (slash commands)\n tool?: {\n [key: string]: ToolDefinition\n }\n \n // Custom authentication providers\n auth?: AuthHook\n \n // Called when a new message is received\n \"chat.message\"?: (\n input: { sessionID: string; agent?: string; model?: { providerID: string; modelID: string }; messageID?: string },\n output: { message: UserMessage; parts: Part[] },\n ) => Promise<void>\n \n // Modify parameters sent to LLM\n \"chat.params\"?: (\n input: { sessionID: string; agent: string; model: Model; provider: ProviderContext; message: UserMessage },\n output: { temperature: number; topP: number; topK: number; options: Record<string, any> },\n ) => Promise<void>\n \n // Intercept permission requests\n \"permission.ask\"?: (input: Permission, output: { status: \"ask\" | \"deny\" | \"allow\" }) => Promise<void>\n \n // Before tool execution - can modify args\n \"tool.execute.before\"?: (\n input: { tool: string; sessionID: string; callID: string },\n output: { args: any },\n ) => Promise<void>\n \n // After tool execution - can modify output\n \"tool.execute.after\"?: (\n input: { tool: string; sessionID: string; callID: string },\n output: { title: string; output: string; metadata: any },\n ) => Promise<void>\n \n // Transform chat messages (experimental)\n \"experimental.chat.messages.transform\"?: (\n input: {},\n output: { messages: { info: Message; parts: Part[] }[] },\n ) => Promise<void>\n \n // Transform system prompt (experimental)\n \"experimental.chat.system.transform\"?: (\n input: {},\n output: { system: string[] },\n ) => Promise<void>\n \n // Add context during session compaction (experimental)\n \"experimental.session.compacting\"?: (\n input: { sessionID: string },\n output: { context: string[] },\n ) => Promise<void>\n \n // Transform completed text (experimental)\n \"experimental.text.complete\"?: (\n input: { sessionID: string; messageID: string; partID: string },\n output: { text: string },\n ) => Promise<void>\n}\n```\n\n### Plugin Location\n\n```\n.opencode/\n└── plugin/\n └── opencode-stats/\n ├── index.ts # Main plugin entry\n ├── package.json # Dependencies\n └── src/\n ├── stats/ # Statistics computation\n ├── render/ # TUI rendering\n └── data/ # Data access layer\n```\n\n---\n\n## System Architecture\n\n```\n┌─────────────────────────────────────────────────────────────────┐\n│ OpenCode Host │\n├─────────────────────────────────────────────────────────────────┤\n│ │\n│ ┌─────────────────────────────────────────────────────────┐ │\n│ │ opencode-stats Plugin │ │\n│ ├─────────────────────────────────────────────────────────┤ │\n│ │ │ │\n│ │ ┌─────────────┐ ┌─────────────┐ ┌─────────────────┐ │ │\n│ │ │ Command │ │ Stats │ │ Renderer │ │ │\n│ │ │ Handler │──│ Engine │──│ (TUI) │ │ │\n│ │ └─────────────┘ └─────────────┘ └─────────────────┘ │ │\n│ │ │ │ │ │ │\n│ │ ▼ ▼ ▼ │ │\n│ │ ┌─────────────┐ ┌─────────────┐ ┌─────────────────┐ │ │\n│ │ │ Slash │ │ Data │ │ Components │ │ │\n│ │ │ Command │ │ Layer │ │ Library │ │ │\n│ │ └─────────────┘ └─────────────┘ └─────────────────┘ │ │\n│ │ │ │ │\n│ └──────────────────────────│─────────────────────────────┘ │\n│ │ │\n│ ▼ │\n│ ┌─────────────────────────────────────────────────────────┐ │\n│ │ OpenCode Session Storage │ │\n│ │ (SQLite / JSON) │ │\n│ └─────────────────────────────────────────────────────────┘ │\n│ │\n└─────────────────────────────────────────────────────────────────┘\n```\n\n---\n\n## Component Design\n\n### 1. Plugin Entry Point (`index.ts`)\n\n```typescript\nimport type { PluginContext, PluginHooks } from \"opencode\";\nimport { StatsCommand } from \"./src/commands/stats\";\nimport { StatsEngine } from \"./src/stats/engine\";\nimport { SessionDataProvider } from \"./src/data/sessions\";\n\nexport default async function plugin(context: PluginContext): Promise<PluginHooks> {\n const dataProvider = new SessionDataProvider(context);\n const statsEngine = new StatsEngine(dataProvider);\n const statsCommand = new StatsCommand(statsEngine);\n\n return {\n // Register the /stats slash command\n tool: {\n name: \"stats\",\n description: \"View your OpenCode usage statistics (Wrapped-style)\",\n parameters: z.object({\n period: z.enum([\"week\", \"month\", \"year\", \"all\"]).optional().default(\"month\"),\n view: z.enum([\"overview\", \"models\"]).optional().default(\"overview\"),\n }),\n execute: statsCommand.execute.bind(statsCommand),\n },\n };\n}\n```\n\n### 2. Data Layer (`src/data/`)\n\n#### Session Data Provider\n\nResponsible for accessing OpenCode's session storage.\n\n```typescript\n// src/data/sessions.ts\n\nexport interface Session {\n id: string;\n createdAt: Date;\n updatedAt: Date;\n messages: Message[];\n}\n\nexport interface Message {\n id: string;\n role: \"user\" | \"assistant\";\n timestamp: Date;\n model?: string;\n tokenCount?: {\n input: number;\n output: number;\n };\n}\n\nexport class SessionDataProvider {\n constructor(private context: PluginContext) {}\n\n async getSessions(options?: {\n from?: Date;\n to?: Date;\n limit?: number;\n }): Promise<Session[]> {\n // Access OpenCode's session list via context\n // Implementation depends on OpenCode's exposed APIs\n }\n\n async getSessionById(id: string): Promise<Session | null> {\n // Fetch a specific session with all messages\n }\n\n async getSessionSummaries(): Promise<SessionSummary[]> {\n // Lightweight fetch for stats computation\n }\n}\n```\n\n#### Data Models\n\n```typescript\n// src/data/models.ts\n\nexport interface SessionSummary {\n id: string;\n startTime: Date;\n endTime: Date;\n messageCount: number;\n totalTokens: number;\n models: string[];\n}\n\nexport interface DailyActivity {\n date: string; // YYYY-MM-DD\n sessionCount: number;\n totalTokens: number;\n totalDuration: number; // minutes\n}\n\nexport interface ModelUsage {\n model: string;\n sessionCount: number;\n messageCount: number;\n totalTokens: number;\n percentage: number;\n}\n```\n\n### 3. Statistics Engine (`src/stats/`)\n\n#### Core Engine\n\n```typescript\n// src/stats/engine.ts\n\nexport interface StatsResult {\n period: {\n start: Date;\n end: Date;\n days: number;\n };\n summary: {\n totalSessions: number;\n totalTokens: number;\n totalMessages: number;\n activeDays: number;\n currentStreak: number;\n longestStreak: number;\n longestSession: {\n id: string;\n duration: number; // minutes\n };\n peakHour: number; // 0-23\n favoriteModel: string;\n };\n dailyActivity: DailyActivity[];\n modelUsage: ModelUsage[];\n funFact: string;\n}\n\nexport class StatsEngine {\n constructor(private dataProvider: SessionDataProvider) {}\n\n async computeStats(options: {\n period: \"week\" | \"month\" | \"year\" | \"all\";\n }): Promise<StatsResult> {\n const sessions = await this.dataProvider.getSessions({\n from: this.getPeriodStart(options.period),\n });\n\n return {\n period: this.computePeriod(sessions, options.period),\n summary: this.computeSummary(sessions),\n dailyActivity: this.computeDailyActivity(sessions),\n modelUsage: this.computeModelUsage(sessions),\n funFact: this.generateFunFact(sessions),\n };\n }\n\n private computeSummary(sessions: Session[]): StatsResult[\"summary\"] {\n // Compute all summary statistics\n }\n\n private computeDailyActivity(sessions: Session[]): DailyActivity[] {\n // Aggregate sessions by day\n }\n\n private computeModelUsage(sessions: Session[]): ModelUsage[] {\n // Aggregate by model\n }\n\n private generateFunFact(sessions: Session[]): string {\n // Pick a fun comparison\n }\n}\n```\n\n#### Streak Calculator\n\n```typescript\n// src/stats/streaks.ts\n\nexport interface StreakResult {\n current: number;\n longest: number;\n currentStart?: Date;\n longestStart?: Date;\n longestEnd?: Date;\n}\n\nexport function calculateStreaks(dailyActivity: DailyActivity[]): StreakResult {\n // Sort by date\n const sorted = [...dailyActivity].sort(\n (a, b) => new Date(a.date).getTime() - new Date(b.date).getTime()\n );\n\n let current = 0;\n let longest = 0;\n let streak = 0;\n let prevDate: Date | null = null;\n\n for (const day of sorted) {\n const date = new Date(day.date);\n if (prevDate && isConsecutiveDay(prevDate, date)) {\n streak++;\n } else {\n streak = 1;\n }\n\n if (streak > longest) longest = streak;\n prevDate = date;\n }\n\n // Check if streak continues to today\n const today = new Date();\n today.setHours(0, 0, 0, 0);\n \n if (prevDate && isConsecutiveDay(prevDate, today)) {\n current = streak;\n } else if (prevDate?.getTime() === today.getTime()) {\n current = streak;\n }\n\n return { current, longest };\n}\n\nfunction isConsecutiveDay(a: Date, b: Date): boolean {\n const diff = b.getTime() - a.getTime();\n return diff === 24 * 60 * 60 * 1000;\n}\n```\n\n#### Fun Facts Generator\n\n```typescript\n// src/stats/funfacts.ts\n\ninterface FunFactTemplate {\n condition: (stats: StatsResult) => boolean;\n generate: (stats: StatsResult) => string;\n}\n\nconst FUN_FACTS: FunFactTemplate[] = [\n {\n condition: (s) => s.summary.longestSession.duration > 148, // Inception length\n generate: (s) => {\n const times = Math.round(s.summary.longestSession.duration / 148);\n return `Your longest session is ~${times}x longer than the movie Inception`;\n },\n },\n {\n condition: (s) => s.summary.totalTokens > 587287, // War and Peace word count\n generate: (s) => {\n const times = Math.round(s.summary.totalTokens / 587287);\n return `You've used ${times}x more tokens than words in War and Peace`;\n },\n },\n {\n condition: (s) => s.summary.currentStreak >= 7,\n generate: (s) => \n `Your ${s.summary.currentStreak}-day streak is longer than most New Year resolutions`,\n },\n {\n condition: (s) => s.summary.peakHour >= 22 || s.summary.peakHour <= 4,\n generate: () => `You're a night owl coder - peak activity is after dark`,\n },\n {\n condition: (s) => s.summary.peakHour >= 5 && s.summary.peakHour <= 8,\n generate: () => `Early bird catches the bugs - you code best at dawn`,\n },\n // More fun facts...\n];\n\nexport function generateFunFact(stats: StatsResult): string {\n const applicable = FUN_FACTS.filter((f) => f.condition(stats));\n if (applicable.length === 0) {\n return `You've had ${stats.summary.totalSessions} coding sessions - keep going!`;\n }\n const random = applicable[Math.floor(Math.random() * applicable.length)];\n return random.generate(stats);\n}\n```\n\n### 4. Renderer (`src/render/`)\n\n#### Renderer Interface\n\n```typescript\n// src/render/types.ts\n\nexport interface RenderContext {\n width: number;\n height: number;\n colors: boolean;\n}\n\nexport interface Renderer {\n render(stats: StatsResult, view: \"overview\" | \"models\"): string;\n}\n```\n\n#### Heatmap Component\n\n```typescript\n// src/render/components/heatmap.ts\n\nconst INTENSITY_CHARS = [\" \", \"░\", \"▒\", \"▓\", \"█\"];\nconst DAYS = [\"\", \"Mon\", \"\", \"Wed\", \"\", \"Fri\", \"\"];\nconst MONTHS = [\"Jan\", \"Feb\", \"Mar\", \"Apr\", \"May\", \"Jun\", \n \"Jul\", \"Aug\", \"Sep\", \"Oct\", \"Nov\", \"Dec\"];\n\nexport function renderHeatmap(\n dailyActivity: DailyActivity[],\n options: { weeks: number; colors: boolean }\n): string[] {\n const lines: string[] = [];\n \n // Build activity map\n const activityMap = new Map<string, number>();\n dailyActivity.forEach((d) => {\n activityMap.set(d.date, d.sessionCount);\n });\n\n // Calculate intensity thresholds\n const maxActivity = Math.max(...dailyActivity.map((d) => d.sessionCount), 1);\n const getIntensity = (count: number): number => {\n if (count === 0) return 0;\n return Math.min(4, Math.ceil((count / maxActivity) * 4));\n };\n\n // Generate header (months)\n const headerLine = \" \" + generateMonthHeader(options.weeks);\n lines.push(headerLine);\n\n // Generate each day row\n for (let dayOfWeek = 0; dayOfWeek < 7; dayOfWeek++) {\n let line = DAYS[dayOfWeek].padEnd(4);\n \n for (let week = 0; week < options.weeks; week++) {\n const date = getDateForWeekDay(week, dayOfWeek, options.weeks);\n const dateStr = formatDate(date);\n const count = activityMap.get(dateStr) || 0;\n const char = INTENSITY_CHARS[getIntensity(count)];\n line += char + \" \";\n }\n \n lines.push(line);\n }\n\n // Legend\n lines.push(\"\");\n lines.push(\" Less \" + INTENSITY_CHARS.slice(1).join(\" \") + \" More\");\n\n return lines;\n}\n```\n\n#### Stats Dashboard Component\n\n```typescript\n// src/render/components/dashboard.ts\n\nexport function renderDashboard(summary: StatsResult[\"summary\"]): string[] {\n const lines: string[] = [];\n \n const formatDuration = (minutes: number): string => {\n const days = Math.floor(minutes / 1440);\n const hours = Math.floor((minutes % 1440) / 60);\n const mins = minutes % 60;\n \n const parts = [];\n if (days > 0) parts.push(`${days}d`);\n if (hours > 0) parts.push(`${hours}h`);\n if (mins > 0) parts.push(`${mins}m`);\n return parts.join(\" \") || \"0m\";\n };\n\n const formatNumber = (n: number): string => {\n if (n >= 1000000) return `${(n / 1000000).toFixed(1)}m`;\n if (n >= 1000) return `${(n / 1000).toFixed(1)}k`;\n return n.toString();\n };\n\n const leftCol = [\n `Favorite model: ${summary.favoriteModel}`,\n \"\",\n `Sessions: ${summary.totalSessions}`,\n `Current streak: ${summary.currentStreak} days`,\n `Active days: ${summary.activeDays}`,\n ];\n\n const rightCol = [\n `Total tokens: ${formatNumber(summary.totalTokens)}`,\n \"\",\n `Longest session: ${formatDuration(summary.longestSession.duration)}`,\n `Longest streak: ${summary.longestStreak} days`,\n `Peak hour: ${summary.peakHour}:00-${summary.peakHour + 1}:00`,\n ];\n\n // Combine columns\n const maxLeftWidth = Math.max(...leftCol.map((l) => l.length));\n const padding = 4;\n\n for (let i = 0; i < leftCol.length; i++) {\n lines.push(\n leftCol[i].padEnd(maxLeftWidth + padding) + rightCol[i]\n );\n }\n\n return lines;\n}\n```\n\n#### Model Usage Bar Chart\n\n```typescript\n// src/render/components/models.ts\n\nexport function renderModelUsage(\n modelUsage: ModelUsage[],\n options: { width: number }\n): string[] {\n const lines: string[] = [];\n const barWidth = options.width - 40; // Space for label and percentage\n\n const sorted = [...modelUsage].sort((a, b) => b.percentage - a.percentage);\n\n for (const model of sorted.slice(0, 5)) {\n const filled = Math.round((model.percentage / 100) * barWidth);\n const empty = barWidth - filled;\n const bar = \"█\".repeat(filled) + \"░\".repeat(empty);\n const label = model.model.padEnd(28);\n const pct = `${Math.round(model.percentage)}%`.padStart(4);\n \n lines.push(` ${label} ${bar} ${pct}`);\n }\n\n return lines;\n}\n```\n\n#### Main Renderer\n\n```typescript\n// src/render/index.ts\n\nimport { renderHeatmap } from \"./components/heatmap\";\nimport { renderDashboard } from \"./components/dashboard\";\nimport { renderModelUsage } from \"./components/models\";\n\nexport class StatsRenderer implements Renderer {\n constructor(private context: RenderContext) {}\n\n render(stats: StatsResult, view: \"overview\" | \"models\"): string {\n const lines: string[] = [];\n \n // Header\n lines.push(\"\");\n const tabs = view === \"overview\" \n ? \" [Overview] Models (tab to cycle)\"\n : \" Overview [Models] (tab to cycle)\";\n lines.push(tabs);\n lines.push(\"\");\n\n if (view === \"overview\") {\n // Heatmap\n const heatmap = renderHeatmap(stats.dailyActivity, {\n weeks: 52,\n colors: this.context.colors,\n });\n lines.push(...heatmap);\n lines.push(\"\");\n\n // Dashboard stats\n const dashboard = renderDashboard(stats.summary);\n lines.push(...dashboard);\n lines.push(\"\");\n\n // Fun fact\n lines.push(` ${stats.funFact}`);\n lines.push(` Stats from the last ${stats.period.days} days`);\n } else {\n // Model breakdown\n const models = renderModelUsage(stats.modelUsage, {\n width: this.context.width,\n });\n lines.push(...models);\n }\n\n lines.push(\"\");\n return lines.join(\"\\n\");\n }\n}\n```\n\n### 5. Command Handler (`src/commands/`)\n\n```typescript\n// src/commands/stats.ts\n\nimport { z } from \"zod\";\nimport type { ToolExecuteParams } from \"opencode\";\nimport { StatsEngine } from \"../stats/engine\";\nimport { StatsRenderer } from \"../render\";\n\nexport class StatsCommand {\n constructor(private engine: StatsEngine) {}\n\n async execute(params: ToolExecuteParams<{\n period?: \"week\" | \"month\" | \"year\" | \"all\";\n view?: \"overview\" | \"models\";\n }>) {\n const { period = \"month\", view = \"overview\" } = params.input;\n\n try {\n const stats = await this.engine.computeStats({ period });\n \n const renderer = new StatsRenderer({\n width: process.stdout.columns || 80,\n height: process.stdout.rows || 24,\n colors: process.stdout.isTTY ?? false,\n });\n\n const output = renderer.render(stats, view);\n \n return {\n content: output,\n metadata: {\n totalSessions: stats.summary.totalSessions,\n period: stats.period,\n },\n };\n } catch (error) {\n return {\n content: `Error computing stats: ${error.message}`,\n isError: true,\n };\n }\n }\n}\n```\n\n---\n\n## Data Flow\n\n```\n┌──────────────────────────────────────────────────────────────────┐\n│ User invokes /stats │\n└──────────────────────────────────────────────────────────────────┘\n │\n ▼\n┌──────────────────────────────────────────────────────────────────┐\n│ StatsCommand.execute() │\n│ - Parse parameters (period, view) │\n│ - Validate inputs │\n└──────────────────────────────────────────────────────────────────┘\n │\n ▼\n┌──────────────────────────────────────────────────────────────────┐\n│ StatsEngine.computeStats() │\n│ - Fetch session data from provider │\n│ - Compute summary statistics │\n│ - Calculate streaks │\n│ - Aggregate daily activity │\n│ - Compute model usage │\n│ - Generate fun fact │\n└──────────────────────────────────────────────────────────────────┘\n │\n ▼\n┌──────────────────────────────────────────────────────────────────┐\n│ SessionDataProvider.getSessions() │\n│ - Access OpenCode session storage │\n│ - Filter by date range │\n│ - Return session summaries │\n└──────────────────────────────────────────────────────────────────┘\n │\n ▼\n┌──────────────────────────────────────────────────────────────────┐\n│ StatsRenderer.render() │\n│ - Select view (overview/models) │\n│ - Compose components │\n│ - Generate ASCII output │\n└──────────────────────────────────────────────────────────────────┘\n │\n ▼\n┌──────────────────────────────────────────────────────────────────┐\n│ Display output to user │\n└──────────────────────────────────────────────────────────────────┘\n```\n\n---\n\n## File Structure\n\n```\nopencode-stats/\n├── index.ts # Plugin entry point\n├── package.json # Dependencies and metadata\n├── tsconfig.json # TypeScript configuration\n├── README.md # Plugin documentation\n│\n├── src/\n│ ├── commands/\n│ │ └── stats.ts # Slash command handler\n│ │\n│ ├── data/\n│ │ ├── sessions.ts # Session data provider\n│ │ └── models.ts # Data models/interfaces\n│ │\n│ ├── stats/\n│ │ ├── engine.ts # Main statistics engine\n│ │ ├── streaks.ts # Streak calculation\n│ │ ├── funfacts.ts # Fun fact generator\n│ │ └── aggregators.ts # Data aggregation utilities\n│ │\n│ └── render/\n│ ├── index.ts # Main renderer\n│ ├── types.ts # Render interfaces\n│ └── components/\n│ ├── heatmap.ts # Activity heatmap\n│ ├── dashboard.ts # Stats dashboard\n│ ├── models.ts # Model usage chart\n│ └── box.ts # Box drawing utilities\n│\n└── tests/\n ├── stats/\n │ ├── engine.test.ts\n │ └── streaks.test.ts\n └── render/\n └── components.test.ts\n```\n\n---\n\n## Dependencies\n\n```json\n{\n \"name\": \"opencode-stats\",\n \"version\": \"1.0.0\",\n \"type\": \"module\",\n \"main\": \"index.ts\",\n \"dependencies\": {\n \"zod\": \"^3.22.0\"\n },\n \"devDependencies\": {\n \"@types/bun\": \"latest\",\n \"typescript\": \"^5.0.0\"\n },\n \"peerDependencies\": {\n \"opencode\": \">=0.1.0\"\n }\n}\n```\n\n---\n\n## Configuration\n\n### Plugin Configuration (`opencode.json`)\n\n```json\n{\n \"plugins\": {\n \"opencode-stats\": {\n \"enabled\": true,\n \"options\": {\n \"defaultPeriod\": \"month\",\n \"cacheEnabled\": true,\n \"cacheTTL\": 300\n }\n }\n }\n}\n```\n\n### Environment Variables\n\n| Variable | Description | Default |\n|----------|-------------|---------|\n| `OPENCODE_STATS_CACHE` | Enable caching | `true` |\n| `OPENCODE_STATS_CACHE_TTL` | Cache TTL in seconds | `300` |\n\n---\n\n## Testing Strategy\n\n### Unit Tests\n\n- Statistics calculations (streaks, aggregations)\n- Render component output\n- Fun fact generation\n\n### Integration Tests\n\n- Full stats computation with mock data\n- Command execution flow\n\n### Manual Testing\n\n- Various terminal sizes\n- Color/no-color modes\n- Large session histories\n\n---\n\n## Performance Considerations\n\n### Caching Strategy\n\n```typescript\ninterface CacheEntry {\n stats: StatsResult;\n computedAt: Date;\n sessionCount: number;\n}\n\nclass StatsCache {\n private cache: Map<string, CacheEntry> = new Map();\n private ttl: number;\n\n constructor(ttlSeconds: number = 300) {\n this.ttl = ttlSeconds * 1000;\n }\n\n get(period: string): StatsResult | null {\n const entry = this.cache.get(period);\n if (!entry) return null;\n \n const age = Date.now() - entry.computedAt.getTime();\n if (age > this.ttl) {\n this.cache.delete(period);\n return null;\n }\n \n return entry.stats;\n }\n\n set(period: string, stats: StatsResult, sessionCount: number): void {\n this.cache.set(period, {\n stats,\n computedAt: new Date(),\n sessionCount,\n });\n }\n\n invalidate(): void {\n this.cache.clear();\n }\n}\n```\n\n### Lazy Loading\n\n- Load only session summaries for initial stats\n- Fetch full session data only when needed (e.g., longest session details)\n\n---\n\n## Security Considerations\n\n1. **Read-only access:** Plugin only reads session data, never writes\n2. **Local processing:** All computation happens locally\n3. **No network calls:** No telemetry or external API calls\n4. **Sandboxed execution:** Runs within OpenCode's plugin sandbox\n\n---\n\n## Future Extensibility\n\n### Planned Extensions\n\n1. **Export API:** Allow other plugins to access stats\n2. **Webhook integration:** Post stats to external services\n3. **Custom metrics:** User-defined stat tracking\n4. **Themes:** Customizable color schemes\n\n### Extension Points\n\n```typescript\n// Future: Plugin extension API\ninterface StatsExtension {\n // Add custom metrics\n metrics?: CustomMetric[];\n \n // Add custom fun facts\n funFacts?: FunFactTemplate[];\n \n // Add custom views\n views?: CustomView[];\n}\n```\n\n---\n\n## Open Questions for Implementation\n\n1. **Session Data Access:**\n - How does OpenCode expose session list to plugins?\n - Is there a direct API or do we need to use events?\n - What's the schema of session/message data?\n\n2. **Rendering:**\n - Can plugins render full-screen TUI views?\n - How do we handle keyboard input (tab to switch views)?\n - Is there a blessed/ink integration or raw terminal output?\n\n3. **Token Counting:**\n - Is token count available per message?\n - If not, how do we estimate it?\n\n4. **Plugin Lifecycle:**\n - When is the plugin loaded/unloaded?\n - Can we persist cache between sessions?\n", | |
| "after": "# Architecture Document: OpenCode Stats Plugin\n\n## Overview\n\nThis document describes the technical architecture of the `opencode-stats` plugin, a \"Spotify Wrapped\"-style statistics visualization tool for OpenCode.\n\n---\n\n## Plugin Architecture\n\n### OpenCode Plugin System\n\nOpenCode plugins are JavaScript/TypeScript modules that run in the Bun runtime. They follow an async function pattern that receives a `PluginInput` and returns `Hooks`.\n\n#### Plugin Input (What plugins receive)\n\n```typescript\n// From @opencode-ai/plugin\nexport type PluginInput = {\n client: ReturnType<typeof createOpencodeClient> // SDK client for API access\n project: Project // Current project info\n directory: string // Project directory\n worktree: string // Git worktree path\n $: BunShell // Bun shell for running commands\n}\n\nexport type Plugin = (input: PluginInput) => Promise<Hooks>\n```\n\n#### Available Hooks\n\n```typescript\nexport interface Hooks {\n // Listen to OpenCode events (session created, message created, etc.)\n event?: (input: { event: Event }) => Promise<void>\n \n // Modify OpenCode configuration\n config?: (input: Config) => Promise<void>\n \n // Define custom tools (slash commands)\n tool?: {\n [key: string]: ToolDefinition\n }\n \n // Custom authentication providers\n auth?: AuthHook\n \n // Called when a new message is received\n \"chat.message\"?: (\n input: { sessionID: string; agent?: string; model?: { providerID: string; modelID: string }; messageID?: string },\n output: { message: UserMessage; parts: Part[] },\n ) => Promise<void>\n \n // Modify parameters sent to LLM\n \"chat.params\"?: (\n input: { sessionID: string; agent: string; model: Model; provider: ProviderContext; message: UserMessage },\n output: { temperature: number; topP: number; topK: number; options: Record<string, any> },\n ) => Promise<void>\n \n // Intercept permission requests\n \"permission.ask\"?: (input: Permission, output: { status: \"ask\" | \"deny\" | \"allow\" }) => Promise<void>\n \n // Before tool execution - can modify args\n \"tool.execute.before\"?: (\n input: { tool: string; sessionID: string; callID: string },\n output: { args: any },\n ) => Promise<void>\n \n // After tool execution - can modify output\n \"tool.execute.after\"?: (\n input: { tool: string; sessionID: string; callID: string },\n output: { title: string; output: string; metadata: any },\n ) => Promise<void>\n \n // Transform chat messages (experimental)\n \"experimental.chat.messages.transform\"?: (\n input: {},\n output: { messages: { info: Message; parts: Part[] }[] },\n ) => Promise<void>\n \n // Transform system prompt (experimental)\n \"experimental.chat.system.transform\"?: (\n input: {},\n output: { system: string[] },\n ) => Promise<void>\n \n // Add context during session compaction (experimental)\n \"experimental.session.compacting\"?: (\n input: { sessionID: string },\n output: { context: string[] },\n ) => Promise<void>\n \n // Transform completed text (experimental)\n \"experimental.text.complete\"?: (\n input: { sessionID: string; messageID: string; partID: string },\n output: { text: string },\n ) => Promise<void>\n}\n```\n\n### Plugin Location\n\n```\n.opencode/\n└── plugin/\n └── opencode-stats/\n ├── index.ts # Main plugin entry\n ├── package.json # Dependencies\n └── src/\n ├── stats/ # Statistics computation\n ├── render/ # TUI rendering\n └── data/ # Data access layer\n```\n\n---\n\n## System Architecture\n\n```\n┌─────────────────────────────────────────────────────────────────┐\n│ OpenCode Host │\n├─────────────────────────────────────────────────────────────────┤\n│ │\n│ ┌─────────────────────────────────────────────────────────┐ │\n│ │ opencode-stats Plugin │ │\n│ ├─────────────────────────────────────────────────────────┤ │\n│ │ │ │\n│ │ ┌─────────────┐ ┌─────────────┐ ┌─────────────────┐ │ │\n│ │ │ Command │ │ Stats │ │ Renderer │ │ │\n│ │ │ Handler │──│ Engine │──│ (TUI) │ │ │\n│ │ └─────────────┘ └─────────────┘ └─────────────────┘ │ │\n│ │ │ │ │ │ │\n│ │ ▼ ▼ ▼ │ │\n│ │ ┌─────────────┐ ┌─────────────┐ ┌─────────────────┐ │ │\n│ │ │ Slash │ │ Data │ │ Components │ │ │\n│ │ │ Command │ │ Layer │ │ Library │ │ │\n│ │ └─────────────┘ └─────────────┘ └─────────────────┘ │ │\n│ │ │ │ │\n│ └──────────────────────────│─────────────────────────────┘ │\n│ │ │\n│ ▼ │\n│ ┌─────────────────────────────────────────────────────────┐ │\n│ │ OpenCode Session Storage │ │\n│ │ (SQLite / JSON) │ │\n│ └─────────────────────────────────────────────────────────┘ │\n│ │\n└─────────────────────────────────────────────────────────────────┘\n```\n\n---\n\n## Component Design\n\n### 1. Plugin Entry Point (`index.ts`)\n\n```typescript\nimport type { Plugin, Hooks, ToolDefinition } from \"@opencode-ai/plugin\";\nimport { z } from \"zod\";\nimport { StatsEngine } from \"./src/stats/engine\";\nimport { SessionDataProvider } from \"./src/data/sessions\";\nimport { StatsRenderer } from \"./src/render\";\n\nconst plugin: Plugin = async (input) => {\n const { client, project, directory } = input;\n \n // Initialize data provider with SDK client\n const dataProvider = new SessionDataProvider(client);\n const statsEngine = new StatsEngine(dataProvider);\n\n const hooks: Hooks = {\n // Register the /stats custom tool (slash command)\n tool: {\n stats: {\n description: \"View your OpenCode usage statistics (Wrapped-style)\",\n parameters: z.object({\n period: z.enum([\"week\", \"month\", \"year\", \"all\"]).optional().default(\"month\"),\n view: z.enum([\"overview\", \"models\"]).optional().default(\"overview\"),\n }),\n async execute(args) {\n const { period, view } = args;\n \n try {\n const stats = await statsEngine.computeStats({ period });\n \n const renderer = new StatsRenderer({\n width: process.stdout.columns || 80,\n height: process.stdout.rows || 24,\n colors: process.stdout.isTTY ?? false,\n });\n\n const output = renderer.render(stats, view);\n \n return {\n title: \"OpenCode Stats\",\n output,\n metadata: {\n totalSessions: stats.summary.totalSessions,\n period: stats.period,\n },\n };\n } catch (error) {\n return {\n title: \"OpenCode Stats Error\",\n output: `Error computing stats: ${error.message}`,\n metadata: { error: true },\n };\n }\n },\n },\n },\n\n // Listen to events for real-time stats updates (optional)\n async event({ event }) {\n // Could invalidate cache when new sessions/messages are created\n if (event.type === \"session.created\" || event.type === \"message.created\") {\n statsEngine.invalidateCache();\n }\n },\n };\n\n return hooks;\n};\n\nexport default plugin;\n```\n\n### 2. Data Layer (`src/data/`)\n\n#### Session Data Provider\n\nResponsible for accessing OpenCode's session storage.\n\n```typescript\n// src/data/sessions.ts\n\nexport interface Session {\n id: string;\n createdAt: Date;\n updatedAt: Date;\n messages: Message[];\n}\n\nexport interface Message {\n id: string;\n role: \"user\" | \"assistant\";\n timestamp: Date;\n model?: string;\n tokenCount?: {\n input: number;\n output: number;\n };\n}\n\nexport class SessionDataProvider {\n constructor(private context: PluginContext) {}\n\n async getSessions(options?: {\n from?: Date;\n to?: Date;\n limit?: number;\n }): Promise<Session[]> {\n // Access OpenCode's session list via context\n // Implementation depends on OpenCode's exposed APIs\n }\n\n async getSessionById(id: string): Promise<Session | null> {\n // Fetch a specific session with all messages\n }\n\n async getSessionSummaries(): Promise<SessionSummary[]> {\n // Lightweight fetch for stats computation\n }\n}\n```\n\n#### Data Models\n\n```typescript\n// src/data/models.ts\n\nexport interface SessionSummary {\n id: string;\n startTime: Date;\n endTime: Date;\n messageCount: number;\n totalTokens: number;\n models: string[];\n}\n\nexport interface DailyActivity {\n date: string; // YYYY-MM-DD\n sessionCount: number;\n totalTokens: number;\n totalDuration: number; // minutes\n}\n\nexport interface ModelUsage {\n model: string;\n sessionCount: number;\n messageCount: number;\n totalTokens: number;\n percentage: number;\n}\n```\n\n### 3. Statistics Engine (`src/stats/`)\n\n#### Core Engine\n\n```typescript\n// src/stats/engine.ts\n\nexport interface StatsResult {\n period: {\n start: Date;\n end: Date;\n days: number;\n };\n summary: {\n totalSessions: number;\n totalTokens: number;\n totalMessages: number;\n activeDays: number;\n currentStreak: number;\n longestStreak: number;\n longestSession: {\n id: string;\n duration: number; // minutes\n };\n peakHour: number; // 0-23\n favoriteModel: string;\n };\n dailyActivity: DailyActivity[];\n modelUsage: ModelUsage[];\n funFact: string;\n}\n\nexport class StatsEngine {\n constructor(private dataProvider: SessionDataProvider) {}\n\n async computeStats(options: {\n period: \"week\" | \"month\" | \"year\" | \"all\";\n }): Promise<StatsResult> {\n const sessions = await this.dataProvider.getSessions({\n from: this.getPeriodStart(options.period),\n });\n\n return {\n period: this.computePeriod(sessions, options.period),\n summary: this.computeSummary(sessions),\n dailyActivity: this.computeDailyActivity(sessions),\n modelUsage: this.computeModelUsage(sessions),\n funFact: this.generateFunFact(sessions),\n };\n }\n\n private computeSummary(sessions: Session[]): StatsResult[\"summary\"] {\n // Compute all summary statistics\n }\n\n private computeDailyActivity(sessions: Session[]): DailyActivity[] {\n // Aggregate sessions by day\n }\n\n private computeModelUsage(sessions: Session[]): ModelUsage[] {\n // Aggregate by model\n }\n\n private generateFunFact(sessions: Session[]): string {\n // Pick a fun comparison\n }\n}\n```\n\n#### Streak Calculator\n\n```typescript\n// src/stats/streaks.ts\n\nexport interface StreakResult {\n current: number;\n longest: number;\n currentStart?: Date;\n longestStart?: Date;\n longestEnd?: Date;\n}\n\nexport function calculateStreaks(dailyActivity: DailyActivity[]): StreakResult {\n // Sort by date\n const sorted = [...dailyActivity].sort(\n (a, b) => new Date(a.date).getTime() - new Date(b.date).getTime()\n );\n\n let current = 0;\n let longest = 0;\n let streak = 0;\n let prevDate: Date | null = null;\n\n for (const day of sorted) {\n const date = new Date(day.date);\n if (prevDate && isConsecutiveDay(prevDate, date)) {\n streak++;\n } else {\n streak = 1;\n }\n\n if (streak > longest) longest = streak;\n prevDate = date;\n }\n\n // Check if streak continues to today\n const today = new Date();\n today.setHours(0, 0, 0, 0);\n \n if (prevDate && isConsecutiveDay(prevDate, today)) {\n current = streak;\n } else if (prevDate?.getTime() === today.getTime()) {\n current = streak;\n }\n\n return { current, longest };\n}\n\nfunction isConsecutiveDay(a: Date, b: Date): boolean {\n const diff = b.getTime() - a.getTime();\n return diff === 24 * 60 * 60 * 1000;\n}\n```\n\n#### Fun Facts Generator\n\n```typescript\n// src/stats/funfacts.ts\n\ninterface FunFactTemplate {\n condition: (stats: StatsResult) => boolean;\n generate: (stats: StatsResult) => string;\n}\n\nconst FUN_FACTS: FunFactTemplate[] = [\n {\n condition: (s) => s.summary.longestSession.duration > 148, // Inception length\n generate: (s) => {\n const times = Math.round(s.summary.longestSession.duration / 148);\n return `Your longest session is ~${times}x longer than the movie Inception`;\n },\n },\n {\n condition: (s) => s.summary.totalTokens > 587287, // War and Peace word count\n generate: (s) => {\n const times = Math.round(s.summary.totalTokens / 587287);\n return `You've used ${times}x more tokens than words in War and Peace`;\n },\n },\n {\n condition: (s) => s.summary.currentStreak >= 7,\n generate: (s) => \n `Your ${s.summary.currentStreak}-day streak is longer than most New Year resolutions`,\n },\n {\n condition: (s) => s.summary.peakHour >= 22 || s.summary.peakHour <= 4,\n generate: () => `You're a night owl coder - peak activity is after dark`,\n },\n {\n condition: (s) => s.summary.peakHour >= 5 && s.summary.peakHour <= 8,\n generate: () => `Early bird catches the bugs - you code best at dawn`,\n },\n // More fun facts...\n];\n\nexport function generateFunFact(stats: StatsResult): string {\n const applicable = FUN_FACTS.filter((f) => f.condition(stats));\n if (applicable.length === 0) {\n return `You've had ${stats.summary.totalSessions} coding sessions - keep going!`;\n }\n const random = applicable[Math.floor(Math.random() * applicable.length)];\n return random.generate(stats);\n}\n```\n\n### 4. Renderer (`src/render/`)\n\n#### Renderer Interface\n\n```typescript\n// src/render/types.ts\n\nexport interface RenderContext {\n width: number;\n height: number;\n colors: boolean;\n}\n\nexport interface Renderer {\n render(stats: StatsResult, view: \"overview\" | \"models\"): string;\n}\n```\n\n#### Heatmap Component\n\n```typescript\n// src/render/components/heatmap.ts\n\nconst INTENSITY_CHARS = [\" \", \"░\", \"▒\", \"▓\", \"█\"];\nconst DAYS = [\"\", \"Mon\", \"\", \"Wed\", \"\", \"Fri\", \"\"];\nconst MONTHS = [\"Jan\", \"Feb\", \"Mar\", \"Apr\", \"May\", \"Jun\", \n \"Jul\", \"Aug\", \"Sep\", \"Oct\", \"Nov\", \"Dec\"];\n\nexport function renderHeatmap(\n dailyActivity: DailyActivity[],\n options: { weeks: number; colors: boolean }\n): string[] {\n const lines: string[] = [];\n \n // Build activity map\n const activityMap = new Map<string, number>();\n dailyActivity.forEach((d) => {\n activityMap.set(d.date, d.sessionCount);\n });\n\n // Calculate intensity thresholds\n const maxActivity = Math.max(...dailyActivity.map((d) => d.sessionCount), 1);\n const getIntensity = (count: number): number => {\n if (count === 0) return 0;\n return Math.min(4, Math.ceil((count / maxActivity) * 4));\n };\n\n // Generate header (months)\n const headerLine = \" \" + generateMonthHeader(options.weeks);\n lines.push(headerLine);\n\n // Generate each day row\n for (let dayOfWeek = 0; dayOfWeek < 7; dayOfWeek++) {\n let line = DAYS[dayOfWeek].padEnd(4);\n \n for (let week = 0; week < options.weeks; week++) {\n const date = getDateForWeekDay(week, dayOfWeek, options.weeks);\n const dateStr = formatDate(date);\n const count = activityMap.get(dateStr) || 0;\n const char = INTENSITY_CHARS[getIntensity(count)];\n line += char + \" \";\n }\n \n lines.push(line);\n }\n\n // Legend\n lines.push(\"\");\n lines.push(\" Less \" + INTENSITY_CHARS.slice(1).join(\" \") + \" More\");\n\n return lines;\n}\n```\n\n#### Stats Dashboard Component\n\n```typescript\n// src/render/components/dashboard.ts\n\nexport function renderDashboard(summary: StatsResult[\"summary\"]): string[] {\n const lines: string[] = [];\n \n const formatDuration = (minutes: number): string => {\n const days = Math.floor(minutes / 1440);\n const hours = Math.floor((minutes % 1440) / 60);\n const mins = minutes % 60;\n \n const parts = [];\n if (days > 0) parts.push(`${days}d`);\n if (hours > 0) parts.push(`${hours}h`);\n if (mins > 0) parts.push(`${mins}m`);\n return parts.join(\" \") || \"0m\";\n };\n\n const formatNumber = (n: number): string => {\n if (n >= 1000000) return `${(n / 1000000).toFixed(1)}m`;\n if (n >= 1000) return `${(n / 1000).toFixed(1)}k`;\n return n.toString();\n };\n\n const leftCol = [\n `Favorite model: ${summary.favoriteModel}`,\n \"\",\n `Sessions: ${summary.totalSessions}`,\n `Current streak: ${summary.currentStreak} days`,\n `Active days: ${summary.activeDays}`,\n ];\n\n const rightCol = [\n `Total tokens: ${formatNumber(summary.totalTokens)}`,\n \"\",\n `Longest session: ${formatDuration(summary.longestSession.duration)}`,\n `Longest streak: ${summary.longestStreak} days`,\n `Peak hour: ${summary.peakHour}:00-${summary.peakHour + 1}:00`,\n ];\n\n // Combine columns\n const maxLeftWidth = Math.max(...leftCol.map((l) => l.length));\n const padding = 4;\n\n for (let i = 0; i < leftCol.length; i++) {\n lines.push(\n leftCol[i].padEnd(maxLeftWidth + padding) + rightCol[i]\n );\n }\n\n return lines;\n}\n```\n\n#### Model Usage Bar Chart\n\n```typescript\n// src/render/components/models.ts\n\nexport function renderModelUsage(\n modelUsage: ModelUsage[],\n options: { width: number }\n): string[] {\n const lines: string[] = [];\n const barWidth = options.width - 40; // Space for label and percentage\n\n const sorted = [...modelUsage].sort((a, b) => b.percentage - a.percentage);\n\n for (const model of sorted.slice(0, 5)) {\n const filled = Math.round((model.percentage / 100) * barWidth);\n const empty = barWidth - filled;\n const bar = \"█\".repeat(filled) + \"░\".repeat(empty);\n const label = model.model.padEnd(28);\n const pct = `${Math.round(model.percentage)}%`.padStart(4);\n \n lines.push(` ${label} ${bar} ${pct}`);\n }\n\n return lines;\n}\n```\n\n#### Main Renderer\n\n```typescript\n// src/render/index.ts\n\nimport { renderHeatmap } from \"./components/heatmap\";\nimport { renderDashboard } from \"./components/dashboard\";\nimport { renderModelUsage } from \"./components/models\";\n\nexport class StatsRenderer implements Renderer {\n constructor(private context: RenderContext) {}\n\n render(stats: StatsResult, view: \"overview\" | \"models\"): string {\n const lines: string[] = [];\n \n // Header\n lines.push(\"\");\n const tabs = view === \"overview\" \n ? \" [Overview] Models (tab to cycle)\"\n : \" Overview [Models] (tab to cycle)\";\n lines.push(tabs);\n lines.push(\"\");\n\n if (view === \"overview\") {\n // Heatmap\n const heatmap = renderHeatmap(stats.dailyActivity, {\n weeks: 52,\n colors: this.context.colors,\n });\n lines.push(...heatmap);\n lines.push(\"\");\n\n // Dashboard stats\n const dashboard = renderDashboard(stats.summary);\n lines.push(...dashboard);\n lines.push(\"\");\n\n // Fun fact\n lines.push(` ${stats.funFact}`);\n lines.push(` Stats from the last ${stats.period.days} days`);\n } else {\n // Model breakdown\n const models = renderModelUsage(stats.modelUsage, {\n width: this.context.width,\n });\n lines.push(...models);\n }\n\n lines.push(\"\");\n return lines.join(\"\\n\");\n }\n}\n```\n\n### 5. Command Handler (`src/commands/`)\n\n```typescript\n// src/commands/stats.ts\n\nimport { z } from \"zod\";\nimport type { ToolExecuteParams } from \"opencode\";\nimport { StatsEngine } from \"../stats/engine\";\nimport { StatsRenderer } from \"../render\";\n\nexport class StatsCommand {\n constructor(private engine: StatsEngine) {}\n\n async execute(params: ToolExecuteParams<{\n period?: \"week\" | \"month\" | \"year\" | \"all\";\n view?: \"overview\" | \"models\";\n }>) {\n const { period = \"month\", view = \"overview\" } = params.input;\n\n try {\n const stats = await this.engine.computeStats({ period });\n \n const renderer = new StatsRenderer({\n width: process.stdout.columns || 80,\n height: process.stdout.rows || 24,\n colors: process.stdout.isTTY ?? false,\n });\n\n const output = renderer.render(stats, view);\n \n return {\n content: output,\n metadata: {\n totalSessions: stats.summary.totalSessions,\n period: stats.period,\n },\n };\n } catch (error) {\n return {\n content: `Error computing stats: ${error.message}`,\n isError: true,\n };\n }\n }\n}\n```\n\n---\n\n## Data Flow\n\n```\n┌──────────────────────────────────────────────────────────────────┐\n│ User invokes /stats │\n└──────────────────────────────────────────────────────────────────┘\n │\n ▼\n┌──────────────────────────────────────────────────────────────────┐\n│ StatsCommand.execute() │\n│ - Parse parameters (period, view) │\n│ - Validate inputs │\n└──────────────────────────────────────────────────────────────────┘\n │\n ▼\n┌──────────────────────────────────────────────────────────────────┐\n│ StatsEngine.computeStats() │\n│ - Fetch session data from provider │\n│ - Compute summary statistics │\n│ - Calculate streaks │\n│ - Aggregate daily activity │\n│ - Compute model usage │\n│ - Generate fun fact │\n└──────────────────────────────────────────────────────────────────┘\n │\n ▼\n┌──────────────────────────────────────────────────────────────────┐\n│ SessionDataProvider.getSessions() │\n│ - Access OpenCode session storage │\n│ - Filter by date range │\n│ - Return session summaries │\n└──────────────────────────────────────────────────────────────────┘\n │\n ▼\n┌──────────────────────────────────────────────────────────────────┐\n│ StatsRenderer.render() │\n│ - Select view (overview/models) │\n│ - Compose components │\n│ - Generate ASCII output │\n└──────────────────────────────────────────────────────────────────┘\n │\n ▼\n┌──────────────────────────────────────────────────────────────────┐\n│ Display output to user │\n└──────────────────────────────────────────────────────────────────┘\n```\n\n---\n\n## File Structure\n\n```\nopencode-stats/\n├── index.ts # Plugin entry point\n├── package.json # Dependencies and metadata\n├── tsconfig.json # TypeScript configuration\n├── README.md # Plugin documentation\n│\n├── src/\n│ ├── commands/\n│ │ └── stats.ts # Slash command handler\n│ │\n│ ├── data/\n│ │ ├── sessions.ts # Session data provider\n│ │ └── models.ts # Data models/interfaces\n│ │\n│ ├── stats/\n│ │ ├── engine.ts # Main statistics engine\n│ │ ├── streaks.ts # Streak calculation\n│ │ ├── funfacts.ts # Fun fact generator\n│ │ └── aggregators.ts # Data aggregation utilities\n│ │\n│ └── render/\n│ ├── index.ts # Main renderer\n│ ├── types.ts # Render interfaces\n│ └── components/\n│ ├── heatmap.ts # Activity heatmap\n│ ├── dashboard.ts # Stats dashboard\n│ ├── models.ts # Model usage chart\n│ └── box.ts # Box drawing utilities\n│\n└── tests/\n ├── stats/\n │ ├── engine.test.ts\n │ └── streaks.test.ts\n └── render/\n └── components.test.ts\n```\n\n---\n\n## Dependencies\n\n```json\n{\n \"name\": \"opencode-stats\",\n \"version\": \"1.0.0\",\n \"type\": \"module\",\n \"main\": \"index.ts\",\n \"dependencies\": {\n \"zod\": \"^3.22.0\"\n },\n \"devDependencies\": {\n \"@types/bun\": \"latest\",\n \"typescript\": \"^5.0.0\"\n },\n \"peerDependencies\": {\n \"opencode\": \">=0.1.0\"\n }\n}\n```\n\n---\n\n## Configuration\n\n### Plugin Configuration (`opencode.json`)\n\n```json\n{\n \"plugins\": {\n \"opencode-stats\": {\n \"enabled\": true,\n \"options\": {\n \"defaultPeriod\": \"month\",\n \"cacheEnabled\": true,\n \"cacheTTL\": 300\n }\n }\n }\n}\n```\n\n### Environment Variables\n\n| Variable | Description | Default |\n|----------|-------------|---------|\n| `OPENCODE_STATS_CACHE` | Enable caching | `true` |\n| `OPENCODE_STATS_CACHE_TTL` | Cache TTL in seconds | `300` |\n\n---\n\n## Testing Strategy\n\n### Unit Tests\n\n- Statistics calculations (streaks, aggregations)\n- Render component output\n- Fun fact generation\n\n### Integration Tests\n\n- Full stats computation with mock data\n- Command execution flow\n\n### Manual Testing\n\n- Various terminal sizes\n- Color/no-color modes\n- Large session histories\n\n---\n\n## Performance Considerations\n\n### Caching Strategy\n\n```typescript\ninterface CacheEntry {\n stats: StatsResult;\n computedAt: Date;\n sessionCount: number;\n}\n\nclass StatsCache {\n private cache: Map<string, CacheEntry> = new Map();\n private ttl: number;\n\n constructor(ttlSeconds: number = 300) {\n this.ttl = ttlSeconds * 1000;\n }\n\n get(period: string): StatsResult | null {\n const entry = this.cache.get(period);\n if (!entry) return null;\n \n const age = Date.now() - entry.computedAt.getTime();\n if (age > this.ttl) {\n this.cache.delete(period);\n return null;\n }\n \n return entry.stats;\n }\n\n set(period: string, stats: StatsResult, sessionCount: number): void {\n this.cache.set(period, {\n stats,\n computedAt: new Date(),\n sessionCount,\n });\n }\n\n invalidate(): void {\n this.cache.clear();\n }\n}\n```\n\n### Lazy Loading\n\n- Load only session summaries for initial stats\n- Fetch full session data only when needed (e.g., longest session details)\n\n---\n\n## Security Considerations\n\n1. **Read-only access:** Plugin only reads session data, never writes\n2. **Local processing:** All computation happens locally\n3. **No network calls:** No telemetry or external API calls\n4. **Sandboxed execution:** Runs within OpenCode's plugin sandbox\n\n---\n\n## Future Extensibility\n\n### Planned Extensions\n\n1. **Export API:** Allow other plugins to access stats\n2. **Webhook integration:** Post stats to external services\n3. **Custom metrics:** User-defined stat tracking\n4. **Themes:** Customizable color schemes\n\n### Extension Points\n\n```typescript\n// Future: Plugin extension API\ninterface StatsExtension {\n // Add custom metrics\n metrics?: CustomMetric[];\n \n // Add custom fun facts\n funFacts?: FunFactTemplate[];\n \n // Add custom views\n views?: CustomView[];\n}\n```\n\n---\n\n## Open Questions for Implementation\n\n1. **Session Data Access:**\n - How does OpenCode expose session list to plugins?\n - Is there a direct API or do we need to use events?\n - What's the schema of session/message data?\n\n2. **Rendering:**\n - Can plugins render full-screen TUI views?\n - How do we handle keyboard input (tab to switch views)?\n - Is there a blessed/ink integration or raw terminal output?\n\n3. **Token Counting:**\n - Is token count available per message?\n - If not, how do we estimate it?\n\n4. **Plugin Lifecycle:**\n - When is the plugin loaded/unloaded?\n - Can we persist cache between sessions?\n", | |
| "additions": 60, | |
| "deletions": 15 | |
| } | |
| }, | |
| "time": { | |
| "start": 1766431362559, | |
| "end": 1766431362564 | |
| } | |
| } | |
| }, | |
| { | |
| "id": "prt_b47838e230018T0LbL8x3fKDxl", | |
| "sessionID": "ses_4b8933352ffe2k7Q7VhaAWbJcB", | |
| "messageID": "msg_b4783590a001IANdB66Lj3TnKR", | |
| "type": "step-finish", | |
| "reason": "tool-calls", | |
| "cost": 0, | |
| "tokens": { | |
| "input": 1, | |
| "output": 948, | |
| "reasoning": 0, | |
| "cache": { | |
| "read": 40634, | |
| "write": 1401 | |
| } | |
| } | |
| } | |
| ] | |
| }, | |
| { | |
| "info": { | |
| "id": "msg_b47838e2b0018W2rC55faXTHO1", | |
| "sessionID": "ses_4b8933352ffe2k7Q7VhaAWbJcB", | |
| "role": "assistant", | |
| "time": { | |
| "created": 1766431362603, | |
| "completed": 1766431378220 | |
| }, | |
| "parentID": "msg_b4782c46a001rP2W0KPoAqISMd", | |
| "modelID": "claude-opus-4-5", | |
| "providerID": "anthropic", | |
| "mode": "build", | |
| "agent": "build", | |
| "path": { | |
| "cwd": "/Users/themishkun/projects/tinkering/opencode-stats", | |
| "root": "/" | |
| }, | |
| "cost": 0, | |
| "tokens": { | |
| "input": 1, | |
| "output": 1079, | |
| "reasoning": 0, | |
| "cache": { | |
| "read": 42035, | |
| "write": 974 | |
| } | |
| }, | |
| "finish": "tool-calls" | |
| }, | |
| "parts": [ | |
| { | |
| "id": "prt_b47839a5c0012Mfow358vxls5d", | |
| "sessionID": "ses_4b8933352ffe2k7Q7VhaAWbJcB", | |
| "messageID": "msg_b47838e2b0018W2rC55faXTHO1", | |
| "type": "step-start" | |
| }, | |
| { | |
| "id": "prt_b47839a5e001hp6PnZptTSwshL", | |
| "sessionID": "ses_4b8933352ffe2k7Q7VhaAWbJcB", | |
| "messageID": "msg_b47838e2b0018W2rC55faXTHO1", | |
| "type": "tool", | |
| "callID": "toolu_01MwZuThK9krdWNxtaDdm2Ar", | |
| "tool": "edit", | |
| "state": { | |
| "status": "completed", | |
| "input": { | |
| "filePath": "/Users/themishkun/projects/tinkering/opencode-stats/ARCHITECTURE.md", | |
| "oldString": "### 2. Data Layer (`src/data/`)\n\n#### Session Data Provider\n\nResponsible for accessing OpenCode's session storage.\n\n```typescript\n// src/data/sessions.ts\n\nexport interface Session {\n id: string;\n createdAt: Date;\n updatedAt: Date;\n messages: Message[];\n}\n\nexport interface Message {\n id: string;\n role: \"user\" | \"assistant\";\n timestamp: Date;\n model?: string;\n tokenCount?: {\n input: number;\n output: number;\n };\n}\n\nexport class SessionDataProvider {\n constructor(private context: PluginContext) {}\n\n async getSessions(options?: {\n from?: Date;\n to?: Date;\n limit?: number;\n }): Promise<Session[]> {\n // Access OpenCode's session list via context\n // Implementation depends on OpenCode's exposed APIs\n }\n\n async getSessionById(id: string): Promise<Session | null> {\n // Fetch a specific session with all messages\n }\n\n async getSessionSummaries(): Promise<SessionSummary[]> {\n // Lightweight fetch for stats computation\n }\n}", | |
| "newString": "### 2. Data Layer (`src/data/`)\n\n#### Session Data Provider\n\nResponsible for accessing OpenCode's session storage via the SDK client.\n\n```typescript\n// src/data/sessions.ts\n\nimport type { createOpencodeClient } from \"@opencode-ai/sdk\";\n\n// Types based on OpenCode SDK\nexport interface Session {\n id: string;\n title?: string;\n createdAt: string;\n updatedAt: string;\n}\n\nexport interface Message {\n id: string;\n sessionID: string;\n role: \"user\" | \"assistant\" | \"system\";\n createdAt: string;\n info: {\n model?: {\n providerID: string;\n modelID: string;\n };\n tokens?: {\n input: number;\n output: number;\n reasoning?: number;\n cache?: {\n read: number;\n write: number;\n };\n };\n cost?: number;\n };\n}\n\nexport interface Part {\n id: string;\n type: \"text\" | \"tool-invocation\" | \"tool-result\" | \"file\" | \"step-start\";\n content?: string;\n}\n\ntype Client = ReturnType<typeof createOpencodeClient>;\n\nexport class SessionDataProvider {\n constructor(private client: Client) {}\n\n async getSessions(options?: {\n from?: Date;\n to?: Date;\n limit?: number;\n }): Promise<Session[]> {\n // Use the SDK client to fetch sessions\n const sessions = await this.client.session.list();\n \n // Filter by date if specified\n let filtered = sessions;\n if (options?.from) {\n filtered = filtered.filter(s => new Date(s.createdAt) >= options.from!);\n }\n if (options?.to) {\n filtered = filtered.filter(s => new Date(s.createdAt) <= options.to!);\n }\n if (options?.limit) {\n filtered = filtered.slice(0, options.limit);\n }\n \n return filtered;\n }\n\n async getSessionMessages(sessionId: string): Promise<{ info: Message; parts: Part[] }[]> {\n // Fetch all messages for a session\n return await this.client.session.messages(sessionId);\n }\n\n async getAllSessionsWithMessages(options?: {\n from?: Date;\n to?: Date;\n }): Promise<Array<{ session: Session; messages: { info: Message; parts: Part[] }[] }>> {\n const sessions = await this.getSessions(options);\n \n // Fetch messages for each session in parallel\n const results = await Promise.all(\n sessions.map(async (session) => ({\n session,\n messages: await this.getSessionMessages(session.id),\n }))\n );\n \n return results;\n }\n}" | |
| }, | |
| "output": "", | |
| "title": "Users/themishkun/projects/tinkering/opencode-stats/ARCHITECTURE.md", | |
| "metadata": { | |
| "diagnostics": {}, | |
| "diff": "Index: /Users/themishkun/projects/tinkering/opencode-stats/ARCHITECTURE.md\n===================================================================\n--- /Users/themishkun/projects/tinkering/opencode-stats/ARCHITECTURE.md\n+++ /Users/themishkun/projects/tinkering/opencode-stats/ARCHITECTURE.md\n@@ -227,49 +227,100 @@\n ### 2. Data Layer (`src/data/`)\n \n #### Session Data Provider\n \n-Responsible for accessing OpenCode's session storage.\n+Responsible for accessing OpenCode's session storage via the SDK client.\n \n ```typescript\n // src/data/sessions.ts\n \n+import type { createOpencodeClient } from \"@opencode-ai/sdk\";\n+\n+// Types based on OpenCode SDK\n export interface Session {\n id: string;\n- createdAt: Date;\n- updatedAt: Date;\n- messages: Message[];\n+ title?: string;\n+ createdAt: string;\n+ updatedAt: string;\n }\n \n export interface Message {\n id: string;\n- role: \"user\" | \"assistant\";\n- timestamp: Date;\n- model?: string;\n- tokenCount?: {\n- input: number;\n- output: number;\n+ sessionID: string;\n+ role: \"user\" | \"assistant\" | \"system\";\n+ createdAt: string;\n+ info: {\n+ model?: {\n+ providerID: string;\n+ modelID: string;\n+ };\n+ tokens?: {\n+ input: number;\n+ output: number;\n+ reasoning?: number;\n+ cache?: {\n+ read: number;\n+ write: number;\n+ };\n+ };\n+ cost?: number;\n };\n }\n \n+export interface Part {\n+ id: string;\n+ type: \"text\" | \"tool-invocation\" | \"tool-result\" | \"file\" | \"step-start\";\n+ content?: string;\n+}\n+\n+type Client = ReturnType<typeof createOpencodeClient>;\n+\n export class SessionDataProvider {\n- constructor(private context: PluginContext) {}\n+ constructor(private client: Client) {}\n \n async getSessions(options?: {\n from?: Date;\n to?: Date;\n limit?: number;\n }): Promise<Session[]> {\n- // Access OpenCode's session list via context\n- // Implementation depends on OpenCode's exposed APIs\n+ // Use the SDK client to fetch sessions\n+ const sessions = await this.client.session.list();\n+ \n+ // Filter by date if specified\n+ let filtered = sessions;\n+ if (options?.from) {\n+ filtered = filtered.filter(s => new Date(s.createdAt) >= options.from!);\n+ }\n+ if (options?.to) {\n+ filtered = filtered.filter(s => new Date(s.createdAt) <= options.to!);\n+ }\n+ if (options?.limit) {\n+ filtered = filtered.slice(0, options.limit);\n+ }\n+ \n+ return filtered;\n }\n \n- async getSessionById(id: string): Promise<Session | null> {\n- // Fetch a specific session with all messages\n+ async getSessionMessages(sessionId: string): Promise<{ info: Message; parts: Part[] }[]> {\n+ // Fetch all messages for a session\n+ return await this.client.session.messages(sessionId);\n }\n \n- async getSessionSummaries(): Promise<SessionSummary[]> {\n- // Lightweight fetch for stats computation\n+ async getAllSessionsWithMessages(options?: {\n+ from?: Date;\n+ to?: Date;\n+ }): Promise<Array<{ session: Session; messages: { info: Message; parts: Part[] }[] }>> {\n+ const sessions = await this.getSessions(options);\n+ \n+ // Fetch messages for each session in parallel\n+ const results = await Promise.all(\n+ sessions.map(async (session) => ({\n+ session,\n+ messages: await this.getSessionMessages(session.id),\n+ }))\n+ );\n+ \n+ return results;\n }\n }\n ```\n \n", | |
| "filediff": { | |
| "file": "/Users/themishkun/projects/tinkering/opencode-stats/ARCHITECTURE.md", | |
| "before": "# Architecture Document: OpenCode Stats Plugin\n\n## Overview\n\nThis document describes the technical architecture of the `opencode-stats` plugin, a \"Spotify Wrapped\"-style statistics visualization tool for OpenCode.\n\n---\n\n## Plugin Architecture\n\n### OpenCode Plugin System\n\nOpenCode plugins are JavaScript/TypeScript modules that run in the Bun runtime. They follow an async function pattern that receives a `PluginInput` and returns `Hooks`.\n\n#### Plugin Input (What plugins receive)\n\n```typescript\n// From @opencode-ai/plugin\nexport type PluginInput = {\n client: ReturnType<typeof createOpencodeClient> // SDK client for API access\n project: Project // Current project info\n directory: string // Project directory\n worktree: string // Git worktree path\n $: BunShell // Bun shell for running commands\n}\n\nexport type Plugin = (input: PluginInput) => Promise<Hooks>\n```\n\n#### Available Hooks\n\n```typescript\nexport interface Hooks {\n // Listen to OpenCode events (session created, message created, etc.)\n event?: (input: { event: Event }) => Promise<void>\n \n // Modify OpenCode configuration\n config?: (input: Config) => Promise<void>\n \n // Define custom tools (slash commands)\n tool?: {\n [key: string]: ToolDefinition\n }\n \n // Custom authentication providers\n auth?: AuthHook\n \n // Called when a new message is received\n \"chat.message\"?: (\n input: { sessionID: string; agent?: string; model?: { providerID: string; modelID: string }; messageID?: string },\n output: { message: UserMessage; parts: Part[] },\n ) => Promise<void>\n \n // Modify parameters sent to LLM\n \"chat.params\"?: (\n input: { sessionID: string; agent: string; model: Model; provider: ProviderContext; message: UserMessage },\n output: { temperature: number; topP: number; topK: number; options: Record<string, any> },\n ) => Promise<void>\n \n // Intercept permission requests\n \"permission.ask\"?: (input: Permission, output: { status: \"ask\" | \"deny\" | \"allow\" }) => Promise<void>\n \n // Before tool execution - can modify args\n \"tool.execute.before\"?: (\n input: { tool: string; sessionID: string; callID: string },\n output: { args: any },\n ) => Promise<void>\n \n // After tool execution - can modify output\n \"tool.execute.after\"?: (\n input: { tool: string; sessionID: string; callID: string },\n output: { title: string; output: string; metadata: any },\n ) => Promise<void>\n \n // Transform chat messages (experimental)\n \"experimental.chat.messages.transform\"?: (\n input: {},\n output: { messages: { info: Message; parts: Part[] }[] },\n ) => Promise<void>\n \n // Transform system prompt (experimental)\n \"experimental.chat.system.transform\"?: (\n input: {},\n output: { system: string[] },\n ) => Promise<void>\n \n // Add context during session compaction (experimental)\n \"experimental.session.compacting\"?: (\n input: { sessionID: string },\n output: { context: string[] },\n ) => Promise<void>\n \n // Transform completed text (experimental)\n \"experimental.text.complete\"?: (\n input: { sessionID: string; messageID: string; partID: string },\n output: { text: string },\n ) => Promise<void>\n}\n```\n\n### Plugin Location\n\n```\n.opencode/\n└── plugin/\n └── opencode-stats/\n ├── index.ts # Main plugin entry\n ├── package.json # Dependencies\n └── src/\n ├── stats/ # Statistics computation\n ├── render/ # TUI rendering\n └── data/ # Data access layer\n```\n\n---\n\n## System Architecture\n\n```\n┌─────────────────────────────────────────────────────────────────┐\n│ OpenCode Host │\n├─────────────────────────────────────────────────────────────────┤\n│ │\n│ ┌─────────────────────────────────────────────────────────┐ │\n│ │ opencode-stats Plugin │ │\n│ ├─────────────────────────────────────────────────────────┤ │\n│ │ │ │\n│ │ ┌─────────────┐ ┌─────────────┐ ┌─────────────────┐ │ │\n│ │ │ Command │ │ Stats │ │ Renderer │ │ │\n│ │ │ Handler │──│ Engine │──│ (TUI) │ │ │\n│ │ └─────────────┘ └─────────────┘ └─────────────────┘ │ │\n│ │ │ │ │ │ │\n│ │ ▼ ▼ ▼ │ │\n│ │ ┌─────────────┐ ┌─────────────┐ ┌─────────────────┐ │ │\n│ │ │ Slash │ │ Data │ │ Components │ │ │\n│ │ │ Command │ │ Layer │ │ Library │ │ │\n│ │ └─────────────┘ └─────────────┘ └─────────────────┘ │ │\n│ │ │ │ │\n│ └──────────────────────────│─────────────────────────────┘ │\n│ │ │\n│ ▼ │\n│ ┌─────────────────────────────────────────────────────────┐ │\n│ │ OpenCode Session Storage │ │\n│ │ (SQLite / JSON) │ │\n│ └─────────────────────────────────────────────────────────┘ │\n│ │\n└─────────────────────────────────────────────────────────────────┘\n```\n\n---\n\n## Component Design\n\n### 1. Plugin Entry Point (`index.ts`)\n\n```typescript\nimport type { Plugin, Hooks, ToolDefinition } from \"@opencode-ai/plugin\";\nimport { z } from \"zod\";\nimport { StatsEngine } from \"./src/stats/engine\";\nimport { SessionDataProvider } from \"./src/data/sessions\";\nimport { StatsRenderer } from \"./src/render\";\n\nconst plugin: Plugin = async (input) => {\n const { client, project, directory } = input;\n \n // Initialize data provider with SDK client\n const dataProvider = new SessionDataProvider(client);\n const statsEngine = new StatsEngine(dataProvider);\n\n const hooks: Hooks = {\n // Register the /stats custom tool (slash command)\n tool: {\n stats: {\n description: \"View your OpenCode usage statistics (Wrapped-style)\",\n parameters: z.object({\n period: z.enum([\"week\", \"month\", \"year\", \"all\"]).optional().default(\"month\"),\n view: z.enum([\"overview\", \"models\"]).optional().default(\"overview\"),\n }),\n async execute(args) {\n const { period, view } = args;\n \n try {\n const stats = await statsEngine.computeStats({ period });\n \n const renderer = new StatsRenderer({\n width: process.stdout.columns || 80,\n height: process.stdout.rows || 24,\n colors: process.stdout.isTTY ?? false,\n });\n\n const output = renderer.render(stats, view);\n \n return {\n title: \"OpenCode Stats\",\n output,\n metadata: {\n totalSessions: stats.summary.totalSessions,\n period: stats.period,\n },\n };\n } catch (error) {\n return {\n title: \"OpenCode Stats Error\",\n output: `Error computing stats: ${error.message}`,\n metadata: { error: true },\n };\n }\n },\n },\n },\n\n // Listen to events for real-time stats updates (optional)\n async event({ event }) {\n // Could invalidate cache when new sessions/messages are created\n if (event.type === \"session.created\" || event.type === \"message.created\") {\n statsEngine.invalidateCache();\n }\n },\n };\n\n return hooks;\n};\n\nexport default plugin;\n```\n\n### 2. Data Layer (`src/data/`)\n\n#### Session Data Provider\n\nResponsible for accessing OpenCode's session storage.\n\n```typescript\n// src/data/sessions.ts\n\nexport interface Session {\n id: string;\n createdAt: Date;\n updatedAt: Date;\n messages: Message[];\n}\n\nexport interface Message {\n id: string;\n role: \"user\" | \"assistant\";\n timestamp: Date;\n model?: string;\n tokenCount?: {\n input: number;\n output: number;\n };\n}\n\nexport class SessionDataProvider {\n constructor(private context: PluginContext) {}\n\n async getSessions(options?: {\n from?: Date;\n to?: Date;\n limit?: number;\n }): Promise<Session[]> {\n // Access OpenCode's session list via context\n // Implementation depends on OpenCode's exposed APIs\n }\n\n async getSessionById(id: string): Promise<Session | null> {\n // Fetch a specific session with all messages\n }\n\n async getSessionSummaries(): Promise<SessionSummary[]> {\n // Lightweight fetch for stats computation\n }\n}\n```\n\n#### Data Models\n\n```typescript\n// src/data/models.ts\n\nexport interface SessionSummary {\n id: string;\n startTime: Date;\n endTime: Date;\n messageCount: number;\n totalTokens: number;\n models: string[];\n}\n\nexport interface DailyActivity {\n date: string; // YYYY-MM-DD\n sessionCount: number;\n totalTokens: number;\n totalDuration: number; // minutes\n}\n\nexport interface ModelUsage {\n model: string;\n sessionCount: number;\n messageCount: number;\n totalTokens: number;\n percentage: number;\n}\n```\n\n### 3. Statistics Engine (`src/stats/`)\n\n#### Core Engine\n\n```typescript\n// src/stats/engine.ts\n\nexport interface StatsResult {\n period: {\n start: Date;\n end: Date;\n days: number;\n };\n summary: {\n totalSessions: number;\n totalTokens: number;\n totalMessages: number;\n activeDays: number;\n currentStreak: number;\n longestStreak: number;\n longestSession: {\n id: string;\n duration: number; // minutes\n };\n peakHour: number; // 0-23\n favoriteModel: string;\n };\n dailyActivity: DailyActivity[];\n modelUsage: ModelUsage[];\n funFact: string;\n}\n\nexport class StatsEngine {\n constructor(private dataProvider: SessionDataProvider) {}\n\n async computeStats(options: {\n period: \"week\" | \"month\" | \"year\" | \"all\";\n }): Promise<StatsResult> {\n const sessions = await this.dataProvider.getSessions({\n from: this.getPeriodStart(options.period),\n });\n\n return {\n period: this.computePeriod(sessions, options.period),\n summary: this.computeSummary(sessions),\n dailyActivity: this.computeDailyActivity(sessions),\n modelUsage: this.computeModelUsage(sessions),\n funFact: this.generateFunFact(sessions),\n };\n }\n\n private computeSummary(sessions: Session[]): StatsResult[\"summary\"] {\n // Compute all summary statistics\n }\n\n private computeDailyActivity(sessions: Session[]): DailyActivity[] {\n // Aggregate sessions by day\n }\n\n private computeModelUsage(sessions: Session[]): ModelUsage[] {\n // Aggregate by model\n }\n\n private generateFunFact(sessions: Session[]): string {\n // Pick a fun comparison\n }\n}\n```\n\n#### Streak Calculator\n\n```typescript\n// src/stats/streaks.ts\n\nexport interface StreakResult {\n current: number;\n longest: number;\n currentStart?: Date;\n longestStart?: Date;\n longestEnd?: Date;\n}\n\nexport function calculateStreaks(dailyActivity: DailyActivity[]): StreakResult {\n // Sort by date\n const sorted = [...dailyActivity].sort(\n (a, b) => new Date(a.date).getTime() - new Date(b.date).getTime()\n );\n\n let current = 0;\n let longest = 0;\n let streak = 0;\n let prevDate: Date | null = null;\n\n for (const day of sorted) {\n const date = new Date(day.date);\n if (prevDate && isConsecutiveDay(prevDate, date)) {\n streak++;\n } else {\n streak = 1;\n }\n\n if (streak > longest) longest = streak;\n prevDate = date;\n }\n\n // Check if streak continues to today\n const today = new Date();\n today.setHours(0, 0, 0, 0);\n \n if (prevDate && isConsecutiveDay(prevDate, today)) {\n current = streak;\n } else if (prevDate?.getTime() === today.getTime()) {\n current = streak;\n }\n\n return { current, longest };\n}\n\nfunction isConsecutiveDay(a: Date, b: Date): boolean {\n const diff = b.getTime() - a.getTime();\n return diff === 24 * 60 * 60 * 1000;\n}\n```\n\n#### Fun Facts Generator\n\n```typescript\n// src/stats/funfacts.ts\n\ninterface FunFactTemplate {\n condition: (stats: StatsResult) => boolean;\n generate: (stats: StatsResult) => string;\n}\n\nconst FUN_FACTS: FunFactTemplate[] = [\n {\n condition: (s) => s.summary.longestSession.duration > 148, // Inception length\n generate: (s) => {\n const times = Math.round(s.summary.longestSession.duration / 148);\n return `Your longest session is ~${times}x longer than the movie Inception`;\n },\n },\n {\n condition: (s) => s.summary.totalTokens > 587287, // War and Peace word count\n generate: (s) => {\n const times = Math.round(s.summary.totalTokens / 587287);\n return `You've used ${times}x more tokens than words in War and Peace`;\n },\n },\n {\n condition: (s) => s.summary.currentStreak >= 7,\n generate: (s) => \n `Your ${s.summary.currentStreak}-day streak is longer than most New Year resolutions`,\n },\n {\n condition: (s) => s.summary.peakHour >= 22 || s.summary.peakHour <= 4,\n generate: () => `You're a night owl coder - peak activity is after dark`,\n },\n {\n condition: (s) => s.summary.peakHour >= 5 && s.summary.peakHour <= 8,\n generate: () => `Early bird catches the bugs - you code best at dawn`,\n },\n // More fun facts...\n];\n\nexport function generateFunFact(stats: StatsResult): string {\n const applicable = FUN_FACTS.filter((f) => f.condition(stats));\n if (applicable.length === 0) {\n return `You've had ${stats.summary.totalSessions} coding sessions - keep going!`;\n }\n const random = applicable[Math.floor(Math.random() * applicable.length)];\n return random.generate(stats);\n}\n```\n\n### 4. Renderer (`src/render/`)\n\n#### Renderer Interface\n\n```typescript\n// src/render/types.ts\n\nexport interface RenderContext {\n width: number;\n height: number;\n colors: boolean;\n}\n\nexport interface Renderer {\n render(stats: StatsResult, view: \"overview\" | \"models\"): string;\n}\n```\n\n#### Heatmap Component\n\n```typescript\n// src/render/components/heatmap.ts\n\nconst INTENSITY_CHARS = [\" \", \"░\", \"▒\", \"▓\", \"█\"];\nconst DAYS = [\"\", \"Mon\", \"\", \"Wed\", \"\", \"Fri\", \"\"];\nconst MONTHS = [\"Jan\", \"Feb\", \"Mar\", \"Apr\", \"May\", \"Jun\", \n \"Jul\", \"Aug\", \"Sep\", \"Oct\", \"Nov\", \"Dec\"];\n\nexport function renderHeatmap(\n dailyActivity: DailyActivity[],\n options: { weeks: number; colors: boolean }\n): string[] {\n const lines: string[] = [];\n \n // Build activity map\n const activityMap = new Map<string, number>();\n dailyActivity.forEach((d) => {\n activityMap.set(d.date, d.sessionCount);\n });\n\n // Calculate intensity thresholds\n const maxActivity = Math.max(...dailyActivity.map((d) => d.sessionCount), 1);\n const getIntensity = (count: number): number => {\n if (count === 0) return 0;\n return Math.min(4, Math.ceil((count / maxActivity) * 4));\n };\n\n // Generate header (months)\n const headerLine = \" \" + generateMonthHeader(options.weeks);\n lines.push(headerLine);\n\n // Generate each day row\n for (let dayOfWeek = 0; dayOfWeek < 7; dayOfWeek++) {\n let line = DAYS[dayOfWeek].padEnd(4);\n \n for (let week = 0; week < options.weeks; week++) {\n const date = getDateForWeekDay(week, dayOfWeek, options.weeks);\n const dateStr = formatDate(date);\n const count = activityMap.get(dateStr) || 0;\n const char = INTENSITY_CHARS[getIntensity(count)];\n line += char + \" \";\n }\n \n lines.push(line);\n }\n\n // Legend\n lines.push(\"\");\n lines.push(\" Less \" + INTENSITY_CHARS.slice(1).join(\" \") + \" More\");\n\n return lines;\n}\n```\n\n#### Stats Dashboard Component\n\n```typescript\n// src/render/components/dashboard.ts\n\nexport function renderDashboard(summary: StatsResult[\"summary\"]): string[] {\n const lines: string[] = [];\n \n const formatDuration = (minutes: number): string => {\n const days = Math.floor(minutes / 1440);\n const hours = Math.floor((minutes % 1440) / 60);\n const mins = minutes % 60;\n \n const parts = [];\n if (days > 0) parts.push(`${days}d`);\n if (hours > 0) parts.push(`${hours}h`);\n if (mins > 0) parts.push(`${mins}m`);\n return parts.join(\" \") || \"0m\";\n };\n\n const formatNumber = (n: number): string => {\n if (n >= 1000000) return `${(n / 1000000).toFixed(1)}m`;\n if (n >= 1000) return `${(n / 1000).toFixed(1)}k`;\n return n.toString();\n };\n\n const leftCol = [\n `Favorite model: ${summary.favoriteModel}`,\n \"\",\n `Sessions: ${summary.totalSessions}`,\n `Current streak: ${summary.currentStreak} days`,\n `Active days: ${summary.activeDays}`,\n ];\n\n const rightCol = [\n `Total tokens: ${formatNumber(summary.totalTokens)}`,\n \"\",\n `Longest session: ${formatDuration(summary.longestSession.duration)}`,\n `Longest streak: ${summary.longestStreak} days`,\n `Peak hour: ${summary.peakHour}:00-${summary.peakHour + 1}:00`,\n ];\n\n // Combine columns\n const maxLeftWidth = Math.max(...leftCol.map((l) => l.length));\n const padding = 4;\n\n for (let i = 0; i < leftCol.length; i++) {\n lines.push(\n leftCol[i].padEnd(maxLeftWidth + padding) + rightCol[i]\n );\n }\n\n return lines;\n}\n```\n\n#### Model Usage Bar Chart\n\n```typescript\n// src/render/components/models.ts\n\nexport function renderModelUsage(\n modelUsage: ModelUsage[],\n options: { width: number }\n): string[] {\n const lines: string[] = [];\n const barWidth = options.width - 40; // Space for label and percentage\n\n const sorted = [...modelUsage].sort((a, b) => b.percentage - a.percentage);\n\n for (const model of sorted.slice(0, 5)) {\n const filled = Math.round((model.percentage / 100) * barWidth);\n const empty = barWidth - filled;\n const bar = \"█\".repeat(filled) + \"░\".repeat(empty);\n const label = model.model.padEnd(28);\n const pct = `${Math.round(model.percentage)}%`.padStart(4);\n \n lines.push(` ${label} ${bar} ${pct}`);\n }\n\n return lines;\n}\n```\n\n#### Main Renderer\n\n```typescript\n// src/render/index.ts\n\nimport { renderHeatmap } from \"./components/heatmap\";\nimport { renderDashboard } from \"./components/dashboard\";\nimport { renderModelUsage } from \"./components/models\";\n\nexport class StatsRenderer implements Renderer {\n constructor(private context: RenderContext) {}\n\n render(stats: StatsResult, view: \"overview\" | \"models\"): string {\n const lines: string[] = [];\n \n // Header\n lines.push(\"\");\n const tabs = view === \"overview\" \n ? \" [Overview] Models (tab to cycle)\"\n : \" Overview [Models] (tab to cycle)\";\n lines.push(tabs);\n lines.push(\"\");\n\n if (view === \"overview\") {\n // Heatmap\n const heatmap = renderHeatmap(stats.dailyActivity, {\n weeks: 52,\n colors: this.context.colors,\n });\n lines.push(...heatmap);\n lines.push(\"\");\n\n // Dashboard stats\n const dashboard = renderDashboard(stats.summary);\n lines.push(...dashboard);\n lines.push(\"\");\n\n // Fun fact\n lines.push(` ${stats.funFact}`);\n lines.push(` Stats from the last ${stats.period.days} days`);\n } else {\n // Model breakdown\n const models = renderModelUsage(stats.modelUsage, {\n width: this.context.width,\n });\n lines.push(...models);\n }\n\n lines.push(\"\");\n return lines.join(\"\\n\");\n }\n}\n```\n\n### 5. Command Handler (`src/commands/`)\n\n```typescript\n// src/commands/stats.ts\n\nimport { z } from \"zod\";\nimport type { ToolExecuteParams } from \"opencode\";\nimport { StatsEngine } from \"../stats/engine\";\nimport { StatsRenderer } from \"../render\";\n\nexport class StatsCommand {\n constructor(private engine: StatsEngine) {}\n\n async execute(params: ToolExecuteParams<{\n period?: \"week\" | \"month\" | \"year\" | \"all\";\n view?: \"overview\" | \"models\";\n }>) {\n const { period = \"month\", view = \"overview\" } = params.input;\n\n try {\n const stats = await this.engine.computeStats({ period });\n \n const renderer = new StatsRenderer({\n width: process.stdout.columns || 80,\n height: process.stdout.rows || 24,\n colors: process.stdout.isTTY ?? false,\n });\n\n const output = renderer.render(stats, view);\n \n return {\n content: output,\n metadata: {\n totalSessions: stats.summary.totalSessions,\n period: stats.period,\n },\n };\n } catch (error) {\n return {\n content: `Error computing stats: ${error.message}`,\n isError: true,\n };\n }\n }\n}\n```\n\n---\n\n## Data Flow\n\n```\n┌──────────────────────────────────────────────────────────────────┐\n│ User invokes /stats │\n└──────────────────────────────────────────────────────────────────┘\n │\n ▼\n┌──────────────────────────────────────────────────────────────────┐\n│ StatsCommand.execute() │\n│ - Parse parameters (period, view) │\n│ - Validate inputs │\n└──────────────────────────────────────────────────────────────────┘\n │\n ▼\n┌──────────────────────────────────────────────────────────────────┐\n│ StatsEngine.computeStats() │\n│ - Fetch session data from provider │\n│ - Compute summary statistics │\n│ - Calculate streaks │\n│ - Aggregate daily activity │\n│ - Compute model usage │\n│ - Generate fun fact │\n└──────────────────────────────────────────────────────────────────┘\n │\n ▼\n┌──────────────────────────────────────────────────────────────────┐\n│ SessionDataProvider.getSessions() │\n│ - Access OpenCode session storage │\n│ - Filter by date range │\n│ - Return session summaries │\n└──────────────────────────────────────────────────────────────────┘\n │\n ▼\n┌──────────────────────────────────────────────────────────────────┐\n│ StatsRenderer.render() │\n│ - Select view (overview/models) │\n│ - Compose components │\n│ - Generate ASCII output │\n└──────────────────────────────────────────────────────────────────┘\n │\n ▼\n┌──────────────────────────────────────────────────────────────────┐\n│ Display output to user │\n└──────────────────────────────────────────────────────────────────┘\n```\n\n---\n\n## File Structure\n\n```\nopencode-stats/\n├── index.ts # Plugin entry point\n├── package.json # Dependencies and metadata\n├── tsconfig.json # TypeScript configuration\n├── README.md # Plugin documentation\n│\n├── src/\n│ ├── commands/\n│ │ └── stats.ts # Slash command handler\n│ │\n│ ├── data/\n│ │ ├── sessions.ts # Session data provider\n│ │ └── models.ts # Data models/interfaces\n│ │\n│ ├── stats/\n│ │ ├── engine.ts # Main statistics engine\n│ │ ├── streaks.ts # Streak calculation\n│ │ ├── funfacts.ts # Fun fact generator\n│ │ └── aggregators.ts # Data aggregation utilities\n│ │\n│ └── render/\n│ ├── index.ts # Main renderer\n│ ├── types.ts # Render interfaces\n│ └── components/\n│ ├── heatmap.ts # Activity heatmap\n│ ├── dashboard.ts # Stats dashboard\n│ ├── models.ts # Model usage chart\n│ └── box.ts # Box drawing utilities\n│\n└── tests/\n ├── stats/\n │ ├── engine.test.ts\n │ └── streaks.test.ts\n └── render/\n └── components.test.ts\n```\n\n---\n\n## Dependencies\n\n```json\n{\n \"name\": \"opencode-stats\",\n \"version\": \"1.0.0\",\n \"type\": \"module\",\n \"main\": \"index.ts\",\n \"dependencies\": {\n \"zod\": \"^3.22.0\"\n },\n \"devDependencies\": {\n \"@types/bun\": \"latest\",\n \"typescript\": \"^5.0.0\"\n },\n \"peerDependencies\": {\n \"opencode\": \">=0.1.0\"\n }\n}\n```\n\n---\n\n## Configuration\n\n### Plugin Configuration (`opencode.json`)\n\n```json\n{\n \"plugins\": {\n \"opencode-stats\": {\n \"enabled\": true,\n \"options\": {\n \"defaultPeriod\": \"month\",\n \"cacheEnabled\": true,\n \"cacheTTL\": 300\n }\n }\n }\n}\n```\n\n### Environment Variables\n\n| Variable | Description | Default |\n|----------|-------------|---------|\n| `OPENCODE_STATS_CACHE` | Enable caching | `true` |\n| `OPENCODE_STATS_CACHE_TTL` | Cache TTL in seconds | `300` |\n\n---\n\n## Testing Strategy\n\n### Unit Tests\n\n- Statistics calculations (streaks, aggregations)\n- Render component output\n- Fun fact generation\n\n### Integration Tests\n\n- Full stats computation with mock data\n- Command execution flow\n\n### Manual Testing\n\n- Various terminal sizes\n- Color/no-color modes\n- Large session histories\n\n---\n\n## Performance Considerations\n\n### Caching Strategy\n\n```typescript\ninterface CacheEntry {\n stats: StatsResult;\n computedAt: Date;\n sessionCount: number;\n}\n\nclass StatsCache {\n private cache: Map<string, CacheEntry> = new Map();\n private ttl: number;\n\n constructor(ttlSeconds: number = 300) {\n this.ttl = ttlSeconds * 1000;\n }\n\n get(period: string): StatsResult | null {\n const entry = this.cache.get(period);\n if (!entry) return null;\n \n const age = Date.now() - entry.computedAt.getTime();\n if (age > this.ttl) {\n this.cache.delete(period);\n return null;\n }\n \n return entry.stats;\n }\n\n set(period: string, stats: StatsResult, sessionCount: number): void {\n this.cache.set(period, {\n stats,\n computedAt: new Date(),\n sessionCount,\n });\n }\n\n invalidate(): void {\n this.cache.clear();\n }\n}\n```\n\n### Lazy Loading\n\n- Load only session summaries for initial stats\n- Fetch full session data only when needed (e.g., longest session details)\n\n---\n\n## Security Considerations\n\n1. **Read-only access:** Plugin only reads session data, never writes\n2. **Local processing:** All computation happens locally\n3. **No network calls:** No telemetry or external API calls\n4. **Sandboxed execution:** Runs within OpenCode's plugin sandbox\n\n---\n\n## Future Extensibility\n\n### Planned Extensions\n\n1. **Export API:** Allow other plugins to access stats\n2. **Webhook integration:** Post stats to external services\n3. **Custom metrics:** User-defined stat tracking\n4. **Themes:** Customizable color schemes\n\n### Extension Points\n\n```typescript\n// Future: Plugin extension API\ninterface StatsExtension {\n // Add custom metrics\n metrics?: CustomMetric[];\n \n // Add custom fun facts\n funFacts?: FunFactTemplate[];\n \n // Add custom views\n views?: CustomView[];\n}\n```\n\n---\n\n## Open Questions for Implementation\n\n1. **Session Data Access:**\n - How does OpenCode expose session list to plugins?\n - Is there a direct API or do we need to use events?\n - What's the schema of session/message data?\n\n2. **Rendering:**\n - Can plugins render full-screen TUI views?\n - How do we handle keyboard input (tab to switch views)?\n - Is there a blessed/ink integration or raw terminal output?\n\n3. **Token Counting:**\n - Is token count available per message?\n - If not, how do we estimate it?\n\n4. **Plugin Lifecycle:**\n - When is the plugin loaded/unloaded?\n - Can we persist cache between sessions?\n", | |
| "after": "# Architecture Document: OpenCode Stats Plugin\n\n## Overview\n\nThis document describes the technical architecture of the `opencode-stats` plugin, a \"Spotify Wrapped\"-style statistics visualization tool for OpenCode.\n\n---\n\n## Plugin Architecture\n\n### OpenCode Plugin System\n\nOpenCode plugins are JavaScript/TypeScript modules that run in the Bun runtime. They follow an async function pattern that receives a `PluginInput` and returns `Hooks`.\n\n#### Plugin Input (What plugins receive)\n\n```typescript\n// From @opencode-ai/plugin\nexport type PluginInput = {\n client: ReturnType<typeof createOpencodeClient> // SDK client for API access\n project: Project // Current project info\n directory: string // Project directory\n worktree: string // Git worktree path\n $: BunShell // Bun shell for running commands\n}\n\nexport type Plugin = (input: PluginInput) => Promise<Hooks>\n```\n\n#### Available Hooks\n\n```typescript\nexport interface Hooks {\n // Listen to OpenCode events (session created, message created, etc.)\n event?: (input: { event: Event }) => Promise<void>\n \n // Modify OpenCode configuration\n config?: (input: Config) => Promise<void>\n \n // Define custom tools (slash commands)\n tool?: {\n [key: string]: ToolDefinition\n }\n \n // Custom authentication providers\n auth?: AuthHook\n \n // Called when a new message is received\n \"chat.message\"?: (\n input: { sessionID: string; agent?: string; model?: { providerID: string; modelID: string }; messageID?: string },\n output: { message: UserMessage; parts: Part[] },\n ) => Promise<void>\n \n // Modify parameters sent to LLM\n \"chat.params\"?: (\n input: { sessionID: string; agent: string; model: Model; provider: ProviderContext; message: UserMessage },\n output: { temperature: number; topP: number; topK: number; options: Record<string, any> },\n ) => Promise<void>\n \n // Intercept permission requests\n \"permission.ask\"?: (input: Permission, output: { status: \"ask\" | \"deny\" | \"allow\" }) => Promise<void>\n \n // Before tool execution - can modify args\n \"tool.execute.before\"?: (\n input: { tool: string; sessionID: string; callID: string },\n output: { args: any },\n ) => Promise<void>\n \n // After tool execution - can modify output\n \"tool.execute.after\"?: (\n input: { tool: string; sessionID: string; callID: string },\n output: { title: string; output: string; metadata: any },\n ) => Promise<void>\n \n // Transform chat messages (experimental)\n \"experimental.chat.messages.transform\"?: (\n input: {},\n output: { messages: { info: Message; parts: Part[] }[] },\n ) => Promise<void>\n \n // Transform system prompt (experimental)\n \"experimental.chat.system.transform\"?: (\n input: {},\n output: { system: string[] },\n ) => Promise<void>\n \n // Add context during session compaction (experimental)\n \"experimental.session.compacting\"?: (\n input: { sessionID: string },\n output: { context: string[] },\n ) => Promise<void>\n \n // Transform completed text (experimental)\n \"experimental.text.complete\"?: (\n input: { sessionID: string; messageID: string; partID: string },\n output: { text: string },\n ) => Promise<void>\n}\n```\n\n### Plugin Location\n\n```\n.opencode/\n└── plugin/\n └── opencode-stats/\n ├── index.ts # Main plugin entry\n ├── package.json # Dependencies\n └── src/\n ├── stats/ # Statistics computation\n ├── render/ # TUI rendering\n └── data/ # Data access layer\n```\n\n---\n\n## System Architecture\n\n```\n┌─────────────────────────────────────────────────────────────────┐\n│ OpenCode Host │\n├─────────────────────────────────────────────────────────────────┤\n│ │\n│ ┌─────────────────────────────────────────────────────────┐ │\n│ │ opencode-stats Plugin │ │\n│ ├─────────────────────────────────────────────────────────┤ │\n│ │ │ │\n│ │ ┌─────────────┐ ┌─────────────┐ ┌─────────────────┐ │ │\n│ │ │ Command │ │ Stats │ │ Renderer │ │ │\n│ │ │ Handler │──│ Engine │──│ (TUI) │ │ │\n│ │ └─────────────┘ └─────────────┘ └─────────────────┘ │ │\n│ │ │ │ │ │ │\n│ │ ▼ ▼ ▼ │ │\n│ │ ┌─────────────┐ ┌─────────────┐ ┌─────────────────┐ │ │\n│ │ │ Slash │ │ Data │ │ Components │ │ │\n│ │ │ Command │ │ Layer │ │ Library │ │ │\n│ │ └─────────────┘ └─────────────┘ └─────────────────┘ │ │\n│ │ │ │ │\n│ └──────────────────────────│─────────────────────────────┘ │\n│ │ │\n│ ▼ │\n│ ┌─────────────────────────────────────────────────────────┐ │\n│ │ OpenCode Session Storage │ │\n│ │ (SQLite / JSON) │ │\n│ └─────────────────────────────────────────────────────────┘ │\n│ │\n└─────────────────────────────────────────────────────────────────┘\n```\n\n---\n\n## Component Design\n\n### 1. Plugin Entry Point (`index.ts`)\n\n```typescript\nimport type { Plugin, Hooks, ToolDefinition } from \"@opencode-ai/plugin\";\nimport { z } from \"zod\";\nimport { StatsEngine } from \"./src/stats/engine\";\nimport { SessionDataProvider } from \"./src/data/sessions\";\nimport { StatsRenderer } from \"./src/render\";\n\nconst plugin: Plugin = async (input) => {\n const { client, project, directory } = input;\n \n // Initialize data provider with SDK client\n const dataProvider = new SessionDataProvider(client);\n const statsEngine = new StatsEngine(dataProvider);\n\n const hooks: Hooks = {\n // Register the /stats custom tool (slash command)\n tool: {\n stats: {\n description: \"View your OpenCode usage statistics (Wrapped-style)\",\n parameters: z.object({\n period: z.enum([\"week\", \"month\", \"year\", \"all\"]).optional().default(\"month\"),\n view: z.enum([\"overview\", \"models\"]).optional().default(\"overview\"),\n }),\n async execute(args) {\n const { period, view } = args;\n \n try {\n const stats = await statsEngine.computeStats({ period });\n \n const renderer = new StatsRenderer({\n width: process.stdout.columns || 80,\n height: process.stdout.rows || 24,\n colors: process.stdout.isTTY ?? false,\n });\n\n const output = renderer.render(stats, view);\n \n return {\n title: \"OpenCode Stats\",\n output,\n metadata: {\n totalSessions: stats.summary.totalSessions,\n period: stats.period,\n },\n };\n } catch (error) {\n return {\n title: \"OpenCode Stats Error\",\n output: `Error computing stats: ${error.message}`,\n metadata: { error: true },\n };\n }\n },\n },\n },\n\n // Listen to events for real-time stats updates (optional)\n async event({ event }) {\n // Could invalidate cache when new sessions/messages are created\n if (event.type === \"session.created\" || event.type === \"message.created\") {\n statsEngine.invalidateCache();\n }\n },\n };\n\n return hooks;\n};\n\nexport default plugin;\n```\n\n### 2. Data Layer (`src/data/`)\n\n#### Session Data Provider\n\nResponsible for accessing OpenCode's session storage via the SDK client.\n\n```typescript\n// src/data/sessions.ts\n\nimport type { createOpencodeClient } from \"@opencode-ai/sdk\";\n\n// Types based on OpenCode SDK\nexport interface Session {\n id: string;\n title?: string;\n createdAt: string;\n updatedAt: string;\n}\n\nexport interface Message {\n id: string;\n sessionID: string;\n role: \"user\" | \"assistant\" | \"system\";\n createdAt: string;\n info: {\n model?: {\n providerID: string;\n modelID: string;\n };\n tokens?: {\n input: number;\n output: number;\n reasoning?: number;\n cache?: {\n read: number;\n write: number;\n };\n };\n cost?: number;\n };\n}\n\nexport interface Part {\n id: string;\n type: \"text\" | \"tool-invocation\" | \"tool-result\" | \"file\" | \"step-start\";\n content?: string;\n}\n\ntype Client = ReturnType<typeof createOpencodeClient>;\n\nexport class SessionDataProvider {\n constructor(private client: Client) {}\n\n async getSessions(options?: {\n from?: Date;\n to?: Date;\n limit?: number;\n }): Promise<Session[]> {\n // Use the SDK client to fetch sessions\n const sessions = await this.client.session.list();\n \n // Filter by date if specified\n let filtered = sessions;\n if (options?.from) {\n filtered = filtered.filter(s => new Date(s.createdAt) >= options.from!);\n }\n if (options?.to) {\n filtered = filtered.filter(s => new Date(s.createdAt) <= options.to!);\n }\n if (options?.limit) {\n filtered = filtered.slice(0, options.limit);\n }\n \n return filtered;\n }\n\n async getSessionMessages(sessionId: string): Promise<{ info: Message; parts: Part[] }[]> {\n // Fetch all messages for a session\n return await this.client.session.messages(sessionId);\n }\n\n async getAllSessionsWithMessages(options?: {\n from?: Date;\n to?: Date;\n }): Promise<Array<{ session: Session; messages: { info: Message; parts: Part[] }[] }>> {\n const sessions = await this.getSessions(options);\n \n // Fetch messages for each session in parallel\n const results = await Promise.all(\n sessions.map(async (session) => ({\n session,\n messages: await this.getSessionMessages(session.id),\n }))\n );\n \n return results;\n }\n}\n```\n\n#### Data Models\n\n```typescript\n// src/data/models.ts\n\nexport interface SessionSummary {\n id: string;\n startTime: Date;\n endTime: Date;\n messageCount: number;\n totalTokens: number;\n models: string[];\n}\n\nexport interface DailyActivity {\n date: string; // YYYY-MM-DD\n sessionCount: number;\n totalTokens: number;\n totalDuration: number; // minutes\n}\n\nexport interface ModelUsage {\n model: string;\n sessionCount: number;\n messageCount: number;\n totalTokens: number;\n percentage: number;\n}\n```\n\n### 3. Statistics Engine (`src/stats/`)\n\n#### Core Engine\n\n```typescript\n// src/stats/engine.ts\n\nexport interface StatsResult {\n period: {\n start: Date;\n end: Date;\n days: number;\n };\n summary: {\n totalSessions: number;\n totalTokens: number;\n totalMessages: number;\n activeDays: number;\n currentStreak: number;\n longestStreak: number;\n longestSession: {\n id: string;\n duration: number; // minutes\n };\n peakHour: number; // 0-23\n favoriteModel: string;\n };\n dailyActivity: DailyActivity[];\n modelUsage: ModelUsage[];\n funFact: string;\n}\n\nexport class StatsEngine {\n constructor(private dataProvider: SessionDataProvider) {}\n\n async computeStats(options: {\n period: \"week\" | \"month\" | \"year\" | \"all\";\n }): Promise<StatsResult> {\n const sessions = await this.dataProvider.getSessions({\n from: this.getPeriodStart(options.period),\n });\n\n return {\n period: this.computePeriod(sessions, options.period),\n summary: this.computeSummary(sessions),\n dailyActivity: this.computeDailyActivity(sessions),\n modelUsage: this.computeModelUsage(sessions),\n funFact: this.generateFunFact(sessions),\n };\n }\n\n private computeSummary(sessions: Session[]): StatsResult[\"summary\"] {\n // Compute all summary statistics\n }\n\n private computeDailyActivity(sessions: Session[]): DailyActivity[] {\n // Aggregate sessions by day\n }\n\n private computeModelUsage(sessions: Session[]): ModelUsage[] {\n // Aggregate by model\n }\n\n private generateFunFact(sessions: Session[]): string {\n // Pick a fun comparison\n }\n}\n```\n\n#### Streak Calculator\n\n```typescript\n// src/stats/streaks.ts\n\nexport interface StreakResult {\n current: number;\n longest: number;\n currentStart?: Date;\n longestStart?: Date;\n longestEnd?: Date;\n}\n\nexport function calculateStreaks(dailyActivity: DailyActivity[]): StreakResult {\n // Sort by date\n const sorted = [...dailyActivity].sort(\n (a, b) => new Date(a.date).getTime() - new Date(b.date).getTime()\n );\n\n let current = 0;\n let longest = 0;\n let streak = 0;\n let prevDate: Date | null = null;\n\n for (const day of sorted) {\n const date = new Date(day.date);\n if (prevDate && isConsecutiveDay(prevDate, date)) {\n streak++;\n } else {\n streak = 1;\n }\n\n if (streak > longest) longest = streak;\n prevDate = date;\n }\n\n // Check if streak continues to today\n const today = new Date();\n today.setHours(0, 0, 0, 0);\n \n if (prevDate && isConsecutiveDay(prevDate, today)) {\n current = streak;\n } else if (prevDate?.getTime() === today.getTime()) {\n current = streak;\n }\n\n return { current, longest };\n}\n\nfunction isConsecutiveDay(a: Date, b: Date): boolean {\n const diff = b.getTime() - a.getTime();\n return diff === 24 * 60 * 60 * 1000;\n}\n```\n\n#### Fun Facts Generator\n\n```typescript\n// src/stats/funfacts.ts\n\ninterface FunFactTemplate {\n condition: (stats: StatsResult) => boolean;\n generate: (stats: StatsResult) => string;\n}\n\nconst FUN_FACTS: FunFactTemplate[] = [\n {\n condition: (s) => s.summary.longestSession.duration > 148, // Inception length\n generate: (s) => {\n const times = Math.round(s.summary.longestSession.duration / 148);\n return `Your longest session is ~${times}x longer than the movie Inception`;\n },\n },\n {\n condition: (s) => s.summary.totalTokens > 587287, // War and Peace word count\n generate: (s) => {\n const times = Math.round(s.summary.totalTokens / 587287);\n return `You've used ${times}x more tokens than words in War and Peace`;\n },\n },\n {\n condition: (s) => s.summary.currentStreak >= 7,\n generate: (s) => \n `Your ${s.summary.currentStreak}-day streak is longer than most New Year resolutions`,\n },\n {\n condition: (s) => s.summary.peakHour >= 22 || s.summary.peakHour <= 4,\n generate: () => `You're a night owl coder - peak activity is after dark`,\n },\n {\n condition: (s) => s.summary.peakHour >= 5 && s.summary.peakHour <= 8,\n generate: () => `Early bird catches the bugs - you code best at dawn`,\n },\n // More fun facts...\n];\n\nexport function generateFunFact(stats: StatsResult): string {\n const applicable = FUN_FACTS.filter((f) => f.condition(stats));\n if (applicable.length === 0) {\n return `You've had ${stats.summary.totalSessions} coding sessions - keep going!`;\n }\n const random = applicable[Math.floor(Math.random() * applicable.length)];\n return random.generate(stats);\n}\n```\n\n### 4. Renderer (`src/render/`)\n\n#### Renderer Interface\n\n```typescript\n// src/render/types.ts\n\nexport interface RenderContext {\n width: number;\n height: number;\n colors: boolean;\n}\n\nexport interface Renderer {\n render(stats: StatsResult, view: \"overview\" | \"models\"): string;\n}\n```\n\n#### Heatmap Component\n\n```typescript\n// src/render/components/heatmap.ts\n\nconst INTENSITY_CHARS = [\" \", \"░\", \"▒\", \"▓\", \"█\"];\nconst DAYS = [\"\", \"Mon\", \"\", \"Wed\", \"\", \"Fri\", \"\"];\nconst MONTHS = [\"Jan\", \"Feb\", \"Mar\", \"Apr\", \"May\", \"Jun\", \n \"Jul\", \"Aug\", \"Sep\", \"Oct\", \"Nov\", \"Dec\"];\n\nexport function renderHeatmap(\n dailyActivity: DailyActivity[],\n options: { weeks: number; colors: boolean }\n): string[] {\n const lines: string[] = [];\n \n // Build activity map\n const activityMap = new Map<string, number>();\n dailyActivity.forEach((d) => {\n activityMap.set(d.date, d.sessionCount);\n });\n\n // Calculate intensity thresholds\n const maxActivity = Math.max(...dailyActivity.map((d) => d.sessionCount), 1);\n const getIntensity = (count: number): number => {\n if (count === 0) return 0;\n return Math.min(4, Math.ceil((count / maxActivity) * 4));\n };\n\n // Generate header (months)\n const headerLine = \" \" + generateMonthHeader(options.weeks);\n lines.push(headerLine);\n\n // Generate each day row\n for (let dayOfWeek = 0; dayOfWeek < 7; dayOfWeek++) {\n let line = DAYS[dayOfWeek].padEnd(4);\n \n for (let week = 0; week < options.weeks; week++) {\n const date = getDateForWeekDay(week, dayOfWeek, options.weeks);\n const dateStr = formatDate(date);\n const count = activityMap.get(dateStr) || 0;\n const char = INTENSITY_CHARS[getIntensity(count)];\n line += char + \" \";\n }\n \n lines.push(line);\n }\n\n // Legend\n lines.push(\"\");\n lines.push(\" Less \" + INTENSITY_CHARS.slice(1).join(\" \") + \" More\");\n\n return lines;\n}\n```\n\n#### Stats Dashboard Component\n\n```typescript\n// src/render/components/dashboard.ts\n\nexport function renderDashboard(summary: StatsResult[\"summary\"]): string[] {\n const lines: string[] = [];\n \n const formatDuration = (minutes: number): string => {\n const days = Math.floor(minutes / 1440);\n const hours = Math.floor((minutes % 1440) / 60);\n const mins = minutes % 60;\n \n const parts = [];\n if (days > 0) parts.push(`${days}d`);\n if (hours > 0) parts.push(`${hours}h`);\n if (mins > 0) parts.push(`${mins}m`);\n return parts.join(\" \") || \"0m\";\n };\n\n const formatNumber = (n: number): string => {\n if (n >= 1000000) return `${(n / 1000000).toFixed(1)}m`;\n if (n >= 1000) return `${(n / 1000).toFixed(1)}k`;\n return n.toString();\n };\n\n const leftCol = [\n `Favorite model: ${summary.favoriteModel}`,\n \"\",\n `Sessions: ${summary.totalSessions}`,\n `Current streak: ${summary.currentStreak} days`,\n `Active days: ${summary.activeDays}`,\n ];\n\n const rightCol = [\n `Total tokens: ${formatNumber(summary.totalTokens)}`,\n \"\",\n `Longest session: ${formatDuration(summary.longestSession.duration)}`,\n `Longest streak: ${summary.longestStreak} days`,\n `Peak hour: ${summary.peakHour}:00-${summary.peakHour + 1}:00`,\n ];\n\n // Combine columns\n const maxLeftWidth = Math.max(...leftCol.map((l) => l.length));\n const padding = 4;\n\n for (let i = 0; i < leftCol.length; i++) {\n lines.push(\n leftCol[i].padEnd(maxLeftWidth + padding) + rightCol[i]\n );\n }\n\n return lines;\n}\n```\n\n#### Model Usage Bar Chart\n\n```typescript\n// src/render/components/models.ts\n\nexport function renderModelUsage(\n modelUsage: ModelUsage[],\n options: { width: number }\n): string[] {\n const lines: string[] = [];\n const barWidth = options.width - 40; // Space for label and percentage\n\n const sorted = [...modelUsage].sort((a, b) => b.percentage - a.percentage);\n\n for (const model of sorted.slice(0, 5)) {\n const filled = Math.round((model.percentage / 100) * barWidth);\n const empty = barWidth - filled;\n const bar = \"█\".repeat(filled) + \"░\".repeat(empty);\n const label = model.model.padEnd(28);\n const pct = `${Math.round(model.percentage)}%`.padStart(4);\n \n lines.push(` ${label} ${bar} ${pct}`);\n }\n\n return lines;\n}\n```\n\n#### Main Renderer\n\n```typescript\n// src/render/index.ts\n\nimport { renderHeatmap } from \"./components/heatmap\";\nimport { renderDashboard } from \"./components/dashboard\";\nimport { renderModelUsage } from \"./components/models\";\n\nexport class StatsRenderer implements Renderer {\n constructor(private context: RenderContext) {}\n\n render(stats: StatsResult, view: \"overview\" | \"models\"): string {\n const lines: string[] = [];\n \n // Header\n lines.push(\"\");\n const tabs = view === \"overview\" \n ? \" [Overview] Models (tab to cycle)\"\n : \" Overview [Models] (tab to cycle)\";\n lines.push(tabs);\n lines.push(\"\");\n\n if (view === \"overview\") {\n // Heatmap\n const heatmap = renderHeatmap(stats.dailyActivity, {\n weeks: 52,\n colors: this.context.colors,\n });\n lines.push(...heatmap);\n lines.push(\"\");\n\n // Dashboard stats\n const dashboard = renderDashboard(stats.summary);\n lines.push(...dashboard);\n lines.push(\"\");\n\n // Fun fact\n lines.push(` ${stats.funFact}`);\n lines.push(` Stats from the last ${stats.period.days} days`);\n } else {\n // Model breakdown\n const models = renderModelUsage(stats.modelUsage, {\n width: this.context.width,\n });\n lines.push(...models);\n }\n\n lines.push(\"\");\n return lines.join(\"\\n\");\n }\n}\n```\n\n### 5. Command Handler (`src/commands/`)\n\n```typescript\n// src/commands/stats.ts\n\nimport { z } from \"zod\";\nimport type { ToolExecuteParams } from \"opencode\";\nimport { StatsEngine } from \"../stats/engine\";\nimport { StatsRenderer } from \"../render\";\n\nexport class StatsCommand {\n constructor(private engine: StatsEngine) {}\n\n async execute(params: ToolExecuteParams<{\n period?: \"week\" | \"month\" | \"year\" | \"all\";\n view?: \"overview\" | \"models\";\n }>) {\n const { period = \"month\", view = \"overview\" } = params.input;\n\n try {\n const stats = await this.engine.computeStats({ period });\n \n const renderer = new StatsRenderer({\n width: process.stdout.columns || 80,\n height: process.stdout.rows || 24,\n colors: process.stdout.isTTY ?? false,\n });\n\n const output = renderer.render(stats, view);\n \n return {\n content: output,\n metadata: {\n totalSessions: stats.summary.totalSessions,\n period: stats.period,\n },\n };\n } catch (error) {\n return {\n content: `Error computing stats: ${error.message}`,\n isError: true,\n };\n }\n }\n}\n```\n\n---\n\n## Data Flow\n\n```\n┌──────────────────────────────────────────────────────────────────┐\n│ User invokes /stats │\n└──────────────────────────────────────────────────────────────────┘\n │\n ▼\n┌──────────────────────────────────────────────────────────────────┐\n│ StatsCommand.execute() │\n│ - Parse parameters (period, view) │\n│ - Validate inputs │\n└──────────────────────────────────────────────────────────────────┘\n │\n ▼\n┌──────────────────────────────────────────────────────────────────┐\n│ StatsEngine.computeStats() │\n│ - Fetch session data from provider │\n│ - Compute summary statistics │\n│ - Calculate streaks │\n│ - Aggregate daily activity │\n│ - Compute model usage │\n│ - Generate fun fact │\n└──────────────────────────────────────────────────────────────────┘\n │\n ▼\n┌──────────────────────────────────────────────────────────────────┐\n│ SessionDataProvider.getSessions() │\n│ - Access OpenCode session storage │\n│ - Filter by date range │\n│ - Return session summaries │\n└──────────────────────────────────────────────────────────────────┘\n │\n ▼\n┌──────────────────────────────────────────────────────────────────┐\n│ StatsRenderer.render() │\n│ - Select view (overview/models) │\n│ - Compose components │\n│ - Generate ASCII output │\n└──────────────────────────────────────────────────────────────────┘\n │\n ▼\n┌──────────────────────────────────────────────────────────────────┐\n│ Display output to user │\n└──────────────────────────────────────────────────────────────────┘\n```\n\n---\n\n## File Structure\n\n```\nopencode-stats/\n├── index.ts # Plugin entry point\n├── package.json # Dependencies and metadata\n├── tsconfig.json # TypeScript configuration\n├── README.md # Plugin documentation\n│\n├── src/\n│ ├── commands/\n│ │ └── stats.ts # Slash command handler\n│ │\n│ ├── data/\n│ │ ├── sessions.ts # Session data provider\n│ │ └── models.ts # Data models/interfaces\n│ │\n│ ├── stats/\n│ │ ├── engine.ts # Main statistics engine\n│ │ ├── streaks.ts # Streak calculation\n│ │ ├── funfacts.ts # Fun fact generator\n│ │ └── aggregators.ts # Data aggregation utilities\n│ │\n│ └── render/\n│ ├── index.ts # Main renderer\n│ ├── types.ts # Render interfaces\n│ └── components/\n│ ├── heatmap.ts # Activity heatmap\n│ ├── dashboard.ts # Stats dashboard\n│ ├── models.ts # Model usage chart\n│ └── box.ts # Box drawing utilities\n│\n└── tests/\n ├── stats/\n │ ├── engine.test.ts\n │ └── streaks.test.ts\n └── render/\n └── components.test.ts\n```\n\n---\n\n## Dependencies\n\n```json\n{\n \"name\": \"opencode-stats\",\n \"version\": \"1.0.0\",\n \"type\": \"module\",\n \"main\": \"index.ts\",\n \"dependencies\": {\n \"zod\": \"^3.22.0\"\n },\n \"devDependencies\": {\n \"@types/bun\": \"latest\",\n \"typescript\": \"^5.0.0\"\n },\n \"peerDependencies\": {\n \"opencode\": \">=0.1.0\"\n }\n}\n```\n\n---\n\n## Configuration\n\n### Plugin Configuration (`opencode.json`)\n\n```json\n{\n \"plugins\": {\n \"opencode-stats\": {\n \"enabled\": true,\n \"options\": {\n \"defaultPeriod\": \"month\",\n \"cacheEnabled\": true,\n \"cacheTTL\": 300\n }\n }\n }\n}\n```\n\n### Environment Variables\n\n| Variable | Description | Default |\n|----------|-------------|---------|\n| `OPENCODE_STATS_CACHE` | Enable caching | `true` |\n| `OPENCODE_STATS_CACHE_TTL` | Cache TTL in seconds | `300` |\n\n---\n\n## Testing Strategy\n\n### Unit Tests\n\n- Statistics calculations (streaks, aggregations)\n- Render component output\n- Fun fact generation\n\n### Integration Tests\n\n- Full stats computation with mock data\n- Command execution flow\n\n### Manual Testing\n\n- Various terminal sizes\n- Color/no-color modes\n- Large session histories\n\n---\n\n## Performance Considerations\n\n### Caching Strategy\n\n```typescript\ninterface CacheEntry {\n stats: StatsResult;\n computedAt: Date;\n sessionCount: number;\n}\n\nclass StatsCache {\n private cache: Map<string, CacheEntry> = new Map();\n private ttl: number;\n\n constructor(ttlSeconds: number = 300) {\n this.ttl = ttlSeconds * 1000;\n }\n\n get(period: string): StatsResult | null {\n const entry = this.cache.get(period);\n if (!entry) return null;\n \n const age = Date.now() - entry.computedAt.getTime();\n if (age > this.ttl) {\n this.cache.delete(period);\n return null;\n }\n \n return entry.stats;\n }\n\n set(period: string, stats: StatsResult, sessionCount: number): void {\n this.cache.set(period, {\n stats,\n computedAt: new Date(),\n sessionCount,\n });\n }\n\n invalidate(): void {\n this.cache.clear();\n }\n}\n```\n\n### Lazy Loading\n\n- Load only session summaries for initial stats\n- Fetch full session data only when needed (e.g., longest session details)\n\n---\n\n## Security Considerations\n\n1. **Read-only access:** Plugin only reads session data, never writes\n2. **Local processing:** All computation happens locally\n3. **No network calls:** No telemetry or external API calls\n4. **Sandboxed execution:** Runs within OpenCode's plugin sandbox\n\n---\n\n## Future Extensibility\n\n### Planned Extensions\n\n1. **Export API:** Allow other plugins to access stats\n2. **Webhook integration:** Post stats to external services\n3. **Custom metrics:** User-defined stat tracking\n4. **Themes:** Customizable color schemes\n\n### Extension Points\n\n```typescript\n// Future: Plugin extension API\ninterface StatsExtension {\n // Add custom metrics\n metrics?: CustomMetric[];\n \n // Add custom fun facts\n funFacts?: FunFactTemplate[];\n \n // Add custom views\n views?: CustomView[];\n}\n```\n\n---\n\n## Open Questions for Implementation\n\n1. **Session Data Access:**\n - How does OpenCode expose session list to plugins?\n - Is there a direct API or do we need to use events?\n - What's the schema of session/message data?\n\n2. **Rendering:**\n - Can plugins render full-screen TUI views?\n - How do we handle keyboard input (tab to switch views)?\n - Is there a blessed/ink integration or raw terminal output?\n\n3. **Token Counting:**\n - Is token count available per message?\n - If not, how do we estimate it?\n\n4. **Plugin Lifecycle:**\n - When is the plugin loaded/unloaded?\n - Can we persist cache between sessions?\n", | |
| "additions": 68, | |
| "deletions": 17 | |
| } | |
| }, | |
| "time": { | |
| "start": 1766431378196, | |
| "end": 1766431378202 | |
| } | |
| } | |
| }, | |
| { | |
| "id": "prt_b4783cb2b001ToEGhpppCgQyq6", | |
| "sessionID": "ses_4b8933352ffe2k7Q7VhaAWbJcB", | |
| "messageID": "msg_b47838e2b0018W2rC55faXTHO1", | |
| "type": "step-finish", | |
| "reason": "tool-calls", | |
| "cost": 0, | |
| "tokens": { | |
| "input": 1, | |
| "output": 1079, | |
| "reasoning": 0, | |
| "cache": { | |
| "read": 42035, | |
| "write": 974 | |
| } | |
| } | |
| } | |
| ] | |
| }, | |
| { | |
| "info": { | |
| "id": "msg_b4783cb3f001VIVAMzvB7HVIog", | |
| "sessionID": "ses_4b8933352ffe2k7Q7VhaAWbJcB", | |
| "role": "assistant", | |
| "time": { | |
| "created": 1766431378239, | |
| "completed": 1766431392347 | |
| }, | |
| "parentID": "msg_b4782c46a001rP2W0KPoAqISMd", | |
| "modelID": "claude-opus-4-5", | |
| "providerID": "anthropic", | |
| "mode": "build", | |
| "agent": "build", | |
| "path": { | |
| "cwd": "/Users/themishkun/projects/tinkering/opencode-stats", | |
| "root": "/" | |
| }, | |
| "cost": 0, | |
| "tokens": { | |
| "input": 1, | |
| "output": 823, | |
| "reasoning": 0, | |
| "cache": { | |
| "read": 43009, | |
| "write": 1105 | |
| } | |
| }, | |
| "finish": "tool-calls" | |
| }, | |
| "parts": [ | |
| { | |
| "id": "prt_b4783d69c001yFbrUtUACx9NhC", | |
| "sessionID": "ses_4b8933352ffe2k7Q7VhaAWbJcB", | |
| "messageID": "msg_b4783cb3f001VIVAMzvB7HVIog", | |
| "type": "step-start" | |
| }, | |
| { | |
| "id": "prt_b4783d6a7001Q6yRQqMEWjP1BV", | |
| "sessionID": "ses_4b8933352ffe2k7Q7VhaAWbJcB", | |
| "messageID": "msg_b4783cb3f001VIVAMzvB7HVIog", | |
| "type": "tool", | |
| "callID": "toolu_01Mg7kpTTzGN2eRVDb8s87FK", | |
| "tool": "edit", | |
| "state": { | |
| "status": "completed", | |
| "input": { | |
| "filePath": "/Users/themishkun/projects/tinkering/opencode-stats/ARCHITECTURE.md", | |
| "oldString": "## Open Questions for Implementation\n\n1. **Session Data Access:**\n - How does OpenCode expose session list to plugins?\n - Is there a direct API or do we need to use events?\n - What's the schema of session/message data?\n\n2. **Rendering:**\n - Can plugins render full-screen TUI views?\n - How do we handle keyboard input (tab to switch views)?\n - Is there a blessed/ink integration or raw terminal output?\n\n3. **Token Counting:**\n - Is token count available per message?\n - If not, how do we estimate it?\n\n4. **Plugin Lifecycle:**\n - When is the plugin loaded/unloaded?\n - Can we persist cache between sessions?", | |
| "newString": "## Resolved Questions\n\nBased on the actual OpenCode plugin API (`@opencode-ai/plugin`):\n\n### 1. Session Data Access - RESOLVED\n\n**How does OpenCode expose session list to plugins?**\n- Via the SDK client: `input.client.session.list()` and `input.client.session.messages(sessionId)`\n\n**Schema of session/message data:**\n- Sessions have: `id`, `title`, `createdAt`, `updatedAt`\n- Messages have: `id`, `sessionID`, `role`, `createdAt`, `info` (with model, tokens, cost)\n- Parts have: `id`, `type`, `content`\n\n### 2. Rendering - RESOLVED\n\n**Can plugins render output?**\n- Yes, via custom tools. The `execute` function returns `{ title, output, metadata }`\n- The `output` string is displayed to the user\n- For tab switching, we'd need to implement as separate tool calls or use the experimental hooks\n\n**Keyboard input:**\n- Not directly available in tool output\n- Alternative: Use multiple tool parameters (e.g., `/stats view=models`)\n\n### 3. Token Counting - RESOLVED\n\n**Is token count available per message?**\n- Yes! In `message.info.tokens`:\n - `input`: Input tokens\n - `output`: Output tokens\n - `reasoning`: Reasoning tokens (if applicable)\n - `cache.read` / `cache.write`: Cache tokens\n- Also `message.info.cost` for cost tracking\n\n### 4. Plugin Lifecycle - RESOLVED\n\n**When is the plugin loaded?**\n- Plugin function is called once when OpenCode starts\n- Returns hooks that are registered for the session lifetime\n\n**Can we persist cache?**\n- Yes, plugins can maintain in-memory state\n- For persistent storage, use file system via the Bun shell (`input.$`)\n\n### 5. Available Hooks Summary\n\n| Hook | Purpose | Use in Stats Plugin |\n|------|---------|---------------------|\n| `tool` | Define custom tools | `/stats` command |\n| `event` | Listen to events | Cache invalidation |\n| `chat.message` | Intercept messages | Could track in real-time |\n| `tool.execute.after` | Modify tool output | Could enhance other tool outputs with stats |\n| `experimental.session.compacting` | Add context | Could inject usage summary |" | |
| }, | |
| "output": "", | |
| "title": "Users/themishkun/projects/tinkering/opencode-stats/ARCHITECTURE.md", | |
| "metadata": { | |
| "diagnostics": {}, | |
| "diff": "Index: /Users/themishkun/projects/tinkering/opencode-stats/ARCHITECTURE.md\n===================================================================\n--- /Users/themishkun/projects/tinkering/opencode-stats/ARCHITECTURE.md\n+++ /Users/themishkun/projects/tinkering/opencode-stats/ARCHITECTURE.md\n@@ -1041,23 +1041,58 @@\n ```\n \n ---\n \n-## Open Questions for Implementation\n+## Resolved Questions\n \n-1. **Session Data Access:**\n- - How does OpenCode expose session list to plugins?\n- - Is there a direct API or do we need to use events?\n- - What's the schema of session/message data?\n+Based on the actual OpenCode plugin API (`@opencode-ai/plugin`):\n \n-2. **Rendering:**\n- - Can plugins render full-screen TUI views?\n- - How do we handle keyboard input (tab to switch views)?\n- - Is there a blessed/ink integration or raw terminal output?\n+### 1. Session Data Access - RESOLVED\n \n-3. **Token Counting:**\n- - Is token count available per message?\n- - If not, how do we estimate it?\n+**How does OpenCode expose session list to plugins?**\n+- Via the SDK client: `input.client.session.list()` and `input.client.session.messages(sessionId)`\n \n-4. **Plugin Lifecycle:**\n- - When is the plugin loaded/unloaded?\n- - Can we persist cache between sessions?\n+**Schema of session/message data:**\n+- Sessions have: `id`, `title`, `createdAt`, `updatedAt`\n+- Messages have: `id`, `sessionID`, `role`, `createdAt`, `info` (with model, tokens, cost)\n+- Parts have: `id`, `type`, `content`\n+\n+### 2. Rendering - RESOLVED\n+\n+**Can plugins render output?**\n+- Yes, via custom tools. The `execute` function returns `{ title, output, metadata }`\n+- The `output` string is displayed to the user\n+- For tab switching, we'd need to implement as separate tool calls or use the experimental hooks\n+\n+**Keyboard input:**\n+- Not directly available in tool output\n+- Alternative: Use multiple tool parameters (e.g., `/stats view=models`)\n+\n+### 3. Token Counting - RESOLVED\n+\n+**Is token count available per message?**\n+- Yes! In `message.info.tokens`:\n+ - `input`: Input tokens\n+ - `output`: Output tokens\n+ - `reasoning`: Reasoning tokens (if applicable)\n+ - `cache.read` / `cache.write`: Cache tokens\n+- Also `message.info.cost` for cost tracking\n+\n+### 4. Plugin Lifecycle - RESOLVED\n+\n+**When is the plugin loaded?**\n+- Plugin function is called once when OpenCode starts\n+- Returns hooks that are registered for the session lifetime\n+\n+**Can we persist cache?**\n+- Yes, plugins can maintain in-memory state\n+- For persistent storage, use file system via the Bun shell (`input.$`)\n+\n+### 5. Available Hooks Summary\n+\n+| Hook | Purpose | Use in Stats Plugin |\n+|------|---------|---------------------|\n+| `tool` | Define custom tools | `/stats` command |\n+| `event` | Listen to events | Cache invalidation |\n+| `chat.message` | Intercept messages | Could track in real-time |\n+| `tool.execute.after` | Modify tool output | Could enhance other tool outputs with stats |\n+| `experimental.session.compacting` | Add context | Could inject usage summary |\n", | |
| "filediff": { | |
| "file": "/Users/themishkun/projects/tinkering/opencode-stats/ARCHITECTURE.md", | |
| "before": "# Architecture Document: OpenCode Stats Plugin\n\n## Overview\n\nThis document describes the technical architecture of the `opencode-stats` plugin, a \"Spotify Wrapped\"-style statistics visualization tool for OpenCode.\n\n---\n\n## Plugin Architecture\n\n### OpenCode Plugin System\n\nOpenCode plugins are JavaScript/TypeScript modules that run in the Bun runtime. They follow an async function pattern that receives a `PluginInput` and returns `Hooks`.\n\n#### Plugin Input (What plugins receive)\n\n```typescript\n// From @opencode-ai/plugin\nexport type PluginInput = {\n client: ReturnType<typeof createOpencodeClient> // SDK client for API access\n project: Project // Current project info\n directory: string // Project directory\n worktree: string // Git worktree path\n $: BunShell // Bun shell for running commands\n}\n\nexport type Plugin = (input: PluginInput) => Promise<Hooks>\n```\n\n#### Available Hooks\n\n```typescript\nexport interface Hooks {\n // Listen to OpenCode events (session created, message created, etc.)\n event?: (input: { event: Event }) => Promise<void>\n \n // Modify OpenCode configuration\n config?: (input: Config) => Promise<void>\n \n // Define custom tools (slash commands)\n tool?: {\n [key: string]: ToolDefinition\n }\n \n // Custom authentication providers\n auth?: AuthHook\n \n // Called when a new message is received\n \"chat.message\"?: (\n input: { sessionID: string; agent?: string; model?: { providerID: string; modelID: string }; messageID?: string },\n output: { message: UserMessage; parts: Part[] },\n ) => Promise<void>\n \n // Modify parameters sent to LLM\n \"chat.params\"?: (\n input: { sessionID: string; agent: string; model: Model; provider: ProviderContext; message: UserMessage },\n output: { temperature: number; topP: number; topK: number; options: Record<string, any> },\n ) => Promise<void>\n \n // Intercept permission requests\n \"permission.ask\"?: (input: Permission, output: { status: \"ask\" | \"deny\" | \"allow\" }) => Promise<void>\n \n // Before tool execution - can modify args\n \"tool.execute.before\"?: (\n input: { tool: string; sessionID: string; callID: string },\n output: { args: any },\n ) => Promise<void>\n \n // After tool execution - can modify output\n \"tool.execute.after\"?: (\n input: { tool: string; sessionID: string; callID: string },\n output: { title: string; output: string; metadata: any },\n ) => Promise<void>\n \n // Transform chat messages (experimental)\n \"experimental.chat.messages.transform\"?: (\n input: {},\n output: { messages: { info: Message; parts: Part[] }[] },\n ) => Promise<void>\n \n // Transform system prompt (experimental)\n \"experimental.chat.system.transform\"?: (\n input: {},\n output: { system: string[] },\n ) => Promise<void>\n \n // Add context during session compaction (experimental)\n \"experimental.session.compacting\"?: (\n input: { sessionID: string },\n output: { context: string[] },\n ) => Promise<void>\n \n // Transform completed text (experimental)\n \"experimental.text.complete\"?: (\n input: { sessionID: string; messageID: string; partID: string },\n output: { text: string },\n ) => Promise<void>\n}\n```\n\n### Plugin Location\n\n```\n.opencode/\n└── plugin/\n └── opencode-stats/\n ├── index.ts # Main plugin entry\n ├── package.json # Dependencies\n └── src/\n ├── stats/ # Statistics computation\n ├── render/ # TUI rendering\n └── data/ # Data access layer\n```\n\n---\n\n## System Architecture\n\n```\n┌─────────────────────────────────────────────────────────────────┐\n│ OpenCode Host │\n├─────────────────────────────────────────────────────────────────┤\n│ │\n│ ┌─────────────────────────────────────────────────────────┐ │\n│ │ opencode-stats Plugin │ │\n│ ├─────────────────────────────────────────────────────────┤ │\n│ │ │ │\n│ │ ┌─────────────┐ ┌─────────────┐ ┌─────────────────┐ │ │\n│ │ │ Command │ │ Stats │ │ Renderer │ │ │\n│ │ │ Handler │──│ Engine │──│ (TUI) │ │ │\n│ │ └─────────────┘ └─────────────┘ └─────────────────┘ │ │\n│ │ │ │ │ │ │\n│ │ ▼ ▼ ▼ │ │\n│ │ ┌─────────────┐ ┌─────────────┐ ┌─────────────────┐ │ │\n│ │ │ Slash │ │ Data │ │ Components │ │ │\n│ │ │ Command │ │ Layer │ │ Library │ │ │\n│ │ └─────────────┘ └─────────────┘ └─────────────────┘ │ │\n│ │ │ │ │\n│ └──────────────────────────│─────────────────────────────┘ │\n│ │ │\n│ ▼ │\n│ ┌─────────────────────────────────────────────────────────┐ │\n│ │ OpenCode Session Storage │ │\n│ │ (SQLite / JSON) │ │\n│ └─────────────────────────────────────────────────────────┘ │\n│ │\n└─────────────────────────────────────────────────────────────────┘\n```\n\n---\n\n## Component Design\n\n### 1. Plugin Entry Point (`index.ts`)\n\n```typescript\nimport type { Plugin, Hooks, ToolDefinition } from \"@opencode-ai/plugin\";\nimport { z } from \"zod\";\nimport { StatsEngine } from \"./src/stats/engine\";\nimport { SessionDataProvider } from \"./src/data/sessions\";\nimport { StatsRenderer } from \"./src/render\";\n\nconst plugin: Plugin = async (input) => {\n const { client, project, directory } = input;\n \n // Initialize data provider with SDK client\n const dataProvider = new SessionDataProvider(client);\n const statsEngine = new StatsEngine(dataProvider);\n\n const hooks: Hooks = {\n // Register the /stats custom tool (slash command)\n tool: {\n stats: {\n description: \"View your OpenCode usage statistics (Wrapped-style)\",\n parameters: z.object({\n period: z.enum([\"week\", \"month\", \"year\", \"all\"]).optional().default(\"month\"),\n view: z.enum([\"overview\", \"models\"]).optional().default(\"overview\"),\n }),\n async execute(args) {\n const { period, view } = args;\n \n try {\n const stats = await statsEngine.computeStats({ period });\n \n const renderer = new StatsRenderer({\n width: process.stdout.columns || 80,\n height: process.stdout.rows || 24,\n colors: process.stdout.isTTY ?? false,\n });\n\n const output = renderer.render(stats, view);\n \n return {\n title: \"OpenCode Stats\",\n output,\n metadata: {\n totalSessions: stats.summary.totalSessions,\n period: stats.period,\n },\n };\n } catch (error) {\n return {\n title: \"OpenCode Stats Error\",\n output: `Error computing stats: ${error.message}`,\n metadata: { error: true },\n };\n }\n },\n },\n },\n\n // Listen to events for real-time stats updates (optional)\n async event({ event }) {\n // Could invalidate cache when new sessions/messages are created\n if (event.type === \"session.created\" || event.type === \"message.created\") {\n statsEngine.invalidateCache();\n }\n },\n };\n\n return hooks;\n};\n\nexport default plugin;\n```\n\n### 2. Data Layer (`src/data/`)\n\n#### Session Data Provider\n\nResponsible for accessing OpenCode's session storage via the SDK client.\n\n```typescript\n// src/data/sessions.ts\n\nimport type { createOpencodeClient } from \"@opencode-ai/sdk\";\n\n// Types based on OpenCode SDK\nexport interface Session {\n id: string;\n title?: string;\n createdAt: string;\n updatedAt: string;\n}\n\nexport interface Message {\n id: string;\n sessionID: string;\n role: \"user\" | \"assistant\" | \"system\";\n createdAt: string;\n info: {\n model?: {\n providerID: string;\n modelID: string;\n };\n tokens?: {\n input: number;\n output: number;\n reasoning?: number;\n cache?: {\n read: number;\n write: number;\n };\n };\n cost?: number;\n };\n}\n\nexport interface Part {\n id: string;\n type: \"text\" | \"tool-invocation\" | \"tool-result\" | \"file\" | \"step-start\";\n content?: string;\n}\n\ntype Client = ReturnType<typeof createOpencodeClient>;\n\nexport class SessionDataProvider {\n constructor(private client: Client) {}\n\n async getSessions(options?: {\n from?: Date;\n to?: Date;\n limit?: number;\n }): Promise<Session[]> {\n // Use the SDK client to fetch sessions\n const sessions = await this.client.session.list();\n \n // Filter by date if specified\n let filtered = sessions;\n if (options?.from) {\n filtered = filtered.filter(s => new Date(s.createdAt) >= options.from!);\n }\n if (options?.to) {\n filtered = filtered.filter(s => new Date(s.createdAt) <= options.to!);\n }\n if (options?.limit) {\n filtered = filtered.slice(0, options.limit);\n }\n \n return filtered;\n }\n\n async getSessionMessages(sessionId: string): Promise<{ info: Message; parts: Part[] }[]> {\n // Fetch all messages for a session\n return await this.client.session.messages(sessionId);\n }\n\n async getAllSessionsWithMessages(options?: {\n from?: Date;\n to?: Date;\n }): Promise<Array<{ session: Session; messages: { info: Message; parts: Part[] }[] }>> {\n const sessions = await this.getSessions(options);\n \n // Fetch messages for each session in parallel\n const results = await Promise.all(\n sessions.map(async (session) => ({\n session,\n messages: await this.getSessionMessages(session.id),\n }))\n );\n \n return results;\n }\n}\n```\n\n#### Data Models\n\n```typescript\n// src/data/models.ts\n\nexport interface SessionSummary {\n id: string;\n startTime: Date;\n endTime: Date;\n messageCount: number;\n totalTokens: number;\n models: string[];\n}\n\nexport interface DailyActivity {\n date: string; // YYYY-MM-DD\n sessionCount: number;\n totalTokens: number;\n totalDuration: number; // minutes\n}\n\nexport interface ModelUsage {\n model: string;\n sessionCount: number;\n messageCount: number;\n totalTokens: number;\n percentage: number;\n}\n```\n\n### 3. Statistics Engine (`src/stats/`)\n\n#### Core Engine\n\n```typescript\n// src/stats/engine.ts\n\nexport interface StatsResult {\n period: {\n start: Date;\n end: Date;\n days: number;\n };\n summary: {\n totalSessions: number;\n totalTokens: number;\n totalMessages: number;\n activeDays: number;\n currentStreak: number;\n longestStreak: number;\n longestSession: {\n id: string;\n duration: number; // minutes\n };\n peakHour: number; // 0-23\n favoriteModel: string;\n };\n dailyActivity: DailyActivity[];\n modelUsage: ModelUsage[];\n funFact: string;\n}\n\nexport class StatsEngine {\n constructor(private dataProvider: SessionDataProvider) {}\n\n async computeStats(options: {\n period: \"week\" | \"month\" | \"year\" | \"all\";\n }): Promise<StatsResult> {\n const sessions = await this.dataProvider.getSessions({\n from: this.getPeriodStart(options.period),\n });\n\n return {\n period: this.computePeriod(sessions, options.period),\n summary: this.computeSummary(sessions),\n dailyActivity: this.computeDailyActivity(sessions),\n modelUsage: this.computeModelUsage(sessions),\n funFact: this.generateFunFact(sessions),\n };\n }\n\n private computeSummary(sessions: Session[]): StatsResult[\"summary\"] {\n // Compute all summary statistics\n }\n\n private computeDailyActivity(sessions: Session[]): DailyActivity[] {\n // Aggregate sessions by day\n }\n\n private computeModelUsage(sessions: Session[]): ModelUsage[] {\n // Aggregate by model\n }\n\n private generateFunFact(sessions: Session[]): string {\n // Pick a fun comparison\n }\n}\n```\n\n#### Streak Calculator\n\n```typescript\n// src/stats/streaks.ts\n\nexport interface StreakResult {\n current: number;\n longest: number;\n currentStart?: Date;\n longestStart?: Date;\n longestEnd?: Date;\n}\n\nexport function calculateStreaks(dailyActivity: DailyActivity[]): StreakResult {\n // Sort by date\n const sorted = [...dailyActivity].sort(\n (a, b) => new Date(a.date).getTime() - new Date(b.date).getTime()\n );\n\n let current = 0;\n let longest = 0;\n let streak = 0;\n let prevDate: Date | null = null;\n\n for (const day of sorted) {\n const date = new Date(day.date);\n if (prevDate && isConsecutiveDay(prevDate, date)) {\n streak++;\n } else {\n streak = 1;\n }\n\n if (streak > longest) longest = streak;\n prevDate = date;\n }\n\n // Check if streak continues to today\n const today = new Date();\n today.setHours(0, 0, 0, 0);\n \n if (prevDate && isConsecutiveDay(prevDate, today)) {\n current = streak;\n } else if (prevDate?.getTime() === today.getTime()) {\n current = streak;\n }\n\n return { current, longest };\n}\n\nfunction isConsecutiveDay(a: Date, b: Date): boolean {\n const diff = b.getTime() - a.getTime();\n return diff === 24 * 60 * 60 * 1000;\n}\n```\n\n#### Fun Facts Generator\n\n```typescript\n// src/stats/funfacts.ts\n\ninterface FunFactTemplate {\n condition: (stats: StatsResult) => boolean;\n generate: (stats: StatsResult) => string;\n}\n\nconst FUN_FACTS: FunFactTemplate[] = [\n {\n condition: (s) => s.summary.longestSession.duration > 148, // Inception length\n generate: (s) => {\n const times = Math.round(s.summary.longestSession.duration / 148);\n return `Your longest session is ~${times}x longer than the movie Inception`;\n },\n },\n {\n condition: (s) => s.summary.totalTokens > 587287, // War and Peace word count\n generate: (s) => {\n const times = Math.round(s.summary.totalTokens / 587287);\n return `You've used ${times}x more tokens than words in War and Peace`;\n },\n },\n {\n condition: (s) => s.summary.currentStreak >= 7,\n generate: (s) => \n `Your ${s.summary.currentStreak}-day streak is longer than most New Year resolutions`,\n },\n {\n condition: (s) => s.summary.peakHour >= 22 || s.summary.peakHour <= 4,\n generate: () => `You're a night owl coder - peak activity is after dark`,\n },\n {\n condition: (s) => s.summary.peakHour >= 5 && s.summary.peakHour <= 8,\n generate: () => `Early bird catches the bugs - you code best at dawn`,\n },\n // More fun facts...\n];\n\nexport function generateFunFact(stats: StatsResult): string {\n const applicable = FUN_FACTS.filter((f) => f.condition(stats));\n if (applicable.length === 0) {\n return `You've had ${stats.summary.totalSessions} coding sessions - keep going!`;\n }\n const random = applicable[Math.floor(Math.random() * applicable.length)];\n return random.generate(stats);\n}\n```\n\n### 4. Renderer (`src/render/`)\n\n#### Renderer Interface\n\n```typescript\n// src/render/types.ts\n\nexport interface RenderContext {\n width: number;\n height: number;\n colors: boolean;\n}\n\nexport interface Renderer {\n render(stats: StatsResult, view: \"overview\" | \"models\"): string;\n}\n```\n\n#### Heatmap Component\n\n```typescript\n// src/render/components/heatmap.ts\n\nconst INTENSITY_CHARS = [\" \", \"░\", \"▒\", \"▓\", \"█\"];\nconst DAYS = [\"\", \"Mon\", \"\", \"Wed\", \"\", \"Fri\", \"\"];\nconst MONTHS = [\"Jan\", \"Feb\", \"Mar\", \"Apr\", \"May\", \"Jun\", \n \"Jul\", \"Aug\", \"Sep\", \"Oct\", \"Nov\", \"Dec\"];\n\nexport function renderHeatmap(\n dailyActivity: DailyActivity[],\n options: { weeks: number; colors: boolean }\n): string[] {\n const lines: string[] = [];\n \n // Build activity map\n const activityMap = new Map<string, number>();\n dailyActivity.forEach((d) => {\n activityMap.set(d.date, d.sessionCount);\n });\n\n // Calculate intensity thresholds\n const maxActivity = Math.max(...dailyActivity.map((d) => d.sessionCount), 1);\n const getIntensity = (count: number): number => {\n if (count === 0) return 0;\n return Math.min(4, Math.ceil((count / maxActivity) * 4));\n };\n\n // Generate header (months)\n const headerLine = \" \" + generateMonthHeader(options.weeks);\n lines.push(headerLine);\n\n // Generate each day row\n for (let dayOfWeek = 0; dayOfWeek < 7; dayOfWeek++) {\n let line = DAYS[dayOfWeek].padEnd(4);\n \n for (let week = 0; week < options.weeks; week++) {\n const date = getDateForWeekDay(week, dayOfWeek, options.weeks);\n const dateStr = formatDate(date);\n const count = activityMap.get(dateStr) || 0;\n const char = INTENSITY_CHARS[getIntensity(count)];\n line += char + \" \";\n }\n \n lines.push(line);\n }\n\n // Legend\n lines.push(\"\");\n lines.push(\" Less \" + INTENSITY_CHARS.slice(1).join(\" \") + \" More\");\n\n return lines;\n}\n```\n\n#### Stats Dashboard Component\n\n```typescript\n// src/render/components/dashboard.ts\n\nexport function renderDashboard(summary: StatsResult[\"summary\"]): string[] {\n const lines: string[] = [];\n \n const formatDuration = (minutes: number): string => {\n const days = Math.floor(minutes / 1440);\n const hours = Math.floor((minutes % 1440) / 60);\n const mins = minutes % 60;\n \n const parts = [];\n if (days > 0) parts.push(`${days}d`);\n if (hours > 0) parts.push(`${hours}h`);\n if (mins > 0) parts.push(`${mins}m`);\n return parts.join(\" \") || \"0m\";\n };\n\n const formatNumber = (n: number): string => {\n if (n >= 1000000) return `${(n / 1000000).toFixed(1)}m`;\n if (n >= 1000) return `${(n / 1000).toFixed(1)}k`;\n return n.toString();\n };\n\n const leftCol = [\n `Favorite model: ${summary.favoriteModel}`,\n \"\",\n `Sessions: ${summary.totalSessions}`,\n `Current streak: ${summary.currentStreak} days`,\n `Active days: ${summary.activeDays}`,\n ];\n\n const rightCol = [\n `Total tokens: ${formatNumber(summary.totalTokens)}`,\n \"\",\n `Longest session: ${formatDuration(summary.longestSession.duration)}`,\n `Longest streak: ${summary.longestStreak} days`,\n `Peak hour: ${summary.peakHour}:00-${summary.peakHour + 1}:00`,\n ];\n\n // Combine columns\n const maxLeftWidth = Math.max(...leftCol.map((l) => l.length));\n const padding = 4;\n\n for (let i = 0; i < leftCol.length; i++) {\n lines.push(\n leftCol[i].padEnd(maxLeftWidth + padding) + rightCol[i]\n );\n }\n\n return lines;\n}\n```\n\n#### Model Usage Bar Chart\n\n```typescript\n// src/render/components/models.ts\n\nexport function renderModelUsage(\n modelUsage: ModelUsage[],\n options: { width: number }\n): string[] {\n const lines: string[] = [];\n const barWidth = options.width - 40; // Space for label and percentage\n\n const sorted = [...modelUsage].sort((a, b) => b.percentage - a.percentage);\n\n for (const model of sorted.slice(0, 5)) {\n const filled = Math.round((model.percentage / 100) * barWidth);\n const empty = barWidth - filled;\n const bar = \"█\".repeat(filled) + \"░\".repeat(empty);\n const label = model.model.padEnd(28);\n const pct = `${Math.round(model.percentage)}%`.padStart(4);\n \n lines.push(` ${label} ${bar} ${pct}`);\n }\n\n return lines;\n}\n```\n\n#### Main Renderer\n\n```typescript\n// src/render/index.ts\n\nimport { renderHeatmap } from \"./components/heatmap\";\nimport { renderDashboard } from \"./components/dashboard\";\nimport { renderModelUsage } from \"./components/models\";\n\nexport class StatsRenderer implements Renderer {\n constructor(private context: RenderContext) {}\n\n render(stats: StatsResult, view: \"overview\" | \"models\"): string {\n const lines: string[] = [];\n \n // Header\n lines.push(\"\");\n const tabs = view === \"overview\" \n ? \" [Overview] Models (tab to cycle)\"\n : \" Overview [Models] (tab to cycle)\";\n lines.push(tabs);\n lines.push(\"\");\n\n if (view === \"overview\") {\n // Heatmap\n const heatmap = renderHeatmap(stats.dailyActivity, {\n weeks: 52,\n colors: this.context.colors,\n });\n lines.push(...heatmap);\n lines.push(\"\");\n\n // Dashboard stats\n const dashboard = renderDashboard(stats.summary);\n lines.push(...dashboard);\n lines.push(\"\");\n\n // Fun fact\n lines.push(` ${stats.funFact}`);\n lines.push(` Stats from the last ${stats.period.days} days`);\n } else {\n // Model breakdown\n const models = renderModelUsage(stats.modelUsage, {\n width: this.context.width,\n });\n lines.push(...models);\n }\n\n lines.push(\"\");\n return lines.join(\"\\n\");\n }\n}\n```\n\n### 5. Command Handler (`src/commands/`)\n\n```typescript\n// src/commands/stats.ts\n\nimport { z } from \"zod\";\nimport type { ToolExecuteParams } from \"opencode\";\nimport { StatsEngine } from \"../stats/engine\";\nimport { StatsRenderer } from \"../render\";\n\nexport class StatsCommand {\n constructor(private engine: StatsEngine) {}\n\n async execute(params: ToolExecuteParams<{\n period?: \"week\" | \"month\" | \"year\" | \"all\";\n view?: \"overview\" | \"models\";\n }>) {\n const { period = \"month\", view = \"overview\" } = params.input;\n\n try {\n const stats = await this.engine.computeStats({ period });\n \n const renderer = new StatsRenderer({\n width: process.stdout.columns || 80,\n height: process.stdout.rows || 24,\n colors: process.stdout.isTTY ?? false,\n });\n\n const output = renderer.render(stats, view);\n \n return {\n content: output,\n metadata: {\n totalSessions: stats.summary.totalSessions,\n period: stats.period,\n },\n };\n } catch (error) {\n return {\n content: `Error computing stats: ${error.message}`,\n isError: true,\n };\n }\n }\n}\n```\n\n---\n\n## Data Flow\n\n```\n┌──────────────────────────────────────────────────────────────────┐\n│ User invokes /stats │\n└──────────────────────────────────────────────────────────────────┘\n │\n ▼\n┌──────────────────────────────────────────────────────────────────┐\n│ StatsCommand.execute() │\n│ - Parse parameters (period, view) │\n│ - Validate inputs │\n└──────────────────────────────────────────────────────────────────┘\n │\n ▼\n┌──────────────────────────────────────────────────────────────────┐\n│ StatsEngine.computeStats() │\n│ - Fetch session data from provider │\n│ - Compute summary statistics │\n│ - Calculate streaks │\n│ - Aggregate daily activity │\n│ - Compute model usage │\n│ - Generate fun fact │\n└──────────────────────────────────────────────────────────────────┘\n │\n ▼\n┌──────────────────────────────────────────────────────────────────┐\n│ SessionDataProvider.getSessions() │\n│ - Access OpenCode session storage │\n│ - Filter by date range │\n│ - Return session summaries │\n└──────────────────────────────────────────────────────────────────┘\n │\n ▼\n┌──────────────────────────────────────────────────────────────────┐\n│ StatsRenderer.render() │\n│ - Select view (overview/models) │\n│ - Compose components │\n│ - Generate ASCII output │\n└──────────────────────────────────────────────────────────────────┘\n │\n ▼\n┌──────────────────────────────────────────────────────────────────┐\n│ Display output to user │\n└──────────────────────────────────────────────────────────────────┘\n```\n\n---\n\n## File Structure\n\n```\nopencode-stats/\n├── index.ts # Plugin entry point\n├── package.json # Dependencies and metadata\n├── tsconfig.json # TypeScript configuration\n├── README.md # Plugin documentation\n│\n├── src/\n│ ├── commands/\n│ │ └── stats.ts # Slash command handler\n│ │\n│ ├── data/\n│ │ ├── sessions.ts # Session data provider\n│ │ └── models.ts # Data models/interfaces\n│ │\n│ ├── stats/\n│ │ ├── engine.ts # Main statistics engine\n│ │ ├── streaks.ts # Streak calculation\n│ │ ├── funfacts.ts # Fun fact generator\n│ │ └── aggregators.ts # Data aggregation utilities\n│ │\n│ └── render/\n│ ├── index.ts # Main renderer\n│ ├── types.ts # Render interfaces\n│ └── components/\n│ ├── heatmap.ts # Activity heatmap\n│ ├── dashboard.ts # Stats dashboard\n│ ├── models.ts # Model usage chart\n│ └── box.ts # Box drawing utilities\n│\n└── tests/\n ├── stats/\n │ ├── engine.test.ts\n │ └── streaks.test.ts\n └── render/\n └── components.test.ts\n```\n\n---\n\n## Dependencies\n\n```json\n{\n \"name\": \"opencode-stats\",\n \"version\": \"1.0.0\",\n \"type\": \"module\",\n \"main\": \"index.ts\",\n \"dependencies\": {\n \"zod\": \"^3.22.0\"\n },\n \"devDependencies\": {\n \"@types/bun\": \"latest\",\n \"typescript\": \"^5.0.0\"\n },\n \"peerDependencies\": {\n \"opencode\": \">=0.1.0\"\n }\n}\n```\n\n---\n\n## Configuration\n\n### Plugin Configuration (`opencode.json`)\n\n```json\n{\n \"plugins\": {\n \"opencode-stats\": {\n \"enabled\": true,\n \"options\": {\n \"defaultPeriod\": \"month\",\n \"cacheEnabled\": true,\n \"cacheTTL\": 300\n }\n }\n }\n}\n```\n\n### Environment Variables\n\n| Variable | Description | Default |\n|----------|-------------|---------|\n| `OPENCODE_STATS_CACHE` | Enable caching | `true` |\n| `OPENCODE_STATS_CACHE_TTL` | Cache TTL in seconds | `300` |\n\n---\n\n## Testing Strategy\n\n### Unit Tests\n\n- Statistics calculations (streaks, aggregations)\n- Render component output\n- Fun fact generation\n\n### Integration Tests\n\n- Full stats computation with mock data\n- Command execution flow\n\n### Manual Testing\n\n- Various terminal sizes\n- Color/no-color modes\n- Large session histories\n\n---\n\n## Performance Considerations\n\n### Caching Strategy\n\n```typescript\ninterface CacheEntry {\n stats: StatsResult;\n computedAt: Date;\n sessionCount: number;\n}\n\nclass StatsCache {\n private cache: Map<string, CacheEntry> = new Map();\n private ttl: number;\n\n constructor(ttlSeconds: number = 300) {\n this.ttl = ttlSeconds * 1000;\n }\n\n get(period: string): StatsResult | null {\n const entry = this.cache.get(period);\n if (!entry) return null;\n \n const age = Date.now() - entry.computedAt.getTime();\n if (age > this.ttl) {\n this.cache.delete(period);\n return null;\n }\n \n return entry.stats;\n }\n\n set(period: string, stats: StatsResult, sessionCount: number): void {\n this.cache.set(period, {\n stats,\n computedAt: new Date(),\n sessionCount,\n });\n }\n\n invalidate(): void {\n this.cache.clear();\n }\n}\n```\n\n### Lazy Loading\n\n- Load only session summaries for initial stats\n- Fetch full session data only when needed (e.g., longest session details)\n\n---\n\n## Security Considerations\n\n1. **Read-only access:** Plugin only reads session data, never writes\n2. **Local processing:** All computation happens locally\n3. **No network calls:** No telemetry or external API calls\n4. **Sandboxed execution:** Runs within OpenCode's plugin sandbox\n\n---\n\n## Future Extensibility\n\n### Planned Extensions\n\n1. **Export API:** Allow other plugins to access stats\n2. **Webhook integration:** Post stats to external services\n3. **Custom metrics:** User-defined stat tracking\n4. **Themes:** Customizable color schemes\n\n### Extension Points\n\n```typescript\n// Future: Plugin extension API\ninterface StatsExtension {\n // Add custom metrics\n metrics?: CustomMetric[];\n \n // Add custom fun facts\n funFacts?: FunFactTemplate[];\n \n // Add custom views\n views?: CustomView[];\n}\n```\n\n---\n\n## Open Questions for Implementation\n\n1. **Session Data Access:**\n - How does OpenCode expose session list to plugins?\n - Is there a direct API or do we need to use events?\n - What's the schema of session/message data?\n\n2. **Rendering:**\n - Can plugins render full-screen TUI views?\n - How do we handle keyboard input (tab to switch views)?\n - Is there a blessed/ink integration or raw terminal output?\n\n3. **Token Counting:**\n - Is token count available per message?\n - If not, how do we estimate it?\n\n4. **Plugin Lifecycle:**\n - When is the plugin loaded/unloaded?\n - Can we persist cache between sessions?\n", | |
| "after": "# Architecture Document: OpenCode Stats Plugin\n\n## Overview\n\nThis document describes the technical architecture of the `opencode-stats` plugin, a \"Spotify Wrapped\"-style statistics visualization tool for OpenCode.\n\n---\n\n## Plugin Architecture\n\n### OpenCode Plugin System\n\nOpenCode plugins are JavaScript/TypeScript modules that run in the Bun runtime. They follow an async function pattern that receives a `PluginInput` and returns `Hooks`.\n\n#### Plugin Input (What plugins receive)\n\n```typescript\n// From @opencode-ai/plugin\nexport type PluginInput = {\n client: ReturnType<typeof createOpencodeClient> // SDK client for API access\n project: Project // Current project info\n directory: string // Project directory\n worktree: string // Git worktree path\n $: BunShell // Bun shell for running commands\n}\n\nexport type Plugin = (input: PluginInput) => Promise<Hooks>\n```\n\n#### Available Hooks\n\n```typescript\nexport interface Hooks {\n // Listen to OpenCode events (session created, message created, etc.)\n event?: (input: { event: Event }) => Promise<void>\n \n // Modify OpenCode configuration\n config?: (input: Config) => Promise<void>\n \n // Define custom tools (slash commands)\n tool?: {\n [key: string]: ToolDefinition\n }\n \n // Custom authentication providers\n auth?: AuthHook\n \n // Called when a new message is received\n \"chat.message\"?: (\n input: { sessionID: string; agent?: string; model?: { providerID: string; modelID: string }; messageID?: string },\n output: { message: UserMessage; parts: Part[] },\n ) => Promise<void>\n \n // Modify parameters sent to LLM\n \"chat.params\"?: (\n input: { sessionID: string; agent: string; model: Model; provider: ProviderContext; message: UserMessage },\n output: { temperature: number; topP: number; topK: number; options: Record<string, any> },\n ) => Promise<void>\n \n // Intercept permission requests\n \"permission.ask\"?: (input: Permission, output: { status: \"ask\" | \"deny\" | \"allow\" }) => Promise<void>\n \n // Before tool execution - can modify args\n \"tool.execute.before\"?: (\n input: { tool: string; sessionID: string; callID: string },\n output: { args: any },\n ) => Promise<void>\n \n // After tool execution - can modify output\n \"tool.execute.after\"?: (\n input: { tool: string; sessionID: string; callID: string },\n output: { title: string; output: string; metadata: any },\n ) => Promise<void>\n \n // Transform chat messages (experimental)\n \"experimental.chat.messages.transform\"?: (\n input: {},\n output: { messages: { info: Message; parts: Part[] }[] },\n ) => Promise<void>\n \n // Transform system prompt (experimental)\n \"experimental.chat.system.transform\"?: (\n input: {},\n output: { system: string[] },\n ) => Promise<void>\n \n // Add context during session compaction (experimental)\n \"experimental.session.compacting\"?: (\n input: { sessionID: string },\n output: { context: string[] },\n ) => Promise<void>\n \n // Transform completed text (experimental)\n \"experimental.text.complete\"?: (\n input: { sessionID: string; messageID: string; partID: string },\n output: { text: string },\n ) => Promise<void>\n}\n```\n\n### Plugin Location\n\n```\n.opencode/\n└── plugin/\n └── opencode-stats/\n ├── index.ts # Main plugin entry\n ├── package.json # Dependencies\n └── src/\n ├── stats/ # Statistics computation\n ├── render/ # TUI rendering\n └── data/ # Data access layer\n```\n\n---\n\n## System Architecture\n\n```\n┌─────────────────────────────────────────────────────────────────┐\n│ OpenCode Host │\n├─────────────────────────────────────────────────────────────────┤\n│ │\n│ ┌─────────────────────────────────────────────────────────┐ │\n│ │ opencode-stats Plugin │ │\n│ ├─────────────────────────────────────────────────────────┤ │\n│ │ │ │\n│ │ ┌─────────────┐ ┌─────────────┐ ┌─────────────────┐ │ │\n│ │ │ Command │ │ Stats │ │ Renderer │ │ │\n│ │ │ Handler │──│ Engine │──│ (TUI) │ │ │\n│ │ └─────────────┘ └─────────────┘ └─────────────────┘ │ │\n│ │ │ │ │ │ │\n│ │ ▼ ▼ ▼ │ │\n│ │ ┌─────────────┐ ┌─────────────┐ ┌─────────────────┐ │ │\n│ │ │ Slash │ │ Data │ │ Components │ │ │\n│ │ │ Command │ │ Layer │ │ Library │ │ │\n│ │ └─────────────┘ └─────────────┘ └─────────────────┘ │ │\n│ │ │ │ │\n│ └──────────────────────────│─────────────────────────────┘ │\n│ │ │\n│ ▼ │\n│ ┌─────────────────────────────────────────────────────────┐ │\n│ │ OpenCode Session Storage │ │\n│ │ (SQLite / JSON) │ │\n│ └─────────────────────────────────────────────────────────┘ │\n│ │\n└─────────────────────────────────────────────────────────────────┘\n```\n\n---\n\n## Component Design\n\n### 1. Plugin Entry Point (`index.ts`)\n\n```typescript\nimport type { Plugin, Hooks, ToolDefinition } from \"@opencode-ai/plugin\";\nimport { z } from \"zod\";\nimport { StatsEngine } from \"./src/stats/engine\";\nimport { SessionDataProvider } from \"./src/data/sessions\";\nimport { StatsRenderer } from \"./src/render\";\n\nconst plugin: Plugin = async (input) => {\n const { client, project, directory } = input;\n \n // Initialize data provider with SDK client\n const dataProvider = new SessionDataProvider(client);\n const statsEngine = new StatsEngine(dataProvider);\n\n const hooks: Hooks = {\n // Register the /stats custom tool (slash command)\n tool: {\n stats: {\n description: \"View your OpenCode usage statistics (Wrapped-style)\",\n parameters: z.object({\n period: z.enum([\"week\", \"month\", \"year\", \"all\"]).optional().default(\"month\"),\n view: z.enum([\"overview\", \"models\"]).optional().default(\"overview\"),\n }),\n async execute(args) {\n const { period, view } = args;\n \n try {\n const stats = await statsEngine.computeStats({ period });\n \n const renderer = new StatsRenderer({\n width: process.stdout.columns || 80,\n height: process.stdout.rows || 24,\n colors: process.stdout.isTTY ?? false,\n });\n\n const output = renderer.render(stats, view);\n \n return {\n title: \"OpenCode Stats\",\n output,\n metadata: {\n totalSessions: stats.summary.totalSessions,\n period: stats.period,\n },\n };\n } catch (error) {\n return {\n title: \"OpenCode Stats Error\",\n output: `Error computing stats: ${error.message}`,\n metadata: { error: true },\n };\n }\n },\n },\n },\n\n // Listen to events for real-time stats updates (optional)\n async event({ event }) {\n // Could invalidate cache when new sessions/messages are created\n if (event.type === \"session.created\" || event.type === \"message.created\") {\n statsEngine.invalidateCache();\n }\n },\n };\n\n return hooks;\n};\n\nexport default plugin;\n```\n\n### 2. Data Layer (`src/data/`)\n\n#### Session Data Provider\n\nResponsible for accessing OpenCode's session storage via the SDK client.\n\n```typescript\n// src/data/sessions.ts\n\nimport type { createOpencodeClient } from \"@opencode-ai/sdk\";\n\n// Types based on OpenCode SDK\nexport interface Session {\n id: string;\n title?: string;\n createdAt: string;\n updatedAt: string;\n}\n\nexport interface Message {\n id: string;\n sessionID: string;\n role: \"user\" | \"assistant\" | \"system\";\n createdAt: string;\n info: {\n model?: {\n providerID: string;\n modelID: string;\n };\n tokens?: {\n input: number;\n output: number;\n reasoning?: number;\n cache?: {\n read: number;\n write: number;\n };\n };\n cost?: number;\n };\n}\n\nexport interface Part {\n id: string;\n type: \"text\" | \"tool-invocation\" | \"tool-result\" | \"file\" | \"step-start\";\n content?: string;\n}\n\ntype Client = ReturnType<typeof createOpencodeClient>;\n\nexport class SessionDataProvider {\n constructor(private client: Client) {}\n\n async getSessions(options?: {\n from?: Date;\n to?: Date;\n limit?: number;\n }): Promise<Session[]> {\n // Use the SDK client to fetch sessions\n const sessions = await this.client.session.list();\n \n // Filter by date if specified\n let filtered = sessions;\n if (options?.from) {\n filtered = filtered.filter(s => new Date(s.createdAt) >= options.from!);\n }\n if (options?.to) {\n filtered = filtered.filter(s => new Date(s.createdAt) <= options.to!);\n }\n if (options?.limit) {\n filtered = filtered.slice(0, options.limit);\n }\n \n return filtered;\n }\n\n async getSessionMessages(sessionId: string): Promise<{ info: Message; parts: Part[] }[]> {\n // Fetch all messages for a session\n return await this.client.session.messages(sessionId);\n }\n\n async getAllSessionsWithMessages(options?: {\n from?: Date;\n to?: Date;\n }): Promise<Array<{ session: Session; messages: { info: Message; parts: Part[] }[] }>> {\n const sessions = await this.getSessions(options);\n \n // Fetch messages for each session in parallel\n const results = await Promise.all(\n sessions.map(async (session) => ({\n session,\n messages: await this.getSessionMessages(session.id),\n }))\n );\n \n return results;\n }\n}\n```\n\n#### Data Models\n\n```typescript\n// src/data/models.ts\n\nexport interface SessionSummary {\n id: string;\n startTime: Date;\n endTime: Date;\n messageCount: number;\n totalTokens: number;\n models: string[];\n}\n\nexport interface DailyActivity {\n date: string; // YYYY-MM-DD\n sessionCount: number;\n totalTokens: number;\n totalDuration: number; // minutes\n}\n\nexport interface ModelUsage {\n model: string;\n sessionCount: number;\n messageCount: number;\n totalTokens: number;\n percentage: number;\n}\n```\n\n### 3. Statistics Engine (`src/stats/`)\n\n#### Core Engine\n\n```typescript\n// src/stats/engine.ts\n\nexport interface StatsResult {\n period: {\n start: Date;\n end: Date;\n days: number;\n };\n summary: {\n totalSessions: number;\n totalTokens: number;\n totalMessages: number;\n activeDays: number;\n currentStreak: number;\n longestStreak: number;\n longestSession: {\n id: string;\n duration: number; // minutes\n };\n peakHour: number; // 0-23\n favoriteModel: string;\n };\n dailyActivity: DailyActivity[];\n modelUsage: ModelUsage[];\n funFact: string;\n}\n\nexport class StatsEngine {\n constructor(private dataProvider: SessionDataProvider) {}\n\n async computeStats(options: {\n period: \"week\" | \"month\" | \"year\" | \"all\";\n }): Promise<StatsResult> {\n const sessions = await this.dataProvider.getSessions({\n from: this.getPeriodStart(options.period),\n });\n\n return {\n period: this.computePeriod(sessions, options.period),\n summary: this.computeSummary(sessions),\n dailyActivity: this.computeDailyActivity(sessions),\n modelUsage: this.computeModelUsage(sessions),\n funFact: this.generateFunFact(sessions),\n };\n }\n\n private computeSummary(sessions: Session[]): StatsResult[\"summary\"] {\n // Compute all summary statistics\n }\n\n private computeDailyActivity(sessions: Session[]): DailyActivity[] {\n // Aggregate sessions by day\n }\n\n private computeModelUsage(sessions: Session[]): ModelUsage[] {\n // Aggregate by model\n }\n\n private generateFunFact(sessions: Session[]): string {\n // Pick a fun comparison\n }\n}\n```\n\n#### Streak Calculator\n\n```typescript\n// src/stats/streaks.ts\n\nexport interface StreakResult {\n current: number;\n longest: number;\n currentStart?: Date;\n longestStart?: Date;\n longestEnd?: Date;\n}\n\nexport function calculateStreaks(dailyActivity: DailyActivity[]): StreakResult {\n // Sort by date\n const sorted = [...dailyActivity].sort(\n (a, b) => new Date(a.date).getTime() - new Date(b.date).getTime()\n );\n\n let current = 0;\n let longest = 0;\n let streak = 0;\n let prevDate: Date | null = null;\n\n for (const day of sorted) {\n const date = new Date(day.date);\n if (prevDate && isConsecutiveDay(prevDate, date)) {\n streak++;\n } else {\n streak = 1;\n }\n\n if (streak > longest) longest = streak;\n prevDate = date;\n }\n\n // Check if streak continues to today\n const today = new Date();\n today.setHours(0, 0, 0, 0);\n \n if (prevDate && isConsecutiveDay(prevDate, today)) {\n current = streak;\n } else if (prevDate?.getTime() === today.getTime()) {\n current = streak;\n }\n\n return { current, longest };\n}\n\nfunction isConsecutiveDay(a: Date, b: Date): boolean {\n const diff = b.getTime() - a.getTime();\n return diff === 24 * 60 * 60 * 1000;\n}\n```\n\n#### Fun Facts Generator\n\n```typescript\n// src/stats/funfacts.ts\n\ninterface FunFactTemplate {\n condition: (stats: StatsResult) => boolean;\n generate: (stats: StatsResult) => string;\n}\n\nconst FUN_FACTS: FunFactTemplate[] = [\n {\n condition: (s) => s.summary.longestSession.duration > 148, // Inception length\n generate: (s) => {\n const times = Math.round(s.summary.longestSession.duration / 148);\n return `Your longest session is ~${times}x longer than the movie Inception`;\n },\n },\n {\n condition: (s) => s.summary.totalTokens > 587287, // War and Peace word count\n generate: (s) => {\n const times = Math.round(s.summary.totalTokens / 587287);\n return `You've used ${times}x more tokens than words in War and Peace`;\n },\n },\n {\n condition: (s) => s.summary.currentStreak >= 7,\n generate: (s) => \n `Your ${s.summary.currentStreak}-day streak is longer than most New Year resolutions`,\n },\n {\n condition: (s) => s.summary.peakHour >= 22 || s.summary.peakHour <= 4,\n generate: () => `You're a night owl coder - peak activity is after dark`,\n },\n {\n condition: (s) => s.summary.peakHour >= 5 && s.summary.peakHour <= 8,\n generate: () => `Early bird catches the bugs - you code best at dawn`,\n },\n // More fun facts...\n];\n\nexport function generateFunFact(stats: StatsResult): string {\n const applicable = FUN_FACTS.filter((f) => f.condition(stats));\n if (applicable.length === 0) {\n return `You've had ${stats.summary.totalSessions} coding sessions - keep going!`;\n }\n const random = applicable[Math.floor(Math.random() * applicable.length)];\n return random.generate(stats);\n}\n```\n\n### 4. Renderer (`src/render/`)\n\n#### Renderer Interface\n\n```typescript\n// src/render/types.ts\n\nexport interface RenderContext {\n width: number;\n height: number;\n colors: boolean;\n}\n\nexport interface Renderer {\n render(stats: StatsResult, view: \"overview\" | \"models\"): string;\n}\n```\n\n#### Heatmap Component\n\n```typescript\n// src/render/components/heatmap.ts\n\nconst INTENSITY_CHARS = [\" \", \"░\", \"▒\", \"▓\", \"█\"];\nconst DAYS = [\"\", \"Mon\", \"\", \"Wed\", \"\", \"Fri\", \"\"];\nconst MONTHS = [\"Jan\", \"Feb\", \"Mar\", \"Apr\", \"May\", \"Jun\", \n \"Jul\", \"Aug\", \"Sep\", \"Oct\", \"Nov\", \"Dec\"];\n\nexport function renderHeatmap(\n dailyActivity: DailyActivity[],\n options: { weeks: number; colors: boolean }\n): string[] {\n const lines: string[] = [];\n \n // Build activity map\n const activityMap = new Map<string, number>();\n dailyActivity.forEach((d) => {\n activityMap.set(d.date, d.sessionCount);\n });\n\n // Calculate intensity thresholds\n const maxActivity = Math.max(...dailyActivity.map((d) => d.sessionCount), 1);\n const getIntensity = (count: number): number => {\n if (count === 0) return 0;\n return Math.min(4, Math.ceil((count / maxActivity) * 4));\n };\n\n // Generate header (months)\n const headerLine = \" \" + generateMonthHeader(options.weeks);\n lines.push(headerLine);\n\n // Generate each day row\n for (let dayOfWeek = 0; dayOfWeek < 7; dayOfWeek++) {\n let line = DAYS[dayOfWeek].padEnd(4);\n \n for (let week = 0; week < options.weeks; week++) {\n const date = getDateForWeekDay(week, dayOfWeek, options.weeks);\n const dateStr = formatDate(date);\n const count = activityMap.get(dateStr) || 0;\n const char = INTENSITY_CHARS[getIntensity(count)];\n line += char + \" \";\n }\n \n lines.push(line);\n }\n\n // Legend\n lines.push(\"\");\n lines.push(\" Less \" + INTENSITY_CHARS.slice(1).join(\" \") + \" More\");\n\n return lines;\n}\n```\n\n#### Stats Dashboard Component\n\n```typescript\n// src/render/components/dashboard.ts\n\nexport function renderDashboard(summary: StatsResult[\"summary\"]): string[] {\n const lines: string[] = [];\n \n const formatDuration = (minutes: number): string => {\n const days = Math.floor(minutes / 1440);\n const hours = Math.floor((minutes % 1440) / 60);\n const mins = minutes % 60;\n \n const parts = [];\n if (days > 0) parts.push(`${days}d`);\n if (hours > 0) parts.push(`${hours}h`);\n if (mins > 0) parts.push(`${mins}m`);\n return parts.join(\" \") || \"0m\";\n };\n\n const formatNumber = (n: number): string => {\n if (n >= 1000000) return `${(n / 1000000).toFixed(1)}m`;\n if (n >= 1000) return `${(n / 1000).toFixed(1)}k`;\n return n.toString();\n };\n\n const leftCol = [\n `Favorite model: ${summary.favoriteModel}`,\n \"\",\n `Sessions: ${summary.totalSessions}`,\n `Current streak: ${summary.currentStreak} days`,\n `Active days: ${summary.activeDays}`,\n ];\n\n const rightCol = [\n `Total tokens: ${formatNumber(summary.totalTokens)}`,\n \"\",\n `Longest session: ${formatDuration(summary.longestSession.duration)}`,\n `Longest streak: ${summary.longestStreak} days`,\n `Peak hour: ${summary.peakHour}:00-${summary.peakHour + 1}:00`,\n ];\n\n // Combine columns\n const maxLeftWidth = Math.max(...leftCol.map((l) => l.length));\n const padding = 4;\n\n for (let i = 0; i < leftCol.length; i++) {\n lines.push(\n leftCol[i].padEnd(maxLeftWidth + padding) + rightCol[i]\n );\n }\n\n return lines;\n}\n```\n\n#### Model Usage Bar Chart\n\n```typescript\n// src/render/components/models.ts\n\nexport function renderModelUsage(\n modelUsage: ModelUsage[],\n options: { width: number }\n): string[] {\n const lines: string[] = [];\n const barWidth = options.width - 40; // Space for label and percentage\n\n const sorted = [...modelUsage].sort((a, b) => b.percentage - a.percentage);\n\n for (const model of sorted.slice(0, 5)) {\n const filled = Math.round((model.percentage / 100) * barWidth);\n const empty = barWidth - filled;\n const bar = \"█\".repeat(filled) + \"░\".repeat(empty);\n const label = model.model.padEnd(28);\n const pct = `${Math.round(model.percentage)}%`.padStart(4);\n \n lines.push(` ${label} ${bar} ${pct}`);\n }\n\n return lines;\n}\n```\n\n#### Main Renderer\n\n```typescript\n// src/render/index.ts\n\nimport { renderHeatmap } from \"./components/heatmap\";\nimport { renderDashboard } from \"./components/dashboard\";\nimport { renderModelUsage } from \"./components/models\";\n\nexport class StatsRenderer implements Renderer {\n constructor(private context: RenderContext) {}\n\n render(stats: StatsResult, view: \"overview\" | \"models\"): string {\n const lines: string[] = [];\n \n // Header\n lines.push(\"\");\n const tabs = view === \"overview\" \n ? \" [Overview] Models (tab to cycle)\"\n : \" Overview [Models] (tab to cycle)\";\n lines.push(tabs);\n lines.push(\"\");\n\n if (view === \"overview\") {\n // Heatmap\n const heatmap = renderHeatmap(stats.dailyActivity, {\n weeks: 52,\n colors: this.context.colors,\n });\n lines.push(...heatmap);\n lines.push(\"\");\n\n // Dashboard stats\n const dashboard = renderDashboard(stats.summary);\n lines.push(...dashboard);\n lines.push(\"\");\n\n // Fun fact\n lines.push(` ${stats.funFact}`);\n lines.push(` Stats from the last ${stats.period.days} days`);\n } else {\n // Model breakdown\n const models = renderModelUsage(stats.modelUsage, {\n width: this.context.width,\n });\n lines.push(...models);\n }\n\n lines.push(\"\");\n return lines.join(\"\\n\");\n }\n}\n```\n\n### 5. Command Handler (`src/commands/`)\n\n```typescript\n// src/commands/stats.ts\n\nimport { z } from \"zod\";\nimport type { ToolExecuteParams } from \"opencode\";\nimport { StatsEngine } from \"../stats/engine\";\nimport { StatsRenderer } from \"../render\";\n\nexport class StatsCommand {\n constructor(private engine: StatsEngine) {}\n\n async execute(params: ToolExecuteParams<{\n period?: \"week\" | \"month\" | \"year\" | \"all\";\n view?: \"overview\" | \"models\";\n }>) {\n const { period = \"month\", view = \"overview\" } = params.input;\n\n try {\n const stats = await this.engine.computeStats({ period });\n \n const renderer = new StatsRenderer({\n width: process.stdout.columns || 80,\n height: process.stdout.rows || 24,\n colors: process.stdout.isTTY ?? false,\n });\n\n const output = renderer.render(stats, view);\n \n return {\n content: output,\n metadata: {\n totalSessions: stats.summary.totalSessions,\n period: stats.period,\n },\n };\n } catch (error) {\n return {\n content: `Error computing stats: ${error.message}`,\n isError: true,\n };\n }\n }\n}\n```\n\n---\n\n## Data Flow\n\n```\n┌──────────────────────────────────────────────────────────────────┐\n│ User invokes /stats │\n└──────────────────────────────────────────────────────────────────┘\n │\n ▼\n┌──────────────────────────────────────────────────────────────────┐\n│ StatsCommand.execute() │\n│ - Parse parameters (period, view) │\n│ - Validate inputs │\n└──────────────────────────────────────────────────────────────────┘\n │\n ▼\n┌──────────────────────────────────────────────────────────────────┐\n│ StatsEngine.computeStats() │\n│ - Fetch session data from provider │\n│ - Compute summary statistics │\n│ - Calculate streaks │\n│ - Aggregate daily activity │\n│ - Compute model usage │\n│ - Generate fun fact │\n└──────────────────────────────────────────────────────────────────┘\n │\n ▼\n┌──────────────────────────────────────────────────────────────────┐\n│ SessionDataProvider.getSessions() │\n│ - Access OpenCode session storage │\n│ - Filter by date range │\n│ - Return session summaries │\n└──────────────────────────────────────────────────────────────────┘\n │\n ▼\n┌──────────────────────────────────────────────────────────────────┐\n│ StatsRenderer.render() │\n│ - Select view (overview/models) │\n│ - Compose components │\n│ - Generate ASCII output │\n└──────────────────────────────────────────────────────────────────┘\n │\n ▼\n┌──────────────────────────────────────────────────────────────────┐\n│ Display output to user │\n└──────────────────────────────────────────────────────────────────┘\n```\n\n---\n\n## File Structure\n\n```\nopencode-stats/\n├── index.ts # Plugin entry point\n├── package.json # Dependencies and metadata\n├── tsconfig.json # TypeScript configuration\n├── README.md # Plugin documentation\n│\n├── src/\n│ ├── commands/\n│ │ └── stats.ts # Slash command handler\n│ │\n│ ├── data/\n│ │ ├── sessions.ts # Session data provider\n│ │ └── models.ts # Data models/interfaces\n│ │\n│ ├── stats/\n│ │ ├── engine.ts # Main statistics engine\n│ │ ├── streaks.ts # Streak calculation\n│ │ ├── funfacts.ts # Fun fact generator\n│ │ └── aggregators.ts # Data aggregation utilities\n│ │\n│ └── render/\n│ ├── index.ts # Main renderer\n│ ├── types.ts # Render interfaces\n│ └── components/\n│ ├── heatmap.ts # Activity heatmap\n│ ├── dashboard.ts # Stats dashboard\n│ ├── models.ts # Model usage chart\n│ └── box.ts # Box drawing utilities\n│\n└── tests/\n ├── stats/\n │ ├── engine.test.ts\n │ └── streaks.test.ts\n └── render/\n └── components.test.ts\n```\n\n---\n\n## Dependencies\n\n```json\n{\n \"name\": \"opencode-stats\",\n \"version\": \"1.0.0\",\n \"type\": \"module\",\n \"main\": \"index.ts\",\n \"dependencies\": {\n \"zod\": \"^3.22.0\"\n },\n \"devDependencies\": {\n \"@types/bun\": \"latest\",\n \"typescript\": \"^5.0.0\"\n },\n \"peerDependencies\": {\n \"opencode\": \">=0.1.0\"\n }\n}\n```\n\n---\n\n## Configuration\n\n### Plugin Configuration (`opencode.json`)\n\n```json\n{\n \"plugins\": {\n \"opencode-stats\": {\n \"enabled\": true,\n \"options\": {\n \"defaultPeriod\": \"month\",\n \"cacheEnabled\": true,\n \"cacheTTL\": 300\n }\n }\n }\n}\n```\n\n### Environment Variables\n\n| Variable | Description | Default |\n|----------|-------------|---------|\n| `OPENCODE_STATS_CACHE` | Enable caching | `true` |\n| `OPENCODE_STATS_CACHE_TTL` | Cache TTL in seconds | `300` |\n\n---\n\n## Testing Strategy\n\n### Unit Tests\n\n- Statistics calculations (streaks, aggregations)\n- Render component output\n- Fun fact generation\n\n### Integration Tests\n\n- Full stats computation with mock data\n- Command execution flow\n\n### Manual Testing\n\n- Various terminal sizes\n- Color/no-color modes\n- Large session histories\n\n---\n\n## Performance Considerations\n\n### Caching Strategy\n\n```typescript\ninterface CacheEntry {\n stats: StatsResult;\n computedAt: Date;\n sessionCount: number;\n}\n\nclass StatsCache {\n private cache: Map<string, CacheEntry> = new Map();\n private ttl: number;\n\n constructor(ttlSeconds: number = 300) {\n this.ttl = ttlSeconds * 1000;\n }\n\n get(period: string): StatsResult | null {\n const entry = this.cache.get(period);\n if (!entry) return null;\n \n const age = Date.now() - entry.computedAt.getTime();\n if (age > this.ttl) {\n this.cache.delete(period);\n return null;\n }\n \n return entry.stats;\n }\n\n set(period: string, stats: StatsResult, sessionCount: number): void {\n this.cache.set(period, {\n stats,\n computedAt: new Date(),\n sessionCount,\n });\n }\n\n invalidate(): void {\n this.cache.clear();\n }\n}\n```\n\n### Lazy Loading\n\n- Load only session summaries for initial stats\n- Fetch full session data only when needed (e.g., longest session details)\n\n---\n\n## Security Considerations\n\n1. **Read-only access:** Plugin only reads session data, never writes\n2. **Local processing:** All computation happens locally\n3. **No network calls:** No telemetry or external API calls\n4. **Sandboxed execution:** Runs within OpenCode's plugin sandbox\n\n---\n\n## Future Extensibility\n\n### Planned Extensions\n\n1. **Export API:** Allow other plugins to access stats\n2. **Webhook integration:** Post stats to external services\n3. **Custom metrics:** User-defined stat tracking\n4. **Themes:** Customizable color schemes\n\n### Extension Points\n\n```typescript\n// Future: Plugin extension API\ninterface StatsExtension {\n // Add custom metrics\n metrics?: CustomMetric[];\n \n // Add custom fun facts\n funFacts?: FunFactTemplate[];\n \n // Add custom views\n views?: CustomView[];\n}\n```\n\n---\n\n## Resolved Questions\n\nBased on the actual OpenCode plugin API (`@opencode-ai/plugin`):\n\n### 1. Session Data Access - RESOLVED\n\n**How does OpenCode expose session list to plugins?**\n- Via the SDK client: `input.client.session.list()` and `input.client.session.messages(sessionId)`\n\n**Schema of session/message data:**\n- Sessions have: `id`, `title`, `createdAt`, `updatedAt`\n- Messages have: `id`, `sessionID`, `role`, `createdAt`, `info` (with model, tokens, cost)\n- Parts have: `id`, `type`, `content`\n\n### 2. Rendering - RESOLVED\n\n**Can plugins render output?**\n- Yes, via custom tools. The `execute` function returns `{ title, output, metadata }`\n- The `output` string is displayed to the user\n- For tab switching, we'd need to implement as separate tool calls or use the experimental hooks\n\n**Keyboard input:**\n- Not directly available in tool output\n- Alternative: Use multiple tool parameters (e.g., `/stats view=models`)\n\n### 3. Token Counting - RESOLVED\n\n**Is token count available per message?**\n- Yes! In `message.info.tokens`:\n - `input`: Input tokens\n - `output`: Output tokens\n - `reasoning`: Reasoning tokens (if applicable)\n - `cache.read` / `cache.write`: Cache tokens\n- Also `message.info.cost` for cost tracking\n\n### 4. Plugin Lifecycle - RESOLVED\n\n**When is the plugin loaded?**\n- Plugin function is called once when OpenCode starts\n- Returns hooks that are registered for the session lifetime\n\n**Can we persist cache?**\n- Yes, plugins can maintain in-memory state\n- For persistent storage, use file system via the Bun shell (`input.$`)\n\n### 5. Available Hooks Summary\n\n| Hook | Purpose | Use in Stats Plugin |\n|------|---------|---------------------|\n| `tool` | Define custom tools | `/stats` command |\n| `event` | Listen to events | Cache invalidation |\n| `chat.message` | Intercept messages | Could track in real-time |\n| `tool.execute.after` | Modify tool output | Could enhance other tool outputs with stats |\n| `experimental.session.compacting` | Add context | Could inject usage summary |\n", | |
| "additions": 50, | |
| "deletions": 15 | |
| } | |
| }, | |
| "time": { | |
| "start": 1766431392079, | |
| "end": 1766431392082 | |
| } | |
| } | |
| }, | |
| { | |
| "id": "prt_b47840259001OOLFa00lOD02w2", | |
| "sessionID": "ses_4b8933352ffe2k7Q7VhaAWbJcB", | |
| "messageID": "msg_b4783cb3f001VIVAMzvB7HVIog", | |
| "type": "step-finish", | |
| "reason": "tool-calls", | |
| "cost": 0, | |
| "tokens": { | |
| "input": 1, | |
| "output": 823, | |
| "reasoning": 0, | |
| "cache": { | |
| "read": 43009, | |
| "write": 1105 | |
| } | |
| } | |
| } | |
| ] | |
| }, | |
| { | |
| "info": { | |
| "id": "msg_b478402620013rb44L4ZXVnxUj", | |
| "sessionID": "ses_4b8933352ffe2k7Q7VhaAWbJcB", | |
| "role": "assistant", | |
| "time": { | |
| "created": 1766431392354, | |
| "completed": 1766431398582 | |
| }, | |
| "parentID": "msg_b4782c46a001rP2W0KPoAqISMd", | |
| "modelID": "claude-opus-4-5", | |
| "providerID": "anthropic", | |
| "mode": "build", | |
| "agent": "build", | |
| "path": { | |
| "cwd": "/Users/themishkun/projects/tinkering/opencode-stats", | |
| "root": "/" | |
| }, | |
| "cost": 0, | |
| "tokens": { | |
| "input": 1, | |
| "output": 388, | |
| "reasoning": 0, | |
| "cache": { | |
| "read": 44114, | |
| "write": 849 | |
| } | |
| }, | |
| "finish": "tool-calls" | |
| }, | |
| "parts": [ | |
| { | |
| "id": "prt_b47840f000016MTdrFXPM750B3", | |
| "sessionID": "ses_4b8933352ffe2k7Q7VhaAWbJcB", | |
| "messageID": "msg_b478402620013rb44L4ZXVnxUj", | |
| "type": "step-start" | |
| }, | |
| { | |
| "id": "prt_b47840f020015KCM74WsmmbQ6l", | |
| "sessionID": "ses_4b8933352ffe2k7Q7VhaAWbJcB", | |
| "messageID": "msg_b478402620013rb44L4ZXVnxUj", | |
| "type": "tool", | |
| "callID": "toolu_011isL1Qb1Vt4LGRxa5V9xEa", | |
| "tool": "edit", | |
| "state": { | |
| "status": "completed", | |
| "input": { | |
| "filePath": "/Users/themishkun/projects/tinkering/opencode-stats/ARCHITECTURE.md", | |
| "oldString": "## Dependencies\n\n```json\n{\n \"name\": \"opencode-stats\",\n \"version\": \"1.0.0\",\n \"type\": \"module\",\n \"main\": \"index.ts\",\n \"dependencies\": {\n \"zod\": \"^3.22.0\"\n },\n \"devDependencies\": {\n \"@types/bun\": \"latest\",\n \"typescript\": \"^5.0.0\"\n },\n \"peerDependencies\": {\n \"opencode\": \">=0.1.0\"\n }\n}", | |
| "newString": "## Dependencies\n\n```json\n{\n \"name\": \"opencode-stats\",\n \"version\": \"1.0.0\",\n \"type\": \"module\",\n \"main\": \"index.ts\",\n \"dependencies\": {\n \"zod\": \"^3.22.0\"\n },\n \"devDependencies\": {\n \"@types/bun\": \"latest\",\n \"typescript\": \"^5.0.0\"\n },\n \"peerDependencies\": {\n \"@opencode-ai/plugin\": \"*\",\n \"@opencode-ai/sdk\": \"*\"\n }\n}" | |
| }, | |
| "output": "", | |
| "title": "Users/themishkun/projects/tinkering/opencode-stats/ARCHITECTURE.md", | |
| "metadata": { | |
| "diagnostics": {}, | |
| "diff": "Index: /Users/themishkun/projects/tinkering/opencode-stats/ARCHITECTURE.md\n===================================================================\n--- /Users/themishkun/projects/tinkering/opencode-stats/ARCHITECTURE.md\n+++ /Users/themishkun/projects/tinkering/opencode-stats/ARCHITECTURE.md\n@@ -896,9 +896,10 @@\n \"@types/bun\": \"latest\",\n \"typescript\": \"^5.0.0\"\n },\n \"peerDependencies\": {\n- \"opencode\": \">=0.1.0\"\n+ \"@opencode-ai/plugin\": \"*\",\n+ \"@opencode-ai/sdk\": \"*\"\n }\n }\n ```\n \n", | |
| "filediff": { | |
| "file": "/Users/themishkun/projects/tinkering/opencode-stats/ARCHITECTURE.md", | |
| "before": "# Architecture Document: OpenCode Stats Plugin\n\n## Overview\n\nThis document describes the technical architecture of the `opencode-stats` plugin, a \"Spotify Wrapped\"-style statistics visualization tool for OpenCode.\n\n---\n\n## Plugin Architecture\n\n### OpenCode Plugin System\n\nOpenCode plugins are JavaScript/TypeScript modules that run in the Bun runtime. They follow an async function pattern that receives a `PluginInput` and returns `Hooks`.\n\n#### Plugin Input (What plugins receive)\n\n```typescript\n// From @opencode-ai/plugin\nexport type PluginInput = {\n client: ReturnType<typeof createOpencodeClient> // SDK client for API access\n project: Project // Current project info\n directory: string // Project directory\n worktree: string // Git worktree path\n $: BunShell // Bun shell for running commands\n}\n\nexport type Plugin = (input: PluginInput) => Promise<Hooks>\n```\n\n#### Available Hooks\n\n```typescript\nexport interface Hooks {\n // Listen to OpenCode events (session created, message created, etc.)\n event?: (input: { event: Event }) => Promise<void>\n \n // Modify OpenCode configuration\n config?: (input: Config) => Promise<void>\n \n // Define custom tools (slash commands)\n tool?: {\n [key: string]: ToolDefinition\n }\n \n // Custom authentication providers\n auth?: AuthHook\n \n // Called when a new message is received\n \"chat.message\"?: (\n input: { sessionID: string; agent?: string; model?: { providerID: string; modelID: string }; messageID?: string },\n output: { message: UserMessage; parts: Part[] },\n ) => Promise<void>\n \n // Modify parameters sent to LLM\n \"chat.params\"?: (\n input: { sessionID: string; agent: string; model: Model; provider: ProviderContext; message: UserMessage },\n output: { temperature: number; topP: number; topK: number; options: Record<string, any> },\n ) => Promise<void>\n \n // Intercept permission requests\n \"permission.ask\"?: (input: Permission, output: { status: \"ask\" | \"deny\" | \"allow\" }) => Promise<void>\n \n // Before tool execution - can modify args\n \"tool.execute.before\"?: (\n input: { tool: string; sessionID: string; callID: string },\n output: { args: any },\n ) => Promise<void>\n \n // After tool execution - can modify output\n \"tool.execute.after\"?: (\n input: { tool: string; sessionID: string; callID: string },\n output: { title: string; output: string; metadata: any },\n ) => Promise<void>\n \n // Transform chat messages (experimental)\n \"experimental.chat.messages.transform\"?: (\n input: {},\n output: { messages: { info: Message; parts: Part[] }[] },\n ) => Promise<void>\n \n // Transform system prompt (experimental)\n \"experimental.chat.system.transform\"?: (\n input: {},\n output: { system: string[] },\n ) => Promise<void>\n \n // Add context during session compaction (experimental)\n \"experimental.session.compacting\"?: (\n input: { sessionID: string },\n output: { context: string[] },\n ) => Promise<void>\n \n // Transform completed text (experimental)\n \"experimental.text.complete\"?: (\n input: { sessionID: string; messageID: string; partID: string },\n output: { text: string },\n ) => Promise<void>\n}\n```\n\n### Plugin Location\n\n```\n.opencode/\n└── plugin/\n └── opencode-stats/\n ├── index.ts # Main plugin entry\n ├── package.json # Dependencies\n └── src/\n ├── stats/ # Statistics computation\n ├── render/ # TUI rendering\n └── data/ # Data access layer\n```\n\n---\n\n## System Architecture\n\n```\n┌─────────────────────────────────────────────────────────────────┐\n│ OpenCode Host │\n├─────────────────────────────────────────────────────────────────┤\n│ │\n│ ┌─────────────────────────────────────────────────────────┐ │\n│ │ opencode-stats Plugin │ │\n│ ├─────────────────────────────────────────────────────────┤ │\n│ │ │ │\n│ │ ┌─────────────┐ ┌─────────────┐ ┌─────────────────┐ │ │\n│ │ │ Command │ │ Stats │ │ Renderer │ │ │\n│ │ │ Handler │──│ Engine │──│ (TUI) │ │ │\n│ │ └─────────────┘ └─────────────┘ └─────────────────┘ │ │\n│ │ │ │ │ │ │\n│ │ ▼ ▼ ▼ │ │\n│ │ ┌─────────────┐ ┌─────────────┐ ┌─────────────────┐ │ │\n│ │ │ Slash │ │ Data │ │ Components │ │ │\n│ │ │ Command │ │ Layer │ │ Library │ │ │\n│ │ └─────────────┘ └─────────────┘ └─────────────────┘ │ │\n│ │ │ │ │\n│ └──────────────────────────│─────────────────────────────┘ │\n│ │ │\n│ ▼ │\n│ ┌─────────────────────────────────────────────────────────┐ │\n│ │ OpenCode Session Storage │ │\n│ │ (SQLite / JSON) │ │\n│ └─────────────────────────────────────────────────────────┘ │\n│ │\n└─────────────────────────────────────────────────────────────────┘\n```\n\n---\n\n## Component Design\n\n### 1. Plugin Entry Point (`index.ts`)\n\n```typescript\nimport type { Plugin, Hooks, ToolDefinition } from \"@opencode-ai/plugin\";\nimport { z } from \"zod\";\nimport { StatsEngine } from \"./src/stats/engine\";\nimport { SessionDataProvider } from \"./src/data/sessions\";\nimport { StatsRenderer } from \"./src/render\";\n\nconst plugin: Plugin = async (input) => {\n const { client, project, directory } = input;\n \n // Initialize data provider with SDK client\n const dataProvider = new SessionDataProvider(client);\n const statsEngine = new StatsEngine(dataProvider);\n\n const hooks: Hooks = {\n // Register the /stats custom tool (slash command)\n tool: {\n stats: {\n description: \"View your OpenCode usage statistics (Wrapped-style)\",\n parameters: z.object({\n period: z.enum([\"week\", \"month\", \"year\", \"all\"]).optional().default(\"month\"),\n view: z.enum([\"overview\", \"models\"]).optional().default(\"overview\"),\n }),\n async execute(args) {\n const { period, view } = args;\n \n try {\n const stats = await statsEngine.computeStats({ period });\n \n const renderer = new StatsRenderer({\n width: process.stdout.columns || 80,\n height: process.stdout.rows || 24,\n colors: process.stdout.isTTY ?? false,\n });\n\n const output = renderer.render(stats, view);\n \n return {\n title: \"OpenCode Stats\",\n output,\n metadata: {\n totalSessions: stats.summary.totalSessions,\n period: stats.period,\n },\n };\n } catch (error) {\n return {\n title: \"OpenCode Stats Error\",\n output: `Error computing stats: ${error.message}`,\n metadata: { error: true },\n };\n }\n },\n },\n },\n\n // Listen to events for real-time stats updates (optional)\n async event({ event }) {\n // Could invalidate cache when new sessions/messages are created\n if (event.type === \"session.created\" || event.type === \"message.created\") {\n statsEngine.invalidateCache();\n }\n },\n };\n\n return hooks;\n};\n\nexport default plugin;\n```\n\n### 2. Data Layer (`src/data/`)\n\n#### Session Data Provider\n\nResponsible for accessing OpenCode's session storage via the SDK client.\n\n```typescript\n// src/data/sessions.ts\n\nimport type { createOpencodeClient } from \"@opencode-ai/sdk\";\n\n// Types based on OpenCode SDK\nexport interface Session {\n id: string;\n title?: string;\n createdAt: string;\n updatedAt: string;\n}\n\nexport interface Message {\n id: string;\n sessionID: string;\n role: \"user\" | \"assistant\" | \"system\";\n createdAt: string;\n info: {\n model?: {\n providerID: string;\n modelID: string;\n };\n tokens?: {\n input: number;\n output: number;\n reasoning?: number;\n cache?: {\n read: number;\n write: number;\n };\n };\n cost?: number;\n };\n}\n\nexport interface Part {\n id: string;\n type: \"text\" | \"tool-invocation\" | \"tool-result\" | \"file\" | \"step-start\";\n content?: string;\n}\n\ntype Client = ReturnType<typeof createOpencodeClient>;\n\nexport class SessionDataProvider {\n constructor(private client: Client) {}\n\n async getSessions(options?: {\n from?: Date;\n to?: Date;\n limit?: number;\n }): Promise<Session[]> {\n // Use the SDK client to fetch sessions\n const sessions = await this.client.session.list();\n \n // Filter by date if specified\n let filtered = sessions;\n if (options?.from) {\n filtered = filtered.filter(s => new Date(s.createdAt) >= options.from!);\n }\n if (options?.to) {\n filtered = filtered.filter(s => new Date(s.createdAt) <= options.to!);\n }\n if (options?.limit) {\n filtered = filtered.slice(0, options.limit);\n }\n \n return filtered;\n }\n\n async getSessionMessages(sessionId: string): Promise<{ info: Message; parts: Part[] }[]> {\n // Fetch all messages for a session\n return await this.client.session.messages(sessionId);\n }\n\n async getAllSessionsWithMessages(options?: {\n from?: Date;\n to?: Date;\n }): Promise<Array<{ session: Session; messages: { info: Message; parts: Part[] }[] }>> {\n const sessions = await this.getSessions(options);\n \n // Fetch messages for each session in parallel\n const results = await Promise.all(\n sessions.map(async (session) => ({\n session,\n messages: await this.getSessionMessages(session.id),\n }))\n );\n \n return results;\n }\n}\n```\n\n#### Data Models\n\n```typescript\n// src/data/models.ts\n\nexport interface SessionSummary {\n id: string;\n startTime: Date;\n endTime: Date;\n messageCount: number;\n totalTokens: number;\n models: string[];\n}\n\nexport interface DailyActivity {\n date: string; // YYYY-MM-DD\n sessionCount: number;\n totalTokens: number;\n totalDuration: number; // minutes\n}\n\nexport interface ModelUsage {\n model: string;\n sessionCount: number;\n messageCount: number;\n totalTokens: number;\n percentage: number;\n}\n```\n\n### 3. Statistics Engine (`src/stats/`)\n\n#### Core Engine\n\n```typescript\n// src/stats/engine.ts\n\nexport interface StatsResult {\n period: {\n start: Date;\n end: Date;\n days: number;\n };\n summary: {\n totalSessions: number;\n totalTokens: number;\n totalMessages: number;\n activeDays: number;\n currentStreak: number;\n longestStreak: number;\n longestSession: {\n id: string;\n duration: number; // minutes\n };\n peakHour: number; // 0-23\n favoriteModel: string;\n };\n dailyActivity: DailyActivity[];\n modelUsage: ModelUsage[];\n funFact: string;\n}\n\nexport class StatsEngine {\n constructor(private dataProvider: SessionDataProvider) {}\n\n async computeStats(options: {\n period: \"week\" | \"month\" | \"year\" | \"all\";\n }): Promise<StatsResult> {\n const sessions = await this.dataProvider.getSessions({\n from: this.getPeriodStart(options.period),\n });\n\n return {\n period: this.computePeriod(sessions, options.period),\n summary: this.computeSummary(sessions),\n dailyActivity: this.computeDailyActivity(sessions),\n modelUsage: this.computeModelUsage(sessions),\n funFact: this.generateFunFact(sessions),\n };\n }\n\n private computeSummary(sessions: Session[]): StatsResult[\"summary\"] {\n // Compute all summary statistics\n }\n\n private computeDailyActivity(sessions: Session[]): DailyActivity[] {\n // Aggregate sessions by day\n }\n\n private computeModelUsage(sessions: Session[]): ModelUsage[] {\n // Aggregate by model\n }\n\n private generateFunFact(sessions: Session[]): string {\n // Pick a fun comparison\n }\n}\n```\n\n#### Streak Calculator\n\n```typescript\n// src/stats/streaks.ts\n\nexport interface StreakResult {\n current: number;\n longest: number;\n currentStart?: Date;\n longestStart?: Date;\n longestEnd?: Date;\n}\n\nexport function calculateStreaks(dailyActivity: DailyActivity[]): StreakResult {\n // Sort by date\n const sorted = [...dailyActivity].sort(\n (a, b) => new Date(a.date).getTime() - new Date(b.date).getTime()\n );\n\n let current = 0;\n let longest = 0;\n let streak = 0;\n let prevDate: Date | null = null;\n\n for (const day of sorted) {\n const date = new Date(day.date);\n if (prevDate && isConsecutiveDay(prevDate, date)) {\n streak++;\n } else {\n streak = 1;\n }\n\n if (streak > longest) longest = streak;\n prevDate = date;\n }\n\n // Check if streak continues to today\n const today = new Date();\n today.setHours(0, 0, 0, 0);\n \n if (prevDate && isConsecutiveDay(prevDate, today)) {\n current = streak;\n } else if (prevDate?.getTime() === today.getTime()) {\n current = streak;\n }\n\n return { current, longest };\n}\n\nfunction isConsecutiveDay(a: Date, b: Date): boolean {\n const diff = b.getTime() - a.getTime();\n return diff === 24 * 60 * 60 * 1000;\n}\n```\n\n#### Fun Facts Generator\n\n```typescript\n// src/stats/funfacts.ts\n\ninterface FunFactTemplate {\n condition: (stats: StatsResult) => boolean;\n generate: (stats: StatsResult) => string;\n}\n\nconst FUN_FACTS: FunFactTemplate[] = [\n {\n condition: (s) => s.summary.longestSession.duration > 148, // Inception length\n generate: (s) => {\n const times = Math.round(s.summary.longestSession.duration / 148);\n return `Your longest session is ~${times}x longer than the movie Inception`;\n },\n },\n {\n condition: (s) => s.summary.totalTokens > 587287, // War and Peace word count\n generate: (s) => {\n const times = Math.round(s.summary.totalTokens / 587287);\n return `You've used ${times}x more tokens than words in War and Peace`;\n },\n },\n {\n condition: (s) => s.summary.currentStreak >= 7,\n generate: (s) => \n `Your ${s.summary.currentStreak}-day streak is longer than most New Year resolutions`,\n },\n {\n condition: (s) => s.summary.peakHour >= 22 || s.summary.peakHour <= 4,\n generate: () => `You're a night owl coder - peak activity is after dark`,\n },\n {\n condition: (s) => s.summary.peakHour >= 5 && s.summary.peakHour <= 8,\n generate: () => `Early bird catches the bugs - you code best at dawn`,\n },\n // More fun facts...\n];\n\nexport function generateFunFact(stats: StatsResult): string {\n const applicable = FUN_FACTS.filter((f) => f.condition(stats));\n if (applicable.length === 0) {\n return `You've had ${stats.summary.totalSessions} coding sessions - keep going!`;\n }\n const random = applicable[Math.floor(Math.random() * applicable.length)];\n return random.generate(stats);\n}\n```\n\n### 4. Renderer (`src/render/`)\n\n#### Renderer Interface\n\n```typescript\n// src/render/types.ts\n\nexport interface RenderContext {\n width: number;\n height: number;\n colors: boolean;\n}\n\nexport interface Renderer {\n render(stats: StatsResult, view: \"overview\" | \"models\"): string;\n}\n```\n\n#### Heatmap Component\n\n```typescript\n// src/render/components/heatmap.ts\n\nconst INTENSITY_CHARS = [\" \", \"░\", \"▒\", \"▓\", \"█\"];\nconst DAYS = [\"\", \"Mon\", \"\", \"Wed\", \"\", \"Fri\", \"\"];\nconst MONTHS = [\"Jan\", \"Feb\", \"Mar\", \"Apr\", \"May\", \"Jun\", \n \"Jul\", \"Aug\", \"Sep\", \"Oct\", \"Nov\", \"Dec\"];\n\nexport function renderHeatmap(\n dailyActivity: DailyActivity[],\n options: { weeks: number; colors: boolean }\n): string[] {\n const lines: string[] = [];\n \n // Build activity map\n const activityMap = new Map<string, number>();\n dailyActivity.forEach((d) => {\n activityMap.set(d.date, d.sessionCount);\n });\n\n // Calculate intensity thresholds\n const maxActivity = Math.max(...dailyActivity.map((d) => d.sessionCount), 1);\n const getIntensity = (count: number): number => {\n if (count === 0) return 0;\n return Math.min(4, Math.ceil((count / maxActivity) * 4));\n };\n\n // Generate header (months)\n const headerLine = \" \" + generateMonthHeader(options.weeks);\n lines.push(headerLine);\n\n // Generate each day row\n for (let dayOfWeek = 0; dayOfWeek < 7; dayOfWeek++) {\n let line = DAYS[dayOfWeek].padEnd(4);\n \n for (let week = 0; week < options.weeks; week++) {\n const date = getDateForWeekDay(week, dayOfWeek, options.weeks);\n const dateStr = formatDate(date);\n const count = activityMap.get(dateStr) || 0;\n const char = INTENSITY_CHARS[getIntensity(count)];\n line += char + \" \";\n }\n \n lines.push(line);\n }\n\n // Legend\n lines.push(\"\");\n lines.push(\" Less \" + INTENSITY_CHARS.slice(1).join(\" \") + \" More\");\n\n return lines;\n}\n```\n\n#### Stats Dashboard Component\n\n```typescript\n// src/render/components/dashboard.ts\n\nexport function renderDashboard(summary: StatsResult[\"summary\"]): string[] {\n const lines: string[] = [];\n \n const formatDuration = (minutes: number): string => {\n const days = Math.floor(minutes / 1440);\n const hours = Math.floor((minutes % 1440) / 60);\n const mins = minutes % 60;\n \n const parts = [];\n if (days > 0) parts.push(`${days}d`);\n if (hours > 0) parts.push(`${hours}h`);\n if (mins > 0) parts.push(`${mins}m`);\n return parts.join(\" \") || \"0m\";\n };\n\n const formatNumber = (n: number): string => {\n if (n >= 1000000) return `${(n / 1000000).toFixed(1)}m`;\n if (n >= 1000) return `${(n / 1000).toFixed(1)}k`;\n return n.toString();\n };\n\n const leftCol = [\n `Favorite model: ${summary.favoriteModel}`,\n \"\",\n `Sessions: ${summary.totalSessions}`,\n `Current streak: ${summary.currentStreak} days`,\n `Active days: ${summary.activeDays}`,\n ];\n\n const rightCol = [\n `Total tokens: ${formatNumber(summary.totalTokens)}`,\n \"\",\n `Longest session: ${formatDuration(summary.longestSession.duration)}`,\n `Longest streak: ${summary.longestStreak} days`,\n `Peak hour: ${summary.peakHour}:00-${summary.peakHour + 1}:00`,\n ];\n\n // Combine columns\n const maxLeftWidth = Math.max(...leftCol.map((l) => l.length));\n const padding = 4;\n\n for (let i = 0; i < leftCol.length; i++) {\n lines.push(\n leftCol[i].padEnd(maxLeftWidth + padding) + rightCol[i]\n );\n }\n\n return lines;\n}\n```\n\n#### Model Usage Bar Chart\n\n```typescript\n// src/render/components/models.ts\n\nexport function renderModelUsage(\n modelUsage: ModelUsage[],\n options: { width: number }\n): string[] {\n const lines: string[] = [];\n const barWidth = options.width - 40; // Space for label and percentage\n\n const sorted = [...modelUsage].sort((a, b) => b.percentage - a.percentage);\n\n for (const model of sorted.slice(0, 5)) {\n const filled = Math.round((model.percentage / 100) * barWidth);\n const empty = barWidth - filled;\n const bar = \"█\".repeat(filled) + \"░\".repeat(empty);\n const label = model.model.padEnd(28);\n const pct = `${Math.round(model.percentage)}%`.padStart(4);\n \n lines.push(` ${label} ${bar} ${pct}`);\n }\n\n return lines;\n}\n```\n\n#### Main Renderer\n\n```typescript\n// src/render/index.ts\n\nimport { renderHeatmap } from \"./components/heatmap\";\nimport { renderDashboard } from \"./components/dashboard\";\nimport { renderModelUsage } from \"./components/models\";\n\nexport class StatsRenderer implements Renderer {\n constructor(private context: RenderContext) {}\n\n render(stats: StatsResult, view: \"overview\" | \"models\"): string {\n const lines: string[] = [];\n \n // Header\n lines.push(\"\");\n const tabs = view === \"overview\" \n ? \" [Overview] Models (tab to cycle)\"\n : \" Overview [Models] (tab to cycle)\";\n lines.push(tabs);\n lines.push(\"\");\n\n if (view === \"overview\") {\n // Heatmap\n const heatmap = renderHeatmap(stats.dailyActivity, {\n weeks: 52,\n colors: this.context.colors,\n });\n lines.push(...heatmap);\n lines.push(\"\");\n\n // Dashboard stats\n const dashboard = renderDashboard(stats.summary);\n lines.push(...dashboard);\n lines.push(\"\");\n\n // Fun fact\n lines.push(` ${stats.funFact}`);\n lines.push(` Stats from the last ${stats.period.days} days`);\n } else {\n // Model breakdown\n const models = renderModelUsage(stats.modelUsage, {\n width: this.context.width,\n });\n lines.push(...models);\n }\n\n lines.push(\"\");\n return lines.join(\"\\n\");\n }\n}\n```\n\n### 5. Command Handler (`src/commands/`)\n\n```typescript\n// src/commands/stats.ts\n\nimport { z } from \"zod\";\nimport type { ToolExecuteParams } from \"opencode\";\nimport { StatsEngine } from \"../stats/engine\";\nimport { StatsRenderer } from \"../render\";\n\nexport class StatsCommand {\n constructor(private engine: StatsEngine) {}\n\n async execute(params: ToolExecuteParams<{\n period?: \"week\" | \"month\" | \"year\" | \"all\";\n view?: \"overview\" | \"models\";\n }>) {\n const { period = \"month\", view = \"overview\" } = params.input;\n\n try {\n const stats = await this.engine.computeStats({ period });\n \n const renderer = new StatsRenderer({\n width: process.stdout.columns || 80,\n height: process.stdout.rows || 24,\n colors: process.stdout.isTTY ?? false,\n });\n\n const output = renderer.render(stats, view);\n \n return {\n content: output,\n metadata: {\n totalSessions: stats.summary.totalSessions,\n period: stats.period,\n },\n };\n } catch (error) {\n return {\n content: `Error computing stats: ${error.message}`,\n isError: true,\n };\n }\n }\n}\n```\n\n---\n\n## Data Flow\n\n```\n┌──────────────────────────────────────────────────────────────────┐\n│ User invokes /stats │\n└──────────────────────────────────────────────────────────────────┘\n │\n ▼\n┌──────────────────────────────────────────────────────────────────┐\n│ StatsCommand.execute() │\n│ - Parse parameters (period, view) │\n│ - Validate inputs │\n└──────────────────────────────────────────────────────────────────┘\n │\n ▼\n┌──────────────────────────────────────────────────────────────────┐\n│ StatsEngine.computeStats() │\n│ - Fetch session data from provider │\n│ - Compute summary statistics │\n│ - Calculate streaks │\n│ - Aggregate daily activity │\n│ - Compute model usage │\n│ - Generate fun fact │\n└──────────────────────────────────────────────────────────────────┘\n │\n ▼\n┌──────────────────────────────────────────────────────────────────┐\n│ SessionDataProvider.getSessions() │\n│ - Access OpenCode session storage │\n│ - Filter by date range │\n│ - Return session summaries │\n└──────────────────────────────────────────────────────────────────┘\n │\n ▼\n┌──────────────────────────────────────────────────────────────────┐\n│ StatsRenderer.render() │\n│ - Select view (overview/models) │\n│ - Compose components │\n│ - Generate ASCII output │\n└──────────────────────────────────────────────────────────────────┘\n │\n ▼\n┌──────────────────────────────────────────────────────────────────┐\n│ Display output to user │\n└──────────────────────────────────────────────────────────────────┘\n```\n\n---\n\n## File Structure\n\n```\nopencode-stats/\n├── index.ts # Plugin entry point\n├── package.json # Dependencies and metadata\n├── tsconfig.json # TypeScript configuration\n├── README.md # Plugin documentation\n│\n├── src/\n│ ├── commands/\n│ │ └── stats.ts # Slash command handler\n│ │\n│ ├── data/\n│ │ ├── sessions.ts # Session data provider\n│ │ └── models.ts # Data models/interfaces\n│ │\n│ ├── stats/\n│ │ ├── engine.ts # Main statistics engine\n│ │ ├── streaks.ts # Streak calculation\n│ │ ├── funfacts.ts # Fun fact generator\n│ │ └── aggregators.ts # Data aggregation utilities\n│ │\n│ └── render/\n│ ├── index.ts # Main renderer\n│ ├── types.ts # Render interfaces\n│ └── components/\n│ ├── heatmap.ts # Activity heatmap\n│ ├── dashboard.ts # Stats dashboard\n│ ├── models.ts # Model usage chart\n│ └── box.ts # Box drawing utilities\n│\n└── tests/\n ├── stats/\n │ ├── engine.test.ts\n │ └── streaks.test.ts\n └── render/\n └── components.test.ts\n```\n\n---\n\n## Dependencies\n\n```json\n{\n \"name\": \"opencode-stats\",\n \"version\": \"1.0.0\",\n \"type\": \"module\",\n \"main\": \"index.ts\",\n \"dependencies\": {\n \"zod\": \"^3.22.0\"\n },\n \"devDependencies\": {\n \"@types/bun\": \"latest\",\n \"typescript\": \"^5.0.0\"\n },\n \"peerDependencies\": {\n \"opencode\": \">=0.1.0\"\n }\n}\n```\n\n---\n\n## Configuration\n\n### Plugin Configuration (`opencode.json`)\n\n```json\n{\n \"plugins\": {\n \"opencode-stats\": {\n \"enabled\": true,\n \"options\": {\n \"defaultPeriod\": \"month\",\n \"cacheEnabled\": true,\n \"cacheTTL\": 300\n }\n }\n }\n}\n```\n\n### Environment Variables\n\n| Variable | Description | Default |\n|----------|-------------|---------|\n| `OPENCODE_STATS_CACHE` | Enable caching | `true` |\n| `OPENCODE_STATS_CACHE_TTL` | Cache TTL in seconds | `300` |\n\n---\n\n## Testing Strategy\n\n### Unit Tests\n\n- Statistics calculations (streaks, aggregations)\n- Render component output\n- Fun fact generation\n\n### Integration Tests\n\n- Full stats computation with mock data\n- Command execution flow\n\n### Manual Testing\n\n- Various terminal sizes\n- Color/no-color modes\n- Large session histories\n\n---\n\n## Performance Considerations\n\n### Caching Strategy\n\n```typescript\ninterface CacheEntry {\n stats: StatsResult;\n computedAt: Date;\n sessionCount: number;\n}\n\nclass StatsCache {\n private cache: Map<string, CacheEntry> = new Map();\n private ttl: number;\n\n constructor(ttlSeconds: number = 300) {\n this.ttl = ttlSeconds * 1000;\n }\n\n get(period: string): StatsResult | null {\n const entry = this.cache.get(period);\n if (!entry) return null;\n \n const age = Date.now() - entry.computedAt.getTime();\n if (age > this.ttl) {\n this.cache.delete(period);\n return null;\n }\n \n return entry.stats;\n }\n\n set(period: string, stats: StatsResult, sessionCount: number): void {\n this.cache.set(period, {\n stats,\n computedAt: new Date(),\n sessionCount,\n });\n }\n\n invalidate(): void {\n this.cache.clear();\n }\n}\n```\n\n### Lazy Loading\n\n- Load only session summaries for initial stats\n- Fetch full session data only when needed (e.g., longest session details)\n\n---\n\n## Security Considerations\n\n1. **Read-only access:** Plugin only reads session data, never writes\n2. **Local processing:** All computation happens locally\n3. **No network calls:** No telemetry or external API calls\n4. **Sandboxed execution:** Runs within OpenCode's plugin sandbox\n\n---\n\n## Future Extensibility\n\n### Planned Extensions\n\n1. **Export API:** Allow other plugins to access stats\n2. **Webhook integration:** Post stats to external services\n3. **Custom metrics:** User-defined stat tracking\n4. **Themes:** Customizable color schemes\n\n### Extension Points\n\n```typescript\n// Future: Plugin extension API\ninterface StatsExtension {\n // Add custom metrics\n metrics?: CustomMetric[];\n \n // Add custom fun facts\n funFacts?: FunFactTemplate[];\n \n // Add custom views\n views?: CustomView[];\n}\n```\n\n---\n\n## Resolved Questions\n\nBased on the actual OpenCode plugin API (`@opencode-ai/plugin`):\n\n### 1. Session Data Access - RESOLVED\n\n**How does OpenCode expose session list to plugins?**\n- Via the SDK client: `input.client.session.list()` and `input.client.session.messages(sessionId)`\n\n**Schema of session/message data:**\n- Sessions have: `id`, `title`, `createdAt`, `updatedAt`\n- Messages have: `id`, `sessionID`, `role`, `createdAt`, `info` (with model, tokens, cost)\n- Parts have: `id`, `type`, `content`\n\n### 2. Rendering - RESOLVED\n\n**Can plugins render output?**\n- Yes, via custom tools. The `execute` function returns `{ title, output, metadata }`\n- The `output` string is displayed to the user\n- For tab switching, we'd need to implement as separate tool calls or use the experimental hooks\n\n**Keyboard input:**\n- Not directly available in tool output\n- Alternative: Use multiple tool parameters (e.g., `/stats view=models`)\n\n### 3. Token Counting - RESOLVED\n\n**Is token count available per message?**\n- Yes! In `message.info.tokens`:\n - `input`: Input tokens\n - `output`: Output tokens\n - `reasoning`: Reasoning tokens (if applicable)\n - `cache.read` / `cache.write`: Cache tokens\n- Also `message.info.cost` for cost tracking\n\n### 4. Plugin Lifecycle - RESOLVED\n\n**When is the plugin loaded?**\n- Plugin function is called once when OpenCode starts\n- Returns hooks that are registered for the session lifetime\n\n**Can we persist cache?**\n- Yes, plugins can maintain in-memory state\n- For persistent storage, use file system via the Bun shell (`input.$`)\n\n### 5. Available Hooks Summary\n\n| Hook | Purpose | Use in Stats Plugin |\n|------|---------|---------------------|\n| `tool` | Define custom tools | `/stats` command |\n| `event` | Listen to events | Cache invalidation |\n| `chat.message` | Intercept messages | Could track in real-time |\n| `tool.execute.after` | Modify tool output | Could enhance other tool outputs with stats |\n| `experimental.session.compacting` | Add context | Could inject usage summary |\n", | |
| "after": "# Architecture Document: OpenCode Stats Plugin\n\n## Overview\n\nThis document describes the technical architecture of the `opencode-stats` plugin, a \"Spotify Wrapped\"-style statistics visualization tool for OpenCode.\n\n---\n\n## Plugin Architecture\n\n### OpenCode Plugin System\n\nOpenCode plugins are JavaScript/TypeScript modules that run in the Bun runtime. They follow an async function pattern that receives a `PluginInput` and returns `Hooks`.\n\n#### Plugin Input (What plugins receive)\n\n```typescript\n// From @opencode-ai/plugin\nexport type PluginInput = {\n client: ReturnType<typeof createOpencodeClient> // SDK client for API access\n project: Project // Current project info\n directory: string // Project directory\n worktree: string // Git worktree path\n $: BunShell // Bun shell for running commands\n}\n\nexport type Plugin = (input: PluginInput) => Promise<Hooks>\n```\n\n#### Available Hooks\n\n```typescript\nexport interface Hooks {\n // Listen to OpenCode events (session created, message created, etc.)\n event?: (input: { event: Event }) => Promise<void>\n \n // Modify OpenCode configuration\n config?: (input: Config) => Promise<void>\n \n // Define custom tools (slash commands)\n tool?: {\n [key: string]: ToolDefinition\n }\n \n // Custom authentication providers\n auth?: AuthHook\n \n // Called when a new message is received\n \"chat.message\"?: (\n input: { sessionID: string; agent?: string; model?: { providerID: string; modelID: string }; messageID?: string },\n output: { message: UserMessage; parts: Part[] },\n ) => Promise<void>\n \n // Modify parameters sent to LLM\n \"chat.params\"?: (\n input: { sessionID: string; agent: string; model: Model; provider: ProviderContext; message: UserMessage },\n output: { temperature: number; topP: number; topK: number; options: Record<string, any> },\n ) => Promise<void>\n \n // Intercept permission requests\n \"permission.ask\"?: (input: Permission, output: { status: \"ask\" | \"deny\" | \"allow\" }) => Promise<void>\n \n // Before tool execution - can modify args\n \"tool.execute.before\"?: (\n input: { tool: string; sessionID: string; callID: string },\n output: { args: any },\n ) => Promise<void>\n \n // After tool execution - can modify output\n \"tool.execute.after\"?: (\n input: { tool: string; sessionID: string; callID: string },\n output: { title: string; output: string; metadata: any },\n ) => Promise<void>\n \n // Transform chat messages (experimental)\n \"experimental.chat.messages.transform\"?: (\n input: {},\n output: { messages: { info: Message; parts: Part[] }[] },\n ) => Promise<void>\n \n // Transform system prompt (experimental)\n \"experimental.chat.system.transform\"?: (\n input: {},\n output: { system: string[] },\n ) => Promise<void>\n \n // Add context during session compaction (experimental)\n \"experimental.session.compacting\"?: (\n input: { sessionID: string },\n output: { context: string[] },\n ) => Promise<void>\n \n // Transform completed text (experimental)\n \"experimental.text.complete\"?: (\n input: { sessionID: string; messageID: string; partID: string },\n output: { text: string },\n ) => Promise<void>\n}\n```\n\n### Plugin Location\n\n```\n.opencode/\n└── plugin/\n └── opencode-stats/\n ├── index.ts # Main plugin entry\n ├── package.json # Dependencies\n └── src/\n ├── stats/ # Statistics computation\n ├── render/ # TUI rendering\n └── data/ # Data access layer\n```\n\n---\n\n## System Architecture\n\n```\n┌─────────────────────────────────────────────────────────────────┐\n│ OpenCode Host │\n├─────────────────────────────────────────────────────────────────┤\n│ │\n│ ┌─────────────────────────────────────────────────────────┐ │\n│ │ opencode-stats Plugin │ │\n│ ├─────────────────────────────────────────────────────────┤ │\n│ │ │ │\n│ │ ┌─────────────┐ ┌─────────────┐ ┌─────────────────┐ │ │\n│ │ │ Command │ │ Stats │ │ Renderer │ │ │\n│ │ │ Handler │──│ Engine │──│ (TUI) │ │ │\n│ │ └─────────────┘ └─────────────┘ └─────────────────┘ │ │\n│ │ │ │ │ │ │\n│ │ ▼ ▼ ▼ │ │\n│ │ ┌─────────────┐ ┌─────────────┐ ┌─────────────────┐ │ │\n│ │ │ Slash │ │ Data │ │ Components │ │ │\n│ │ │ Command │ │ Layer │ │ Library │ │ │\n│ │ └─────────────┘ └─────────────┘ └─────────────────┘ │ │\n│ │ │ │ │\n│ └──────────────────────────│─────────────────────────────┘ │\n│ │ │\n│ ▼ │\n│ ┌─────────────────────────────────────────────────────────┐ │\n│ │ OpenCode Session Storage │ │\n│ │ (SQLite / JSON) │ │\n│ └─────────────────────────────────────────────────────────┘ │\n│ │\n└─────────────────────────────────────────────────────────────────┘\n```\n\n---\n\n## Component Design\n\n### 1. Plugin Entry Point (`index.ts`)\n\n```typescript\nimport type { Plugin, Hooks, ToolDefinition } from \"@opencode-ai/plugin\";\nimport { z } from \"zod\";\nimport { StatsEngine } from \"./src/stats/engine\";\nimport { SessionDataProvider } from \"./src/data/sessions\";\nimport { StatsRenderer } from \"./src/render\";\n\nconst plugin: Plugin = async (input) => {\n const { client, project, directory } = input;\n \n // Initialize data provider with SDK client\n const dataProvider = new SessionDataProvider(client);\n const statsEngine = new StatsEngine(dataProvider);\n\n const hooks: Hooks = {\n // Register the /stats custom tool (slash command)\n tool: {\n stats: {\n description: \"View your OpenCode usage statistics (Wrapped-style)\",\n parameters: z.object({\n period: z.enum([\"week\", \"month\", \"year\", \"all\"]).optional().default(\"month\"),\n view: z.enum([\"overview\", \"models\"]).optional().default(\"overview\"),\n }),\n async execute(args) {\n const { period, view } = args;\n \n try {\n const stats = await statsEngine.computeStats({ period });\n \n const renderer = new StatsRenderer({\n width: process.stdout.columns || 80,\n height: process.stdout.rows || 24,\n colors: process.stdout.isTTY ?? false,\n });\n\n const output = renderer.render(stats, view);\n \n return {\n title: \"OpenCode Stats\",\n output,\n metadata: {\n totalSessions: stats.summary.totalSessions,\n period: stats.period,\n },\n };\n } catch (error) {\n return {\n title: \"OpenCode Stats Error\",\n output: `Error computing stats: ${error.message}`,\n metadata: { error: true },\n };\n }\n },\n },\n },\n\n // Listen to events for real-time stats updates (optional)\n async event({ event }) {\n // Could invalidate cache when new sessions/messages are created\n if (event.type === \"session.created\" || event.type === \"message.created\") {\n statsEngine.invalidateCache();\n }\n },\n };\n\n return hooks;\n};\n\nexport default plugin;\n```\n\n### 2. Data Layer (`src/data/`)\n\n#### Session Data Provider\n\nResponsible for accessing OpenCode's session storage via the SDK client.\n\n```typescript\n// src/data/sessions.ts\n\nimport type { createOpencodeClient } from \"@opencode-ai/sdk\";\n\n// Types based on OpenCode SDK\nexport interface Session {\n id: string;\n title?: string;\n createdAt: string;\n updatedAt: string;\n}\n\nexport interface Message {\n id: string;\n sessionID: string;\n role: \"user\" | \"assistant\" | \"system\";\n createdAt: string;\n info: {\n model?: {\n providerID: string;\n modelID: string;\n };\n tokens?: {\n input: number;\n output: number;\n reasoning?: number;\n cache?: {\n read: number;\n write: number;\n };\n };\n cost?: number;\n };\n}\n\nexport interface Part {\n id: string;\n type: \"text\" | \"tool-invocation\" | \"tool-result\" | \"file\" | \"step-start\";\n content?: string;\n}\n\ntype Client = ReturnType<typeof createOpencodeClient>;\n\nexport class SessionDataProvider {\n constructor(private client: Client) {}\n\n async getSessions(options?: {\n from?: Date;\n to?: Date;\n limit?: number;\n }): Promise<Session[]> {\n // Use the SDK client to fetch sessions\n const sessions = await this.client.session.list();\n \n // Filter by date if specified\n let filtered = sessions;\n if (options?.from) {\n filtered = filtered.filter(s => new Date(s.createdAt) >= options.from!);\n }\n if (options?.to) {\n filtered = filtered.filter(s => new Date(s.createdAt) <= options.to!);\n }\n if (options?.limit) {\n filtered = filtered.slice(0, options.limit);\n }\n \n return filtered;\n }\n\n async getSessionMessages(sessionId: string): Promise<{ info: Message; parts: Part[] }[]> {\n // Fetch all messages for a session\n return await this.client.session.messages(sessionId);\n }\n\n async getAllSessionsWithMessages(options?: {\n from?: Date;\n to?: Date;\n }): Promise<Array<{ session: Session; messages: { info: Message; parts: Part[] }[] }>> {\n const sessions = await this.getSessions(options);\n \n // Fetch messages for each session in parallel\n const results = await Promise.all(\n sessions.map(async (session) => ({\n session,\n messages: await this.getSessionMessages(session.id),\n }))\n );\n \n return results;\n }\n}\n```\n\n#### Data Models\n\n```typescript\n// src/data/models.ts\n\nexport interface SessionSummary {\n id: string;\n startTime: Date;\n endTime: Date;\n messageCount: number;\n totalTokens: number;\n models: string[];\n}\n\nexport interface DailyActivity {\n date: string; // YYYY-MM-DD\n sessionCount: number;\n totalTokens: number;\n totalDuration: number; // minutes\n}\n\nexport interface ModelUsage {\n model: string;\n sessionCount: number;\n messageCount: number;\n totalTokens: number;\n percentage: number;\n}\n```\n\n### 3. Statistics Engine (`src/stats/`)\n\n#### Core Engine\n\n```typescript\n// src/stats/engine.ts\n\nexport interface StatsResult {\n period: {\n start: Date;\n end: Date;\n days: number;\n };\n summary: {\n totalSessions: number;\n totalTokens: number;\n totalMessages: number;\n activeDays: number;\n currentStreak: number;\n longestStreak: number;\n longestSession: {\n id: string;\n duration: number; // minutes\n };\n peakHour: number; // 0-23\n favoriteModel: string;\n };\n dailyActivity: DailyActivity[];\n modelUsage: ModelUsage[];\n funFact: string;\n}\n\nexport class StatsEngine {\n constructor(private dataProvider: SessionDataProvider) {}\n\n async computeStats(options: {\n period: \"week\" | \"month\" | \"year\" | \"all\";\n }): Promise<StatsResult> {\n const sessions = await this.dataProvider.getSessions({\n from: this.getPeriodStart(options.period),\n });\n\n return {\n period: this.computePeriod(sessions, options.period),\n summary: this.computeSummary(sessions),\n dailyActivity: this.computeDailyActivity(sessions),\n modelUsage: this.computeModelUsage(sessions),\n funFact: this.generateFunFact(sessions),\n };\n }\n\n private computeSummary(sessions: Session[]): StatsResult[\"summary\"] {\n // Compute all summary statistics\n }\n\n private computeDailyActivity(sessions: Session[]): DailyActivity[] {\n // Aggregate sessions by day\n }\n\n private computeModelUsage(sessions: Session[]): ModelUsage[] {\n // Aggregate by model\n }\n\n private generateFunFact(sessions: Session[]): string {\n // Pick a fun comparison\n }\n}\n```\n\n#### Streak Calculator\n\n```typescript\n// src/stats/streaks.ts\n\nexport interface StreakResult {\n current: number;\n longest: number;\n currentStart?: Date;\n longestStart?: Date;\n longestEnd?: Date;\n}\n\nexport function calculateStreaks(dailyActivity: DailyActivity[]): StreakResult {\n // Sort by date\n const sorted = [...dailyActivity].sort(\n (a, b) => new Date(a.date).getTime() - new Date(b.date).getTime()\n );\n\n let current = 0;\n let longest = 0;\n let streak = 0;\n let prevDate: Date | null = null;\n\n for (const day of sorted) {\n const date = new Date(day.date);\n if (prevDate && isConsecutiveDay(prevDate, date)) {\n streak++;\n } else {\n streak = 1;\n }\n\n if (streak > longest) longest = streak;\n prevDate = date;\n }\n\n // Check if streak continues to today\n const today = new Date();\n today.setHours(0, 0, 0, 0);\n \n if (prevDate && isConsecutiveDay(prevDate, today)) {\n current = streak;\n } else if (prevDate?.getTime() === today.getTime()) {\n current = streak;\n }\n\n return { current, longest };\n}\n\nfunction isConsecutiveDay(a: Date, b: Date): boolean {\n const diff = b.getTime() - a.getTime();\n return diff === 24 * 60 * 60 * 1000;\n}\n```\n\n#### Fun Facts Generator\n\n```typescript\n// src/stats/funfacts.ts\n\ninterface FunFactTemplate {\n condition: (stats: StatsResult) => boolean;\n generate: (stats: StatsResult) => string;\n}\n\nconst FUN_FACTS: FunFactTemplate[] = [\n {\n condition: (s) => s.summary.longestSession.duration > 148, // Inception length\n generate: (s) => {\n const times = Math.round(s.summary.longestSession.duration / 148);\n return `Your longest session is ~${times}x longer than the movie Inception`;\n },\n },\n {\n condition: (s) => s.summary.totalTokens > 587287, // War and Peace word count\n generate: (s) => {\n const times = Math.round(s.summary.totalTokens / 587287);\n return `You've used ${times}x more tokens than words in War and Peace`;\n },\n },\n {\n condition: (s) => s.summary.currentStreak >= 7,\n generate: (s) => \n `Your ${s.summary.currentStreak}-day streak is longer than most New Year resolutions`,\n },\n {\n condition: (s) => s.summary.peakHour >= 22 || s.summary.peakHour <= 4,\n generate: () => `You're a night owl coder - peak activity is after dark`,\n },\n {\n condition: (s) => s.summary.peakHour >= 5 && s.summary.peakHour <= 8,\n generate: () => `Early bird catches the bugs - you code best at dawn`,\n },\n // More fun facts...\n];\n\nexport function generateFunFact(stats: StatsResult): string {\n const applicable = FUN_FACTS.filter((f) => f.condition(stats));\n if (applicable.length === 0) {\n return `You've had ${stats.summary.totalSessions} coding sessions - keep going!`;\n }\n const random = applicable[Math.floor(Math.random() * applicable.length)];\n return random.generate(stats);\n}\n```\n\n### 4. Renderer (`src/render/`)\n\n#### Renderer Interface\n\n```typescript\n// src/render/types.ts\n\nexport interface RenderContext {\n width: number;\n height: number;\n colors: boolean;\n}\n\nexport interface Renderer {\n render(stats: StatsResult, view: \"overview\" | \"models\"): string;\n}\n```\n\n#### Heatmap Component\n\n```typescript\n// src/render/components/heatmap.ts\n\nconst INTENSITY_CHARS = [\" \", \"░\", \"▒\", \"▓\", \"█\"];\nconst DAYS = [\"\", \"Mon\", \"\", \"Wed\", \"\", \"Fri\", \"\"];\nconst MONTHS = [\"Jan\", \"Feb\", \"Mar\", \"Apr\", \"May\", \"Jun\", \n \"Jul\", \"Aug\", \"Sep\", \"Oct\", \"Nov\", \"Dec\"];\n\nexport function renderHeatmap(\n dailyActivity: DailyActivity[],\n options: { weeks: number; colors: boolean }\n): string[] {\n const lines: string[] = [];\n \n // Build activity map\n const activityMap = new Map<string, number>();\n dailyActivity.forEach((d) => {\n activityMap.set(d.date, d.sessionCount);\n });\n\n // Calculate intensity thresholds\n const maxActivity = Math.max(...dailyActivity.map((d) => d.sessionCount), 1);\n const getIntensity = (count: number): number => {\n if (count === 0) return 0;\n return Math.min(4, Math.ceil((count / maxActivity) * 4));\n };\n\n // Generate header (months)\n const headerLine = \" \" + generateMonthHeader(options.weeks);\n lines.push(headerLine);\n\n // Generate each day row\n for (let dayOfWeek = 0; dayOfWeek < 7; dayOfWeek++) {\n let line = DAYS[dayOfWeek].padEnd(4);\n \n for (let week = 0; week < options.weeks; week++) {\n const date = getDateForWeekDay(week, dayOfWeek, options.weeks);\n const dateStr = formatDate(date);\n const count = activityMap.get(dateStr) || 0;\n const char = INTENSITY_CHARS[getIntensity(count)];\n line += char + \" \";\n }\n \n lines.push(line);\n }\n\n // Legend\n lines.push(\"\");\n lines.push(\" Less \" + INTENSITY_CHARS.slice(1).join(\" \") + \" More\");\n\n return lines;\n}\n```\n\n#### Stats Dashboard Component\n\n```typescript\n// src/render/components/dashboard.ts\n\nexport function renderDashboard(summary: StatsResult[\"summary\"]): string[] {\n const lines: string[] = [];\n \n const formatDuration = (minutes: number): string => {\n const days = Math.floor(minutes / 1440);\n const hours = Math.floor((minutes % 1440) / 60);\n const mins = minutes % 60;\n \n const parts = [];\n if (days > 0) parts.push(`${days}d`);\n if (hours > 0) parts.push(`${hours}h`);\n if (mins > 0) parts.push(`${mins}m`);\n return parts.join(\" \") || \"0m\";\n };\n\n const formatNumber = (n: number): string => {\n if (n >= 1000000) return `${(n / 1000000).toFixed(1)}m`;\n if (n >= 1000) return `${(n / 1000).toFixed(1)}k`;\n return n.toString();\n };\n\n const leftCol = [\n `Favorite model: ${summary.favoriteModel}`,\n \"\",\n `Sessions: ${summary.totalSessions}`,\n `Current streak: ${summary.currentStreak} days`,\n `Active days: ${summary.activeDays}`,\n ];\n\n const rightCol = [\n `Total tokens: ${formatNumber(summary.totalTokens)}`,\n \"\",\n `Longest session: ${formatDuration(summary.longestSession.duration)}`,\n `Longest streak: ${summary.longestStreak} days`,\n `Peak hour: ${summary.peakHour}:00-${summary.peakHour + 1}:00`,\n ];\n\n // Combine columns\n const maxLeftWidth = Math.max(...leftCol.map((l) => l.length));\n const padding = 4;\n\n for (let i = 0; i < leftCol.length; i++) {\n lines.push(\n leftCol[i].padEnd(maxLeftWidth + padding) + rightCol[i]\n );\n }\n\n return lines;\n}\n```\n\n#### Model Usage Bar Chart\n\n```typescript\n// src/render/components/models.ts\n\nexport function renderModelUsage(\n modelUsage: ModelUsage[],\n options: { width: number }\n): string[] {\n const lines: string[] = [];\n const barWidth = options.width - 40; // Space for label and percentage\n\n const sorted = [...modelUsage].sort((a, b) => b.percentage - a.percentage);\n\n for (const model of sorted.slice(0, 5)) {\n const filled = Math.round((model.percentage / 100) * barWidth);\n const empty = barWidth - filled;\n const bar = \"█\".repeat(filled) + \"░\".repeat(empty);\n const label = model.model.padEnd(28);\n const pct = `${Math.round(model.percentage)}%`.padStart(4);\n \n lines.push(` ${label} ${bar} ${pct}`);\n }\n\n return lines;\n}\n```\n\n#### Main Renderer\n\n```typescript\n// src/render/index.ts\n\nimport { renderHeatmap } from \"./components/heatmap\";\nimport { renderDashboard } from \"./components/dashboard\";\nimport { renderModelUsage } from \"./components/models\";\n\nexport class StatsRenderer implements Renderer {\n constructor(private context: RenderContext) {}\n\n render(stats: StatsResult, view: \"overview\" | \"models\"): string {\n const lines: string[] = [];\n \n // Header\n lines.push(\"\");\n const tabs = view === \"overview\" \n ? \" [Overview] Models (tab to cycle)\"\n : \" Overview [Models] (tab to cycle)\";\n lines.push(tabs);\n lines.push(\"\");\n\n if (view === \"overview\") {\n // Heatmap\n const heatmap = renderHeatmap(stats.dailyActivity, {\n weeks: 52,\n colors: this.context.colors,\n });\n lines.push(...heatmap);\n lines.push(\"\");\n\n // Dashboard stats\n const dashboard = renderDashboard(stats.summary);\n lines.push(...dashboard);\n lines.push(\"\");\n\n // Fun fact\n lines.push(` ${stats.funFact}`);\n lines.push(` Stats from the last ${stats.period.days} days`);\n } else {\n // Model breakdown\n const models = renderModelUsage(stats.modelUsage, {\n width: this.context.width,\n });\n lines.push(...models);\n }\n\n lines.push(\"\");\n return lines.join(\"\\n\");\n }\n}\n```\n\n### 5. Command Handler (`src/commands/`)\n\n```typescript\n// src/commands/stats.ts\n\nimport { z } from \"zod\";\nimport type { ToolExecuteParams } from \"opencode\";\nimport { StatsEngine } from \"../stats/engine\";\nimport { StatsRenderer } from \"../render\";\n\nexport class StatsCommand {\n constructor(private engine: StatsEngine) {}\n\n async execute(params: ToolExecuteParams<{\n period?: \"week\" | \"month\" | \"year\" | \"all\";\n view?: \"overview\" | \"models\";\n }>) {\n const { period = \"month\", view = \"overview\" } = params.input;\n\n try {\n const stats = await this.engine.computeStats({ period });\n \n const renderer = new StatsRenderer({\n width: process.stdout.columns || 80,\n height: process.stdout.rows || 24,\n colors: process.stdout.isTTY ?? false,\n });\n\n const output = renderer.render(stats, view);\n \n return {\n content: output,\n metadata: {\n totalSessions: stats.summary.totalSessions,\n period: stats.period,\n },\n };\n } catch (error) {\n return {\n content: `Error computing stats: ${error.message}`,\n isError: true,\n };\n }\n }\n}\n```\n\n---\n\n## Data Flow\n\n```\n┌──────────────────────────────────────────────────────────────────┐\n│ User invokes /stats │\n└──────────────────────────────────────────────────────────────────┘\n │\n ▼\n┌──────────────────────────────────────────────────────────────────┐\n│ StatsCommand.execute() │\n│ - Parse parameters (period, view) │\n│ - Validate inputs │\n└──────────────────────────────────────────────────────────────────┘\n │\n ▼\n┌──────────────────────────────────────────────────────────────────┐\n│ StatsEngine.computeStats() │\n│ - Fetch session data from provider │\n│ - Compute summary statistics │\n│ - Calculate streaks │\n│ - Aggregate daily activity │\n│ - Compute model usage │\n│ - Generate fun fact │\n└──────────────────────────────────────────────────────────────────┘\n │\n ▼\n┌──────────────────────────────────────────────────────────────────┐\n│ SessionDataProvider.getSessions() │\n│ - Access OpenCode session storage │\n│ - Filter by date range │\n│ - Return session summaries │\n└──────────────────────────────────────────────────────────────────┘\n │\n ▼\n┌──────────────────────────────────────────────────────────────────┐\n│ StatsRenderer.render() │\n│ - Select view (overview/models) │\n│ - Compose components │\n│ - Generate ASCII output │\n└──────────────────────────────────────────────────────────────────┘\n │\n ▼\n┌──────────────────────────────────────────────────────────────────┐\n│ Display output to user │\n└──────────────────────────────────────────────────────────────────┘\n```\n\n---\n\n## File Structure\n\n```\nopencode-stats/\n├── index.ts # Plugin entry point\n├── package.json # Dependencies and metadata\n├── tsconfig.json # TypeScript configuration\n├── README.md # Plugin documentation\n│\n├── src/\n│ ├── commands/\n│ │ └── stats.ts # Slash command handler\n│ │\n│ ├── data/\n│ │ ├── sessions.ts # Session data provider\n│ │ └── models.ts # Data models/interfaces\n│ │\n│ ├── stats/\n│ │ ├── engine.ts # Main statistics engine\n│ │ ├── streaks.ts # Streak calculation\n│ │ ├── funfacts.ts # Fun fact generator\n│ │ └── aggregators.ts # Data aggregation utilities\n│ │\n│ └── render/\n│ ├── index.ts # Main renderer\n│ ├── types.ts # Render interfaces\n│ └── components/\n│ ├── heatmap.ts # Activity heatmap\n│ ├── dashboard.ts # Stats dashboard\n│ ├── models.ts # Model usage chart\n│ └── box.ts # Box drawing utilities\n│\n└── tests/\n ├── stats/\n │ ├── engine.test.ts\n │ └── streaks.test.ts\n └── render/\n └── components.test.ts\n```\n\n---\n\n## Dependencies\n\n```json\n{\n \"name\": \"opencode-stats\",\n \"version\": \"1.0.0\",\n \"type\": \"module\",\n \"main\": \"index.ts\",\n \"dependencies\": {\n \"zod\": \"^3.22.0\"\n },\n \"devDependencies\": {\n \"@types/bun\": \"latest\",\n \"typescript\": \"^5.0.0\"\n },\n \"peerDependencies\": {\n \"@opencode-ai/plugin\": \"*\",\n \"@opencode-ai/sdk\": \"*\"\n }\n}\n```\n\n---\n\n## Configuration\n\n### Plugin Configuration (`opencode.json`)\n\n```json\n{\n \"plugins\": {\n \"opencode-stats\": {\n \"enabled\": true,\n \"options\": {\n \"defaultPeriod\": \"month\",\n \"cacheEnabled\": true,\n \"cacheTTL\": 300\n }\n }\n }\n}\n```\n\n### Environment Variables\n\n| Variable | Description | Default |\n|----------|-------------|---------|\n| `OPENCODE_STATS_CACHE` | Enable caching | `true` |\n| `OPENCODE_STATS_CACHE_TTL` | Cache TTL in seconds | `300` |\n\n---\n\n## Testing Strategy\n\n### Unit Tests\n\n- Statistics calculations (streaks, aggregations)\n- Render component output\n- Fun fact generation\n\n### Integration Tests\n\n- Full stats computation with mock data\n- Command execution flow\n\n### Manual Testing\n\n- Various terminal sizes\n- Color/no-color modes\n- Large session histories\n\n---\n\n## Performance Considerations\n\n### Caching Strategy\n\n```typescript\ninterface CacheEntry {\n stats: StatsResult;\n computedAt: Date;\n sessionCount: number;\n}\n\nclass StatsCache {\n private cache: Map<string, CacheEntry> = new Map();\n private ttl: number;\n\n constructor(ttlSeconds: number = 300) {\n this.ttl = ttlSeconds * 1000;\n }\n\n get(period: string): StatsResult | null {\n const entry = this.cache.get(period);\n if (!entry) return null;\n \n const age = Date.now() - entry.computedAt.getTime();\n if (age > this.ttl) {\n this.cache.delete(period);\n return null;\n }\n \n return entry.stats;\n }\n\n set(period: string, stats: StatsResult, sessionCount: number): void {\n this.cache.set(period, {\n stats,\n computedAt: new Date(),\n sessionCount,\n });\n }\n\n invalidate(): void {\n this.cache.clear();\n }\n}\n```\n\n### Lazy Loading\n\n- Load only session summaries for initial stats\n- Fetch full session data only when needed (e.g., longest session details)\n\n---\n\n## Security Considerations\n\n1. **Read-only access:** Plugin only reads session data, never writes\n2. **Local processing:** All computation happens locally\n3. **No network calls:** No telemetry or external API calls\n4. **Sandboxed execution:** Runs within OpenCode's plugin sandbox\n\n---\n\n## Future Extensibility\n\n### Planned Extensions\n\n1. **Export API:** Allow other plugins to access stats\n2. **Webhook integration:** Post stats to external services\n3. **Custom metrics:** User-defined stat tracking\n4. **Themes:** Customizable color schemes\n\n### Extension Points\n\n```typescript\n// Future: Plugin extension API\ninterface StatsExtension {\n // Add custom metrics\n metrics?: CustomMetric[];\n \n // Add custom fun facts\n funFacts?: FunFactTemplate[];\n \n // Add custom views\n views?: CustomView[];\n}\n```\n\n---\n\n## Resolved Questions\n\nBased on the actual OpenCode plugin API (`@opencode-ai/plugin`):\n\n### 1. Session Data Access - RESOLVED\n\n**How does OpenCode expose session list to plugins?**\n- Via the SDK client: `input.client.session.list()` and `input.client.session.messages(sessionId)`\n\n**Schema of session/message data:**\n- Sessions have: `id`, `title`, `createdAt`, `updatedAt`\n- Messages have: `id`, `sessionID`, `role`, `createdAt`, `info` (with model, tokens, cost)\n- Parts have: `id`, `type`, `content`\n\n### 2. Rendering - RESOLVED\n\n**Can plugins render output?**\n- Yes, via custom tools. The `execute` function returns `{ title, output, metadata }`\n- The `output` string is displayed to the user\n- For tab switching, we'd need to implement as separate tool calls or use the experimental hooks\n\n**Keyboard input:**\n- Not directly available in tool output\n- Alternative: Use multiple tool parameters (e.g., `/stats view=models`)\n\n### 3. Token Counting - RESOLVED\n\n**Is token count available per message?**\n- Yes! In `message.info.tokens`:\n - `input`: Input tokens\n - `output`: Output tokens\n - `reasoning`: Reasoning tokens (if applicable)\n - `cache.read` / `cache.write`: Cache tokens\n- Also `message.info.cost` for cost tracking\n\n### 4. Plugin Lifecycle - RESOLVED\n\n**When is the plugin loaded?**\n- Plugin function is called once when OpenCode starts\n- Returns hooks that are registered for the session lifetime\n\n**Can we persist cache?**\n- Yes, plugins can maintain in-memory state\n- For persistent storage, use file system via the Bun shell (`input.$`)\n\n### 5. Available Hooks Summary\n\n| Hook | Purpose | Use in Stats Plugin |\n|------|---------|---------------------|\n| `tool` | Define custom tools | `/stats` command |\n| `event` | Listen to events | Cache invalidation |\n| `chat.message` | Intercept messages | Could track in real-time |\n| `tool.execute.after` | Modify tool output | Could enhance other tool outputs with stats |\n| `experimental.session.compacting` | Add context | Could inject usage summary |\n", | |
| "additions": 2, | |
| "deletions": 1 | |
| } | |
| }, | |
| "time": { | |
| "start": 1766431398538, | |
| "end": 1766431398541 | |
| } | |
| } | |
| }, | |
| { | |
| "id": "prt_b47841ab4001zlmNxotAzpa5fy", | |
| "sessionID": "ses_4b8933352ffe2k7Q7VhaAWbJcB", | |
| "messageID": "msg_b478402620013rb44L4ZXVnxUj", | |
| "type": "step-finish", | |
| "reason": "tool-calls", | |
| "cost": 0, | |
| "tokens": { | |
| "input": 1, | |
| "output": 388, | |
| "reasoning": 0, | |
| "cache": { | |
| "read": 44114, | |
| "write": 849 | |
| } | |
| } | |
| } | |
| ] | |
| }, | |
| { | |
| "info": { | |
| "id": "msg_b47841abc001FZ0JdgpWlTn1KF", | |
| "sessionID": "ses_4b8933352ffe2k7Q7VhaAWbJcB", | |
| "role": "assistant", | |
| "time": { | |
| "created": 1766431398588, | |
| "completed": 1766431432916 | |
| }, | |
| "parentID": "msg_b4782c46a001rP2W0KPoAqISMd", | |
| "modelID": "claude-opus-4-5", | |
| "providerID": "anthropic", | |
| "mode": "build", | |
| "agent": "build", | |
| "path": { | |
| "cwd": "/Users/themishkun/projects/tinkering/opencode-stats", | |
| "root": "/" | |
| }, | |
| "cost": 0, | |
| "tokens": { | |
| "input": 1, | |
| "output": 3152, | |
| "reasoning": 0, | |
| "cache": { | |
| "read": 44963, | |
| "write": 414 | |
| } | |
| }, | |
| "finish": "tool-calls" | |
| }, | |
| "parts": [ | |
| { | |
| "id": "prt_b478427240016jhgGn1lAYTDmn", | |
| "sessionID": "ses_4b8933352ffe2k7Q7VhaAWbJcB", | |
| "messageID": "msg_b47841abc001FZ0JdgpWlTn1KF", | |
| "type": "step-start" | |
| }, | |
| { | |
| "id": "prt_b47842726001D8MyDao5BWqWhX", | |
| "sessionID": "ses_4b8933352ffe2k7Q7VhaAWbJcB", | |
| "messageID": "msg_b47841abc001FZ0JdgpWlTn1KF", | |
| "type": "text", | |
| "text": "Now let me also update the stats engine to work with the actual message format that includes token info:", | |
| "time": { | |
| "start": 1766431402847, | |
| "end": 1766431402847 | |
| } | |
| }, | |
| { | |
| "id": "prt_b47842b5f001BITlPoRfEu7IeW", | |
| "sessionID": "ses_4b8933352ffe2k7Q7VhaAWbJcB", | |
| "messageID": "msg_b47841abc001FZ0JdgpWlTn1KF", | |
| "type": "tool", | |
| "callID": "toolu_01F2TC7rhohcBKaDSR6NN3fa", | |
| "tool": "edit", | |
| "state": { | |
| "status": "completed", | |
| "input": { | |
| "filePath": "/Users/themishkun/projects/tinkering/opencode-stats/ARCHITECTURE.md", | |
| "oldString": "### 3. Statistics Engine (`src/stats/`)\n\n#### Core Engine\n\n```typescript\n// src/stats/engine.ts\n\nexport interface StatsResult {\n period: {\n start: Date;\n end: Date;\n days: number;\n };\n summary: {\n totalSessions: number;\n totalTokens: number;\n totalMessages: number;\n activeDays: number;\n currentStreak: number;\n longestStreak: number;\n longestSession: {\n id: string;\n duration: number; // minutes\n };\n peakHour: number; // 0-23\n favoriteModel: string;\n };\n dailyActivity: DailyActivity[];\n modelUsage: ModelUsage[];\n funFact: string;\n}\n\nexport class StatsEngine {\n constructor(private dataProvider: SessionDataProvider) {}\n\n async computeStats(options: {\n period: \"week\" | \"month\" | \"year\" | \"all\";\n }): Promise<StatsResult> {\n const sessions = await this.dataProvider.getSessions({\n from: this.getPeriodStart(options.period),\n });\n\n return {\n period: this.computePeriod(sessions, options.period),\n summary: this.computeSummary(sessions),\n dailyActivity: this.computeDailyActivity(sessions),\n modelUsage: this.computeModelUsage(sessions),\n funFact: this.generateFunFact(sessions),\n };\n }\n\n private computeSummary(sessions: Session[]): StatsResult[\"summary\"] {\n // Compute all summary statistics\n }\n\n private computeDailyActivity(sessions: Session[]): DailyActivity[] {\n // Aggregate sessions by day\n }\n\n private computeModelUsage(sessions: Session[]): ModelUsage[] {\n // Aggregate by model\n }\n\n private generateFunFact(sessions: Session[]): string {\n // Pick a fun comparison\n }\n}", | |
| "newString": "### 3. Statistics Engine (`src/stats/`)\n\n#### Core Engine\n\n```typescript\n// src/stats/engine.ts\n\nimport { SessionDataProvider, Session, Message, Part } from \"../data/sessions\";\nimport { calculateStreaks } from \"./streaks\";\nimport { generateFunFact } from \"./funfacts\";\n\nexport interface StatsResult {\n period: {\n start: Date;\n end: Date;\n days: number;\n };\n summary: {\n totalSessions: number;\n totalTokens: number;\n totalMessages: number;\n activeDays: number;\n currentStreak: number;\n longestStreak: number;\n longestSession: {\n id: string;\n duration: number; // minutes\n };\n peakHour: number; // 0-23\n favoriteModel: string;\n totalCost: number;\n };\n dailyActivity: DailyActivity[];\n modelUsage: ModelUsage[];\n funFact: string;\n}\n\nexport interface DailyActivity {\n date: string; // YYYY-MM-DD\n sessionCount: number;\n totalTokens: number;\n messageCount: number;\n}\n\nexport interface ModelUsage {\n modelID: string;\n providerID: string;\n displayName: string;\n sessionCount: number;\n messageCount: number;\n totalTokens: number;\n percentage: number;\n}\n\ntype SessionWithMessages = {\n session: Session;\n messages: { info: Message; parts: Part[] }[];\n};\n\nexport class StatsEngine {\n private cache: Map<string, { result: StatsResult; timestamp: number }> = new Map();\n private cacheTTL = 5 * 60 * 1000; // 5 minutes\n\n constructor(private dataProvider: SessionDataProvider) {}\n\n invalidateCache(): void {\n this.cache.clear();\n }\n\n async computeStats(options: {\n period: \"week\" | \"month\" | \"year\" | \"all\";\n }): Promise<StatsResult> {\n // Check cache\n const cached = this.cache.get(options.period);\n if (cached && Date.now() - cached.timestamp < this.cacheTTL) {\n return cached.result;\n }\n\n const from = this.getPeriodStart(options.period);\n const sessionsWithMessages = await this.dataProvider.getAllSessionsWithMessages({ from });\n\n const result: StatsResult = {\n period: this.computePeriod(sessionsWithMessages, options.period, from),\n summary: this.computeSummary(sessionsWithMessages),\n dailyActivity: this.computeDailyActivity(sessionsWithMessages),\n modelUsage: this.computeModelUsage(sessionsWithMessages),\n funFact: \"\", // Computed after other stats\n };\n\n result.funFact = generateFunFact(result);\n\n // Cache result\n this.cache.set(options.period, { result, timestamp: Date.now() });\n\n return result;\n }\n\n private getPeriodStart(period: string): Date | undefined {\n const now = new Date();\n switch (period) {\n case \"week\":\n return new Date(now.getTime() - 7 * 24 * 60 * 60 * 1000);\n case \"month\":\n return new Date(now.getTime() - 30 * 24 * 60 * 60 * 1000);\n case \"year\":\n return new Date(now.getTime() - 365 * 24 * 60 * 60 * 1000);\n default:\n return undefined; // \"all\" - no filter\n }\n }\n\n private computePeriod(\n sessions: SessionWithMessages[],\n period: string,\n from?: Date\n ): StatsResult[\"period\"] {\n const now = new Date();\n const start = from || (sessions.length > 0 \n ? new Date(Math.min(...sessions.map(s => new Date(s.session.createdAt).getTime())))\n : now);\n \n return {\n start,\n end: now,\n days: Math.ceil((now.getTime() - start.getTime()) / (24 * 60 * 60 * 1000)),\n };\n }\n\n private computeSummary(sessions: SessionWithMessages[]): StatsResult[\"summary\"] {\n let totalTokens = 0;\n let totalMessages = 0;\n let totalCost = 0;\n const hourCounts = new Array(24).fill(0);\n const modelCounts = new Map<string, number>();\n const activeDaysSet = new Set<string>();\n \n let longestSession = { id: \"\", duration: 0 };\n\n for (const { session, messages } of sessions) {\n // Track active days\n const sessionDate = new Date(session.createdAt).toISOString().split(\"T\")[0];\n activeDaysSet.add(sessionDate);\n\n // Calculate session duration\n if (messages.length > 0) {\n const firstMsg = new Date(messages[0].info.createdAt);\n const lastMsg = new Date(messages[messages.length - 1].info.createdAt);\n const duration = (lastMsg.getTime() - firstMsg.getTime()) / (1000 * 60); // minutes\n \n if (duration > longestSession.duration) {\n longestSession = { id: session.id, duration };\n }\n }\n\n for (const { info } of messages) {\n totalMessages++;\n \n // Token counting from message.info.tokens\n if (info.tokens) {\n totalTokens += (info.tokens.input || 0) + (info.tokens.output || 0);\n if (info.tokens.reasoning) totalTokens += info.tokens.reasoning;\n }\n \n // Cost tracking\n if (info.cost) {\n totalCost += info.cost;\n }\n\n // Peak hour\n const hour = new Date(info.createdAt).getHours();\n hourCounts[hour]++;\n\n // Model usage\n if (info.model) {\n const modelKey = `${info.model.providerID}/${info.model.modelID}`;\n modelCounts.set(modelKey, (modelCounts.get(modelKey) || 0) + 1);\n }\n }\n }\n\n // Find peak hour\n const peakHour = hourCounts.indexOf(Math.max(...hourCounts));\n\n // Find favorite model\n let favoriteModel = \"Unknown\";\n let maxCount = 0;\n for (const [model, count] of modelCounts) {\n if (count > maxCount) {\n maxCount = count;\n favoriteModel = model.split(\"/\")[1] || model; // Just model name\n }\n }\n\n // Calculate streaks\n const dailyActivity = this.computeDailyActivity(sessions);\n const streaks = calculateStreaks(dailyActivity);\n\n return {\n totalSessions: sessions.length,\n totalTokens,\n totalMessages,\n activeDays: activeDaysSet.size,\n currentStreak: streaks.current,\n longestStreak: streaks.longest,\n longestSession,\n peakHour,\n favoriteModel,\n totalCost,\n };\n }\n\n private computeDailyActivity(sessions: SessionWithMessages[]): DailyActivity[] {\n const dailyMap = new Map<string, DailyActivity>();\n\n for (const { session, messages } of sessions) {\n const date = new Date(session.createdAt).toISOString().split(\"T\")[0];\n \n const existing = dailyMap.get(date) || {\n date,\n sessionCount: 0,\n totalTokens: 0,\n messageCount: 0,\n };\n\n existing.sessionCount++;\n existing.messageCount += messages.length;\n \n for (const { info } of messages) {\n if (info.tokens) {\n existing.totalTokens += (info.tokens.input || 0) + (info.tokens.output || 0);\n }\n }\n\n dailyMap.set(date, existing);\n }\n\n return Array.from(dailyMap.values()).sort((a, b) => a.date.localeCompare(b.date));\n }\n\n private computeModelUsage(sessions: SessionWithMessages[]): ModelUsage[] {\n const modelMap = new Map<string, ModelUsage>();\n let totalMsgs = 0;\n\n for (const { session, messages } of sessions) {\n const sessionModels = new Set<string>();\n \n for (const { info } of messages) {\n if (info.model) {\n const key = `${info.model.providerID}/${info.model.modelID}`;\n sessionModels.add(key);\n \n const existing = modelMap.get(key) || {\n modelID: info.model.modelID,\n providerID: info.model.providerID,\n displayName: info.model.modelID,\n sessionCount: 0,\n messageCount: 0,\n totalTokens: 0,\n percentage: 0,\n };\n\n existing.messageCount++;\n totalMsgs++;\n \n if (info.tokens) {\n existing.totalTokens += (info.tokens.input || 0) + (info.tokens.output || 0);\n }\n\n modelMap.set(key, existing);\n }\n }\n\n // Count unique sessions per model\n for (const key of sessionModels) {\n const model = modelMap.get(key);\n if (model) model.sessionCount++;\n }\n }\n\n // Calculate percentages\n const models = Array.from(modelMap.values());\n for (const model of models) {\n model.percentage = totalMsgs > 0 ? (model.messageCount / totalMsgs) * 100 : 0;\n }\n\n return models.sort((a, b) => b.percentage - a.percentage);\n }\n}" | |
| }, | |
| "output": "", | |
| "title": "Users/themishkun/projects/tinkering/opencode-stats/ARCHITECTURE.md", | |
| "metadata": { | |
| "diagnostics": {}, | |
| "diff": "Index: /Users/themishkun/projects/tinkering/opencode-stats/ARCHITECTURE.md\n===================================================================\n--- /Users/themishkun/projects/tinkering/opencode-stats/ARCHITECTURE.md\n+++ /Users/themishkun/projects/tinkering/opencode-stats/ARCHITECTURE.md\n@@ -360,8 +360,12 @@\n \n ```typescript\n // src/stats/engine.ts\n \n+import { SessionDataProvider, Session, Message, Part } from \"../data/sessions\";\n+import { calculateStreaks } from \"./streaks\";\n+import { generateFunFact } from \"./funfacts\";\n+\n export interface StatsResult {\n period: {\n start: Date;\n end: Date;\n@@ -379,48 +383,265 @@\n duration: number; // minutes\n };\n peakHour: number; // 0-23\n favoriteModel: string;\n+ totalCost: number;\n };\n dailyActivity: DailyActivity[];\n modelUsage: ModelUsage[];\n funFact: string;\n }\n \n+export interface DailyActivity {\n+ date: string; // YYYY-MM-DD\n+ sessionCount: number;\n+ totalTokens: number;\n+ messageCount: number;\n+}\n+\n+export interface ModelUsage {\n+ modelID: string;\n+ providerID: string;\n+ displayName: string;\n+ sessionCount: number;\n+ messageCount: number;\n+ totalTokens: number;\n+ percentage: number;\n+}\n+\n+type SessionWithMessages = {\n+ session: Session;\n+ messages: { info: Message; parts: Part[] }[];\n+};\n+\n export class StatsEngine {\n+ private cache: Map<string, { result: StatsResult; timestamp: number }> = new Map();\n+ private cacheTTL = 5 * 60 * 1000; // 5 minutes\n+\n constructor(private dataProvider: SessionDataProvider) {}\n \n+ invalidateCache(): void {\n+ this.cache.clear();\n+ }\n+\n async computeStats(options: {\n period: \"week\" | \"month\" | \"year\" | \"all\";\n }): Promise<StatsResult> {\n- const sessions = await this.dataProvider.getSessions({\n- from: this.getPeriodStart(options.period),\n- });\n+ // Check cache\n+ const cached = this.cache.get(options.period);\n+ if (cached && Date.now() - cached.timestamp < this.cacheTTL) {\n+ return cached.result;\n+ }\n \n- return {\n- period: this.computePeriod(sessions, options.period),\n- summary: this.computeSummary(sessions),\n- dailyActivity: this.computeDailyActivity(sessions),\n- modelUsage: this.computeModelUsage(sessions),\n- funFact: this.generateFunFact(sessions),\n+ const from = this.getPeriodStart(options.period);\n+ const sessionsWithMessages = await this.dataProvider.getAllSessionsWithMessages({ from });\n+\n+ const result: StatsResult = {\n+ period: this.computePeriod(sessionsWithMessages, options.period, from),\n+ summary: this.computeSummary(sessionsWithMessages),\n+ dailyActivity: this.computeDailyActivity(sessionsWithMessages),\n+ modelUsage: this.computeModelUsage(sessionsWithMessages),\n+ funFact: \"\", // Computed after other stats\n };\n+\n+ result.funFact = generateFunFact(result);\n+\n+ // Cache result\n+ this.cache.set(options.period, { result, timestamp: Date.now() });\n+\n+ return result;\n }\n \n- private computeSummary(sessions: Session[]): StatsResult[\"summary\"] {\n- // Compute all summary statistics\n+ private getPeriodStart(period: string): Date | undefined {\n+ const now = new Date();\n+ switch (period) {\n+ case \"week\":\n+ return new Date(now.getTime() - 7 * 24 * 60 * 60 * 1000);\n+ case \"month\":\n+ return new Date(now.getTime() - 30 * 24 * 60 * 60 * 1000);\n+ case \"year\":\n+ return new Date(now.getTime() - 365 * 24 * 60 * 60 * 1000);\n+ default:\n+ return undefined; // \"all\" - no filter\n+ }\n }\n \n- private computeDailyActivity(sessions: Session[]): DailyActivity[] {\n- // Aggregate sessions by day\n+ private computePeriod(\n+ sessions: SessionWithMessages[],\n+ period: string,\n+ from?: Date\n+ ): StatsResult[\"period\"] {\n+ const now = new Date();\n+ const start = from || (sessions.length > 0 \n+ ? new Date(Math.min(...sessions.map(s => new Date(s.session.createdAt).getTime())))\n+ : now);\n+ \n+ return {\n+ start,\n+ end: now,\n+ days: Math.ceil((now.getTime() - start.getTime()) / (24 * 60 * 60 * 1000)),\n+ };\n }\n \n- private computeModelUsage(sessions: Session[]): ModelUsage[] {\n- // Aggregate by model\n+ private computeSummary(sessions: SessionWithMessages[]): StatsResult[\"summary\"] {\n+ let totalTokens = 0;\n+ let totalMessages = 0;\n+ let totalCost = 0;\n+ const hourCounts = new Array(24).fill(0);\n+ const modelCounts = new Map<string, number>();\n+ const activeDaysSet = new Set<string>();\n+ \n+ let longestSession = { id: \"\", duration: 0 };\n+\n+ for (const { session, messages } of sessions) {\n+ // Track active days\n+ const sessionDate = new Date(session.createdAt).toISOString().split(\"T\")[0];\n+ activeDaysSet.add(sessionDate);\n+\n+ // Calculate session duration\n+ if (messages.length > 0) {\n+ const firstMsg = new Date(messages[0].info.createdAt);\n+ const lastMsg = new Date(messages[messages.length - 1].info.createdAt);\n+ const duration = (lastMsg.getTime() - firstMsg.getTime()) / (1000 * 60); // minutes\n+ \n+ if (duration > longestSession.duration) {\n+ longestSession = { id: session.id, duration };\n+ }\n+ }\n+\n+ for (const { info } of messages) {\n+ totalMessages++;\n+ \n+ // Token counting from message.info.tokens\n+ if (info.tokens) {\n+ totalTokens += (info.tokens.input || 0) + (info.tokens.output || 0);\n+ if (info.tokens.reasoning) totalTokens += info.tokens.reasoning;\n+ }\n+ \n+ // Cost tracking\n+ if (info.cost) {\n+ totalCost += info.cost;\n+ }\n+\n+ // Peak hour\n+ const hour = new Date(info.createdAt).getHours();\n+ hourCounts[hour]++;\n+\n+ // Model usage\n+ if (info.model) {\n+ const modelKey = `${info.model.providerID}/${info.model.modelID}`;\n+ modelCounts.set(modelKey, (modelCounts.get(modelKey) || 0) + 1);\n+ }\n+ }\n+ }\n+\n+ // Find peak hour\n+ const peakHour = hourCounts.indexOf(Math.max(...hourCounts));\n+\n+ // Find favorite model\n+ let favoriteModel = \"Unknown\";\n+ let maxCount = 0;\n+ for (const [model, count] of modelCounts) {\n+ if (count > maxCount) {\n+ maxCount = count;\n+ favoriteModel = model.split(\"/\")[1] || model; // Just model name\n+ }\n+ }\n+\n+ // Calculate streaks\n+ const dailyActivity = this.computeDailyActivity(sessions);\n+ const streaks = calculateStreaks(dailyActivity);\n+\n+ return {\n+ totalSessions: sessions.length,\n+ totalTokens,\n+ totalMessages,\n+ activeDays: activeDaysSet.size,\n+ currentStreak: streaks.current,\n+ longestStreak: streaks.longest,\n+ longestSession,\n+ peakHour,\n+ favoriteModel,\n+ totalCost,\n+ };\n }\n \n- private generateFunFact(sessions: Session[]): string {\n- // Pick a fun comparison\n+ private computeDailyActivity(sessions: SessionWithMessages[]): DailyActivity[] {\n+ const dailyMap = new Map<string, DailyActivity>();\n+\n+ for (const { session, messages } of sessions) {\n+ const date = new Date(session.createdAt).toISOString().split(\"T\")[0];\n+ \n+ const existing = dailyMap.get(date) || {\n+ date,\n+ sessionCount: 0,\n+ totalTokens: 0,\n+ messageCount: 0,\n+ };\n+\n+ existing.sessionCount++;\n+ existing.messageCount += messages.length;\n+ \n+ for (const { info } of messages) {\n+ if (info.tokens) {\n+ existing.totalTokens += (info.tokens.input || 0) + (info.tokens.output || 0);\n+ }\n+ }\n+\n+ dailyMap.set(date, existing);\n+ }\n+\n+ return Array.from(dailyMap.values()).sort((a, b) => a.date.localeCompare(b.date));\n }\n+\n+ private computeModelUsage(sessions: SessionWithMessages[]): ModelUsage[] {\n+ const modelMap = new Map<string, ModelUsage>();\n+ let totalMsgs = 0;\n+\n+ for (const { session, messages } of sessions) {\n+ const sessionModels = new Set<string>();\n+ \n+ for (const { info } of messages) {\n+ if (info.model) {\n+ const key = `${info.model.providerID}/${info.model.modelID}`;\n+ sessionModels.add(key);\n+ \n+ const existing = modelMap.get(key) || {\n+ modelID: info.model.modelID,\n+ providerID: info.model.providerID,\n+ displayName: info.model.modelID,\n+ sessionCount: 0,\n+ messageCount: 0,\n+ totalTokens: 0,\n+ percentage: 0,\n+ };\n+\n+ existing.messageCount++;\n+ totalMsgs++;\n+ \n+ if (info.tokens) {\n+ existing.totalTokens += (info.tokens.input || 0) + (info.tokens.output || 0);\n+ }\n+\n+ modelMap.set(key, existing);\n+ }\n+ }\n+\n+ // Count unique sessions per model\n+ for (const key of sessionModels) {\n+ const model = modelMap.get(key);\n+ if (model) model.sessionCount++;\n+ }\n+ }\n+\n+ // Calculate percentages\n+ const models = Array.from(modelMap.values());\n+ for (const model of models) {\n+ model.percentage = totalMsgs > 0 ? (model.messageCount / totalMsgs) * 100 : 0;\n+ }\n+\n+ return models.sort((a, b) => b.percentage - a.percentage);\n+ }\n }\n ```\n \n #### Streak Calculator\n", | |
| "filediff": { | |
| "file": "/Users/themishkun/projects/tinkering/opencode-stats/ARCHITECTURE.md", | |
| "before": "# Architecture Document: OpenCode Stats Plugin\n\n## Overview\n\nThis document describes the technical architecture of the `opencode-stats` plugin, a \"Spotify Wrapped\"-style statistics visualization tool for OpenCode.\n\n---\n\n## Plugin Architecture\n\n### OpenCode Plugin System\n\nOpenCode plugins are JavaScript/TypeScript modules that run in the Bun runtime. They follow an async function pattern that receives a `PluginInput` and returns `Hooks`.\n\n#### Plugin Input (What plugins receive)\n\n```typescript\n// From @opencode-ai/plugin\nexport type PluginInput = {\n client: ReturnType<typeof createOpencodeClient> // SDK client for API access\n project: Project // Current project info\n directory: string // Project directory\n worktree: string // Git worktree path\n $: BunShell // Bun shell for running commands\n}\n\nexport type Plugin = (input: PluginInput) => Promise<Hooks>\n```\n\n#### Available Hooks\n\n```typescript\nexport interface Hooks {\n // Listen to OpenCode events (session created, message created, etc.)\n event?: (input: { event: Event }) => Promise<void>\n \n // Modify OpenCode configuration\n config?: (input: Config) => Promise<void>\n \n // Define custom tools (slash commands)\n tool?: {\n [key: string]: ToolDefinition\n }\n \n // Custom authentication providers\n auth?: AuthHook\n \n // Called when a new message is received\n \"chat.message\"?: (\n input: { sessionID: string; agent?: string; model?: { providerID: string; modelID: string }; messageID?: string },\n output: { message: UserMessage; parts: Part[] },\n ) => Promise<void>\n \n // Modify parameters sent to LLM\n \"chat.params\"?: (\n input: { sessionID: string; agent: string; model: Model; provider: ProviderContext; message: UserMessage },\n output: { temperature: number; topP: number; topK: number; options: Record<string, any> },\n ) => Promise<void>\n \n // Intercept permission requests\n \"permission.ask\"?: (input: Permission, output: { status: \"ask\" | \"deny\" | \"allow\" }) => Promise<void>\n \n // Before tool execution - can modify args\n \"tool.execute.before\"?: (\n input: { tool: string; sessionID: string; callID: string },\n output: { args: any },\n ) => Promise<void>\n \n // After tool execution - can modify output\n \"tool.execute.after\"?: (\n input: { tool: string; sessionID: string; callID: string },\n output: { title: string; output: string; metadata: any },\n ) => Promise<void>\n \n // Transform chat messages (experimental)\n \"experimental.chat.messages.transform\"?: (\n input: {},\n output: { messages: { info: Message; parts: Part[] }[] },\n ) => Promise<void>\n \n // Transform system prompt (experimental)\n \"experimental.chat.system.transform\"?: (\n input: {},\n output: { system: string[] },\n ) => Promise<void>\n \n // Add context during session compaction (experimental)\n \"experimental.session.compacting\"?: (\n input: { sessionID: string },\n output: { context: string[] },\n ) => Promise<void>\n \n // Transform completed text (experimental)\n \"experimental.text.complete\"?: (\n input: { sessionID: string; messageID: string; partID: string },\n output: { text: string },\n ) => Promise<void>\n}\n```\n\n### Plugin Location\n\n```\n.opencode/\n└── plugin/\n └── opencode-stats/\n ├── index.ts # Main plugin entry\n ├── package.json # Dependencies\n └── src/\n ├── stats/ # Statistics computation\n ├── render/ # TUI rendering\n └── data/ # Data access layer\n```\n\n---\n\n## System Architecture\n\n```\n┌─────────────────────────────────────────────────────────────────┐\n│ OpenCode Host │\n├─────────────────────────────────────────────────────────────────┤\n│ │\n│ ┌─────────────────────────────────────────────────────────┐ │\n│ │ opencode-stats Plugin │ │\n│ ├─────────────────────────────────────────────────────────┤ │\n│ │ │ │\n│ │ ┌─────────────┐ ┌─────────────┐ ┌─────────────────┐ │ │\n│ │ │ Command │ │ Stats │ │ Renderer │ │ │\n│ │ │ Handler │──│ Engine │──│ (TUI) │ │ │\n│ │ └─────────────┘ └─────────────┘ └─────────────────┘ │ │\n│ │ │ │ │ │ │\n│ │ ▼ ▼ ▼ │ │\n│ │ ┌─────────────┐ ┌─────────────┐ ┌─────────────────┐ │ │\n│ │ │ Slash │ │ Data │ │ Components │ │ │\n│ │ │ Command │ │ Layer │ │ Library │ │ │\n│ │ └─────────────┘ └─────────────┘ └─────────────────┘ │ │\n│ │ │ │ │\n│ └──────────────────────────│─────────────────────────────┘ │\n│ │ │\n│ ▼ │\n│ ┌─────────────────────────────────────────────────────────┐ │\n│ │ OpenCode Session Storage │ │\n│ │ (SQLite / JSON) │ │\n│ └─────────────────────────────────────────────────────────┘ │\n│ │\n└─────────────────────────────────────────────────────────────────┘\n```\n\n---\n\n## Component Design\n\n### 1. Plugin Entry Point (`index.ts`)\n\n```typescript\nimport type { Plugin, Hooks, ToolDefinition } from \"@opencode-ai/plugin\";\nimport { z } from \"zod\";\nimport { StatsEngine } from \"./src/stats/engine\";\nimport { SessionDataProvider } from \"./src/data/sessions\";\nimport { StatsRenderer } from \"./src/render\";\n\nconst plugin: Plugin = async (input) => {\n const { client, project, directory } = input;\n \n // Initialize data provider with SDK client\n const dataProvider = new SessionDataProvider(client);\n const statsEngine = new StatsEngine(dataProvider);\n\n const hooks: Hooks = {\n // Register the /stats custom tool (slash command)\n tool: {\n stats: {\n description: \"View your OpenCode usage statistics (Wrapped-style)\",\n parameters: z.object({\n period: z.enum([\"week\", \"month\", \"year\", \"all\"]).optional().default(\"month\"),\n view: z.enum([\"overview\", \"models\"]).optional().default(\"overview\"),\n }),\n async execute(args) {\n const { period, view } = args;\n \n try {\n const stats = await statsEngine.computeStats({ period });\n \n const renderer = new StatsRenderer({\n width: process.stdout.columns || 80,\n height: process.stdout.rows || 24,\n colors: process.stdout.isTTY ?? false,\n });\n\n const output = renderer.render(stats, view);\n \n return {\n title: \"OpenCode Stats\",\n output,\n metadata: {\n totalSessions: stats.summary.totalSessions,\n period: stats.period,\n },\n };\n } catch (error) {\n return {\n title: \"OpenCode Stats Error\",\n output: `Error computing stats: ${error.message}`,\n metadata: { error: true },\n };\n }\n },\n },\n },\n\n // Listen to events for real-time stats updates (optional)\n async event({ event }) {\n // Could invalidate cache when new sessions/messages are created\n if (event.type === \"session.created\" || event.type === \"message.created\") {\n statsEngine.invalidateCache();\n }\n },\n };\n\n return hooks;\n};\n\nexport default plugin;\n```\n\n### 2. Data Layer (`src/data/`)\n\n#### Session Data Provider\n\nResponsible for accessing OpenCode's session storage via the SDK client.\n\n```typescript\n// src/data/sessions.ts\n\nimport type { createOpencodeClient } from \"@opencode-ai/sdk\";\n\n// Types based on OpenCode SDK\nexport interface Session {\n id: string;\n title?: string;\n createdAt: string;\n updatedAt: string;\n}\n\nexport interface Message {\n id: string;\n sessionID: string;\n role: \"user\" | \"assistant\" | \"system\";\n createdAt: string;\n info: {\n model?: {\n providerID: string;\n modelID: string;\n };\n tokens?: {\n input: number;\n output: number;\n reasoning?: number;\n cache?: {\n read: number;\n write: number;\n };\n };\n cost?: number;\n };\n}\n\nexport interface Part {\n id: string;\n type: \"text\" | \"tool-invocation\" | \"tool-result\" | \"file\" | \"step-start\";\n content?: string;\n}\n\ntype Client = ReturnType<typeof createOpencodeClient>;\n\nexport class SessionDataProvider {\n constructor(private client: Client) {}\n\n async getSessions(options?: {\n from?: Date;\n to?: Date;\n limit?: number;\n }): Promise<Session[]> {\n // Use the SDK client to fetch sessions\n const sessions = await this.client.session.list();\n \n // Filter by date if specified\n let filtered = sessions;\n if (options?.from) {\n filtered = filtered.filter(s => new Date(s.createdAt) >= options.from!);\n }\n if (options?.to) {\n filtered = filtered.filter(s => new Date(s.createdAt) <= options.to!);\n }\n if (options?.limit) {\n filtered = filtered.slice(0, options.limit);\n }\n \n return filtered;\n }\n\n async getSessionMessages(sessionId: string): Promise<{ info: Message; parts: Part[] }[]> {\n // Fetch all messages for a session\n return await this.client.session.messages(sessionId);\n }\n\n async getAllSessionsWithMessages(options?: {\n from?: Date;\n to?: Date;\n }): Promise<Array<{ session: Session; messages: { info: Message; parts: Part[] }[] }>> {\n const sessions = await this.getSessions(options);\n \n // Fetch messages for each session in parallel\n const results = await Promise.all(\n sessions.map(async (session) => ({\n session,\n messages: await this.getSessionMessages(session.id),\n }))\n );\n \n return results;\n }\n}\n```\n\n#### Data Models\n\n```typescript\n// src/data/models.ts\n\nexport interface SessionSummary {\n id: string;\n startTime: Date;\n endTime: Date;\n messageCount: number;\n totalTokens: number;\n models: string[];\n}\n\nexport interface DailyActivity {\n date: string; // YYYY-MM-DD\n sessionCount: number;\n totalTokens: number;\n totalDuration: number; // minutes\n}\n\nexport interface ModelUsage {\n model: string;\n sessionCount: number;\n messageCount: number;\n totalTokens: number;\n percentage: number;\n}\n```\n\n### 3. Statistics Engine (`src/stats/`)\n\n#### Core Engine\n\n```typescript\n// src/stats/engine.ts\n\nexport interface StatsResult {\n period: {\n start: Date;\n end: Date;\n days: number;\n };\n summary: {\n totalSessions: number;\n totalTokens: number;\n totalMessages: number;\n activeDays: number;\n currentStreak: number;\n longestStreak: number;\n longestSession: {\n id: string;\n duration: number; // minutes\n };\n peakHour: number; // 0-23\n favoriteModel: string;\n };\n dailyActivity: DailyActivity[];\n modelUsage: ModelUsage[];\n funFact: string;\n}\n\nexport class StatsEngine {\n constructor(private dataProvider: SessionDataProvider) {}\n\n async computeStats(options: {\n period: \"week\" | \"month\" | \"year\" | \"all\";\n }): Promise<StatsResult> {\n const sessions = await this.dataProvider.getSessions({\n from: this.getPeriodStart(options.period),\n });\n\n return {\n period: this.computePeriod(sessions, options.period),\n summary: this.computeSummary(sessions),\n dailyActivity: this.computeDailyActivity(sessions),\n modelUsage: this.computeModelUsage(sessions),\n funFact: this.generateFunFact(sessions),\n };\n }\n\n private computeSummary(sessions: Session[]): StatsResult[\"summary\"] {\n // Compute all summary statistics\n }\n\n private computeDailyActivity(sessions: Session[]): DailyActivity[] {\n // Aggregate sessions by day\n }\n\n private computeModelUsage(sessions: Session[]): ModelUsage[] {\n // Aggregate by model\n }\n\n private generateFunFact(sessions: Session[]): string {\n // Pick a fun comparison\n }\n}\n```\n\n#### Streak Calculator\n\n```typescript\n// src/stats/streaks.ts\n\nexport interface StreakResult {\n current: number;\n longest: number;\n currentStart?: Date;\n longestStart?: Date;\n longestEnd?: Date;\n}\n\nexport function calculateStreaks(dailyActivity: DailyActivity[]): StreakResult {\n // Sort by date\n const sorted = [...dailyActivity].sort(\n (a, b) => new Date(a.date).getTime() - new Date(b.date).getTime()\n );\n\n let current = 0;\n let longest = 0;\n let streak = 0;\n let prevDate: Date | null = null;\n\n for (const day of sorted) {\n const date = new Date(day.date);\n if (prevDate && isConsecutiveDay(prevDate, date)) {\n streak++;\n } else {\n streak = 1;\n }\n\n if (streak > longest) longest = streak;\n prevDate = date;\n }\n\n // Check if streak continues to today\n const today = new Date();\n today.setHours(0, 0, 0, 0);\n \n if (prevDate && isConsecutiveDay(prevDate, today)) {\n current = streak;\n } else if (prevDate?.getTime() === today.getTime()) {\n current = streak;\n }\n\n return { current, longest };\n}\n\nfunction isConsecutiveDay(a: Date, b: Date): boolean {\n const diff = b.getTime() - a.getTime();\n return diff === 24 * 60 * 60 * 1000;\n}\n```\n\n#### Fun Facts Generator\n\n```typescript\n// src/stats/funfacts.ts\n\ninterface FunFactTemplate {\n condition: (stats: StatsResult) => boolean;\n generate: (stats: StatsResult) => string;\n}\n\nconst FUN_FACTS: FunFactTemplate[] = [\n {\n condition: (s) => s.summary.longestSession.duration > 148, // Inception length\n generate: (s) => {\n const times = Math.round(s.summary.longestSession.duration / 148);\n return `Your longest session is ~${times}x longer than the movie Inception`;\n },\n },\n {\n condition: (s) => s.summary.totalTokens > 587287, // War and Peace word count\n generate: (s) => {\n const times = Math.round(s.summary.totalTokens / 587287);\n return `You've used ${times}x more tokens than words in War and Peace`;\n },\n },\n {\n condition: (s) => s.summary.currentStreak >= 7,\n generate: (s) => \n `Your ${s.summary.currentStreak}-day streak is longer than most New Year resolutions`,\n },\n {\n condition: (s) => s.summary.peakHour >= 22 || s.summary.peakHour <= 4,\n generate: () => `You're a night owl coder - peak activity is after dark`,\n },\n {\n condition: (s) => s.summary.peakHour >= 5 && s.summary.peakHour <= 8,\n generate: () => `Early bird catches the bugs - you code best at dawn`,\n },\n // More fun facts...\n];\n\nexport function generateFunFact(stats: StatsResult): string {\n const applicable = FUN_FACTS.filter((f) => f.condition(stats));\n if (applicable.length === 0) {\n return `You've had ${stats.summary.totalSessions} coding sessions - keep going!`;\n }\n const random = applicable[Math.floor(Math.random() * applicable.length)];\n return random.generate(stats);\n}\n```\n\n### 4. Renderer (`src/render/`)\n\n#### Renderer Interface\n\n```typescript\n// src/render/types.ts\n\nexport interface RenderContext {\n width: number;\n height: number;\n colors: boolean;\n}\n\nexport interface Renderer {\n render(stats: StatsResult, view: \"overview\" | \"models\"): string;\n}\n```\n\n#### Heatmap Component\n\n```typescript\n// src/render/components/heatmap.ts\n\nconst INTENSITY_CHARS = [\" \", \"░\", \"▒\", \"▓\", \"█\"];\nconst DAYS = [\"\", \"Mon\", \"\", \"Wed\", \"\", \"Fri\", \"\"];\nconst MONTHS = [\"Jan\", \"Feb\", \"Mar\", \"Apr\", \"May\", \"Jun\", \n \"Jul\", \"Aug\", \"Sep\", \"Oct\", \"Nov\", \"Dec\"];\n\nexport function renderHeatmap(\n dailyActivity: DailyActivity[],\n options: { weeks: number; colors: boolean }\n): string[] {\n const lines: string[] = [];\n \n // Build activity map\n const activityMap = new Map<string, number>();\n dailyActivity.forEach((d) => {\n activityMap.set(d.date, d.sessionCount);\n });\n\n // Calculate intensity thresholds\n const maxActivity = Math.max(...dailyActivity.map((d) => d.sessionCount), 1);\n const getIntensity = (count: number): number => {\n if (count === 0) return 0;\n return Math.min(4, Math.ceil((count / maxActivity) * 4));\n };\n\n // Generate header (months)\n const headerLine = \" \" + generateMonthHeader(options.weeks);\n lines.push(headerLine);\n\n // Generate each day row\n for (let dayOfWeek = 0; dayOfWeek < 7; dayOfWeek++) {\n let line = DAYS[dayOfWeek].padEnd(4);\n \n for (let week = 0; week < options.weeks; week++) {\n const date = getDateForWeekDay(week, dayOfWeek, options.weeks);\n const dateStr = formatDate(date);\n const count = activityMap.get(dateStr) || 0;\n const char = INTENSITY_CHARS[getIntensity(count)];\n line += char + \" \";\n }\n \n lines.push(line);\n }\n\n // Legend\n lines.push(\"\");\n lines.push(\" Less \" + INTENSITY_CHARS.slice(1).join(\" \") + \" More\");\n\n return lines;\n}\n```\n\n#### Stats Dashboard Component\n\n```typescript\n// src/render/components/dashboard.ts\n\nexport function renderDashboard(summary: StatsResult[\"summary\"]): string[] {\n const lines: string[] = [];\n \n const formatDuration = (minutes: number): string => {\n const days = Math.floor(minutes / 1440);\n const hours = Math.floor((minutes % 1440) / 60);\n const mins = minutes % 60;\n \n const parts = [];\n if (days > 0) parts.push(`${days}d`);\n if (hours > 0) parts.push(`${hours}h`);\n if (mins > 0) parts.push(`${mins}m`);\n return parts.join(\" \") || \"0m\";\n };\n\n const formatNumber = (n: number): string => {\n if (n >= 1000000) return `${(n / 1000000).toFixed(1)}m`;\n if (n >= 1000) return `${(n / 1000).toFixed(1)}k`;\n return n.toString();\n };\n\n const leftCol = [\n `Favorite model: ${summary.favoriteModel}`,\n \"\",\n `Sessions: ${summary.totalSessions}`,\n `Current streak: ${summary.currentStreak} days`,\n `Active days: ${summary.activeDays}`,\n ];\n\n const rightCol = [\n `Total tokens: ${formatNumber(summary.totalTokens)}`,\n \"\",\n `Longest session: ${formatDuration(summary.longestSession.duration)}`,\n `Longest streak: ${summary.longestStreak} days`,\n `Peak hour: ${summary.peakHour}:00-${summary.peakHour + 1}:00`,\n ];\n\n // Combine columns\n const maxLeftWidth = Math.max(...leftCol.map((l) => l.length));\n const padding = 4;\n\n for (let i = 0; i < leftCol.length; i++) {\n lines.push(\n leftCol[i].padEnd(maxLeftWidth + padding) + rightCol[i]\n );\n }\n\n return lines;\n}\n```\n\n#### Model Usage Bar Chart\n\n```typescript\n// src/render/components/models.ts\n\nexport function renderModelUsage(\n modelUsage: ModelUsage[],\n options: { width: number }\n): string[] {\n const lines: string[] = [];\n const barWidth = options.width - 40; // Space for label and percentage\n\n const sorted = [...modelUsage].sort((a, b) => b.percentage - a.percentage);\n\n for (const model of sorted.slice(0, 5)) {\n const filled = Math.round((model.percentage / 100) * barWidth);\n const empty = barWidth - filled;\n const bar = \"█\".repeat(filled) + \"░\".repeat(empty);\n const label = model.model.padEnd(28);\n const pct = `${Math.round(model.percentage)}%`.padStart(4);\n \n lines.push(` ${label} ${bar} ${pct}`);\n }\n\n return lines;\n}\n```\n\n#### Main Renderer\n\n```typescript\n// src/render/index.ts\n\nimport { renderHeatmap } from \"./components/heatmap\";\nimport { renderDashboard } from \"./components/dashboard\";\nimport { renderModelUsage } from \"./components/models\";\n\nexport class StatsRenderer implements Renderer {\n constructor(private context: RenderContext) {}\n\n render(stats: StatsResult, view: \"overview\" | \"models\"): string {\n const lines: string[] = [];\n \n // Header\n lines.push(\"\");\n const tabs = view === \"overview\" \n ? \" [Overview] Models (tab to cycle)\"\n : \" Overview [Models] (tab to cycle)\";\n lines.push(tabs);\n lines.push(\"\");\n\n if (view === \"overview\") {\n // Heatmap\n const heatmap = renderHeatmap(stats.dailyActivity, {\n weeks: 52,\n colors: this.context.colors,\n });\n lines.push(...heatmap);\n lines.push(\"\");\n\n // Dashboard stats\n const dashboard = renderDashboard(stats.summary);\n lines.push(...dashboard);\n lines.push(\"\");\n\n // Fun fact\n lines.push(` ${stats.funFact}`);\n lines.push(` Stats from the last ${stats.period.days} days`);\n } else {\n // Model breakdown\n const models = renderModelUsage(stats.modelUsage, {\n width: this.context.width,\n });\n lines.push(...models);\n }\n\n lines.push(\"\");\n return lines.join(\"\\n\");\n }\n}\n```\n\n### 5. Command Handler (`src/commands/`)\n\n```typescript\n// src/commands/stats.ts\n\nimport { z } from \"zod\";\nimport type { ToolExecuteParams } from \"opencode\";\nimport { StatsEngine } from \"../stats/engine\";\nimport { StatsRenderer } from \"../render\";\n\nexport class StatsCommand {\n constructor(private engine: StatsEngine) {}\n\n async execute(params: ToolExecuteParams<{\n period?: \"week\" | \"month\" | \"year\" | \"all\";\n view?: \"overview\" | \"models\";\n }>) {\n const { period = \"month\", view = \"overview\" } = params.input;\n\n try {\n const stats = await this.engine.computeStats({ period });\n \n const renderer = new StatsRenderer({\n width: process.stdout.columns || 80,\n height: process.stdout.rows || 24,\n colors: process.stdout.isTTY ?? false,\n });\n\n const output = renderer.render(stats, view);\n \n return {\n content: output,\n metadata: {\n totalSessions: stats.summary.totalSessions,\n period: stats.period,\n },\n };\n } catch (error) {\n return {\n content: `Error computing stats: ${error.message}`,\n isError: true,\n };\n }\n }\n}\n```\n\n---\n\n## Data Flow\n\n```\n┌──────────────────────────────────────────────────────────────────┐\n│ User invokes /stats │\n└──────────────────────────────────────────────────────────────────┘\n │\n ▼\n┌──────────────────────────────────────────────────────────────────┐\n│ StatsCommand.execute() │\n│ - Parse parameters (period, view) │\n│ - Validate inputs │\n└──────────────────────────────────────────────────────────────────┘\n │\n ▼\n┌──────────────────────────────────────────────────────────────────┐\n│ StatsEngine.computeStats() │\n│ - Fetch session data from provider │\n│ - Compute summary statistics │\n│ - Calculate streaks │\n│ - Aggregate daily activity │\n│ - Compute model usage │\n│ - Generate fun fact │\n└──────────────────────────────────────────────────────────────────┘\n │\n ▼\n┌──────────────────────────────────────────────────────────────────┐\n│ SessionDataProvider.getSessions() │\n│ - Access OpenCode session storage │\n│ - Filter by date range │\n│ - Return session summaries │\n└──────────────────────────────────────────────────────────────────┘\n │\n ▼\n┌──────────────────────────────────────────────────────────────────┐\n│ StatsRenderer.render() │\n│ - Select view (overview/models) │\n│ - Compose components │\n│ - Generate ASCII output │\n└──────────────────────────────────────────────────────────────────┘\n │\n ▼\n┌──────────────────────────────────────────────────────────────────┐\n│ Display output to user │\n└──────────────────────────────────────────────────────────────────┘\n```\n\n---\n\n## File Structure\n\n```\nopencode-stats/\n├── index.ts # Plugin entry point\n├── package.json # Dependencies and metadata\n├── tsconfig.json # TypeScript configuration\n├── README.md # Plugin documentation\n│\n├── src/\n│ ├── commands/\n│ │ └── stats.ts # Slash command handler\n│ │\n│ ├── data/\n│ │ ├── sessions.ts # Session data provider\n│ │ └── models.ts # Data models/interfaces\n│ │\n│ ├── stats/\n│ │ ├── engine.ts # Main statistics engine\n│ │ ├── streaks.ts # Streak calculation\n│ │ ├── funfacts.ts # Fun fact generator\n│ │ └── aggregators.ts # Data aggregation utilities\n│ │\n│ └── render/\n│ ├── index.ts # Main renderer\n│ ├── types.ts # Render interfaces\n│ └── components/\n│ ├── heatmap.ts # Activity heatmap\n│ ├── dashboard.ts # Stats dashboard\n│ ├── models.ts # Model usage chart\n│ └── box.ts # Box drawing utilities\n│\n└── tests/\n ├── stats/\n │ ├── engine.test.ts\n │ └── streaks.test.ts\n └── render/\n └── components.test.ts\n```\n\n---\n\n## Dependencies\n\n```json\n{\n \"name\": \"opencode-stats\",\n \"version\": \"1.0.0\",\n \"type\": \"module\",\n \"main\": \"index.ts\",\n \"dependencies\": {\n \"zod\": \"^3.22.0\"\n },\n \"devDependencies\": {\n \"@types/bun\": \"latest\",\n \"typescript\": \"^5.0.0\"\n },\n \"peerDependencies\": {\n \"@opencode-ai/plugin\": \"*\",\n \"@opencode-ai/sdk\": \"*\"\n }\n}\n```\n\n---\n\n## Configuration\n\n### Plugin Configuration (`opencode.json`)\n\n```json\n{\n \"plugins\": {\n \"opencode-stats\": {\n \"enabled\": true,\n \"options\": {\n \"defaultPeriod\": \"month\",\n \"cacheEnabled\": true,\n \"cacheTTL\": 300\n }\n }\n }\n}\n```\n\n### Environment Variables\n\n| Variable | Description | Default |\n|----------|-------------|---------|\n| `OPENCODE_STATS_CACHE` | Enable caching | `true` |\n| `OPENCODE_STATS_CACHE_TTL` | Cache TTL in seconds | `300` |\n\n---\n\n## Testing Strategy\n\n### Unit Tests\n\n- Statistics calculations (streaks, aggregations)\n- Render component output\n- Fun fact generation\n\n### Integration Tests\n\n- Full stats computation with mock data\n- Command execution flow\n\n### Manual Testing\n\n- Various terminal sizes\n- Color/no-color modes\n- Large session histories\n\n---\n\n## Performance Considerations\n\n### Caching Strategy\n\n```typescript\ninterface CacheEntry {\n stats: StatsResult;\n computedAt: Date;\n sessionCount: number;\n}\n\nclass StatsCache {\n private cache: Map<string, CacheEntry> = new Map();\n private ttl: number;\n\n constructor(ttlSeconds: number = 300) {\n this.ttl = ttlSeconds * 1000;\n }\n\n get(period: string): StatsResult | null {\n const entry = this.cache.get(period);\n if (!entry) return null;\n \n const age = Date.now() - entry.computedAt.getTime();\n if (age > this.ttl) {\n this.cache.delete(period);\n return null;\n }\n \n return entry.stats;\n }\n\n set(period: string, stats: StatsResult, sessionCount: number): void {\n this.cache.set(period, {\n stats,\n computedAt: new Date(),\n sessionCount,\n });\n }\n\n invalidate(): void {\n this.cache.clear();\n }\n}\n```\n\n### Lazy Loading\n\n- Load only session summaries for initial stats\n- Fetch full session data only when needed (e.g., longest session details)\n\n---\n\n## Security Considerations\n\n1. **Read-only access:** Plugin only reads session data, never writes\n2. **Local processing:** All computation happens locally\n3. **No network calls:** No telemetry or external API calls\n4. **Sandboxed execution:** Runs within OpenCode's plugin sandbox\n\n---\n\n## Future Extensibility\n\n### Planned Extensions\n\n1. **Export API:** Allow other plugins to access stats\n2. **Webhook integration:** Post stats to external services\n3. **Custom metrics:** User-defined stat tracking\n4. **Themes:** Customizable color schemes\n\n### Extension Points\n\n```typescript\n// Future: Plugin extension API\ninterface StatsExtension {\n // Add custom metrics\n metrics?: CustomMetric[];\n \n // Add custom fun facts\n funFacts?: FunFactTemplate[];\n \n // Add custom views\n views?: CustomView[];\n}\n```\n\n---\n\n## Resolved Questions\n\nBased on the actual OpenCode plugin API (`@opencode-ai/plugin`):\n\n### 1. Session Data Access - RESOLVED\n\n**How does OpenCode expose session list to plugins?**\n- Via the SDK client: `input.client.session.list()` and `input.client.session.messages(sessionId)`\n\n**Schema of session/message data:**\n- Sessions have: `id`, `title`, `createdAt`, `updatedAt`\n- Messages have: `id`, `sessionID`, `role`, `createdAt`, `info` (with model, tokens, cost)\n- Parts have: `id`, `type`, `content`\n\n### 2. Rendering - RESOLVED\n\n**Can plugins render output?**\n- Yes, via custom tools. The `execute` function returns `{ title, output, metadata }`\n- The `output` string is displayed to the user\n- For tab switching, we'd need to implement as separate tool calls or use the experimental hooks\n\n**Keyboard input:**\n- Not directly available in tool output\n- Alternative: Use multiple tool parameters (e.g., `/stats view=models`)\n\n### 3. Token Counting - RESOLVED\n\n**Is token count available per message?**\n- Yes! In `message.info.tokens`:\n - `input`: Input tokens\n - `output`: Output tokens\n - `reasoning`: Reasoning tokens (if applicable)\n - `cache.read` / `cache.write`: Cache tokens\n- Also `message.info.cost` for cost tracking\n\n### 4. Plugin Lifecycle - RESOLVED\n\n**When is the plugin loaded?**\n- Plugin function is called once when OpenCode starts\n- Returns hooks that are registered for the session lifetime\n\n**Can we persist cache?**\n- Yes, plugins can maintain in-memory state\n- For persistent storage, use file system via the Bun shell (`input.$`)\n\n### 5. Available Hooks Summary\n\n| Hook | Purpose | Use in Stats Plugin |\n|------|---------|---------------------|\n| `tool` | Define custom tools | `/stats` command |\n| `event` | Listen to events | Cache invalidation |\n| `chat.message` | Intercept messages | Could track in real-time |\n| `tool.execute.after` | Modify tool output | Could enhance other tool outputs with stats |\n| `experimental.session.compacting` | Add context | Could inject usage summary |\n", | |
| "after": "# Architecture Document: OpenCode Stats Plugin\n\n## Overview\n\nThis document describes the technical architecture of the `opencode-stats` plugin, a \"Spotify Wrapped\"-style statistics visualization tool for OpenCode.\n\n---\n\n## Plugin Architecture\n\n### OpenCode Plugin System\n\nOpenCode plugins are JavaScript/TypeScript modules that run in the Bun runtime. They follow an async function pattern that receives a `PluginInput` and returns `Hooks`.\n\n#### Plugin Input (What plugins receive)\n\n```typescript\n// From @opencode-ai/plugin\nexport type PluginInput = {\n client: ReturnType<typeof createOpencodeClient> // SDK client for API access\n project: Project // Current project info\n directory: string // Project directory\n worktree: string // Git worktree path\n $: BunShell // Bun shell for running commands\n}\n\nexport type Plugin = (input: PluginInput) => Promise<Hooks>\n```\n\n#### Available Hooks\n\n```typescript\nexport interface Hooks {\n // Listen to OpenCode events (session created, message created, etc.)\n event?: (input: { event: Event }) => Promise<void>\n \n // Modify OpenCode configuration\n config?: (input: Config) => Promise<void>\n \n // Define custom tools (slash commands)\n tool?: {\n [key: string]: ToolDefinition\n }\n \n // Custom authentication providers\n auth?: AuthHook\n \n // Called when a new message is received\n \"chat.message\"?: (\n input: { sessionID: string; agent?: string; model?: { providerID: string; modelID: string }; messageID?: string },\n output: { message: UserMessage; parts: Part[] },\n ) => Promise<void>\n \n // Modify parameters sent to LLM\n \"chat.params\"?: (\n input: { sessionID: string; agent: string; model: Model; provider: ProviderContext; message: UserMessage },\n output: { temperature: number; topP: number; topK: number; options: Record<string, any> },\n ) => Promise<void>\n \n // Intercept permission requests\n \"permission.ask\"?: (input: Permission, output: { status: \"ask\" | \"deny\" | \"allow\" }) => Promise<void>\n \n // Before tool execution - can modify args\n \"tool.execute.before\"?: (\n input: { tool: string; sessionID: string; callID: string },\n output: { args: any },\n ) => Promise<void>\n \n // After tool execution - can modify output\n \"tool.execute.after\"?: (\n input: { tool: string; sessionID: string; callID: string },\n output: { title: string; output: string; metadata: any },\n ) => Promise<void>\n \n // Transform chat messages (experimental)\n \"experimental.chat.messages.transform\"?: (\n input: {},\n output: { messages: { info: Message; parts: Part[] }[] },\n ) => Promise<void>\n \n // Transform system prompt (experimental)\n \"experimental.chat.system.transform\"?: (\n input: {},\n output: { system: string[] },\n ) => Promise<void>\n \n // Add context during session compaction (experimental)\n \"experimental.session.compacting\"?: (\n input: { sessionID: string },\n output: { context: string[] },\n ) => Promise<void>\n \n // Transform completed text (experimental)\n \"experimental.text.complete\"?: (\n input: { sessionID: string; messageID: string; partID: string },\n output: { text: string },\n ) => Promise<void>\n}\n```\n\n### Plugin Location\n\n```\n.opencode/\n└── plugin/\n └── opencode-stats/\n ├── index.ts # Main plugin entry\n ├── package.json # Dependencies\n └── src/\n ├── stats/ # Statistics computation\n ├── render/ # TUI rendering\n └── data/ # Data access layer\n```\n\n---\n\n## System Architecture\n\n```\n┌─────────────────────────────────────────────────────────────────┐\n│ OpenCode Host │\n├─────────────────────────────────────────────────────────────────┤\n│ │\n│ ┌─────────────────────────────────────────────────────────┐ │\n│ │ opencode-stats Plugin │ │\n│ ├─────────────────────────────────────────────────────────┤ │\n│ │ │ │\n│ │ ┌─────────────┐ ┌─────────────┐ ┌─────────────────┐ │ │\n│ │ │ Command │ │ Stats │ │ Renderer │ │ │\n│ │ │ Handler │──│ Engine │──│ (TUI) │ │ │\n│ │ └─────────────┘ └─────────────┘ └─────────────────┘ │ │\n│ │ │ │ │ │ │\n│ │ ▼ ▼ ▼ │ │\n│ │ ┌─────────────┐ ┌─────────────┐ ┌─────────────────┐ │ │\n│ │ │ Slash │ │ Data │ │ Components │ │ │\n│ │ │ Command │ │ Layer │ │ Library │ │ │\n│ │ └─────────────┘ └─────────────┘ └─────────────────┘ │ │\n│ │ │ │ │\n│ └──────────────────────────│─────────────────────────────┘ │\n│ │ │\n│ ▼ │\n│ ┌─────────────────────────────────────────────────────────┐ │\n│ │ OpenCode Session Storage │ │\n│ │ (SQLite / JSON) │ │\n│ └─────────────────────────────────────────────────────────┘ │\n│ │\n└─────────────────────────────────────────────────────────────────┘\n```\n\n---\n\n## Component Design\n\n### 1. Plugin Entry Point (`index.ts`)\n\n```typescript\nimport type { Plugin, Hooks, ToolDefinition } from \"@opencode-ai/plugin\";\nimport { z } from \"zod\";\nimport { StatsEngine } from \"./src/stats/engine\";\nimport { SessionDataProvider } from \"./src/data/sessions\";\nimport { StatsRenderer } from \"./src/render\";\n\nconst plugin: Plugin = async (input) => {\n const { client, project, directory } = input;\n \n // Initialize data provider with SDK client\n const dataProvider = new SessionDataProvider(client);\n const statsEngine = new StatsEngine(dataProvider);\n\n const hooks: Hooks = {\n // Register the /stats custom tool (slash command)\n tool: {\n stats: {\n description: \"View your OpenCode usage statistics (Wrapped-style)\",\n parameters: z.object({\n period: z.enum([\"week\", \"month\", \"year\", \"all\"]).optional().default(\"month\"),\n view: z.enum([\"overview\", \"models\"]).optional().default(\"overview\"),\n }),\n async execute(args) {\n const { period, view } = args;\n \n try {\n const stats = await statsEngine.computeStats({ period });\n \n const renderer = new StatsRenderer({\n width: process.stdout.columns || 80,\n height: process.stdout.rows || 24,\n colors: process.stdout.isTTY ?? false,\n });\n\n const output = renderer.render(stats, view);\n \n return {\n title: \"OpenCode Stats\",\n output,\n metadata: {\n totalSessions: stats.summary.totalSessions,\n period: stats.period,\n },\n };\n } catch (error) {\n return {\n title: \"OpenCode Stats Error\",\n output: `Error computing stats: ${error.message}`,\n metadata: { error: true },\n };\n }\n },\n },\n },\n\n // Listen to events for real-time stats updates (optional)\n async event({ event }) {\n // Could invalidate cache when new sessions/messages are created\n if (event.type === \"session.created\" || event.type === \"message.created\") {\n statsEngine.invalidateCache();\n }\n },\n };\n\n return hooks;\n};\n\nexport default plugin;\n```\n\n### 2. Data Layer (`src/data/`)\n\n#### Session Data Provider\n\nResponsible for accessing OpenCode's session storage via the SDK client.\n\n```typescript\n// src/data/sessions.ts\n\nimport type { createOpencodeClient } from \"@opencode-ai/sdk\";\n\n// Types based on OpenCode SDK\nexport interface Session {\n id: string;\n title?: string;\n createdAt: string;\n updatedAt: string;\n}\n\nexport interface Message {\n id: string;\n sessionID: string;\n role: \"user\" | \"assistant\" | \"system\";\n createdAt: string;\n info: {\n model?: {\n providerID: string;\n modelID: string;\n };\n tokens?: {\n input: number;\n output: number;\n reasoning?: number;\n cache?: {\n read: number;\n write: number;\n };\n };\n cost?: number;\n };\n}\n\nexport interface Part {\n id: string;\n type: \"text\" | \"tool-invocation\" | \"tool-result\" | \"file\" | \"step-start\";\n content?: string;\n}\n\ntype Client = ReturnType<typeof createOpencodeClient>;\n\nexport class SessionDataProvider {\n constructor(private client: Client) {}\n\n async getSessions(options?: {\n from?: Date;\n to?: Date;\n limit?: number;\n }): Promise<Session[]> {\n // Use the SDK client to fetch sessions\n const sessions = await this.client.session.list();\n \n // Filter by date if specified\n let filtered = sessions;\n if (options?.from) {\n filtered = filtered.filter(s => new Date(s.createdAt) >= options.from!);\n }\n if (options?.to) {\n filtered = filtered.filter(s => new Date(s.createdAt) <= options.to!);\n }\n if (options?.limit) {\n filtered = filtered.slice(0, options.limit);\n }\n \n return filtered;\n }\n\n async getSessionMessages(sessionId: string): Promise<{ info: Message; parts: Part[] }[]> {\n // Fetch all messages for a session\n return await this.client.session.messages(sessionId);\n }\n\n async getAllSessionsWithMessages(options?: {\n from?: Date;\n to?: Date;\n }): Promise<Array<{ session: Session; messages: { info: Message; parts: Part[] }[] }>> {\n const sessions = await this.getSessions(options);\n \n // Fetch messages for each session in parallel\n const results = await Promise.all(\n sessions.map(async (session) => ({\n session,\n messages: await this.getSessionMessages(session.id),\n }))\n );\n \n return results;\n }\n}\n```\n\n#### Data Models\n\n```typescript\n// src/data/models.ts\n\nexport interface SessionSummary {\n id: string;\n startTime: Date;\n endTime: Date;\n messageCount: number;\n totalTokens: number;\n models: string[];\n}\n\nexport interface DailyActivity {\n date: string; // YYYY-MM-DD\n sessionCount: number;\n totalTokens: number;\n totalDuration: number; // minutes\n}\n\nexport interface ModelUsage {\n model: string;\n sessionCount: number;\n messageCount: number;\n totalTokens: number;\n percentage: number;\n}\n```\n\n### 3. Statistics Engine (`src/stats/`)\n\n#### Core Engine\n\n```typescript\n// src/stats/engine.ts\n\nimport { SessionDataProvider, Session, Message, Part } from \"../data/sessions\";\nimport { calculateStreaks } from \"./streaks\";\nimport { generateFunFact } from \"./funfacts\";\n\nexport interface StatsResult {\n period: {\n start: Date;\n end: Date;\n days: number;\n };\n summary: {\n totalSessions: number;\n totalTokens: number;\n totalMessages: number;\n activeDays: number;\n currentStreak: number;\n longestStreak: number;\n longestSession: {\n id: string;\n duration: number; // minutes\n };\n peakHour: number; // 0-23\n favoriteModel: string;\n totalCost: number;\n };\n dailyActivity: DailyActivity[];\n modelUsage: ModelUsage[];\n funFact: string;\n}\n\nexport interface DailyActivity {\n date: string; // YYYY-MM-DD\n sessionCount: number;\n totalTokens: number;\n messageCount: number;\n}\n\nexport interface ModelUsage {\n modelID: string;\n providerID: string;\n displayName: string;\n sessionCount: number;\n messageCount: number;\n totalTokens: number;\n percentage: number;\n}\n\ntype SessionWithMessages = {\n session: Session;\n messages: { info: Message; parts: Part[] }[];\n};\n\nexport class StatsEngine {\n private cache: Map<string, { result: StatsResult; timestamp: number }> = new Map();\n private cacheTTL = 5 * 60 * 1000; // 5 minutes\n\n constructor(private dataProvider: SessionDataProvider) {}\n\n invalidateCache(): void {\n this.cache.clear();\n }\n\n async computeStats(options: {\n period: \"week\" | \"month\" | \"year\" | \"all\";\n }): Promise<StatsResult> {\n // Check cache\n const cached = this.cache.get(options.period);\n if (cached && Date.now() - cached.timestamp < this.cacheTTL) {\n return cached.result;\n }\n\n const from = this.getPeriodStart(options.period);\n const sessionsWithMessages = await this.dataProvider.getAllSessionsWithMessages({ from });\n\n const result: StatsResult = {\n period: this.computePeriod(sessionsWithMessages, options.period, from),\n summary: this.computeSummary(sessionsWithMessages),\n dailyActivity: this.computeDailyActivity(sessionsWithMessages),\n modelUsage: this.computeModelUsage(sessionsWithMessages),\n funFact: \"\", // Computed after other stats\n };\n\n result.funFact = generateFunFact(result);\n\n // Cache result\n this.cache.set(options.period, { result, timestamp: Date.now() });\n\n return result;\n }\n\n private getPeriodStart(period: string): Date | undefined {\n const now = new Date();\n switch (period) {\n case \"week\":\n return new Date(now.getTime() - 7 * 24 * 60 * 60 * 1000);\n case \"month\":\n return new Date(now.getTime() - 30 * 24 * 60 * 60 * 1000);\n case \"year\":\n return new Date(now.getTime() - 365 * 24 * 60 * 60 * 1000);\n default:\n return undefined; // \"all\" - no filter\n }\n }\n\n private computePeriod(\n sessions: SessionWithMessages[],\n period: string,\n from?: Date\n ): StatsResult[\"period\"] {\n const now = new Date();\n const start = from || (sessions.length > 0 \n ? new Date(Math.min(...sessions.map(s => new Date(s.session.createdAt).getTime())))\n : now);\n \n return {\n start,\n end: now,\n days: Math.ceil((now.getTime() - start.getTime()) / (24 * 60 * 60 * 1000)),\n };\n }\n\n private computeSummary(sessions: SessionWithMessages[]): StatsResult[\"summary\"] {\n let totalTokens = 0;\n let totalMessages = 0;\n let totalCost = 0;\n const hourCounts = new Array(24).fill(0);\n const modelCounts = new Map<string, number>();\n const activeDaysSet = new Set<string>();\n \n let longestSession = { id: \"\", duration: 0 };\n\n for (const { session, messages } of sessions) {\n // Track active days\n const sessionDate = new Date(session.createdAt).toISOString().split(\"T\")[0];\n activeDaysSet.add(sessionDate);\n\n // Calculate session duration\n if (messages.length > 0) {\n const firstMsg = new Date(messages[0].info.createdAt);\n const lastMsg = new Date(messages[messages.length - 1].info.createdAt);\n const duration = (lastMsg.getTime() - firstMsg.getTime()) / (1000 * 60); // minutes\n \n if (duration > longestSession.duration) {\n longestSession = { id: session.id, duration };\n }\n }\n\n for (const { info } of messages) {\n totalMessages++;\n \n // Token counting from message.info.tokens\n if (info.tokens) {\n totalTokens += (info.tokens.input || 0) + (info.tokens.output || 0);\n if (info.tokens.reasoning) totalTokens += info.tokens.reasoning;\n }\n \n // Cost tracking\n if (info.cost) {\n totalCost += info.cost;\n }\n\n // Peak hour\n const hour = new Date(info.createdAt).getHours();\n hourCounts[hour]++;\n\n // Model usage\n if (info.model) {\n const modelKey = `${info.model.providerID}/${info.model.modelID}`;\n modelCounts.set(modelKey, (modelCounts.get(modelKey) || 0) + 1);\n }\n }\n }\n\n // Find peak hour\n const peakHour = hourCounts.indexOf(Math.max(...hourCounts));\n\n // Find favorite model\n let favoriteModel = \"Unknown\";\n let maxCount = 0;\n for (const [model, count] of modelCounts) {\n if (count > maxCount) {\n maxCount = count;\n favoriteModel = model.split(\"/\")[1] || model; // Just model name\n }\n }\n\n // Calculate streaks\n const dailyActivity = this.computeDailyActivity(sessions);\n const streaks = calculateStreaks(dailyActivity);\n\n return {\n totalSessions: sessions.length,\n totalTokens,\n totalMessages,\n activeDays: activeDaysSet.size,\n currentStreak: streaks.current,\n longestStreak: streaks.longest,\n longestSession,\n peakHour,\n favoriteModel,\n totalCost,\n };\n }\n\n private computeDailyActivity(sessions: SessionWithMessages[]): DailyActivity[] {\n const dailyMap = new Map<string, DailyActivity>();\n\n for (const { session, messages } of sessions) {\n const date = new Date(session.createdAt).toISOString().split(\"T\")[0];\n \n const existing = dailyMap.get(date) || {\n date,\n sessionCount: 0,\n totalTokens: 0,\n messageCount: 0,\n };\n\n existing.sessionCount++;\n existing.messageCount += messages.length;\n \n for (const { info } of messages) {\n if (info.tokens) {\n existing.totalTokens += (info.tokens.input || 0) + (info.tokens.output || 0);\n }\n }\n\n dailyMap.set(date, existing);\n }\n\n return Array.from(dailyMap.values()).sort((a, b) => a.date.localeCompare(b.date));\n }\n\n private computeModelUsage(sessions: SessionWithMessages[]): ModelUsage[] {\n const modelMap = new Map<string, ModelUsage>();\n let totalMsgs = 0;\n\n for (const { session, messages } of sessions) {\n const sessionModels = new Set<string>();\n \n for (const { info } of messages) {\n if (info.model) {\n const key = `${info.model.providerID}/${info.model.modelID}`;\n sessionModels.add(key);\n \n const existing = modelMap.get(key) || {\n modelID: info.model.modelID,\n providerID: info.model.providerID,\n displayName: info.model.modelID,\n sessionCount: 0,\n messageCount: 0,\n totalTokens: 0,\n percentage: 0,\n };\n\n existing.messageCount++;\n totalMsgs++;\n \n if (info.tokens) {\n existing.totalTokens += (info.tokens.input || 0) + (info.tokens.output || 0);\n }\n\n modelMap.set(key, existing);\n }\n }\n\n // Count unique sessions per model\n for (const key of sessionModels) {\n const model = modelMap.get(key);\n if (model) model.sessionCount++;\n }\n }\n\n // Calculate percentages\n const models = Array.from(modelMap.values());\n for (const model of models) {\n model.percentage = totalMsgs > 0 ? (model.messageCount / totalMsgs) * 100 : 0;\n }\n\n return models.sort((a, b) => b.percentage - a.percentage);\n }\n}\n```\n\n#### Streak Calculator\n\n```typescript\n// src/stats/streaks.ts\n\nexport interface StreakResult {\n current: number;\n longest: number;\n currentStart?: Date;\n longestStart?: Date;\n longestEnd?: Date;\n}\n\nexport function calculateStreaks(dailyActivity: DailyActivity[]): StreakResult {\n // Sort by date\n const sorted = [...dailyActivity].sort(\n (a, b) => new Date(a.date).getTime() - new Date(b.date).getTime()\n );\n\n let current = 0;\n let longest = 0;\n let streak = 0;\n let prevDate: Date | null = null;\n\n for (const day of sorted) {\n const date = new Date(day.date);\n if (prevDate && isConsecutiveDay(prevDate, date)) {\n streak++;\n } else {\n streak = 1;\n }\n\n if (streak > longest) longest = streak;\n prevDate = date;\n }\n\n // Check if streak continues to today\n const today = new Date();\n today.setHours(0, 0, 0, 0);\n \n if (prevDate && isConsecutiveDay(prevDate, today)) {\n current = streak;\n } else if (prevDate?.getTime() === today.getTime()) {\n current = streak;\n }\n\n return { current, longest };\n}\n\nfunction isConsecutiveDay(a: Date, b: Date): boolean {\n const diff = b.getTime() - a.getTime();\n return diff === 24 * 60 * 60 * 1000;\n}\n```\n\n#### Fun Facts Generator\n\n```typescript\n// src/stats/funfacts.ts\n\ninterface FunFactTemplate {\n condition: (stats: StatsResult) => boolean;\n generate: (stats: StatsResult) => string;\n}\n\nconst FUN_FACTS: FunFactTemplate[] = [\n {\n condition: (s) => s.summary.longestSession.duration > 148, // Inception length\n generate: (s) => {\n const times = Math.round(s.summary.longestSession.duration / 148);\n return `Your longest session is ~${times}x longer than the movie Inception`;\n },\n },\n {\n condition: (s) => s.summary.totalTokens > 587287, // War and Peace word count\n generate: (s) => {\n const times = Math.round(s.summary.totalTokens / 587287);\n return `You've used ${times}x more tokens than words in War and Peace`;\n },\n },\n {\n condition: (s) => s.summary.currentStreak >= 7,\n generate: (s) => \n `Your ${s.summary.currentStreak}-day streak is longer than most New Year resolutions`,\n },\n {\n condition: (s) => s.summary.peakHour >= 22 || s.summary.peakHour <= 4,\n generate: () => `You're a night owl coder - peak activity is after dark`,\n },\n {\n condition: (s) => s.summary.peakHour >= 5 && s.summary.peakHour <= 8,\n generate: () => `Early bird catches the bugs - you code best at dawn`,\n },\n // More fun facts...\n];\n\nexport function generateFunFact(stats: StatsResult): string {\n const applicable = FUN_FACTS.filter((f) => f.condition(stats));\n if (applicable.length === 0) {\n return `You've had ${stats.summary.totalSessions} coding sessions - keep going!`;\n }\n const random = applicable[Math.floor(Math.random() * applicable.length)];\n return random.generate(stats);\n}\n```\n\n### 4. Renderer (`src/render/`)\n\n#### Renderer Interface\n\n```typescript\n// src/render/types.ts\n\nexport interface RenderContext {\n width: number;\n height: number;\n colors: boolean;\n}\n\nexport interface Renderer {\n render(stats: StatsResult, view: \"overview\" | \"models\"): string;\n}\n```\n\n#### Heatmap Component\n\n```typescript\n// src/render/components/heatmap.ts\n\nconst INTENSITY_CHARS = [\" \", \"░\", \"▒\", \"▓\", \"█\"];\nconst DAYS = [\"\", \"Mon\", \"\", \"Wed\", \"\", \"Fri\", \"\"];\nconst MONTHS = [\"Jan\", \"Feb\", \"Mar\", \"Apr\", \"May\", \"Jun\", \n \"Jul\", \"Aug\", \"Sep\", \"Oct\", \"Nov\", \"Dec\"];\n\nexport function renderHeatmap(\n dailyActivity: DailyActivity[],\n options: { weeks: number; colors: boolean }\n): string[] {\n const lines: string[] = [];\n \n // Build activity map\n const activityMap = new Map<string, number>();\n dailyActivity.forEach((d) => {\n activityMap.set(d.date, d.sessionCount);\n });\n\n // Calculate intensity thresholds\n const maxActivity = Math.max(...dailyActivity.map((d) => d.sessionCount), 1);\n const getIntensity = (count: number): number => {\n if (count === 0) return 0;\n return Math.min(4, Math.ceil((count / maxActivity) * 4));\n };\n\n // Generate header (months)\n const headerLine = \" \" + generateMonthHeader(options.weeks);\n lines.push(headerLine);\n\n // Generate each day row\n for (let dayOfWeek = 0; dayOfWeek < 7; dayOfWeek++) {\n let line = DAYS[dayOfWeek].padEnd(4);\n \n for (let week = 0; week < options.weeks; week++) {\n const date = getDateForWeekDay(week, dayOfWeek, options.weeks);\n const dateStr = formatDate(date);\n const count = activityMap.get(dateStr) || 0;\n const char = INTENSITY_CHARS[getIntensity(count)];\n line += char + \" \";\n }\n \n lines.push(line);\n }\n\n // Legend\n lines.push(\"\");\n lines.push(\" Less \" + INTENSITY_CHARS.slice(1).join(\" \") + \" More\");\n\n return lines;\n}\n```\n\n#### Stats Dashboard Component\n\n```typescript\n// src/render/components/dashboard.ts\n\nexport function renderDashboard(summary: StatsResult[\"summary\"]): string[] {\n const lines: string[] = [];\n \n const formatDuration = (minutes: number): string => {\n const days = Math.floor(minutes / 1440);\n const hours = Math.floor((minutes % 1440) / 60);\n const mins = minutes % 60;\n \n const parts = [];\n if (days > 0) parts.push(`${days}d`);\n if (hours > 0) parts.push(`${hours}h`);\n if (mins > 0) parts.push(`${mins}m`);\n return parts.join(\" \") || \"0m\";\n };\n\n const formatNumber = (n: number): string => {\n if (n >= 1000000) return `${(n / 1000000).toFixed(1)}m`;\n if (n >= 1000) return `${(n / 1000).toFixed(1)}k`;\n return n.toString();\n };\n\n const leftCol = [\n `Favorite model: ${summary.favoriteModel}`,\n \"\",\n `Sessions: ${summary.totalSessions}`,\n `Current streak: ${summary.currentStreak} days`,\n `Active days: ${summary.activeDays}`,\n ];\n\n const rightCol = [\n `Total tokens: ${formatNumber(summary.totalTokens)}`,\n \"\",\n `Longest session: ${formatDuration(summary.longestSession.duration)}`,\n `Longest streak: ${summary.longestStreak} days`,\n `Peak hour: ${summary.peakHour}:00-${summary.peakHour + 1}:00`,\n ];\n\n // Combine columns\n const maxLeftWidth = Math.max(...leftCol.map((l) => l.length));\n const padding = 4;\n\n for (let i = 0; i < leftCol.length; i++) {\n lines.push(\n leftCol[i].padEnd(maxLeftWidth + padding) + rightCol[i]\n );\n }\n\n return lines;\n}\n```\n\n#### Model Usage Bar Chart\n\n```typescript\n// src/render/components/models.ts\n\nexport function renderModelUsage(\n modelUsage: ModelUsage[],\n options: { width: number }\n): string[] {\n const lines: string[] = [];\n const barWidth = options.width - 40; // Space for label and percentage\n\n const sorted = [...modelUsage].sort((a, b) => b.percentage - a.percentage);\n\n for (const model of sorted.slice(0, 5)) {\n const filled = Math.round((model.percentage / 100) * barWidth);\n const empty = barWidth - filled;\n const bar = \"█\".repeat(filled) + \"░\".repeat(empty);\n const label = model.model.padEnd(28);\n const pct = `${Math.round(model.percentage)}%`.padStart(4);\n \n lines.push(` ${label} ${bar} ${pct}`);\n }\n\n return lines;\n}\n```\n\n#### Main Renderer\n\n```typescript\n// src/render/index.ts\n\nimport { renderHeatmap } from \"./components/heatmap\";\nimport { renderDashboard } from \"./components/dashboard\";\nimport { renderModelUsage } from \"./components/models\";\n\nexport class StatsRenderer implements Renderer {\n constructor(private context: RenderContext) {}\n\n render(stats: StatsResult, view: \"overview\" | \"models\"): string {\n const lines: string[] = [];\n \n // Header\n lines.push(\"\");\n const tabs = view === \"overview\" \n ? \" [Overview] Models (tab to cycle)\"\n : \" Overview [Models] (tab to cycle)\";\n lines.push(tabs);\n lines.push(\"\");\n\n if (view === \"overview\") {\n // Heatmap\n const heatmap = renderHeatmap(stats.dailyActivity, {\n weeks: 52,\n colors: this.context.colors,\n });\n lines.push(...heatmap);\n lines.push(\"\");\n\n // Dashboard stats\n const dashboard = renderDashboard(stats.summary);\n lines.push(...dashboard);\n lines.push(\"\");\n\n // Fun fact\n lines.push(` ${stats.funFact}`);\n lines.push(` Stats from the last ${stats.period.days} days`);\n } else {\n // Model breakdown\n const models = renderModelUsage(stats.modelUsage, {\n width: this.context.width,\n });\n lines.push(...models);\n }\n\n lines.push(\"\");\n return lines.join(\"\\n\");\n }\n}\n```\n\n### 5. Command Handler (`src/commands/`)\n\n```typescript\n// src/commands/stats.ts\n\nimport { z } from \"zod\";\nimport type { ToolExecuteParams } from \"opencode\";\nimport { StatsEngine } from \"../stats/engine\";\nimport { StatsRenderer } from \"../render\";\n\nexport class StatsCommand {\n constructor(private engine: StatsEngine) {}\n\n async execute(params: ToolExecuteParams<{\n period?: \"week\" | \"month\" | \"year\" | \"all\";\n view?: \"overview\" | \"models\";\n }>) {\n const { period = \"month\", view = \"overview\" } = params.input;\n\n try {\n const stats = await this.engine.computeStats({ period });\n \n const renderer = new StatsRenderer({\n width: process.stdout.columns || 80,\n height: process.stdout.rows || 24,\n colors: process.stdout.isTTY ?? false,\n });\n\n const output = renderer.render(stats, view);\n \n return {\n content: output,\n metadata: {\n totalSessions: stats.summary.totalSessions,\n period: stats.period,\n },\n };\n } catch (error) {\n return {\n content: `Error computing stats: ${error.message}`,\n isError: true,\n };\n }\n }\n}\n```\n\n---\n\n## Data Flow\n\n```\n┌──────────────────────────────────────────────────────────────────┐\n│ User invokes /stats │\n└──────────────────────────────────────────────────────────────────┘\n │\n ▼\n┌──────────────────────────────────────────────────────────────────┐\n│ StatsCommand.execute() │\n│ - Parse parameters (period, view) │\n│ - Validate inputs │\n└──────────────────────────────────────────────────────────────────┘\n │\n ▼\n┌──────────────────────────────────────────────────────────────────┐\n│ StatsEngine.computeStats() │\n│ - Fetch session data from provider │\n│ - Compute summary statistics │\n│ - Calculate streaks │\n│ - Aggregate daily activity │\n│ - Compute model usage │\n│ - Generate fun fact │\n└──────────────────────────────────────────────────────────────────┘\n │\n ▼\n┌──────────────────────────────────────────────────────────────────┐\n│ SessionDataProvider.getSessions() │\n│ - Access OpenCode session storage │\n│ - Filter by date range │\n│ - Return session summaries │\n└──────────────────────────────────────────────────────────────────┘\n │\n ▼\n┌──────────────────────────────────────────────────────────────────┐\n│ StatsRenderer.render() │\n│ - Select view (overview/models) │\n│ - Compose components │\n│ - Generate ASCII output │\n└──────────────────────────────────────────────────────────────────┘\n │\n ▼\n┌──────────────────────────────────────────────────────────────────┐\n│ Display output to user │\n└──────────────────────────────────────────────────────────────────┘\n```\n\n---\n\n## File Structure\n\n```\nopencode-stats/\n├── index.ts # Plugin entry point\n├── package.json # Dependencies and metadata\n├── tsconfig.json # TypeScript configuration\n├── README.md # Plugin documentation\n│\n├── src/\n│ ├── commands/\n│ │ └── stats.ts # Slash command handler\n│ │\n│ ├── data/\n│ │ ├── sessions.ts # Session data provider\n│ │ └── models.ts # Data models/interfaces\n│ │\n│ ├── stats/\n│ │ ├── engine.ts # Main statistics engine\n│ │ ├── streaks.ts # Streak calculation\n│ │ ├── funfacts.ts # Fun fact generator\n│ │ └── aggregators.ts # Data aggregation utilities\n│ │\n│ └── render/\n│ ├── index.ts # Main renderer\n│ ├── types.ts # Render interfaces\n│ └── components/\n│ ├── heatmap.ts # Activity heatmap\n│ ├── dashboard.ts # Stats dashboard\n│ ├── models.ts # Model usage chart\n│ └── box.ts # Box drawing utilities\n│\n└── tests/\n ├── stats/\n │ ├── engine.test.ts\n │ └── streaks.test.ts\n └── render/\n └── components.test.ts\n```\n\n---\n\n## Dependencies\n\n```json\n{\n \"name\": \"opencode-stats\",\n \"version\": \"1.0.0\",\n \"type\": \"module\",\n \"main\": \"index.ts\",\n \"dependencies\": {\n \"zod\": \"^3.22.0\"\n },\n \"devDependencies\": {\n \"@types/bun\": \"latest\",\n \"typescript\": \"^5.0.0\"\n },\n \"peerDependencies\": {\n \"@opencode-ai/plugin\": \"*\",\n \"@opencode-ai/sdk\": \"*\"\n }\n}\n```\n\n---\n\n## Configuration\n\n### Plugin Configuration (`opencode.json`)\n\n```json\n{\n \"plugins\": {\n \"opencode-stats\": {\n \"enabled\": true,\n \"options\": {\n \"defaultPeriod\": \"month\",\n \"cacheEnabled\": true,\n \"cacheTTL\": 300\n }\n }\n }\n}\n```\n\n### Environment Variables\n\n| Variable | Description | Default |\n|----------|-------------|---------|\n| `OPENCODE_STATS_CACHE` | Enable caching | `true` |\n| `OPENCODE_STATS_CACHE_TTL` | Cache TTL in seconds | `300` |\n\n---\n\n## Testing Strategy\n\n### Unit Tests\n\n- Statistics calculations (streaks, aggregations)\n- Render component output\n- Fun fact generation\n\n### Integration Tests\n\n- Full stats computation with mock data\n- Command execution flow\n\n### Manual Testing\n\n- Various terminal sizes\n- Color/no-color modes\n- Large session histories\n\n---\n\n## Performance Considerations\n\n### Caching Strategy\n\n```typescript\ninterface CacheEntry {\n stats: StatsResult;\n computedAt: Date;\n sessionCount: number;\n}\n\nclass StatsCache {\n private cache: Map<string, CacheEntry> = new Map();\n private ttl: number;\n\n constructor(ttlSeconds: number = 300) {\n this.ttl = ttlSeconds * 1000;\n }\n\n get(period: string): StatsResult | null {\n const entry = this.cache.get(period);\n if (!entry) return null;\n \n const age = Date.now() - entry.computedAt.getTime();\n if (age > this.ttl) {\n this.cache.delete(period);\n return null;\n }\n \n return entry.stats;\n }\n\n set(period: string, stats: StatsResult, sessionCount: number): void {\n this.cache.set(period, {\n stats,\n computedAt: new Date(),\n sessionCount,\n });\n }\n\n invalidate(): void {\n this.cache.clear();\n }\n}\n```\n\n### Lazy Loading\n\n- Load only session summaries for initial stats\n- Fetch full session data only when needed (e.g., longest session details)\n\n---\n\n## Security Considerations\n\n1. **Read-only access:** Plugin only reads session data, never writes\n2. **Local processing:** All computation happens locally\n3. **No network calls:** No telemetry or external API calls\n4. **Sandboxed execution:** Runs within OpenCode's plugin sandbox\n\n---\n\n## Future Extensibility\n\n### Planned Extensions\n\n1. **Export API:** Allow other plugins to access stats\n2. **Webhook integration:** Post stats to external services\n3. **Custom metrics:** User-defined stat tracking\n4. **Themes:** Customizable color schemes\n\n### Extension Points\n\n```typescript\n// Future: Plugin extension API\ninterface StatsExtension {\n // Add custom metrics\n metrics?: CustomMetric[];\n \n // Add custom fun facts\n funFacts?: FunFactTemplate[];\n \n // Add custom views\n views?: CustomView[];\n}\n```\n\n---\n\n## Resolved Questions\n\nBased on the actual OpenCode plugin API (`@opencode-ai/plugin`):\n\n### 1. Session Data Access - RESOLVED\n\n**How does OpenCode expose session list to plugins?**\n- Via the SDK client: `input.client.session.list()` and `input.client.session.messages(sessionId)`\n\n**Schema of session/message data:**\n- Sessions have: `id`, `title`, `createdAt`, `updatedAt`\n- Messages have: `id`, `sessionID`, `role`, `createdAt`, `info` (with model, tokens, cost)\n- Parts have: `id`, `type`, `content`\n\n### 2. Rendering - RESOLVED\n\n**Can plugins render output?**\n- Yes, via custom tools. The `execute` function returns `{ title, output, metadata }`\n- The `output` string is displayed to the user\n- For tab switching, we'd need to implement as separate tool calls or use the experimental hooks\n\n**Keyboard input:**\n- Not directly available in tool output\n- Alternative: Use multiple tool parameters (e.g., `/stats view=models`)\n\n### 3. Token Counting - RESOLVED\n\n**Is token count available per message?**\n- Yes! In `message.info.tokens`:\n - `input`: Input tokens\n - `output`: Output tokens\n - `reasoning`: Reasoning tokens (if applicable)\n - `cache.read` / `cache.write`: Cache tokens\n- Also `message.info.cost` for cost tracking\n\n### 4. Plugin Lifecycle - RESOLVED\n\n**When is the plugin loaded?**\n- Plugin function is called once when OpenCode starts\n- Returns hooks that are registered for the session lifetime\n\n**Can we persist cache?**\n- Yes, plugins can maintain in-memory state\n- For persistent storage, use file system via the Bun shell (`input.$`)\n\n### 5. Available Hooks Summary\n\n| Hook | Purpose | Use in Stats Plugin |\n|------|---------|---------------------|\n| `tool` | Define custom tools | `/stats` command |\n| `event` | Listen to events | Cache invalidation |\n| `chat.message` | Intercept messages | Could track in real-time |\n| `tool.execute.after` | Modify tool output | Could enhance other tool outputs with stats |\n| `experimental.session.compacting` | Add context | Could inject usage summary |\n", | |
| "additions": 238, | |
| "deletions": 17 | |
| } | |
| }, | |
| "time": { | |
| "start": 1766431432885, | |
| "end": 1766431432903 | |
| } | |
| } | |
| }, | |
| { | |
| "id": "prt_b4784a0d20016ycEHLPo79LcWX", | |
| "sessionID": "ses_4b8933352ffe2k7Q7VhaAWbJcB", | |
| "messageID": "msg_b47841abc001FZ0JdgpWlTn1KF", | |
| "type": "step-finish", | |
| "reason": "tool-calls", | |
| "cost": 0, | |
| "tokens": { | |
| "input": 1, | |
| "output": 3152, | |
| "reasoning": 0, | |
| "cache": { | |
| "read": 44963, | |
| "write": 414 | |
| } | |
| } | |
| } | |
| ] | |
| }, | |
| { | |
| "info": { | |
| "id": "msg_b4784a0e9001KkyS4hr8Q6wRut", | |
| "sessionID": "ses_4b8933352ffe2k7Q7VhaAWbJcB", | |
| "role": "assistant", | |
| "time": { | |
| "created": 1766431432937, | |
| "completed": 1766431443206 | |
| }, | |
| "parentID": "msg_b4782c46a001rP2W0KPoAqISMd", | |
| "modelID": "claude-opus-4-5", | |
| "providerID": "anthropic", | |
| "mode": "build", | |
| "agent": "build", | |
| "path": { | |
| "cwd": "/Users/themishkun/projects/tinkering/opencode-stats", | |
| "root": "/" | |
| }, | |
| "cost": 0, | |
| "tokens": { | |
| "input": 1, | |
| "output": 426, | |
| "reasoning": 0, | |
| "cache": { | |
| "read": 45377, | |
| "write": 3178 | |
| } | |
| }, | |
| "finish": "stop" | |
| }, | |
| "parts": [ | |
| { | |
| "id": "prt_b4784abf600111CHi6oexMkYJN", | |
| "sessionID": "ses_4b8933352ffe2k7Q7VhaAWbJcB", | |
| "messageID": "msg_b4784a0e9001KkyS4hr8Q6wRut", | |
| "type": "step-start" | |
| }, | |
| { | |
| "id": "prt_b4784abf8001i5GHOKBdlAhHmD", | |
| "sessionID": "ses_4b8933352ffe2k7Q7VhaAWbJcB", | |
| "messageID": "msg_b4784a0e9001KkyS4hr8Q6wRut", | |
| "type": "text", | |
| "text": "The ARCHITECTURE.md has been updated with the correct OpenCode plugin API. Let me provide a summary of the changes:\n\n## Updated ARCHITECTURE.md\n\nThe document now reflects the **actual OpenCode plugin API** from `@opencode-ai/plugin`:\n\n### Key Updates:\n\n1. **Plugin Input Structure**\n - `client`: SDK client for API access (`createOpencodeClient`)\n - `project`: Current project info\n - `directory`: Project directory path\n - `worktree`: Git worktree path\n - `$`: Bun shell for running commands\n\n2. **Available Hooks** (from actual source)\n - `tool` - Define custom tools (this is how we'll implement `/stats`)\n - `event` - Listen to OpenCode events\n - `chat.message` - Called when messages are received\n - `chat.params` - Modify LLM parameters\n - `tool.execute.before/after` - Intercept tool execution\n - `experimental.session.compacting` - Add context during compaction\n - And more...\n\n3. **Session Data Access**\n - Via SDK client: `client.session.list()` and `client.session.messages(sessionId)`\n - Messages include `info.tokens` with `{ input, output, reasoning, cache }`\n - Messages include `info.cost` for cost tracking\n - Messages include `info.model` with `{ providerID, modelID }`\n\n4. **Resolved Open Questions**\n - Token counting: Available in `message.info.tokens`\n - Session access: Via SDK client\n - Rendering: Via tool `execute` return `{ title, output, metadata }`\n\n5. **Updated Dependencies**\n - Now uses `@opencode-ai/plugin` and `@opencode-ai/sdk` as peer dependencies", | |
| "time": { | |
| "start": 1766431443171, | |
| "end": 1766431443171 | |
| } | |
| }, | |
| { | |
| "id": "prt_b4784c905001hsYT97BIW13lZu", | |
| "sessionID": "ses_4b8933352ffe2k7Q7VhaAWbJcB", | |
| "messageID": "msg_b4784a0e9001KkyS4hr8Q6wRut", | |
| "type": "step-finish", | |
| "reason": "stop", | |
| "cost": 0, | |
| "tokens": { | |
| "input": 1, | |
| "output": 426, | |
| "reasoning": 0, | |
| "cache": { | |
| "read": 45377, | |
| "write": 3178 | |
| } | |
| } | |
| } | |
| ] | |
| }, | |
| { | |
| "info": { | |
| "id": "msg_b4ba6ef4b001MfFyRjB5r8ijUq", | |
| "sessionID": "ses_4b8933352ffe2k7Q7VhaAWbJcB", | |
| "role": "user", | |
| "time": { | |
| "created": 1766500790105 | |
| }, | |
| "summary": { | |
| "title": "Building CLI with OpenCode SDK sessions", | |
| "diffs": [] | |
| }, | |
| "agent": "build", | |
| "model": { | |
| "providerID": "anthropic", | |
| "modelID": "claude-opus-4-5" | |
| } | |
| }, | |
| "parts": [ | |
| { | |
| "id": "prt_b4ba6ef4c001unhbRiow1z0rYM", | |
| "sessionID": "ses_4b8933352ffe2k7Q7VhaAWbJcB", | |
| "messageID": "msg_b4ba6ef4b001MfFyRjB5r8ijUq", | |
| "type": "text", | |
| "text": "okay let's instead do a cli app that will use opencode sdk to get sessions. This will work better than the plugin, as plugins can't do the function call directly rn" | |
| } | |
| ] | |
| }, | |
| { | |
| "info": { | |
| "id": "msg_b4ba6ef7d001je6dYuF09YvQSz", | |
| "sessionID": "ses_4b8933352ffe2k7Q7VhaAWbJcB", | |
| "role": "assistant", | |
| "time": { | |
| "created": 1766500790141, | |
| "completed": 1766500800637 | |
| }, | |
| "parentID": "msg_b4ba6ef4b001MfFyRjB5r8ijUq", | |
| "modelID": "claude-opus-4-5", | |
| "providerID": "anthropic", | |
| "mode": "build", | |
| "agent": "build", | |
| "path": { | |
| "cwd": "/Users/themishkun/projects/tinkering/opencode-stats", | |
| "root": "/" | |
| }, | |
| "cost": 0, | |
| "tokens": { | |
| "input": 3, | |
| "output": 141, | |
| "reasoning": 0, | |
| "cache": { | |
| "read": 0, | |
| "write": 49020 | |
| } | |
| }, | |
| "finish": "tool-calls" | |
| }, | |
| "parts": [ | |
| { | |
| "id": "prt_b4ba70c5c001k8fvswCWc5HlOX", | |
| "sessionID": "ses_4b8933352ffe2k7Q7VhaAWbJcB", | |
| "messageID": "msg_b4ba6ef7d001je6dYuF09YvQSz", | |
| "type": "step-start" | |
| }, | |
| { | |
| "id": "prt_b4ba70c6e001VDZt3eh03wZ9PE", | |
| "sessionID": "ses_4b8933352ffe2k7Q7VhaAWbJcB", | |
| "messageID": "msg_b4ba6ef7d001je6dYuF09YvQSz", | |
| "type": "text", | |
| "text": "Good call. Let me update the architecture to be a standalone CLI app using the OpenCode SDK.", | |
| "time": { | |
| "start": 1766500798611, | |
| "end": 1766500798611 | |
| } | |
| }, | |
| { | |
| "id": "prt_b4ba71093001ymJ9r2Cn6hgv1E", | |
| "sessionID": "ses_4b8933352ffe2k7Q7VhaAWbJcB", | |
| "messageID": "msg_b4ba6ef7d001je6dYuF09YvQSz", | |
| "type": "tool", | |
| "callID": "toolu_01P4ug5yi1wroqXUnZoySrMR", | |
| "tool": "todowrite", | |
| "state": { | |
| "status": "completed", | |
| "input": { | |
| "todos": [ | |
| { | |
| "id": "1", | |
| "content": "Update PRD.md for CLI app approach", | |
| "status": "in_progress", | |
| "priority": "high" | |
| }, | |
| { | |
| "id": "2", | |
| "content": "Update ARCHITECTURE.md for CLI app approach", | |
| "status": "pending", | |
| "priority": "high" | |
| } | |
| ] | |
| }, | |
| "output": "[\n {\n \"id\": \"1\",\n \"content\": \"Update PRD.md for CLI app approach\",\n \"status\": \"in_progress\",\n \"priority\": \"high\"\n },\n {\n \"id\": \"2\",\n \"content\": \"Update ARCHITECTURE.md for CLI app approach\",\n \"status\": \"pending\",\n \"priority\": \"high\"\n }\n]", | |
| "title": "2 todos", | |
| "metadata": { | |
| "todos": [ | |
| { | |
| "id": "1", | |
| "content": "Update PRD.md for CLI app approach", | |
| "status": "in_progress", | |
| "priority": "high" | |
| }, | |
| { | |
| "id": "2", | |
| "content": "Update ARCHITECTURE.md for CLI app approach", | |
| "status": "pending", | |
| "priority": "high" | |
| } | |
| ] | |
| }, | |
| "time": { | |
| "start": 1766500800471, | |
| "end": 1766500800473 | |
| } | |
| } | |
| }, | |
| { | |
| "id": "prt_b4ba7187c001K7CYDFc0PpYoTU", | |
| "sessionID": "ses_4b8933352ffe2k7Q7VhaAWbJcB", | |
| "messageID": "msg_b4ba6ef7d001je6dYuF09YvQSz", | |
| "type": "step-finish", | |
| "reason": "tool-calls", | |
| "cost": 0, | |
| "tokens": { | |
| "input": 3, | |
| "output": 141, | |
| "reasoning": 0, | |
| "cache": { | |
| "read": 0, | |
| "write": 49020 | |
| } | |
| } | |
| } | |
| ] | |
| }, | |
| { | |
| "info": { | |
| "id": "msg_b4ba71887001QpvNgaTinon85M", | |
| "sessionID": "ses_4b8933352ffe2k7Q7VhaAWbJcB", | |
| "role": "assistant", | |
| "time": { | |
| "created": 1766500800647, | |
| "completed": 1766500804633 | |
| }, | |
| "parentID": "msg_b4ba6ef4b001MfFyRjB5r8ijUq", | |
| "modelID": "claude-opus-4-5", | |
| "providerID": "anthropic", | |
| "mode": "build", | |
| "agent": "build", | |
| "path": { | |
| "cwd": "/Users/themishkun/projects/tinkering/opencode-stats", | |
| "root": "/" | |
| }, | |
| "cost": 0, | |
| "tokens": { | |
| "input": 1, | |
| "output": 74, | |
| "reasoning": 0, | |
| "cache": { | |
| "read": 49020, | |
| "write": 251 | |
| } | |
| }, | |
| "finish": "tool-calls" | |
| }, | |
| "parts": [ | |
| { | |
| "id": "prt_b4ba725fc001U3u0y0btJFzEmI", | |
| "sessionID": "ses_4b8933352ffe2k7Q7VhaAWbJcB", | |
| "messageID": "msg_b4ba71887001QpvNgaTinon85M", | |
| "type": "step-start" | |
| }, | |
| { | |
| "id": "prt_b4ba72600001oLfQeFZKAvAZzD", | |
| "sessionID": "ses_4b8933352ffe2k7Q7VhaAWbJcB", | |
| "messageID": "msg_b4ba71887001QpvNgaTinon85M", | |
| "type": "tool", | |
| "callID": "toolu_01NzAj1NqJGeQz18xg7vXZED", | |
| "tool": "read", | |
| "state": { | |
| "status": "completed", | |
| "input": { | |
| "filePath": "/Users/themishkun/projects/tinkering/opencode-stats/PRD.md" | |
| }, | |
| "output": "<file>\n00001| # Product Requirements Document: OpenCode Stats Plugin\n00002| \n00003| ## Overview\n00004| \n00005| **Product Name:** opencode-stats \n00006| **Version:** 1.0.0 \n00007| **Author:** themishkun \n00008| **Date:** December 22, 2025\n00009| \n00010| ### Vision\n00011| \n00012| Create a \"Spotify Wrapped\"-style statistics plugin for OpenCode that provides users with engaging, visual insights into their coding assistant usage patterns directly within the OpenCode interface.\n00013| \n00014| ### Problem Statement\n00015| \n00016| Users of OpenCode have no visibility into their usage patterns, making it difficult to:\n00017| - Understand how they interact with the AI assistant over time\n00018| - Track productivity metrics and coding streaks\n00019| - Identify peak productivity hours and preferred models\n00020| - Share and celebrate their coding journey milestones\n00021| \n00022| ### Solution\n00023| \n00024| A native OpenCode plugin that:\n00025| 1. Reads session data from OpenCode's session list\n00026| 2. Computes comprehensive usage statistics\n00027| 3. Renders beautiful ASCII/TUI visualizations directly in the OpenCode interface\n00028| 4. Provides fun, engaging comparisons (e.g., \"Your longest session is ~76x longer than the movie Inception\")\n00029| \n00030| ---\n00031| \n00032| ## Target Users\n00033| \n00034| - **Primary:** Active OpenCode users who want to track their usage\n00035| - **Secondary:** Teams wanting to understand AI assistant adoption patterns\n00036| \n00037| ---\n00038| \n00039| ## Features\n00040| \n00041| ### Core Features (MVP)\n00042| \n00043| #### 1. Activity Heatmap\n00044| A GitHub-style contribution heatmap showing daily activity over the past year.\n00045| \n00046| ```\n00047| Dec Jan Feb Mar Apr May Jun Jul Aug Sep Oct Nov Dec\n00048| Mon . . . . . . . . . . . . . . . . . . . . . . ▓ ▓ . .\n00049| Wed . . . . . . . . . . . . . . . . . . . . . . ▓ ▓ . .\n00050| Fri . . . . . . . . . . . . . . . . . . . . . . ░ ▓ . .\n00051| Less ░ ▒ ▓ █ More\n00052| ```\n00053| \n00054| **Data Points:**\n00055| - Sessions per day\n00056| - Color intensity based on activity level (5 levels)\n00057| - 52-week rolling window\n00058| \n00059| #### 2. Key Statistics Dashboard\n00060| \n00061| | Statistic | Description |\n00062| |-----------|-------------|\n00063| | Total Sessions | Count of all sessions |\n00064| | Total Tokens | Sum of tokens used across all sessions |\n00065| | Active Days | Days with at least one session |\n00066| | Current Streak | Consecutive days with activity |\n00067| | Longest Streak | Historical best consecutive days |\n00068| | Longest Session | Duration of the longest single session |\n00069| | Peak Hour | Most common hour of session starts |\n00070| | Favorite Model | Most frequently used AI model |\n00071| \n00072| #### 3. Model Usage Breakdown\n00073| Tab to switch between \"Overview\" and \"Models\" views:\n00074| \n00075| ```\n00076| Models (tab to cycle)\n00077| \n00078| claude-sonnet-4-20250514 ████████████████░░░░ 78%\n00079| claude-3-5-haiku ███░░░░░░░░░░░░░░░░░ 15%\n00080| gpt-4o █░░░░░░░░░░░░░░░░░░░ 7%\n00081| ```\n00082| \n00083| #### 4. Fun Comparisons\n00084| Generate engaging, shareable insights:\n00085| - \"Your longest session is ~76x longer than the movie Inception\"\n00086| - \"You've used more tokens than words in War and Peace\"\n00087| - \"Your streak is longer than the average vacation\"\n00088| \n00089| ### Future Features (v2.0)\n00090| \n00091| - **Export to Image:** Generate shareable images of stats\n00092| - **Weekly/Monthly Reports:** Automated summaries\n00093| - **Goals & Achievements:** Gamification elements\n00094| - **Team Leaderboards:** Compare stats across team members\n00095| - **Cost Estimation:** Approximate token costs by provider\n00096| \n00097| ---\n00098| \n00099| ## User Interface\n00100| \n00101| ### Invocation Methods\n00102| \n00103| 1. **Slash Command:** `/stats` - Primary way to invoke the stats view\n00104| 2. **Keyboard Shortcut:** Configurable (default: `Ctrl+Shift+S`)\n00105| \n00106| ### Display Modes\n00107| \n00108| 1. **Overview Mode** (default)\n00109| - Activity heatmap\n00110| - Key statistics in two columns\n00111| - Fun comparison at the bottom\n00112| \n00113| 2. **Models Mode** (tab to switch)\n00114| - Model usage breakdown with bar charts\n00115| - Per-model token counts\n00116| - Model switching frequency\n00117| \n00118| ### Interaction\n00119| \n00120| - `Tab` - Cycle between Overview and Models views\n00121| - `q` or `Esc` - Close stats view\n00122| - `r` - Refresh statistics\n00123| - `←` `→` - Navigate time periods (future feature)\n00124| \n00125| ---\n00126| \n00127| ## Technical Requirements\n00128| \n00129| ### Data Sources\n00130| \n00131| The plugin needs access to:\n00132| \n00133| 1. **Session List** - Via OpenCode's internal API/hooks\n00134| - Session ID\n00135| - Start timestamp\n00136| - End timestamp (or last message timestamp)\n00137| - Message count\n00138| - Model used per message\n00139| \n00140| 2. **Message Data** (per session)\n00141| - Timestamp\n00142| - Token count (input/output)\n00143| - Model used\n00144| \n00145| ### Performance Requirements\n00146| \n00147| | Metric | Target |\n00148| |--------|--------|\n00149| | Initial load time | < 500ms |\n00150| | Stats computation | < 1s for 1 year of data |\n00151| | Memory overhead | < 50MB |\n00152| | Render time | < 100ms |\n00153| \n00154| ### Data Storage\n00155| \n00156| - **Read-only:** Plugin only reads existing OpenCode session data\n00157| - **Cache:** Optional local cache for computed stats (invalidated on new sessions)\n00158| - **No external calls:** All processing happens locally\n00159| \n00160| ---\n00161| \n00162| ## Non-Functional Requirements\n00163| \n00164| ### Privacy\n00165| - All data processing happens locally\n00166| - No telemetry or external data transmission\n00167| - No PII is collected or stored\n00168| \n00169| ### Compatibility\n00170| - OpenCode version: >= 0.1.0\n00171| - Runtime: Bun (as per OpenCode plugin requirements)\n00172| - OS: macOS, Linux, Windows (via WSL)\n00173| \n00174| ### Accessibility\n00175| - ASCII-based rendering works in all terminals\n00176| - Color schemes respect terminal themes\n00177| - Stats available as plain text for screen readers\n00178| \n00179| ---\n00180| \n00181| ## Success Metrics\n00182| \n00183| | Metric | Target |\n00184| |--------|--------|\n00185| | User activation | 50% of users who install view stats at least once |\n00186| | Weekly engagement | 30% of active users check stats weekly |\n00187| | User satisfaction | 4.5+ stars on plugin marketplace |\n00188| \n00189| ---\n00190| \n00191| ## Risks & Mitigations\n00192| \n00193| | Risk | Impact | Mitigation |\n00194| |------|--------|------------|\n00195| | Session data format changes | High | Version-check OpenCode, graceful degradation |\n00196| | Large session history causes slow loads | Medium | Implement pagination, caching |\n00197| | Limited terminal color support | Low | Fallback to monochrome mode |\n00198| \n00199| ---\n00200| \n00201| ## Timeline\n00202| \n00203| ### Phase 1: MVP (Week 1-2)\n00204| - [ ] Plugin scaffolding and configuration\n00205| - [ ] Session data access and parsing\n00206| - [ ] Core statistics computation\n00207| - [ ] Activity heatmap rendering\n00208| - [ ] Basic statistics display\n00209| - [ ] `/stats` slash command\n00210| \n00211| ### Phase 2: Polish (Week 3)\n00212| - [ ] Models breakdown view\n00213| - [ ] Fun comparisons engine\n00214| - [ ] Performance optimization\n00215| - [ ] Error handling and edge cases\n00216| - [ ] Documentation\n00217| \n00218| ### Phase 3: Release (Week 4)\n00219| - [ ] Testing across different terminals\n00220| - [ ] Beta feedback incorporation\n00221| - [ ] Plugin marketplace submission\n00222| - [ ] Announcement and promotion\n00223| \n00224| ---\n00225| \n00226| ## Open Questions\n00227| \n00228| 1. **Session data access:** What hooks/APIs does OpenCode expose for reading session history?\n00229| 2. **Token counting:** Is token count available per message or needs estimation?\n00230| 3. **Plugin UI patterns:** Are there existing patterns for full-screen plugin views in OpenCode?\n00231| 4. **Distribution:** What's the plugin marketplace/distribution mechanism?\n00232| \n00233| ---\n00234| \n00235| ## Appendix\n00236| \n00237| ### Reference: Spotify Wrapped Elements\n00238| \n00239| The inspiration comes from Spotify's annual Wrapped feature:\n00240| - Visually engaging data presentation\n00241| - Fun, shareable insights\n00242| - Personal statistics with contextual comparisons\n00243| - Progressive disclosure (overview → details)\n00244| \n00245| ### Sample Output\n00246| \n00247| ```\n00248| ┌─ OpenCode Stats ─────────────────────────────────────────────┐\n00249| │ │\n00250| │ Overview Models (tab to cycle) │\n00251| │ │\n00252| │ Dec Jan Feb Mar Apr May Jun Jul Aug Sep Oct Nov Dec │\n00253| │ Mon . . . . . . . . . . . . . . . . . . . . . . ▓ ▓ . . │\n00254| │ Wed . . . . . . . . . . . . . . . . . . . . . . ▓ ▓ . . │\n00255| │ Fri . . . . . . . . . . . . . . . . . . . . . . ░ ▓ . . │\n00256| │ Less ░ ▒ ▓ █ More │\n00257| │ │\n00258| │ Favorite model: Sonnet 4.5 Total tokens: 12.8m │\n00259| │ │\n00260| │ Sessions: 432 Longest session: 7d 20h 14m │\n00261| │ Current streak: 31 days Longest streak: 32 days │\n00262| │ Active days: 32/32 Peak hour: 12:00-13:00 │\n00263| │ │\n00264| │ ✨ Your longest session is ~76x longer than Inception │\n00265| │ Stats from the last 32 days │\n00266| │ │\n00267| └──────────────────────────────────────────────────────────────┘\n00268| ```\n00269| \n\n(End of file - total 269 lines)\n</file>", | |
| "title": "Users/themishkun/projects/tinkering/opencode-stats/PRD.md", | |
| "metadata": { | |
| "preview": "# Product Requirements Document: OpenCode Stats Plugin\n\n## Overview\n\n**Product Name:** opencode-stats \n**Version:** 1.0.0 \n**Author:** themishkun \n**Date:** December 22, 2025\n\n### Vision\n\nCreate a \"Spotify Wrapped\"-style statistics plugin for OpenCode that provides users with engaging, visual insights into their coding assistant usage patterns directly within the OpenCode interface.\n\n### Problem Statement\n\nUsers of OpenCode have no visibility into their usage patterns, making it difficult to:\n- Understand how they interact with the AI assistant over time\n- Track productivity metrics and coding streaks\n- Identify peak productivity hours and preferred models\n- Share and celebrate their coding journey milestones" | |
| }, | |
| "time": { | |
| "start": 1766500804567, | |
| "end": 1766500804569 | |
| } | |
| } | |
| }, | |
| { | |
| "id": "prt_b4ba72817001cLog8DC5O02Eba", | |
| "sessionID": "ses_4b8933352ffe2k7Q7VhaAWbJcB", | |
| "messageID": "msg_b4ba71887001QpvNgaTinon85M", | |
| "type": "step-finish", | |
| "reason": "tool-calls", | |
| "cost": 0, | |
| "tokens": { | |
| "input": 1, | |
| "output": 74, | |
| "reasoning": 0, | |
| "cache": { | |
| "read": 49020, | |
| "write": 251 | |
| } | |
| } | |
| } | |
| ] | |
| }, | |
| { | |
| "info": { | |
| "id": "msg_b4ba72821001GE9eO2H0r7ObB7", | |
| "sessionID": "ses_4b8933352ffe2k7Q7VhaAWbJcB", | |
| "role": "assistant", | |
| "time": { | |
| "created": 1766500804641, | |
| "completed": 1766500839038 | |
| }, | |
| "parentID": "msg_b4ba6ef4b001MfFyRjB5r8ijUq", | |
| "modelID": "claude-opus-4-5", | |
| "providerID": "anthropic", | |
| "mode": "build", | |
| "agent": "build", | |
| "path": { | |
| "cwd": "/Users/themishkun/projects/tinkering/opencode-stats", | |
| "root": "/" | |
| }, | |
| "cost": 0, | |
| "tokens": { | |
| "input": 1, | |
| "output": 2909, | |
| "reasoning": 0, | |
| "cache": { | |
| "read": 49271, | |
| "write": 3290 | |
| } | |
| }, | |
| "finish": "tool-calls" | |
| }, | |
| "parts": [ | |
| { | |
| "id": "prt_b4ba73348001vhaBcjZSkysJVs", | |
| "sessionID": "ses_4b8933352ffe2k7Q7VhaAWbJcB", | |
| "messageID": "msg_b4ba72821001GE9eO2H0r7ObB7", | |
| "type": "step-start" | |
| }, | |
| { | |
| "id": "prt_b4ba7334b001oHQvhII7d3t3hV", | |
| "sessionID": "ses_4b8933352ffe2k7Q7VhaAWbJcB", | |
| "messageID": "msg_b4ba72821001GE9eO2H0r7ObB7", | |
| "type": "tool", | |
| "callID": "toolu_01EbwisX3RMgTwnSJPo3dczL", | |
| "tool": "write", | |
| "state": { | |
| "status": "completed", | |
| "input": { | |
| "filePath": "/Users/themishkun/projects/tinkering/opencode-stats/PRD.md", | |
| "content": "# Product Requirements Document: OpenCode Stats CLI\n\n## Overview\n\n**Product Name:** opencode-stats \n**Version:** 1.0.0 \n**Author:** themishkun \n**Date:** December 23, 2025\n\n### Vision\n\nCreate a \"Spotify Wrapped\"-style statistics CLI tool for OpenCode that provides users with engaging, visual insights into their coding assistant usage patterns in the terminal.\n\n### Problem Statement\n\nUsers of OpenCode have no visibility into their usage patterns, making it difficult to:\n- Understand how they interact with the AI assistant over time\n- Track productivity metrics and coding streaks\n- Identify peak productivity hours and preferred models\n- Share and celebrate their coding journey milestones\n\n### Solution\n\nA standalone CLI application that:\n1. Uses the `@opencode-ai/sdk` to read session data from OpenCode's storage\n2. Computes comprehensive usage statistics\n3. Renders beautiful ASCII/TUI visualizations in the terminal\n4. Provides fun, engaging comparisons (e.g., \"Your longest session is ~76x longer than the movie Inception\")\n\n---\n\n## Target Users\n\n- **Primary:** Active OpenCode users who want to track their usage\n- **Secondary:** Teams wanting to understand AI assistant adoption patterns\n\n---\n\n## Features\n\n### Core Features (MVP)\n\n#### 1. Activity Heatmap\nA GitHub-style contribution heatmap showing daily activity over the past year.\n\n```\n Dec Jan Feb Mar Apr May Jun Jul Aug Sep Oct Nov Dec\nMon · · · · · · · · · · · · · · · · · · · · · · ▓ ▓ · ·\nWed · · · · · · · · · · · · · · · · · · · · · · ▓ ▓ · ·\nFri · · · · · · · · · · · · · · · · · · · · · · ░ ▓ · ·\n Less ░ ▒ ▓ █ More\n```\n\n**Data Points:**\n- Sessions per day\n- Color intensity based on activity level (5 levels)\n- 52-week rolling window\n\n#### 2. Key Statistics Dashboard\n\n| Statistic | Description |\n|-----------|-------------|\n| Total Sessions | Count of all sessions |\n| Total Tokens | Sum of tokens used across all sessions |\n| Active Days | Days with at least one session |\n| Current Streak | Consecutive days with activity |\n| Longest Streak | Historical best consecutive days |\n| Longest Session | Duration of the longest single session |\n| Peak Hour | Most common hour of session starts |\n| Favorite Model | Most frequently used AI model |\n\n#### 3. Model Usage Breakdown\n\n```\nModels\n\n claude-sonnet-4-20250514 ████████████████░░░░ 78%\n claude-3-5-haiku ███░░░░░░░░░░░░░░░░░ 15%\n gpt-4o █░░░░░░░░░░░░░░░░░░░ 7%\n```\n\n#### 4. Fun Comparisons\nGenerate engaging, shareable insights:\n- \"Your longest session is ~76x longer than the movie Inception\"\n- \"You've used more tokens than words in War and Peace\"\n- \"Your streak is longer than the average vacation\"\n\n### Future Features (v2.0)\n\n- **Export to Image:** Generate shareable images of stats (SVG/PNG)\n- **Weekly/Monthly Reports:** Automated summaries\n- **Goals & Achievements:** Gamification elements\n- **JSON Export:** Machine-readable stats output\n- **Cost Estimation:** Approximate token costs by provider\n- **Watch Mode:** Live-updating stats display\n\n---\n\n## User Interface\n\n### Invocation\n\n```bash\n# Default: show overview for last 30 days\nopencode-stats\n\n# Show stats for specific period\nopencode-stats --period week\nopencode-stats --period month\nopencode-stats --period year\nopencode-stats --period all\n\n# Show specific view\nopencode-stats --view overview # default\nopencode-stats --view models\nopencode-stats --view heatmap\n\n# Output formats\nopencode-stats --format pretty # default, colored terminal output\nopencode-stats --format plain # no colors, ASCII only\nopencode-stats --format json # machine-readable\n\n# Other options\nopencode-stats --no-color # disable colors\nopencode-stats --width 80 # set output width\nopencode-stats --help # show help\nopencode-stats --version # show version\n```\n\n### Display Modes\n\n1. **Overview Mode** (default)\n - Activity heatmap\n - Key statistics in two columns\n - Fun comparison at the bottom\n\n2. **Models Mode**\n - Model usage breakdown with bar charts\n - Per-model token counts\n\n3. **Heatmap Mode**\n - Full-width activity heatmap only\n - Useful for embedding in other tools\n\n---\n\n## Technical Requirements\n\n### Data Sources\n\nThe CLI reads from OpenCode's session storage via the SDK:\n\n1. **Session List** - `client.session.list()`\n - Session ID\n - Created/Updated timestamps\n - Title\n\n2. **Message Data** - `client.session.messages(sessionId)`\n - Message info with timestamps\n - Token counts (`info.tokens.input`, `info.tokens.output`)\n - Model used (`info.model.providerID`, `info.model.modelID`)\n - Cost (`info.cost`)\n\n### Performance Requirements\n\n| Metric | Target |\n|--------|--------|\n| Startup time | < 200ms |\n| Stats computation | < 1s for 1 year of data |\n| Memory usage | < 100MB |\n\n### Data Storage\n\n- **Read-only:** CLI only reads existing OpenCode session data\n- **No external calls:** All processing happens locally\n- **No caching:** Fresh data on each run (simple, predictable)\n\n---\n\n## Non-Functional Requirements\n\n### Privacy\n- All data processing happens locally\n- No telemetry or external data transmission\n- No data leaves the user's machine\n\n### Compatibility\n- Runtime: Bun or Node.js 18+\n- OS: macOS, Linux, Windows\n- Terminal: Any terminal with UTF-8 support\n\n### Accessibility\n- ASCII-based rendering works in all terminals\n- `--no-color` flag for colorblind users\n- `--format plain` for screen readers\n- `--format json` for programmatic access\n\n---\n\n## CLI Design\n\n### Command Structure\n\n```\nopencode-stats [options]\n\nOptions:\n -p, --period <period> Time period: week, month, year, all (default: month)\n -v, --view <view> View mode: overview, models, heatmap (default: overview)\n -f, --format <format> Output format: pretty, plain, json (default: pretty)\n -w, --width <number> Output width in characters (default: auto)\n --no-color Disable colored output\n --version Show version number\n --help Show help\n```\n\n### Exit Codes\n\n| Code | Meaning |\n|------|---------|\n| 0 | Success |\n| 1 | General error |\n| 2 | No session data found |\n| 3 | OpenCode SDK error |\n\n---\n\n## Success Metrics\n\n| Metric | Target |\n|--------|--------|\n| npm weekly downloads | 100+ after launch |\n| GitHub stars | 50+ in first month |\n| User issues/feedback | Response within 48h |\n\n---\n\n## Risks & Mitigations\n\n| Risk | Impact | Mitigation |\n|------|--------|------------|\n| OpenCode SDK API changes | High | Pin SDK version, handle gracefully |\n| Large session history causes slow loads | Medium | Stream processing, progress indicator |\n| Limited terminal color support | Low | `--no-color` flag, detection |\n| No session data | Low | Helpful error message with setup instructions |\n\n---\n\n## Timeline\n\n### Phase 1: MVP (Week 1)\n- [ ] Project setup (Bun, TypeScript)\n- [ ] OpenCode SDK integration\n- [ ] Session data fetching and parsing\n- [ ] Core statistics computation\n- [ ] Activity heatmap rendering\n- [ ] Basic CLI with overview display\n\n### Phase 2: Polish (Week 2)\n- [ ] Models breakdown view\n- [ ] Fun comparisons engine\n- [ ] JSON output format\n- [ ] Error handling and edge cases\n- [ ] README and documentation\n\n### Phase 3: Release (Week 3)\n- [ ] npm package publishing\n- [ ] GitHub release\n- [ ] Testing across different terminals/OS\n- [ ] Announcement\n\n---\n\n## Resolved Questions\n\n1. **Session data access:** Via `@opencode-ai/sdk` client methods\n2. **Token counting:** Available in `message.info.tokens` (input, output, reasoning, cache)\n3. **Distribution:** npm package, installable via `npm i -g opencode-stats` or `bunx opencode-stats`\n\n---\n\n## Sample Output\n\n```\n┌─ OpenCode Stats ─────────────────────────────────────────────┐\n│ │\n│ Dec Jan Feb Mar Apr May Jun Jul Aug Sep Oct Nov Dec │\n│ Mon · · · · · · · · · · · · · · · · · · · · · · ▓ ▓ · · │\n│ Wed · · · · · · · · · · · · · · · · · · · · · · ▓ ▓ · · │\n│ Fri · · · · · · · · · · · · · · · · · · · · · · ░ ▓ · · │\n│ Less ░ ▒ ▓ █ More │\n│ │\n│ Favorite model: Sonnet 4.5 Total tokens: 12.8m │\n│ │\n│ Sessions: 432 Longest session: 7d 20h 14m│\n│ Current streak: 31 days Longest streak: 32 days │\n│ Active days: 32/32 Peak hour: 12:00-13:00 │\n│ │\n│ ✨ Your longest session is ~76x longer than Inception │\n│ Stats from the last 32 days │\n│ │\n└──────────────────────────────────────────────────────────────┘\n```\n\n### JSON Output Example\n\n```json\n{\n \"period\": {\n \"start\": \"2024-11-23T00:00:00Z\",\n \"end\": \"2024-12-23T00:00:00Z\",\n \"days\": 30\n },\n \"summary\": {\n \"totalSessions\": 432,\n \"totalTokens\": 12800000,\n \"totalMessages\": 8640,\n \"activeDays\": 32,\n \"currentStreak\": 31,\n \"longestStreak\": 32,\n \"longestSession\": {\n \"id\": \"ses_abc123\",\n \"durationMinutes\": 11294\n },\n \"peakHour\": 12,\n \"favoriteModel\": \"claude-sonnet-4-20250514\",\n \"totalCost\": 45.67\n },\n \"modelUsage\": [\n {\n \"modelID\": \"claude-sonnet-4-20250514\",\n \"providerID\": \"anthropic\",\n \"messageCount\": 6739,\n \"totalTokens\": 9984000,\n \"percentage\": 78\n }\n ],\n \"funFact\": \"Your longest session is ~76x longer than the movie Inception\"\n}\n```\n" | |
| }, | |
| "output": "", | |
| "title": "Users/themishkun/projects/tinkering/opencode-stats/PRD.md", | |
| "metadata": { | |
| "diagnostics": {}, | |
| "filepath": "/Users/themishkun/projects/tinkering/opencode-stats/PRD.md", | |
| "exists": true | |
| }, | |
| "time": { | |
| "start": 1766500838980, | |
| "end": 1766500838982 | |
| } | |
| } | |
| }, | |
| { | |
| "id": "prt_b4ba7ae7c001d03CSxXNv2XTpl", | |
| "sessionID": "ses_4b8933352ffe2k7Q7VhaAWbJcB", | |
| "messageID": "msg_b4ba72821001GE9eO2H0r7ObB7", | |
| "type": "step-finish", | |
| "reason": "tool-calls", | |
| "cost": 0, | |
| "tokens": { | |
| "input": 1, | |
| "output": 2909, | |
| "reasoning": 0, | |
| "cache": { | |
| "read": 49271, | |
| "write": 3290 | |
| } | |
| } | |
| } | |
| ] | |
| }, | |
| { | |
| "info": { | |
| "id": "msg_b4ba7ae8a00167N0r61LIhDeRW", | |
| "sessionID": "ses_4b8933352ffe2k7Q7VhaAWbJcB", | |
| "role": "assistant", | |
| "time": { | |
| "created": 1766500839050, | |
| "completed": 1766500844270 | |
| }, | |
| "parentID": "msg_b4ba6ef4b001MfFyRjB5r8ijUq", | |
| "modelID": "claude-opus-4-5", | |
| "providerID": "anthropic", | |
| "mode": "build", | |
| "agent": "build", | |
| "path": { | |
| "cwd": "/Users/themishkun/projects/tinkering/opencode-stats", | |
| "root": "/" | |
| }, | |
| "cost": 0, | |
| "tokens": { | |
| "input": 1, | |
| "output": 120, | |
| "reasoning": 0, | |
| "cache": { | |
| "read": 52561, | |
| "write": 2935 | |
| } | |
| }, | |
| "finish": "tool-calls" | |
| }, | |
| "parts": [ | |
| { | |
| "id": "prt_b4ba7bbdd001n8DsCQNtGEIOW3", | |
| "sessionID": "ses_4b8933352ffe2k7Q7VhaAWbJcB", | |
| "messageID": "msg_b4ba7ae8a00167N0r61LIhDeRW", | |
| "type": "step-start" | |
| }, | |
| { | |
| "id": "prt_b4ba7bbdf001fdPofol0cNzIiP", | |
| "sessionID": "ses_4b8933352ffe2k7Q7VhaAWbJcB", | |
| "messageID": "msg_b4ba7ae8a00167N0r61LIhDeRW", | |
| "type": "tool", | |
| "callID": "toolu_01KqBN9qxpsDRMHLRmk7Z3ku", | |
| "tool": "todowrite", | |
| "state": { | |
| "status": "completed", | |
| "input": { | |
| "todos": [ | |
| { | |
| "id": "1", | |
| "content": "Update PRD.md for CLI app approach", | |
| "status": "completed", | |
| "priority": "high" | |
| }, | |
| { | |
| "id": "2", | |
| "content": "Update ARCHITECTURE.md for CLI app approach", | |
| "status": "in_progress", | |
| "priority": "high" | |
| } | |
| ] | |
| }, | |
| "output": "[\n {\n \"id\": \"1\",\n \"content\": \"Update PRD.md for CLI app approach\",\n \"status\": \"completed\",\n \"priority\": \"high\"\n },\n {\n \"id\": \"2\",\n \"content\": \"Update ARCHITECTURE.md for CLI app approach\",\n \"status\": \"in_progress\",\n \"priority\": \"high\"\n }\n]", | |
| "title": "1 todos", | |
| "metadata": { | |
| "todos": [ | |
| { | |
| "id": "1", | |
| "content": "Update PRD.md for CLI app approach", | |
| "status": "completed", | |
| "priority": "high" | |
| }, | |
| { | |
| "id": "2", | |
| "content": "Update ARCHITECTURE.md for CLI app approach", | |
| "status": "in_progress", | |
| "priority": "high" | |
| } | |
| ] | |
| }, | |
| "time": { | |
| "start": 1766500844094, | |
| "end": 1766500844095 | |
| } | |
| } | |
| }, | |
| { | |
| "id": "prt_b4ba7c2ed0014fiRFtDKDpm5pZ", | |
| "sessionID": "ses_4b8933352ffe2k7Q7VhaAWbJcB", | |
| "messageID": "msg_b4ba7ae8a00167N0r61LIhDeRW", | |
| "type": "step-finish", | |
| "reason": "tool-calls", | |
| "cost": 0, | |
| "tokens": { | |
| "input": 1, | |
| "output": 120, | |
| "reasoning": 0, | |
| "cache": { | |
| "read": 52561, | |
| "write": 2935 | |
| } | |
| } | |
| } | |
| ] | |
| }, | |
| { | |
| "info": { | |
| "id": "msg_b4ba7c2f8001OdnwZI2RhYAqZk", | |
| "sessionID": "ses_4b8933352ffe2k7Q7VhaAWbJcB", | |
| "role": "assistant", | |
| "time": { | |
| "created": 1766500844280, | |
| "completed": 1766500964022 | |
| }, | |
| "parentID": "msg_b4ba6ef4b001MfFyRjB5r8ijUq", | |
| "modelID": "claude-opus-4-5", | |
| "providerID": "anthropic", | |
| "mode": "build", | |
| "agent": "build", | |
| "path": { | |
| "cwd": "/Users/themishkun/projects/tinkering/opencode-stats", | |
| "root": "/" | |
| }, | |
| "cost": 0, | |
| "tokens": { | |
| "input": 1, | |
| "output": 10581, | |
| "reasoning": 0, | |
| "cache": { | |
| "read": 55496, | |
| "write": 228 | |
| } | |
| }, | |
| "finish": "tool-calls" | |
| }, | |
| "parts": [ | |
| { | |
| "id": "prt_b4ba7d068001IsuP1e2gpBKU4w", | |
| "sessionID": "ses_4b8933352ffe2k7Q7VhaAWbJcB", | |
| "messageID": "msg_b4ba7c2f8001OdnwZI2RhYAqZk", | |
| "type": "step-start" | |
| }, | |
| { | |
| "id": "prt_b4ba7d06b0010PKzeuwtzbAYMc", | |
| "sessionID": "ses_4b8933352ffe2k7Q7VhaAWbJcB", | |
| "messageID": "msg_b4ba7c2f8001OdnwZI2RhYAqZk", | |
| "type": "tool", | |
| "callID": "toolu_019RBHd2poGX2rkGo7XSXiL4", | |
| "tool": "write", | |
| "state": { | |
| "status": "completed", | |
| "input": { | |
| "filePath": "/Users/themishkun/projects/tinkering/opencode-stats/ARCHITECTURE.md", | |
| "content": "# Architecture Document: OpenCode Stats CLI\n\n## Overview\n\nThis document describes the technical architecture of `opencode-stats`, a standalone CLI application that generates \"Spotify Wrapped\"-style statistics for OpenCode usage.\n\n---\n\n## High-Level Architecture\n\n```\n┌─────────────────────────────────────────────────────────────────┐\n│ opencode-stats CLI │\n├─────────────────────────────────────────────────────────────────┤\n│ │\n│ ┌─────────────┐ ┌─────────────┐ ┌─────────────────────────┐ │\n│ │ CLI │ │ Stats │ │ Renderer │ │\n│ │ Parser │──│ Engine │──│ (Terminal Output) │ │\n│ └─────────────┘ └─────────────┘ └─────────────────────────┘ │\n│ │ │ │ │\n│ ▼ ▼ ▼ │\n│ ┌─────────────┐ ┌─────────────┐ ┌─────────────────────────┐ │\n│ │ Config │ │ Data │ │ Components │ │\n│ │ (args) │ │ Layer │ │ (heatmap, stats, etc) │ │\n│ └─────────────┘ └─────────────┘ └─────────────────────────┘ │\n│ │ │\n└──────────────────────────│─────────────────────────────────────┘\n │\n ▼\n┌─────────────────────────────────────────────────────────────────┐\n│ @opencode-ai/sdk │\n│ │\n│ client.session.list() client.session.messages(id) │\n└─────────────────────────────────────────────────────────────────┘\n │\n ▼\n┌─────────────────────────────────────────────────────────────────┐\n│ OpenCode Session Storage │\n│ ~/.opencode/ │\n└─────────────────────────────────────────────────────────────────┘\n```\n\n---\n\n## Project Structure\n\n```\nopencode-stats/\n├── src/\n│ ├── index.ts # Entry point, CLI setup\n│ ├── cli.ts # Argument parsing\n│ ├── config.ts # Configuration types\n│ │\n│ ├── data/\n│ │ ├── client.ts # OpenCode SDK client wrapper\n│ │ ├── sessions.ts # Session data fetching\n│ │ └── types.ts # Data types/interfaces\n│ │\n│ ├── stats/\n│ │ ├── engine.ts # Main statistics computation\n│ │ ├── streaks.ts # Streak calculations\n│ │ ├── aggregators.ts # Data aggregation utilities\n│ │ └── funfacts.ts # Fun fact generator\n│ │\n│ └── render/\n│ ├── index.ts # Main renderer\n│ ├── pretty.ts # Colored terminal output\n│ ├── plain.ts # Plain text output\n│ ├── json.ts # JSON output\n│ └── components/\n│ ├── heatmap.ts # Activity heatmap\n│ ├── dashboard.ts # Stats dashboard\n│ ├── models.ts # Model usage chart\n│ └── box.ts # Box drawing utilities\n│\n├── package.json\n├── tsconfig.json\n├── README.md\n├── PRD.md\n└── ARCHITECTURE.md\n```\n\n---\n\n## Component Design\n\n### 1. CLI Entry Point (`src/index.ts`)\n\n```typescript\n#!/usr/bin/env node\nimport { parseArgs } from \"./cli\";\nimport { createDataProvider } from \"./data/client\";\nimport { StatsEngine } from \"./stats/engine\";\nimport { render } from \"./render\";\n\nasync function main() {\n const config = parseArgs(process.argv.slice(2));\n \n try {\n const dataProvider = await createDataProvider();\n const engine = new StatsEngine(dataProvider);\n const stats = await engine.computeStats({ period: config.period });\n \n const output = render(stats, config);\n console.log(output);\n \n process.exit(0);\n } catch (error) {\n if (error.code === \"NO_SESSIONS\") {\n console.error(\"No OpenCode sessions found. Start using OpenCode first!\");\n process.exit(2);\n }\n console.error(\"Error:\", error.message);\n process.exit(1);\n }\n}\n\nmain();\n```\n\n### 2. CLI Argument Parser (`src/cli.ts`)\n\n```typescript\nimport { parseArgs as nodeParseArgs } from \"node:util\";\n\nexport interface Config {\n period: \"week\" | \"month\" | \"year\" | \"all\";\n view: \"overview\" | \"models\" | \"heatmap\";\n format: \"pretty\" | \"plain\" | \"json\";\n width: number;\n noColor: boolean;\n}\n\nexport function parseArgs(args: string[]): Config {\n const { values } = nodeParseArgs({\n args,\n options: {\n period: { type: \"string\", short: \"p\", default: \"month\" },\n view: { type: \"string\", short: \"v\", default: \"overview\" },\n format: { type: \"string\", short: \"f\", default: \"pretty\" },\n width: { type: \"string\", short: \"w\" },\n \"no-color\": { type: \"boolean\", default: false },\n help: { type: \"boolean\", short: \"h\" },\n version: { type: \"boolean\" },\n },\n });\n\n if (values.help) {\n printHelp();\n process.exit(0);\n }\n\n if (values.version) {\n console.log(require(\"../package.json\").version);\n process.exit(0);\n }\n\n return {\n period: validatePeriod(values.period as string),\n view: validateView(values.view as string),\n format: validateFormat(values.format as string),\n width: values.width ? parseInt(values.width as string, 10) : process.stdout.columns || 80,\n noColor: values[\"no-color\"] || !process.stdout.isTTY,\n };\n}\n\nfunction printHelp() {\n console.log(`\nopencode-stats - Spotify Wrapped-style stats for OpenCode\n\nUsage: opencode-stats [options]\n\nOptions:\n -p, --period <period> Time period: week, month, year, all (default: month)\n -v, --view <view> View mode: overview, models, heatmap (default: overview)\n -f, --format <format> Output format: pretty, plain, json (default: pretty)\n -w, --width <number> Output width in characters (default: auto)\n --no-color Disable colored output\n --version Show version number\n -h, --help Show help\n\nExamples:\n opencode-stats # Show monthly overview\n opencode-stats -p year # Show yearly stats\n opencode-stats -v models # Show model usage breakdown\n opencode-stats -f json # Output as JSON\n`);\n}\n```\n\n### 3. Data Layer (`src/data/`)\n\n#### SDK Client Wrapper (`src/data/client.ts`)\n\n```typescript\nimport { createOpencodeClient } from \"@opencode-ai/sdk\";\n\nexport async function createDataProvider(): Promise<DataProvider> {\n const client = createOpencodeClient();\n return new DataProvider(client);\n}\n\nexport class DataProvider {\n constructor(private client: ReturnType<typeof createOpencodeClient>) {}\n\n async getSessions(): Promise<Session[]> {\n return await this.client.session.list();\n }\n\n async getSessionMessages(sessionId: string): Promise<MessageWithParts[]> {\n return await this.client.session.messages(sessionId);\n }\n\n async getAllData(): Promise<SessionWithMessages[]> {\n const sessions = await this.getSessions();\n \n if (sessions.length === 0) {\n const error = new Error(\"No sessions found\");\n (error as any).code = \"NO_SESSIONS\";\n throw error;\n }\n\n // Fetch messages for all sessions in parallel (with concurrency limit)\n const results: SessionWithMessages[] = [];\n const batchSize = 10;\n \n for (let i = 0; i < sessions.length; i += batchSize) {\n const batch = sessions.slice(i, i + batchSize);\n const batchResults = await Promise.all(\n batch.map(async (session) => ({\n session,\n messages: await this.getSessionMessages(session.id),\n }))\n );\n results.push(...batchResults);\n }\n\n return results;\n }\n}\n```\n\n#### Types (`src/data/types.ts`)\n\n```typescript\nexport interface Session {\n id: string;\n title?: string;\n createdAt: string;\n updatedAt: string;\n}\n\nexport interface Message {\n id: string;\n sessionID: string;\n role: \"user\" | \"assistant\" | \"system\";\n createdAt: string;\n info: {\n model?: {\n providerID: string;\n modelID: string;\n };\n tokens?: {\n input: number;\n output: number;\n reasoning?: number;\n cache?: {\n read: number;\n write: number;\n };\n };\n cost?: number;\n };\n}\n\nexport interface Part {\n id: string;\n type: \"text\" | \"tool-invocation\" | \"tool-result\" | \"file\" | \"step-start\";\n content?: string;\n}\n\nexport interface MessageWithParts {\n info: Message;\n parts: Part[];\n}\n\nexport interface SessionWithMessages {\n session: Session;\n messages: MessageWithParts[];\n}\n```\n\n### 4. Statistics Engine (`src/stats/`)\n\n#### Main Engine (`src/stats/engine.ts`)\n\n```typescript\nimport { DataProvider, SessionWithMessages } from \"../data/types\";\nimport { calculateStreaks } from \"./streaks\";\nimport { generateFunFact } from \"./funfacts\";\n\nexport interface StatsResult {\n period: {\n start: Date;\n end: Date;\n days: number;\n };\n summary: {\n totalSessions: number;\n totalTokens: number;\n totalMessages: number;\n activeDays: number;\n currentStreak: number;\n longestStreak: number;\n longestSession: {\n id: string;\n durationMinutes: number;\n };\n peakHour: number;\n favoriteModel: string;\n totalCost: number;\n };\n dailyActivity: DailyActivity[];\n modelUsage: ModelUsage[];\n funFact: string;\n}\n\nexport interface DailyActivity {\n date: string;\n sessionCount: number;\n messageCount: number;\n totalTokens: number;\n}\n\nexport interface ModelUsage {\n modelID: string;\n providerID: string;\n messageCount: number;\n totalTokens: number;\n percentage: number;\n}\n\nexport class StatsEngine {\n constructor(private dataProvider: DataProvider) {}\n\n async computeStats(options: { period: string }): Promise<StatsResult> {\n const allData = await this.dataProvider.getAllData();\n \n // Filter by period\n const from = this.getPeriodStart(options.period);\n const filtered = from\n ? allData.filter(d => new Date(d.session.createdAt) >= from)\n : allData;\n\n if (filtered.length === 0) {\n const error = new Error(\"No sessions in selected period\");\n (error as any).code = \"NO_SESSIONS\";\n throw error;\n }\n\n const dailyActivity = this.computeDailyActivity(filtered);\n const modelUsage = this.computeModelUsage(filtered);\n const summary = this.computeSummary(filtered, dailyActivity);\n \n const result: StatsResult = {\n period: this.computePeriod(filtered, from),\n summary,\n dailyActivity,\n modelUsage,\n funFact: \"\",\n };\n\n result.funFact = generateFunFact(result);\n return result;\n }\n\n private getPeriodStart(period: string): Date | null {\n const now = new Date();\n switch (period) {\n case \"week\":\n return new Date(now.getTime() - 7 * 24 * 60 * 60 * 1000);\n case \"month\":\n return new Date(now.getTime() - 30 * 24 * 60 * 60 * 1000);\n case \"year\":\n return new Date(now.getTime() - 365 * 24 * 60 * 60 * 1000);\n default:\n return null;\n }\n }\n\n private computePeriod(data: SessionWithMessages[], from: Date | null): StatsResult[\"period\"] {\n const now = new Date();\n const earliest = from || new Date(\n Math.min(...data.map(d => new Date(d.session.createdAt).getTime()))\n );\n \n return {\n start: earliest,\n end: now,\n days: Math.ceil((now.getTime() - earliest.getTime()) / (24 * 60 * 60 * 1000)),\n };\n }\n\n private computeSummary(\n data: SessionWithMessages[],\n dailyActivity: DailyActivity[]\n ): StatsResult[\"summary\"] {\n let totalTokens = 0;\n let totalMessages = 0;\n let totalCost = 0;\n const hourCounts = new Array(24).fill(0);\n const modelCounts = new Map<string, number>();\n const activeDaysSet = new Set<string>();\n let longestSession = { id: \"\", durationMinutes: 0 };\n\n for (const { session, messages } of data) {\n const date = new Date(session.createdAt).toISOString().split(\"T\")[0];\n activeDaysSet.add(date);\n\n // Calculate session duration\n if (messages.length >= 2) {\n const first = new Date(messages[0].info.createdAt).getTime();\n const last = new Date(messages[messages.length - 1].info.createdAt).getTime();\n const duration = (last - first) / (1000 * 60);\n \n if (duration > longestSession.durationMinutes) {\n longestSession = { id: session.id, durationMinutes: Math.round(duration) };\n }\n }\n\n for (const { info } of messages) {\n totalMessages++;\n \n if (info.tokens) {\n totalTokens += (info.tokens.input || 0) + (info.tokens.output || 0);\n if (info.tokens.reasoning) totalTokens += info.tokens.reasoning;\n }\n \n if (info.cost) totalCost += info.cost;\n\n const hour = new Date(info.createdAt).getHours();\n hourCounts[hour]++;\n\n if (info.model) {\n const key = info.model.modelID;\n modelCounts.set(key, (modelCounts.get(key) || 0) + 1);\n }\n }\n }\n\n const peakHour = hourCounts.indexOf(Math.max(...hourCounts));\n \n let favoriteModel = \"Unknown\";\n let maxCount = 0;\n for (const [model, count] of modelCounts) {\n if (count > maxCount) {\n maxCount = count;\n favoriteModel = model;\n }\n }\n\n const streaks = calculateStreaks(dailyActivity);\n\n return {\n totalSessions: data.length,\n totalTokens,\n totalMessages,\n activeDays: activeDaysSet.size,\n currentStreak: streaks.current,\n longestStreak: streaks.longest,\n longestSession,\n peakHour,\n favoriteModel,\n totalCost,\n };\n }\n\n private computeDailyActivity(data: SessionWithMessages[]): DailyActivity[] {\n const map = new Map<string, DailyActivity>();\n\n for (const { session, messages } of data) {\n const date = new Date(session.createdAt).toISOString().split(\"T\")[0];\n \n const existing = map.get(date) || {\n date,\n sessionCount: 0,\n messageCount: 0,\n totalTokens: 0,\n };\n\n existing.sessionCount++;\n existing.messageCount += messages.length;\n \n for (const { info } of messages) {\n if (info.tokens) {\n existing.totalTokens += (info.tokens.input || 0) + (info.tokens.output || 0);\n }\n }\n\n map.set(date, existing);\n }\n\n return Array.from(map.values()).sort((a, b) => a.date.localeCompare(b.date));\n }\n\n private computeModelUsage(data: SessionWithMessages[]): ModelUsage[] {\n const map = new Map<string, ModelUsage>();\n let total = 0;\n\n for (const { messages } of data) {\n for (const { info } of messages) {\n if (info.model) {\n const key = `${info.model.providerID}/${info.model.modelID}`;\n \n const existing = map.get(key) || {\n modelID: info.model.modelID,\n providerID: info.model.providerID,\n messageCount: 0,\n totalTokens: 0,\n percentage: 0,\n };\n\n existing.messageCount++;\n total++;\n \n if (info.tokens) {\n existing.totalTokens += (info.tokens.input || 0) + (info.tokens.output || 0);\n }\n\n map.set(key, existing);\n }\n }\n }\n\n const models = Array.from(map.values());\n for (const model of models) {\n model.percentage = total > 0 ? (model.messageCount / total) * 100 : 0;\n }\n\n return models.sort((a, b) => b.percentage - a.percentage);\n }\n}\n```\n\n#### Streaks Calculator (`src/stats/streaks.ts`)\n\n```typescript\nimport { DailyActivity } from \"./engine\";\n\nexport interface StreakResult {\n current: number;\n longest: number;\n}\n\nexport function calculateStreaks(dailyActivity: DailyActivity[]): StreakResult {\n if (dailyActivity.length === 0) {\n return { current: 0, longest: 0 };\n }\n\n const sorted = [...dailyActivity].sort((a, b) => a.date.localeCompare(b.date));\n const activeDates = new Set(sorted.map(d => d.date));\n \n let longest = 0;\n let current = 0;\n let streak = 0;\n let prevDate: Date | null = null;\n\n // Check all dates from first activity to today\n const startDate = new Date(sorted[0].date);\n const today = new Date();\n today.setHours(0, 0, 0, 0);\n\n for (let d = new Date(startDate); d <= today; d.setDate(d.getDate() + 1)) {\n const dateStr = d.toISOString().split(\"T\")[0];\n \n if (activeDates.has(dateStr)) {\n streak++;\n if (streak > longest) longest = streak;\n } else {\n streak = 0;\n }\n }\n\n // Current streak: count backwards from today\n current = 0;\n for (let d = new Date(today); ; d.setDate(d.getDate() - 1)) {\n const dateStr = d.toISOString().split(\"T\")[0];\n if (activeDates.has(dateStr)) {\n current++;\n } else {\n break;\n }\n }\n\n return { current, longest };\n}\n```\n\n#### Fun Facts Generator (`src/stats/funfacts.ts`)\n\n```typescript\nimport { StatsResult } from \"./engine\";\n\ninterface FunFact {\n check: (stats: StatsResult) => boolean;\n generate: (stats: StatsResult) => string;\n}\n\nconst INCEPTION_MINUTES = 148;\nconst WAR_AND_PEACE_WORDS = 587287;\nconst AVERAGE_VACATION_DAYS = 7;\nconst HARRY_POTTER_WORDS = 1084170;\nconst LOTR_TRILOGY_MINUTES = 558;\n\nconst FUN_FACTS: FunFact[] = [\n {\n check: (s) => s.summary.longestSession.durationMinutes > INCEPTION_MINUTES,\n generate: (s) => {\n const times = Math.round(s.summary.longestSession.durationMinutes / INCEPTION_MINUTES);\n return `Your longest session is ~${times}x longer than the movie Inception`;\n },\n },\n {\n check: (s) => s.summary.longestSession.durationMinutes > LOTR_TRILOGY_MINUTES,\n generate: (s) => {\n const times = (s.summary.longestSession.durationMinutes / LOTR_TRILOGY_MINUTES).toFixed(1);\n return `Your longest session is ${times}x the entire Lord of the Rings trilogy`;\n },\n },\n {\n check: (s) => s.summary.totalTokens > WAR_AND_PEACE_WORDS,\n generate: (s) => {\n const times = Math.round(s.summary.totalTokens / WAR_AND_PEACE_WORDS);\n return `You've used ${times}x more tokens than words in War and Peace`;\n },\n },\n {\n check: (s) => s.summary.totalTokens > HARRY_POTTER_WORDS,\n generate: (s) => {\n const times = Math.round(s.summary.totalTokens / HARRY_POTTER_WORDS);\n return `You've processed ${times}x more tokens than words in all Harry Potter books`;\n },\n },\n {\n check: (s) => s.summary.currentStreak > AVERAGE_VACATION_DAYS,\n generate: (s) => \n `Your ${s.summary.currentStreak}-day streak is longer than the average vacation`,\n },\n {\n check: (s) => s.summary.longestStreak >= 30,\n generate: (s) => \n `Your ${s.summary.longestStreak}-day streak means you coded with AI for a whole month straight!`,\n },\n {\n check: (s) => s.summary.peakHour >= 22 || s.summary.peakHour <= 4,\n generate: () => `You're a night owl coder - your peak activity is after dark`,\n },\n {\n check: (s) => s.summary.peakHour >= 5 && s.summary.peakHour <= 7,\n generate: () => `Early bird catches the bugs - you code best at dawn`,\n },\n {\n check: (s) => s.summary.totalSessions >= 100,\n generate: (s) => `${s.summary.totalSessions} sessions! You're an AI-assisted coding power user`,\n },\n {\n check: (s) => s.summary.totalMessages >= 1000,\n generate: (s) => `${s.summary.totalMessages.toLocaleString()} messages - that's a lot of back-and-forth!`,\n },\n];\n\nexport function generateFunFact(stats: StatsResult): string {\n const applicable = FUN_FACTS.filter((f) => f.check(stats));\n \n if (applicable.length === 0) {\n return `You've had ${stats.summary.totalSessions} coding sessions - keep going!`;\n }\n \n // Pick a random applicable fun fact\n const random = applicable[Math.floor(Math.random() * applicable.length)];\n return random.generate(stats);\n}\n```\n\n### 5. Renderer (`src/render/`)\n\n#### Main Renderer (`src/render/index.ts`)\n\n```typescript\nimport { StatsResult } from \"../stats/engine\";\nimport { Config } from \"../cli\";\nimport { renderPretty } from \"./pretty\";\nimport { renderPlain } from \"./plain\";\nimport { renderJson } from \"./json\";\n\nexport function render(stats: StatsResult, config: Config): string {\n switch (config.format) {\n case \"json\":\n return renderJson(stats);\n case \"plain\":\n return renderPlain(stats, config);\n case \"pretty\":\n default:\n return renderPretty(stats, config);\n }\n}\n```\n\n#### Pretty Renderer (`src/render/pretty.ts`)\n\n```typescript\nimport { StatsResult } from \"../stats/engine\";\nimport { Config } from \"../cli\";\nimport { renderHeatmap } from \"./components/heatmap\";\nimport { renderDashboard } from \"./components/dashboard\";\nimport { renderModels } from \"./components/models\";\nimport { box } from \"./components/box\";\n\n// ANSI color codes\nconst colors = {\n reset: \"\\x1b[0m\",\n bold: \"\\x1b[1m\",\n dim: \"\\x1b[2m\",\n orange: \"\\x1b[38;5;208m\",\n yellow: \"\\x1b[33m\",\n blue: \"\\x1b[34m\",\n cyan: \"\\x1b[36m\",\n gray: \"\\x1b[90m\",\n};\n\nexport function renderPretty(stats: StatsResult, config: Config): string {\n const c = config.noColor ? noColors : colors;\n const lines: string[] = [];\n\n if (config.view === \"overview\" || config.view === \"heatmap\") {\n lines.push(\"\");\n lines.push(...renderHeatmap(stats.dailyActivity, { \n width: config.width, \n colors: !config.noColor \n }));\n }\n\n if (config.view === \"overview\") {\n lines.push(\"\");\n lines.push(...renderDashboard(stats.summary, c));\n lines.push(\"\");\n lines.push(` ${c.yellow}${stats.funFact}${c.reset}`);\n lines.push(` ${c.dim}Stats from the last ${stats.period.days} days${c.reset}`);\n }\n\n if (config.view === \"models\") {\n lines.push(\"\");\n lines.push(...renderModels(stats.modelUsage, { width: config.width, colors: !config.noColor }));\n }\n\n lines.push(\"\");\n \n return box(lines, { width: config.width, title: \"OpenCode Stats\" });\n}\n\nconst noColors = {\n reset: \"\",\n bold: \"\",\n dim: \"\",\n orange: \"\",\n yellow: \"\",\n blue: \"\",\n cyan: \"\",\n gray: \"\",\n};\n```\n\n#### Heatmap Component (`src/render/components/heatmap.ts`)\n\n```typescript\nimport { DailyActivity } from \"../../stats/engine\";\n\nconst CHARS = [\"·\", \"░\", \"▒\", \"▓\", \"█\"];\nconst DAYS = [\"Sun\", \"Mon\", \"Tue\", \"Wed\", \"Thu\", \"Fri\", \"Sat\"];\nconst MONTHS = [\"Jan\", \"Feb\", \"Mar\", \"Apr\", \"May\", \"Jun\", \"Jul\", \"Aug\", \"Sep\", \"Oct\", \"Nov\", \"Dec\"];\n\ninterface HeatmapOptions {\n width: number;\n colors: boolean;\n weeks?: number;\n}\n\nexport function renderHeatmap(dailyActivity: DailyActivity[], options: HeatmapOptions): string[] {\n const weeks = options.weeks || 52;\n const lines: string[] = [];\n \n // Build activity map\n const activityMap = new Map<string, number>();\n for (const day of dailyActivity) {\n activityMap.set(day.date, day.sessionCount);\n }\n\n // Calculate max for intensity scaling\n const maxActivity = Math.max(...dailyActivity.map(d => d.sessionCount), 1);\n \n const getIntensity = (count: number): number => {\n if (count === 0) return 0;\n const normalized = count / maxActivity;\n return Math.min(4, Math.ceil(normalized * 4));\n };\n\n const getChar = (count: number): string => {\n return CHARS[getIntensity(count)];\n };\n\n // Generate dates for the heatmap (last N weeks)\n const today = new Date();\n const startDate = new Date(today);\n startDate.setDate(startDate.getDate() - (weeks * 7) + (7 - today.getDay()));\n\n // Month header\n let monthHeader = \" \";\n let currentMonth = -1;\n for (let week = 0; week < weeks; week++) {\n const weekStart = new Date(startDate);\n weekStart.setDate(weekStart.getDate() + week * 7);\n const month = weekStart.getMonth();\n \n if (month !== currentMonth) {\n monthHeader += MONTHS[month].padEnd(4);\n currentMonth = month;\n } else {\n monthHeader += \" \";\n }\n }\n lines.push(monthHeader.trimEnd());\n\n // Day rows (only show Mon, Wed, Fri for compact view)\n const showDays = [1, 3, 5]; // Mon, Wed, Fri\n \n for (const dayOfWeek of showDays) {\n let row = DAYS[dayOfWeek].padStart(4) + \" \";\n \n for (let week = 0; week < weeks; week++) {\n const date = new Date(startDate);\n date.setDate(date.getDate() + week * 7 + dayOfWeek);\n \n if (date > today) {\n row += \" \";\n continue;\n }\n \n const dateStr = date.toISOString().split(\"T\")[0];\n const count = activityMap.get(dateStr) || 0;\n row += getChar(count) + \" \";\n }\n \n lines.push(row.trimEnd());\n }\n\n // Legend\n lines.push(\"\");\n lines.push(\" Less \" + CHARS.join(\" \") + \" More\");\n\n return lines;\n}\n```\n\n#### Dashboard Component (`src/render/components/dashboard.ts`)\n\n```typescript\nimport { StatsResult } from \"../../stats/engine\";\n\ninterface Colors {\n reset: string;\n bold: string;\n dim: string;\n orange: string;\n yellow: string;\n blue: string;\n cyan: string;\n gray: string;\n}\n\nexport function renderDashboard(summary: StatsResult[\"summary\"], c: Colors): string[] {\n const lines: string[] = [];\n\n const formatDuration = (minutes: number): string => {\n if (minutes < 60) return `${minutes}m`;\n const hours = Math.floor(minutes / 60);\n const mins = minutes % 60;\n if (hours < 24) return `${hours}h ${mins}m`;\n const days = Math.floor(hours / 24);\n const remainingHours = hours % 24;\n return `${days}d ${remainingHours}h ${mins}m`;\n };\n\n const formatNumber = (n: number): string => {\n if (n >= 1_000_000) return `${(n / 1_000_000).toFixed(1)}m`;\n if (n >= 1_000) return `${(n / 1_000).toFixed(1)}k`;\n return n.toString();\n };\n\n const formatCost = (cost: number): string => {\n return `$${cost.toFixed(2)}`;\n };\n\n // Two-column layout\n const left = [\n `${c.dim}Favorite model:${c.reset} ${c.orange}${summary.favoriteModel}${c.reset}`,\n \"\",\n `${c.dim}Sessions:${c.reset} ${c.bold}${summary.totalSessions}${c.reset}`,\n `${c.dim}Current streak:${c.reset} ${c.bold}${summary.currentStreak}${c.reset} days`,\n `${c.dim}Active days:${c.reset} ${c.bold}${summary.activeDays}${c.reset}`,\n ];\n\n const right = [\n `${c.dim}Total tokens:${c.reset} ${c.cyan}${formatNumber(summary.totalTokens)}${c.reset}`,\n \"\",\n `${c.dim}Longest session:${c.reset} ${c.bold}${formatDuration(summary.longestSession.durationMinutes)}${c.reset}`,\n `${c.dim}Longest streak:${c.reset} ${c.bold}${summary.longestStreak}${c.reset} days`,\n `${c.dim}Peak hour:${c.reset} ${c.bold}${summary.peakHour}:00-${summary.peakHour + 1}:00${c.reset}`,\n ];\n\n // Calculate column width (strip ANSI codes for measurement)\n const stripAnsi = (s: string) => s.replace(/\\x1b\\[[0-9;]*m/g, \"\");\n const leftWidth = Math.max(...left.map(l => stripAnsi(l).length));\n const gap = 4;\n\n for (let i = 0; i < left.length; i++) {\n const leftPadded = left[i] + \" \".repeat(leftWidth - stripAnsi(left[i]).length + gap);\n lines.push(\" \" + leftPadded + right[i]);\n }\n\n return lines;\n}\n```\n\n#### Models Component (`src/render/components/models.ts`)\n\n```typescript\nimport { ModelUsage } from \"../../stats/engine\";\n\ninterface ModelsOptions {\n width: number;\n colors: boolean;\n}\n\nexport function renderModels(models: ModelUsage[], options: ModelsOptions): string[] {\n const lines: string[] = [];\n const barWidth = Math.min(30, options.width - 45);\n\n lines.push(\" Model Usage\");\n lines.push(\"\");\n\n for (const model of models.slice(0, 6)) {\n const filled = Math.round((model.percentage / 100) * barWidth);\n const empty = barWidth - filled;\n const bar = \"█\".repeat(filled) + \"░\".repeat(empty);\n const label = model.modelID.slice(0, 28).padEnd(28);\n const pct = `${Math.round(model.percentage)}%`.padStart(4);\n \n lines.push(` ${label} ${bar} ${pct}`);\n }\n\n return lines;\n}\n```\n\n#### Box Component (`src/render/components/box.ts`)\n\n```typescript\ninterface BoxOptions {\n width: number;\n title?: string;\n}\n\nexport function box(content: string[], options: BoxOptions): string {\n const width = options.width - 2;\n const lines: string[] = [];\n \n // Top border with title\n if (options.title) {\n const titlePart = `─ ${options.title} `;\n const remaining = width - titlePart.length - 1;\n lines.push(\"┌\" + titlePart + \"─\".repeat(remaining) + \"┐\");\n } else {\n lines.push(\"┌\" + \"─\".repeat(width) + \"┐\");\n }\n\n // Content\n const stripAnsi = (s: string) => s.replace(/\\x1b\\[[0-9;]*m/g, \"\");\n \n for (const line of content) {\n const visibleLength = stripAnsi(line).length;\n const padding = Math.max(0, width - visibleLength - 2);\n lines.push(\"│ \" + line + \" \".repeat(padding) + \" │\");\n }\n\n // Bottom border\n lines.push(\"└\" + \"─\".repeat(width) + \"┘\");\n\n return lines.join(\"\\n\");\n}\n```\n\n#### JSON Renderer (`src/render/json.ts`)\n\n```typescript\nimport { StatsResult } from \"../stats/engine\";\n\nexport function renderJson(stats: StatsResult): string {\n return JSON.stringify(stats, null, 2);\n}\n```\n\n---\n\n## Dependencies\n\n```json\n{\n \"name\": \"opencode-stats\",\n \"version\": \"1.0.0\",\n \"description\": \"Spotify Wrapped-style statistics for OpenCode\",\n \"type\": \"module\",\n \"bin\": {\n \"opencode-stats\": \"./dist/index.js\"\n },\n \"scripts\": {\n \"build\": \"bun build src/index.ts --outdir dist --target node\",\n \"dev\": \"bun run src/index.ts\",\n \"typecheck\": \"tsc --noEmit\"\n },\n \"dependencies\": {\n \"@opencode-ai/sdk\": \"latest\"\n },\n \"devDependencies\": {\n \"@types/bun\": \"latest\",\n \"@types/node\": \"^20\",\n \"typescript\": \"^5.0.0\"\n },\n \"engines\": {\n \"node\": \">=18\"\n }\n}\n```\n\n---\n\n## Data Flow\n\n```\n┌────────────────────────────────────────────────────────────┐\n│ User runs: opencode-stats │\n└────────────────────────────────────────────────────────────┘\n │\n ▼\n┌────────────────────────────────────────────────────────────┐\n│ CLI Argument Parser │\n│ - Parse --period, --view, --format options │\n│ - Validate inputs │\n│ - Return Config object │\n└────────────────────────────────────────────────────────────┘\n │\n ▼\n┌────────────────────────────────────────────────────────────┐\n│ Data Provider │\n│ - Connect to OpenCode SDK │\n│ - Fetch all sessions via client.session.list() │\n│ - Fetch messages for each session │\n│ - Return SessionWithMessages[] │\n└────────────────────────────────────────────────────────────┘\n │\n ▼\n┌────────────────────────────────────────────────────────────┐\n│ Stats Engine │\n│ - Filter by period │\n│ - Compute daily activity │\n│ - Compute model usage │\n│ - Compute summary stats │\n│ - Calculate streaks │\n│ - Generate fun fact │\n│ - Return StatsResult │\n└────────────────────────────────────────────────────────────┘\n │\n ▼\n┌────────────────────────────────────────────────────────────┐\n│ Renderer │\n│ - Select format (pretty/plain/json) │\n│ - Compose view (overview/models/heatmap) │\n│ - Generate output string │\n└────────────────────────────────────────────────────────────┘\n │\n ▼\n┌────────────────────────────────────────────────────────────┐\n│ console.log(output) │\n└────────────────────────────────────────────────────────────┘\n```\n\n---\n\n## Installation & Usage\n\n### Installation\n\n```bash\n# Global install\nnpm install -g opencode-stats\n\n# Or run directly with bunx/npx\nbunx opencode-stats\nnpx opencode-stats\n```\n\n### Usage Examples\n\n```bash\n# Basic usage - show monthly overview\nopencode-stats\n\n# Different periods\nopencode-stats --period week\nopencode-stats --period year\nopencode-stats --period all\n\n# Different views\nopencode-stats --view models\nopencode-stats --view heatmap\n\n# Output formats\nopencode-stats --format json > stats.json\nopencode-stats --format plain # for piping\n\n# Options\nopencode-stats --no-color\nopencode-stats --width 120\n```\n\n---\n\n## Error Handling\n\n| Error | Message | Exit Code |\n|-------|---------|-----------|\n| No sessions | \"No OpenCode sessions found. Start using OpenCode first!\" | 2 |\n| SDK error | \"Error connecting to OpenCode: {details}\" | 3 |\n| Invalid args | \"Invalid option: {option}\" | 1 |\n\n---\n\n## Future Improvements\n\n1. **Watch mode:** `opencode-stats --watch` for live updates\n2. **Export:** `opencode-stats --export png` to generate images\n3. **Compare:** `opencode-stats --compare last-month` to show changes\n4. **Filter by project:** `opencode-stats --project ./my-project`\n5. **Interactive mode:** TUI with keyboard navigation\n" | |
| }, | |
| "output": "", | |
| "title": "Users/themishkun/projects/tinkering/opencode-stats/ARCHITECTURE.md", | |
| "metadata": { | |
| "diagnostics": {}, | |
| "filepath": "/Users/themishkun/projects/tinkering/opencode-stats/ARCHITECTURE.md", | |
| "exists": true | |
| }, | |
| "time": { | |
| "start": 1766500963947, | |
| "end": 1766500963950 | |
| } | |
| } | |
| }, | |
| { | |
| "id": "prt_b4ba996b4001CeyKATr2t6mWIv", | |
| "sessionID": "ses_4b8933352ffe2k7Q7VhaAWbJcB", | |
| "messageID": "msg_b4ba7c2f8001OdnwZI2RhYAqZk", | |
| "type": "step-finish", | |
| "reason": "tool-calls", | |
| "cost": 0, | |
| "tokens": { | |
| "input": 1, | |
| "output": 10581, | |
| "reasoning": 0, | |
| "cache": { | |
| "read": 55496, | |
| "write": 228 | |
| } | |
| } | |
| } | |
| ] | |
| }, | |
| { | |
| "info": { | |
| "id": "msg_b4ba996c2001KVqm2Mi5UgEoZo", | |
| "sessionID": "ses_4b8933352ffe2k7Q7VhaAWbJcB", | |
| "role": "assistant", | |
| "time": { | |
| "created": 1766500964034, | |
| "completed": 1766500969615 | |
| }, | |
| "parentID": "msg_b4ba6ef4b001MfFyRjB5r8ijUq", | |
| "modelID": "claude-opus-4-5", | |
| "providerID": "anthropic", | |
| "mode": "build", | |
| "agent": "build", | |
| "path": { | |
| "cwd": "/Users/themishkun/projects/tinkering/opencode-stats", | |
| "root": "/" | |
| }, | |
| "cost": 0, | |
| "tokens": { | |
| "input": 1, | |
| "output": 118, | |
| "reasoning": 0, | |
| "cache": { | |
| "read": 55724, | |
| "write": 10607 | |
| } | |
| }, | |
| "finish": "tool-calls" | |
| }, | |
| "parts": [ | |
| { | |
| "id": "prt_b4ba9a64e001m3rVCZg8HFP05X", | |
| "sessionID": "ses_4b8933352ffe2k7Q7VhaAWbJcB", | |
| "messageID": "msg_b4ba996c2001KVqm2Mi5UgEoZo", | |
| "type": "step-start" | |
| }, | |
| { | |
| "id": "prt_b4ba9a650001k9S6Yp93gBiWDF", | |
| "sessionID": "ses_4b8933352ffe2k7Q7VhaAWbJcB", | |
| "messageID": "msg_b4ba996c2001KVqm2Mi5UgEoZo", | |
| "type": "tool", | |
| "callID": "toolu_01CgfXM8i5XNMRdmRHJTAdMF", | |
| "tool": "todowrite", | |
| "state": { | |
| "status": "completed", | |
| "input": { | |
| "todos": [ | |
| { | |
| "id": "1", | |
| "content": "Update PRD.md for CLI app approach", | |
| "status": "completed", | |
| "priority": "high" | |
| }, | |
| { | |
| "id": "2", | |
| "content": "Update ARCHITECTURE.md for CLI app approach", | |
| "status": "completed", | |
| "priority": "high" | |
| } | |
| ] | |
| }, | |
| "output": "[\n {\n \"id\": \"1\",\n \"content\": \"Update PRD.md for CLI app approach\",\n \"status\": \"completed\",\n \"priority\": \"high\"\n },\n {\n \"id\": \"2\",\n \"content\": \"Update ARCHITECTURE.md for CLI app approach\",\n \"status\": \"completed\",\n \"priority\": \"high\"\n }\n]", | |
| "title": "0 todos", | |
| "metadata": { | |
| "todos": [ | |
| { | |
| "id": "1", | |
| "content": "Update PRD.md for CLI app approach", | |
| "status": "completed", | |
| "priority": "high" | |
| }, | |
| { | |
| "id": "2", | |
| "content": "Update ARCHITECTURE.md for CLI app approach", | |
| "status": "completed", | |
| "priority": "high" | |
| } | |
| ] | |
| }, | |
| "time": { | |
| "start": 1766500969533, | |
| "end": 1766500969533 | |
| } | |
| } | |
| }, | |
| { | |
| "id": "prt_b4ba9ac8e001PF2I44B7RgukgO", | |
| "sessionID": "ses_4b8933352ffe2k7Q7VhaAWbJcB", | |
| "messageID": "msg_b4ba996c2001KVqm2Mi5UgEoZo", | |
| "type": "step-finish", | |
| "reason": "tool-calls", | |
| "cost": 0, | |
| "tokens": { | |
| "input": 1, | |
| "output": 118, | |
| "reasoning": 0, | |
| "cache": { | |
| "read": 55724, | |
| "write": 10607 | |
| } | |
| } | |
| } | |
| ] | |
| }, | |
| { | |
| "info": { | |
| "id": "msg_b4ba9ac980017i0jkm6Kdanklf", | |
| "sessionID": "ses_4b8933352ffe2k7Q7VhaAWbJcB", | |
| "role": "assistant", | |
| "time": { | |
| "created": 1766500969624, | |
| "completed": 1766500979493 | |
| }, | |
| "parentID": "msg_b4ba6ef4b001MfFyRjB5r8ijUq", | |
| "modelID": "claude-opus-4-5", | |
| "providerID": "anthropic", | |
| "mode": "build", | |
| "agent": "build", | |
| "path": { | |
| "cwd": "/Users/themishkun/projects/tinkering/opencode-stats", | |
| "root": "/" | |
| }, | |
| "cost": 0, | |
| "tokens": { | |
| "input": 1, | |
| "output": 280, | |
| "reasoning": 0, | |
| "cache": { | |
| "read": 66331, | |
| "write": 224 | |
| } | |
| }, | |
| "finish": "stop" | |
| }, | |
| "parts": [ | |
| { | |
| "id": "prt_b4ba9b86f001hAy1uu41xmnNEy", | |
| "sessionID": "ses_4b8933352ffe2k7Q7VhaAWbJcB", | |
| "messageID": "msg_b4ba9ac980017i0jkm6Kdanklf", | |
| "type": "step-start" | |
| }, | |
| { | |
| "id": "prt_b4ba9b875001AQwG5t7CKZ53bD", | |
| "sessionID": "ses_4b8933352ffe2k7Q7VhaAWbJcB", | |
| "messageID": "msg_b4ba9ac980017i0jkm6Kdanklf", | |
| "type": "text", | |
| "text": "Done! Both documents have been updated for the standalone CLI approach.\n\n## Summary of Changes\n\n### PRD.md\n- Changed from \"plugin\" to \"CLI app\"\n- Updated invocation from `/stats` slash command to `opencode-stats` CLI\n- Added full CLI argument specification (`--period`, `--view`, `--format`, etc.)\n- Added JSON output example for programmatic access\n- Updated distribution to npm package\n- Simplified timeline (no plugin marketplace concerns)\n\n### ARCHITECTURE.md\n- Complete rewrite as standalone CLI application\n- Uses `@opencode-ai/sdk` directly instead of plugin hooks\n- Simple entry point with `parseArgs` from Node.js\n- Data layer wraps the SDK client\n- Same stats engine and rendering components\n- Added box-drawing for nice terminal output\n- Full code examples for all components\n- Clear data flow diagram\n- Installation via npm/bunx\n\n### Key Benefits of CLI Approach\n1. **No plugin limitations** - Direct SDK access\n2. **Easier to develop/test** - Run independently\n3. **Wider distribution** - npm package, works anywhere\n4. **Simpler architecture** - No hooks/events needed\n5. **Multiple output formats** - JSON, plain text, pretty", | |
| "time": { | |
| "start": 1766500979393, | |
| "end": 1766500979393 | |
| } | |
| }, | |
| { | |
| "id": "prt_b4ba9d323001Q4iKazb0zJsyGu", | |
| "sessionID": "ses_4b8933352ffe2k7Q7VhaAWbJcB", | |
| "messageID": "msg_b4ba9ac980017i0jkm6Kdanklf", | |
| "type": "step-finish", | |
| "reason": "stop", | |
| "cost": 0, | |
| "tokens": { | |
| "input": 1, | |
| "output": 280, | |
| "reasoning": 0, | |
| "cache": { | |
| "read": 66331, | |
| "write": 224 | |
| } | |
| } | |
| } | |
| ] | |
| }, | |
| { | |
| "info": { | |
| "id": "msg_b4baa862c0018DD4qS37ADu7UN", | |
| "sessionID": "ses_4b8933352ffe2k7Q7VhaAWbJcB", | |
| "role": "user", | |
| "time": { | |
| "created": 1766501025330 | |
| }, | |
| "summary": { | |
| "title": "Counting file edits in sessions", | |
| "diffs": [] | |
| }, | |
| "agent": "build", | |
| "model": { | |
| "providerID": "anthropic", | |
| "modelID": "claude-opus-4-5" | |
| } | |
| }, | |
| "parts": [ | |
| { | |
| "id": "prt_b4baa862d001WFOGaF3OVyPVXZ", | |
| "sessionID": "ses_4b8933352ffe2k7Q7VhaAWbJcB", | |
| "messageID": "msg_b4baa862c0018DD4qS37ADu7UN", | |
| "type": "text", | |
| "text": "i also want to count file edits, if there is this data in sessions. maybe even more data could be proposed for fun?\n\nif you have any open questions - ask. if not, let's build this using subagents!" | |
| } | |
| ] | |
| }, | |
| { | |
| "info": { | |
| "id": "msg_b4baa8641001NPBty9b7oLWH2h", | |
| "sessionID": "ses_4b8933352ffe2k7Q7VhaAWbJcB", | |
| "role": "assistant", | |
| "time": { | |
| "created": 1766501025345, | |
| "completed": 1766501042219 | |
| }, | |
| "parentID": "msg_b4baa862c0018DD4qS37ADu7UN", | |
| "modelID": "claude-opus-4-5", | |
| "providerID": "anthropic", | |
| "mode": "build", | |
| "agent": "build", | |
| "path": { | |
| "cwd": "/Users/themishkun/projects/tinkering/opencode-stats", | |
| "root": "/" | |
| }, | |
| "cost": 0, | |
| "tokens": { | |
| "input": 3, | |
| "output": 491, | |
| "reasoning": 0, | |
| "cache": { | |
| "read": 66555, | |
| "write": 330 | |
| } | |
| }, | |
| "finish": "stop" | |
| }, | |
| "parts": [ | |
| { | |
| "id": "prt_b4baa99ba0013lYqXt1uDIvtbR", | |
| "sessionID": "ses_4b8933352ffe2k7Q7VhaAWbJcB", | |
| "messageID": "msg_b4baa8641001NPBty9b7oLWH2h", | |
| "type": "step-start" | |
| }, | |
| { | |
| "id": "prt_b4baa99bd001llVPCQmTS8ZKs2", | |
| "sessionID": "ses_4b8933352ffe2k7Q7VhaAWbJcB", | |
| "messageID": "msg_b4baa8641001NPBty9b7oLWH2h", | |
| "type": "text", | |
| "text": "Good idea! Let me check what data is actually available in OpenCode sessions to see what we can track.\n\n**Questions before building:**\n\n1. **File edits** - I assume these come from tool calls like `Edit`, `Write`, `Read` in the session messages. The `Part` type includes `tool-invocation` and `tool-result`. Do you want me to explore the actual OpenCode SDK/storage to see the exact schema, or should I assume standard tool names?\n\n2. **Additional fun stats ideas** - here's what I'm thinking we could track:\n\n | Stat | Source | Fun Fact Potential |\n |------|--------|-------------------|\n | Files edited | `Edit` tool calls | \"You've edited X files - that's a whole codebase!\" |\n | Files created | `Write` tool calls | \"You created X new files\" |\n | Files read | `Read` tool calls | \"You explored X files\" |\n | Lines of code changed | Tool metadata | \"X lines changed - more than Linux kernel v0.01\" |\n | Bash commands run | `Bash` tool calls | \"You ran X terminal commands\" |\n | Languages used | File extensions from tool calls | \"Your top language: TypeScript\" |\n | Largest file edited | Tool metadata | \"Biggest edit: 500 lines in app.tsx\" |\n | Most edited file | Count by filepath | \"Your most touched file: index.ts (47 edits)\" |\n | Tool usage breakdown | All tool calls | \"Favorite tool: Edit (used 234 times)\" |\n | Average session length | Timestamps | Compare to coffee breaks, meetings |\n | Time of day distribution | Message timestamps | \"You're 3x more productive after lunch\" |\n | Questions asked | User message count | \"You asked X questions\" |\n | Code blocks received | Assistant parts | \"AI wrote X code snippets for you\" |\n\n3. **Do you want me to explore the SDK first** to confirm what data is available, or just start building with reasonable assumptions and iterate?\n\nLet me know and I'll kick off the subagents to build this!", | |
| "time": { | |
| "start": 1766501042181, | |
| "end": 1766501042181 | |
| } | |
| }, | |
| { | |
| "id": "prt_b4baac829001uyePYuWqrWjm2d", | |
| "sessionID": "ses_4b8933352ffe2k7Q7VhaAWbJcB", | |
| "messageID": "msg_b4baa8641001NPBty9b7oLWH2h", | |
| "type": "step-finish", | |
| "reason": "stop", | |
| "cost": 0, | |
| "tokens": { | |
| "input": 3, | |
| "output": 491, | |
| "reasoning": 0, | |
| "cache": { | |
| "read": 66555, | |
| "write": 330 | |
| } | |
| } | |
| } | |
| ] | |
| }, | |
| { | |
| "info": { | |
| "id": "msg_b4badc04e001hWUUxXgTE32bEC", | |
| "sessionID": "ses_4b8933352ffe2k7Q7VhaAWbJcB", | |
| "role": "user", | |
| "time": { | |
| "created": 1766501236818 | |
| }, | |
| "summary": { | |
| "title": "Exploring OpenCode SDK schema", | |
| "diffs": [] | |
| }, | |
| "agent": "build", | |
| "model": { | |
| "providerID": "anthropic", | |
| "modelID": "claude-opus-4-5" | |
| } | |
| }, | |
| "parts": [ | |
| { | |
| "id": "prt_b4badc04e002VF1IPFfWcoQVgI", | |
| "sessionID": "ses_4b8933352ffe2k7Q7VhaAWbJcB", | |
| "messageID": "msg_b4badc04e001hWUUxXgTE32bEC", | |
| "type": "text", | |
| "text": "1. you should launch subagent to explore opencode sdk schema in ~/projects/opencode/\n\n2. lines of code changed, bash commands run, top language, time of day - nice. others - dump\n\n3. yes, explore" | |
| } | |
| ] | |
| }, | |
| { | |
| "info": { | |
| "id": "msg_b4badc075001ZfdxphyySLJ3IT", | |
| "sessionID": "ses_4b8933352ffe2k7Q7VhaAWbJcB", | |
| "role": "assistant", | |
| "time": { | |
| "created": 1766501236853, | |
| "completed": 1766501553897 | |
| }, | |
| "parentID": "msg_b4badc04e001hWUUxXgTE32bEC", | |
| "modelID": "claude-opus-4-5", | |
| "providerID": "anthropic", | |
| "mode": "build", | |
| "agent": "build", | |
| "path": { | |
| "cwd": "/Users/themishkun/projects/tinkering/opencode-stats", | |
| "root": "/" | |
| }, | |
| "cost": 0, | |
| "tokens": { | |
| "input": 3, | |
| "output": 361, | |
| "reasoning": 0, | |
| "cache": { | |
| "read": 66885, | |
| "write": 546 | |
| } | |
| }, | |
| "finish": "tool-calls" | |
| }, | |
| "parts": [ | |
| { | |
| "id": "prt_b4badd115001Qv1SMU4xO3LGPC", | |
| "sessionID": "ses_4b8933352ffe2k7Q7VhaAWbJcB", | |
| "messageID": "msg_b4badc075001ZfdxphyySLJ3IT", | |
| "type": "step-start" | |
| }, | |
| { | |
| "id": "prt_b4badd2ad001mw6DF8KSSCGfhS", | |
| "sessionID": "ses_4b8933352ffe2k7Q7VhaAWbJcB", | |
| "messageID": "msg_b4badc075001ZfdxphyySLJ3IT", | |
| "type": "tool", | |
| "callID": "toolu_013xUsGyiwkQUrHwBVTayPC1", | |
| "tool": "task", | |
| "state": { | |
| "status": "completed", | |
| "input": { | |
| "description": "Explore OpenCode SDK schema", | |
| "prompt": "Explore the OpenCode SDK in ~/projects/opencode/ to understand the exact schema for sessions, messages, and tool calls.\n\nI need to find:\n\n1. **Session schema** - What fields are available on a session object?\n2. **Message schema** - What fields are in message.info? What's in parts?\n3. **Tool call data** - How are tool invocations stored? What metadata is available?\n - Specifically looking for: Edit, Write, Read, Bash tool calls\n - Do they include file paths, line counts, command text?\n4. **Token/cost data** - Confirm the token counting fields\n\nFocus on:\n- `packages/sdk/` - The SDK package\n- `packages/opencode/src/` - Core types and storage\n- Look for TypeScript interfaces/types for Session, Message, Part, Tool\n- Look at how tool results are stored\n\nSearch for:\n- \"interface Session\"\n- \"interface Message\" \n- \"type Part\"\n- \"tool-invocation\"\n- \"tool-result\"\n- Storage/database schema files\n\nReturn a detailed summary of the data structures with field names and types. Include code snippets of the relevant interfaces.", | |
| "subagent_type": "explore" | |
| }, | |
| "output": "Perfect! Let me create one final master index:\n\n<task_metadata>\nsession_id: ses_4b452134fffeoGV0836YRVO5gn\n</task_metadata>", | |
| "title": "Explore OpenCode SDK schema", | |
| "metadata": { | |
| "summary": [ | |
| { | |
| "id": "prt_b4badf618001tMpOvC0xXnFANv", | |
| "tool": "bash", | |
| "state": { | |
| "status": "completed", | |
| "title": "Find TypeScript files in opencode project" | |
| } | |
| }, | |
| { | |
| "id": "prt_b4badf6ad0010HTn0JhOSkv70B", | |
| "tool": "list", | |
| "state": { | |
| "status": "completed", | |
| "title": "Users/themishkun/projects/opencode" | |
| } | |
| }, | |
| { | |
| "id": "prt_b4badff2b001WK0zNqAryz9yOe", | |
| "tool": "bash", | |
| "state": { | |
| "status": "completed", | |
| "title": "Find sdk and opencode package directories" | |
| } | |
| }, | |
| { | |
| "id": "prt_b4bae00b50016GJOHC4Na4657T", | |
| "tool": "glob", | |
| "state": { | |
| "status": "completed", | |
| "title": "Users/themishkun/projects/tinkering/opencode-stats" | |
| } | |
| }, | |
| { | |
| "id": "prt_b4bae06e0001eBHzHh5TQKlm37", | |
| "tool": "list", | |
| "state": { | |
| "status": "completed", | |
| "title": "Users/themishkun/projects/opencode/packages/sdk" | |
| } | |
| }, | |
| { | |
| "id": "prt_b4bae0765001agShJ06hcTWIZm", | |
| "tool": "list", | |
| "state": { | |
| "status": "completed", | |
| "title": "Users/themishkun/projects/opencode/packages/opencode" | |
| } | |
| }, | |
| { | |
| "id": "prt_b4bae0e3f001ESiT6fh8m0w3TV", | |
| "tool": "grep", | |
| "state": { | |
| "status": "completed", | |
| "title": "interface Session|type Session|export.*Session" | |
| } | |
| }, | |
| { | |
| "id": "prt_b4bae108a001K4XXiOoNQFH49o", | |
| "tool": "grep", | |
| "state": { | |
| "status": "completed", | |
| "title": "interface Message|type Message|export.*Message" | |
| } | |
| }, | |
| { | |
| "id": "prt_b4bae11f5001vxG0AVfS54w4u8", | |
| "tool": "grep", | |
| "state": { | |
| "status": "completed", | |
| "title": "tool-invocation|tool-result|ToolPart|ToolCall" | |
| } | |
| }, | |
| { | |
| "id": "prt_b4bae19df001vJ5HWbnRf2skKX", | |
| "tool": "read", | |
| "state": { | |
| "status": "completed", | |
| "title": "Users/themishkun/projects/opencode/packages/sdk/js/src/gen/types.gen.ts" | |
| } | |
| }, | |
| { | |
| "id": "prt_b4bae1c2a001ENSu8FwhZbGxk2", | |
| "tool": "read", | |
| "state": { | |
| "status": "completed", | |
| "title": "Users/themishkun/projects/opencode/packages/opencode/src/session/message-v2.ts" | |
| } | |
| }, | |
| { | |
| "id": "prt_b4bae1d740012h6aW3LZL7oqLs", | |
| "tool": "read", | |
| "state": { | |
| "status": "completed", | |
| "title": "Users/themishkun/projects/opencode/packages/opencode/src/session/message.ts" | |
| } | |
| }, | |
| { | |
| "id": "prt_b4bae3292001Kw5evS71tciFkG", | |
| "tool": "read", | |
| "state": { | |
| "status": "completed", | |
| "title": "Users/themishkun/projects/opencode/packages/opencode/src/session/message-v2.ts" | |
| } | |
| }, | |
| { | |
| "id": "prt_b4bae34fe001vf0CuDkgzmBCZP", | |
| "tool": "read", | |
| "state": { | |
| "status": "completed", | |
| "title": "Users/themishkun/projects/opencode/packages/opencode/src/session/message.ts" | |
| } | |
| }, | |
| { | |
| "id": "prt_b4bae36600010r4eqcBjdXVFoO", | |
| "tool": "read", | |
| "state": { | |
| "status": "completed", | |
| "title": "Users/themishkun/projects/opencode/packages/sdk/js/src/gen/types.gen.ts" | |
| } | |
| }, | |
| { | |
| "id": "prt_b4bae40eb001nzr29NjLfcw7AZ", | |
| "tool": "read", | |
| "state": { | |
| "status": "completed", | |
| "title": "Users/themishkun/projects/opencode/packages/sdk/js/src/gen/types.gen.ts" | |
| } | |
| }, | |
| { | |
| "id": "prt_b4bae4381001iJyPS4d2BHsLgh", | |
| "tool": "read", | |
| "state": { | |
| "status": "completed", | |
| "title": "Users/themishkun/projects/opencode/packages/sdk/js/src/gen/types.gen.ts" | |
| } | |
| }, | |
| { | |
| "id": "prt_b4bae50dd001ev1pEAxExtqZ0L", | |
| "tool": "grep", | |
| "state": { | |
| "status": "completed", | |
| "title": "export type ToolState|type ToolStatePending|type ToolStateRunning|type ToolStateCompleted|type ToolStateError" | |
| } | |
| }, | |
| { | |
| "id": "prt_b4bae53df001EDFsOEflowwttQ", | |
| "tool": "bash", | |
| "state": { | |
| "status": "completed", | |
| "title": "Find ToolState type definitions in SDK" | |
| } | |
| }, | |
| { | |
| "id": "prt_b4bae5f7f001fKf6IAlAo4oC27", | |
| "tool": "read", | |
| "state": { | |
| "status": "completed", | |
| "title": "Users/themishkun/projects/opencode/packages/sdk/js/src/gen/types.gen.ts" | |
| } | |
| }, | |
| { | |
| "id": "prt_b4bae68df001LlzgzPXVylyhaw", | |
| "tool": "read", | |
| "state": { | |
| "status": "completed", | |
| "title": "Users/themishkun/projects/opencode/packages/opencode/src/tool/edit.ts" | |
| } | |
| }, | |
| { | |
| "id": "prt_b4bae6a73001hPcWZOGjCFj5jj", | |
| "tool": "read", | |
| "state": { | |
| "status": "completed", | |
| "title": "Users/themishkun/projects/opencode/packages/opencode/src/tool/bash.ts" | |
| } | |
| }, | |
| { | |
| "id": "prt_b4bae6b93001rt3Tpd2P7mbM2c", | |
| "tool": "read", | |
| "state": { | |
| "status": "completed", | |
| "title": "Users/themishkun/projects/opencode/packages/opencode/src/tool/read.ts" | |
| } | |
| }, | |
| { | |
| "id": "prt_b4bae7b06001tKOHHt3KqG0uHi", | |
| "tool": "read", | |
| "state": { | |
| "status": "completed", | |
| "title": "Users/themishkun/projects/opencode/packages/opencode/src/tool/write.ts" | |
| } | |
| }, | |
| { | |
| "id": "prt_b4bae844a001K9gnHrWSY44Csq", | |
| "tool": "read", | |
| "state": { | |
| "status": "completed", | |
| "title": "Users/themishkun/projects/opencode/packages/opencode/src/tool/tool.ts" | |
| } | |
| }, | |
| { | |
| "id": "prt_b4bae8df30010zbBvQbZM0Fmg9", | |
| "tool": "read", | |
| "state": { | |
| "status": "completed", | |
| "title": "Users/themishkun/projects/opencode/packages/opencode/src/acp/types.ts" | |
| } | |
| }, | |
| { | |
| "id": "prt_b4bae9af9001blkRPR3lSXASre", | |
| "tool": "bash", | |
| "state": { | |
| "status": "completed", | |
| "title": "Find Session type definition" | |
| } | |
| }, | |
| { | |
| "id": "prt_b4baea3790016S7x1CqeD28Zhi", | |
| "tool": "read", | |
| "state": { | |
| "status": "completed", | |
| "title": "Users/themishkun/projects/opencode/packages/sdk/js/src/gen/types.gen.ts" | |
| } | |
| }, | |
| { | |
| "id": "prt_b4baeac85001JIdZy1dphb7qzo", | |
| "tool": "grep", | |
| "state": { | |
| "status": "completed", | |
| "title": "FileDiff|cost|tokens.*input.*output" | |
| } | |
| }, | |
| { | |
| "id": "prt_b4baeb3e4001rB39PLw1THqQt1", | |
| "tool": "read", | |
| "state": { | |
| "status": "completed", | |
| "title": "Users/themishkun/projects/opencode/packages/sdk/js/src/gen/types.gen.ts" | |
| } | |
| }, | |
| { | |
| "id": "prt_b4baebd5100135p3a7mKolA2g5", | |
| "tool": "bash", | |
| "state": { | |
| "status": "completed", | |
| "title": "Generate comprehensive schema documentation" | |
| } | |
| }, | |
| { | |
| "id": "prt_b4baf4f17001VDQqZ0QhcoYdwL", | |
| "tool": "bash", | |
| "state": { | |
| "status": "completed", | |
| "title": "Copy schema documentation to home directory" | |
| } | |
| }, | |
| { | |
| "id": "prt_b4bafeb7b001pFHE0m6yNuaGB9", | |
| "tool": "bash", | |
| "state": { | |
| "status": "completed", | |
| "title": "Create quick reference card" | |
| } | |
| }, | |
| { | |
| "id": "prt_b4bb042a8001uNn3km2rY3FJl2", | |
| "tool": "bash", | |
| "state": { | |
| "status": "completed", | |
| "title": "Create practical examples document" | |
| } | |
| }, | |
| { | |
| "id": "prt_b4bb0c9a0001Qv4ZAKYvZ7KUpN", | |
| "tool": "bash", | |
| "state": { | |
| "status": "completed", | |
| "title": "Create index document for all schema files" | |
| } | |
| }, | |
| { | |
| "id": "prt_b4bb13465001SV5Plr9cvBPx9G", | |
| "tool": "bash", | |
| "state": { | |
| "status": "completed", | |
| "title": "List created documentation files and their sizes" | |
| } | |
| }, | |
| { | |
| "id": "prt_b4bb13edc001gCigpNM7zKh3qi", | |
| "tool": "bash", | |
| "state": { | |
| "status": "completed", | |
| "title": "Create visual diagram documentation" | |
| } | |
| }, | |
| { | |
| "id": "prt_b4bb1e8c9001VOvjpo16pQQWdW", | |
| "tool": "bash", | |
| "state": { | |
| "status": "completed", | |
| "title": "Create main README file for schema documentation" | |
| } | |
| }, | |
| { | |
| "id": "prt_b4bb265b7001ElZ9s6oMqWo7xz", | |
| "tool": "bash", | |
| "state": { | |
| "status": "completed", | |
| "title": "Verify all documentation files created" | |
| } | |
| }, | |
| { | |
| "id": "prt_b4bb277ae001lWbsc7RNfY8Z6c", | |
| "tool": "bash", | |
| "state": { | |
| "status": "completed", | |
| "title": "Final verification of documentation" | |
| } | |
| }, | |
| { | |
| "id": "prt_b4bb282db001tJYBAIHB0CZfMa", | |
| "tool": "bash", | |
| "state": { | |
| "status": "error" | |
| } | |
| } | |
| ], | |
| "sessionId": "ses_4b452134fffeoGV0836YRVO5gn" | |
| }, | |
| "time": { | |
| "start": 1766501248176, | |
| "end": 1766501553893 | |
| } | |
| } | |
| }, | |
| { | |
| "id": "prt_b4bb296e6001m0tAW3Z23PlRex", | |
| "sessionID": "ses_4b8933352ffe2k7Q7VhaAWbJcB", | |
| "messageID": "msg_b4badc075001ZfdxphyySLJ3IT", | |
| "type": "step-finish", | |
| "reason": "tool-calls", | |
| "cost": 0, | |
| "tokens": { | |
| "input": 3, | |
| "output": 361, | |
| "reasoning": 0, | |
| "cache": { | |
| "read": 66885, | |
| "write": 546 | |
| } | |
| } | |
| } | |
| ] | |
| }, | |
| { | |
| "info": { | |
| "id": "msg_b4bb2970b001KPMI6WJGgM1jTx", | |
| "sessionID": "ses_4b8933352ffe2k7Q7VhaAWbJcB", | |
| "role": "assistant", | |
| "time": { | |
| "created": 1766501553931, | |
| "completed": 1766501560903 | |
| }, | |
| "parentID": "msg_b4badc04e001hWUUxXgTE32bEC", | |
| "modelID": "claude-opus-4-5", | |
| "providerID": "anthropic", | |
| "mode": "build", | |
| "agent": "build", | |
| "path": { | |
| "cwd": "/Users/themishkun/projects/tinkering/opencode-stats", | |
| "root": "/" | |
| }, | |
| "cost": 0, | |
| "tokens": { | |
| "input": 1, | |
| "output": 288, | |
| "reasoning": 0, | |
| "cache": { | |
| "read": 0, | |
| "write": 67853 | |
| } | |
| }, | |
| "finish": "tool-calls" | |
| }, | |
| "parts": [ | |
| { | |
| "id": "prt_b4bb2a3a7001OeRy14fye7JtlE", | |
| "sessionID": "ses_4b8933352ffe2k7Q7VhaAWbJcB", | |
| "messageID": "msg_b4bb2970b001KPMI6WJGgM1jTx", | |
| "type": "step-start" | |
| }, | |
| { | |
| "id": "prt_b4bb2a3ac001o1CykI2gbahcZf", | |
| "sessionID": "ses_4b8933352ffe2k7Q7VhaAWbJcB", | |
| "messageID": "msg_b4bb2970b001KPMI6WJGgM1jTx", | |
| "type": "text", | |
| "text": "The subagent seems to have finished but didn't return the findings. Let me do a quick targeted search myself:", | |
| "time": { | |
| "start": 1766501558198, | |
| "end": 1766501558198 | |
| } | |
| }, | |
| { | |
| "id": "prt_b4bb2a7b8001276ynSTkWPrLxC", | |
| "sessionID": "ses_4b8933352ffe2k7Q7VhaAWbJcB", | |
| "messageID": "msg_b4bb2970b001KPMI6WJGgM1jTx", | |
| "type": "tool", | |
| "callID": "toolu_013mqun4nwL7URu3HXaayhwM", | |
| "tool": "glob", | |
| "state": { | |
| "status": "error", | |
| "input": { | |
| "pattern": "**/*.ts", | |
| "path": "/Users/themishkun/projects/opencode/packages/sdk/src" | |
| }, | |
| "error": "Error: No such file or directory: '/Users/themishkun/projects/opencode/packages/sdk/src'", | |
| "time": { | |
| "start": 1766501558961, | |
| "end": 1766501558966 | |
| } | |
| } | |
| }, | |
| { | |
| "id": "prt_b4bb2aab40012p5LlDZFFMwDTI", | |
| "sessionID": "ses_4b8933352ffe2k7Q7VhaAWbJcB", | |
| "messageID": "msg_b4bb2970b001KPMI6WJGgM1jTx", | |
| "type": "tool", | |
| "callID": "toolu_01QbLkkGnZkrPUUZNbGLxJrU", | |
| "tool": "grep", | |
| "state": { | |
| "status": "completed", | |
| "input": { | |
| "pattern": "interface.*Session|type.*Session", | |
| "path": "/Users/themishkun/projects/opencode/packages", | |
| "include": "*.ts" | |
| }, | |
| "output": "Found 100 matches\n/Users/themishkun/projects/opencode/packages/sdk/js/src/gen/types.gen.ts:\n Line 528: export type Session = {\n Line 1212: export type EventSessionCompacted = {\n Line 1282: export type EventSessionIdle = {\n Line 1289: export type EventSessionCreated = {\n Line 1296: export type EventSessionUpdated = {\n Line 1303: export type EventSessionDeleted = {\n Line 1310: export type EventSessionError = {\n Line 1510: export type SessionListData = {\n Line 1519: export type SessionListResponses = {\n Line 1526: export type SessionListResponse = SessionListResponses[keyof SessionListResponses]\n Line 1528: export type SessionCreateData = {\n Line 1540: export type SessionCreateErrors = {\n Line 1547: export type SessionCreateError = SessionCreateErrors[keyof SessionCreateErrors]\n Line 1549: export type SessionCreateResponses = {\n Line 1556: export type SessionCreateResponse = SessionCreateResponses[keyof SessionCreateResponses]\n Line 1558: export type SessionDeleteData = {\n Line 1569: export type SessionDeleteErrors = {\n Line 1580: export type SessionDeleteError = SessionDeleteErrors[keyof SessionDeleteErrors]\n Line 1582: export type SessionDeleteResponses = {\n Line 1589: export type SessionDeleteResponse = SessionDeleteResponses[keyof SessionDeleteResponses]\n Line 1591: export type SessionGetData = {\n Line 1602: export type SessionGetErrors = {\n Line 1613: export type SessionGetError = SessionGetErrors[keyof SessionGetErrors]\n Line 1615: export type SessionGetResponses = {\n Line 1622: export type SessionGetResponse = SessionGetResponses[keyof SessionGetResponses]\n Line 1624: export type SessionUpdateData = {\n Line 1637: export type SessionUpdateErrors = {\n Line 1648: export type SessionUpdateError = SessionUpdateErrors[keyof SessionUpdateErrors]\n Line 1650: export type SessionUpdateResponses = {\n Line 1657: export type SessionUpdateResponse = SessionUpdateResponses[keyof SessionUpdateResponses]\n Line 1659: export type SessionChildrenData = {\n Line 1670: export type SessionChildrenErrors = {\n Line 1681: export type SessionChildrenError = SessionChildrenErrors[keyof SessionChildrenErrors]\n Line 1683: export type SessionChildrenResponses = {\n Line 1690: export type SessionChildrenResponse = SessionChildrenResponses[keyof SessionChildrenResponses]\n Line 1692: export type SessionTodoData = {\n Line 1706: export type SessionTodoErrors = {\n Line 1717: export type SessionTodoError = SessionTodoErrors[keyof SessionTodoErrors]\n Line 1719: export type SessionTodoResponses = {\n Line 1726: export type SessionTodoResponse = SessionTodoResponses[keyof SessionTodoResponses]\n Line 1728: export type SessionInitData = {\n Line 1746: export type SessionInitErrors = {\n Line 1757: export type SessionInitError = SessionInitErrors[keyof SessionInitErrors]\n Line 1759: export type SessionInitResponses = {\n Line 1766: export type SessionInitResponse = SessionInitResponses[keyof SessionInitResponses]\n Line 1768: export type SessionForkData = {\n Line 1781: export type SessionForkResponses = {\n Line 1788: export type SessionForkResponse = SessionForkResponses[keyof SessionForkResponses]\n Line 1790: export type SessionAbortData = {\n Line 1801: export type SessionAbortErrors = {\n Line 1812: export type SessionAbortError = SessionAbortErrors[keyof SessionAbortErrors]\n Line 1814: export type SessionAbortResponses = {\n Line 1821: export type SessionAbortResponse = SessionAbortResponses[keyof SessionAbortResponses]\n Line 1823: export type SessionUnshareData = {\n Line 1834: export type SessionUnshareErrors = {\n Line 1845: export type SessionUnshareError = SessionUnshareErrors[keyof SessionUnshareErrors]\n Line 1847: export type SessionUnshareResponses = {\n Line 1854: export type SessionUnshareResponse = SessionUnshareResponses[keyof SessionUnshareResponses]\n Line 1856: export type SessionShareData = {\n Line 1867: export type SessionShareErrors = {\n Line 1878: export type SessionShareError = SessionShareErrors[keyof SessionShareErrors]\n Line 1880: export type SessionShareResponses = {\n Line 1887: export type SessionShareResponse = SessionShareResponses[keyof SessionShareResponses]\n Line 1889: export type SessionDiffData = {\n Line 1904: export type SessionDiffErrors = {\n Line 1915: export type SessionDiffError = SessionDiffErrors[keyof SessionDiffErrors]\n Line 1917: export type SessionDiffResponses = {\n Line 1924: export type SessionDiffResponse = SessionDiffResponses[keyof SessionDiffResponses]\n Line 1926: export type SessionSummarizeData = {\n Line 1943: export type SessionSummarizeErrors = {\n Line 1954: export type SessionSummarizeError = SessionSummarizeErrors[keyof SessionSummarizeErrors]\n Line 1956: export type SessionSummarizeResponses = {\n Line 1963: export type SessionSummarizeResponse = SessionSummarizeResponses[keyof SessionSummarizeResponses]\n Line 1965: export type SessionMessagesData = {\n Line 1979: export type SessionMessagesErrors = {\n Line 1990: export type SessionMessagesError = SessionMessagesErrors[keyof SessionMessagesErrors]\n Line 1992: export type SessionMessagesResponses = {\n Line 2002: export type SessionMessagesResponse = SessionMessagesResponses[keyof SessionMessagesResponses]\n Line 2004: export type SessionPromptData = {\n Line 2031: export type SessionPromptErrors = {\n Line 2042: export type SessionPromptError = SessionPromptErrors[keyof SessionPromptErrors]\n Line 2044: export type SessionPromptResponses = {\n Line 2054: export type SessionPromptResponse = SessionPromptResponses[keyof SessionPromptResponses]\n Line 2056: export type SessionMessageData = {\n Line 2074: export type SessionMessageErrors = {\n Line 2085: export type SessionMessageError = SessionMessageErrors[keyof SessionMessageErrors]\n Line 2087: export type SessionMessageResponses = {\n Line 2097: export type SessionMessageResponse = SessionMessageResponses[keyof SessionMessageResponses]\n Line 2099: export type SessionCommandData = {\n Line 2119: export type SessionCommandErrors = {\n Line 2130: export type SessionCommandError = SessionCommandErrors[keyof SessionCommandErrors]\n Line 2132: export type SessionCommandResponses = {\n Line 2142: export type SessionCommandResponse = SessionCommandResponses[keyof SessionCommandResponses]\n Line 2144: export type SessionShellData = {\n Line 2161: export type SessionShellErrors = {\n Line 2172: export type SessionShellError = SessionShellErrors[keyof SessionShellErrors]\n Line 2174: export type SessionShellResponses = {\n Line 2181: export type SessionShellResponse = SessionShellResponses[keyof SessionShellResponses]\n Line 2183: export type SessionRevertData = {\n Line 2197: export type SessionRevertErrors = {\n\n(Results are truncated. Consider using a more specific path or pattern.)", | |
| "title": "interface.*Session|type.*Session", | |
| "metadata": { | |
| "matches": 100, | |
| "truncated": true | |
| }, | |
| "time": { | |
| "start": 1766501559721, | |
| "end": 1766501559758 | |
| } | |
| } | |
| }, | |
| { | |
| "id": "prt_b4bb2adae001Rj738eOOUouZBd", | |
| "sessionID": "ses_4b8933352ffe2k7Q7VhaAWbJcB", | |
| "messageID": "msg_b4bb2970b001KPMI6WJGgM1jTx", | |
| "type": "tool", | |
| "callID": "toolu_012t3TTeoqbVDFf1es1Pj7bN", | |
| "tool": "grep", | |
| "state": { | |
| "status": "completed", | |
| "input": { | |
| "pattern": "interface.*Message|type.*Message", | |
| "path": "/Users/themishkun/projects/opencode/packages", | |
| "include": "*.ts" | |
| }, | |
| "output": "Found 29 matches\n/Users/themishkun/projects/opencode/packages/sdk/js/src/gen/types.gen.ts:\n Line 582: export type UserMessage = {\n Line 611: export type MessageOutputLengthError = {\n Line 618: export type MessageAbortedError = {\n Line 638: export type AssistantMessage = {\n Line 674: export type Message = UserMessage | AssistantMessage\n Line 1180: export type EventMessageUpdated = {\n Line 1187: export type EventMessageRemoved = {\n Line 1195: export type EventMessagePartUpdated = {\n Line 1203: export type EventMessagePartRemoved = {\n Line 1965: export type SessionMessagesData = {\n Line 1979: export type SessionMessagesErrors = {\n Line 1990: export type SessionMessagesError = SessionMessagesErrors[keyof SessionMessagesErrors]\n Line 1992: export type SessionMessagesResponses = {\n Line 2002: export type SessionMessagesResponse = SessionMessagesResponses[keyof SessionMessagesResponses]\n Line 2056: export type SessionMessageData = {\n Line 2074: export type SessionMessageErrors = {\n Line 2085: export type SessionMessageError = SessionMessageErrors[keyof SessionMessageErrors]\n Line 2087: export type SessionMessageResponses = {\n Line 2097: export type SessionMessageResponse = SessionMessageResponses[keyof SessionMessageResponses]\n\n/Users/themishkun/projects/opencode/packages/opencode/src/agent/agent.ts:\n Line 4: import { generateObject, type ModelMessage } from \"ai\"\n\n/Users/themishkun/projects/opencode/packages/opencode/src/session/summary.ts:\n Line 5: import { generateText, type ModelMessage } from \"ai\"\n\n/Users/themishkun/projects/opencode/packages/opencode/src/session/prompt.ts:\n Line 15: type ModelMessage,\n\n/Users/themishkun/projects/opencode/packages/console/app/src/routes/zen/util/provider/provider.ts:\n Line 46: export interface CommonMessage {\n\n/Users/themishkun/projects/opencode/packages/opencode/src/session/message-v2.ts:\n Line 5: import { APICallError, convertToModelMessages, LoadAPIKeyError, type ModelMessage, type UIMessage } from \"ai\"\n\n/Users/themishkun/projects/opencode/packages/opencode/src/session/compaction.ts:\n Line 1: import { streamText, type ModelMessage, LoadAPIKeyError, type StreamTextResult, type Tool as AITool } from \"ai\"\n\n/Users/themishkun/projects/opencode/packages/opencode/src/tool/task.ts:\n Line 94: all = all.flatMap((msg) => msg.parts.filter((x: any) => x.type === \"tool\") as MessageV2.ToolPart[])\n\n/Users/themishkun/projects/opencode/packages/opencode/src/tool/tool.ts:\n Line 2: import type { MessageV2 } from \"../session/message-v2\"\n\n/Users/themishkun/projects/opencode/packages/opencode/src/session/message.ts:\n Line 129: export type MessagePart = z.infer<typeof MessagePart>\n\n/Users/themishkun/projects/opencode/packages/opencode/src/provider/transform.ts:\n Line 1: import type { ModelMessage } from \"ai\"", | |
| "title": "interface.*Message|type.*Message", | |
| "metadata": { | |
| "matches": 29, | |
| "truncated": false | |
| }, | |
| "time": { | |
| "start": 1766501560833, | |
| "end": 1766501560863 | |
| } | |
| } | |
| }, | |
| { | |
| "id": "prt_b4bb2b2420013Q7GuCr7Z5v9dB", | |
| "sessionID": "ses_4b8933352ffe2k7Q7VhaAWbJcB", | |
| "messageID": "msg_b4bb2970b001KPMI6WJGgM1jTx", | |
| "type": "step-finish", | |
| "reason": "tool-calls", | |
| "cost": 0, | |
| "tokens": { | |
| "input": 1, | |
| "output": 288, | |
| "reasoning": 0, | |
| "cache": { | |
| "read": 0, | |
| "write": 67853 | |
| } | |
| } | |
| } | |
| ] | |
| }, | |
| { | |
| "info": { | |
| "id": "msg_b4bb2b257001jGGNjpYksgGy3g", | |
| "sessionID": "ses_4b8933352ffe2k7Q7VhaAWbJcB", | |
| "role": "assistant", | |
| "time": { | |
| "created": 1766501560919, | |
| "completed": 1766501578495 | |
| }, | |
| "parentID": "msg_b4badc04e001hWUUxXgTE32bEC", | |
| "modelID": "claude-opus-4-5", | |
| "providerID": "anthropic", | |
| "mode": "build", | |
| "agent": "build", | |
| "path": { | |
| "cwd": "/Users/themishkun/projects/tinkering/opencode-stats", | |
| "root": "/" | |
| }, | |
| "cost": 0, | |
| "tokens": { | |
| "input": 1, | |
| "output": 227, | |
| "reasoning": 0, | |
| "cache": { | |
| "read": 67853, | |
| "write": 3227 | |
| } | |
| }, | |
| "finish": "tool-calls" | |
| }, | |
| "parts": [ | |
| { | |
| "id": "prt_b4bb2c4b1001flVBHvUYxVOf4V", | |
| "sessionID": "ses_4b8933352ffe2k7Q7VhaAWbJcB", | |
| "messageID": "msg_b4bb2b257001jGGNjpYksgGy3g", | |
| "type": "step-start" | |
| }, | |
| { | |
| "id": "prt_b4bb2c4b3001bt741dSmP2rth1", | |
| "sessionID": "ses_4b8933352ffe2k7Q7VhaAWbJcB", | |
| "messageID": "msg_b4bb2b257001jGGNjpYksgGy3g", | |
| "type": "text", | |
| "text": "Found the types file. Let me read the key type definitions:", | |
| "time": { | |
| "start": 1766501566496, | |
| "end": 1766501566496 | |
| } | |
| }, | |
| { | |
| "id": "prt_b4bb2c827001oMTjHM7jp1ci7C", | |
| "sessionID": "ses_4b8933352ffe2k7Q7VhaAWbJcB", | |
| "messageID": "msg_b4bb2b257001jGGNjpYksgGy3g", | |
| "type": "tool", | |
| "callID": "toolu_01NjeDfzScLBFhvZPtkGPVjE", | |
| "tool": "read", | |
| "state": { | |
| "status": "completed", | |
| "input": { | |
| "filePath": "/Users/themishkun/projects/opencode/packages/sdk/js/src/gen/types.gen.ts", | |
| "offset": 525, | |
| "limit": 200 | |
| }, | |
| "output": "<file>\n00526| }\n00527| \n00528| export type Session = {\n00529| id: string\n00530| projectID: string\n00531| directory: string\n00532| parentID?: string\n00533| summary?: {\n00534| additions: number\n00535| deletions: number\n00536| diffs?: Array<FileDiff>\n00537| }\n00538| share?: {\n00539| url: string\n00540| }\n00541| title: string\n00542| version: string\n00543| time: {\n00544| created: number\n00545| updated: number\n00546| compacting?: number\n00547| }\n00548| revert?: {\n00549| messageID: string\n00550| partID?: string\n00551| snapshot?: string\n00552| diff?: string\n00553| }\n00554| }\n00555| \n00556| export type NotFoundError = {\n00557| name: \"NotFoundError\"\n00558| data: {\n00559| message: string\n00560| }\n00561| }\n00562| \n00563| export type Todo = {\n00564| /**\n00565| * Brief description of the task\n00566| */\n00567| content: string\n00568| /**\n00569| * Current status of the task: pending, in_progress, completed, cancelled\n00570| */\n00571| status: string\n00572| /**\n00573| * Priority level of the task: high, medium, low\n00574| */\n00575| priority: string\n00576| /**\n00577| * Unique identifier for the todo item\n00578| */\n00579| id: string\n00580| }\n00581| \n00582| export type UserMessage = {\n00583| id: string\n00584| sessionID: string\n00585| role: \"user\"\n00586| time: {\n00587| created: number\n00588| }\n00589| summary?: {\n00590| title?: string\n00591| body?: string\n00592| diffs: Array<FileDiff>\n00593| }\n00594| }\n00595| \n00596| export type ProviderAuthError = {\n00597| name: \"ProviderAuthError\"\n00598| data: {\n00599| providerID: string\n00600| message: string\n00601| }\n00602| }\n00603| \n00604| export type UnknownError = {\n00605| name: \"UnknownError\"\n00606| data: {\n00607| message: string\n00608| }\n00609| }\n00610| \n00611| export type MessageOutputLengthError = {\n00612| name: \"MessageOutputLengthError\"\n00613| data: {\n00614| [key: string]: unknown\n00615| }\n00616| }\n00617| \n00618| export type MessageAbortedError = {\n00619| name: \"MessageAbortedError\"\n00620| data: {\n00621| message: string\n00622| }\n00623| }\n00624| \n00625| export type ApiError = {\n00626| name: \"APIError\"\n00627| data: {\n00628| message: string\n00629| statusCode?: number\n00630| isRetryable: boolean\n00631| responseHeaders?: {\n00632| [key: string]: string\n00633| }\n00634| responseBody?: string\n00635| }\n00636| }\n00637| \n00638| export type AssistantMessage = {\n00639| id: string\n00640| sessionID: string\n00641| role: \"assistant\"\n00642| time: {\n00643| created: number\n00644| completed?: number\n00645| }\n00646| error?:\n00647| | ProviderAuthError\n00648| | UnknownError\n00649| | MessageOutputLengthError\n00650| | MessageAbortedError\n00651| | ApiError\n00652| system: Array<string>\n00653| parentID: string\n00654| modelID: string\n00655| providerID: string\n00656| mode: string\n00657| path: {\n00658| cwd: string\n00659| root: string\n00660| }\n00661| summary?: boolean\n00662| cost: number\n00663| tokens: {\n00664| input: number\n00665| output: number\n00666| reasoning: number\n00667| cache: {\n00668| read: number\n00669| write: number\n00670| }\n00671| }\n00672| }\n00673| \n00674| export type Message = UserMessage | AssistantMessage\n00675| \n00676| export type TextPart = {\n00677| id: string\n00678| sessionID: string\n00679| messageID: string\n00680| type: \"text\"\n00681| text: string\n00682| synthetic?: boolean\n00683| time?: {\n00684| start: number\n00685| end?: number\n00686| }\n00687| metadata?: {\n00688| [key: string]: unknown\n00689| }\n00690| }\n00691| \n00692| export type ReasoningPart = {\n00693| id: string\n00694| sessionID: string\n00695| messageID: string\n00696| type: \"reasoning\"\n00697| text: string\n00698| metadata?: {\n00699| [key: string]: unknown\n00700| }\n00701| time: {\n00702| start: number\n00703| end?: number\n00704| }\n00705| }\n00706| \n00707| export type FilePartSourceText = {\n00708| value: string\n00709| start: number\n00710| end: number\n00711| }\n00712| \n00713| export type FileSource = {\n00714| text: FilePartSourceText\n00715| type: \"file\"\n00716| path: string\n00717| }\n00718| \n00719| export type Range = {\n00720| start: {\n00721| line: number\n00722| character: number\n00723| }\n00724| end: {\n00725| line: number\n\n(File has more lines. Use 'offset' parameter to read beyond line 725)\n</file>", | |
| "title": "Users/themishkun/projects/opencode/packages/sdk/js/src/gen/types.gen.ts", | |
| "metadata": { | |
| "preview": "}\n\nexport type Session = {\n id: string\n projectID: string\n directory: string\n parentID?: string\n summary?: {\n additions: number\n deletions: number\n diffs?: Array<FileDiff>\n }\n share?: {\n url: string\n }\n title: string\n version: string\n time: {\n created: number\n updated: number" | |
| }, | |
| "time": { | |
| "start": 1766501568009, | |
| "end": 1766501578492 | |
| } | |
| } | |
| }, | |
| { | |
| "id": "prt_b4bb2ce15001Wzq4kkuA0Aubjk", | |
| "sessionID": "ses_4b8933352ffe2k7Q7VhaAWbJcB", | |
| "messageID": "msg_b4bb2b257001jGGNjpYksgGy3g", | |
| "type": "tool", | |
| "callID": "toolu_01CUMVP7fAYr2KxuDp9tWmMS", | |
| "tool": "grep", | |
| "state": { | |
| "status": "completed", | |
| "input": { | |
| "pattern": "type.*Part|ToolInvocation|ToolResult", | |
| "path": "/Users/themishkun/projects/opencode/packages/sdk/js/src", | |
| "include": "*.ts" | |
| }, | |
| "output": "Found 18 matches\n/Users/themishkun/projects/opencode/packages/sdk/js/src/gen/types.gen.ts:\n Line 676: export type TextPart = {\n Line 692: export type ReasoningPart = {\n Line 707: export type FilePartSourceText = {\n Line 739: export type FilePartSource = FileSource | SymbolSource\n Line 741: export type FilePart = {\n Line 809: export type ToolPart = {\n Line 822: export type StepStartPart = {\n Line 830: export type StepFinishPart = {\n Line 849: export type SnapshotPart = {\n Line 857: export type PatchPart = {\n Line 866: export type AgentPart = {\n Line 879: export type RetryPart = {\n Line 891: export type Part =\n Line 903: export type TextPartInput = {\n Line 917: export type FilePartInput = {\n Line 926: export type AgentPartInput = {\n Line 1195: export type EventMessagePartUpdated = {\n Line 1203: export type EventMessagePartRemoved = {", | |
| "title": "type.*Part|ToolInvocation|ToolResult", | |
| "metadata": { | |
| "matches": 18, | |
| "truncated": false | |
| }, | |
| "time": { | |
| "start": 1766501568874, | |
| "end": 1766501568884 | |
| } | |
| } | |
| }, | |
| { | |
| "id": "prt_b4bb2f6fe001GdBm4msYzJDfYw", | |
| "sessionID": "ses_4b8933352ffe2k7Q7VhaAWbJcB", | |
| "messageID": "msg_b4bb2b257001jGGNjpYksgGy3g", | |
| "type": "step-finish", | |
| "reason": "tool-calls", | |
| "cost": 0, | |
| "tokens": { | |
| "input": 1, | |
| "output": 227, | |
| "reasoning": 0, | |
| "cache": { | |
| "read": 67853, | |
| "write": 3227 | |
| } | |
| } | |
| } | |
| ] | |
| }, | |
| { | |
| "info": { | |
| "id": "msg_b4bb2f70c001zCWka6YgG4RAC7", | |
| "sessionID": "ses_4b8933352ffe2k7Q7VhaAWbJcB", | |
| "role": "assistant", | |
| "time": { | |
| "created": 1766501578508, | |
| "completed": 1766501583578 | |
| }, | |
| "parentID": "msg_b4badc04e001hWUUxXgTE32bEC", | |
| "modelID": "claude-opus-4-5", | |
| "providerID": "anthropic", | |
| "mode": "build", | |
| "agent": "build", | |
| "path": { | |
| "cwd": "/Users/themishkun/projects/tinkering/opencode-stats", | |
| "root": "/" | |
| }, | |
| "cost": 0, | |
| "tokens": { | |
| "input": 1, | |
| "output": 128, | |
| "reasoning": 0, | |
| "cache": { | |
| "read": 71080, | |
| "write": 2246 | |
| } | |
| }, | |
| "finish": "tool-calls" | |
| }, | |
| "parts": [ | |
| { | |
| "id": "prt_b4bb3064a001UERDoPEX8ZrkqG", | |
| "sessionID": "ses_4b8933352ffe2k7Q7VhaAWbJcB", | |
| "messageID": "msg_b4bb2f70c001zCWka6YgG4RAC7", | |
| "type": "step-start" | |
| }, | |
| { | |
| "id": "prt_b4bb3064b001MU16zpRHE9WJHZ", | |
| "sessionID": "ses_4b8933352ffe2k7Q7VhaAWbJcB", | |
| "messageID": "msg_b4bb2f70c001zCWka6YgG4RAC7", | |
| "type": "text", | |
| "text": "Let me read more about the ToolPart and Part types:", | |
| "time": { | |
| "start": 1766501582920, | |
| "end": 1766501582920 | |
| } | |
| }, | |
| { | |
| "id": "prt_b4bb3084800183R68Qev7xYukE", | |
| "sessionID": "ses_4b8933352ffe2k7Q7VhaAWbJcB", | |
| "messageID": "msg_b4bb2f70c001zCWka6YgG4RAC7", | |
| "type": "tool", | |
| "callID": "toolu_01L4MHgw2JV1A6UGn6MTSKnq", | |
| "tool": "read", | |
| "state": { | |
| "status": "completed", | |
| "input": { | |
| "filePath": "/Users/themishkun/projects/opencode/packages/sdk/js/src/gen/types.gen.ts", | |
| "offset": 805, | |
| "limit": 120 | |
| }, | |
| "output": "<file>\n00806| \n00807| export type ToolState = ToolStatePending | ToolStateRunning | ToolStateCompleted | ToolStateError\n00808| \n00809| export type ToolPart = {\n00810| id: string\n00811| sessionID: string\n00812| messageID: string\n00813| type: \"tool\"\n00814| callID: string\n00815| tool: string\n00816| state: ToolState\n00817| metadata?: {\n00818| [key: string]: unknown\n00819| }\n00820| }\n00821| \n00822| export type StepStartPart = {\n00823| id: string\n00824| sessionID: string\n00825| messageID: string\n00826| type: \"step-start\"\n00827| snapshot?: string\n00828| }\n00829| \n00830| export type StepFinishPart = {\n00831| id: string\n00832| sessionID: string\n00833| messageID: string\n00834| type: \"step-finish\"\n00835| reason: string\n00836| snapshot?: string\n00837| cost: number\n00838| tokens: {\n00839| input: number\n00840| output: number\n00841| reasoning: number\n00842| cache: {\n00843| read: number\n00844| write: number\n00845| }\n00846| }\n00847| }\n00848| \n00849| export type SnapshotPart = {\n00850| id: string\n00851| sessionID: string\n00852| messageID: string\n00853| type: \"snapshot\"\n00854| snapshot: string\n00855| }\n00856| \n00857| export type PatchPart = {\n00858| id: string\n00859| sessionID: string\n00860| messageID: string\n00861| type: \"patch\"\n00862| hash: string\n00863| files: Array<string>\n00864| }\n00865| \n00866| export type AgentPart = {\n00867| id: string\n00868| sessionID: string\n00869| messageID: string\n00870| type: \"agent\"\n00871| name: string\n00872| source?: {\n00873| value: string\n00874| start: number\n00875| end: number\n00876| }\n00877| }\n00878| \n00879| export type RetryPart = {\n00880| id: string\n00881| sessionID: string\n00882| messageID: string\n00883| type: \"retry\"\n00884| attempt: number\n00885| error: ApiError\n00886| time: {\n00887| created: number\n00888| }\n00889| }\n00890| \n00891| export type Part =\n00892| | TextPart\n00893| | ReasoningPart\n00894| | FilePart\n00895| | ToolPart\n00896| | StepStartPart\n00897| | StepFinishPart\n00898| | SnapshotPart\n00899| | PatchPart\n00900| | AgentPart\n00901| | RetryPart\n00902| \n00903| export type TextPartInput = {\n00904| id?: string\n00905| type: \"text\"\n00906| text: string\n00907| synthetic?: boolean\n00908| time?: {\n00909| start: number\n00910| end?: number\n00911| }\n00912| metadata?: {\n00913| [key: string]: unknown\n00914| }\n00915| }\n00916| \n00917| export type FilePartInput = {\n00918| id?: string\n00919| type: \"file\"\n00920| mime: string\n00921| filename?: string\n00922| url: string\n00923| source?: FilePartSource\n00924| }\n00925| \n\n(File has more lines. Use 'offset' parameter to read beyond line 925)\n</file>", | |
| "title": "Users/themishkun/projects/opencode/packages/sdk/js/src/gen/types.gen.ts", | |
| "metadata": { | |
| "preview": "\nexport type ToolState = ToolStatePending | ToolStateRunning | ToolStateCompleted | ToolStateError\n\nexport type ToolPart = {\n id: string\n sessionID: string\n messageID: string\n type: \"tool\"\n callID: string\n tool: string\n state: ToolState\n metadata?: {\n [key: string]: unknown\n }\n}\n\nexport type StepStartPart = {\n id: string\n sessionID: string\n messageID: string" | |
| }, | |
| "time": { | |
| "start": 1766501583535, | |
| "end": 1766501583536 | |
| } | |
| } | |
| }, | |
| { | |
| "id": "prt_b4bb30ad50010HFH8sedweQ4Ma", | |
| "sessionID": "ses_4b8933352ffe2k7Q7VhaAWbJcB", | |
| "messageID": "msg_b4bb2f70c001zCWka6YgG4RAC7", | |
| "type": "step-finish", | |
| "reason": "tool-calls", | |
| "cost": 0, | |
| "tokens": { | |
| "input": 1, | |
| "output": 128, | |
| "reasoning": 0, | |
| "cache": { | |
| "read": 71080, | |
| "write": 2246 | |
| } | |
| } | |
| } | |
| ] | |
| }, | |
| { | |
| "info": { | |
| "id": "msg_b4bb30aee001IFKSWM1jYCyjHr", | |
| "sessionID": "ses_4b8933352ffe2k7Q7VhaAWbJcB", | |
| "role": "assistant", | |
| "time": { | |
| "created": 1766501583598, | |
| "completed": 1766501589286 | |
| }, | |
| "parentID": "msg_b4badc04e001hWUUxXgTE32bEC", | |
| "modelID": "claude-opus-4-5", | |
| "providerID": "anthropic", | |
| "mode": "build", | |
| "agent": "build", | |
| "path": { | |
| "cwd": "/Users/themishkun/projects/tinkering/opencode-stats", | |
| "root": "/" | |
| }, | |
| "cost": 0, | |
| "tokens": { | |
| "input": 1, | |
| "output": 244, | |
| "reasoning": 0, | |
| "cache": { | |
| "read": 73326, | |
| "write": 1186 | |
| } | |
| }, | |
| "finish": "tool-calls" | |
| }, | |
| "parts": [ | |
| { | |
| "id": "prt_b4bb31737001RkviOhoxfIDpZ1", | |
| "sessionID": "ses_4b8933352ffe2k7Q7VhaAWbJcB", | |
| "messageID": "msg_b4bb30aee001IFKSWM1jYCyjHr", | |
| "type": "step-start" | |
| }, | |
| { | |
| "id": "prt_b4bb3173b001tPRpywKCNM5yzq", | |
| "sessionID": "ses_4b8933352ffe2k7Q7VhaAWbJcB", | |
| "messageID": "msg_b4bb30aee001IFKSWM1jYCyjHr", | |
| "type": "text", | |
| "text": "Now let me check ToolState to see what data is in completed tools, and also look at the FileDiff type:", | |
| "time": { | |
| "start": 1766501587891, | |
| "end": 1766501587891 | |
| } | |
| }, | |
| { | |
| "id": "prt_b4bb31bb600135bbbs06S2P3kf", | |
| "sessionID": "ses_4b8933352ffe2k7Q7VhaAWbJcB", | |
| "messageID": "msg_b4bb30aee001IFKSWM1jYCyjHr", | |
| "type": "tool", | |
| "callID": "toolu_01TzAHH8UYVLW8aU6WQc8DEn", | |
| "tool": "grep", | |
| "state": { | |
| "status": "completed", | |
| "input": { | |
| "pattern": "ToolStateCompleted|ToolStatePending|ToolStateRunning|ToolStateError", | |
| "path": "/Users/themishkun/projects/opencode/packages/sdk/js/src", | |
| "include": "*.ts" | |
| }, | |
| "output": "Found 5 matches\n/Users/themishkun/projects/opencode/packages/sdk/js/src/gen/types.gen.ts:\n Line 752: export type ToolStatePending = {\n Line 760: export type ToolStateRunning = {\n Line 774: export type ToolStateCompleted = {\n Line 792: export type ToolStateError = {\n Line 807: export type ToolState = ToolStatePending | ToolStateRunning | ToolStateCompleted | ToolStateError", | |
| "title": "ToolStateCompleted|ToolStatePending|ToolStateRunning|ToolStateError", | |
| "metadata": { | |
| "matches": 5, | |
| "truncated": false | |
| }, | |
| "time": { | |
| "start": 1766501588554, | |
| "end": 1766501588561 | |
| } | |
| } | |
| }, | |
| { | |
| "id": "prt_b4bb31e4b001RPdma1apVot7Xq", | |
| "sessionID": "ses_4b8933352ffe2k7Q7VhaAWbJcB", | |
| "messageID": "msg_b4bb30aee001IFKSWM1jYCyjHr", | |
| "type": "tool", | |
| "callID": "toolu_01EtshuHHdqdYnTy59k5iYxg", | |
| "tool": "grep", | |
| "state": { | |
| "status": "completed", | |
| "input": { | |
| "pattern": "type FileDiff", | |
| "path": "/Users/themishkun/projects/opencode/packages/sdk/js/src", | |
| "include": "*.ts" | |
| }, | |
| "output": "Found 1 matches\n/Users/themishkun/projects/opencode/packages/sdk/js/src/gen/types.gen.ts:\n Line 520: export type FileDiff = {", | |
| "title": "type FileDiff", | |
| "metadata": { | |
| "matches": 1, | |
| "truncated": false | |
| }, | |
| "time": { | |
| "start": 1766501589226, | |
| "end": 1766501589233 | |
| } | |
| } | |
| }, | |
| { | |
| "id": "prt_b4bb3212200111iS5CGVKrBuof", | |
| "sessionID": "ses_4b8933352ffe2k7Q7VhaAWbJcB", | |
| "messageID": "msg_b4bb30aee001IFKSWM1jYCyjHr", | |
| "type": "step-finish", | |
| "reason": "tool-calls", | |
| "cost": 0, | |
| "tokens": { | |
| "input": 1, | |
| "output": 244, | |
| "reasoning": 0, | |
| "cache": { | |
| "read": 73326, | |
| "write": 1186 | |
| } | |
| } | |
| } | |
| ] | |
| }, | |
| { | |
| "info": { | |
| "id": "msg_b4bb3214a001n7WDl87LTiqEjM", | |
| "sessionID": "ses_4b8933352ffe2k7Q7VhaAWbJcB", | |
| "role": "assistant", | |
| "time": { | |
| "created": 1766501589322, | |
| "completed": 1766501594317 | |
| }, | |
| "parentID": "msg_b4badc04e001hWUUxXgTE32bEC", | |
| "modelID": "claude-opus-4-5", | |
| "providerID": "anthropic", | |
| "mode": "build", | |
| "agent": "build", | |
| "path": { | |
| "cwd": "/Users/themishkun/projects/tinkering/opencode-stats", | |
| "root": "/" | |
| }, | |
| "cost": 0, | |
| "tokens": { | |
| "input": 1, | |
| "output": 209, | |
| "reasoning": 0, | |
| "cache": { | |
| "read": 74512, | |
| "write": 479 | |
| } | |
| }, | |
| "finish": "tool-calls" | |
| }, | |
| "parts": [ | |
| { | |
| "id": "prt_b4bb32f15001t9yG5vrZChYxBZ", | |
| "sessionID": "ses_4b8933352ffe2k7Q7VhaAWbJcB", | |
| "messageID": "msg_b4bb3214a001n7WDl87LTiqEjM", | |
| "type": "step-start" | |
| }, | |
| { | |
| "id": "prt_b4bb32f16001Z2M5iL3gBMb9Wf", | |
| "sessionID": "ses_4b8933352ffe2k7Q7VhaAWbJcB", | |
| "messageID": "msg_b4bb3214a001n7WDl87LTiqEjM", | |
| "type": "tool", | |
| "callID": "toolu_016qHTcgaKwcvUcGWVxXdS8f", | |
| "tool": "read", | |
| "state": { | |
| "status": "completed", | |
| "input": { | |
| "filePath": "/Users/themishkun/projects/opencode/packages/sdk/js/src/gen/types.gen.ts", | |
| "offset": 518, | |
| "limit": 15 | |
| }, | |
| "output": "<file>\n00519| \n00520| export type FileDiff = {\n00521| file: string\n00522| before: string\n00523| after: string\n00524| additions: number\n00525| deletions: number\n00526| }\n00527| \n00528| export type Session = {\n00529| id: string\n00530| projectID: string\n00531| directory: string\n00532| parentID?: string\n00533| summary?: {\n\n(File has more lines. Use 'offset' parameter to read beyond line 533)\n</file>", | |
| "title": "Users/themishkun/projects/opencode/packages/sdk/js/src/gen/types.gen.ts", | |
| "metadata": { | |
| "preview": "\nexport type FileDiff = {\n file: string\n before: string\n after: string\n additions: number\n deletions: number\n}\n\nexport type Session = {\n id: string\n projectID: string\n directory: string\n parentID?: string\n summary?: {" | |
| }, | |
| "time": { | |
| "start": 1766501593563, | |
| "end": 1766501593564 | |
| } | |
| } | |
| }, | |
| { | |
| "id": "prt_b4bb331db001vTPSuOxSE0SvrV", | |
| "sessionID": "ses_4b8933352ffe2k7Q7VhaAWbJcB", | |
| "messageID": "msg_b4bb3214a001n7WDl87LTiqEjM", | |
| "type": "tool", | |
| "callID": "toolu_01XXrmfiVzq1ekVq4kb3opEJ", | |
| "tool": "read", | |
| "state": { | |
| "status": "completed", | |
| "input": { | |
| "filePath": "/Users/themishkun/projects/opencode/packages/sdk/js/src/gen/types.gen.ts", | |
| "offset": 750, | |
| "limit": 55 | |
| }, | |
| "output": "<file>\n00751| \n00752| export type ToolStatePending = {\n00753| status: \"pending\"\n00754| input: {\n00755| [key: string]: unknown\n00756| }\n00757| raw: string\n00758| }\n00759| \n00760| export type ToolStateRunning = {\n00761| status: \"running\"\n00762| input: {\n00763| [key: string]: unknown\n00764| }\n00765| title?: string\n00766| metadata?: {\n00767| [key: string]: unknown\n00768| }\n00769| time: {\n00770| start: number\n00771| }\n00772| }\n00773| \n00774| export type ToolStateCompleted = {\n00775| status: \"completed\"\n00776| input: {\n00777| [key: string]: unknown\n00778| }\n00779| output: string\n00780| title: string\n00781| metadata: {\n00782| [key: string]: unknown\n00783| }\n00784| time: {\n00785| start: number\n00786| end: number\n00787| compacted?: number\n00788| }\n00789| attachments?: Array<FilePart>\n00790| }\n00791| \n00792| export type ToolStateError = {\n00793| status: \"error\"\n00794| input: {\n00795| [key: string]: unknown\n00796| }\n00797| error: string\n00798| metadata?: {\n00799| [key: string]: unknown\n00800| }\n00801| time: {\n00802| start: number\n00803| end: number\n00804| }\n00805| }\n\n(File has more lines. Use 'offset' parameter to read beyond line 805)\n</file>", | |
| "title": "Users/themishkun/projects/opencode/packages/sdk/js/src/gen/types.gen.ts", | |
| "metadata": { | |
| "preview": "\nexport type ToolStatePending = {\n status: \"pending\"\n input: {\n [key: string]: unknown\n }\n raw: string\n}\n\nexport type ToolStateRunning = {\n status: \"running\"\n input: {\n [key: string]: unknown\n }\n title?: string\n metadata?: {\n [key: string]: unknown\n }\n time: {\n start: number" | |
| }, | |
| "time": { | |
| "start": 1766501594225, | |
| "end": 1766501594230 | |
| } | |
| } | |
| }, | |
| { | |
| "id": "prt_b4bb334c90014vDfsfFi8nYaWP", | |
| "sessionID": "ses_4b8933352ffe2k7Q7VhaAWbJcB", | |
| "messageID": "msg_b4bb3214a001n7WDl87LTiqEjM", | |
| "type": "step-finish", | |
| "reason": "tool-calls", | |
| "cost": 0, | |
| "tokens": { | |
| "input": 1, | |
| "output": 209, | |
| "reasoning": 0, | |
| "cache": { | |
| "read": 74512, | |
| "write": 479 | |
| } | |
| } | |
| } | |
| ] | |
| }, | |
| { | |
| "info": { | |
| "id": "msg_b4bb334d9001AwzLd1FNBxMmrZ", | |
| "sessionID": "ses_4b8933352ffe2k7Q7VhaAWbJcB", | |
| "role": "assistant", | |
| "time": { | |
| "created": 1766501594329, | |
| "completed": 1766501598459 | |
| }, | |
| "parentID": "msg_b4badc04e001hWUUxXgTE32bEC", | |
| "modelID": "claude-opus-4-5", | |
| "providerID": "anthropic", | |
| "mode": "build", | |
| "agent": "build", | |
| "path": { | |
| "cwd": "/Users/themishkun/projects/tinkering/opencode-stats", | |
| "root": "/" | |
| }, | |
| "cost": 0, | |
| "tokens": { | |
| "input": 1, | |
| "output": 111, | |
| "reasoning": 0, | |
| "cache": { | |
| "read": 74991, | |
| "write": 887 | |
| } | |
| }, | |
| "finish": "tool-calls" | |
| }, | |
| "parts": [ | |
| { | |
| "id": "prt_b4bb33fb70014of55IwkqLKw8A", | |
| "sessionID": "ses_4b8933352ffe2k7Q7VhaAWbJcB", | |
| "messageID": "msg_b4bb334d9001AwzLd1FNBxMmrZ", | |
| "type": "step-start" | |
| }, | |
| { | |
| "id": "prt_b4bb33fba001lqC0bS0DZizPki", | |
| "sessionID": "ses_4b8933352ffe2k7Q7VhaAWbJcB", | |
| "messageID": "msg_b4bb334d9001AwzLd1FNBxMmrZ", | |
| "type": "text", | |
| "text": "Excellent! Now I have a clear picture. Let me also check what tool names are available:", | |
| "time": { | |
| "start": 1766501597770, | |
| "end": 1766501597770 | |
| } | |
| }, | |
| { | |
| "id": "prt_b4bb3424c001PudHe6aQuoSdkY", | |
| "sessionID": "ses_4b8933352ffe2k7Q7VhaAWbJcB", | |
| "messageID": "msg_b4bb334d9001AwzLd1FNBxMmrZ", | |
| "type": "tool", | |
| "callID": "toolu_01XfULEPqSsCTtgU8wJqTrfC", | |
| "tool": "glob", | |
| "state": { | |
| "status": "completed", | |
| "input": { | |
| "pattern": "**/tool/*.ts", | |
| "path": "/Users/themishkun/projects/opencode/packages/opencode/src" | |
| }, | |
| "output": "/Users/themishkun/projects/opencode/packages/opencode/src/tool/write.ts\n/Users/themishkun/projects/opencode/packages/opencode/src/tool/patch.ts\n/Users/themishkun/projects/opencode/packages/opencode/src/tool/registry.ts\n/Users/themishkun/projects/opencode/packages/opencode/src/tool/edit.ts\n/Users/themishkun/projects/opencode/packages/opencode/src/tool/read.ts\n/Users/themishkun/projects/opencode/packages/opencode/src/tool/bash.ts\n/Users/themishkun/projects/opencode/packages/opencode/src/tool/grep.ts\n/Users/themishkun/projects/opencode/packages/opencode/src/tool/task.ts\n/Users/themishkun/projects/opencode/packages/opencode/src/tool/webfetch.ts\n/Users/themishkun/projects/opencode/packages/opencode/src/tool/todo.ts\n/Users/themishkun/projects/opencode/packages/opencode/src/tool/tool.ts\n/Users/themishkun/projects/opencode/packages/opencode/src/tool/lsp-diagnostics.ts\n/Users/themishkun/projects/opencode/packages/opencode/src/tool/invalid.ts\n/Users/themishkun/projects/opencode/packages/opencode/src/tool/ls.ts\n/Users/themishkun/projects/opencode/packages/opencode/src/tool/lsp-hover.ts\n/Users/themishkun/projects/opencode/packages/opencode/src/tool/multiedit.ts\n/Users/themishkun/projects/opencode/packages/opencode/src/tool/glob.ts", | |
| "title": "Users/themishkun/projects/opencode/packages/opencode/src", | |
| "metadata": { | |
| "count": 17, | |
| "truncated": false | |
| }, | |
| "time": { | |
| "start": 1766501598369, | |
| "end": 1766501598378 | |
| } | |
| } | |
| }, | |
| { | |
| "id": "prt_b4bb344f7001ezGn9ri0u5khhI", | |
| "sessionID": "ses_4b8933352ffe2k7Q7VhaAWbJcB", | |
| "messageID": "msg_b4bb334d9001AwzLd1FNBxMmrZ", | |
| "type": "step-finish", | |
| "reason": "tool-calls", | |
| "cost": 0, | |
| "tokens": { | |
| "input": 1, | |
| "output": 111, | |
| "reasoning": 0, | |
| "cache": { | |
| "read": 74991, | |
| "write": 887 | |
| } | |
| } | |
| } | |
| ] | |
| }, | |
| { | |
| "info": { | |
| "id": "msg_b4bb34509001z7v9rlys5fTjPF", | |
| "sessionID": "ses_4b8933352ffe2k7Q7VhaAWbJcB", | |
| "role": "assistant", | |
| "time": { | |
| "created": 1766501598473, | |
| "completed": 1766501609326 | |
| }, | |
| "parentID": "msg_b4badc04e001hWUUxXgTE32bEC", | |
| "modelID": "claude-opus-4-5", | |
| "providerID": "anthropic", | |
| "mode": "build", | |
| "agent": "build", | |
| "path": { | |
| "cwd": "/Users/themishkun/projects/tinkering/opencode-stats", | |
| "root": "/" | |
| }, | |
| "cost": 0, | |
| "tokens": { | |
| "input": 1, | |
| "output": 184, | |
| "reasoning": 0, | |
| "cache": { | |
| "read": 75878, | |
| "write": 574 | |
| } | |
| }, | |
| "finish": "tool-calls" | |
| }, | |
| "parts": [ | |
| { | |
| "id": "prt_b4bb35048001B2DLozmHtS1xEj", | |
| "sessionID": "ses_4b8933352ffe2k7Q7VhaAWbJcB", | |
| "messageID": "msg_b4bb34509001z7v9rlys5fTjPF", | |
| "type": "step-start" | |
| }, | |
| { | |
| "id": "prt_b4bb35049001CaHEhoGG5cES8e", | |
| "sessionID": "ses_4b8933352ffe2k7Q7VhaAWbJcB", | |
| "messageID": "msg_b4bb34509001z7v9rlys5fTjPF", | |
| "type": "text", | |
| "text": "Let me check one tool to see how input/metadata is structured:", | |
| "time": { | |
| "start": 1766501602071, | |
| "end": 1766501602071 | |
| } | |
| }, | |
| { | |
| "id": "prt_b4bb35317001Bl85ZizFdezIbv", | |
| "sessionID": "ses_4b8933352ffe2k7Q7VhaAWbJcB", | |
| "messageID": "msg_b4bb34509001z7v9rlys5fTjPF", | |
| "type": "tool", | |
| "callID": "toolu_015tRcxNacvJKe3xCxs72zzU", | |
| "tool": "read", | |
| "state": { | |
| "status": "completed", | |
| "input": { | |
| "filePath": "/Users/themishkun/projects/opencode/packages/opencode/src/tool/edit.ts", | |
| "limit": 80 | |
| }, | |
| "output": "<file>\n00001| // the approaches in this edit tool are sourced from\n00002| // https://github.com/cline/cline/blob/main/evals/diff-edits/diff-apply/diff-06-23-25.ts\n00003| // https://github.com/google-gemini/gemini-cli/blob/main/packages/core/src/utils/editCorrector.ts\n00004| // https://github.com/cline/cline/blob/main/evals/diff-edits/diff-apply/diff-06-26-25.ts\n00005| \n00006| import z from \"zod\"\n00007| import * as path from \"path\"\n00008| import { Tool } from \"./tool\"\n00009| import { LSP } from \"../lsp\"\n00010| import { createTwoFilesPatch, diffLines } from \"diff\"\n00011| import { Permission } from \"../permission\"\n00012| import DESCRIPTION from \"./edit.txt\"\n00013| import { File } from \"../file\"\n00014| import { Bus } from \"../bus\"\n00015| import { FileTime } from \"../file/time\"\n00016| import { Filesystem } from \"../util/filesystem\"\n00017| import { Instance } from \"../project/instance\"\n00018| import { Agent } from \"../agent/agent\"\n00019| import { Snapshot } from \"@/snapshot\"\n00020| \n00021| export const EditTool = Tool.define(\"edit\", {\n00022| description: DESCRIPTION,\n00023| parameters: z.object({\n00024| filePath: z.string().describe(\"The absolute path to the file to modify\"),\n00025| oldString: z.string().describe(\"The text to replace\"),\n00026| newString: z.string().describe(\"The text to replace it with (must be different from oldString)\"),\n00027| replaceAll: z.boolean().optional().describe(\"Replace all occurrences of oldString (default false)\"),\n00028| }),\n00029| async execute(params, ctx) {\n00030| if (!params.filePath) {\n00031| throw new Error(\"filePath is required\")\n00032| }\n00033| \n00034| if (params.oldString === params.newString) {\n00035| throw new Error(\"oldString and newString must be different\")\n00036| }\n00037| \n00038| const filePath = path.isAbsolute(params.filePath) ? params.filePath : path.join(Instance.directory, params.filePath)\n00039| if (!Filesystem.contains(Instance.directory, filePath)) {\n00040| throw new Error(`File ${filePath} is not in the current working directory`)\n00041| }\n00042| \n00043| const agent = await Agent.get(ctx.agent)\n00044| let diff = \"\"\n00045| let contentOld = \"\"\n00046| let contentNew = \"\"\n00047| await (async () => {\n00048| if (params.oldString === \"\") {\n00049| contentNew = params.newString\n00050| diff = trimDiff(createTwoFilesPatch(filePath, filePath, contentOld, contentNew))\n00051| if (agent.permission.edit === \"ask\") {\n00052| await Permission.ask({\n00053| type: \"edit\",\n00054| sessionID: ctx.sessionID,\n00055| messageID: ctx.messageID,\n00056| callID: ctx.callID,\n00057| title: \"Edit this file: \" + filePath,\n00058| metadata: {\n00059| filePath,\n00060| diff,\n00061| },\n00062| })\n00063| }\n00064| await Bun.write(filePath, params.newString)\n00065| await Bus.publish(File.Event.Edited, {\n00066| file: filePath,\n00067| })\n00068| return\n00069| }\n00070| \n00071| const file = Bun.file(filePath)\n00072| const stats = await file.stat().catch(() => {})\n00073| if (!stats) throw new Error(`File ${filePath} not found`)\n00074| if (stats.isDirectory()) throw new Error(`Path is a directory, not a file: ${filePath}`)\n00075| await FileTime.assert(ctx.sessionID, filePath)\n00076| contentOld = await file.text()\n00077| contentNew = replace(contentOld, params.oldString, params.newString, params.replaceAll)\n00078| \n00079| diff = trimDiff(createTwoFilesPatch(filePath, filePath, contentOld, contentNew))\n00080| if (agent.permission.edit === \"ask\") {\n\n(File has more lines. Use 'offset' parameter to read beyond line 80)\n</file>", | |
| "title": "Users/themishkun/projects/opencode/packages/opencode/src/tool/edit.ts", | |
| "metadata": { | |
| "preview": "// the approaches in this edit tool are sourced from\n// https://github.com/cline/cline/blob/main/evals/diff-edits/diff-apply/diff-06-23-25.ts\n// https://github.com/google-gemini/gemini-cli/blob/main/packages/core/src/utils/editCorrector.ts\n// https://github.com/cline/cline/blob/main/evals/diff-edits/diff-apply/diff-06-26-25.ts\n\nimport z from \"zod\"\nimport * as path from \"path\"\nimport { Tool } from \"./tool\"\nimport { LSP } from \"../lsp\"\nimport { createTwoFilesPatch, diffLines } from \"diff\"\nimport { Permission } from \"../permission\"\nimport DESCRIPTION from \"./edit.txt\"\nimport { File } from \"../file\"\nimport { Bus } from \"../bus\"\nimport { FileTime } from \"../file/time\"\nimport { Filesystem } from \"../util/filesystem\"\nimport { Instance } from \"../project/instance\"\nimport { Agent } from \"../agent/agent\"\nimport { Snapshot } from \"@/snapshot\"\n" | |
| }, | |
| "time": { | |
| "start": 1766501602581, | |
| "end": 1766501609325 | |
| } | |
| } | |
| }, | |
| { | |
| "id": "prt_b4bb35516001Mb07VjNsLumRIG", | |
| "sessionID": "ses_4b8933352ffe2k7Q7VhaAWbJcB", | |
| "messageID": "msg_b4bb34509001z7v9rlys5fTjPF", | |
| "type": "tool", | |
| "callID": "toolu_01WaY18LhB6ivnF3oZKdNdjh", | |
| "tool": "read", | |
| "state": { | |
| "status": "completed", | |
| "input": { | |
| "filePath": "/Users/themishkun/projects/opencode/packages/opencode/src/tool/bash.ts", | |
| "limit": 80 | |
| }, | |
| "output": "<file>\n00001| import z from \"zod\"\n00002| import { spawn } from \"child_process\"\n00003| import { Tool } from \"./tool\"\n00004| import DESCRIPTION from \"./bash.txt\"\n00005| import { Log } from \"../util/log\"\n00006| import { Instance } from \"../project/instance\"\n00007| import { lazy } from \"@/util/lazy\"\n00008| import { Language } from \"web-tree-sitter\"\n00009| import { Agent } from \"@/agent/agent\"\n00010| import { $ } from \"bun\"\n00011| import { Filesystem } from \"@/util/filesystem\"\n00012| import { Wildcard } from \"@/util/wildcard\"\n00013| import { Permission } from \"@/permission\"\n00014| \n00015| const MAX_OUTPUT_LENGTH = 30_000\n00016| const DEFAULT_TIMEOUT = 1 * 60 * 1000\n00017| const MAX_TIMEOUT = 10 * 60 * 1000\n00018| const SIGKILL_TIMEOUT_MS = 200\n00019| \n00020| export const log = Log.create({ service: \"bash-tool\" })\n00021| \n00022| const parser = lazy(async () => {\n00023| const { Parser } = await import(\"web-tree-sitter\")\n00024| const { default: treeWasm } = await import(\"web-tree-sitter/tree-sitter.wasm\" as string, {\n00025| with: { type: \"wasm\" },\n00026| })\n00027| await Parser.init({\n00028| locateFile() {\n00029| return treeWasm\n00030| },\n00031| })\n00032| const { default: bashWasm } = await import(\"tree-sitter-bash/tree-sitter-bash.wasm\" as string, {\n00033| with: { type: \"wasm\" },\n00034| })\n00035| const bashLanguage = await Language.load(bashWasm)\n00036| const p = new Parser()\n00037| p.setLanguage(bashLanguage)\n00038| return p\n00039| })\n00040| \n00041| export const BashTool = Tool.define(\"bash\", {\n00042| description: DESCRIPTION,\n00043| parameters: z.object({\n00044| command: z.string().describe(\"The command to execute\"),\n00045| timeout: z.number().describe(\"Optional timeout in milliseconds\").optional(),\n00046| description: z\n00047| .string()\n00048| .describe(\n00049| \"Clear, concise description of what this command does in 5-10 words. Examples:\\nInput: ls\\nOutput: Lists files in current directory\\n\\nInput: git status\\nOutput: Shows working tree status\\n\\nInput: npm install\\nOutput: Installs package dependencies\\n\\nInput: mkdir foo\\nOutput: Creates directory 'foo'\",\n00050| ),\n00051| }),\n00052| async execute(params, ctx) {\n00053| if (params.timeout !== undefined && params.timeout < 0) {\n00054| throw new Error(\n00055| `Invalid timeout value: ${params.timeout}. Timeout must be a positive number.`,\n00056| )\n00057| }\n00058| const timeout = Math.min(params.timeout ?? DEFAULT_TIMEOUT, MAX_TIMEOUT)\n00059| const tree = await parser().then((p) => p.parse(params.command))\n00060| if (!tree) {\n00061| throw new Error(\"Failed to parse command\")\n00062| }\n00063| const permissions = await Agent.get(ctx.agent).then((x) => x.permission.bash)\n00064| \n00065| const askPatterns = new Set<string>()\n00066| for (const node of tree.rootNode.descendantsOfType(\"command\")) {\n00067| if (!node) continue\n00068| const command = []\n00069| for (let i = 0; i < node.childCount; i++) {\n00070| const child = node.child(i)\n00071| if (!child) continue\n00072| if (\n00073| child.type !== \"command_name\" &&\n00074| child.type !== \"word\" &&\n00075| child.type !== \"string\" &&\n00076| child.type !== \"raw_string\" &&\n00077| child.type !== \"concatenation\"\n00078| ) {\n00079| continue\n00080| }\n\n(File has more lines. Use 'offset' parameter to read beyond line 80)\n</file>", | |
| "title": "Users/themishkun/projects/opencode/packages/opencode/src/tool/bash.ts", | |
| "metadata": { | |
| "preview": "import z from \"zod\"\nimport { spawn } from \"child_process\"\nimport { Tool } from \"./tool\"\nimport DESCRIPTION from \"./bash.txt\"\nimport { Log } from \"../util/log\"\nimport { Instance } from \"../project/instance\"\nimport { lazy } from \"@/util/lazy\"\nimport { Language } from \"web-tree-sitter\"\nimport { Agent } from \"@/agent/agent\"\nimport { $ } from \"bun\"\nimport { Filesystem } from \"@/util/filesystem\"\nimport { Wildcard } from \"@/util/wildcard\"\nimport { Permission } from \"@/permission\"\n\nconst MAX_OUTPUT_LENGTH = 30_000\nconst DEFAULT_TIMEOUT = 1 * 60 * 1000\nconst MAX_TIMEOUT = 10 * 60 * 1000\nconst SIGKILL_TIMEOUT_MS = 200\n\nexport const log = Log.create({ service: \"bash-tool\" })" | |
| }, | |
| "time": { | |
| "start": 1766501603022, | |
| "end": 1766501609324 | |
| } | |
| } | |
| }, | |
| { | |
| "id": "prt_b4bb36f6d001QVj09W9BxpKT7A", | |
| "sessionID": "ses_4b8933352ffe2k7Q7VhaAWbJcB", | |
| "messageID": "msg_b4bb34509001z7v9rlys5fTjPF", | |
| "type": "step-finish", | |
| "reason": "tool-calls", | |
| "cost": 0, | |
| "tokens": { | |
| "input": 1, | |
| "output": 184, | |
| "reasoning": 0, | |
| "cache": { | |
| "read": 75878, | |
| "write": 574 | |
| } | |
| } | |
| } | |
| ] | |
| }, | |
| { | |
| "info": { | |
| "id": "msg_b4bb36f7d001me44Y0Z97r5uwo", | |
| "sessionID": "ses_4b8933352ffe2k7Q7VhaAWbJcB", | |
| "role": "assistant", | |
| "time": { | |
| "created": 1766501609341, | |
| "completed": 1766501614877 | |
| }, | |
| "parentID": "msg_b4badc04e001hWUUxXgTE32bEC", | |
| "modelID": "claude-opus-4-5", | |
| "providerID": "anthropic", | |
| "mode": "build", | |
| "agent": "build", | |
| "path": { | |
| "cwd": "/Users/themishkun/projects/tinkering/opencode-stats", | |
| "root": "/" | |
| }, | |
| "cost": 0, | |
| "tokens": { | |
| "input": 1, | |
| "output": 133, | |
| "reasoning": 0, | |
| "cache": { | |
| "read": 76452, | |
| "write": 2635 | |
| } | |
| }, | |
| "finish": "tool-calls" | |
| }, | |
| "parts": [ | |
| { | |
| "id": "prt_b4bb37d8c0015ls91yNwJaix97", | |
| "sessionID": "ses_4b8933352ffe2k7Q7VhaAWbJcB", | |
| "messageID": "msg_b4bb36f7d001me44Y0Z97r5uwo", | |
| "type": "step-start" | |
| }, | |
| { | |
| "id": "prt_b4bb37d98001n6rhalBmw75KRD", | |
| "sessionID": "ses_4b8933352ffe2k7Q7VhaAWbJcB", | |
| "messageID": "msg_b4bb36f7d001me44Y0Z97r5uwo", | |
| "type": "text", | |
| "text": "Now I have all the information I need. Let me update the architecture document with the actual schema and then start building:", | |
| "time": { | |
| "start": 1766501613921, | |
| "end": 1766501613921 | |
| } | |
| }, | |
| { | |
| "id": "prt_b4bb38162001r4QGhJzqLj2g1r", | |
| "sessionID": "ses_4b8933352ffe2k7Q7VhaAWbJcB", | |
| "messageID": "msg_b4bb36f7d001me44Y0Z97r5uwo", | |
| "type": "tool", | |
| "callID": "toolu_018euVwxx3NGYGLDherAC86T", | |
| "tool": "read", | |
| "state": { | |
| "status": "completed", | |
| "input": { | |
| "filePath": "/Users/themishkun/projects/tinkering/opencode-stats/ARCHITECTURE.md", | |
| "offset": 0, | |
| "limit": 100 | |
| }, | |
| "output": "<file>\n00001| # Architecture Document: OpenCode Stats CLI\n00002| \n00003| ## Overview\n00004| \n00005| This document describes the technical architecture of `opencode-stats`, a standalone CLI application that generates \"Spotify Wrapped\"-style statistics for OpenCode usage.\n00006| \n00007| ---\n00008| \n00009| ## High-Level Architecture\n00010| \n00011| ```\n00012| ┌─────────────────────────────────────────────────────────────────┐\n00013| │ opencode-stats CLI │\n00014| ├─────────────────────────────────────────────────────────────────┤\n00015| │ │\n00016| │ ┌─────────────┐ ┌─────────────┐ ┌─────────────────────────┐ │\n00017| │ │ CLI │ │ Stats │ │ Renderer │ │\n00018| │ │ Parser │──│ Engine │──│ (Terminal Output) │ │\n00019| │ └─────────────┘ └─────────────┘ └─────────────────────────┘ │\n00020| │ │ │ │ │\n00021| │ ▼ ▼ ▼ │\n00022| │ ┌─────────────┐ ┌─────────────┐ ┌─────────────────────────┐ │\n00023| │ │ Config │ │ Data │ │ Components │ │\n00024| │ │ (args) │ │ Layer │ │ (heatmap, stats, etc) │ │\n00025| │ └─────────────┘ └─────────────┘ └─────────────────────────┘ │\n00026| │ │ │\n00027| └──────────────────────────│─────────────────────────────────────┘\n00028| │\n00029| ▼\n00030| ┌─────────────────────────────────────────────────────────────────┐\n00031| │ @opencode-ai/sdk │\n00032| │ │\n00033| │ client.session.list() client.session.messages(id) │\n00034| └─────────────────────────────────────────────────────────────────┘\n00035| │\n00036| ▼\n00037| ┌─────────────────────────────────────────────────────────────────┐\n00038| │ OpenCode Session Storage │\n00039| │ ~/.opencode/ │\n00040| └─────────────────────────────────────────────────────────────────┘\n00041| ```\n00042| \n00043| ---\n00044| \n00045| ## Project Structure\n00046| \n00047| ```\n00048| opencode-stats/\n00049| ├── src/\n00050| │ ├── index.ts # Entry point, CLI setup\n00051| │ ├── cli.ts # Argument parsing\n00052| │ ├── config.ts # Configuration types\n00053| │ │\n00054| │ ├── data/\n00055| │ │ ├── client.ts # OpenCode SDK client wrapper\n00056| │ │ ├── sessions.ts # Session data fetching\n00057| │ │ └── types.ts # Data types/interfaces\n00058| │ │\n00059| │ ├── stats/\n00060| │ │ ├── engine.ts # Main statistics computation\n00061| │ │ ├── streaks.ts # Streak calculations\n00062| │ │ ├── aggregators.ts # Data aggregation utilities\n00063| │ │ └── funfacts.ts # Fun fact generator\n00064| │ │\n00065| │ └── render/\n00066| │ ├── index.ts # Main renderer\n00067| │ ├── pretty.ts # Colored terminal output\n00068| │ ├── plain.ts # Plain text output\n00069| │ ├── json.ts # JSON output\n00070| │ └── components/\n00071| │ ├── heatmap.ts # Activity heatmap\n00072| │ ├── dashboard.ts # Stats dashboard\n00073| │ ├── models.ts # Model usage chart\n00074| │ └── box.ts # Box drawing utilities\n00075| │\n00076| ├── package.json\n00077| ├── tsconfig.json\n00078| ├── README.md\n00079| ├── PRD.md\n00080| └── ARCHITECTURE.md\n00081| ```\n00082| \n00083| ---\n00084| \n00085| ## Component Design\n00086| \n00087| ### 1. CLI Entry Point (`src/index.ts`)\n00088| \n00089| ```typescript\n00090| #!/usr/bin/env node\n00091| import { parseArgs } from \"./cli\";\n00092| import { createDataProvider } from \"./data/client\";\n00093| import { StatsEngine } from \"./stats/engine\";\n00094| import { render } from \"./render\";\n00095| \n00096| async function main() {\n00097| const config = parseArgs(process.argv.slice(2));\n00098| \n00099| try {\n00100| const dataProvider = await createDataProvider();\n\n(File has more lines. Use 'offset' parameter to read beyond line 100)\n</file>", | |
| "title": "Users/themishkun/projects/tinkering/opencode-stats/ARCHITECTURE.md", | |
| "metadata": { | |
| "preview": "# Architecture Document: OpenCode Stats CLI\n\n## Overview\n\nThis document describes the technical architecture of `opencode-stats`, a standalone CLI application that generates \"Spotify Wrapped\"-style statistics for OpenCode usage.\n\n---\n\n## High-Level Architecture\n\n```\n┌─────────────────────────────────────────────────────────────────┐\n│ opencode-stats CLI │\n├─────────────────────────────────────────────────────────────────┤\n│ │\n│ ┌─────────────┐ ┌─────────────┐ ┌─────────────────────────┐ │\n│ │ CLI │ │ Stats │ │ Renderer │ │\n│ │ Parser │──│ Engine │──│ (Terminal Output) │ │\n│ └─────────────┘ └─────────────┘ └─────────────────────────┘ │\n│ │ │ │ │" | |
| }, | |
| "time": { | |
| "start": 1766501614795, | |
| "end": 1766501614796 | |
| } | |
| } | |
| }, | |
| { | |
| "id": "prt_b4bb3851b001HtB6WyudGkRt9u", | |
| "sessionID": "ses_4b8933352ffe2k7Q7VhaAWbJcB", | |
| "messageID": "msg_b4bb36f7d001me44Y0Z97r5uwo", | |
| "type": "step-finish", | |
| "reason": "tool-calls", | |
| "cost": 0, | |
| "tokens": { | |
| "input": 1, | |
| "output": 133, | |
| "reasoning": 0, | |
| "cache": { | |
| "read": 76452, | |
| "write": 2635 | |
| } | |
| } | |
| } | |
| ] | |
| }, | |
| { | |
| "info": { | |
| "id": "msg_b4bb3852d001iJpbde7DWy41VV", | |
| "sessionID": "ses_4b8933352ffe2k7Q7VhaAWbJcB", | |
| "role": "assistant", | |
| "time": { | |
| "created": 1766501614893, | |
| "completed": 1766501636476 | |
| }, | |
| "parentID": "msg_b4badc04e001hWUUxXgTE32bEC", | |
| "modelID": "claude-opus-4-5", | |
| "providerID": "anthropic", | |
| "mode": "build", | |
| "agent": "build", | |
| "path": { | |
| "cwd": "/Users/themishkun/projects/tinkering/opencode-stats", | |
| "root": "/" | |
| }, | |
| "cost": 0, | |
| "tokens": { | |
| "input": 1, | |
| "output": 1218, | |
| "reasoning": 0, | |
| "cache": { | |
| "read": 79087, | |
| "write": 1581 | |
| } | |
| }, | |
| "finish": "tool-calls" | |
| }, | |
| "parts": [ | |
| { | |
| "id": "prt_b4bb391f7001Sq5h8yRgGc6mPM", | |
| "sessionID": "ses_4b8933352ffe2k7Q7VhaAWbJcB", | |
| "messageID": "msg_b4bb3852d001iJpbde7DWy41VV", | |
| "type": "step-start" | |
| }, | |
| { | |
| "id": "prt_b4bb391fe0017J7vEC7DJYRTUY", | |
| "sessionID": "ses_4b8933352ffe2k7Q7VhaAWbJcB", | |
| "messageID": "msg_b4bb3852d001iJpbde7DWy41VV", | |
| "type": "text", | |
| "text": "Let me update the ARCHITECTURE.md with the actual SDK schema and additional stats we want to track:", | |
| "time": { | |
| "start": 1766501619142, | |
| "end": 1766501619142 | |
| } | |
| }, | |
| { | |
| "id": "prt_b4bb395c60017XZkUyJdQw86H1", | |
| "sessionID": "ses_4b8933352ffe2k7Q7VhaAWbJcB", | |
| "messageID": "msg_b4bb3852d001iJpbde7DWy41VV", | |
| "type": "tool", | |
| "callID": "toolu_01HtYkbuqzNTABAGf49Gy286", | |
| "tool": "edit", | |
| "state": { | |
| "status": "completed", | |
| "input": { | |
| "filePath": "/Users/themishkun/projects/tinkering/opencode-stats/ARCHITECTURE.md", | |
| "oldString": "# Architecture Document: OpenCode Stats CLI\n\n## Overview\n\nThis document describes the technical architecture of `opencode-stats`, a standalone CLI application that generates \"Spotify Wrapped\"-style statistics for OpenCode usage.\n\n---\n\n## High-Level Architecture", | |
| "newString": "# Architecture Document: OpenCode Stats CLI\n\n## Overview\n\nThis document describes the technical architecture of `opencode-stats`, a standalone CLI application that generates \"Spotify Wrapped\"-style statistics for OpenCode usage.\n\n---\n\n## OpenCode SDK Schema (from source)\n\nBased on exploration of `/Users/themishkun/projects/opencode/packages/sdk/js/src/gen/types.gen.ts`:\n\n### Session\n\n```typescript\ntype Session = {\n id: string\n projectID: string\n directory: string\n parentID?: string\n summary?: {\n additions: number // Total lines added\n deletions: number // Total lines deleted\n diffs?: Array<FileDiff>\n }\n title: string\n version: string\n time: {\n created: number // Unix timestamp\n updated: number\n compacting?: number\n }\n}\n\ntype FileDiff = {\n file: string\n before: string\n after: string\n additions: number\n deletions: number\n}\n```\n\n### Message\n\n```typescript\ntype UserMessage = {\n id: string\n sessionID: string\n role: \"user\"\n time: { created: number }\n summary?: {\n title?: string\n body?: string\n diffs: Array<FileDiff>\n }\n}\n\ntype AssistantMessage = {\n id: string\n sessionID: string\n role: \"assistant\"\n time: {\n created: number\n completed?: number\n }\n modelID: string // e.g., \"claude-sonnet-4-20250514\"\n providerID: string // e.g., \"anthropic\"\n cost: number // Cost in dollars\n tokens: {\n input: number\n output: number\n reasoning: number\n cache: { read: number, write: number }\n }\n}\n```\n\n### Parts (Tool Calls)\n\n```typescript\ntype ToolPart = {\n id: string\n sessionID: string\n messageID: string\n type: \"tool\"\n callID: string\n tool: string // Tool name: \"edit\", \"bash\", \"read\", \"write\", \"glob\", \"grep\", etc.\n state: ToolState\n}\n\ntype ToolStateCompleted = {\n status: \"completed\"\n input: Record<string, unknown> // Tool arguments (e.g., { filePath, command, etc. })\n output: string\n title: string\n metadata: Record<string, unknown>\n time: { start: number, end: number }\n}\n```\n\n### Available Tools (from source)\n\n- `edit` - Edit file (input: `{ filePath, oldString, newString, replaceAll? }`)\n- `write` - Create/overwrite file (input: `{ filePath, content }`)\n- `read` - Read file (input: `{ filePath, offset?, limit? }`)\n- `bash` - Run command (input: `{ command, timeout?, description }`)\n- `glob` - Find files (input: `{ pattern, path? }`)\n- `grep` - Search content (input: `{ pattern, path?, include? }`)\n- `task` - Launch subagent\n- `webfetch` - Fetch URL\n- `todo` - Manage todos\n- `multiedit` - Multiple edits\n\n---\n\n## Stats We Can Extract\n\n| Stat | Source | Notes |\n|------|--------|-------|\n| Sessions count | `sessions.length` | |\n| Total tokens | `message.tokens.input + output` | Per assistant message |\n| Total cost | `message.cost` | Per assistant message |\n| Lines added/deleted | `session.summary.additions/deletions` | Already aggregated |\n| Files edited | `ToolPart` where `tool === \"edit\"` | Count unique `filePath` |\n| Files created | `ToolPart` where `tool === \"write\"` | |\n| Bash commands | `ToolPart` where `tool === \"bash\"` | Can extract `command` |\n| Model usage | `message.modelID` | Per assistant message |\n| Peak hour | `message.time.created` | Hour distribution |\n| Languages | File extensions from edit/write tools | |\n| Session duration | `time.updated - time.created` | Or last message time |\n\n---\n\n## High-Level Architecture" | |
| }, | |
| "output": "", | |
| "title": "Users/themishkun/projects/tinkering/opencode-stats/ARCHITECTURE.md", | |
| "metadata": { | |
| "diagnostics": {}, | |
| "diff": "Index: /Users/themishkun/projects/tinkering/opencode-stats/ARCHITECTURE.md\n===================================================================\n--- /Users/themishkun/projects/tinkering/opencode-stats/ARCHITECTURE.md\n+++ /Users/themishkun/projects/tinkering/opencode-stats/ARCHITECTURE.md\n@@ -5,8 +5,134 @@\n This document describes the technical architecture of `opencode-stats`, a standalone CLI application that generates \"Spotify Wrapped\"-style statistics for OpenCode usage.\n \n ---\n \n+## OpenCode SDK Schema (from source)\n+\n+Based on exploration of `/Users/themishkun/projects/opencode/packages/sdk/js/src/gen/types.gen.ts`:\n+\n+### Session\n+\n+```typescript\n+type Session = {\n+ id: string\n+ projectID: string\n+ directory: string\n+ parentID?: string\n+ summary?: {\n+ additions: number // Total lines added\n+ deletions: number // Total lines deleted\n+ diffs?: Array<FileDiff>\n+ }\n+ title: string\n+ version: string\n+ time: {\n+ created: number // Unix timestamp\n+ updated: number\n+ compacting?: number\n+ }\n+}\n+\n+type FileDiff = {\n+ file: string\n+ before: string\n+ after: string\n+ additions: number\n+ deletions: number\n+}\n+```\n+\n+### Message\n+\n+```typescript\n+type UserMessage = {\n+ id: string\n+ sessionID: string\n+ role: \"user\"\n+ time: { created: number }\n+ summary?: {\n+ title?: string\n+ body?: string\n+ diffs: Array<FileDiff>\n+ }\n+}\n+\n+type AssistantMessage = {\n+ id: string\n+ sessionID: string\n+ role: \"assistant\"\n+ time: {\n+ created: number\n+ completed?: number\n+ }\n+ modelID: string // e.g., \"claude-sonnet-4-20250514\"\n+ providerID: string // e.g., \"anthropic\"\n+ cost: number // Cost in dollars\n+ tokens: {\n+ input: number\n+ output: number\n+ reasoning: number\n+ cache: { read: number, write: number }\n+ }\n+}\n+```\n+\n+### Parts (Tool Calls)\n+\n+```typescript\n+type ToolPart = {\n+ id: string\n+ sessionID: string\n+ messageID: string\n+ type: \"tool\"\n+ callID: string\n+ tool: string // Tool name: \"edit\", \"bash\", \"read\", \"write\", \"glob\", \"grep\", etc.\n+ state: ToolState\n+}\n+\n+type ToolStateCompleted = {\n+ status: \"completed\"\n+ input: Record<string, unknown> // Tool arguments (e.g., { filePath, command, etc. })\n+ output: string\n+ title: string\n+ metadata: Record<string, unknown>\n+ time: { start: number, end: number }\n+}\n+```\n+\n+### Available Tools (from source)\n+\n+- `edit` - Edit file (input: `{ filePath, oldString, newString, replaceAll? }`)\n+- `write` - Create/overwrite file (input: `{ filePath, content }`)\n+- `read` - Read file (input: `{ filePath, offset?, limit? }`)\n+- `bash` - Run command (input: `{ command, timeout?, description }`)\n+- `glob` - Find files (input: `{ pattern, path? }`)\n+- `grep` - Search content (input: `{ pattern, path?, include? }`)\n+- `task` - Launch subagent\n+- `webfetch` - Fetch URL\n+- `todo` - Manage todos\n+- `multiedit` - Multiple edits\n+\n+---\n+\n+## Stats We Can Extract\n+\n+| Stat | Source | Notes |\n+|------|--------|-------|\n+| Sessions count | `sessions.length` | |\n+| Total tokens | `message.tokens.input + output` | Per assistant message |\n+| Total cost | `message.cost` | Per assistant message |\n+| Lines added/deleted | `session.summary.additions/deletions` | Already aggregated |\n+| Files edited | `ToolPart` where `tool === \"edit\"` | Count unique `filePath` |\n+| Files created | `ToolPart` where `tool === \"write\"` | |\n+| Bash commands | `ToolPart` where `tool === \"bash\"` | Can extract `command` |\n+| Model usage | `message.modelID` | Per assistant message |\n+| Peak hour | `message.time.created` | Hour distribution |\n+| Languages | File extensions from edit/write tools | |\n+| Session duration | `time.updated - time.created` | Or last message time |\n+\n+---\n+\n ## High-Level Architecture\n \n ```\n ┌─────────────────────────────────────────────────────────────────┐\n", | |
| "filediff": { | |
| "file": "/Users/themishkun/projects/tinkering/opencode-stats/ARCHITECTURE.md", | |
| "before": "# Architecture Document: OpenCode Stats CLI\n\n## Overview\n\nThis document describes the technical architecture of `opencode-stats`, a standalone CLI application that generates \"Spotify Wrapped\"-style statistics for OpenCode usage.\n\n---\n\n## High-Level Architecture\n\n```\n┌─────────────────────────────────────────────────────────────────┐\n│ opencode-stats CLI │\n├─────────────────────────────────────────────────────────────────┤\n│ │\n│ ┌─────────────┐ ┌─────────────┐ ┌─────────────────────────┐ │\n│ │ CLI │ │ Stats │ │ Renderer │ │\n│ │ Parser │──│ Engine │──│ (Terminal Output) │ │\n│ └─────────────┘ └─────────────┘ └─────────────────────────┘ │\n│ │ │ │ │\n│ ▼ ▼ ▼ │\n│ ┌─────────────┐ ┌─────────────┐ ┌─────────────────────────┐ │\n│ │ Config │ │ Data │ │ Components │ │\n│ │ (args) │ │ Layer │ │ (heatmap, stats, etc) │ │\n│ └─────────────┘ └─────────────┘ └─────────────────────────┘ │\n│ │ │\n└──────────────────────────│─────────────────────────────────────┘\n │\n ▼\n┌─────────────────────────────────────────────────────────────────┐\n│ @opencode-ai/sdk │\n│ │\n│ client.session.list() client.session.messages(id) │\n└─────────────────────────────────────────────────────────────────┘\n │\n ▼\n┌─────────────────────────────────────────────────────────────────┐\n│ OpenCode Session Storage │\n│ ~/.opencode/ │\n└─────────────────────────────────────────────────────────────────┘\n```\n\n---\n\n## Project Structure\n\n```\nopencode-stats/\n├── src/\n│ ├── index.ts # Entry point, CLI setup\n│ ├── cli.ts # Argument parsing\n│ ├── config.ts # Configuration types\n│ │\n│ ├── data/\n│ │ ├── client.ts # OpenCode SDK client wrapper\n│ │ ├── sessions.ts # Session data fetching\n│ │ └── types.ts # Data types/interfaces\n│ │\n│ ├── stats/\n│ │ ├── engine.ts # Main statistics computation\n│ │ ├── streaks.ts # Streak calculations\n│ │ ├── aggregators.ts # Data aggregation utilities\n│ │ └── funfacts.ts # Fun fact generator\n│ │\n│ └── render/\n│ ├── index.ts # Main renderer\n│ ├── pretty.ts # Colored terminal output\n│ ├── plain.ts # Plain text output\n│ ├── json.ts # JSON output\n│ └── components/\n│ ├── heatmap.ts # Activity heatmap\n│ ├── dashboard.ts # Stats dashboard\n│ ├── models.ts # Model usage chart\n│ └── box.ts # Box drawing utilities\n│\n├── package.json\n├── tsconfig.json\n├── README.md\n├── PRD.md\n└── ARCHITECTURE.md\n```\n\n---\n\n## Component Design\n\n### 1. CLI Entry Point (`src/index.ts`)\n\n```typescript\n#!/usr/bin/env node\nimport { parseArgs } from \"./cli\";\nimport { createDataProvider } from \"./data/client\";\nimport { StatsEngine } from \"./stats/engine\";\nimport { render } from \"./render\";\n\nasync function main() {\n const config = parseArgs(process.argv.slice(2));\n \n try {\n const dataProvider = await createDataProvider();\n const engine = new StatsEngine(dataProvider);\n const stats = await engine.computeStats({ period: config.period });\n \n const output = render(stats, config);\n console.log(output);\n \n process.exit(0);\n } catch (error) {\n if (error.code === \"NO_SESSIONS\") {\n console.error(\"No OpenCode sessions found. Start using OpenCode first!\");\n process.exit(2);\n }\n console.error(\"Error:\", error.message);\n process.exit(1);\n }\n}\n\nmain();\n```\n\n### 2. CLI Argument Parser (`src/cli.ts`)\n\n```typescript\nimport { parseArgs as nodeParseArgs } from \"node:util\";\n\nexport interface Config {\n period: \"week\" | \"month\" | \"year\" | \"all\";\n view: \"overview\" | \"models\" | \"heatmap\";\n format: \"pretty\" | \"plain\" | \"json\";\n width: number;\n noColor: boolean;\n}\n\nexport function parseArgs(args: string[]): Config {\n const { values } = nodeParseArgs({\n args,\n options: {\n period: { type: \"string\", short: \"p\", default: \"month\" },\n view: { type: \"string\", short: \"v\", default: \"overview\" },\n for |
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment