omninode-memory 0.7.2__tar.gz → 0.9.0__tar.gz

{omninode_memory-0.7.2 → omninode_memory-0.9.0}/.github/workflows/build-and-push-migrate-image.yml

@@ -24,8 +24,8 @@ jobs:
     runs-on: ubuntu-latest
     timeout-minutes: 15
     steps:
-      - uses: actions/checkout@v4
-      - uses: aws-actions/configure-aws-credentials@v4
+      - uses: actions/checkout@v6
+      - uses: aws-actions/configure-aws-credentials@v6
         with:
           role-to-assume: arn:aws:iam::${{ vars.AWS_ACCOUNT_ID }}:role/omninode-github-actions-role
           role-session-name: gha-build-migrate-omnimemory

omninode_memory-0.9.0/.github/workflows/omni-standards-compliance.yml

@@ -0,0 +1,52 @@
+# SPDX-FileCopyrightText: 2025 OmniNode.ai Inc.
+# SPDX-License-Identifier: MIT
+---
+name: Omni* Ecosystem Standards Compliance
+
+on:
+  push:
+    branches: [main, develop, "jonah/*", "jonahgabriel/*"]
+  pull_request:
+    branches: [main, develop]
+  merge_group:
+  workflow_dispatch:
+
+env:
+  PYTHON_VERSION: "3.12"
+  UV_VERSION: "0.8.3"
+  REPO_NAME: "omnimemory"
+
+# ci-health-ok: blocking mypy --strict already enforced in test.yml lint job
+
+jobs:
+  type-union-check:
+    name: PEP 604 Type Union Check (UP007)
+    # OMNINODE_SELF_HOSTED_RUNS_ON_V1 — do not edit inline; update plan + all occurrences together
+    runs-on: >-
+      ${{
+        (vars.USE_SELF_HOSTED_RUNNERS == 'true' &&
+         (github.event_name == 'push' ||
+          github.event_name == 'workflow_dispatch' ||
+          github.event_name == 'schedule'))
+        && fromJSON('["self-hosted","omnibase-ci"]')
+        || fromJSON('["ubuntu-latest"]')
+      }}
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v6
+
+      - name: Set up Python
+        uses: actions/setup-python@v6
+        with:
+          python-version: ${{ env.PYTHON_VERSION }}
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v7
+        with:
+          version: ${{ env.UV_VERSION }}
+
+      - name: Install dependencies
+        run: uv sync --all-extras
+
+      - name: Check for Optional/Union usage (PEP 604)
+        run: uv run ruff check src/ --select UP007,UP006

{omninode_memory-0.7.2 → omninode_memory-0.9.0}/.github/workflows/pre-commit.yml

@@ -23,6 +23,7 @@ jobs:
       #   - contract-linter  -> contract-validation job
       #   - io-audit         -> io-audit job
       #   - mypy             -> lint job (pre-push stage, not triggered here anyway)
+      #   - onex-validate-links -> requires uv (not available in pre-commit CI env)
       - uses: pre-commit/action@v3.0.1
         env:
-          SKIP: contract-linter,io-audit,check-ai-slop
+          SKIP: contract-linter,io-audit,check-ai-slop,onex-validate-links

{omninode_memory-0.7.2 → omninode_memory-0.9.0}/.github/workflows/release.yml

@@ -21,6 +21,8 @@ concurrency:
 jobs:
   release:
     runs-on: ubuntu-latest
+    outputs:
+      version: ${{ steps.tag.outputs.tag }}
     steps:
       - uses: actions/checkout@v6
         with:
@@ -99,3 +101,47 @@ jobs:
             dist/SHA256SUMS.txt
           generate_release_notes: true
           prerelease: ${{ contains(github.ref_name, 'rc') }}
+
+  # ---------------------------------------------------------------------------
+  # Post-release: trigger Dockerfile.runtime pin cascade (OMN-5137)
+  # ---------------------------------------------------------------------------
+  # When omnimemory is released, notify omnibase_infra so its
+  # plugin-pin-cascade workflow can bump Dockerfile.runtime pins automatically.
+  #
+  # REQUIREMENT: CROSS_REPO_PAT secret must be a GitHub PAT with `repo` scope
+  # on OmniNode-ai/omnibase_infra (same pattern as omnibase_infra's
+  # trigger-runtime-rebuild job).
+  notify-plugin-pin-cascade:
+    name: Notify Plugin Pin Cascade
+    needs: release
+    if: ${{ !contains(needs.release.outputs.version, 'rc') }}
+    runs-on: ubuntu-latest
+    steps:
+      - name: Check CROSS_REPO_PAT is configured
+        id: token_check
+        env:
+          CROSS_REPO_PAT: ${{ secrets.CROSS_REPO_PAT }}
+        run: |
+          if [ -z "$CROSS_REPO_PAT" ]; then
+            echo "::warning::CROSS_REPO_PAT secret is not set. Skipping cross-repo dispatch." \
+              "Set a PAT with 'repo' scope on OmniNode-ai/omnibase_infra" \
+              "as the CROSS_REPO_PAT repository secret to enable plugin pin cascade."
+            echo "has_token=false" >> "$GITHUB_OUTPUT"
+          else
+            echo "has_token=true" >> "$GITHUB_OUTPUT"
+          fi
+
+      - name: Dispatch plugin-release to omnibase_infra
+        if: steps.token_check.outputs.has_token == 'true'
+        uses: peter-evans/repository-dispatch@v4
+        with:
+          token: ${{ secrets.CROSS_REPO_PAT }}
+          repository: OmniNode-ai/omnibase_infra
+          event-type: plugin-release
+          client-payload: >-
+            {
+              "package": "omninode-memory",
+              "version": "${{ needs.release.outputs.version }}",
+              "source_repo": "${{ github.repository }}",
+              "source_sha": "${{ github.sha }}"
+            }

omninode_memory-0.9.0/.github/workflows/security-scan.yml

@@ -0,0 +1,29 @@
+# SPDX-FileCopyrightText: 2025 OmniNode.ai Inc.
+# SPDX-License-Identifier: MIT
+#
+# CodeQL security and quality analysis for omnimemory.
+# Calls the reusable workflow in onex_change_control.
+# OMN-5424
+
+name: Security Scan
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+  schedule:
+    # Run weekly on Monday at 06:00 UTC
+    - cron: "0 6 * * 1"
+
+jobs:
+  codeql:
+    name: CodeQL
+    uses: OmniNode-ai/onex_change_control/.github/workflows/codeql-reusable.yml@main
+    with:
+      language: python
+      query_suite: security-and-quality
+    permissions:
+      actions: read
+      contents: read
+      security-events: write

omninode_memory-0.9.0/.markdown-link-check.json

@@ -0,0 +1,17 @@
+{
+    "ignorePatterns": [
+        {"pattern": "^https://linear\\.app"},
+        {"pattern": "^https://github\\.com/OmniNode-ai"},
+        {"pattern": "^http://localhost"},
+        {"pattern": "^https://localhost"}
+    ],
+    "excludeFiles": [
+        ".pytest_cache/**",
+        ".venv/**",
+        "venv/**",
+        "node_modules/**",
+        "archived/**"
+    ],
+    "checkExternal": false,
+    "externalTimeout": 5000
+}

{omninode_memory-0.7.2 → omninode_memory-0.9.0}/.pre-commit-config.yaml

@@ -76,6 +76,16 @@
 #   pre-commit run --all-files --hook-stage pre-push  # Run pre-push hooks
 
 repos:
+  # No hardcoded ONEX topic strings — sourced from onex_change_control (OMN-5259)
+  - repo: https://github.com/OmniNode-ai/onex_change_control
+    rev: 39a09ffb2432b8b7d3f47b334b869b55c9cb4fc6  # pragma: allowlist secret
+    hooks:
+      - id: no-hardcoded-topics
+        # Pre-existing violations — pending migration to canonical topic constants
+        exclude: >-
+          ^src/omnimemory/nodes/(node_filesystem_crawler_effect|node_intent_event_consumer_effect|node_kreuzberg_parse_effect)/models/
+        stages: [pre-commit]
+
   # Stub implementation detection — sourced from omnibase_core (OMN-4472)
   - repo: https://github.com/OmniNode-ai/omnibase_core
     rev: 30a06f85bb5849902d33c8d0bdb90fc6cba0c346  # pragma: allowlist secret
@@ -158,7 +168,7 @@ repos:
       - id: mypy-type-check
         name: mypy (type checking - strict)
         # SYNCHRONIZED WITH CI: Identical to .github/workflows/test.yml lint job
-        entry: poetry run mypy --show-error-codes --no-error-summary src/omnimemory
+        entry: uv run mypy --show-error-codes --no-error-summary src/omnimemory
         language: system
         types: [python]
         pass_filenames: false
@@ -347,7 +357,7 @@ repos:
       - id: contract-linter
         name: ONEX Contract Linter
         description: Validates node contract YAML files. Requires Poetry (poetry install).
-        entry: poetry run python -m omnimemory.tools.contract_linter
+        entry: uv run python -m omnimemory.tools.contract_linter
         language: system
         pass_filenames: true
         # SYNC: CI uses `find src/omnimemory -name contract.yaml` with graceful
@@ -367,7 +377,7 @@ repos:
       - id: io-audit
         name: I/O Audit (ONEX node purity)
         description: Audits node purity for forbidden I/O. Requires Poetry (poetry install).
-        entry: poetry run python -m omnimemory.audit
+        entry: uv run python -m omnimemory.audit
         language: system
         pass_filenames: false
         types: [python]
@@ -470,6 +480,15 @@ repos:
         exclude: ^(archived/|archive/)
         stages: [pre-commit]
 
+      # Markdown link validation (OMN-5086) — uses onex-validate-links from omnibase_core
+      - id: onex-validate-links
+        name: Validate markdown links
+        entry: uv run onex-validate-links --verbose
+        language: system
+        types: [markdown]
+        pass_filenames: false
+        stages: [pre-commit]
+
 # Configuration
 default_install_hook_types: [pre-commit, pre-push]
 default_stages: [pre-commit]

omninode_memory-0.9.0/AGENT.md

@@ -0,0 +1,28 @@
+# AGENT.md -- omnimemory
+
+> LLM navigation guide. Points to context sources -- does not duplicate them.
+
+## Context
+
+- **Architecture**: `docs/architecture/`
+- **Stub status**: `docs/stub_protocols.md`
+- **PII handling**: `docs/pii_handling.md`
+- **Conventions**: `CLAUDE.md`
+
+## Commands
+
+- Tests: `uv run pytest -m unit`
+- Lint: `uv run ruff check src/ tests/`
+- Type check: `uv run mypy src/omnimemory/`
+- Pre-commit: `pre-commit run --all-files`
+
+## Cross-Repo
+
+- Shared platform standards: `~/.claude/CLAUDE.md`
+- Core models: `omnibase_core/CLAUDE.md`
+
+## Rules
+
+- Qdrant for vector storage, PostgreSQL for metadata
+- Document ingestion + semantic retrieval pipeline
+- PII detection required before storage

{omninode_memory-0.7.2 → omninode_memory-0.9.0}/CHANGELOG.md

@@ -1,3 +1,19 @@
+## v0.9.0 (2026-03-19)
+
+### Added
+- feat(ci): deploy CodeQL security scanning to omnimemory [OMN-5424] (#179)
+- feat: add onex.node_package entry point for contract discovery [OMN-5370] (#177)
+- feat: PluginMemory.should_activate() infers from OMNIMEMORY_MEMGRAPH_HOST [OMN-5359] (#175)
+- feat: infer OMNIMEMORY__POSTGRES_ENABLED and QDRANT_ENABLED from connection URLs [OMN-5362] (#176)
+
+### Fixed
+- fix: remove env_prefix topic prefixing from handlers [OMN-5214] (#171, #172)
+
+### Changed
+- ci(omnimemory): add ruff UP007 standards compliance workflow [OMN-5132] (#178)
+- chore: wire no-hardcoded-topics pre-commit hook [OMN-5259] (#174)
+- chore(deps): bump omnibase-core to 0.29.0, omnibase-spi to 0.18.0, omnibase-infra to 0.22.0
+
 ## v0.7.2 (2026-03-13)
 
 ### Other Changes

{omninode_memory-0.7.2 → omninode_memory-0.9.0}/CLAUDE.md

@@ -1,6 +1,6 @@
 # CLAUDE.md - OmniMemory
 
-> **Python**: 3.12+ | **Framework**: ONEX 4.0 | **Package Manager**: Poetry | **Shared Standards**: See **`~/.claude/CLAUDE.md`** for shared development standards (Python, Git, testing, architecture principles) and infrastructure configuration (PostgreSQL, Kafka/Redpanda, Docker networking, environment variables).
+> **Python**: 3.12+ | **Framework**: ONEX 4.0 | **Package Manager**: uv (hatchling backend) | **Shared Standards**: See **`~/.claude/CLAUDE.md`** for shared development standards (Python, Git, testing, architecture principles) and infrastructure configuration (PostgreSQL, Kafka/Redpanda, Docker networking, environment variables).
 
 ---
 
@@ -49,22 +49,22 @@ OmniMemory explicitly does **NOT**:
 
 ```bash
 # Setup
-poetry install
+uv sync --group dev
 pre-commit install
 pre-commit install --hook-type pre-push
 
 # Format and lint
-poetry run ruff format src/ tests/
-poetry run ruff check --fix src/ tests/
+uv run ruff format src/ tests/
+uv run ruff check --fix src/ tests/
 
 # Type checking
-poetry run mypy src/omnimemory
+uv run mypy src/omnimemory
 
 # Testing
-poetry run pytest                    # All tests
-poetry run pytest -m unit            # Unit tests only
-poetry run pytest -m integration     # Integration tests
-poetry run pytest --cov              # With coverage report
+uv run pytest                        # All tests
+uv run pytest -m unit                # Unit tests only
+uv run pytest -m integration         # Integration tests
+uv run pytest --cov                  # With coverage report
 
 # Pre-commit validation
 pre-commit run --all-files
@@ -77,12 +77,12 @@ pre-commit run --all-files --hook-stage pre-push
 
 ## Package Manager
 
-This repository uses **Poetry** for dependency management. All Python commands must be run via `poetry run`.
+This repository uses **uv** for dependency management. All Python commands must be run via `uv run`.
 
 ```bash
-poetry install          # Install all dependencies
-poetry run <command>    # Run command in venv
-poetry lock             # Regenerate lockfile
+uv sync          # Install all dependencies
+uv run <command>    # Run command in venv
+uv lock              # Regenerate lockfile
 ```
 
 ---
@@ -247,4 +247,4 @@ For project overview, mission, and technology stack, see `README.md`.
 
 ---
 
-**Python**: 3.12+ | **Package Manager**: Poetry | **ONEX**: 4.0+
+**Python**: 3.12+ | **Package Manager**: uv | **ONEX**: 4.0+

{omninode_memory-0.7.2 → omninode_memory-0.9.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: omninode-memory
-Version: 0.7.2
+Version: 0.9.0
 Summary: OmniNode document ingestion and semantic retrieval
 Project-URL: Homepage, https://github.com/OmniNode-ai/omnimemory
 Project-URL: Repository, https://github.com/OmniNode-ai/omnimemory
@@ -11,7 +11,7 @@ Author-email: "OmniNode.ai" <contact@omninode.ai>
 License: MIT
 License-File: LICENSE
 Keywords: embeddings,memory,omninode,onex,rag,semantic-search
-Requires-Python: <4.0,>=3.12
+Requires-Python: <3.14,>=3.12
 Requires-Dist: aiohttp<4.0.0,>=3.12.15
 Requires-Dist: alembic<2.0.0,>=1.13.0
 Requires-Dist: asyncio-mqtt<1.0.0,>=0.16.0
@@ -20,9 +20,9 @@ Requires-Dist: cachetools<8.0.0,>=6.2.4
 Requires-Dist: fastapi<1.0.0,>=0.120.1
 Requires-Dist: httpx<1.0.0,>=0.28.0
 Requires-Dist: mcp<2.0.0,>=1.8.0
-Requires-Dist: omnibase-core==0.27.0
-Requires-Dist: omnibase-infra==0.20.0
-Requires-Dist: omnibase-spi>=0.16.1
+Requires-Dist: omnibase-core==0.29.0
+Requires-Dist: omnibase-infra==0.22.0
+Requires-Dist: omnibase-spi==0.18.0
 Requires-Dist: pinecone-client<7.0.0,>=4.1.0
 Requires-Dist: psutil<8.0.0,>=7.0.0
 Requires-Dist: psycopg2-binary<3.0.0,>=2.9.10
@@ -48,19 +48,9 @@ Description-Content-Type: text/markdown
 
 **Memory persistence, recall, and semantic retrieval for the OmniNode platform.** OmniMemory provides ONEX-compliant nodes and handlers for storing agent context, indexing embeddings, querying intent graphs, and managing the full memory lifecycle across distributed omni agents.
 
-## Four-Node Architecture
+## Architecture
 
-```text
-┌─────────────────┐    ┌─────────────────┐    ┌─────────────────┐    ┌─────────────────┐
-│     EFFECT      │───▶│     COMPUTE     │───▶│     REDUCER     │───▶│  ORCHESTRATOR   │
-│  (store/fetch)  │    │ (embed/analyze) │    │  (consolidate)  │    │  (coordinate)   │
-└─────────────────┘    └─────────────────┘    └─────────────────┘    └─────────────────┘
-```
-
-- **EFFECT**: Memory storage, retrieval, and intent query against external backends
-- **COMPUTE**: Semantic analysis, similarity scoring, embedding generation
-- **REDUCER**: Memory consolidation, statistics aggregation, lifecycle state management
-- **ORCHESTRATOR**: Agent coordination, multi-step memory lifecycle workflows
+Follows the [ONEX Four-Node Architecture](https://github.com/OmniNode-ai/omnibase_core/blob/main/docs/architecture/ONEX_FOUR_NODE_ARCHITECTURE.md) (EFFECT, COMPUTE, REDUCER, ORCHESTRATOR) applied to memory operations.
 
 ## What This Repo Provides
 

{omninode_memory-0.7.2 → omninode_memory-0.9.0}/README.md

@@ -8,19 +8,9 @@
 
 **Memory persistence, recall, and semantic retrieval for the OmniNode platform.** OmniMemory provides ONEX-compliant nodes and handlers for storing agent context, indexing embeddings, querying intent graphs, and managing the full memory lifecycle across distributed omni agents.
 
-## Four-Node Architecture
+## Architecture
 
-```text
-┌─────────────────┐    ┌─────────────────┐    ┌─────────────────┐    ┌─────────────────┐
-│     EFFECT      │───▶│     COMPUTE     │───▶│     REDUCER     │───▶│  ORCHESTRATOR   │
-│  (store/fetch)  │    │ (embed/analyze) │    │  (consolidate)  │    │  (coordinate)   │
-└─────────────────┘    └─────────────────┘    └─────────────────┘    └─────────────────┘
-```
-
-- **EFFECT**: Memory storage, retrieval, and intent query against external backends
-- **COMPUTE**: Semantic analysis, similarity scoring, embedding generation
-- **REDUCER**: Memory consolidation, statistics aggregation, lifecycle state management
-- **ORCHESTRATOR**: Agent coordination, multi-step memory lifecycle workflows
+Follows the [ONEX Four-Node Architecture](https://github.com/OmniNode-ai/omnibase_core/blob/main/docs/architecture/ONEX_FOUR_NODE_ARCHITECTURE.md) (EFFECT, COMPUTE, REDUCER, ORCHESTRATOR) applied to memory operations.
 
 ## What This Repo Provides
 

{omninode_memory-0.7.2 → omninode_memory-0.9.0}/pyproject.toml

@@ -7,10 +7,10 @@ build-backend = "hatchling.build"
 
 [project]
 name = "omninode-memory"
-version = "0.7.2"
+version = "0.9.0"
 description = "OmniNode document ingestion and semantic retrieval"
 readme = "README.md"
-requires-python = ">=3.12,<4.0"
+requires-python = ">=3.12,<3.14"
 license = { text = "MIT" }
 authors = [{ name = "OmniNode.ai", email = "contact@omninode.ai" }]
 keywords = ["omninode", "memory", "rag", "embeddings", "semantic-search", "onex"]
@@ -59,9 +59,9 @@ dependencies = [
     "pyyaml>=6.0.2,<7.0.0",
 
     # ONEX dependencies - versioned releases from PyPI
-    "omnibase-core==0.27.0",
-    "omnibase-spi>=0.16.1",
-    "omnibase-infra==0.20.0",
+    "omnibase-core==0.29.0",
+    "omnibase-spi==0.18.0",
+    "omnibase-infra==0.22.0",
 
     # Logging and monitoring
     # Version ^23.3.0 required for compatibility with omnibase-infra (requires ^23.2.0)
@@ -84,6 +84,9 @@ Changelog = "https://github.com/OmniNode-ai/omnimemory/blob/main/CHANGELOG.md"
 [project.entry-points."onex.domain_plugins"]
 memory = "omnimemory.runtime.plugin:PluginMemory"
 
+[project.entry-points."onex.node_package"]
+omnimemory = "omnimemory.nodes"
+
 [tool.hatch.build.targets.wheel]
 packages = ["src/omnimemory"]
 
@@ -217,7 +220,7 @@ ignore = [
     "N806",      # Variable in function should be lowercase
     "PTH123",    # Use Path.open() instead of open()
     "TID252",    # Prefer absolute imports over relative from parent
-    "T201",      # print() found (use logging instead)
+    # T201 (print) is NOT ignored — enforced per standardization plan
     "S311",      # Random not suitable for crypto (acceptable for non-crypto)
     "RUF022",    # __all__ is not sorted
     "RUF012",    # Mutable class attrs should be ClassVar
@@ -269,6 +272,11 @@ known-first-party = ["omnimemory"]
 "src/omnimemory/audit/*" = [
     "N802",  # AST visitor methods use CamelCase (visit_Import, visit_Call, etc.)
 ]
+# CLI entry points — intentional print() for user-facing output
+"src/omnimemory/audit/__main__.py" = ["T201"]
+"src/omnimemory/tools/contract_linter.py" = ["T201"]
+# Performance benchmark test — uses print() for results output
+"tests/test_performance.py" = ["T201"]
 # Test-only rules - acceptable in test files
 "tests/**/*" = [
     "SLF001",  # Private member accessed (tests need to verify internals)
@@ -329,9 +337,15 @@ warn_untyped_fields = true
 asyncio_mode = "auto"
 asyncio_default_fixture_loop_scope = "function"
 testpaths = ["tests"]
+pythonpath = ["src", "."]
 python_files = ["test_*.py"]
 python_functions = ["test_*"]
-addopts = "-v --tb=short --strict-markers"
+addopts = [
+    "--strict-markers",
+    "--strict-config",
+    "-ra",
+    "--tb=short",
+]
 # Filter deprecation warnings from third-party libraries we can't fix
 filterwarnings = [
     # Google protobuf PyType_Spec metaclass warning - upstream issue, can't fix
@@ -347,4 +361,13 @@ markers = [
 ]
 
 [tool.uv]
-# No override-dependencies needed — omnibase-infra>=0.14.0 + omnibase-core>=0.23.0 resolve cleanly.
+# Override omnibase-infra's transitive pins on core/spi so our direct pins win.
+override-dependencies = [
+    "omnibase-core==0.29.0",
+    "omnibase-spi==0.18.0",
+]
+
+[tool.uv.sources]
+omnibase-core = { git = "https://github.com/OmniNode-ai/omnibase_core.git", branch = "release/v0.29.0" }
+omnibase-spi = { git = "https://github.com/OmniNode-ai/omnibase_spi.git", branch = "release/v0.18.0" }
+omnibase-infra = { git = "https://github.com/OmniNode-ai/omnibase_infra.git", branch = "release/v0.22.0" }

{omninode_memory-0.7.2 → omninode_memory-0.9.0}/scripts/validation/validate_naming.py

@@ -356,7 +356,9 @@ def detect_expected_prefix_from_bases(
     return None, None
 
 
-def validate_file(filepath: Path) -> list[Violation]:  # stub-ok: docstring uses ModelXxx/ServiceXxx as naming examples, not TODO markers
+def validate_file(  # stub-ok: docstring uses ModelXxx/ServiceXxx as naming examples, not TODO markers
+    filepath: Path,
+) -> list[Violation]:
     """Validate a single Python file.
 
     Validates:

{omninode_memory-0.7.2 → omninode_memory-0.9.0}/src/omnimemory/nodes/node_filesystem_crawler_effect/handler_filesystem_crawler.py

@@ -50,7 +50,6 @@ Example::
             correlation_id=uuid4(),
             crawl_scope="omninode/omnimemory",
             trigger_source="scheduled",
-            env_prefix="dev",
             publish_callback=publisher,
         )
         print(f"discovered={result.discovered_count}")
@@ -353,7 +352,6 @@ class HandlerFilesystemCrawler:
         correlation_id: UUID,
         crawl_scope: str,
         trigger_source: TriggerSource,
-        env_prefix: str,
         publish_callback: Callable[
             [str, dict[str, object]], Coroutine[object, object, None]
         ],
@@ -373,9 +371,8 @@ class HandlerFilesystemCrawler:
             correlation_id: Threaded from the originating crawl tick command.
             crawl_scope: Scope string from the crawl tick command.
             trigger_source: What triggered this crawl run.
-            env_prefix: Deployment environment prefix (e.g. "dev").
             publish_callback: Async callback for publishing events.
-                Signature: (full_topic, message_dict) -> Coroutine[..., None].
+                Signature: (topic, message_dict) -> Coroutine[..., None].
             scope_mappings: Optional list of (path_prefix, scope_ref) pairs
                 for scope resolution. If None, DEFAULT_SCOPE_REF is used
                 for all files.
@@ -607,7 +604,7 @@ class HandlerFilesystemCrawler:
                     )
                     await _publish_event(
                         publish_callback,
-                        f"{env_prefix}.{self._config.publish_topic_discovered}",
+                        self._config.publish_topic_discovered,
                         discovered_event.model_dump(mode="json"),
                         correlation_id,
                     )
@@ -626,7 +623,7 @@ class HandlerFilesystemCrawler:
                     )
                     await _publish_event(
                         publish_callback,
-                        f"{env_prefix}.{self._config.publish_topic_indexed}",
+                        self._config.publish_topic_indexed,
                         indexed_event.model_dump(mode="json"),
                         correlation_id,
                     )
@@ -682,7 +679,7 @@ class HandlerFilesystemCrawler:
                     )
                     await _publish_event(
                         publish_callback,
-                        f"{env_prefix}.{self._config.publish_topic_changed}",
+                        self._config.publish_topic_changed,
                         changed_event.model_dump(mode="json"),
                         correlation_id,
                     )
@@ -701,7 +698,7 @@ class HandlerFilesystemCrawler:
                     )
                     await _publish_event(
                         publish_callback,
-                        f"{env_prefix}.{self._config.publish_topic_indexed}",
+                        self._config.publish_topic_indexed,
                         indexed_event.model_dump(mode="json"),
                         correlation_id,
                     )
@@ -744,7 +741,6 @@ class HandlerFilesystemCrawler:
                 emitted_at_utc=now_utc,
                 crawl_scope=crawl_scope,
                 trigger_source=trigger_source,
-                env_prefix=env_prefix,
                 publish_callback=publish_callback,
                 resolved_mappings=resolved_mappings,
             )
@@ -789,7 +785,6 @@ class HandlerFilesystemCrawler:
         emitted_at_utc: datetime,
         crawl_scope: str,
         trigger_source: TriggerSource,
-        env_prefix: str,
         publish_callback: Callable[
             [str, dict[str, object]], Coroutine[object, object, None]
         ],
@@ -816,7 +811,6 @@ class HandlerFilesystemCrawler:
             emitted_at_utc: UTC datetime when the crawl run started.
             crawl_scope: Scope string from the originating crawl tick command.
             trigger_source: What triggered the crawl run.
-            env_prefix: Environment prefix for topic construction.
             publish_callback: Async publish callback.
             resolved_mappings: Scope mappings for source_type resolution.
 
@@ -874,7 +868,7 @@ class HandlerFilesystemCrawler:
                     )
                     await _publish_event(
                         publish_callback,
-                        f"{env_prefix}.{self._config.publish_topic_removed}",
+                        self._config.publish_topic_removed,
                         removed_event.model_dump(mode="json"),
                         correlation_id,
                     )
@@ -925,7 +919,7 @@ async def _publish_event(
 
     Args:
         publish_callback: Caller-supplied async publish function.
-        topic: Full topic name (env prefix already applied).
+        topic: Full canonical ONEX topic name.
         payload: Serialized event dict.
         correlation_id: Used in error log for traceability.
     """