devark-cli 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 DevArk
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,388 @@
+
+<div align="center">
+
+![devark-icon-white](https://github.com/user-attachments/assets/5cfa24f2-b2d5-4839-a6ba-5f3d0996f430)<svg width="64" height="64" viewBox="0 0 64 64" fill="none" xmlns="http://www.w3.org/2000/svg">
+  <!-- DevArk Icon (White variant for dark backgrounds) -->
+
+  <!-- Top chevron - Blue left, White right -->
+  <path d="M32 6 L8 26 L12 30 L32 14 Z" fill="#3528E0"/>
+  <path d="M32 6 L56 26 L52 30 L32 14 Z" fill="#FFFFFF"/>
+
+  <!-- Middle chevron - Blue left, White right -->
+  <path d="M32 18 L12 34 L16 38 L32 26 Z" fill="#3528E0"/>
+  <path d="M32 18 L52 34 L48 38 L32 26 Z" fill="#FFFFFF"/>
+
+  <!-- Bottom chevron - Blue left, White right -->
+  <path d="M32 30 L16 42 L20 46 L32 38 Z" fill="#3528E0"/>
+  <path d="M32 30 L48 42 L44 46 L32 38 Z" fill="#FFFFFF"/>
+</svg>
+
+
+
+
+<p></p>
+<h3>Open-source CLI for analyzing Claude Code sessions locally and generating productivity reports</h3>
+<p></p>
+
+<a href="https://devark.ai"><img src="https://img.shields.io/badge/by-devark.ai-16A34A" alt="by devark.ai"></a>
+<a href="https://www.npmjs.com/package/devark-cli"><img src="https://img.shields.io/npm/v/devark-cli.svg" alt="npm version"></a>
+<a href="https://opensource.org/licenses/MIT"><img src="https://img.shields.io/badge/License-MIT-yellow.svg" alt="License: MIT"></a>
+<a href="https://nodejs.org"><img src="https://img.shields.io/node/v/devark-cli.svg" alt="Node.js Version"></a>
+
+<a href="https://github.com/devark/devark-cli/actions/workflows/tests.yml"><img src="https://github.com/devark/devark-cli/actions/workflows/tests.yml/badge.svg" alt="Tests"></a>
+<a href="https://github.com/devark/devark-cli/actions/workflows/npm-publish.yml"><img src="https://github.com/devark/devark-cli/actions/workflows/npm-publish.yml/badge.svg" alt="NPM Publish"></a>
+<a href="https://github.com/devark/devark-cli/actions/workflows/build-verification.yml"><img src="https://github.com/devark/devark-cli/actions/workflows/build-verification.yml/badge.svg" alt="Build Verification"></a>
+<img src="./coverage/badges.svg" alt="Coverage">
+
+<a href="SECURITY.md"><img src="https://img.shields.io/badge/Security-Policy-blue.svg" alt="Security Policy"></a>
+<a href="https://github.com/devark/devark-cli?tab=readme-ov-file#-privacy--security"><img src="https://img.shields.io/badge/build-transparent-blue" alt="Transparent Build"></a>
+
+<a href="CONTRIBUTING.md"><img src="https://img.shields.io/badge/PRs-welcome-brightgreen.svg" alt="PRs Welcome"></a>
+
+<a href="https://github.com/devark/devark-cli"><img src="https://img.shields.io/badge/⭐_Star-this_repo-22C55E?labelColor=000000" alt="Star this repo"></a>  
+ 
+</p>
+</p>
+
+[Website](https://devark.ai) • [Report Bug](https://github.com/devark/devark-cli/issues) • [Request Feature](https://github.com/devark/devark-cli/issues)
+</div>
+
+
+## What is DevArk?
+
+DevArk-cli is an open-source command-line tool that analyzes your Claude Code sessions to extract productivity insights and generate reports. All analyses can run completely locally on your machine using Claude Code's capabilities. It also encompasses a statusline that help you get more from your sessions.  
+
+## Getting Started fast
+Just run: 
+```bash
+npx devark-cli@latest
+```
+ 
+
+## Main features 
+### 1. 📋 Today's standup 
+New: Be prepared in 2-3 minutes for your daily standup meeting! 
+<img width="1270" height="512" alt="Screenshot 2025-10-02 163102" src="https://github.com/user-attachments/assets/b0e2bd55-618e-4b9e-b1c0-f2d7069e76aa" />
+
+
+### 2. 📊 Claude Code Productivity Report Generation (Local) 
+Generate comprehensive productivity reports using Claude Code's sub-agents to analyze your sessions in parallel. No data leaves your machine.
+See example of locally generated report here: https://devark.ai/example-daily-report
+ 
+
+### 3. 🧠 Claude Code Co-pilot Statusline 
+Strategic product advisor in Claude Code. Your prompts are analyzed locally (via CC) to provide actionable guidance that pushes you to ship faster. Feedback appears in your Claude Code status line with concrete next steps.
+<img width="612" height="227" alt="image" src="https://github.com/user-attachments/assets/b2f7f10b-8a29-429b-921a-d0fc0bc45183" />
+
+## Updates 
+
+### What's New in v0.7.x
+#### Today's Standup ✨
+Get a personalized standup summary of your recent claude coding activity right from your terminal. Runs 100% locally using your own Claude Code installation 
+The standup feature analyzes your recent sessions and generates a concise summary of:
+* What you worked on
+* Key accomplishments
+* Next steps
+
+#### Improved Onboarding Experience 🚀
+Getting started with devark is now smoother than ever:
+Better first-run setup flow
+Helpful prompts to guide you through configuration
+Improved error messages when things go wrong
+
+#### Improved Time Calculation ⏱️
+More accurate session duration tracking with better handling of:
+Massive sessions: Sessions with 10,000+ messages no longer cause performance issues
+Smart truncation: Large sessions are intelligently truncated while preserving time data
+Consistent timestamps: Better parsing and validation of session timing information
+Edge case handling: Fixed issues with sessions that had missing or invalid timestamps
+
+
+
+## 💬 More about Claude Status Line - Strategic Co-pilot / Advisor (Local)
+
+**🔒 Installation Safety**: Automatically backs up your existing status line configuration. Uninstalling instantly restores your original setup - zero risk to your Claude Code configuration.
+
+
+### Why Use Status Line?
+
+- **🚀 Ship Faster**: Get pushed to deliver
+- **🎯 Stay Focused**: Remembers your original mission and keeps you on track and forward ⏩︎
+- **⚡ Concrete Actions**: Specific next steps like:
+- **📈 Strategic Thinking**: Considers edge cases, user experience, and scaling at the right time
+- **📊 Token Usage Display**: Integrates with ccusage to show real-time token metrics
+- **↩️ Easy Restore**: Your original status line is backed up and can be restored anytime
+## Architecture
+### How Status Line Works
+1. Intercepts prompts submitted in Claude Code
+1. Analyzes via the local Claude Code latest prompt with relevant session context.
+4. Provides strategic guidance and pushes you to ship
+5. Displays actionable feedback in the Claude Code status line
+
+In more details:
+```mermaid
+flowchart LR
+    subgraph Input ["✳️ In Claude Code"]
+        User([👤 You type a<br/>prompt]) --> Submit[Press Enter to<br/>submit prompt]
+        Submit --> Hook[🪝 UserPromptSubmit<br/>hook triggers]
+    end
+
+    subgraph Analysis ["🧠 Local Prompt Analysis via Claude Code SDK"]
+        Hook --> CLI[DevArk CLI<br/>receives prompt]
+        CLI --> Check{Is new chat?}
+        Check -->|No| Context[📝 Include previous<br/>conversation]
+        Check -->|Yes| Direct[💭 Analyze prompt<br/>standalone]
+        
+        subgraph Personality ["🎭 Infuse Coach Personality"]
+            Gordon[🧑‍🍳 Gordon<br/>Tough love]
+            Vibe[💜 DevArk<br/>Encouraging]
+            Custom[✨ Custom<br/>Your style]
+        end
+        
+        Context --> SDK[Claude SDK<br/>analyzes prompt quality]
+        Direct --> SDK
+        Personality -.-> SDK
+        SDK --> Score[📊 Generate score<br/>& suggestion]
+    end
+
+    subgraph Display ["💬 Status Line Feedback"]
+        Score --> Save[💾 Save to<br/>~/.devark/analysis]
+        Save --> Status[Status bar<br/>reads result]
+        Status --> Show[🟢 85/100<br/>✨ Gordon says:<br/>Add more context chef!]
+    end
+
+    Show --> Improve([📈 Better prompts<br/>Better results])
+  ```
+
+### Coach Personalities
+- **Gordon** - Sharp, pushy, business-focused. Creates urgency: "Ship by FRIDAY or you're fired!"
+- **DevArk** - Supportive but pushy senior dev. Helps you ship: "MVP checklist: Auth works ✓ | Ship it!"
+- **Custom** - User-defined personality with strategic focus
+
+### Example Output
+ 
+
+### Setup
+1. Run `npx devark-cli`
+2. Select "Configure prompt coach status line"
+3. Choose coach personality
+4. (Optional) Enable ccusage token metrics display
+5. Prompts will be analyzed locally in Claude Code
+
+**Note**: Installation automatically backs up your current status line (if any). When you uninstall devark, your original configuration is instantly restored.
+
+## Local Report Generation Works
+
+Generate comprehensive productivity reports using Claude Code's sub-agents to analyze your sessions in parallel. No data leaves your machine.
+- Select timefrema
+- Select projects
+  
+```mermaid
+flowchart TD
+    Start([📝 Claude Code Sessions]) --> Select[devark-cli select time frame and projects]
+    Select --> Extract[Extracts & prepares session data]
+    Extract --> Launch[Launches Claude with instructions]
+    Launch --> Parallel{Parallel sub-agents<br/> session analysis}
+    Parallel --> Gather[Gathers results &<br/>Generates report]
+    Gather --> Output[📊 HTML Report in current folder]    
+    style Start fill:#e1f5fe
+    style Output fill:#d4edda
+```
+## Example of Local Report Output
+<img width="1920" height="4048" alt="screencapture-file-C-devark-devark-cli-devark-report-2025-09-05-2-html-2025-09-05-15_54_16" src="https://github.com/user-attachments/assets/545c0515-7649-4561-9e19-86b69a2e7103" />
+
+## ☁️ Cloud Sync (Optional)
+
+Optionally sync your sanitized session data to the devark dashboard for advanced analytics and tracking over time.
+
+### Features
+- **🎁 Free Forever**: Up to 1,000 session analyses per month
+- **📈 Track Over Time**: Monitor your prompt quality and productivity trends
+- **🔄 Auto-sync**: Configure hooks for automatic background sync
+- **🔒 Privacy First**: All code removed before upload, only patterns synced
+- **📊 Web Dashboard**: Learn and improve your AI coding sessions.
+
+### How It Works
+
+```mermaid
+flowchart TD
+    subgraph Local ["🏠 Your Machine"]
+        Sessions[Claude Code Sessions] --> Select[Select sessions]
+        Select --> Privacy[🔒 Privacy Layer<br/>Removes code & secrets<br/>Keeps only patterns]
+    end
+    
+    subgraph Cloud ["☁️ DevArk Cloud"]
+        Privacy --> Upload[Upload patterns]
+        Upload --> Verify[Server verification]
+        Verify --> Analysis[AI analysis]
+        Analysis --> Dashboard[📊 Web Dashboard]
+    end
+    
+    subgraph Features ["Dashboard Features"]
+        Dashboard --> Track[📈 Track prompt improvement over time]
+        Dashboard --> Metrics[⚡ Deeper productivity insights]  
+        Dashboard --> Streaks[🔥 Peak times/Low times]
+        Dashboard --> Prompt[💬 User Prompt Analysis]
+    end
+    
+    style Local fill:#e1f5fe
+    style Cloud fill:#f3e5f5
+    style Features fill:#d4edda
+```
+## Auto-Sync 
+### What is Auto-Sync
+Claude Code Hooks allow DevArk to automatically sync your Claude Code sessions.
+
+What are Claude Code Hooks?
+
+  • Small commands that run at specific moments in Claude Code
+  
+  • They work silently in the background (you won't notice them)
+
+  
+Which hooks do we use?
+
+  📍 SessionStart - Syncs previous sessions when you start/resume work
+     (Triggers: startup, resume, clear commands)
+     
+  📦 PreCompact - Syncs full session before context compression
+     (Triggers: manual or automatic context cleanup)
+
+     
+Why we recommend both:
+
+  ✓ SessionStart ensures nothing is lost between sessions
+  
+  ✓ PreCompact syncs everything before Claude compresses context
+    
+### Setup Auto-sync
+1. Run `npx devark-cli`
+2. Authenticate with your Github account
+3. Enable auto-sync via CLI menu
+
+## Supported Coding Engines 
+
+Currently supported:
+- ✅ Claude Code
+
+Future:
+- 🔜 Cursor
+- 🔜 VS Code
+
+🌍 Cross-Platform - Runs on macOS, Windows, Linux, and any environment with Node.js
+
+
+## 🔒 Privacy & Security
+
+<div align="center">
+<a href="https://github.com/devark/devark-cli/actions/workflows/npm-publish.yml"><img src="https://img.shields.io/badge/Automated-Releases-success?logo=githubactions" alt="Automated Releases"></a>
+<a href="https://www.npmjs.com/package/devark-cli"><img src="https://img.shields.io/badge/NPM-Provenance-green?logo=npm" alt="NPM Provenance"></a>
+<a href="#verify-our-package"><img src="https://img.shields.io/badge/SHA256-Checksums-blue?logo=shield" alt="SHA256 Checksums"></a>
+<a href="https://github.com/devark/devark-cli"><img src="https://img.shields.io/badge/Open-Source-orange?logo=github" alt="Open Source"></a>
+</div>
+
+<br>
+
+**This package is built with complete transparency:**
+
+- ✅ **Source Code**: Fully open source at [github.com/devark/devark-cli](https://github.com/devark/devark-cli)
+- ✅ **Not Minified**: Published code is readable and verifiable
+- ✅ **Source Maps**: Included for debugging and verification
+- ✅ **Automated Builds**: All releases via GitHub Actions (no manual publishing)
+- ✅ **npm Provenance**: Every package includes build attestation
+- ✅ **Checksums**: SHA256 hashes for integrity verification
+
+### Verify Our Package
+
+```bash
+# Download and inspect the package
+npm pack devark-cli@latest
+tar -xzf devark-cli-*.tgz
+head -100 package/dist/index.js  # Verify it's readable
+
+# Check checksums
+cd package/dist && sha256sum -c checksums.sha256
+```
+
+### Privacy
+- **Context-Preserving Sanitization**: Messages are sanitized to remove sensitive data while preserving context
+- **What gets redacted/removed**:
+  - Code blocks → `[CODE_BLOCK_1: javascript]`
+  - API keys/tokens → `[CREDENTIAL_1]`
+  - File paths → `[PATH_1]`
+  - URLs → `[DATABASE_URL]`, `[API_URL]`
+  - Emails → `[EMAIL_1]`
+  - Environment variables → `[ENV_VAR_1]`
+  - Also Removed: Images/Binary files 
+- **What's preserved**: Conversation flow, questions, explanations
+- **Transparent**: Preview sanitized data with the interactive prompt
+- **Open source**: Review our sanitization at [src/lib/message-sanitizer-v2.ts](src/lib/message-sanitizer-v2.ts)
+
+## Troubleshooting
+
+### Authentication Issues
+Try the following: 
+- Log out from the CLI
+- Clear cookies
+- Re-authenticate via the CLI 
+
+### No Sessions Found
+- Make sure Claude Code is installed
+- Check that you've used Claude Code recently
+
+### Sessions Stuck in Analyzing
+- Please open a Github issue.
+
+
+### Debug Mode
+```bash
+# Enable debug logging
+DEVARK_DEBUG=1 npx devark-cli send
+```
+
+## Contributing
+
+We love your input! We want to make contributing to DevArk CLI as easy and transparent as possible. Please see our [Contributing Guide](CONTRIBUTING.md) for details.
+
+```bash
+# Clone the repository
+git clone https://github.com/devark/devark-cli.git
+cd devark-cli
+
+# Install dependencies
+npm install
+
+# Run tests
+npm test
+
+# Build the project
+npm run build
+```
+
+Check out our [open issues](https://github.com/devark/devark-cli/issues) for a list of proposed features and known issues.
+
+## Community
+
+- **GitHub**: Star us on [GitHub](https://github.com/devark/devark-cli)
+- **Issues**: Report bugs and request features in [GitHub Issues](https://github.com/devark/devark-cli/issues)
+- **Website**: Visit [devark.ai](https://devark.ai)
+
+## Support
+
+Need help? Here are some ways to get support:
+- 🐛 Report bugs in [GitHub Issues](https://github.com/devark/devark-cli/issues)
+- 📧 Email us at support@devark.ai
+
+## License
+
+MIT © DevArk - see the [LICENSE](LICENSE) file for details.
+
+## Acknowledgments
+
+Built with love by the DevArk team [@mickmicksh](https://github.com/mickmicksh), [@dannyshmueli](https://github.com/dannyshmueli)
+
+Special thanks to [ccusage](https://www.npmjs.com/package/ccusage) for providing token usage metrics integration for Claude Code sessions.
+
+## Star History
+
+[![Star History Chart](https://api.star-history.com/svg?repos=devark/devark-cli&type=Date)](https://www.star-history.com/#devark/devark-cli&Date)

package/bin/devark.js

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+require('../dist/index.js');

package/dist/checksums.sha256

@@ -0,0 +1,3 @@
+52a46eee13d20a05fc798ac3e30f00685cf9475e3a56a48ede86461cd5d56ee1  index.js
+6e948721c1e5bb7dd3e746c0e1e7a972cbd491b6f0135718178b22563ca56de9  index.js.map
+137b0f6da8ab3a82dd96e536c9de1c0162f51d5450895af16e935906975671a8  report-template.html