raise-cli 2.4.0a2__tar.gz → 3.0.0__tar.gz

raise_cli-3.0.0/.gitignore

@@ -0,0 +1,196 @@
+# IDE / editor directories
+.specstory/
+.cursor/
+.idea/
+.vscode/
+
+# Claude Code local settings (user-specific)
+.claude/settings.local.json
+.claude/worktrees/
+.claude/projects/
+
+# Hermes Agent worktrees (auto-created by hermes -w)
+.worktrees/
+
+# Codex/Agents experimental tooling (local only)
+.agents/
+.codex/
+.codex-plugin/
+
+# Claude Code legacy files (superseded, prevent re-addition)
+.claude/RAI.md
+.claude/RAI-naming.md
+.claude/rai.archive/
+
+# Daemon config (contains secrets — template committed as .example)
+daemon-team.yaml
+daemon.yaml
+.env.fly
+
+# RaiSE generated/cache files
+.raise/cache/
+.raise/confluence-pages.yaml
+.raise/backlog/
+# .raise/artifacts/ — tracked (story-design YAMLs are versioned artifacts)
+
+# Drift detection pipeline outputs (computed, machine-specific paths, high churn)
+.raise/drift/
+packages/*/.raise/drift/
+packages/*/.raise/pending_sync.json
+packages/*/.raise/rai/personal/
+packages/*/.raise/rai/sessions/
+
+# Pipeline state (environment-specific, PAT-E-594)
+.rai-state/
+
+# RaiSE adapter configs (declarative, PII-free — identity in env vars)
+# .raise/jira.yaml and .raise/confluence.yaml are tracked (shared config)
+.raise/adapters/*.yaml
+!.raise/adapters/*.yaml.example
+
+# Dossier output (generated, not committed)
+dev/output/
+
+# RaiSE graph index — SQLite is canonical after S22.3; index.json excluded via .raise/.gitignore
+# Rebuild with: rai graph build
+
+# RaiSE personal directory (per-developer, not shared)
+.raise/rai/personal/
+
+# RaiSE sync state (per-instance JIRA mappings, not shared)
+.raise/rai/sync/
+
+# RaiSE global SQLite DB (per-machine, not shared)
+.raise/rai/raise.db
+
+# RaiSE mission migration artifacts
+.raise/rai/missions/*.migrated
+
+# RaiSE sync ephemeral artifacts (backups, dead-letter, migrations, pending ops)
+.raise/sync/backlog-ledger.yaml
+.raise/sync/backlog-ledger.yaml.backup.*
+.raise/sync/backlog-dead-letter.jsonl
+.raise/sync/backlog-ledger.yaml.migrated
+packages/*/.raise/sync/*-pending-ops.jsonl
+
+# Per-session env context written by Rai skills, read by CC hooks + MCP tool
+# Namespaced by CC session_id (RAISE-1982) — isolates concurrent CC sessions.
+.raise/rai/sessions/
+
+# Temporary files
+req.txt
+*.tmp
+*.bak-*
+*.log
+.DS_Store
+Thumbs.db
+
+# Script generated folders (if testing locally)
+.specify-raise/commands/
+
+# Python build artifacts
+__pycache__/
+*.py[cod]
+*$py.class
+*.so
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+
+# Virtual environments
+.venv/
+venv/
+ENV/
+env/
+
+# Testing
+htmlcov/
+.tox/
+.nox/
+.coverage
+.coverage.*
+.cache
+nosetests.xml
+coverage.xml
+*.cover
+.hypothesis/
+.pytest_cache/
+
+# Type checking
+.mypy_cache/
+.dmypy.json
+dmypy.json
+.pyright/
+.rai/memory/graph.json
+.envrc
+
+# Legacy telemetry (should be in personal/, will migrate)
+.raise/rai/telemetry/
+
+# Push tracking markers (per-environment, not shared)
+.raise/rai/learnings/**/.pushed
+
+# MCP server config (contains API tokens)
+.mcp.json
+
+# Secrets & credentials
+.env
+.env.*
+!.env.example
+*.pem
+*.key
+.pypirc
+credentials.json
+*.sqlite
+.netrc
+.raise/mcp/
+!.raise/mcp/catalog.yaml
+
+# MkDocs build output
+_site/
+.docs-build/
+
+# Security scan outputs (contain findings — not committed)
+work/reports/gl-secret-detection-report*
+
+# Issue analysis artifacts (PDFs, images — binary, no git value)
+dev/issues/**/*.pdf
+dev/issues/**/*.png
+dev/issues/**/*.jpg
+dev/issues/**/*.txt
+dev/transcripts/
+
+# Prevent symlink artifacts from being tracked at root
+/es/
+
+# Ephemeral debug artifacts (Playwright MCP snapshots, root-level screenshots)
+.playwright-mcp/
+.claude/scheduled_tasks.lock
+/issue-*.png
+/panel-*.png
+/s7-*.png
+/app-actions-menu.yml
+/issue-layout.yml
+/layout-editor.yml
+/menu-open.yml
+/raise-*.yml
+
+# Per-developer docker compose override (e.g., expose postgres:5432 for e2e).
+# See dev/sops/raise-server-local.md § Running e2e tests locally.
+/docker-compose.override.yaml
+/docker-compose.override.yml
+.worktrees/
+.venv
+.venv

raise_cli-3.0.0/PKG-INFO

@@ -0,0 +1,167 @@
+Metadata-Version: 2.4
+Name: raise-cli
+Version: 3.0.0
+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: atlassian-python-api>=3.41.0
+Requires-Dist: httpx<1.0,>=0.27.0
+Requires-Dist: logfire-api>=4.0
+Requires-Dist: markdown>=3.6
+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.0
+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
+Provides-Extra: confluence
+Provides-Extra: csharp
+Requires-Dist: tree-sitter-c-sharp>=0.23.1; extra == 'csharp'
+Provides-Extra: go
+Requires-Dist: tree-sitter-go>=0.25.0; extra == 'go'
+Provides-Extra: hud
+Requires-Dist: textual<1.0,>=0.86; extra == 'hud'
+Provides-Extra: java
+Requires-Dist: tree-sitter-java>=0.23.5; extra == 'java'
+Provides-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** — governance, memory, and structured workflows for AI-assisted development.
+
+[![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)
+
+---
+
+AI coding assistants are powerful. They're also unreliable. They forget your conventions between sessions. They don't know your architecture decisions. They optimize for speed over correctness. Left ungoverned, they produce code that *looks* right but subtly isn't.
+
+RaiSE fixes this through three collaborating parts:
+
+```
+    You (Strategy, Judgment, Ownership)
+         │
+         │ collaborates with
+         ▼
+      Rai (AI Partner — Execution + Memory)
+         │
+         │ governed by
+         ▼
+      RaiSE (Methodology + Toolkit)
+```
+
+**You** decide what to build and why. **Rai** executes with accumulated memory and calibrated judgment. **RaiSE** provides the discipline — skills, governance, and quality gates — 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
+
+### Quick install (recommended)
+
+Per-project isolation — each project gets its own version:
+
+```bash
+cd your-project
+curl -LsSf https://docs.raiseframework.ai/install.sh | bash
+```
+
+Windows (PowerShell):
+
+```powershell
+cd your-project
+powershell -ExecutionPolicy ByPass -c "irm https://docs.raiseframework.ai/install.ps1 | iex"
+```
+
+### Manual install
+
+```bash
+pip install raise-cli        # latest stable
+pip install raise-cli --pre  # latest pre-release
+```
+
+Requires **Python 3.12 or 3.13**. See the [Installation Guide](https://docs.raiseframework.ai/3.0/installation/) for platform-specific notes and troubleshooting.
+
+## Getting started
+
+```bash
+cd your-project
+rai init           # create .raise/ governance structure
+```
+
+Open your AI assistant ([Claude Code](https://claude.ai/claude-code), Cursor, or Windsurf) in the project directory and run:
+
+```
+/rai-welcome          → First-time setup: developer profile + knowledge graph
+/rai-session-start    → Load context, memory, and propose focused work
+```
+
+## The story lifecycle
+
+Every piece of work follows six steps — the core rhythm of RaiSE:
+
+```
+/rai-story-start     → Scope: what are we building?
+/rai-story-design    → Spec: how will it work?
+/rai-story-plan      → Tasks: decompose into steps
+/rai-story-implement → Build: test, code, verify, commit
+/rai-story-review    → Reflect: what did we learn?
+/rai-story-close     → Ship: merge and clean up
+```
+
+Each step produces an artifact that feeds the next. Reviews capture patterns into memory. Memory feeds future sessions. This is how learning compounds — not through magic, but through disciplined repetition.
+
+## What's inside
+
+**Governance** — Layered rules (principles → requirements → guardrails → code) loaded at session start and enforced throughout. Everything traceable, everything in Markdown.
+
+**Memory** — Patterns, calibration data, and session history that persist across sessions. Session 1 is discovery. Session 50 is expertise.
+
+**Knowledge Graph** — Connects governance, memory, skills, and code into a queryable structure. The CLI traverses this graph to deliver the right context for your current work.
+
+**Skills** — 44 structured workflows covering epics, stories, bugfixes, discovery, documentation, and releases. Each adapts to your experience level (Shu-Ha-Ri).
+
+**Quality Gates** — Automated verification at every step. Tests, types, lint, coverage, architectural drift detection, and release readiness checks.
+
+**Integrations** — Jira, Confluence, and filesystem adapters. MCP server for AI tool orchestration. Multi-language code discovery (Python, TypeScript, JavaScript, C#, PHP, Dart, Svelte).
+
+## Documentation
+
+- **[Getting Started](https://docs.raiseframework.ai/3.0/getting-started/)** — Install, initialize, and run your first session
+- **[Your First Story](https://docs.raiseframework.ai/3.0/guides/first-story/)** — Walk through the full story lifecycle
+- **[Core Concepts](https://docs.raiseframework.ai/3.0/concepts/)** — Memory, Skills, Governance, Knowledge Graph
+- **[CLI Reference](https://docs.raiseframework.ai/3.0/cli/)** — Every command, flag, and option
+- **[Guides](https://docs.raiseframework.ai/3.0/guides/)** — Integrations, pipelines, extending RaiSE
+
+## License
+
+Apache 2.0 — see [LICENSE](https://github.com/humansys/raise/blob/main/LICENSE).

raise_cli-3.0.0/README.md

@@ -0,0 +1,111 @@
+# RaiSE CLI
+
+**Reliable AI Software Engineering** — governance, memory, and structured workflows for AI-assisted development.
+
+[![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)
+
+---
+
+AI coding assistants are powerful. They're also unreliable. They forget your conventions between sessions. They don't know your architecture decisions. They optimize for speed over correctness. Left ungoverned, they produce code that *looks* right but subtly isn't.
+
+RaiSE fixes this through three collaborating parts:
+
+```
+    You (Strategy, Judgment, Ownership)
+         │
+         │ collaborates with
+         ▼
+      Rai (AI Partner — Execution + Memory)
+         │
+         │ governed by
+         ▼
+      RaiSE (Methodology + Toolkit)
+```
+
+**You** decide what to build and why. **Rai** executes with accumulated memory and calibrated judgment. **RaiSE** provides the discipline — skills, governance, and quality gates — 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
+
+### Quick install (recommended)
+
+Per-project isolation — each project gets its own version:
+
+```bash
+cd your-project
+curl -LsSf https://docs.raiseframework.ai/install.sh | bash
+```
+
+Windows (PowerShell):
+
+```powershell
+cd your-project
+powershell -ExecutionPolicy ByPass -c "irm https://docs.raiseframework.ai/install.ps1 | iex"
+```
+
+### Manual install
+
+```bash
+pip install raise-cli        # latest stable
+pip install raise-cli --pre  # latest pre-release
+```
+
+Requires **Python 3.12 or 3.13**. See the [Installation Guide](https://docs.raiseframework.ai/3.0/installation/) for platform-specific notes and troubleshooting.
+
+## Getting started
+
+```bash
+cd your-project
+rai init           # create .raise/ governance structure
+```
+
+Open your AI assistant ([Claude Code](https://claude.ai/claude-code), Cursor, or Windsurf) in the project directory and run:
+
+```
+/rai-welcome          → First-time setup: developer profile + knowledge graph
+/rai-session-start    → Load context, memory, and propose focused work
+```
+
+## The story lifecycle
+
+Every piece of work follows six steps — the core rhythm of RaiSE:
+
+```
+/rai-story-start     → Scope: what are we building?
+/rai-story-design    → Spec: how will it work?
+/rai-story-plan      → Tasks: decompose into steps
+/rai-story-implement → Build: test, code, verify, commit
+/rai-story-review    → Reflect: what did we learn?
+/rai-story-close     → Ship: merge and clean up
+```
+
+Each step produces an artifact that feeds the next. Reviews capture patterns into memory. Memory feeds future sessions. This is how learning compounds — not through magic, but through disciplined repetition.
+
+## What's inside
+
+**Governance** — Layered rules (principles → requirements → guardrails → code) loaded at session start and enforced throughout. Everything traceable, everything in Markdown.
+
+**Memory** — Patterns, calibration data, and session history that persist across sessions. Session 1 is discovery. Session 50 is expertise.
+
+**Knowledge Graph** — Connects governance, memory, skills, and code into a queryable structure. The CLI traverses this graph to deliver the right context for your current work.
+
+**Skills** — 44 structured workflows covering epics, stories, bugfixes, discovery, documentation, and releases. Each adapts to your experience level (Shu-Ha-Ri).
+
+**Quality Gates** — Automated verification at every step. Tests, types, lint, coverage, architectural drift detection, and release readiness checks.
+
+**Integrations** — Jira, Confluence, and filesystem adapters. MCP server for AI tool orchestration. Multi-language code discovery (Python, TypeScript, JavaScript, C#, PHP, Dart, Svelte).
+
+## Documentation
+
+- **[Getting Started](https://docs.raiseframework.ai/3.0/getting-started/)** — Install, initialize, and run your first session
+- **[Your First Story](https://docs.raiseframework.ai/3.0/guides/first-story/)** — Walk through the full story lifecycle
+- **[Core Concepts](https://docs.raiseframework.ai/3.0/concepts/)** — Memory, Skills, Governance, Knowledge Graph
+- **[CLI Reference](https://docs.raiseframework.ai/3.0/cli/)** — Every command, flag, and option
+- **[Guides](https://docs.raiseframework.ai/3.0/guides/)** — Integrations, pipelines, extending RaiSE
+
+## License
+
+Apache 2.0 — see [LICENSE](https://github.com/humansys/raise/blob/main/LICENSE).

{raise_cli-2.4.0a2 → raise_cli-3.0.0}/pyproject.toml

@@ -1,12 +1,11 @@
 [project]
 name = "raise-cli"
-version = "2.4.0a2"
+version = "3.0.0"
 description = "RaiSE CLI - Reliable AI Software Engineering governance framework"
 authors = [
     {name = "Emilio Osorio", email = "emilio@humansys.ai"}
 ]
-# README.md is at repo root — referenced via sdist include, not readme field
-# (hatch resolves readme relative to build temp dir, not source dir)
+readme = "README.md"
 license = {text = "Apache-2.0"}
 requires-python = ">=3.12"
 keywords = ["ai", "governance", "cli", "software-engineering", "methodology"]
@@ -22,7 +21,7 @@ classifiers = [
 ]
 
 dependencies = [
-    "raise-core",
+    "raise-core>=3.0.0",
     "typer>=0.12.0",
     "rich>=13.7.0",
     "pydantic>=2.6.0",
@@ -37,27 +36,34 @@ dependencies = [
     "tree-sitter-svelte>=1.0.2",
     "tree-sitter-language-pack>=0.13.0",
     "logfire-api>=4.0",
+    "httpx>=0.27.0,<1.0",
+    "mcp>=1.26,<2",
+    "markdown>=3.6",
+    "atlassian-python-api>=3.41.0",
 ]
 
 [project.optional-dependencies]
-mcp = [
-    "mcp>=1.26,<2",
-]
 observability = [
     "logfire>=4.0",
+    "opentelemetry-api>=1.20",
+    "opentelemetry-sdk>=1.20",
 ]
 csharp = [
     "tree-sitter-c-sharp>=0.23.1",
 ]
-atlassian = [
-    "atlassian-python-api>=3.41.0",
+java = [
+    "tree-sitter-java>=0.23.5",
 ]
-confluence = [
-    "atlassian-python-api>=3.41.0",
+go = [
+    "tree-sitter-go>=0.25.0",
 ]
-jira = [
-    "atlassian-python-api>=3.41.0",
+hud = [
+    "textual>=0.86,<1.0",
 ]
+# Backwards-compat aliases — atlassian-python-api is now installed by default (RAISE-1912).
+atlassian = []
+confluence = []
+jira = []
 
 [project.urls]
 Homepage = "https://raiseframework.ai"
@@ -67,6 +73,7 @@ Changelog = "https://github.com/humansys/raise/blob/main/CHANGELOG.md"
 
 [project.scripts]
 rai = "raise_cli.cli.main:app"
+rai-mcp-pipeline = "raise_cli.pipeline.mcp_server:main"
 
 [project.entry-points."rai.governance.parsers"]
 prd = "raise_cli.governance.parsers.prd:PrdParser"
@@ -82,7 +89,7 @@ glossary = "raise_cli.governance.parsers.glossary:GlossaryParser"
 [project.entry-points."rai.hooks"]
 telemetry = "raise_cli.hooks.builtin.telemetry:TelemetryHook"
 gate-bridge = "raise_cli.hooks.builtin.gate_bridge:GateBridgeHook"
-memory-sync = "raise_cli.hooks.builtin.memory:MemoryMdSyncHook"
+work-events = "raise_cli.work_events.emitter:ServerEmitHook"
 
 [project.entry-points."rai.gates"]
 tests = "raise_cli.gates.builtin.tests:TestGate"
@@ -90,11 +97,23 @@ types = "raise_cli.gates.builtin.types:TypeGate"
 lint = "raise_cli.gates.builtin.lint:LintGate"
 coverage = "raise_cli.gates.builtin.coverage:CoverageGate"
 format = "raise_cli.gates.builtin.format:FormatGate"
+drift-post-refactor-orphan = "raise_cli.gates.drift.post_refactor_orphan:PostRefactorOrphanGate"
+drift-dead-public-api = "raise_cli.gates.drift.dead_public_api:DeadPublicApiGate"
+drift-linter-suppression = "raise_cli.gates.drift.linter_suppression:LinterSuppressionGate"
+drift-story-accretion = "raise_cli.gates.drift.story_accretion:StoryAccretionGate"
+drift-import-fan-in = "raise_cli.gates.drift.import_fan_in:ImportFanInGate"
+drift-parallel-siblings = "raise_cli.gates.drift.parallel_siblings:ParallelSiblingGate"
+drift-auth-fan-out = "raise_cli.gates.drift.auth_fan_out:AuthorizationFanOutGate"
+ar-story = "raise_cli.gates.ar.story_gate:ArchitectureReviewGate"
+ar-bugfix = "raise_cli.gates.ar.bugfix_gate:BugfixArchitectureReviewGate"
+epic-close-drift = "raise_cli.gates.drift.epic_close:EpicCloseGate"
 
 [project.entry-points."rai.doctor.checks"]
 environment = "raise_cli.doctor.checks.environment:EnvironmentCheck"
 project = "raise_cli.doctor.checks.project:ProjectCheck"
 developer = "raise_cli.doctor.checks.developer:DeveloperCheck"
+adapters = "raise_cli.doctor.checks.adapters:AdapterDoctorCheck"
+runtimes = "raise_cli.doctor.checks.runtimes:RuntimesCheck"
 
 [project.entry-points."rai.adapters.pm"]
 filesystem = "raise_cli.adapters.filesystem:FilesystemPMAdapter"
@@ -107,6 +126,15 @@ confluence = "raise_cli.adapters.confluence_adapter:PythonApiConfluenceAdapter"
 [project.entry-points."rai.graph.backends"]
 local = "raise_core.graph.backends.filesystem:FilesystemGraphBackend"
 
+[project.entry-points."rai.session.state_deriver"]
+git = "raise_cli.session.derive:GitStateDeriver"
+
+[project.entry-points."rai.session.registry"]
+local = "raise_cli.session.registry:LocalSessionRegistry"
+
+[project.entry-points."rai.session.monitor"]
+local = "raise_cli.session.monitor:LocalWorkstreamMonitor"
+
 [tool.uv.sources]
 raise-core = { workspace = true }