omninode-intelligence 0.17.0__tar.gz → 0.18.0__tar.gz

{omninode_intelligence-0.17.0 → omninode_intelligence-0.18.0}/.github/workflows/omni-standards-compliance.yml

@@ -16,7 +16,7 @@ env:
   UV_VERSION: "0.8.3"
   REPO_NAME: "omniintelligence"
 
-# ci-health-ok: blocking mypy already enforced in ci.yaml type-check job (scoped to tools/utils/runtime)
+# ci-health-ok: blocking mypy already enforced in ci.yml type-check job (scoped to tools/utils/runtime)
 
 jobs:
   type-union-check:
@@ -50,3 +50,29 @@ jobs:
 
       - name: Check for Optional/Union usage (PEP 604)
         run: uv run ruff check src/ --select UP007,UP006
+
+  ci-naming-convention:
+    name: CI Naming Convention
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v6
+
+      - name: Verify CI workflow naming convention
+        run: |
+          if [ ! -f .github/workflows/ci.yml ]; then
+            echo "::error::Missing .github/workflows/ci.yml"
+            exit 1
+          fi
+          CI_NAME=$(grep -m1 "^name:" .github/workflows/ci.yml | sed "s/name: *//" | tr -d "'\"")
+          if [ "$CI_NAME" != "CI" ]; then
+            echo "::error::ci.yml has name '$CI_NAME' — must be 'CI'"
+            exit 1
+          fi
+          for legacy in test.yml ci.yaml; do
+            if [ -f ".github/workflows/$legacy" ]; then
+              echo "::error::Legacy workflow .github/workflows/$legacy exists"
+              exit 1
+            fi
+          done
+          echo "CI naming convention: PASS"

{omninode_intelligence-0.17.0 → omninode_intelligence-0.18.0}/CHANGELOG.md

@@ -1,3 +1,21 @@
+## v0.18.0 (2026-03-25)
+
+### Added
+- feat: wire model_selector DecisionEmitter into dispatch engine [OMN-6595] (#467)
+- feat: register review_pairing node package for topic discovery [OMN-6593] (#466)
+- feat(runtime): wire orchestrator, reducer, and CI nodes into dispatch engine [OMN-6590][OMN-6594][OMN-6598] (#470)
+- feat: add review_pairing PairingEngine to intelligence handler specs [OMN-6591] (#464)
+
+### Fixed
+- fix: add code_entities and code_relationships to schema manifest [OMN-5669] (#468)
+- fix: add relevance filters to file access pattern extraction [OMN-6566] (#465)
+- fix: correct stale DATABASE_URL default to omniintelligence database [OMN-6427] (#463)
+
+### Changed
+- feat(projection): truncate pattern_signature to 512 chars in projection snapshots [OMN-6341] (#461)
+- chore(deps): bump omnibase-core to 0.32.0, omnibase-infra to 0.27.0 (coordinated release)
+- chore(deps): bump omnibase_core to 0.31.0 (#462)
+
 ## v0.17.0 (2026-03-24)
 
 ### Added

{omninode_intelligence-0.17.0 → omninode_intelligence-0.18.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: omninode-intelligence
-Version: 0.17.0
+Version: 0.18.0
 Summary: Intelligence, indexing, and pattern services as first-class Omninode nodes
 Project-URL: Homepage, https://github.com/OmniNode-ai/omniintelligence
 Project-URL: Repository, https://github.com/OmniNode-ai/omniintelligence
@@ -15,7 +15,7 @@ Requires-Python: <4.0,>=3.12
 Requires-Dist: adaptive-classifier>=0.1.2
 Requires-Dist: confluent-kafka<3.0.0,>=2.12.0
 Requires-Dist: httpx>=0.28.1
-Requires-Dist: omnibase-infra==0.24.1
+Requires-Dist: omnibase-infra==0.27.0
 Requires-Dist: pydantic-settings<3.0.0,>=2.7.0
 Requires-Dist: pydantic<3.0.0,>=2.12.5
 Requires-Dist: python-dotenv>=1.0.0

{omninode_intelligence-0.17.0 → omninode_intelligence-0.18.0}/deployment/docker/docker-compose.nodes.yml

@@ -42,8 +42,8 @@ services:
       dockerfile: deployment/docker/Dockerfile.reducer
     container_name: omni-intelligence-reducer
     environment:
-      # Database Configuration — points to omnibase_infra postgres
-      DATABASE_URL: ${DATABASE_URL:-postgresql://postgres:${POSTGRES_PASSWORD}@omnibase-infra-postgres:5432/omnibase_infra}
+      # Database Configuration — points to omniintelligence database
+      DATABASE_URL: ${OMNIINTELLIGENCE_DB_URL:-postgresql://postgres:${POSTGRES_PASSWORD}@omnibase-infra-postgres:5432/omniintelligence}
 
       # Reducer Configuration
       ENABLE_LEASE_MANAGEMENT: ${ENABLE_LEASE_MANAGEMENT:-true}

{omninode_intelligence-0.17.0 → omninode_intelligence-0.18.0}/pyproject.toml

@@ -17,7 +17,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "omninode-intelligence"
-version = "0.17.0"
+version = "0.18.0"
 description = "Intelligence, indexing, and pattern services as first-class Omninode nodes"
 readme = "README.md"
 requires-python = ">=3.12,<4.0"
@@ -35,7 +35,7 @@ dependencies = [
     "tenacity>=8.2.0",
     "watchdog>=6.0.0",
     "adaptive-classifier>=0.1.2",
-    "omnibase-infra==0.24.1",
+    "omnibase-infra==0.27.0",
 ]
 
 [project.optional-dependencies]
@@ -92,9 +92,9 @@ core = [
     # ONEX private ecosystem dependencies (NOT on public PyPI)
     # Installed via editable installs from sibling repos or private registry.
     # Version bounds match Poetry caret syntax above.
-    "omnibase-core>=0.30.1",
+    "omnibase-core==0.32.0",
     "omnibase-spi==0.19.1",
-    "omnibase-infra==0.24.1",
+    "omnibase-infra==0.27.0",
     "pydantic>=2.12.5,<3.0.0",
     "pydantic-settings>=2.7.0,<3.0.0",
     # Web framework for API endpoints
@@ -360,6 +360,6 @@ markers = [
 [tool.uv]
 # Override omnibase-infra's transitive pins on core/spi so our direct pins win.
 override-dependencies = [
-    "omnibase-core>=0.30.2",
+    "omnibase-core==0.32.0",
     "omnibase-spi==0.19.1",
 ]

{omninode_intelligence-0.17.0 → omninode_intelligence-0.18.0}/scripts/validate_ci_precommit_alignment.py

@@ -4,7 +4,7 @@
 
 """Validate alignment between CI path filters and pre-commit hook patterns.
 
-This script ensures that the CI workflow path filters (.github/workflows/ci.yaml)
+This script ensures that the CI workflow path filters (.github/workflows/ci.yml)
 stay synchronized with pre-commit hook file patterns (.pre-commit-config.yaml).
 
 SYNCHRONIZATION STRATEGY:
@@ -35,7 +35,7 @@ ADDING A NEW MODULE:
 When adding a new source directory, update ALIGNED_SOURCE_DIRS below,
 then run this script. It will report any drift in CI or pre-commit configs.
 
-See .github/workflows/ci.yaml header for complete checklist of files to update.
+See .github/workflows/ci.yml header for complete checklist of files to update.
 
 Usage:
     uv run python scripts/validate_ci_precommit_alignment.py
@@ -71,7 +71,7 @@ logger = logging.getLogger(__name__)
 REPO_ROOT = Path(__file__).parent.parent
 
 # Configuration files to validate
-CI_WORKFLOW_PATH = REPO_ROOT / ".github" / "workflows" / "ci.yaml"
+CI_WORKFLOW_PATH = REPO_ROOT / ".github" / "workflows" / "ci.yml"
 PRECOMMIT_CONFIG_PATH = REPO_ROOT / ".pre-commit-config.yaml"
 
 # =============================================================================
@@ -748,7 +748,7 @@ def format_result(result: ValidationResult, output_json: bool = False) -> str:
                 lines.append(f"  - {path}")
         lines.append("")
         lines.append("Action required: Update both files to maintain synchronization.")
-        lines.append("See .pre-commit-config.yaml and .github/workflows/ci.yaml")
+        lines.append("See .pre-commit-config.yaml and .github/workflows/ci.yml")
 
     # Mypy cache validation section
     lines.append("")
@@ -784,7 +784,7 @@ def format_result(result: ValidationResult, output_json: bool = False) -> str:
                 lines.append(f"  - {dir_name}")
         lines.append("")
         lines.append(
-            "Action: Update mypy cache hashFiles patterns in .github/workflows/ci.yaml"
+            "Action: Update mypy cache hashFiles patterns in .github/workflows/ci.yml"
         )
         lines.append(
             "        to match the mypy command scope (~line 309 and ~line 319)"

{omninode_intelligence-0.17.0 → omninode_intelligence-0.18.0}/src/omniintelligence/audit/README.md

@@ -438,7 +438,7 @@ repos:
 
 ### GitHub Actions
 
-Add to your CI workflow (`.github/workflows/ci.yaml`):
+Add to your CI workflow (`.github/workflows/ci.yml`):
 
 ```yaml
 jobs:

{omninode_intelligence-0.17.0 → omninode_intelligence-0.18.0}/src/omniintelligence/nodes/node_pattern_extraction_compute/handlers/handler_file_patterns.py

@@ -25,15 +25,17 @@ ONEX Compliance:
 
 Algorithm:
     1. Iterate through all sessions, extracting files_accessed and files_modified
-    2. Track file co-occurrences within each session
-    3. Compute pattern confidence based on occurrence frequency
-    4. Filter patterns by minimum occurrence and confidence thresholds
+    2. Filter out common/excluded files and apply per-session pair cap
+    3. Track file co-occurrences within each session (skip same-directory pairs)
+    4. Compute pattern confidence based on occurrence frequency
+    5. Filter patterns by minimum occurrence and confidence thresholds
 """
 
 from __future__ import annotations
 
 from collections import Counter, defaultdict
 from collections.abc import Sequence
+from pathlib import PurePosixPath
 from typing import TYPE_CHECKING
 from uuid import uuid4
 
@@ -56,10 +58,63 @@ CO_ACCESS_SIGNIFICANCE_FACTOR = 0.5
 MODIFICATION_CLUSTER_SIGNIFICANCE_FACTOR = 0.3
 """Modification clusters: occurrence in 30% of sessions is significant (rarer pattern)."""
 
+# --- Relevance filters (OMN-6566) ---
+
+COMMON_FILE_EXCLUSIONS: frozenset[str] = frozenset(
+    {
+        "CLAUDE.md",
+        "pyproject.toml",
+        "setup.cfg",
+        "conftest.py",
+        "__init__.py",
+        ".gitignore",
+        "README.md",
+        "CHANGELOG.md",
+        "Makefile",
+        ".env",
+        "uv.lock",
+        "package.json",
+        "package-lock.json",
+    }
+)
+"""Files that appear in nearly every session but provide zero signal for patterns."""
+
+MAX_FILES_PER_SESSION_FOR_PAIRS: int = 10
+"""Cap on unique files per session before generating pairs.
+
+A session touching 20 files generates C(20,2) = 190 pairs. Capping at 10
+limits this to C(10,2) = 45, preventing O(n^2) blowup from large sessions.
+"""
+
+
+def _is_excluded_file(path: str) -> bool:
+    """Check if a file path's basename matches the common file exclusion list."""
+    return PurePosixPath(path).name in COMMON_FILE_EXCLUSIONS
+
+
+def _same_directory(f1: str, f2: str) -> bool:
+    """Check if two file paths share the same parent directory."""
+    return PurePosixPath(f1).parent == PurePosixPath(f2).parent
+
+
+def _filter_and_cap(
+    files: list[str],
+    cap: int = MAX_FILES_PER_SESSION_FOR_PAIRS,
+) -> list[str]:
+    """Filter excluded files and cap the list for pair generation.
+
+    Sorts by path for deterministic selection when cap is applied.
+    """
+    filtered = [f for f in files if not _is_excluded_file(f)]
+    if len(filtered) > cap:
+        filtered.sort()
+        filtered = filtered[:cap]
+    return filtered
+
 
 def extract_file_access_patterns(
     sessions: Sequence[ModelSessionSnapshot],
-    min_occurrences: int = 2,
+    min_occurrences: int = 5,
     min_confidence: float = 0.6,
     min_distinct_sessions: int = 2,  # noqa: ARG001 - Unused, for uniform interface
     max_results_per_type: int = 20,  # noqa: ARG001 - Unused, for uniform interface
@@ -77,13 +132,18 @@ def extract_file_access_patterns(
         2. Entry points: Files accessed first in sessions (common starting points).
         3. Modification clusters: Files modified together in the same session.
 
+    Relevance filters applied (OMN-6566):
+        - Common files (CLAUDE.md, pyproject.toml, etc.) are excluded by basename
+        - Same-directory file pairs are excluded (trivially co-accessed)
+        - Per-session pair count is capped at MAX_FILES_PER_SESSION_FOR_PAIRS
+
     Args:
         sessions: Session snapshots to analyze. Each session should have:
             - session_id (str): Unique session identifier
             - files_accessed (tuple[str, ...]): Files read during the session
             - files_modified (tuple[str, ...]): Files modified during the session
         min_occurrences: Minimum times a pattern must occur to be included.
-            Default is 2 to filter out one-off coincidences.
+            Default is 5 to filter out low-signal coincidences.
         min_confidence: Minimum confidence threshold (0.0-1.0) for patterns.
             Default is 0.6 to ensure statistical significance.
 
@@ -126,14 +186,18 @@ def extract_file_access_patterns(
         session_files[session_id] = all_session_files
 
         # Track entry points (first file accessed in session)
-        if files_accessed:
+        # Skip if the first file is a common excluded file
+        if files_accessed and not _is_excluded_file(files_accessed[0]):
             entry_points[files_accessed[0]] += 1
 
         # Track co-access pairs (files accessed together)
         # Use dict.fromkeys to preserve order while removing duplicates
         unique_accessed = list(dict.fromkeys(files_accessed))
+        unique_accessed = _filter_and_cap(unique_accessed)
         for i, f1 in enumerate(unique_accessed):
             for f2 in unique_accessed[i + 1 :]:
+                if _same_directory(f1, f2):
+                    continue
                 # Sort pair to ensure consistent key regardless of access order
                 sorted_files = sorted([f1, f2])
                 pair: tuple[str, str] = (sorted_files[0], sorted_files[1])
@@ -141,8 +205,11 @@ def extract_file_access_patterns(
 
         # Track modification clusters (files modified together)
         unique_modified = list(dict.fromkeys(files_modified))
+        unique_modified = _filter_and_cap(unique_modified)
         for i, f1 in enumerate(unique_modified):
             for f2 in unique_modified[i + 1 :]:
+                if _same_directory(f1, f2):
+                    continue
                 sorted_files = sorted([f1, f2])
                 pair = (sorted_files[0], sorted_files[1])
                 modification_pairs[pair] += 1

{omninode_intelligence-0.17.0 → omninode_intelligence-0.18.0}/src/omniintelligence/nodes/node_pattern_projection_effect/contract.yaml

@@ -69,7 +69,10 @@ handler_routing:
 # =============================================================================
 io_operations:
   - operation: "publish_projection"
-    description: "Query all validated/provisional patterns and publish a projection snapshot"
+    description: >
+      Query all validated/provisional patterns (with pattern_signature truncated to 512 chars) and publish
+      a projection snapshot. Uses query_patterns_projection SQL operation to keep Kafka messages bounded
+      while preserving pattern_signature for downstream consumers.
     input_fields:
       - correlation_id
       - trigger_event_type
@@ -162,8 +165,10 @@ event_bus:
   publish_topic_metadata:
     "onex.evt.omniintelligence.pattern-projection.v1":
       schema_ref: "omniintelligence.models.events.model_pattern_projection_event.ModelPatternProjectionEvent"
-      description: "Materialized snapshot of all validated/provisional patterns for downstream consumers"
-
+      description: >
+        Materialized snapshot of all validated/provisional patterns for downstream consumers. pattern_signature
+        is truncated to 512 chars to stay within Kafka message size limits (OMN-6341). Consumers needing
+        full signatures should query the REST API. #magic___^_^___line
 # =============================================================================
 # CAPABILITIES
 # =============================================================================
@@ -198,3 +203,6 @@ metadata:
     - ticket: "OMN-2355"
       url: "https://linear.app/omninode/issue/OMN-2355"
       description: "HTTP API escape hatch superseded by this node"
+    - ticket: "OMN-6341"
+      url: "https://linear.app/omninode/issue/OMN-6341"
+      description: "Kafka MessageSizeTooLarge fix — truncated pattern_signature in projections"

{omninode_intelligence-0.17.0 → omninode_intelligence-0.18.0}/src/omniintelligence/nodes/node_pattern_projection_effect/handlers/handler_projection.py

@@ -123,9 +123,7 @@ async def publish_projection(
 
     while True:
         try:
-            raw_rows = await pattern_query_store.query_patterns(
-                domain=None,
-                language=None,
+            raw_rows = await pattern_query_store.query_patterns_projection(
                 min_confidence=_MIN_CONFIDENCE,
                 limit=_QUERY_LIMIT,
                 offset=offset,

{omninode_intelligence-0.17.0 → omninode_intelligence-0.18.0}/src/omniintelligence/nodes/node_pattern_projection_effect/node_tests/conftest.py

@@ -72,6 +72,30 @@ class MockPatternQueryStore:
         # Simulate pagination
         return self.rows[offset : offset + limit]
 
+    async def query_patterns_projection(
+        self,
+        *,
+        min_confidence: float,
+        limit: int,
+        offset: int,
+    ) -> list[dict[str, Any]]:
+        """Return a page of rows for projection (truncated pattern_signature).
+
+        Delegates to the same backing rows as query_patterns. In tests, the
+        row data is already short so truncation is a no-op.
+        """
+        self.query_calls.append(
+            {
+                "min_confidence": min_confidence,
+                "limit": limit,
+                "offset": offset,
+            }
+        )
+        if self.simulate_error is not None:
+            raise self.simulate_error
+
+        return self.rows[offset : offset + limit]
+
     def reset(self) -> None:
         """Reset all state for test isolation."""
         self.rows.clear()

{omninode_intelligence-0.17.0 → omninode_intelligence-0.18.0}/src/omniintelligence/protocols/__init__.py

@@ -200,6 +200,22 @@ class ProtocolPatternQueryStore(Protocol):
         """Query validated/provisional patterns with optional filters."""
         ...
 
+    async def query_patterns_projection(
+        self,
+        *,
+        min_confidence: float,
+        limit: int,
+        offset: int,
+    ) -> list[dict[str, Any]]:  # any-ok: raw asyncpg row dicts from DB
+        """Query patterns for projection snapshot (truncated pattern_signature).
+
+        Returns patterns with pattern_signature truncated to 512 chars to keep
+        Kafka messages bounded. Used by NodePatternProjectionEffect.
+
+        Reference: OMN-6341
+        """
+        ...
+
 
 @runtime_checkable
 class ProtocolDecisionRecordRepository(Protocol):

{omninode_intelligence-0.17.0 → omninode_intelligence-0.18.0}/src/omniintelligence/repositories/adapter_pattern_store.py

@@ -531,6 +531,36 @@ class AdapterPatternStore:
             return []
         return [result]
 
+    async def query_patterns_projection(
+        self,
+        *,
+        min_confidence: float = 0.7,
+        limit: int = 50,
+        offset: int = 0,
+    ) -> list[dict[str, Any]]:
+        """Query patterns for projection snapshot with truncated pattern_signature.
+
+        Returns patterns with pattern_signature truncated to 512 chars to keep
+        Kafka messages bounded while preserving the field for downstream consumers.
+
+        Reference: OMN-6341 (Kafka MessageSizeTooLarge fix)
+        """
+        args = self._build_positional_args(
+            "query_patterns_projection",
+            {
+                "min_confidence": min_confidence,
+                "limit": limit,
+                "offset": offset,
+            },
+        )
+        result = await self._runtime.call("query_patterns_projection", *args)
+
+        if isinstance(result, list):
+            return result
+        if result is None:
+            return []
+        return [result]
+
     async def store_with_version_transition(
         self,
         *,

{omninode_intelligence-0.17.0 → omninode_intelligence-0.18.0}/src/omniintelligence/repositories/learned_patterns.repository.yaml

@@ -389,6 +389,64 @@ db_repository:
         model_ref: PatternSummary
         many: true
 
+    # -------------------------------------------------------------------------
+    # READ: Projection query (truncated pattern_signature for Kafka snapshots)
+    # -------------------------------------------------------------------------
+    # Projection query: truncates pattern_signature to 512 chars for Kafka snapshot.
+    # Used by NodePatternProjectionEffect to build ModelPatternProjectionEvent
+    # without exceeding Kafka message size limits.
+    # pattern_signature is kept (truncated) because omniclaude consumers depend on it.
+    # Reference: OMN-6341 (Kafka MessageSizeTooLarge fix)
+    query_patterns_projection:
+      mode: read
+      description: |
+        Query patterns for projection snapshot with truncated pattern_signature.
+        Returns metadata fields plus LEFT(pattern_signature, 512) to keep
+        Kafka messages bounded while preserving the field for downstream consumers.
+      sql: |
+        SELECT
+          id,
+          LEFT(pattern_signature, 512) AS pattern_signature,
+          signature_hash,
+          domain_id,
+          project_scope,
+          quality_score,
+          confidence,
+          status,
+          is_current,
+          version,
+          created_at
+        FROM learned_patterns
+        WHERE status IN ('validated', 'provisional')
+          AND is_current = TRUE
+          AND confidence >= $1
+        ORDER BY
+          CASE WHEN status = 'validated' THEN 0 ELSE 1 END,
+          confidence DESC,
+          id ASC
+        LIMIT $2
+        OFFSET $3
+      param_order:
+        - min_confidence
+        - limit
+        - offset
+      params:
+        min_confidence:
+          name: min_confidence
+          param_type: float
+          description: Minimum confidence threshold
+        limit:
+          name: limit
+          param_type: integer
+          description: Maximum rows per page
+        offset:
+          name: offset
+          param_type: integer
+          description: Row offset for pagination
+      returns:
+        model_ref: PatternSummary
+        many: true
+
     # -------------------------------------------------------------------------
     # READ: Get promotion candidates
     # -------------------------------------------------------------------------

{omninode_intelligence-0.17.0 → omninode_intelligence-0.18.0}/src/omniintelligence/review_pairing/adapters/adapter_ai_reviewer.py

@@ -104,19 +104,26 @@ def build_review_prompt(
     plan_content: str,
     *,
     review_type: str = "plan",
+    system_prompt_prefix: str | None = None,
 ) -> tuple[str, str]:
     """Construct system and user prompts for adversarial review.
 
     Args:
         plan_content: Raw content to review (plan text or PR diff).
         review_type: "plan" for plan/design review, "pr" for PR diff review.
+        system_prompt_prefix: Optional content to prepend to the system prompt.
+            When provided (e.g., a persona), it is prepended with a separator.
 
     Returns:
         Tuple of (system_prompt, user_prompt).
     """
     template = USER_PROMPT_TEMPLATE_PR if review_type == "pr" else USER_PROMPT_TEMPLATE
     user_prompt = template.format(plan_content=plan_content)
-    return SYSTEM_PROMPT, user_prompt
+    if system_prompt_prefix:
+        system_prompt = f"{system_prompt_prefix}\n\n---\n\n{SYSTEM_PROMPT}"
+    else:
+        system_prompt = SYSTEM_PROMPT
+    return system_prompt, user_prompt
 
 
 def _resolve_model_url(model_key: str) -> str:
@@ -234,7 +241,7 @@ def parse_review_response(raw_text: str) -> list[dict[str, Any]]:
     try:
         parsed = json.loads(text)
         if isinstance(parsed, list):
-            return parsed  # type: ignore[no-any-return]
+            return parsed
         logger.warning("Parsed JSON is not a list; got %s", type(parsed).__name__)
         return []
     except json.JSONDecodeError:
@@ -246,7 +253,7 @@ def parse_review_response(raw_text: str) -> list[dict[str, Any]]:
         try:
             parsed = json.loads(fence_match.group(1).strip())
             if isinstance(parsed, list):
-                return parsed  # type: ignore[no-any-return]
+                return parsed
         except json.JSONDecodeError:
             logger.debug("Fenced block was not valid JSON, trying bracket extraction")
 
@@ -256,7 +263,7 @@ def parse_review_response(raw_text: str) -> list[dict[str, Any]]:
         try:
             parsed = json.loads(bracket_match.group(0))
             if isinstance(parsed, list):
-                return parsed  # type: ignore[no-any-return]
+                return parsed
         except json.JSONDecodeError:
             logger.debug("Bracket-extracted text was not valid JSON")
 
@@ -285,7 +292,7 @@ def map_severity(raw_severity: str) -> FindingSeverity:
 
 
 def to_review_findings(
-    parsed: list[dict[str, Any]],
+    parsed: list[Any],
     model_key: str,
     *,
     repo: str = "plan-review",
@@ -412,6 +419,7 @@ async def async_parse_raw(
     repo: str = "plan-review",
     pr_id: int = 0,
     commit_sha: str = "0000000",
+    system_prompt_prefix: str | None = None,
 ) -> ModelExternalReviewResult:
     """Full review transaction: prompt, call, parse, convert.
 
@@ -428,6 +436,8 @@ async def async_parse_raw(
         repo: Repository slug.
         pr_id: Pull request number.
         commit_sha: Commit SHA.
+        system_prompt_prefix: Optional content to prepend to the system prompt
+            (e.g., persona content). When set, prepended with a separator.
 
     Returns:
         ModelExternalReviewResult with review findings or error.
@@ -438,6 +448,7 @@ async def async_parse_raw(
         system_prompt, user_prompt = build_review_prompt(
             plan_content,
             review_type=review_type,
+            system_prompt_prefix=system_prompt_prefix,
         )
         raw_text = await call_model(system_prompt, user_prompt, model_key=model)
         parsed = parse_review_response(raw_text)