raise-cli 3.0.0a4__tar.gz → 3.0.0a5__tar.gz

{raise_cli-3.0.0a4 → raise_cli-3.0.0a5}/.gitignore

@@ -9,6 +9,9 @@
 .claude/worktrees/
 .claude/projects/
 
+# Hermes Agent worktrees (auto-created by hermes -w)
+.worktrees/
+
 # Claude Code legacy files (superseded, prevent re-addition)
 .claude/RAI.md
 .claude/RAI-naming.md
@@ -25,6 +28,13 @@ daemon.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/
 
@@ -161,3 +171,6 @@ work/research/
 # 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.0a4 → raise_cli-3.0.0a5}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: raise-cli
-Version: 3.0.0a4
+Version: 3.0.0a5
 Summary: RaiSE CLI - Reliable AI Software Engineering governance framework
 Project-URL: Homepage, https://raiseframework.ai
 Project-URL: Documentation, https://docs.raiseframework.ai
@@ -18,6 +18,7 @@ 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
@@ -37,13 +38,12 @@ 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'
 Provides-Extra: csharp
 Requires-Dist: tree-sitter-c-sharp>=0.23.1; extra == 'csharp'
+Provides-Extra: hud
+Requires-Dist: textual<1.0,>=0.86; extra == 'hud'
 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'

{raise_cli-3.0.0a4 → raise_cli-3.0.0a5}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "raise-cli"
-version = "3.0.0a4"
+version = "3.0.0a5"
 description = "RaiSE CLI - Reliable AI Software Engineering governance framework"
 authors = [
     {name = "Emilio Osorio", email = "emilio@humansys.ai"}
@@ -39,6 +39,7 @@ dependencies = [
     "httpx>=0.27.0,<1.0",
     "mcp>=1.26,<2",
     "markdown>=3.6",
+    "atlassian-python-api>=3.41.0",
 ]
 
 [project.optional-dependencies]
@@ -50,15 +51,13 @@ observability = [
 csharp = [
     "tree-sitter-c-sharp>=0.23.1",
 ]
-atlassian = [
-    "atlassian-python-api>=3.41.0",
-]
-confluence = [
-    "atlassian-python-api>=3.41.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"
@@ -68,6 +67,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"
@@ -91,12 +91,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.0a5/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.0a5/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()

raise_cli-3.0.0a5/src/raise_cli/adapters/backlog_config.py

@@ -0,0 +1,190 @@
+"""Generic backlog adapter config I/O — reads/writes .raise/backlog.yaml.
+
+Replaces jira_config.save_jira_config and load_jira_config for CLI use.
+The CLI never imports from jira_config directly (PAT-F-167).
+
+S2503.12 (RAISE-2723)
+"""
+
+from __future__ import annotations
+
+import re
+from pathlib import Path
+from typing import Any
+
+import yaml
+
+from raise_cli.adapters.models.pm import BacklogAdapterConfig
+
+_BACKLOG_YAML_PATH = Path(".raise") / "backlog.yaml"
+_JIRA_YAML_PATH = Path(".raise") / "jira.yaml"
+
+
+def save_backlog_config(
+    project_root: Path,
+    adapter_name: str,
+    updates: dict[str, Any],
+) -> None:
+    """Merge updates into .raise/backlog.yaml under adapter_name section.
+
+    For each top-level key in updates:
+    - If the key already exists as a dict, shallow-merges so sibling sub-keys
+      (e.g. custom_fields.bug vs .story) survive.
+    - Replaces only the matching block in the raw file; other sections untouched.
+    - Appends if section doesn't exist yet.
+    """
+    config_path = project_root / _BACKLOG_YAML_PATH
+    config_path.parent.mkdir(parents=True, exist_ok=True)
+
+    content = ""
+    root_data: dict[str, Any] = {}
+    if config_path.exists():
+        content = config_path.read_text(encoding="utf-8")
+        root_data = yaml.safe_load(content) or {}
+
+    adapter_data: dict[str, Any] = root_data.get(adapter_name) or {}
+
+    # Merge each update key into the adapter section
+    for key, value in updates.items():
+        existing = adapter_data.get(key)
+        if isinstance(existing, dict) and isinstance(value, dict):
+            adapter_data[key] = {**existing, **value}
+        else:
+            adapter_data[key] = value
+
+    # Serialize full adapter section as YAML
+    section_yaml = yaml.dump(
+        {adapter_name: adapter_data},
+        default_flow_style=False,
+        allow_unicode=True,
+        sort_keys=False,
+    )
+
+    # Surgically replace the adapter_name block (key + all indented/blank lines)
+    pattern = re.compile(
+        rf"^{re.escape(adapter_name)}:\n(?:[ \t][^\n]*\n|[ \t]*\n)*",
+        re.MULTILINE,
+    )
+    if pattern.search(content):
+        content = pattern.sub(section_yaml, content)
+    else:
+        if content and not content.endswith("\n"):
+            content += "\n"
+        content += "\n" + section_yaml if content else section_yaml
+
+    config_path.write_text(content, encoding="utf-8")
+
+
+def load_backlog_config(
+    project_root: Path,
+    adapter_name: str,
+) -> BacklogAdapterConfig:
+    """Load and validate backlog.yaml section for adapter_name.
+
+    Runs migrate_jira_yaml_if_needed() first so projects with only jira.yaml
+    continue working without manual migration.
+
+    Raises:
+        FileNotFoundError: If neither backlog.yaml nor jira.yaml exists.
+        KeyError: If adapter_name section is missing.
+        pydantic.ValidationError: If section doesn't match BacklogAdapterConfig.
+    """
+    migrate_jira_yaml_if_needed(project_root)
+    config_path = project_root / _BACKLOG_YAML_PATH
+    if not config_path.exists():
+        msg = f"Backlog config not found: {config_path}"
+        raise FileNotFoundError(msg)
+
+    root_data: dict[str, Any] = (
+        yaml.safe_load(config_path.read_text(encoding="utf-8")) or {}
+    )
+    if adapter_name not in root_data:
+        msg = f"Adapter '{adapter_name}' not configured in {config_path}"
+        raise KeyError(msg)
+
+    return BacklogAdapterConfig.model_validate(root_data[adapter_name])
+
+
+def migrate_jira_yaml_if_needed(project_root: Path) -> bool:
+    """Migrate .raise/jira.yaml → .raise/backlog.yaml[jira] with generic field names.
+
+    Applies renames:
+        instances       → organizations
+        instance.site   → organization.url
+        default_instance → default_org
+        project.instance → project.org
+        link_types      → relation_types
+
+    Returns True if migration ran, False if no-op.
+    Idempotent: no-op if backlog.yaml already exists.
+    Preserves jira.yaml (does not delete it).
+    """
+    backlog_path = project_root / _BACKLOG_YAML_PATH
+    jira_path = project_root / _JIRA_YAML_PATH
+
+    if backlog_path.exists():
+        return False
+    if not jira_path.exists():
+        return False
+
+    raw: dict[str, Any] = yaml.safe_load(jira_path.read_text(encoding="utf-8")) or {}
+    migrated = _rename_jira_to_generic(raw)
+
+    backlog_path.parent.mkdir(parents=True, exist_ok=True)
+    content = yaml.dump(
+        {"jira": migrated},
+        default_flow_style=False,
+        allow_unicode=True,
+        sort_keys=False,
+    )
+    backlog_path.write_text(content, encoding="utf-8")
+    return True
+
+
+def _rename_jira_to_generic(raw: dict[str, Any]) -> dict[str, Any]:
+    """Apply field renames from jira.yaml format to backlog.yaml[jira] format."""
+    result: dict[str, Any] = {}
+
+    for key, value in raw.items():
+        if key == "default_instance":
+            result["default_org"] = value
+        elif key == "instances":
+            organizations: dict[str, Any] = {}
+            instances_raw: dict[str, Any] = value or {}
+            for org_name, inst in instances_raw.items():
+                org: dict[str, Any] = {}
+                inst_dict: dict[str, Any] = inst or {}
+                for ikey, ival in inst_dict.items():
+                    org["url" if ikey == "site" else ikey] = ival
+                organizations[org_name] = org
+            result["organizations"] = organizations
+        elif key == "projects":
+            projects: dict[str, Any] = {}
+            projects_raw: dict[str, Any] = value or {}
+            for pkey, proj in projects_raw.items():
+                p: dict[str, Any] = {}
+                proj_dict: dict[str, Any] = proj or {}
+                for pk, pv in proj_dict.items():
+                    p["org" if pk == "instance" else pk] = pv
+                projects[pkey] = p
+            result["projects"] = projects
+        elif key == "link_types":
+            result["relation_types"] = value
+        else:
+            result[key] = value
+
+    return result
+
+
+def get_configured_adapters(project_root: Path) -> set[str]:
+    """Return set of adapter names with a section in backlog.yaml.
+
+    Returns empty set if backlog.yaml doesn't exist.
+    """
+    config_path = project_root / _BACKLOG_YAML_PATH
+    if not config_path.exists():
+        return set()
+    root_data: dict[str, Any] = (
+        yaml.safe_load(config_path.read_text(encoding="utf-8")) or {}
+    )
+    return {k for k in root_data if isinstance(root_data[k], dict)}

{raise_cli-3.0.0a4 → raise_cli-3.0.0a5}/src/raise_cli/adapters/composite_docs.py

@@ -20,7 +20,12 @@ from __future__ import annotations
 import logging
 from typing import Any
 
-from raise_cli.adapters.models.docs import PageContent, PageSummary, PublishResult
+from raise_cli.adapters.models.docs import (
+    CommentSummary,
+    PageContent,
+    PageSummary,
+    PublishResult,
+)
 from raise_cli.adapters.models.health import AdapterHealth
 from raise_cli.adapters.pending_ops import PendingOpsLog
 
@@ -178,3 +183,27 @@ class CompositeDocTarget:
     def health(self) -> AdapterHealth:
         """Delegate to remote (last) target."""
         return self._remote.health()
+
+    def add_label(self, page_id: str, name: str) -> None:
+        """Delegate to remote (last) target."""
+        self._remote.add_label(page_id, name)
+
+    def get_labels(self, page_id: str) -> list[str]:
+        """Delegate to remote (last) target."""
+        return self._remote.get_labels(page_id)
+
+    def get_page_children(self, page_id: str) -> list[PageSummary]:
+        """Delegate to remote (last) target."""
+        return self._remote.get_page_children(page_id)
+
+    def delete_page(self, page_id: str) -> None:
+        """Delegate to remote (last) target."""
+        self._remote.delete_page(page_id)
+
+    def add_comment(self, page_id: str, body: str) -> None:
+        """Delegate to remote (last) target."""
+        self._remote.add_comment(page_id, body)
+
+    def get_comments(self, page_id: str) -> list[CommentSummary]:
+        """Delegate to remote (last) target."""
+        return self._remote.get_comments(page_id)