raise-cli 2.3.0__tar.gz → 2.4.0__tar.gz

{raise_cli-2.3.0 → raise_cli-2.4.0}/.gitignore

@@ -20,9 +20,13 @@ CLAUDE.local.md
 .raise/confluence-pages.yaml
 .raise/backlog/
 
-# RaiSE adapter configs (contain PII — use .example templates)
-.raise/jira.yaml
-.raise/confluence.yaml
+# 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 derived artifacts (rebuild with `rai memory build`)
 .raise/rai/memory/index.json
@@ -95,12 +99,16 @@ 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
 
 # Secrets & credentials
 .env
 .env.*
+!.env.example
 *.pem
 *.key
 .pypirc
@@ -110,13 +118,8 @@ credentials.json
 .raise/mcp/
 !.raise/mcp/catalog.yaml
 
-# Website (Astro)
-site/node_modules/
-site/dist/
-site/.astro/
-site/.wrangler/
-docs/node_modules/
-docs/.astro/
+# MkDocs build output
+_site/
 
 # Issue analysis artifacts (PDFs, images — binary, no git value)
 dev/issues/**/*.pdf
@@ -127,3 +130,4 @@ dev/transcripts/
 
 # Prevent symlink artifacts from being tracked at root
 /es/
+work/research/

raise_cli-2.4.0/PKG-INFO

@@ -0,0 +1,190 @@
+Metadata-Version: 2.4
+Name: raise-cli
+Version: 2.4.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: 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'
+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-2.4.0/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.0/pyproject.toml

@@ -0,0 +1,135 @@
+[project]
+name = "raise-cli"
+version = "2.4.0"
+description = "RaiSE CLI - Reliable AI Software Engineering governance framework"
+authors = [
+    {name = "Emilio Osorio", email = "emilio@humansys.ai"}
+]
+readme = "README.md"
+license = {text = "Apache-2.0"}
+requires-python = ">=3.12"
+keywords = ["ai", "governance", "cli", "software-engineering", "methodology"]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: Apache Software License",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Topic :: Software Development :: Quality Assurance",
+    "Topic :: Software Development :: Libraries :: Application Frameworks",
+]
+
+dependencies = [
+    "raise-core",
+    "typer>=0.12.0",
+    "rich>=13.7.0",
+    "pydantic>=2.6.0",
+    "pydantic-settings>=2.2.0",
+    "python-dotenv>=1.0.0",
+    "pyyaml>=6.0.1",
+    "networkx>=3.6.1",
+    "tree-sitter>=0.25.2",
+    "tree-sitter-typescript>=0.23.2",
+    "tree-sitter-javascript>=0.25.0",
+    "tree-sitter-php>=0.24.1",
+    "tree-sitter-svelte>=1.0.2",
+    "tree-sitter-language-pack>=0.13.0",
+    "logfire-api>=4.0",
+]
+
+[project.optional-dependencies]
+mcp = [
+    "mcp>=1.26,<2",
+]
+observability = [
+    "logfire>=4.0",
+]
+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",
+]
+
+[project.urls]
+Homepage = "https://raiseframework.ai"
+Documentation = "https://docs.raiseframework.ai"
+Repository = "https://github.com/humansys/raise"
+Changelog = "https://github.com/humansys/raise/blob/main/CHANGELOG.md"
+
+[project.scripts]
+rai = "raise_cli.cli.main:app"
+
+[project.entry-points."rai.governance.parsers"]
+prd = "raise_cli.governance.parsers.prd:PrdParser"
+vision = "raise_cli.governance.parsers.vision:VisionParser"
+constitution = "raise_cli.governance.parsers.constitution:ConstitutionParser"
+roadmap = "raise_cli.governance.parsers.roadmap:RoadmapParser"
+backlog = "raise_cli.governance.parsers.backlog:BacklogParser"
+epic_scope = "raise_cli.governance.parsers.epic:EpicScopeParser"
+adr = "raise_cli.governance.parsers.adr:AdrParser"
+guardrails = "raise_cli.governance.parsers.guardrails:GuardrailsParser"
+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"
+
+[project.entry-points."rai.gates"]
+tests = "raise_cli.gates.builtin.tests:TestGate"
+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"
+
+[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"
+
+[project.entry-points."rai.adapters.pm"]
+filesystem = "raise_cli.adapters.filesystem:FilesystemPMAdapter"
+jira = "raise_cli.adapters.jira_adapter:PythonApiJiraAdapter"
+
+[project.entry-points."rai.docs.targets"]
+filesystem = "raise_cli.adapters.filesystem_docs:FilesystemDocsTarget"
+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 }
+
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/raise_cli"]
+
+[tool.hatch.build.targets.sdist]
+include = [
+    "/src/raise_cli/",
+    "/LICENSE",
+    "/README.md",
+    "/pyproject.toml",
+]

{raise_cli-2.3.0 → raise_cli-2.4.0}/src/raise_cli/__init__.py

@@ -5,6 +5,8 @@ A governance framework for AI-assisted software development.
 
 from __future__ import annotations
 
+from importlib.metadata import version as _pkg_version
+
 from raise_cli.exceptions import (
     ArtifactNotFoundError,
     ConfigurationError,
@@ -17,7 +19,7 @@ from raise_cli.exceptions import (
     ValidationError,
 )
 
-__version__ = "2.3.0"
+__version__ = _pkg_version("raise-cli")
 __author__ = "Emilio Osorio"
 __license__ = "MIT"
 

{raise_cli-2.3.0 → raise_cli-2.4.0}/src/raise_cli/adapters/__init__.py

@@ -1,6 +1,6 @@
 """Adapter contracts and registry for raise-cli extensibility.
 
-Public API: 7 Protocols + 15 boundary models + 2 sync wrappers
+Public API: 7 Protocols + 16 boundary models + 2 sync wrappers
 + 5 registry functions + 5 group constants.
 KnowledgeGraphBackend + BackendHealth moved to raise_core (E275).
 
@@ -22,6 +22,7 @@ from raise_cli.adapters.models import (
     PageContent,
     PageSummary,
     PublishResult,
+    SpaceInfo,
 )
 from raise_cli.adapters.protocols import (
     AsyncDocumentationTarget,
@@ -76,6 +77,7 @@ __all__ = [
     "PageContent",
     "PageSummary",
     "PublishResult",
+    "SpaceInfo",
     # Registry functions
     "get_doc_targets",
     "get_governance_parsers",

raise_cli-2.4.0/src/raise_cli/adapters/composite_docs.py

@@ -0,0 +1,92 @@
+"""Composite documentation target — delegates to multiple targets.
+
+Publishes to ALL targets (e.g. filesystem + Confluence). Reads (get_page,
+search, health) delegate to the remote target (last in list — typically Confluence).
+
+Filesystem is first for durability: local copy always saved.
+Result prefers last successful publish (remote URL over local path).
+If remote fails, returns success with warning (local copy is the guarantee).
+
+RAISE-1051 (S1051.7)
+"""
+
+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.health import AdapterHealth
+
+logger = logging.getLogger(__name__)
+
+
+class CompositeDocTarget:
+    """Delegates to multiple DocumentationTargets.
+
+    - publish: calls all targets; returns last successful result (remote preferred)
+    - get_page / search / health: delegate to remote (last) target
+    - Filesystem first for durability, Confluence last for the URL
+    """
+
+    def __init__(self, targets: list[Any]) -> None:
+        self._targets = targets
+        self._remote = targets[-1]  # last target = remote (Confluence)
+
+    def can_publish(self, doc_type: str, metadata: dict[str, Any]) -> bool:
+        """True if any wrapped target can publish."""
+        return any(t.can_publish(doc_type, metadata) for t in self._targets)
+
+    def publish(
+        self, doc_type: str, content: str, metadata: dict[str, Any]
+    ) -> PublishResult:
+        """Publish to all accepting targets. Return best result.
+
+        Prefers last successful result (remote URL). If remote fails but
+        local succeeded, returns success with sync-pending warning.
+        """
+        results: list[PublishResult] = []
+        failures: list[str] = []
+
+        for target in self._targets:
+            if target.can_publish(doc_type, metadata):
+                try:
+                    result: PublishResult = target.publish(doc_type, content, metadata)
+                    results.append(result)
+                    if not result.success:
+                        failures.append(result.message)
+                except Exception as exc:
+                    logger.warning("Composite publish failed on %s: %s", type(target).__name__, exc)
+                    failures.append(str(exc))
+
+        if not results:
+            return PublishResult(
+                success=False, message="No target accepted this doc_type"
+            )
+
+        # Prefer last successful result (remote URL over local path)
+        successful = [r for r in results if r.success]
+        if successful:
+            best = successful[-1]  # last success = remote if available
+            if failures:
+                return PublishResult(
+                    success=True,
+                    url=best.url,
+                    message=f"{best.message} (sync pending: {'; '.join(failures)})",
+                )
+            return best
+
+        # All failed — return first failure
+        return results[0]
+
+    def get_page(self, identifier: str) -> PageContent:
+        """Delegate to remote (last) target."""
+        return self._remote.get_page(identifier)
+
+    def search(self, query: str, limit: int = 10) -> list[PageSummary]:
+        """Delegate to remote (last) target."""
+        return self._remote.search(query, limit=limit)
+
+    def health(self) -> AdapterHealth:
+        """Delegate to remote (last) target."""
+        return self._remote.health()