vaspera-pm 2.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024-2025 Vaspera Capital
+
+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,228 @@
+# VasperaPM
+
+<div align="center">
+
+```
+╔═══════════════════════════════════════════════════════════════╗
+║                                                               ║
+║   ██╗   ██╗ █████╗ ███████╗██████╗ ███████╗██████╗  █████╗    ║
+║   ██║   ██║██╔══██╗██╔════╝██╔══██╗██╔════╝██╔══██╗██╔══██╗   ║
+║   ██║   ██║███████║███████╗██████╔╝█████╗  ██████╔╝███████║   ║
+║   ╚██╗ ██╔╝██╔══██║╚════██║██╔═══╝ ██╔══╝  ██╔══██╗██╔══██║   ║
+║    ╚████╔╝ ██║  ██║███████║██║     ███████╗██║  ██║██║  ██║   ║
+║     ╚═══╝  ╚═╝  ╚═╝╚══════╝╚═╝     ╚══════╝╚═╝  ╚═╝╚═╝  ╚═╝   ║
+║                                                               ║
+║              AI-Powered Product Management                    ║
+║                                                               ║
+╚═══════════════════════════════════════════════════════════════╝
+```
+
+**Transform your ideas into production-ready specs with AI**
+
+[![npm version](https://img.shields.io/npm/v/vaspera-pm.svg)](https://www.npmjs.com/package/vaspera-pm)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
+</div>
+
+---
+
+## What is VasperaPM?
+
+VasperaPM is an MCP (Model Context Protocol) server that brings AI-powered product management tools directly into Claude Code. Generate PRDs, API specs, test cases, and sync with your favorite PM tools - all from your IDE.
+
+### Key Features
+
+- **Generate PRDs** - Create comprehensive Product Requirements Documents from context
+- **Infer from Code** - Analyze existing codebases to generate documentation
+- **Generate Code** - Turn PRDs into implementation code
+- **API Specs** - Auto-generate OpenAPI/Swagger specifications
+- **Test Cases** - Create detailed test plans and acceptance criteria
+- **PM Tool Sync** - Export to Jira, Linear, and GitHub
+
+---
+
+## Quick Start (Zero Friction)
+
+### Option 1: Use npx (Recommended - No Install)
+
+```bash
+# One command - that's it!
+npx vaspera-pm analyze .
+
+# Or with your Anthropic API key
+ANTHROPIC_API_KEY=sk-ant-xxx npx vaspera-pm analyze .
+```
+
+### Option 2: Global Install
+
+```bash
+# Install once
+npm install -g vaspera-pm
+
+# Use anywhere
+vaspera-pm analyze .
+```
+
+### Option 3: Claude Code Integration
+
+```bash
+# Set up MCP server for Claude Code
+npx vaspera-pm install
+
+# Restart VSCode/Claude Code, then try:
+# "Generate a PRD for a user authentication system"
+# "Analyze this codebase and create a PRD"
+```
+
+---
+
+## Commands
+
+| Command | Description |
+|---------|-------------|
+| `vaspera-pm analyze <path>` | Full analysis: discover → analyze → verify → output |
+| `vaspera-pm verify <path>` | Quick verification check (for CI/CD) |
+| `vaspera-pm discover <path>` | Discovery only (no AI, no API key needed) |
+| `vaspera-pm init` | Initialize VasperaPM in a project |
+| `vaspera-pm install` | Configure MCP server for Claude Code |
+| `vaspera-pm serve` | Start the MCP server (used by Claude Code) |
+| `vaspera-pm status` | Check your current configuration |
+
+---
+
+## Available Tools (29 Total)
+
+Once installed, these tools are available in Claude Code:
+
+### Requirements & PRDs
+| Tool | Description |
+|------|-------------|
+| `synthesize_requirements` | Extract requirements from meeting notes, emails, specs |
+| `synthesize_master_prd` | Create unified PRD from multiple sources |
+| `infer_prd_from_code` | Reverse-engineer PRD from existing code |
+| `review_prd` | Quality review with completeness scoring |
+| `explode_backlog` | Break features into sprint-ready stories |
+
+### Code Analysis
+| Tool | Description |
+|------|-------------|
+| `explain_codebase` | Generate onboarding documentation |
+| `reverse_engineer_user_flows` | Extract user journeys from code |
+| `validate_implementation` | Verify code matches requirements |
+| `suggest_refactors` | Identify tech debt and improvements |
+
+### Architecture & Specs
+| Tool | Description |
+|------|-------------|
+| `generate_architecture` | Create system design from requirements |
+| `generate_api_docs` | Auto-generate OpenAPI specifications |
+| `generate_test_specs` | Create comprehensive test plans |
+| `handoff_package` | Generate developer handoff documentation |
+
+### Verification & Drift Detection
+| Tool | Description |
+|------|-------------|
+| `verify_docs_code` | Detect documentation vs code drift |
+| `analyze_git_freshness` | Find stale documentation |
+| `dependency_audit` | Security and update checks |
+
+### Export & Integration
+| Tool | Description |
+|------|-------------|
+| `sync_to_tracker` | Export to Jira, Linear, GitHub, ADO |
+| `export_requirements` | Generate portable requirement formats |
+| `generate_complete_backlog` | Full sprint backlog generation |
+
+### DevOps & Traceability
+| Tool | Description |
+|------|-------------|
+| `generate_deployment_runbook` | Create deployment documentation |
+| `generate_changelog` | Auto-generate release notes |
+| `detect_regressions` | Find breaking changes |
+| `generate_sprint_report` | Sprint summary and metrics |
+
+### Pipeline Automation
+| Tool | Description |
+|------|-------------|
+| `run_pipeline` | Orchestrate multi-tool workflows |
+
+---
+
+## API Keys
+
+### Local Mode (Zero Friction)
+
+Just use your own Anthropic API key - no account needed:
+
+```bash
+export ANTHROPIC_API_KEY=sk-ant-xxx
+npx vaspera-pm analyze .
+```
+
+Features:
+- All 29 tools work locally
+- Output saved to `docs/vasperaPM/`
+- No account required
+- Works in air-gapped environments
+
+### Cloud Mode (Team Features)
+
+Get a VasperaPM API key at [vasperapm.com/dashboard](https://vasperapm.com/dashboard) for:
+
+- Team collaboration & sharing
+- Usage analytics & billing
+- Jira/Linear/GitHub integrations
+- Historical drift tracking
+- Webhook notifications
+
+```bash
+npx vaspera-pm connect  # Link your account
+```
+
+---
+
+## Configuration
+
+VasperaPM uses sensible defaults - no configuration required.
+
+Optional configuration locations:
+- `~/.vasperapm/config.json` - Your settings and cloud API key
+- `~/.claude/claude_desktop_config.json` - Claude Code MCP integration
+- `ANTHROPIC_API_KEY` - Environment variable for local mode
+
+---
+
+## Integrations
+
+Connect your PM tools at [vasperapm.com/dashboard/integrations](https://vasperapm.com/dashboard/integrations):
+
+- **Jira** - Sync PRDs to epics and stories
+- **Linear** - Export tasks to Linear projects
+- **GitHub** - Create issues and track progress
+
+---
+
+## Requirements
+
+- Node.js 20+
+- Claude Code (VSCode extension or CLI)
+
+---
+
+## Support
+
+- **Documentation**: [github.com/rcolkitt/VasperaPM](https://github.com/rcolkitt/VasperaPM)
+- **Issues**: [github.com/rcolkitt/VasperaPM/issues](https://github.com/rcolkitt/VasperaPM/issues)
+- **Dashboard**: [vasperapm.com/dashboard](https://vasperapm.com/dashboard)
+
+---
+
+## License
+
+MIT License - see [LICENSE](LICENSE) for details.
+
+---
+
+<div align="center">
+Made with by <a href="https://github.com/rcolkitt">@rcolkitt</a>
+</div>

package/dist/cli.d.ts

@@ -0,0 +1 @@
+#!/usr/bin/env node