raise-cli 3.1.4__tar.gz → 3.1.5__tar.gz

{raise_cli-3.1.4 → raise_cli-3.1.5}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: raise-cli
-Version: 3.1.4
+Version: 3.1.5
 Summary: RaiSE CLI - Reliable AI Software Engineering governance framework
 Project-URL: Homepage, https://raiseframework.ai
 Project-URL: Documentation, https://docs.raiseframework.ai
@@ -33,7 +33,7 @@ Requires-Dist: pydantic>=2.6.0
 Requires-Dist: python-dotenv>=1.0.0
 Requires-Dist: pyyaml>=6.0.1
 Requires-Dist: qrcode>=8.2
-Requires-Dist: raise-core==3.1.4
+Requires-Dist: raise-core==3.1.5
 Requires-Dist: rich>=13.7.0
 Requires-Dist: ruamel-yaml>=0.18
 Requires-Dist: textual>=0.89.0

{raise_cli-3.1.4 → raise_cli-3.1.5}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "raise-cli"
-version = "3.1.4"
+version = "3.1.5"
 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==3.1.4",
+    "raise-core==3.1.5",
     "typer>=0.12.0",
     "rich>=13.7.0",
     "pydantic>=2.6.0",

{raise_cli-3.1.4 → raise_cli-3.1.5}/src/raise_cli/adapters/filesystem_docs.py

@@ -61,7 +61,9 @@ class FilesystemDocsTarget:
             return error
         path = self._root / raw_path
         path.parent.mkdir(parents=True, exist_ok=True)
-        path.write_text(content)
+        path.write_text(
+            content, encoding="utf-8"
+        )  # RAISE-17565: explícito, independiente del locale del OS
         return PublishResult(
             success=True, url=str(path), message="Written to filesystem"
         )

{raise_cli-3.1.4 → raise_cli-3.1.5}/src/raise_cli/cli/commands/graph.py

@@ -167,6 +167,8 @@ def _parse_query_strategy(strategy: str | None) -> QueryStrategy:
         return QueryStrategy.KEYWORD_SEARCH
     if strategy == "semantic":
         return QueryStrategy.SEMANTIC_LOCAL
+    if strategy == "keyword":  # backwards-compat alias — RAISE-18713
+        return QueryStrategy.KEYWORD_SEARCH
     try:
         return QueryStrategy(strategy)
     except ValueError:
@@ -228,6 +230,8 @@ def _write_query_output(
     output_text: str,
     output: Path | None,
     result: object,
+    *,
+    is_json: bool = False,
 ) -> None:
     """Write query result to file or stdout with summary."""
     if output:
@@ -237,6 +241,10 @@ def _write_query_output(
         console.print(f"  Concepts: {meta.total_concepts}")
         console.print(f"  Tokens: ~{meta.token_estimate}")
         console.print(f"  Execution: {meta.execution_time_ms:.2f}ms\n")
+    elif is_json:
+        # RAISE-17940: Rich console.print() word-wraps long lines, inserting
+        # raw 0x0A bytes inside JSON string values — use plain print() instead.
+        print(output_text)  # noqa: T201
     else:
         console.print(output_text)
 
@@ -598,7 +606,9 @@ def query(  # noqa: C901
                     output_text = format_compact(result, full=full)
                 else:
                     output_text = format_markdown(result, full=full)
-                _write_query_output(output_text, output, result)
+                _write_query_output(
+                    output_text, output, result, is_json=(format == "json")
+                )
                 return
         except httpx.HTTPStatusError as exc:
             _warn_msg = (
@@ -654,7 +664,7 @@ def query(  # noqa: C901
         depth_expand=depth_expand,
     )
 
-    if format != "agent":
+    if format not in ("agent", "json"):
         console.print(f"\nQuerying memory for: [cyan]{query_str}[/cyan]")
         if query_strategy == QueryStrategy.KEYWORD_SEARCH_FORCED:
             console.print(
@@ -701,7 +711,7 @@ def query(  # noqa: C901
     else:
         output_text = format_markdown(result, full=full)
 
-    _write_query_output(output_text, output, result)
+    _write_query_output(output_text, output, result, is_json=(format == "json"))
 
 
 # =============================================================================
@@ -1899,6 +1909,9 @@ def build(
 
     # Auto-embed cartridges for hybrid retrieval (S9795.7)
     _auto_embed_all_cartridges(Path.cwd() / ".raise" / "cartridges")
+    _auto_embed_all_cartridges(
+        Path.home() / ".rai" / "cartridges"
+    )  # RAISE-18708: global path
 
     # Auto-embed non-cartridge graph nodes (pattern/symbol/document) for
     # pure-semantic reachability (RAISE-16087)

{raise_cli-3.1.4 → raise_cli-3.1.5}/src/raise_cli/memory/memory_index.py

@@ -16,6 +16,9 @@ _logger = logging.getLogger(__name__)
 
 _FRONTMATTER_RE = re.compile(r"^---\s*\n(.*?)\n---", re.DOTALL)
 
+# Claude Code ceiling for MEMORY.md load (~24.4 KB) — RAISE-18712
+_MEMORY_MD_CEIL_BYTES = 24_400
+
 _HEADER = """\
 # Memory Index
 
@@ -134,6 +137,14 @@ def regenerate_memory_index(
         lines.append("")
 
     result = "\n".join(lines).rstrip() + "\n"
+    result_bytes = len(result.encode("utf-8"))  # RAISE-18712
+    if result_bytes > _MEMORY_MD_CEIL_BYTES:  # RAISE-18712
+        _logger.warning(  # RAISE-18712
+            "MEMORY.md exceeds Claude Code ceiling (%d > %d bytes). "
+            "Oldest entries may be truncated at load time.",
+            result_bytes,
+            _MEMORY_MD_CEIL_BYTES,
+        )
     memory_dir.mkdir(parents=True, exist_ok=True)
     memory_file = memory_dir / "MEMORY.md"
     if memory_file.exists():

{raise_cli-3.1.4 → raise_cli-3.1.5}/src/raise_cli/memory/writer.py

@@ -483,6 +483,9 @@ def append_pattern(
     )
 
 
+_SHORT_HASH_RE = re.compile(r"^[0-9a-f]{8}$", re.IGNORECASE)
+
+
 def _resolve_local_pattern_id(conn: sqlite3.Connection, pattern_id: str) -> str | None:
     """Resolve pattern_id, falling back to an original_id lookup.
 
@@ -494,12 +497,24 @@ def _resolve_local_pattern_id(conn: sqlite3.Connection, pattern_id: str) -> str
     `original_id` defaults to `''` for every unlinked local pattern, so an
     unguarded `WHERE original_id = ?` would match an arbitrary unlinked row
     for any other non-matching input (e.g. an empty string or typo).
+
+    Short-hash IDs (8 hex chars) from legacy tooling resolve via
+    content_hash prefix lookup (RAISE-18012).
     """
     row = conn.execute(
         "SELECT pattern_id FROM patterns WHERE pattern_id = ?", (pattern_id,)
     ).fetchone()
     if row is not None:
         return row[0]
+    # Legacy short-hash format: 8 hex chars → resolve via content_hash prefix
+    if _SHORT_HASH_RE.match(pattern_id):
+        row = conn.execute(
+            "SELECT pattern_id FROM patterns WHERE content_hash LIKE ? AND archived = 0 LIMIT 1",
+            (f"sha256:{pattern_id.lower()}%",),
+        ).fetchone()
+        if row is not None:
+            return row[0]
+        return None
     try:
         uuid.UUID(pattern_id)
     except ValueError:

{raise_cli-3.1.4 → raise_cli-3.1.5}/src/raise_cli/pipeline/mcp_tools_pattern.py

@@ -4,6 +4,7 @@ from __future__ import annotations
 
 import json
 import logging
+import re
 import sqlite3
 import uuid
 from pathlib import Path
@@ -192,6 +193,23 @@ def _is_local_pattern_id(pattern_id: str) -> bool:
     return False
 
 
+_SHORT_HASH_RE = re.compile(r"^[0-9a-f]{8}$", re.IGNORECASE)
+
+
+def _is_short_hash_id(pattern_id: str) -> bool:
+    """True when pattern_id is a legacy 8-char hex content-hash prefix (RAISE-18012)."""
+    return bool(_SHORT_HASH_RE.match(pattern_id))
+
+
+def _resolve_content_hash_id(conn: sqlite3.Connection, short_hash: str) -> str | None:
+    """Resolve a short-hash prefix to a local pattern_id via content_hash (RAISE-18012)."""
+    row = conn.execute(
+        "SELECT pattern_id FROM patterns WHERE content_hash LIKE ? AND archived = 0 LIMIT 1",
+        (f"sha256:{short_hash.lower()}%",),
+    ).fetchone()
+    return row[0] if row is not None else None
+
+
 def _get_local_conn_and_project_id(root: Path) -> tuple[sqlite3.Connection, str]:
     """Resolve the local project DB connection + canonical project_id.
 
@@ -279,7 +297,11 @@ async def raise_pattern_reinforce(
         conn, project_id = _get_local_conn_and_project_id(_root)
 
         if _is_local_pattern_id(pattern_id):
-            local_pattern_id = pattern_id
+            if _is_short_hash_id(pattern_id):
+                resolved = _resolve_content_hash_id(conn, pattern_id)
+                local_pattern_id = resolved if resolved is not None else pattern_id
+            else:
+                local_pattern_id = pattern_id
         else:
             local_pattern_id = _resolve_local_pattern_id(conn, pattern_id)
             if local_pattern_id is None:

{raise_cli-3.1.4 → raise_cli-3.1.5}/src/raise_cli/skills_base/rai-worktree-close/SKILL.md

@@ -247,7 +247,7 @@ worktree from within it.
 
 ```bash
 WORKTREE_PATH=$(pwd)
-MAIN_REPO=$(dirname $(git rev-parse --git-common-dir))
+MAIN_REPO=$(dirname "$(git rev-parse --git-common-dir)")
 ```
 
 Check if the remote branch still exists:
@@ -264,6 +264,27 @@ git ls-remote --exit-code origin "$BRANCH" &>/dev/null
 Execute cleanup:
 
 ```bash
+# Step 6a: Pre-clean — remove regenerable build artifacts (RAISE-17934)
+# -f=force, -d=include dirs, -X=gitignored files ONLY (safe, stack-agnostic:
+# covers .venv/, node_modules/, target/, __pycache__, etc.)
+# This prevents 'git worktree remove' from failing when pull --rebase (Step 3)
+# regenerates build artifacts inside the worktree directory.
+git -C "$WORKTREE_PATH" clean -fdX 2>/dev/null || true
+
+# Step 6b: Detect non-gitignored untracked files that would still block the remove
+UNTRACKED=$(git -C "$WORKTREE_PATH" status --porcelain 2>/dev/null | grep '^??')
+if [ -n "$UNTRACKED" ]; then
+    echo "⚠ Archivos no rastreados encontrados en el worktree:"
+    echo "$UNTRACKED"
+    echo ""
+    echo "Opciones:"
+    echo "  (a) Descartarlos: git -C \"$WORKTREE_PATH\" clean -fd && re-run"
+    echo "  (b) Cancelar para revisarlos manualmente"
+    # STOP — wait for developer decision before proceeding
+    exit 1
+fi
+
+# Step 6c: Remove worktree and delete local branch
 git -C "$MAIN_REPO" worktree remove "$WORKTREE_PATH"
 
 if git ls-remote --exit-code origin "$BRANCH" &>/dev/null; then
@@ -271,16 +292,26 @@ if git ls-remote --exit-code origin "$BRANCH" &>/dev/null; then
 else
     git -C "$MAIN_REPO" branch -D "$BRANCH"
 fi
+
+# Step 6d: Defensive fallback — paranoia for NFS/race-condition edge cases
+# In standard git, exit 0 from worktree remove means directory is gone.
+# This guard catches the rare case where it is not (RAISE-17934).
+if [ -d "$WORKTREE_PATH" ]; then
+    rm -rf "$WORKTREE_PATH"
+    git -C "$MAIN_REPO" worktree prune
+fi
 ```
 
 | Condition | Action |
 |-----------|--------|
 | `worktree remove` fails (uncommitted changes) | Stop — commit or stash changes first, then re-run |
+| `worktree remove` fails (non-gitignored untracked files) | Stop — Step 6b shows the list; choose (a) discard or (b) cancel |
 | `branch -d` fails (not fully merged, remote still exists) | Stop — MR not yet merged. Create MR first via `/rai-mr-create` |
 | Both succeed | Worktree closed and workspace cleaned |
 
 <verification>
 Worktree directory removed. Local branch deleted. No manual cleanup required.
+No orphaned directory left on disk under any circumstance.
 </verification>
 
 ## Output
@@ -297,6 +328,7 @@ Worktree directory removed. Local branch deleted. No manual cleanup required.
 - [ ] Registered worktree state is updated when available
 - [ ] Direct-flow close does not mutate DB state
 - [ ] MR creation is suggested, not forced
+- [ ] Disk clean confirmed: no orphaned worktree directory after removal (RAISE-17934)
 
 ## References
 

{raise_cli-3.1.4 → raise_cli-3.1.5}/src/raise_cli/telemetry/phase_map.py

@@ -19,6 +19,7 @@ PHASE_MAP: dict[str, dict[str, str]] = {
         # must be distinguishable from implement for flow/cost analysis.
         "architecture-review": "architecture-review",
         "quality-review": "quality-review",
+        "pre-submission": "review",  # RAISE-17911: pre-submission review maps to review phase
         "review": "review",
         "close": "close",
     },

{raise_cli-3.1.4 → raise_cli-3.1.5}/src/raise_cli/telemetry/schemas.py

@@ -364,7 +364,13 @@ class WorkLifecycle(BaseModel):
     )
     work_id: str = Field(..., description="Work item identifier (e.g., 'E9', 'F9.4')")
     event: Literal[
-        "start", "complete", "blocked", "unblocked", "abandoned", "ar-skip"
+        "start",
+        "complete",
+        "blocked",
+        "unblocked",
+        "abandoned",
+        "ar-skip",
+        "review_completed",  # RAISE-17605: pre-submission review (S17422.2)
     ] = Field(..., description="Lifecycle event type")
     phase: Literal[
         "init",