omniintelligence 0.1.0__tar.gz

omniintelligence-0.1.0/PKG-INFO

@@ -0,0 +1,197 @@
+Metadata-Version: 2.4
+Name: omniintelligence
+Version: 0.1.0
+Summary: Intelligence, indexing, and pattern services as first-class Omninode nodes
+Author: OmniNode Team
+Author-email: team@omninode.ai
+Requires-Python: >=3.12,<4.0
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Requires-Dist: confluent-kafka (>=2.6.0)
+Requires-Dist: httpx (>=0.28.1)
+Requires-Dist: pydantic (>=2.9.0)
+Requires-Dist: pydantic-settings (>=2.6.0)
+Requires-Dist: python-dotenv (>=1.0.0)
+Requires-Dist: pyyaml (>=6.0)
+Requires-Dist: tenacity (>=8.2.0)
+Description-Content-Type: text/markdown
+
+# OmniIntelligence
+
+Intelligence, indexing, and pattern services as first-class Omninode nodes.
+
+## Overview
+
+OmniIntelligence is a rebuild of the legacy `omniarchon` intelligence platform, transformed into a set of canonical ONEX nodes following the Omninode architecture patterns. This migration preserves contract-driven ingestion, vector search, and intelligence APIs while aligning with canonical node standards.
+
+## Architecture
+
+The system is decomposed into specialized ONEX nodes:
+
+### Orchestrator Nodes
+- **intelligence_orchestrator** - Coordinates ingestion, enrichment, vectorization, and persistence pipelines
+
+### Reducer Nodes
+- **ingestion_reducer** - Manages ingestion FSM, state transitions, and lease management
+
+### Compute Nodes
+- **vectorization_compute** - Encapsulates embedding generation, scoring, and fallback models
+- **pattern_learning_compute** - Pattern enrichment and learning operations
+
+### Effect Nodes
+- **ingestion_effect** - Handles Kafka/Qdrant/PostgreSQL side effects
+- **intelligence_api_effect** - Provides HTTP/Kafka façade for intelligence APIs
+
+## Project Structure
+
+```
+omniintelligence/
+├── src/
+│   └── omniintelligence/
+│       ├── nodes/                    # ONEX nodes
+│       │   ├── intelligence_orchestrator/
+│       │   ├── ingestion_reducer/
+│       │   ├── ingestion_effect/
+│       │   ├── vectorization_compute/
+│       │   ├── pattern_learning_compute/
+│       │   └── intelligence_api_effect/
+│       ├── adapters/                 # External adapters (HTTP, etc.)
+│       ├── shared/                   # Shared models and utilities
+│       └── utils/                    # Common utilities
+├── tests/
+│   ├── unit/                         # Unit tests
+│   ├── integration/                  # Integration tests
+│   ├── fixtures/                     # Test fixtures
+│   └── contracts/                    # Contract validation tests
+├── scripts/                          # Automation scripts
+├── deployment/                       # Deployment manifests
+├── config/                           # Configuration files
+├── docs/                             # Documentation
+│   └── migrations/                   # Migration guides
+└── migration_sources/                # Legacy source reference
+    └── omniarchon/                   # Original omniarchon codebase
+```
+
+## Setup
+
+### Prerequisites
+
+- Python 3.12+
+- Poetry or uv for dependency management
+- Docker for local infrastructure (Kafka, Qdrant, PostgreSQL, Memgraph)
+
+### Installation
+
+```bash
+# Install core dependencies
+uv sync --group core
+
+# Install development dependencies
+uv sync --group dev
+
+# Install all dependencies (development + testing)
+uv sync --group all
+```
+
+### ONEX Ecosystem Dependencies
+
+The `omnibase-*` packages are **published to PyPI** and will be installed automatically:
+
+- **omnibase-core** (>=0.8.0) - ONEX node base classes, error handling, validation
+- **omnibase-spi** (>=0.5.0) - Service Provider Interface protocols
+- **omnibase-infra** (>=0.2.1) - Infrastructure handlers (Kafka, Qdrant, PostgreSQL)
+
+**What omnibase-infra provides**:
+- `QdrantVectorHandler` - Vector database operations
+- `KafkaEventBus` - Event bus implementation
+- `BaseRuntimeHostProcess` - Process lifecycle management
+- Handler implementations for PostgreSQL, Memgraph, etc.
+
+**For local development with unpublished versions** (optional):
+
+```bash
+# Install a local checkout for development
+uv pip install -e /path/to/your/omnibase_infra
+
+# Or for Poetry users, update pyproject.toml:
+# omnibase-infra = {path = "../omnibase_infra", develop = true}
+```
+
+### Running Tests
+
+```bash
+# Run unit tests
+pytest tests/unit
+
+# Run integration tests (requires infrastructure)
+pytest tests/integration
+
+# Run all tests
+pytest
+
+# Run with coverage
+pytest --cov=src/omniintelligence --cov-report=html
+```
+
+## Development
+
+### Node Development Pattern
+
+Each node follows the canonical ONEX structure:
+
+```
+node_name/
+├── v1_0_0/                          # Versioned implementation
+│   ├── contracts/                   # YAML contract definitions
+│   ├── models/                      # Pydantic models
+│   ├── node.py                      # Main node implementation
+│   ├── introspection.py            # Introspection support
+│   ├── scenarios/                   # Integration test scenarios
+│   └── node_tests/                  # Node-specific tests
+└── __init__.py
+```
+
+### Code Quality
+
+```bash
+# Format code
+black src tests
+isort src tests
+
+# Lint
+ruff check src tests
+
+# Type check
+mypy src
+```
+
+## Migration from OmniArchon
+
+This project is a migration from the legacy `omniarchon` system. See:
+- [Migration Guide](docs/migrations/omniarchon_to_omniintelligence.md)
+- [Legacy Sources](migration_sources/omniarchon/)
+
+## Documentation
+
+- [Architecture Overview](docs/migrations/omniarchon_to_omniintelligence.md#4-service-decomposition)
+- [Node Stack Blueprint](docs/migrations/omniarchon_to_omniintelligence.md#5-node-stack-blueprint)
+- [Migration Steps](docs/migrations/omniarchon_to_omniintelligence.md#6-migration-steps)
+- [Testing Strategy](docs/migrations/omniarchon_to_omniintelligence.md#7-testing--validation)
+
+## Migration Freeze
+
+A schema freeze is currently active for this repository as part of the DB-per-repo refactor ([OMN-2055](https://linear.app/omninode/issue/OMN-2055)). While `.migration_freeze` exists at the repo root, **no new migrations may be added** to `deployment/database/migrations/`.
+
+**Allowed during freeze:**
+- Migration moves (reorg between repos)
+- Ownership fixes (table transfers)
+- Rollback bug fixes (DB-SPLIT-01 refactor phase)
+
+**To lift the freeze:** remove `.migration_freeze` once DB boundary work for omniintelligence is complete.
+
+## License
+
+Copyright © 2024 OmniNode Team
+

omniintelligence-0.1.0/README.md

@@ -0,0 +1,176 @@
+# OmniIntelligence
+
+Intelligence, indexing, and pattern services as first-class Omninode nodes.
+
+## Overview
+
+OmniIntelligence is a rebuild of the legacy `omniarchon` intelligence platform, transformed into a set of canonical ONEX nodes following the Omninode architecture patterns. This migration preserves contract-driven ingestion, vector search, and intelligence APIs while aligning with canonical node standards.
+
+## Architecture
+
+The system is decomposed into specialized ONEX nodes:
+
+### Orchestrator Nodes
+- **intelligence_orchestrator** - Coordinates ingestion, enrichment, vectorization, and persistence pipelines
+
+### Reducer Nodes
+- **ingestion_reducer** - Manages ingestion FSM, state transitions, and lease management
+
+### Compute Nodes
+- **vectorization_compute** - Encapsulates embedding generation, scoring, and fallback models
+- **pattern_learning_compute** - Pattern enrichment and learning operations
+
+### Effect Nodes
+- **ingestion_effect** - Handles Kafka/Qdrant/PostgreSQL side effects
+- **intelligence_api_effect** - Provides HTTP/Kafka façade for intelligence APIs
+
+## Project Structure
+
+```
+omniintelligence/
+├── src/
+│   └── omniintelligence/
+│       ├── nodes/                    # ONEX nodes
+│       │   ├── intelligence_orchestrator/
+│       │   ├── ingestion_reducer/
+│       │   ├── ingestion_effect/
+│       │   ├── vectorization_compute/
+│       │   ├── pattern_learning_compute/
+│       │   └── intelligence_api_effect/
+│       ├── adapters/                 # External adapters (HTTP, etc.)
+│       ├── shared/                   # Shared models and utilities
+│       └── utils/                    # Common utilities
+├── tests/
+│   ├── unit/                         # Unit tests
+│   ├── integration/                  # Integration tests
+│   ├── fixtures/                     # Test fixtures
+│   └── contracts/                    # Contract validation tests
+├── scripts/                          # Automation scripts
+├── deployment/                       # Deployment manifests
+├── config/                           # Configuration files
+├── docs/                             # Documentation
+│   └── migrations/                   # Migration guides
+└── migration_sources/                # Legacy source reference
+    └── omniarchon/                   # Original omniarchon codebase
+```
+
+## Setup
+
+### Prerequisites
+
+- Python 3.12+
+- Poetry or uv for dependency management
+- Docker for local infrastructure (Kafka, Qdrant, PostgreSQL, Memgraph)
+
+### Installation
+
+```bash
+# Install core dependencies
+uv sync --group core
+
+# Install development dependencies
+uv sync --group dev
+
+# Install all dependencies (development + testing)
+uv sync --group all
+```
+
+### ONEX Ecosystem Dependencies
+
+The `omnibase-*` packages are **published to PyPI** and will be installed automatically:
+
+- **omnibase-core** (>=0.8.0) - ONEX node base classes, error handling, validation
+- **omnibase-spi** (>=0.5.0) - Service Provider Interface protocols
+- **omnibase-infra** (>=0.2.1) - Infrastructure handlers (Kafka, Qdrant, PostgreSQL)
+
+**What omnibase-infra provides**:
+- `QdrantVectorHandler` - Vector database operations
+- `KafkaEventBus` - Event bus implementation
+- `BaseRuntimeHostProcess` - Process lifecycle management
+- Handler implementations for PostgreSQL, Memgraph, etc.
+
+**For local development with unpublished versions** (optional):
+
+```bash
+# Install a local checkout for development
+uv pip install -e /path/to/your/omnibase_infra
+
+# Or for Poetry users, update pyproject.toml:
+# omnibase-infra = {path = "../omnibase_infra", develop = true}
+```
+
+### Running Tests
+
+```bash
+# Run unit tests
+pytest tests/unit
+
+# Run integration tests (requires infrastructure)
+pytest tests/integration
+
+# Run all tests
+pytest
+
+# Run with coverage
+pytest --cov=src/omniintelligence --cov-report=html
+```
+
+## Development
+
+### Node Development Pattern
+
+Each node follows the canonical ONEX structure:
+
+```
+node_name/
+├── v1_0_0/                          # Versioned implementation
+│   ├── contracts/                   # YAML contract definitions
+│   ├── models/                      # Pydantic models
+│   ├── node.py                      # Main node implementation
+│   ├── introspection.py            # Introspection support
+│   ├── scenarios/                   # Integration test scenarios
+│   └── node_tests/                  # Node-specific tests
+└── __init__.py
+```
+
+### Code Quality
+
+```bash
+# Format code
+black src tests
+isort src tests
+
+# Lint
+ruff check src tests
+
+# Type check
+mypy src
+```
+
+## Migration from OmniArchon
+
+This project is a migration from the legacy `omniarchon` system. See:
+- [Migration Guide](docs/migrations/omniarchon_to_omniintelligence.md)
+- [Legacy Sources](migration_sources/omniarchon/)
+
+## Documentation
+
+- [Architecture Overview](docs/migrations/omniarchon_to_omniintelligence.md#4-service-decomposition)
+- [Node Stack Blueprint](docs/migrations/omniarchon_to_omniintelligence.md#5-node-stack-blueprint)
+- [Migration Steps](docs/migrations/omniarchon_to_omniintelligence.md#6-migration-steps)
+- [Testing Strategy](docs/migrations/omniarchon_to_omniintelligence.md#7-testing--validation)
+
+## Migration Freeze
+
+A schema freeze is currently active for this repository as part of the DB-per-repo refactor ([OMN-2055](https://linear.app/omninode/issue/OMN-2055)). While `.migration_freeze` exists at the repo root, **no new migrations may be added** to `deployment/database/migrations/`.
+
+**Allowed during freeze:**
+- Migration moves (reorg between repos)
+- Ownership fixes (table transfers)
+- Rollback bug fixes (DB-SPLIT-01 refactor phase)
+
+**To lift the freeze:** remove `.migration_freeze` once DB boundary work for omniintelligence is complete.
+
+## License
+
+Copyright © 2024 OmniNode Team

omniintelligence-0.1.0/pyproject.toml

@@ -0,0 +1,281 @@
+[build-system]
+requires = ["poetry-core"]
+build-backend = "poetry.core.masonry.api"
+
+# =============================================================================
+# DEPENDENCY MANAGEMENT NOTES
+# =============================================================================
+# This project supports both Poetry and uv/PEP 621 dependency management.
+#
+# EDITABLE INSTALLS & uv.lock:
+#   Editable installs (pip install -e .) bypass uv.lock resolution.
+#   To verify reproducibility after editable install changes:
+#     1. Remove uv.lock: rm uv.lock
+#     2. Regenerate: uv lock
+#     3. Verify sync: uv sync --group dev
+# =============================================================================
+
+[tool.poetry]
+# Metadata defined in [project] section below (PEP 621 standard)
+# Only Poetry-specific settings (like packages) go here
+packages = [{include = "omniintelligence", from = "src"}]
+
+[tool.poetry.dependencies]
+python = ">=3.12,<4.0"
+# Versions aligned with [project.dependencies] for consistency
+pydantic = ">=2.9.0"
+pydantic-settings = ">=2.6.0"
+httpx = ">=0.28.1"
+tenacity = ">=8.2.0"
+confluent-kafka = ">=2.6.0"
+pyyaml = ">=6.0"
+python-dotenv = ">=1.0.0"
+
+[tool.poetry.group.dev.dependencies]
+# Versions aligned with [dependency-groups].dev for consistency
+pytest = ">=8.0.0"
+pytest-asyncio = ">=0.24.0"
+pytest-cov = ">=6.2.1"
+pytest-mock = ">=3.12.0"
+pytest-timeout = ">=2.3.0"
+pytest-xdist = ">=3.5.0"
+ruff = ">=0.12.5"
+mypy = ">=1.17.0"
+types-PyYAML = ">=6.0.0"
+requests = ">=2.31.0"
+factory-boy = ">=3.3.0"
+pre-commit = ">=4.5.0"
+
+[tool.poetry.group.core.dependencies]
+# ONEX private ecosystem dependencies (NOT on public PyPI)
+# Installed via editable installs from sibling repos or private registry.
+# Version constraints use caret syntax: ^0.9.10 = >=0.9.10,<0.10.0
+omnibase-core = "^0.16.0"
+omnibase-spi = "^0.7.0"
+omnibase-infra = "^0.6.0"
+# Core runtime dependencies (also in base [tool.poetry.dependencies] for minimal installs)
+# Included here for self-contained --only core installs
+pydantic = ">=2.9.0"
+pydantic-settings = ">=2.6.0"
+httpx = ">=0.28.1"
+pyyaml = ">=6.0"
+python-dotenv = ">=1.0.0"
+tenacity = ">=8.2.0"
+confluent-kafka = ">=2.6.0"
+# Web framework for API endpoints
+fastapi = ">=0.104.0"
+uvicorn = ">=0.24.0"
+python-multipart = ">=0.0.20"
+# Event bus (Kafka/Redpanda)
+aiokafka = ">=0.10.0"
+# Vector database
+qdrant-client = ">=1.15.1"
+# Graph database
+neo4j = ">=5.28.2"
+# PostgreSQL
+asyncpg = ">=0.29.0"
+# Document processing
+pypdf2 = ">=3.0.1"
+pdfplumber = ">=0.11.6"
+python-docx = ">=1.1.2"
+markdown = ">=3.8"
+# AI/ML
+openai = ">=1.71.0"
+sentence-transformers = ">=4.1.0"
+torch = ">=2.0.0"
+transformers = ">=4.30.0"
+tiktoken = ">=0.5.0"
+# Utilities
+cachetools = ">=5.3.0"
+redis = {extras = ["hiredis"], version = ">=5.0.0"}
+# Logging and monitoring
+logfire = ">=0.30.0"
+structlog = ">=23.1.0"
+prometheus-client = ">=0.19.0"
+psutil = ">=5.9.0"
+
+[tool.poetry.plugins."onex.domain_plugins"]
+intelligence = "omniintelligence.runtime.plugin:PluginIntelligence"
+
+[project]
+name = "omniintelligence"
+version = "0.1.0"
+description = "Intelligence, indexing, and pattern services as first-class Omninode nodes"
+authors = [{name = "OmniNode Team", email = "team@omninode.ai"}]
+readme = "README.md"
+requires-python = ">=3.12,<4.0"
+# Versions aligned with [tool.poetry.dependencies] for consistency
+dependencies = [
+    "httpx>=0.28.1",
+    "pyyaml>=6.0",
+    "pydantic>=2.9.0",
+    "pydantic-settings>=2.6.0",
+    "python-dotenv>=1.0.0",
+    "confluent-kafka>=2.6.0",
+    "tenacity>=8.2.0",
+]
+
+[project.entry-points."onex.domain_plugins"]
+intelligence = "omniintelligence.runtime.plugin:PluginIntelligence"
+
+[dependency-groups]
+# Development dependencies for linting and testing
+# Versions aligned with [tool.poetry.group.dev.dependencies] for consistency
+dev = [
+    "mypy>=1.17.0",
+    "types-PyYAML>=6.0.0",
+    "pytest>=8.0.0",
+    "pytest-asyncio>=0.24.0",
+    "pytest-mock>=3.12.0",
+    "pytest-timeout>=2.3.0",
+    "pytest-cov>=6.2.1",
+    "pytest-xdist>=3.5.0",
+    "ruff>=0.12.5",
+    "requests>=2.31.0",
+    "factory-boy>=3.3.0",
+    "pre-commit>=4.5.0",
+]
+
+# Core node system dependencies
+# Version constraints aligned with [tool.poetry.group.core.dependencies] caret syntax:
+#   ^0.16.0 = >=0.16.0,<0.17.0  (compatible releases within 0.16.x)
+#   ^0.7.0 = >=0.7.0,<0.8.0  (compatible releases within 0.7.x)
+#   ^0.6.0 = >=0.6.0,<0.7.0  (compatible releases within 0.6.x)
+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.16.0,<0.17.0",
+    "omnibase-spi>=0.7.0,<0.8.0",
+    "omnibase-infra>=0.6.0,<0.7.0",
+    # Web framework for API endpoints
+    "fastapi>=0.104.0",
+    "uvicorn>=0.24.0",
+    "python-multipart>=0.0.20",
+    # Event bus (Kafka/Redpanda)
+    "aiokafka>=0.10.0",
+    "confluent-kafka>=2.6.0",
+    # Vector database
+    "qdrant-client>=1.15.1",
+    # Graph database
+    "neo4j>=5.28.2",
+    # PostgreSQL
+    "asyncpg>=0.29.0",
+    # Document processing
+    "pypdf2>=3.0.1",
+    "pdfplumber>=0.11.6",
+    "python-docx>=1.1.2",
+    "markdown>=3.8",
+    # AI/ML
+    "openai>=1.71.0",
+    "sentence-transformers>=4.1.0",
+    "torch>=2.0.0",
+    "transformers>=4.30.0",
+    "tiktoken>=0.5.0",
+    # Utilities
+    "tenacity>=8.2.0",
+    "cachetools>=5.3.0",
+    "redis[hiredis]>=5.0.0",
+    # Logging and monitoring
+    "logfire>=0.30.0",
+    "structlog>=23.1.0",
+    "prometheus-client>=0.19.0",
+    "psutil>=5.9.0",
+]
+
+# All dependencies for development and testing
+# Uses include-group (PEP 735) to compose from core and dev groups
+# This eliminates duplication and prevents version drift between groups
+all = [
+    {include-group = "core"},
+    {include-group = "dev"},
+]
+
+[tool.ruff]
+line-length = 88
+target-version = "py312"
+
+[tool.ruff.lint]
+select = [
+    "E",     # pycodestyle errors
+    "F",     # pyflakes
+    "I",     # isort (import sorting)
+    "W",     # pycodestyle warnings
+    "N",     # pep8-naming
+    "UP",    # pyupgrade
+    "B",     # flake8-bugbear
+    "C4",    # flake8-comprehensions
+    "SIM",   # flake8-simplify
+    "ARG",   # flake8-unused-arguments
+    "RUF",   # Ruff-specific rules
+]
+ignore = [
+    "S101",   # Allow assert statements in tests
+    "E501",   # Allow line length violations (line length handled by ruff format)
+    "E402",   # Allow imports not at top (tests need sys.path setup, legacy emits warnings)
+    "B904",   # Allow raise without from in exception handlers
+    "B019",   # Allow lru_cache on methods (used carefully for singleton patterns)
+    "B007",   # Allow unused loop control variables
+    "N812",   # Allow lowercase imported as non-lowercase
+    "N815",   # Allow mixedCase variables
+    "N806",   # Allow non-lowercase variable in function
+    "N805",   # Allow cls as first argument
+    "UP007",  # Allow Union syntax
+    "UP042",  # Allow (str, Enum) inheritance (20 existing classes, migrate to StrEnum later)
+    "SIM117", # Allow nested with statements
+    "SIM102", # Allow nested if statements (sometimes clearer than combining)
+    "SIM103", # Allow explicit if/else returns (sometimes clearer)
+    "B008",   # Allow function call defaults
+    "F841",   # Allow unused variables
+    "ARG002", # Allow unused method arguments (common in test fixtures)
+    "RUF012", # Allow mutable class attributes
+    "RUF022", # Allow unsorted __all__ (manual ordering preferred for readability)
+    "RUF043", # Allow unescaped regex patterns in pytest.raises match (intentional regex)
+    "RUF059", # Allow unused unpacked variables (common in tests for tuple unpacking)
+]
+
+[tool.ruff.lint.per-file-ignores]
+# AST visitor methods must use PascalCase (visit_Import, visit_Call, etc.)
+"src/omniintelligence/audit/io_audit.py" = ["N802"]
+"tests/unit/test_node_purity.py" = ["N802"]
+# BaseHTTPRequestHandler requires do_GET method name
+"src/omniintelligence/runtime/stub_launcher.py" = ["N802"]
+# __init__.py files re-export for public API
+"src/omniintelligence/tools/__init__.py" = ["F401"]
+# Test intentionally catches broad exceptions for validation error testing
+"tests/nodes/pattern_extraction_compute/test_handlers.py" = ["B017"]
+
+[tool.ruff.format]
+quote-style = "double"
+indent-style = "space"
+skip-magic-trailing-comma = false
+line-ending = "auto"
+
+[tool.mypy]
+python_version = "3.12"
+warn_return_any = true
+warn_unused_configs = true
+disallow_untyped_defs = false
+disallow_any_unimported = false
+no_implicit_optional = true
+warn_redundant_casts = true
+warn_unused_ignores = true
+warn_no_return = true
+check_untyped_defs = true
+ignore_missing_imports = true
+
+[tool.pytest.ini_options]
+minversion = "8.0"
+testpaths = ["tests", "src/omniintelligence/nodes"]
+python_files = ["test_*.py", "*_test.py"]
+python_classes = ["Test*"]
+python_functions = ["test_*"]
+asyncio_mode = "auto"
+addopts = "-v --tb=short"
+markers = [
+    "slow: marks tests as slow (deselect with '-m \"not slow\"')",
+    "integration: marks tests as integration tests",
+    "performance: marks tests as performance benchmarks",
+    "unit: marks tests as unit tests",
+    "audit: marks tests as I/O audit enforcement tests",
+]

omniintelligence-0.1.0/src/omniintelligence/__init__.py

@@ -0,0 +1,43 @@
+"""OmniIntelligence - ONEX-compliant intelligence nodes.
+
+This package provides code quality analysis and intelligence operations
+as first-class ONEX nodes.
+
+Quick Start - Quality Scoring:
+    >>> from omniintelligence import score_code_quality, OnexStrictnessLevel
+    >>> result = score_code_quality(
+    ...     content="class Model(BaseModel): x: int",
+    ...     language="python",
+    ...     preset=OnexStrictnessLevel.STRICT,
+    ... )
+    >>> result["success"]
+    True
+    >>> result["quality_score"]  # 0.0 to 1.0
+    0.65
+"""
+
+from omniintelligence.nodes.node_quality_scoring_compute.handlers import (
+    DEFAULT_WEIGHTS,
+    DimensionScores,
+    OnexStrictnessLevel,
+    QualityScoringComputeError,
+    QualityScoringResult,
+    QualityScoringValidationError,
+    score_code_quality,
+)
+
+__version__ = "0.1.0"
+
+__all__ = [
+    # Configuration
+    "DEFAULT_WEIGHTS",
+    "DimensionScores",
+    "OnexStrictnessLevel",
+    "QualityScoringComputeError",
+    # Types
+    "QualityScoringResult",
+    # Exceptions
+    "QualityScoringValidationError",
+    # Main API
+    "score_code_quality",
+]