@theihtisham/dev-pulse 1.0.0 → 1.1.0

package/.editorconfig

@@ -0,0 +1,12 @@
+root = true
+
+[*]
+charset = utf-8
+end_of_line = lf
+indent_style = space
+indent_size = 2
+insert_final_newline = true
+trim_trailing_whitespace = true
+
+[*.md]
+trim_trailing_whitespace = false

package/.github/ISSUE_TEMPLATE/bug_report.yml

@@ -0,0 +1,43 @@
+name: Bug Report
+description: Report a bug or unexpected behavior
+labels: [bug]
+body:
+  - type: textarea
+    id: description
+    attributes:
+      label: Bug Description
+      description: What happened?
+      placeholder: "When I run agent-memory..."
+    validations:
+      required: true
+
+  - type: textarea
+    id: steps
+    attributes:
+      label: Steps to Reproduce
+      description: How can we reproduce this?
+      placeholder: "1. Install...\n2. Configure...\n3. Run..."
+    validations:
+      required: true
+
+  - type: textarea
+    id: expected
+    attributes:
+      label: Expected Behavior
+      description: What should have happened?
+    validations:
+      required: true
+
+  - type: textarea
+    id: environment
+    attributes:
+      label: Environment
+      description: Node version, OS, etc.
+      placeholder: "Node 20.11.0, macOS 14, agent-memory 1.0.0"
+
+  - type: textarea
+    id: logs
+    attributes:
+      label: Relevant Logs
+      description: Paste any relevant log output
+      render: shell

package/.github/ISSUE_TEMPLATE/feature_request.yml

@@ -0,0 +1,33 @@
+name: Feature Request
+description: Suggest a new feature or enhancement
+labels: [enhancement]
+body:
+  - type: textarea
+    id: problem
+    attributes:
+      label: Problem
+      description: What problem does this feature solve?
+      placeholder: "I'm frustrated when..."
+    validations:
+      required: true
+
+  - type: textarea
+    id: solution
+    attributes:
+      label: Proposed Solution
+      description: How should it work?
+    validations:
+      required: true
+
+  - type: dropdown
+    id: type
+    attributes:
+      label: Feature Type
+      options:
+        - New Tool/Resource
+        - Performance Improvement
+        - Developer Experience
+        - Documentation
+        - Other
+    validations:
+      required: true

package/.github/PULL_REQUEST_TEMPLATE.md

@@ -0,0 +1,18 @@
+## Description
+
+<!-- Brief description of changes -->
+
+## Type of Change
+
+- [ ] Bug fix
+- [ ] New feature
+- [ ] Breaking change
+- [ ] Documentation update
+- [ ] Refactor / cleanup
+
+## Checklist
+
+- [ ] Tests pass (`npm test`)
+- [ ] Type checks pass (`npm run lint`)
+- [ ] No secrets or credentials introduced
+- [ ] Commit messages follow [conventional commits](https://www.conventionalcommits.org/)

package/.github/dependabot.yml

@@ -0,0 +1,16 @@
+version: 2
+updates:
+  - package-ecosystem: npm
+    directory: /
+    schedule:
+      interval: weekly
+      day: monday
+    open-pull-requests-limit: 5
+    commit-message:
+      prefix: chore
+      include: scope
+
+  - package-ecosystem: github-actions
+    directory: /
+    schedule:
+      interval: monthly

package/.github/workflows/ci.yml

@@ -0,0 +1,33 @@
+name: CI
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        python-version: ['3.10', '3.11', '3.12']
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: ${{ matrix.python-version }}
+      - run: pip install -e ".[dev]"
+      - run: pytest --cov -v
+      - run: pip install ruff && ruff check .
+
+  build:
+    runs-on: ubuntu-latest
+    needs: test
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: '3.11'
+      - run: pip install build
+      - run: python -m build

package/CODE_OF_CONDUCT.md

@@ -0,0 +1,27 @@
+# Contributor Covenant Code of Conduct
+
+## Our Pledge
+
+We as members, contributors, and leaders pledge to make participation in our community a harassment-free experience for everyone.
+
+## Our Standards
+
+Examples of behavior that contributes to a positive environment:
+- Demonstrating empathy and kindness toward other people
+- Being respectful of differing opinions, viewpoints, and experiences
+- Giving and gracefully accepting constructive feedback
+- Accepting responsibility and apologizing to those affected by our mistakes
+
+Examples of unacceptable behavior:
+- The use of sexualized language or imagery
+- Trolling, insulting or derogatory comments
+- Public or private harassment
+- Publishing others' private information without explicit permission
+
+## Enforcement
+
+Instances of abusive, harassing, or otherwise unacceptable behavior may be reported to **Theihtisham@outlook.com**.
+
+## Attribution
+
+This Code of Conduct is adapted from the [Contributor Covenant](https://www.contributor-covenant.org/), version 2.1.

package/Dockerfile

@@ -0,0 +1,8 @@
+FROM python:3.11-slim
+
+WORKDIR /app
+COPY pyproject.toml requirements.txt ./
+RUN pip install --no-cache-dir .
+COPY devpulse/ ./devpulse/
+
+ENTRYPOINT ["python", "-m", "devpulse.cli.main"]

package/LICENSE

@@ -1,21 +1,21 @@
-MIT License
-
-Copyright (c) 2026 DevPulse Contributors
-
-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.
+MIT License
+
+Copyright (c) 2026 DevPulse Contributors
+
+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

@@ -1,73 +1,169 @@
-# Dev Pulse
+<div align="center">
 
-Developer productivity metrics dashboard
+<img width="100%" height="180" src="data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 960 180'%3E%3Cdefs%3E%3ClinearGradient id='g' x1='0%25' y1='0%25' x2='100%25' y2='100%25'%3E%3Cstop offset='0%25' stop-color='%2334d399'/%3E%3Cstop offset='100%25' stop-color='%2338bdf8'/%3E%3C/linearGradient%3E%3C/defs%3E%3Crect width='960' height='180' fill='%230a0a1a' rx='16'/%3E%3Crect x='2' y='2' width='956' height='176' fill='none' stroke='url(%23g)' stroke-width='2' rx='15'/%3E%3Ctext x='480' y='75' text-anchor='middle' fill='white' font-family='system-ui' font-size='38' font-weight='bold'%3E%F0%9F%93%8A Dev Pulse%3C/text%3E%3Ctext x='480' y='115' text-anchor='middle' fill='%23a5a5c0' font-family='system-ui' font-size='18'%3EAI-Powered Developer Productivity Dashboard%3C/text%3E%3Ctext x='480' y='148' text-anchor='middle' fill='%236b6b88' font-family='monospace' font-size='13'%3EFastAPI %C2%B7 Rich %C2%B7 GitHub Integration %C2%B7 CLI %C2%B7 Pydantic %C2%B7 Scheduled Reports%3C/text%3E%3C/svg%3E" alt="Dev Pulse Banner"/>
 
-## Installation
+[![CI](https://img.shields.io/github/actions/workflow/status/theihtisham/dev-pulse/ci.yml?style=for-the-badge&label=CI)](https://github.com/theihtisham/dev-pulse/actions/workflows/ci.yml)
+[![PyPI version](https://img.shields.io/pypi/v/ai-dev-pulse.svg?style=for-the-badge&color=FF6D00)](https://pypi.org/project/ai-dev-pulse/)
+[![Python](https://img.shields.io/badge/Python-3.10%2B-3776AB?style=for-the-badge&logo=python&logoColor=white)](https://www.python.org/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg?style=for-the-badge)](https://opensource.org/licenses/MIT)
 
-```bash
-npm install @theihtisham/dev-pulse
+**AI-powered developer productivity dashboard with GitHub integration.** Track commits, PRs, code reviews, and team metrics with intelligent insights and scheduled reports.
+
+[Quick Start](#-quick-start) · [Architecture](#-architecture) · [Configuration](#-configuration)
+
+</div>
+
+---
+
+## Architecture
+
+```mermaid
+graph TD
+    subgraph "Data Sources"
+        GH[GitHub API<br/>Commits / PRs / Reviews]
+        CLI[CLI Interface<br/>Click + Rich]
+    end
+
+    subgraph "Dev Pulse Engine"
+        API[FastAPI Server<br/>REST + WebSocket]
+        ANALYZER[Analytics Engine<br/>Metrics + Trends]
+        SCHED[Scheduler<br/>Periodic Reports]
+        MODELS[Pydantic Models<br/>Typed Data]
+    end
+
+    subgraph "Output"
+        DASH[Rich Dashboard<br/>Terminal UI]
+        REPORT[Report Generator<br/>Markdown / HTML]
+        ALERT[Alert System<br/>Threshold Notifications]
+    end
+
+    GH --> API
+    CLI --> API
+    API --> ANALYZER
+    ANALYZER --> MODELS
+    SCHED --> ANALYZER
+    ANALYZER --> DASH
+    ANALYZER --> REPORT
+    ANALYZER --> ALERT
+
+    style API fill:#34d399,color:#000
+    style ANALYZER fill:#38bdf8,color:#fff
 ```
 
-## Usage
+---
+
+## Quick Start
 
-```typescript
-import { } from '@theihtisham/dev-pulse';
+```bash
+# Install
+pip install ai-dev-pulse
+
+# Or from source
+git clone https://github.com/theihtisham/dev-pulse.git
+cd dev-pulse
+pip install -e ".[dev]"
 ```
 
-## Features
+### Configure
+
+Create `.env` or export environment variables:
+
+```bash
+GITHUB_TOKEN=ghp_...     # GitHub personal access token
+GITHUB_ORG=your-org      # Optional: default organization
+```
 
-- Written in TypeScript with full type definitions
-- Zero external dependencies (minimal footprint)
-- Event-driven architecture
-- Comprehensive test suite
+### Run
 
-## API
+```bash
+# CLI dashboard
+devpulse dashboard
 
-### Quick Start
+# Generate report
+devpulse report --format markdown --output report.md
 
-```typescript
-import { } from '@theihtisham/dev-pulse';
+# Start web server
+devpulse serve --port 8000
 
-// Initialize and use the package
+# Schedule periodic reports
+devpulse schedule --interval daily
 ```
 
+---
+
+## Features
+
+| Feature | Description |
+|---------|-------------|
+| **Commit Analytics** | Track commit frequency, size, and patterns |
+| **PR Metrics** | Review turnaround, approval rates, bottleneck detection |
+| **Team Dashboard** | Per-developer productivity metrics |
+| **Trend Analysis** | AI-powered trend detection and predictions |
+| **Scheduled Reports** | Daily/weekly automated report generation |
+| **Rich CLI** | Beautiful terminal output with Rich library |
+| **Web Dashboard** | FastAPI-powered web interface |
+| **Alert Thresholds** | Configurable alerts for metric anomalies |
+
+---
+
 ## Configuration
 
-Configuration options and their defaults:
+### CLI Commands
 
-```typescript
-const config = {
-  // Add configuration options here
-};
+```bash
+devpulse dashboard          # Interactive dashboard
+devpulse report             # Generate report
+devpulse serve              # Start web server
+devpulse schedule           # Schedule periodic reports
+devpulse config show        # Show current config
+devpulse config set KEY VAL # Set configuration
 ```
 
-## Examples
+### Environment Variables
 
-See the `tests/` directory for usage examples.
+| Variable | Required | Description |
+|----------|----------|-------------|
+| `GITHUB_TOKEN` | Yes | GitHub personal access token |
+| `GITHUB_ORG` | No | Default GitHub organization |
+| `PORT` | No | Web server port (default: 8000) |
 
-## Development
+---
+
+## Docker
 
 ```bash
-# Install dependencies
-npm install
+docker build -t dev-pulse .
+docker run -e GITHUB_TOKEN=ghp_... dev-pulse
+```
 
-# Build
-npm run build
+---
 
-# Run tests
-npm test
+## Development
 
-# Lint
-npm run lint
+```bash
+pip install -e ".[dev]"
+pytest --cov -v
+ruff check .
 ```
 
+---
+
+## Trending Tags
+
+`developer-tools` `productivity` `dashboard` `github` `metrics` `analytics` `fastapi` `rich` `python` `cli` `devops` `team-management`
+
+---
+
 ## License
 
-MIT License - see [LICENSE](LICENSE) for details.
+MIT License — see [LICENSE](LICENSE) for details.
+
+---
+
+<div align="center">
 
-## Author
+**Built by [theihtisham](https://github.com/theihtisham)**
 
-**ihtisham**
+[GitHub](https://github.com/theihtisham) · [Email](mailto:Theihtisham@outlook.com)
 
-- GitHub: [https://github.com/ihtisham](https://github.com/ihtisham)
-- npm: [@theihtisham](https://www.npmjs.com/~theihtisham)
+</div>

package/SECURITY.md

@@ -0,0 +1,22 @@
+# Security Policy
+
+## Supported Versions
+
+| Version | Supported |
+| ------- | --------- |
+| 1.x     | Yes       |
+
+## Reporting a Vulnerability
+
+If you discover a security vulnerability, please report it responsibly:
+
+- **Email**: Theihtisham@outlook.com
+- **Subject**: [Security] Vulnerability in ai-agent-memory
+
+Please include:
+1. Description of the vulnerability
+2. Steps to reproduce
+3. Potential impact
+4. Suggested fix (if any)
+
+We aim to respond within 48 hours and patch critical issues within 7 days.

package/devpulse/__init__.py

@@ -1,4 +1,4 @@
-"""DevPulse - AI-powered developer productivity dashboard."""
-
-__version__ = "1.0.0"
-__author__ = "DevPulse Contributors"
+"""DevPulse - AI-powered developer productivity dashboard."""
+
+__version__ = "1.0.0"
+__author__ = "DevPulse Contributors"

package/devpulse/api/__init__.py

@@ -1 +1 @@
-"""FastAPI web API package for DevPulse."""
+"""FastAPI web API package for DevPulse."""