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

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

@@ -6,7 +6,6 @@
 
 # Claude Code local settings (user-specific)
 .claude/settings.local.json
-CLAUDE.local.md
 .claude/worktrees/
 .claude/projects/
 

{raise_cli-2.4.0 → raise_cli-2.4.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: raise-cli
-Version: 2.4.0
+Version: 2.4.1
 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: httpx>=0.27.0
 Requires-Dist: logfire-api>=4.0
 Requires-Dist: networkx>=3.6.1
 Requires-Dist: pydantic-settings>=2.2.0

{raise_cli-2.4.0 → raise_cli-2.4.1}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "raise-cli"
-version = "2.4.0"
+version = "2.4.1"
 description = "RaiSE CLI - Reliable AI Software Engineering governance framework"
 authors = [
     {name = "Emilio Osorio", email = "emilio@humansys.ai"}
@@ -36,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]
@@ -81,7 +82,6 @@ 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"

{raise_cli-2.4.0 → raise_cli-2.4.1}/src/raise_cli/adapters/jira_adapter.py

@@ -212,6 +212,8 @@ class PythonApiJiraAdapter:
             fields["description"] = issue.description
         if issue.labels:
             fields["labels"] = issue.labels
+        if issue.metadata.get("parent"):
+            fields["parent"] = {"key": issue.metadata["parent"]}
 
         result = client.create_issue(fields)
         key = result.get("key", "")

{raise_cli-2.4.0 → raise_cli-2.4.1}/src/raise_cli/cli/commands/init.py

@@ -511,32 +511,67 @@ def _create_and_save_manifest(
     detection: DetectionResult,
     valid_agent_types: list[str],
 ) -> ProjectManifest:
-    """Create project manifest from detection results and save it."""
+    """Create project manifest from detection results and save it.
+
+    When an existing manifest is present, preserve user-configured values
+    and only update detection-derived fields (RAISE-1431, RAISE-1320).
+
+    Preserved on re-init: name, ide, agents, language (if set), detected_at,
+    toolchain commands (if user-configured), branches, tier, backlog.
+    Updated on re-init: project_type, code_file_count (always re-scanned).
+    """
     existing_manifest = load_manifest(project_path)
+    ep = existing_manifest.project if existing_manifest else None
+
+    # Preserve existing name if caller got it from directory (no --name flag)
+    effective_name = project_name
+    if ep and ep.name and project_name == project_path.name:
+        effective_name = ep.name
+
+    # Preserve user-configured language; fall back to detection (RAISE-1320)
+    effective_language = ep.language if ep and ep.language else detection.language
+
+    # Preserve user-configured toolchain commands; fall back to detection
+    detected_test = detection.toolchain.test_command if detection.toolchain else None
+    detected_lint = detection.toolchain.lint_command if detection.toolchain else None
+    detected_type = detection.toolchain.type_check_command if detection.toolchain else None
+    detected_format = detection.toolchain.format_command if detection.toolchain else None
 
     project_info = ProjectInfo(
-        name=project_name,
+        name=effective_name,
         project_type=detection.project_type,
         code_file_count=detection.code_file_count,
-        language=detection.language,
-        test_command=detection.toolchain.test_command if detection.toolchain else None,
-        lint_command=detection.toolchain.lint_command if detection.toolchain else None,
-        type_check_command=(
-            detection.toolchain.type_check_command if detection.toolchain else None
-        ),
+        language=effective_language,
+        test_command=ep.test_command if ep and ep.test_command else detected_test,
+        lint_command=ep.lint_command if ep and ep.lint_command else detected_lint,
+        type_check_command=ep.type_check_command if ep and ep.type_check_command else detected_type,
+        format_command=ep.format_command if ep and ep.format_command else detected_format,
+        # Preserve original detected_at timestamp on re-init (RAISE-1320)
+        **({"detected_at": ep.detected_at} if ep else {}),
     )
-    # Sync ide.type with agents.types[0] (RAISE-218)
-    primary = valid_agent_types[0] if valid_agent_types else "claude"
-    try:
-        ide_manifest = IdeManifest(type=primary)  # type: ignore[arg-type]
-    except Exception:
-        ide_manifest = IdeManifest()  # custom agents outside BuiltinAgentType
+
+    # Preserve existing agents/ide if present, merge new detections (RAISE-1431)
+    if existing_manifest:
+        existing_agents = existing_manifest.agents.types if existing_manifest.agents else []
+        merged_agents = list(dict.fromkeys(existing_agents + valid_agent_types))
+        effective_agents = merged_agents
+        effective_ide = existing_manifest.ide
+    else:
+        effective_agents = valid_agent_types
+        primary = valid_agent_types[0] if valid_agent_types else "claude"
+        try:
+            effective_ide = IdeManifest(type=primary)  # type: ignore[arg-type]
+        except Exception:
+            effective_ide = IdeManifest()
+
     manifest = ProjectManifest(
         project=project_info,
-        agents=AgentsManifest(types=valid_agent_types),
-        ide=ide_manifest,
+        agents=AgentsManifest(types=effective_agents),
+        ide=effective_ide,
         branches=existing_manifest.branches if existing_manifest else BranchConfig(),
         tier=existing_manifest.tier if existing_manifest else None,
+        # Preserve backlog config on re-init (RAISE-1320)
+        backlog=existing_manifest.backlog if existing_manifest else None,
     )
     save_manifest(manifest, project_path)
     return manifest
@@ -678,6 +713,14 @@ def _detect_and_generate_guardrails(
     guardrails_dir = project_path / "governance"
     guardrails_dir.mkdir(parents=True, exist_ok=True)
     guardrails_path = guardrails_dir / "guardrails.md"
+
+    # Never overwrite user-customized guardrails on re-init (RAISE-1320/Gustavo).
+    # Allow overwrite of empty scaffold templates (contain "fill with" marker).
+    if guardrails_path.exists():
+        existing = guardrails_path.read_text(encoding="utf-8")
+        if "fill with /rai-project-create" not in existing:
+            return
+
     guardrails_path.write_text(guardrails_content, encoding="utf-8")
 
     instructions_path = project_path / instructions_file
@@ -799,19 +842,32 @@ def init_command(
 ) -> None:
     """Initialize a RaiSE project in the current directory.
 
-    Detects project type (greenfield/brownfield), creates .raise/manifest.yaml,
-    and scaffolds skills/workflows for each target agent.
+    First-time setup only. If the project is already initialized (.raise/ exists),
+    use ``rai upgrade`` instead to update skills, framework files, and configuration.
 
     Examples:
         $ rai init                                 # defaults to claude
         $ rai init --agent cursor                  # single agent
         $ rai init --agent claude --agent cursor   # multi-agent
         $ rai init --detect                        # auto-detect agents
-        $ rai init --ide antigravity               # (deprecated) alias
+        $ rai init --force                         # re-init (destructive)
     """
     project_path = (path if path is not None else Path.cwd()).resolve()
     project_name = name if name is not None else project_path.name
 
+    # Guard: already initialized? Suggest rai upgrade (RAISE-1462)
+    raise_dir = project_path / ".raise"
+    if raise_dir.is_dir() and not force:
+        console.print(
+            "[yellow]Project already initialized[/yellow] "
+            f"(.raise/ exists at {project_path}).\n\n"
+            "To update skills and framework files, run:\n"
+            "  [bold]rai upgrade[/bold]\n\n"
+            "To re-initialize from scratch, run:\n"
+            "  [bold]rai init --force[/bold]"
+        )
+        raise typer.Exit(code=1)
+
     # Load or create developer profile
     profile, created_profile = _load_or_create_profile(project_path)
 
@@ -900,3 +956,175 @@ def init_command(
         _detect_and_generate_guardrails(
             project_path, project_name, profile, first_config.instructions_file
         )
+
+
+# =============================================================================
+# rai upgrade — re-init with merge strategy (RAISE-1462)
+# =============================================================================
+
+
+def upgrade_command(
+    path: Annotated[
+        Path | None,
+        typer.Option(
+            "--path",
+            "-p",
+            help="Project root directory (defaults to current directory).",
+        ),
+    ] = None,
+    detect: Annotated[
+        bool,
+        typer.Option(
+            "--detect",
+            "-d",
+            help="Re-detect installed agents and update AGENTS.md.",
+        ),
+    ] = False,
+    dry_run: Annotated[
+        bool,
+        typer.Option(
+            "--dry-run",
+            help="Preview skill updates without writing files.",
+        ),
+    ] = False,
+    force: Annotated[
+        bool,
+        typer.Option(
+            "--force",
+            help="Overwrite all skill files without prompting.",
+        ),
+    ] = False,
+    skip_updates: Annotated[
+        bool,
+        typer.Option(
+            "--skip-updates",
+            help="Keep all existing skills, only install new ones.",
+        ),
+    ] = False,
+    skill_set: Annotated[
+        str | None,
+        typer.Option(
+            "--skill-set",
+            help="Overlay a skill set from .raise/skills/{name}/ on top of builtins.",
+        ),
+    ] = None,
+) -> None:
+    """Update an existing RaiSE project to the latest version.
+
+    Updates skills, framework files, and regenerates CLAUDE.md while preserving
+    user-configured values (manifest fields, governance docs, custom skills).
+
+    Use ``rai init`` for first-time project setup.
+
+    Examples:
+        $ rai upgrade                  # update skills + framework
+        $ rai upgrade --detect         # also re-detect agents
+        $ rai upgrade --dry-run        # preview changes
+        $ rai upgrade --skip-updates   # only install new skills
+    """
+    project_path = (path if path is not None else Path.cwd()).resolve()
+
+    # Guard: must be initialized
+    raise_dir = project_path / ".raise"
+    if not raise_dir.is_dir():
+        console.print(
+            "[red]Project not initialized[/red] "
+            f"(no .raise/ at {project_path}).\n\n"
+            "Run [bold]rai init[/bold] first to set up the project."
+        )
+        raise typer.Exit(code=1)
+
+    # Load existing manifest for project name
+    existing_manifest = load_manifest(project_path)
+    project_name = (
+        existing_manifest.project.name if existing_manifest else project_path.name
+    )
+
+    # Load developer profile (never create on upgrade)
+    _profile, _created = _load_or_create_profile(project_path)
+
+    # Detect project type
+    detection = detect_project_type(project_path)
+
+    # Load agent registry and resolve agent types
+    registry = load_registry(project_root=project_path)
+    if detect:
+        agent_types = _resolve_agent_types(None, None, True, project_path, registry)
+    elif existing_manifest:
+        agent_types = existing_manifest.agents.types if existing_manifest.agents else ["claude"]
+    else:
+        agent_types = ["claude"]
+
+    valid_agent_types = _validate_agent_types(agent_types, registry)
+
+    # Update manifest with merge strategy (preserves user config)
+    manifest = _create_and_save_manifest(
+        project_path, project_name, detection, valid_agent_types
+    )
+
+    # Bootstrap (idempotent — skips existing files)
+    _bootstrap_result, _governance_result, memory_content = _bootstrap_project_assets(
+        project_path, project_name, manifest
+    )
+
+    # Update skills (diff/merge UX)
+    first_config = registry.get_config(valid_agent_types[0])
+    first_skills_result = _scaffold_per_agent(
+        project_path,
+        valid_agent_types,
+        registry,
+        memory_content,
+        force=force,
+        skip_updates=skip_updates,
+        dry_run=dry_run,
+        skill_set=skill_set,
+    )
+
+    # Dry-run: show summary and exit
+    if dry_run and first_skills_result is not None:
+        _print_skill_sync_summary(first_skills_result)
+        has_updates = bool(
+            first_skills_result.skills_updated
+            or first_skills_result.skills_installed
+            or first_skills_result.skills_conflicted
+        )
+        raise typer.Exit(code=0 if not has_updates else 1)
+
+    # Regenerate CLAUDE.md (it's generated, safe to overwrite)
+    if raise_dir.is_dir():
+        instructions_content = generate_instructions(
+            project_name=project_name,
+            detection=detection,
+            project_path=project_path,
+        )
+        instructions_path = project_path / first_config.instructions_file
+        instructions_path.parent.mkdir(parents=True, exist_ok=True)
+        instructions_path.write_text(instructions_content, encoding="utf-8")
+
+    # Emit event
+    emitter = create_emitter()
+    emitter.emit(
+        InitCompleteEvent(
+            project_path=project_path,
+            project_name=project_name,
+        )
+    )
+
+    # AGENTS.md on --detect
+    if detect:
+        _generate_agents_md(project_path, valid_agent_types, project_name)
+
+    # Output
+    console.print(
+        f"\n[bold green]Upgrade complete[/bold green] — {project_name}\n"
+    )
+    if first_skills_result:
+        installed = len(first_skills_result.skills_installed)
+        updated = len(first_skills_result.skills_updated)
+        kept = len(first_skills_result.skills_kept)
+        if installed or updated:
+            console.print(
+                f"  Skills: {installed} new, {updated} updated, {kept} unchanged"
+            )
+        else:
+            console.print("  Skills: all up to date")

{raise_cli-2.4.0 → raise_cli-2.4.1}/src/raise_cli/cli/commands/journal.py

@@ -1,12 +1,11 @@
-"""CLI commands for session journal — incremental memory persistence.
+"""CLI commands for session journal — DEPRECATED.
 
-Provides `rai session journal add` and `rai session journal show` for
-persisting and retrieving session context across compaction events.
+The journal system is deprecated as of v3.0.0a1 (RAISE-1433). The append-only
+journal relied on Claude Code hook injection for post-compaction recovery,
+which is broken (CC bugs #12671, #15174). Commands remain functional for
+backward compatibility but will be removed in v3.1.
 
-Example:
-    $ rai session journal add "Use JSONL for persistence" --type decision
-    $ rai session journal show --last 5
-    $ rai session journal show --compact
+Use ``/rai-session-close`` skill for full session continuity instead.
 """
 
 from __future__ import annotations
@@ -97,11 +96,26 @@ def add(
 ) -> None:
     """Add a journal entry to the current session.
 
+    .. deprecated:: 3.0.0a1
+        Journal is deprecated (RAISE-1433). Use /rai-session-close for continuity.
+
     Examples:
         $ rai session journal add "Use JSONL for journal" --type decision
         $ rai session journal add "T1 complete" --type task_done
-        $ rai session journal add "Compaction loses rationale" --type insight --tags "compaction,memory"
     """
+    import warnings
+
+    warnings.warn(
+        "rai session journal is deprecated (RAISE-1433). "
+        "Use /rai-session-close skill for session continuity.",
+        DeprecationWarning,
+        stacklevel=1,
+    )
+    typer.echo(
+        "Warning: journal is deprecated (RAISE-1433). "
+        "Use /rai-session-close for session continuity.",
+        err=True,
+    )
     session_dir = _resolve_session_dir(project)
     tag_list = [t.strip() for t in tags.split(",") if t.strip()] if tags else []
 
@@ -143,14 +157,21 @@ def show(
 ) -> None:
     """Show journal entries for the current session.
 
-    With --compact, outputs a token-efficient format suitable for
-    post-compaction context injection via hooks.
+    .. deprecated:: 3.0.0a1
+        Journal is deprecated (RAISE-1433). Use /rai-session-close for continuity.
 
     Examples:
         $ rai session journal show
-        $ rai session journal show --last 5
         $ rai session journal show --compact
     """
+    import warnings
+
+    warnings.warn(
+        "rai session journal is deprecated (RAISE-1433). "
+        "Use /rai-session-close skill for session continuity.",
+        DeprecationWarning,
+        stacklevel=1,
+    )
     session_dir = _resolve_session_dir(project)
     entries = read_journal(session_dir, last_n=last)
 

{raise_cli-2.4.0 → raise_cli-2.4.1}/src/raise_cli/cli/commands/release.py

@@ -42,12 +42,11 @@ GRAPH_REL_PATH = Path(".raise") / "rai" / "memory" / "index.json"
 # =============================================================================
 
 
-def _find_project_paths(project: Path) -> tuple[Path, Path, Path]:
-    """Find pyproject.toml, __init__.py, and CHANGELOG.md paths."""
+def _find_project_paths(project: Path) -> tuple[Path, Path]:
+    """Find pyproject.toml and CHANGELOG.md paths."""
     pyproject_path = project / "pyproject.toml"
     changelog_path = project / "CHANGELOG.md"
-    init_path = project / "src" / "raise_cli" / "__init__.py"
-    return pyproject_path, init_path, changelog_path
+    return pyproject_path, changelog_path
 
 
 def _read_current_version(pyproject_path: Path) -> str:
@@ -180,12 +179,11 @@ def check_command(
         $ rai release check
         $ rai release check --project /path/to/project
     """
-    pyproject_path, init_path, changelog_path = _find_project_paths(project)
+    pyproject_path, changelog_path = _find_project_paths(project)
 
     results = run_checks(
         project_root=project,
         pyproject_path=pyproject_path,
-        init_path=init_path,
         changelog_path=changelog_path,
     )
 
@@ -319,13 +317,13 @@ def publish_command(
         console.print("[red]Either --bump or --version is required[/red]")
         raise typer.Exit(1)
 
-    pyproject_path, init_path, changelog_path = _find_project_paths(project)
+    pyproject_path, changelog_path = _find_project_paths(project)
+    init_path = project / "src" / "raise_cli" / "__init__.py"
 
     if not skip_check:
         results = run_checks(
             project_root=project,
             pyproject_path=pyproject_path,
-            init_path=init_path,
             changelog_path=changelog_path,
         )
         all_passed = _display_results(results)

{raise_cli-2.4.0 → raise_cli-2.4.1}/src/raise_cli/cli/commands/session.py

@@ -627,6 +627,12 @@ def close(  # noqa: C901
             summary=summary or "",
             session_type=session_type or "feature",
         )
+        typer.echo(
+            "Warning: --summary close captures only a summary. "
+            "For full session continuity (narrative, patterns, next-session prompt), "
+            "use the /rai-session-close skill instead.",
+            err=True,
+        )
 
     # Coherence validation: reject if state file session_id
     # doesn't match the target session. Prevents race condition where

{raise_cli-2.4.0 → raise_cli-2.4.1}/src/raise_cli/cli/main.py

@@ -20,13 +20,12 @@ from raise_cli.cli.commands.doctor import doctor_app
 from raise_cli.cli.commands.gate import gate_app
 from raise_cli.cli.commands.graph import graph_app
 from raise_cli.cli.commands.info import info_command
-from raise_cli.cli.commands.init import init_command
+from raise_cli.cli.commands.init import init_command, upgrade_command
 from raise_cli.cli.commands.learn import learn_app
 from raise_cli.cli.commands.mcp import mcp_app
 from raise_cli.cli.commands.memory import memory_app
 from raise_cli.cli.commands.pattern import pattern_app
 from raise_cli.cli.commands.profile import profile_app
-from raise_cli.cli.commands.publish import publish_app
 from raise_cli.cli.commands.release import release_app
 from raise_cli.cli.commands.session import session_app
 from raise_cli.cli.commands.signal import signal_app
@@ -69,7 +68,6 @@ app.add_typer(mcp_app, name="mcp")
 app.add_typer(memory_app, name="memory")
 app.add_typer(pattern_app, name="pattern")
 app.add_typer(profile_app, name="profile")
-app.add_typer(publish_app, name="publish")
 app.add_typer(release_app, name="release")
 app.add_typer(session_app, name="session")
 app.add_typer(signal_app, name="signal")
@@ -78,6 +76,7 @@ app.add_typer(skill_app, name="skill")
 # Register standalone commands
 app.command("info")(info_command)
 app.command("init")(init_command)
+app.command("upgrade")(upgrade_command)
 
 # Register CLI extensions from external packages
 discover_cli_extensions(app)

raise_cli-2.4.1/src/raise_cli/hooks/builtin/memory.py

@@ -0,0 +1,38 @@
+"""Built-in MemoryMdSyncHook — DISABLED.
+
+Previously regenerated MEMORY.md after graph build. Disabled because
+MEMORY.md is owned by Claude Code's auto-memory system (see RAISE-1459).
+
+CLAUDE.md (user-managed) is the correct place for always-on context.
+MEMORY.md and memory/*.md are Claude-managed auto-memory files.
+
+Architecture: E1132 Wave 4, CC source memoryFileDetection.ts:127-131.
+"""
+
+from __future__ import annotations
+
+import logging
+from typing import ClassVar
+
+from raise_cli.hooks.events import HookEvent, HookResult
+
+logger = logging.getLogger(__name__)
+
+
+class MemoryMdSyncHook:
+    """DISABLED — MEMORY.md is owned by Claude auto-memory.
+
+    Kept as a stub to avoid import errors from any code that references
+    this class. The entry point has been removed from pyproject.toml
+    so this hook is never discovered or invoked by the hook system.
+
+    See: RAISE-1459, E1132 Wave 4 (CC reverse engineering)
+    """
+
+    events: ClassVar[list[str]] = ["graph:build"]
+    priority: ClassVar[int] = 0
+
+    def handle(self, event: HookEvent) -> HookResult:
+        """No-op. Returns ok without writing any files."""
+        logger.debug("MemoryMdSyncHook disabled (RAISE-1459)")
+        return HookResult(status="ok", message="disabled — MEMORY.md owned by Claude auto-memory")