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

{raise_cli-2.4.0a2 → raise_cli-3.0.0a1}/.gitignore

@@ -15,10 +15,19 @@ CLAUDE.local.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/
+
+# 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)
@@ -28,8 +37,8 @@ CLAUDE.local.md
 # Dossier output (generated, not committed)
 dev/output/
 
-# RaiSE derived artifacts (rebuild with `rai memory build`)
-.raise/rai/memory/index.json
+# RaiSE graph index — tracked (essential for skill PRIME/JIT queries in worktrees)
+# Rebuild with: rai graph build
 
 # RaiSE personal directory (per-developer, not shared)
 .raise/rai/personal/
@@ -99,6 +108,9 @@ dmypy.json
 # 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
 
@@ -117,6 +129,7 @@ credentials.json
 
 # MkDocs build output
 _site/
+.docs-build/
 
 # Issue analysis artifacts (PDFs, images — binary, no git value)
 dev/issues/**/*.pdf
@@ -127,3 +140,4 @@ dev/transcripts/
 
 # Prevent symlink artifacts from being tracked at root
 /es/
+work/research/

raise_cli-3.0.0a1/PKG-INFO

@@ -0,0 +1,193 @@
+Metadata-Version: 2.4
+Name: raise-cli
+Version: 3.0.0a1
+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: 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
+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'
+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: mcp
+Requires-Dist: mcp<2,>=1.26; extra == 'mcp'
+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]"
+
+# MCP server support
+pip install "raise-cli[mcp]"
+
+# All extras
+pip install "raise-cli[jira,confluence,mcp,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).

raise_cli-3.0.0a1/README.md

@@ -0,0 +1,141 @@
+# 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]"
+
+# MCP server support
+pip install "raise-cli[mcp]"
+
+# All extras
+pip install "raise-cli[jira,confluence,mcp,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).

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

@@ -1,12 +1,11 @@
 [project]
 name = "raise-cli"
-version = "2.4.0a2"
+version = "3.0.0a1"
 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"]
@@ -37,6 +36,7 @@ dependencies = [
     "tree-sitter-svelte>=1.0.2",
     "tree-sitter-language-pack>=0.13.0",
     "logfire-api>=4.0",
+    "httpx>=0.27.0",
 ]
 
 [project.optional-dependencies]
@@ -45,6 +45,8 @@ mcp = [
 ]
 observability = [
     "logfire>=4.0",
+    "opentelemetry-api>=1.20",
+    "opentelemetry-sdk>=1.20",
 ]
 csharp = [
     "tree-sitter-c-sharp>=0.23.1",
@@ -95,6 +97,7 @@ format = "raise_cli.gates.builtin.format:FormatGate"
 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"
 
 [project.entry-points."rai.adapters.pm"]
 filesystem = "raise_cli.adapters.filesystem:FilesystemPMAdapter"
@@ -107,6 +110,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 }
 

{raise_cli-2.4.0a2 → raise_cli-3.0.0a1}/src/raise_cli/adapters/confluence_adapter.py

@@ -42,7 +42,13 @@ class PythonApiConfluenceAdapter:
     def publish(
         self, doc_type: str, content: str, metadata: dict[str, Any]
     ) -> PublishResult:
-        """Publish doc: resolve routing, find/create page, apply labels."""
+        """Publish doc: resolve parent and labels, find/create page.
+
+        Parent resolution priority (RAISE-605):
+        1. metadata["parent_id"] — explicit override
+        2. routing.parent_title — from config
+        3. Error — no parent available
+        """
         title = metadata.get("title")
         if not title:
             return PublishResult(
@@ -51,26 +57,29 @@ class PythonApiConfluenceAdapter:
             )
 
         routing = self._config.resolve_routing(doc_type)
-        if not routing:
-            return PublishResult(
-                success=False,
-                message=f"No routing configured for doc_type '{doc_type}'",
-            )
-
-        labels = routing.labels
-        parent_id: str | None = None
-
-        # Resolve parent page — fail if not found (reliability over convenience)
-        parent_page = self._client.get_page_by_title(routing.parent_title)
-        if not parent_page:
-            return PublishResult(
-                success=False,
-                message=(
-                    f"Parent page '{routing.parent_title}' not found in Confluence. "
-                    "Create it first or fix routing config."
-                ),
-            )
-        parent_id = parent_page.id
+        labels: list[str] = routing.labels if routing else []
+        parent_id: str | None = metadata.get("parent_id")
+
+        # Resolve parent: explicit > routing > error
+        if parent_id is None:
+            if not routing:
+                return PublishResult(
+                    success=False,
+                    message=(
+                        f"No routing configured for doc_type '{doc_type}' "
+                        "and no parent_id provided in metadata."
+                    ),
+                )
+            parent_page = self._client.get_page_by_title(routing.parent_title)
+            if not parent_page:
+                return PublishResult(
+                    success=False,
+                    message=(
+                        f"Parent page '{routing.parent_title}' not found in Confluence. "
+                        "Create it first or fix routing config."
+                    ),
+                )
+            parent_id = parent_page.id
 
         # Check if page already exists
         existing = self._client.get_page_by_title(title)

{raise_cli-2.4.0a2 → raise_cli-3.0.0a1}/src/raise_cli/adapters/confluence_client.py

@@ -163,10 +163,38 @@ class ConfluenceClient:
 
     # ── Discovery ─────────────────────────────────────────────────────
 
+    def get_space_homepage_id(self, space_key: str) -> str | None:
+        """Get the homepage page ID for a space. Returns None if not found."""
+        try:
+            raw: Any = self._client.get_home_page_of_space(space_key)  # type: ignore[no-untyped-call]
+            if isinstance(raw, dict) and "id" in raw:
+                return str(raw["id"])  # type: ignore[no-untyped-call]
+            return None
+        except ConfluenceError:
+            raise
+        except Exception as e:
+            raise self._map_error(e, f"get_space_homepage_id({space_key})") from e
+
     def get_spaces(self) -> list[SpaceInfo]:
-        """List all accessible spaces."""
+        """List all accessible spaces.
+
+        Paginates through all results — ``get_all_spaces()`` returns only
+        one page (default limit=50), which misses spaces beyond that page.
+        RAISE-1187: discovered during S1130.4 dogfood.
+        """
         try:
-            raw: dict[str, Any] = self._client.get_all_spaces()  # type: ignore[no-untyped-call]
+            all_results: list[dict[str, Any]] = []
+            start = 0
+            limit = 100
+            while True:
+                raw: dict[str, Any] = self._client.get_all_spaces(  # type: ignore[no-untyped-call]
+                    start=start, limit=limit
+                )
+                results: list[dict[str, Any]] = raw.get("results", [])
+                all_results.extend(results)
+                if len(results) < limit:
+                    break
+                start += limit
             return [
                 SpaceInfo(
                     key=s["key"],
@@ -174,7 +202,7 @@ class ConfluenceClient:
                     url=s.get("_links", {}).get("webui", ""),
                     type=s.get("type", "global"),
                 )
-                for s in raw.get("results", [])
+                for s in all_results
             ]
         except ConfluenceError:
             raise
@@ -201,10 +229,25 @@ class ConfluenceClient:
 
     # ── Search & Health ───────────────────────────────────────────────
 
+    @staticmethod
+    def _ensure_cql(query: str) -> str:
+        """Wrap plain text in CQL siteSearch if not already CQL.
+
+        CQL queries contain operators like ~, =, AND, OR, or known
+        predicates like type=, space=, text~. Plain text does not.
+        """
+        cql_indicators = ("~", "=", " AND ", " OR ", " ORDER BY ")
+        if any(op in query for op in cql_indicators):
+            return query
+        # Escape double quotes in user query
+        escaped = query.replace('"', '\\"')
+        return f'siteSearch ~ "{escaped}"'
+
     def search(self, cql: str, limit: int = 10) -> list[PageSummary]:
-        """Search using CQL."""
+        """Search using CQL. Plain text queries are auto-wrapped."""
+        effective_cql = self._ensure_cql(cql)
         try:
-            raw: dict[str, Any] = self._client.cql(cql, limit=limit)  # type: ignore[no-untyped-call]
+            raw: dict[str, Any] = self._client.cql(effective_cql, limit=limit)  # type: ignore[no-untyped-call]
             return [
                 PageSummary(
                     id=str(r["content"]["id"]),
@@ -217,7 +260,7 @@ class ConfluenceClient:
         except ConfluenceError:
             raise
         except Exception as e:
-            raise self._map_error(e, f"search({cql!r})") from e
+            raise self._map_error(e, f"search({effective_cql!r})") from e
 
     def health(self) -> AdapterHealth:
         """Check connectivity by listing 1 space."""
@@ -225,9 +268,7 @@ class ConfluenceClient:
             self._client.get_all_spaces(limit=1)  # type: ignore[no-untyped-call]
             return AdapterHealth(name="confluence", healthy=True)
         except Exception as e:
-            return AdapterHealth(
-                name="confluence", healthy=False, message=str(e)
-            )
+            return AdapterHealth(name="confluence", healthy=False, message=str(e))
 
     # ── Internal ──────────────────────────────────────────────────────