up-cli 0.1.1__py3-none-any.whl → 0.2.0__py3-none-any.whl

up_cli-0.2.0.dist-info/METADATA

@@ -0,0 +1,374 @@
+Metadata-Version: 2.4
+Name: up-cli
+Version: 0.2.0
+Summary: AI-powered project scaffolding with docs, learn, and product-loop systems
+Project-URL: Homepage, https://github.com/yourusername/up-cli
+Project-URL: Documentation, https://github.com/yourusername/up-cli#readme
+Project-URL: Repository, https://github.com/yourusername/up-cli
+Author-email: Your Name <you@example.com>
+License-Expression: MIT
+Keywords: ai,claude,cli,cursor,mcp,productivity,scaffolding
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Software Development :: Code Generators
+Requires-Python: >=3.10
+Requires-Dist: click>=8.0
+Requires-Dist: pyyaml>=6.0
+Requires-Dist: rich>=13.0
+Requires-Dist: tqdm>=4.65.0
+Provides-Extra: dev
+Requires-Dist: mypy>=1.5.0; extra == 'dev'
+Requires-Dist: pytest-cov>=4.0; extra == 'dev'
+Requires-Dist: pytest>=7.0; extra == 'dev'
+Requires-Dist: ruff>=0.1.0; extra == 'dev'
+Description-Content-Type: text/markdown
+
+# up-cli
+
+<img width="3498" height="2182" alt="543426914-37655a9f-e661-4ab5-b994-e4e11f97dd95" src="https://github.com/user-attachments/assets/7cbc2614-af8e-41cb-be2f-df2b6cd43b07" />
+
+
+An AI-powered CLI tool for scaffolding projects with built-in documentation, learning systems, and product-loop workflows designed for use with Claude Code and Cursor AI.
+
+**Learned from real practice** - Built on insights from 5+ billion tokens of development experience and commercial products. Extracts best practices from chat history, documentation patterns, and proven workflows.
+
+## Installation
+
+```bash
+pip install up-cli
+```
+
+## Quick Start
+
+```bash
+# Create new project
+up new my-project
+
+# Or initialize in existing project
+cd existing-project
+up init
+
+# Check system health
+up status
+
+# Live dashboard
+up dashboard
+```
+
+## Commands
+
+| Command | Description |
+|---------|-------------|
+| `up new <name>` | Create a new project with full scaffolding |
+| `up new <name> --template <type>` | Create project from specific template |
+| `up init` | Initialize up systems in current directory |
+| `up init --ai claude` | Initialize for Claude Code only |
+| `up init --ai cursor` | Initialize for Cursor AI only |
+| `up init --systems docs,learn` | Initialize specific systems only |
+| `up start` | Start the product loop |
+| `up start --resume` | Resume from last checkpoint |
+| `up start --dry-run` | Preview mode without changes |
+| `up status` | Show health of all systems |
+| `up dashboard` | Live interactive health dashboard |
+| `up learn auto` | Auto-analyze project for improvements |
+| `up learn plan` | Generate improvement PRD |
+| `up summarize` | Summarize AI conversation history |
+
+## Project Templates
+
+Create projects with pre-configured tech stacks:
+
+```bash
+# FastAPI backend with SQLAlchemy
+up new my-api --template fastapi
+
+# Next.js frontend with TypeScript
+up new my-app --template nextjs
+
+# Python library with packaging
+up new my-lib --template python-lib
+
+# Minimal structure
+up new my-project --template minimal
+
+# Full setup with MCP
+up new my-project --template full
+```
+
+| Template | Description |
+|----------|-------------|
+| `minimal` | Basic structure with docs |
+| `standard` | Full up systems (default) |
+| `full` | Everything including MCP server |
+| `fastapi` | FastAPI + SQLAlchemy + pytest |
+| `nextjs` | Next.js 14 + TypeScript + Tailwind |
+| `python-lib` | Python library with pyproject.toml |
+
+## Usage Examples
+
+### Create a new project
+
+```bash
+# Create a new project with all systems
+up new my-saas-app
+
+# Create with a specific template
+up new my-api --template fastapi
+```
+
+### Initialize in existing project
+
+```bash
+cd my-existing-project
+
+# Full initialization
+up init
+
+# Claude Code focused setup
+up init --ai claude
+
+# Only add docs and learn systems
+up init --systems docs,learn
+```
+
+### Monitor System Health
+
+```bash
+# Quick status check
+up status
+
+# Live dashboard (updates every 5 seconds)
+up dashboard
+
+# JSON output for scripting
+up status --json
+```
+
+### Using the Learn System
+
+```bash
+# Auto-analyze your project and generate insights
+up learn auto
+
+# Check learning system status
+up learn status
+
+# Generate a PRD from analysis
+up learn plan
+```
+
+### Using the Product Loop
+
+```bash
+# Start the product loop
+up start
+
+# Resume from checkpoint
+up start --resume
+
+# Preview what would happen
+up start --dry-run
+
+# Start with specific task
+up start --task US-003
+
+# Use custom PRD file
+up start --prd path/to/prd.json
+```
+
+### Summarize Conversations
+
+```bash
+# Summarize Cursor chat history
+up summarize
+
+# Export as JSON
+up summarize --format json --output summary.json
+
+# Filter by project
+up summarize --project myproject
+```
+
+## Systems
+
+### 1. Docs System
+
+Comprehensive documentation structure:
+
+```
+docs/
+├── CONTEXT.md         # AI reads first
+├── INDEX.md           # Quick reference
+├── roadmap/           # Strategic planning
+│   ├── vision/        # Product vision
+│   └── phases/        # Phase roadmaps
+├── architecture/      # System design
+├── features/          # Feature specs
+├── changelog/         # Progress tracking
+├── handoff/           # Session continuity
+├── decisions/         # ADRs
+└── learnings/         # Patterns discovered
+```
+
+### 2. Learn System
+
+Research and improvement pipeline:
+
+```
+RESEARCH → ANALYZE → COMPARE → PLAN → IMPLEMENT
+```
+
+- `/learn auto` - Auto-analyze project
+- `/learn research [topic]` - Research topic
+- `/learn plan` - Generate improvement PRD
+
+### 3. Product Loop (SESRC)
+
+Autonomous development with safety guardrails:
+
+| Principle | Implementation |
+|-----------|----------------|
+| **Stable** | Graceful degradation, fallback modes |
+| **Efficient** | Token budgets, incremental testing |
+| **Safe** | Input validation, path whitelisting |
+| **Reliable** | Timeouts, idempotency, rollback |
+| **Cost-effective** | Early termination, ROI threshold |
+
+Features:
+- Circuit breaker (max 3 failures)
+- Checkpoint/rollback
+- Health checks
+- Budget limits
+
+### 4. Context Budget
+
+Tracks AI context window usage:
+
+- Estimates token usage per file/message
+- Warns at 80% capacity
+- Suggests handoff at 90%
+- Persists across sessions
+
+### 5. MCP Server Support
+
+Model Context Protocol integration:
+
+```
+.mcp/
+├── config.json       # Server configuration
+├── tools/            # Custom tool definitions
+└── README.md         # Usage guide
+```
+
+## AI Integration
+
+### Generated Files
+
+| File | Purpose |
+|------|---------|
+| `CLAUDE.md` | Claude Code instructions |
+| `.cursorrules` | Cursor AI rules |
+| `.cursor/rules/*.md` | File-specific rules |
+| `.claude/context_budget.json` | Context tracking |
+
+### Cursor Rules
+
+Generated rules for different file types:
+- `main.md` - General project rules
+- `python.md` - Python standards
+- `typescript.md` - TypeScript standards
+- `docs.md` - Documentation standards
+- `tests.md` - Testing standards
+
+## Design Principles & Practices
+
+### AI-First Development
+
+**Design for AI collaboration, not just human readability.**
+
+- **Context-aware scaffolding** - Project structures optimized for AI agents to navigate and understand quickly
+- **Explicit over implicit** - Clear file naming, directory structures, and documentation that AI can parse without ambiguity
+- **Prompt-friendly patterns** - Code and docs written to be easily referenced in AI conversations
+- **Tool integration** - Native support for Claude Code skills and Cursor AI rules
+
+### Documentation-Driven Development
+
+**Documentation is the source of truth, not an afterthought.**
+
+- **Docs-first workflow** - Write documentation before implementation to clarify intent
+- **Living documentation** - Docs evolve with the codebase through automated learning systems
+- **Knowledge extraction** - `/learn` commands analyze patterns and generate insights from real usage
+- **Structured knowledge** - Vision, roadmaps, and changelogs in predictable locations for AI and human consumption
+
+### Product Loop Patterns (SESRC)
+
+**Autonomous development with safety guardrails.**
+
+- **Circuit breaker protection** - Max 3 consecutive failures before stopping to prevent runaway loops
+- **Checkpoint/rollback** - Save state before risky operations, restore on failure
+- **Health checks** - Validate system state between iterations
+- **Budget limits** - Token and time constraints to prevent unbounded execution
+- **Human-in-the-loop** - Critical decisions require explicit approval
+
+### Core Practices
+
+| Practice | Description |
+|----------|-------------|
+| **Incremental delivery** | Ship small, working increments over big-bang releases |
+| **Fail fast, recover faster** | Detect issues early, rollback automatically |
+| **Observable by default** | Logging, metrics, and state visible to both AI and humans |
+| **Convention over configuration** | Sensible defaults that work out of the box |
+
+## Development
+
+```bash
+# Install for development
+pip install -e ".[dev]"
+
+# Run tests
+pytest
+
+# Lint
+ruff check src/
+
+# Type check
+mypy src/
+```
+
+## Project Structure
+
+```
+up-cli/
+├── src/up/
+│   ├── cli.py              # Main CLI
+│   ├── context.py          # Context budget management
+│   ├── summarizer.py       # Conversation analysis
+│   ├── commands/           # CLI commands
+│   │   ├── init.py
+│   │   ├── new.py
+│   │   ├── status.py
+│   │   ├── dashboard.py
+│   │   ├── learn.py
+│   │   └── summarize.py
+│   └── templates/          # Scaffolding templates
+│       ├── config/         # CLAUDE.md, .cursor/rules
+│       ├── docs/           # Documentation system
+│       ├── learn/          # Learning system
+│       ├── loop/           # Product loop
+│       ├── mcp/            # MCP server
+│       └── projects/       # Project templates
+├── scripts/                # Utility scripts
+│   ├── export_claude_history.py
+│   └── export_cursor_history.py
+└── skills/                 # Reference skills
+```
+
+## License
+
+MIT

up_cli-0.2.0.dist-info/RECORD

@@ -0,0 +1,23 @@
+up/__init__.py,sha256=7suBsJ6_nxjrmi-aUlqOniZkgIWUttUoNQ_zT8vza9Q,70
+up/cli.py,sha256=vYwrxZaG3NX0LNuVNKe9eLmbQPPIvZPA9qZLC864kH0,1616
+up/context.py,sha256=Z_C5C7H_brC7IyQpRcEwlYToKcm9VKhzKyWIbE91yM8,11662
+up/summarizer.py,sha256=JyKYIB2CkuFuNHFuqiw6v6oEsD7enLIl9O8xA_32qQI,13952
+up/commands/__init__.py,sha256=95wKJUh3jcO5L0kj6UiA5Hanrs1mTnHv_L70PfmMNJ0,23
+up/commands/dashboard.py,sha256=7J7J3JFq95NecbOtSXQfm3zUytpacFVQrF0oMfdrlfg,7426
+up/commands/init.py,sha256=uBLYSict6O2nmywFIfgBbb_Isw8LkB3y5R09XAnrvfQ,1756
+up/commands/learn.py,sha256=iL-jlIfynVQ9a0VUl1qMQx5jXip8QyRcbXBQFK7ZR4k,12210
+up/commands/new.py,sha256=PNyrYtWkJDEWkKN1Axa57YW_pJYL6zjHCuhqbjq-FIc,4733
+up/commands/start.py,sha256=e61s28A-_rgmU_5nwKBQ3fuGbrieyL7S2152EZfun8A,13302
+up/commands/status.py,sha256=2lzCYMTd9dCPAxetMYNQd8RnJ83V4mmuovBt1JjTDy0,6721
+up/commands/summarize.py,sha256=GqAm_Yj9-8UaHMHjAzyi6yRT5f2D8updi7BHP3OA7bA,3619
+up/templates/__init__.py,sha256=S_GEtcw4WCtlkK8iFtNJJpAxX8OhSaE6jJyacWIfgso,3282
+up/templates/config/__init__.py,sha256=snm6ObGyQtAOEG3-X_v6iamoGiBV7uUVzBu6Sipo6nw,11937
+up/templates/docs_skill/__init__.py,sha256=0XNjIj5yuwlhqUmIZjjcfQo67J-m_op1RKAVjIn6bho,1201
+up/templates/learn/__init__.py,sha256=NUDmkyfN3HN0ZILNbIpCcfpmG4ztw6RXmN405Ps5DTE,17313
+up/templates/loop/__init__.py,sha256=PsemvvBaGdvJya8cqB6GEDuJomFIlJLD6Clu9bdVlyI,16216
+up/templates/mcp/__init__.py,sha256=hN4_w1v50tFpf8-WZe2_tVGgNjOW5Ucilfue6qQiIv8,12686
+up/templates/projects/__init__.py,sha256=kNmEP6uRnj_f-RkSUwIXwjuwO_ep5Pm10MbHda0cqCU,17717
+up_cli-0.2.0.dist-info/METADATA,sha256=sJf1vPSD5y5JVxB__J-CTpo2eNSFpya0UWvwsss_ZTo,10366
+up_cli-0.2.0.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
+up_cli-0.2.0.dist-info/entry_points.txt,sha256=3xiuYEewTAtul4F7s7mBOBD8s4kUlkdcqNrrMGfLEHA,35
+up_cli-0.2.0.dist-info/RECORD,,

up_cli-0.1.1.dist-info/METADATA

@@ -1,186 +0,0 @@
-Metadata-Version: 2.4
-Name: up-cli
-Version: 0.1.1
-Summary: AI-powered project scaffolding with docs, learn, and product-loop systems
-Project-URL: Homepage, https://github.com/yourusername/up-cli
-Project-URL: Documentation, https://github.com/yourusername/up-cli#readme
-Project-URL: Repository, https://github.com/yourusername/up-cli
-Author-email: Your Name <you@example.com>
-License-Expression: MIT
-Keywords: ai,claude,cli,cursor,productivity,scaffolding
-Classifier: Development Status :: 3 - Alpha
-Classifier: Environment :: Console
-Classifier: Intended Audience :: Developers
-Classifier: License :: OSI Approved :: MIT License
-Classifier: Programming Language :: Python :: 3
-Classifier: Programming Language :: Python :: 3.10
-Classifier: Programming Language :: Python :: 3.11
-Classifier: Programming Language :: Python :: 3.12
-Classifier: Topic :: Software Development :: Code Generators
-Requires-Python: >=3.10
-Requires-Dist: click>=8.0
-Requires-Dist: pyyaml>=6.0
-Requires-Dist: rich>=13.0
-Provides-Extra: dev
-Requires-Dist: pytest>=7.0; extra == 'dev'
-Requires-Dist: ruff>=0.1.0; extra == 'dev'
-Description-Content-Type: text/markdown
-
-# up-cli
-
-![img](https://img.iami.xyz/images/ai-futures/543426914-37655a9f-e661-4ab5-b994-e4e11f97dd95.png)
-
-An AI-powered CLI tool for scaffolding projects with built-in documentation, learning systems, and product-loop workflows designed for use with Claude Code and Cursor AI.
-
-**Learned from real practice** - Built on insights from 5+ billion tokens of development experience and commercial products. Extracts best practices from chat history, documentation patterns, and proven workflows.
-
-## Installation
-
-```bash
-pip install -e .
-```
-
-## Quick Start
-
-```bash
-# Create new project
-up new my-project
-
-# Or initialize in existing project
-cd existing-project
-up init
-```
-
-## Commands
-
-| Command | Description |
-|---------|-------------|
-| `up new <name>` | Create a new project with full scaffolding |
-| `up new <name> --template <type>` | Create project from specific template |
-| `up init` | Initialize up systems in current directory |
-| `up init --ai claude` | Initialize for Claude Code only |
-| `up init --ai cursor` | Initialize for Cursor AI only |
-| `up init --systems docs,learn` | Initialize specific systems only |
-
-## Usage Examples
-
-### Create a new project
-
-```bash
-# Create a new project with all systems
-up new my-saas-app
-
-# Create with a specific template
-up new my-api --template fastapi
-```
-
-### Initialize in existing project
-
-```bash
-cd my-existing-project
-
-# Full initialization
-up init
-
-# Claude Code focused setup
-up init --ai claude
-
-# Only add docs and learn systems
-up init --systems docs,learn
-```
-
-### Using the Learn System
-
-```bash
-# Auto-analyze your project and generate insights
-/learn auto
-
-# Research a specific topic with web sources
-/learn research "authentication patterns"
-
-# Generate a PRD from your codebase
-/learn plan
-```
-
-### Using the Product Loop
-
-```bash
-# Start autonomous development loop
-./skills/product-loop/start-autonomous.sh
-
-# Run with circuit breaker protection
-./skills/product-loop/ralph_hybrid.sh
-```
-
-## Systems
-
-### 1. Docs System
-
-```
-docs/roadmap/vision/      # Product vision
-docs/roadmap/phases/      # Phase roadmaps
-docs/changelog/           # Progress tracking
-```
-
-### 2. Learn System
-
-- `/learn auto` - Auto-analyze project
-- `/learn research [topic]` - Research topic
-- `/learn plan` - Generate PRD
-
-### 3. Product Loop (SESRC)
-
-- Circuit breaker (max 3 failures)
-- Checkpoint/rollback
-- Health checks
-- Budget limits
-
-## Design Principles & Practices
-
-### AI-First Development
-
-**Design for AI collaboration, not just human readability.**
-
-- **Context-aware scaffolding** - Project structures optimized for AI agents to navigate and understand quickly
-- **Explicit over implicit** - Clear file naming, directory structures, and documentation that AI can parse without ambiguity
-- **Prompt-friendly patterns** - Code and docs written to be easily referenced in AI conversations
-- **Tool integration** - Native support for Claude Code skills and Cursor AI rules
-
-### Documentation-Driven Development
-
-**Documentation is the source of truth, not an afterthought.**
-
-- **Docs-first workflow** - Write documentation before implementation to clarify intent
-- **Living documentation** - Docs evolve with the codebase through automated learning systems
-- **Knowledge extraction** - `/learn` commands analyze patterns and generate insights from real usage
-- **Structured knowledge** - Vision, roadmaps, and changelogs in predictable locations for AI and human consumption
-
-### Product Loop Patterns (SESRC)
-
-**Autonomous development with safety guardrails.**
-
-- **Circuit breaker protection** - Max 3 consecutive failures before stopping to prevent runaway loops
-- **Checkpoint/rollback** - Save state before risky operations, restore on failure
-- **Health checks** - Validate system state between iterations
-- **Budget limits** - Token and time constraints to prevent unbounded execution
-- **Human-in-the-loop** - Critical decisions require explicit approval
-
-### Core Practices
-
-| Practice | Description |
-|----------|-------------|
-| **Incremental delivery** | Ship small, working increments over big-bang releases |
-| **Fail fast, recover faster** | Detect issues early, rollback automatically |
-| **Observable by default** | Logging, metrics, and state visible to both AI and humans |
-| **Convention over configuration** | Sensible defaults that work out of the box |
-
-## Development
-
-```bash
-pip install -e .
-pytest
-```
-
-## License
-
-MIT

up_cli-0.1.1.dist-info/RECORD

@@ -1,14 +0,0 @@
-up/__init__.py,sha256=7suBsJ6_nxjrmi-aUlqOniZkgIWUttUoNQ_zT8vza9Q,70
-up/cli.py,sha256=NV7Zn4ep2vEVQsKZWGZqTRSXiefe9sFrN6fsnLLHub8,551
-up/commands/__init__.py,sha256=95wKJUh3jcO5L0kj6UiA5Hanrs1mTnHv_L70PfmMNJ0,23
-up/commands/init.py,sha256=uBLYSict6O2nmywFIfgBbb_Isw8LkB3y5R09XAnrvfQ,1756
-up/commands/new.py,sha256=oYLdf7s0QhI1uZiXhxWdO7S_y8IeVqIdSxsAD4nFPYc,1712
-up/templates/__init__.py,sha256=lTJqsHoYoMAvFMoYttvVJP_zb1w2ELzj04--ckDfFYI,1657
-up/templates/config/__init__.py,sha256=zOUgJWVB_OLPmkKVKyrdGhfV8tpL2m-oGy327Wn8LhE,2219
-up/templates/docs_skill/__init__.py,sha256=0XNjIj5yuwlhqUmIZjjcfQo67J-m_op1RKAVjIn6bho,1201
-up/templates/learn/__init__.py,sha256=8ArFJ0M25gGbPkmdzg3p2LPOqyetefn65NqSC59pBqw,2289
-up/templates/loop/__init__.py,sha256=jC_pAHnMUi34e_RBSu_YFd2oKAXWc3lC_e3M4DPUAPY,2290
-up_cli-0.1.1.dist-info/METADATA,sha256=2UUOHQxnStniuCQ9M-wpd9ov2iPig8MYkUlDzrnsQzA,5555
-up_cli-0.1.1.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
-up_cli-0.1.1.dist-info/entry_points.txt,sha256=3xiuYEewTAtul4F7s7mBOBD8s4kUlkdcqNrrMGfLEHA,35
-up_cli-0.1.1.dist-info/RECORD,,