raise-cli 2.4.1__tar.gz → 3.0.0__tar.gz

{raise_cli-2.4.1 → raise_cli-3.0.0}/.gitignore

@@ -9,15 +9,39 @@
 .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)
@@ -27,8 +51,8 @@
 # Dossier output (generated, not committed)
 dev/output/
 
-# RaiSE derived artifacts (rebuild with `rai memory build`)
-.raise/rai/memory/index.json
+# 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/
@@ -36,6 +60,23 @@ 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 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
@@ -119,6 +160,10 @@ credentials.json
 
 # 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
@@ -129,4 +174,23 @@ dev/transcripts/
 
 # Prevent symlink artifacts from being tracked at root
 /es/
-work/research/
+
+# 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.1 → raise_cli-3.0.0}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "raise-cli"
-version = "2.4.1"
+version = "3.0.0"
 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",
+    "raise-core>=3.0.0",
     "typer>=0.12.0",
     "rich>=13.7.0",
     "pydantic>=2.6.0",
@@ -36,28 +36,34 @@ dependencies = [
     "tree-sitter-svelte>=1.0.2",
     "tree-sitter-language-pack>=0.13.0",
     "logfire-api>=4.0",
-    "httpx>=0.27.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,6 +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"
+work-events = "raise_cli.work_events.emitter:ServerEmitHook"
 
 [project.entry-points."rai.gates"]
 tests = "raise_cli.gates.builtin.tests:TestGate"
@@ -89,12 +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"

raise_cli-3.0.0/src/raise_cli/_agent_session.py

@@ -0,0 +1,139 @@
+"""Discover agent session_id via runtime-agnostic priority chain.
+
+Resolution order:
+1. RAISE_AGENT_SESSION_ID (explicit, set by any runtime adapter)
+2. RAISE_CC_SESSION_ID (Claude Code backward compat)
+3. CC port discovery (CLAUDE_CODE_SSE_PORT → cc.port, unambiguous match only)
+4. Terminal bindings (PPID ancestry → _terminal_bindings.json)
+"""
+
+from __future__ import annotations
+
+import json
+import os
+from pathlib import Path
+
+_SESSIONS_DIR = Path(".raise") / "rai" / "sessions"
+
+
+def discover_agent_session_id() -> str | None:
+    """Resolve session ID from any supported runtime.
+
+    Priority chain ensures backward compatibility while enabling
+    new runtimes (Hermes, Codex) to participate in session correlation.
+    """
+    agent_sid = os.environ.get("RAISE_AGENT_SESSION_ID", "").strip()
+    if agent_sid:
+        return agent_sid
+
+    cc_sid = os.environ.get("RAISE_CC_SESSION_ID", "").strip()
+    if cc_sid:
+        return cc_sid
+
+    port_sid = _discover_via_cc_port()
+    if port_sid:
+        return port_sid
+
+    return _discover_via_terminal_bindings()
+
+
+def discover_mission_for_session(cc_session_id: str) -> str | None:
+    """Return the mission bound to *cc_session_id* in SQLite, or None.
+
+    Uses the shared raise.db so the lookup works across worktrees and
+    concurrent CC sessions without PID navigation.
+    """
+    try:
+        from pathlib import Path as _Path
+
+        from raise_cli.session.mission_binding import get_mission_for_session
+
+        return get_mission_for_session(_Path.cwd(), cc_session_id)
+    except Exception:
+        return None
+
+
+def discover_agent_runtime() -> str:
+    """Resolve the active agent runtime identifier.
+
+    Resolution: $RAISE_AGENT_RUNTIME > CC-specific env detection > "unknown".
+    """
+    explicit = os.environ.get("RAISE_AGENT_RUNTIME", "").strip()
+    if explicit:
+        return explicit
+
+    if os.environ.get("RAISE_CC_SESSION_ID", "").strip():
+        return "claude_code"
+
+    if _discover_via_cc_port():
+        return "claude_code"
+
+    if _discover_via_terminal_bindings():
+        return "claude_code"
+
+    return "unknown"
+
+
+def _discover_via_cc_port() -> str | None:
+    """CC-specific: match CLAUDE_CODE_SSE_PORT to session dir's cc.port file.
+
+    Returns the matching session ID only when exactly one session matches the
+    port. Returns None when the match is ambiguous (multiple sessions share the
+    same port, which happens during multi-agent runs where each subagent session
+    also writes cc.port). Ambiguous cases are resolved by the terminal-bindings
+    fallback instead.
+    """
+    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)
+    return matches[0] if len(matches) == 1 else None
+
+
+def _get_parent_pid(pid: int) -> int | None:
+    """Return the parent PID of *pid* via /proc (Linux only)."""
+    try:
+        status = Path(f"/proc/{pid}/status").read_text()
+        for line in status.splitlines():
+            if line.startswith("PPid:"):
+                return int(line.split()[1])
+        return None
+    except (FileNotFoundError, ValueError, PermissionError, OSError):
+        return None
+
+
+def _discover_via_terminal_bindings() -> str | None:
+    """Resolve session ID by walking the PID ancestry to the CC process.
+
+    The SessionStart hook writes ``{cc_pid: {session_id: ...}}`` to
+    ``_terminal_bindings.json``. From within a Bash tool call the CC process is
+    the grandparent: ``rai`` → ``bash`` → ``CC``. Reading the grandparent PID
+    and looking it up in the bindings gives the correct session even when
+    multiple sessions share the same SSE port.
+    """
+    try:
+        bash_pid = os.getppid()
+        cc_pid = _get_parent_pid(bash_pid)
+        if cc_pid is None:
+            return None
+        bindings_file = Path.cwd() / _SESSIONS_DIR / "_terminal_bindings.json"
+        if not bindings_file.exists():
+            return None
+        bindings: dict[str, dict[str, object]] = json.loads(bindings_file.read_text())
+        entry = bindings.get(str(cc_pid))
+        if entry:
+            sid = entry.get("session_id")
+            if sid:
+                return str(sid)
+        return None
+    except Exception:
+        return None

raise_cli-3.0.0/src/raise_cli/_cc_session.py

@@ -0,0 +1,8 @@
+"""Backward compat stub — use _agent_session instead (RAISE-2779)."""
+
+from raise_cli._agent_session import discover_agent_session_id
+
+
+def discover_cc_session_id() -> str | None:
+    """Deprecated: use discover_agent_session_id() instead."""
+    return discover_agent_session_id()