raise-cli 3.0.0a5__tar.gz → 3.1.0a3__tar.gz

{raise_cli-3.0.0a5 → raise_cli-3.1.0a3}/.gitignore

@@ -1,3 +1,6 @@
+# Node.js
+node_modules/
+
 # IDE / editor directories
 .specstory/
 .cursor/
@@ -12,6 +15,11 @@
 # 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
@@ -46,7 +54,7 @@ packages/*/.raise/rai/sessions/
 # Dossier output (generated, not committed)
 dev/output/
 
-# RaiSE graph index — tracked (essential for skill PRIME/JIT queries in worktrees)
+# 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)
@@ -55,6 +63,20 @@ dev/output/
 # 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/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/
@@ -81,8 +103,8 @@ dist/
 downloads/
 eggs/
 .eggs/
-lib/
-lib64/
+/lib/
+/lib64/
 parts/
 sdist/
 var/
@@ -131,6 +153,7 @@ dmypy.json
 .env
 .env.*
 !.env.example
+!.env.production
 *.pem
 *.key
 .pypirc
@@ -144,6 +167,9 @@ credentials.json
 _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
@@ -153,7 +179,6 @@ dev/transcripts/
 
 # Prevent symlink artifacts from being tracked at root
 /es/
-work/research/
 
 # Ephemeral debug artifacts (Playwright MCP snapshots, root-level screenshots)
 .playwright-mcp/
@@ -174,3 +199,16 @@ work/research/
 .worktrees/
 .venv
 .venv
+work/debug/
+
+# Playwright E2E auth state (contains session cookies)
+packages/raise-admin/e2e/.auth/
+# Playwright test results
+packages/raise-admin/test-results/
+packages/raise-admin/playwright-report/
+
+# Forge raise-jira app — generated files
+forge/raise-jira/static/raise-app/package-lock.json
+forge/raise-jira/static/raise-app/pnpm-workspace.yaml
+packages/raise-cli/.raise/sync/backlog-dead-letter.jsonl
+package-lock.json

raise_cli-3.1.0a3/PKG-INFO

@@ -0,0 +1,171 @@
+Metadata-Version: 2.4
+Name: raise-cli
+Version: 3.1.0a3
+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: kuzu>=0.11.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: eval
+Requires-Dist: ranx<0.4,>=0.3.20; extra == 'eval'
+Requires-Dist: scipy>=1.10; extra == 'eval'
+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.1.0a3/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-3.0.0a5 → raise_cli-3.1.0a3}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "raise-cli"
-version = "3.0.0a5"
+version = "3.1.0a3"
 description = "RaiSE CLI - Reliable AI Software Engineering governance framework"
 authors = [
     {name = "Emilio Osorio", email = "emilio@humansys.ai"}
@@ -21,7 +21,7 @@ classifiers = [
 ]
 
 dependencies = [
-    "raise-core>=3.0.0a2",
+    "raise-core>=3.0.0",
     "typer>=0.12.0",
     "rich>=13.7.0",
     "pydantic>=2.6.0",
@@ -40,6 +40,7 @@ dependencies = [
     "mcp>=1.26,<2",
     "markdown>=3.6",
     "atlassian-python-api>=3.41.0",
+    "kuzu>=0.11.0",
 ]
 
 [project.optional-dependencies]
@@ -51,9 +52,19 @@ observability = [
 csharp = [
     "tree-sitter-c-sharp>=0.23.1",
 ]
+java = [
+    "tree-sitter-java>=0.23.5",
+]
+go = [
+    "tree-sitter-go>=0.25.0",
+]
 hud = [
     "textual>=0.86,<1.0",
 ]
+eval = [
+    "ranx>=0.3.20,<0.4",
+    "scipy>=1.10",
+]
 # Backwards-compat aliases — atlassian-python-api is now installed by default (RAISE-1912).
 atlassian = []
 confluence = []
@@ -83,7 +94,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"
-work-events = "raise_cli.work_events.emitter:ServerEmitHook"
+graph-auto-update = "raise_cli.hooks.builtin.graph_update:GraphAutoUpdateHook"
 
 [project.entry-points."rai.gates"]
 tests = "raise_cli.gates.builtin.tests:TestGate"
@@ -101,6 +112,7 @@ 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"
+eval = "raise_cli.eval.gate:EvalGate"
 
 [project.entry-points."rai.doctor.checks"]
 environment = "raise_cli.doctor.checks.environment:EnvironmentCheck"
@@ -108,6 +120,7 @@ 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"
+skills = "raise_cli.doctor.checks.skills:SkillCommandReferenceCheck"
 
 [project.entry-points."rai.adapters.pm"]
 filesystem = "raise_cli.adapters.filesystem:FilesystemPMAdapter"

{raise_cli-3.0.0a5 → raise_cli-3.1.0a3}/src/raise_cli/_agent_session.py

@@ -3,6 +3,7 @@
 Resolution order:
 1. RAISE_AGENT_SESSION_ID (explicit, set by any runtime adapter)
 2. RAISE_CC_SESSION_ID (Claude Code backward compat)
+2.5. CLAUDE_CODE_SESSION_ID (CC-native; always injected into Bash tool env)
 3. CC port discovery (CLAUDE_CODE_SSE_PORT → cc.port, unambiguous match only)
 4. Terminal bindings (PPID ancestry → _terminal_bindings.json)
 """
@@ -14,6 +15,7 @@ import os
 from pathlib import Path
 
 _SESSIONS_DIR = Path(".raise") / "rai" / "sessions"
+_CLAUDE_WORKTREES_DIR = Path(".claude") / "worktrees"
 
 
 def discover_agent_session_id() -> str | None:
@@ -30,6 +32,10 @@ def discover_agent_session_id() -> str | None:
     if cc_sid:
         return cc_sid
 
+    native_sid = os.environ.get("CLAUDE_CODE_SESSION_ID", "").strip()
+    if native_sid:
+        return native_sid
+
     port_sid = _discover_via_cc_port()
     if port_sid:
         return port_sid
@@ -65,6 +71,9 @@ def discover_agent_runtime() -> str:
     if os.environ.get("RAISE_CC_SESSION_ID", "").strip():
         return "claude_code"
 
+    if os.environ.get("CLAUDE_CODE_SESSION_ID", "").strip():
+        return "claude_code"
+
     if _discover_via_cc_port():
         return "claude_code"
 
@@ -86,19 +95,34 @@ def _discover_via_cc_port() -> str | None:
     port = os.environ.get("CLAUDE_CODE_SSE_PORT", "").strip()
     if not port:
         return None
-    sessions_dir = Path.cwd() / _SESSIONS_DIR
-    if not sessions_dir.exists():
-        return None
     matches: list[str] = []
-    for sess_dir in sessions_dir.iterdir():
-        if not sess_dir.is_dir():
-            continue
-        port_file = sess_dir / "cc.port"
-        if port_file.exists() and port_file.read_text().strip() == port:
-            matches.append(sess_dir.name)
+    for sessions_dir in _candidate_session_dirs(Path.cwd()):
+        for sess_dir in sessions_dir.iterdir():
+            if not sess_dir.is_dir():
+                continue
+            port_file = sess_dir / "cc.port"
+            if port_file.exists() and port_file.read_text().strip() == port:
+                matches.append(sess_dir.name)
     return matches[0] if len(matches) == 1 else None
 
 
+def _candidate_session_dirs(root: Path) -> list[Path]:
+    """Return session directories relevant from an MCP server CWD."""
+    candidates: list[Path] = []
+    local_sessions = root / _SESSIONS_DIR
+    if local_sessions.exists():
+        candidates.append(local_sessions)
+
+    worktrees_root = root / _CLAUDE_WORKTREES_DIR
+    if worktrees_root.exists():
+        for worktree in sorted(worktrees_root.iterdir()):
+            sessions_dir = worktree / _SESSIONS_DIR
+            if sessions_dir.exists():
+                candidates.append(sessions_dir)
+
+    return candidates
+
+
 def _get_parent_pid(pid: int) -> int | None:
     """Return the parent PID of *pid* via /proc (Linux only)."""
     try: