Metadata-Version: 2.4
Name: raise-cli
Version: 3.0.0a2
Summary: RaiSE CLI - Reliable AI Software Engineering governance framework
Project-URL: Homepage, https://raiseframework.ai
Project-URL: Documentation, https://docs.raiseframework.ai
Project-URL: Repository, https://github.com/humansys/raise
Project-URL: Changelog, https://github.com/humansys/raise/blob/main/CHANGELOG.md
Author-email: Emilio Osorio <emilio@humansys.ai>
License: Apache-2.0
Keywords: ai,cli,governance,methodology,software-engineering
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Software Development :: Libraries :: Application Frameworks
Classifier: Topic :: Software Development :: Quality Assurance
Requires-Python: >=3.12
Requires-Dist: httpx>=0.27.0
Requires-Dist: logfire-api>=4.0
Requires-Dist: mcp<2,>=1.26
Requires-Dist: networkx>=3.6.1
Requires-Dist: pydantic-settings>=2.2.0
Requires-Dist: pydantic>=2.6.0
Requires-Dist: python-dotenv>=1.0.0
Requires-Dist: pyyaml>=6.0.1
Requires-Dist: raise-core>=3.0.0a2
Requires-Dist: rich>=13.7.0
Requires-Dist: tree-sitter-javascript>=0.25.0
Requires-Dist: tree-sitter-language-pack>=0.13.0
Requires-Dist: tree-sitter-php>=0.24.1
Requires-Dist: tree-sitter-svelte>=1.0.2
Requires-Dist: tree-sitter-typescript>=0.23.2
Requires-Dist: tree-sitter>=0.25.2
Requires-Dist: typer>=0.12.0
Provides-Extra: atlassian
Requires-Dist: atlassian-python-api>=3.41.0; extra == 'atlassian'
Provides-Extra: confluence
Requires-Dist: atlassian-python-api>=3.41.0; extra == 'confluence'
Requires-Dist: markdown>=3.6; extra == 'confluence'
Provides-Extra: csharp
Requires-Dist: tree-sitter-c-sharp>=0.23.1; extra == 'csharp'
Provides-Extra: jira
Requires-Dist: atlassian-python-api>=3.41.0; extra == 'jira'
Provides-Extra: observability
Requires-Dist: logfire>=4.0; extra == 'observability'
Requires-Dist: opentelemetry-api>=1.20; extra == 'observability'
Requires-Dist: opentelemetry-sdk>=1.20; extra == 'observability'
Description-Content-Type: text/markdown

# RaiSE CLI

**Reliable AI Software Engineering** — a lean methodology and deterministic CLI toolkit that turns AI coding assistants into disciplined collaborators.

[![PyPI](https://img.shields.io/pypi/v/raise-cli)](https://pypi.org/project/raise-cli/)
[![Python](https://img.shields.io/pypi/pyversions/raise-cli)](https://pypi.org/project/raise-cli/)
[![License](https://img.shields.io/pypi/l/raise-cli)](https://github.com/humansys/raise/blob/main/LICENSE)

## What is RaiSE?

RaiSE provides **governance, memory, and structured workflows** for AI-assisted software engineering. You decide *what* to build. Rai (your AI partner) executes with accumulated memory and calibrated judgment. RaiSE provides the discipline that makes the collaboration reliable.

The result: AI that learns from your project, follows your rules, and compounds knowledge across sessions instead of starting fresh every time.

## Install

```bash
pip install raise-cli
```

Optional integrations:

```bash
# Jira + Confluence adapters
pip install "raise-cli[jira,confluence]"

# All extras
pip install "raise-cli[jira,confluence,csharp,observability]"
```

Requires Python 3.12 or 3.13.

## Quick start

```bash
# Initialize a project
rai init

# Start a session (loads context, memory, proposes work)
rai session start --project . --context

# Build the knowledge graph
rai graph build
```

Then work through skills in your AI assistant (Claude Code, Cursor, Windsurf):

```
/rai-session-start       → Load context, propose focused work
/rai-story-start         → Scope a piece of work
/rai-story-plan          → Decompose into tasks
/rai-story-implement     → TDD: test, code, verify, commit
/rai-story-review        → Extract learnings
/rai-story-close         → Merge and clean up
/rai-session-close       → Capture session outcomes
```

## Key features

### Structured workflows
44 skills covering the full SDLC — epic, story, bugfix, discovery, session management, documentation, and release.

### Knowledge graph
Project context, patterns, and cross-session memory — queryable and persistent.

```bash
rai graph query "testing patterns" --types pattern --limit 5
```

### Backlog management
Built-in adapters for Jira and filesystem-backed backlogs.

```bash
rai backlog search "project = MYPROJECT AND status = 'In Progress'"
rai backlog create "Fix pagination bug" -p MYPROJECT -t Bug
rai backlog transition MYPROJECT-123 done
```

### Documentation publishing
Publish to Confluence, local filesystem, or both (dual-write).

```bash
rai docs publish adr --title "ADR-045: Auth Architecture"
```

### Quality gates
Automated checks before commits and releases.

```bash
rai gate check --all        # Run all gates
rai release check           # 10-point release checklist
```

### Session continuity
Memory that compounds across sessions — patterns, calibration, coaching corrections.

```bash
rai session start --context  # Loads everything from prior sessions
rai pattern add "Always validate frontmatter before writing"
```

### Multi-language discovery
Scan codebases and build knowledge graphs from: Python, TypeScript, JavaScript, C#, PHP, Dart, Svelte.

```bash
rai discover scan src/ --language python --output summary
```

## CLI commands

72 subcommands across 17 groups:

| Group | Commands |
|-------|----------|
| `init` | Initialize project governance |
| `session` | start, close, context, journal, doctor |
| `graph` | build, query, context |
| `pattern` | add, query |
| `backlog` | create, get, search, transition, update, link, comment |
| `docs` | publish, get, search |
| `skill` | list, validate, check-name, scaffold |
| `discover` | scan |
| `adapter` | list, check, validate, status |
| `mcp` | list, health, tools, call, install, scaffold |
| `gate` | list, check |
| `doctor` | diagnostics with --fix auto-remediation |
| `release` | check, publish |

## Documentation

- **[Getting Started](https://docs.raiseframework.ai/)** — Install and run your first session
- **[Guides](https://docs.raiseframework.ai/guides/first-story/)** — Your First Story, Configuring Integrations, Bugfix Lifecycle
- **[CLI Reference](https://docs.raiseframework.ai/cli/)** — Every command, flag, and option
- **[Concepts](https://docs.raiseframework.ai/concepts/)** — Memory, Skills, Governance, Knowledge Graph

## License

Apache 2.0 — see [LICENSE](https://github.com/humansys/raise/blob/main/LICENSE).
