Metadata-Version: 2.4
Name: story-lifecycle
Version: 0.1.0
Summary: AI-powered development workflow orchestrator — from TAPD/Jira story to production
Author: zhaozihao
License: MIT
License-File: LICENSE
Keywords: ai,claude-code,devtools,orchestrator,workflow
Classifier: Development Status :: 3 - Alpha
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.12
Requires-Python: >=3.10
Requires-Dist: click>=8.1.0
Requires-Dist: fastapi>=0.115.0
Requires-Dist: httpx>=0.27.0
Requires-Dist: langgraph-checkpoint-sqlite>=3.0
Requires-Dist: langgraph>=0.2.0
Requires-Dist: pyyaml>=6.0
Requires-Dist: rich>=13.0.0
Requires-Dist: uvicorn[standard]>=0.30.0
Provides-Extra: dev
Requires-Dist: build>=1.0; extra == 'dev'
Requires-Dist: pytest-asyncio>=0.24.0; extra == 'dev'
Requires-Dist: pytest>=8.0; extra == 'dev'
Requires-Dist: ruff>=0.11.0; extra == 'dev'
Requires-Dist: twine>=6.0; extra == 'dev'
Description-Content-Type: text/markdown

# Story Lifecycle Manager

AI-powered development workflow orchestrator — from TAPD/Jira story to production.

> **Work in progress — Phase 1 development.**

## Platform Support

| Platform | CLI + DB | AI Execution (tmux/ttyd) |
|----------|----------|--------------------------|
| **Linux** | Full | Full |
| **macOS** | Full | Full (install tmux: `brew install tmux ttyd`) |
| **Windows (native)** | Full | Not supported — use WSL2 |
| **Windows (WSL2)** | Full | Full |

### Why Windows native doesn't support AI execution

tmux and ttyd depend on Unix pseudo-terminals (PTY), `fork()`, and POSIX signals — APIs not available on native Windows. All major AI coding CLI tools (Claude Code, Aider) have the same limitation.

**Recommended setup on Windows:**

```powershell
# In WSL2 Ubuntu
sudo apt install tmux ttyd
pip install story-lifecycle
story serve
```

## Quick Start

```bash
# Install
pip install story-lifecycle       # not yet on PyPI — use `pip install -e .`

# Start orchestrator in one terminal
story serve

# Create a story in another terminal
story new STORY-123 --title "Add login feature"

# Watch progress
story board

# Interact with the AI (Linux/macOS/WSL only)
story enter STORY-123
```

## Profiles

- `minimal` (default): design → implement → test (3 stages)
- `standard`: full 14-stage flow (coming in Phase 2)
- Custom: drop a YAML in `~/.story-lifecycle/profiles/`

## CLI Commands

```
story new <KEY> --title "..."     Create a new story
story board                       Show all active stories
story enter <KEY>                 Open terminal to interact with AI
story status <KEY>                Show story details
story skip <KEY> --stage <NAME>   Skip a stage
story fail <KEY>                  Mark as blocked
story serve                       Start the orchestrator server
```

## License

MIT
