Frontend (17 items): - Virtualized message list with batch loading - CSS split with skeleton, drawer, search filter, message action styles - Code splitting via React.lazy + Suspense for Admin/Ethics/Settings pages - Skeleton loading components (Skeleton, SkeletonCard, SkeletonGrid) - Debounced search/filter component (SearchFilter) - Error boundary with fallback UI - Keyboard shortcuts (Ctrl+K search, Ctrl+Enter send, Escape dismiss) - Page transition animations (fade-in) - PWA support (manifest.json + service worker) - WebSocket auto-reconnect with exponential backoff (10 retries) - Chat history persistence to localStorage (500 msg limit) - Message edit/delete on hover - Copy-to-clipboard on code blocks - Mobile drawer (bottom-sheet for consensus panel) - File upload support - User preferences sync to backend Testing (8 items): - Component tests: Toast, Markdown, ChatMessage, Avatar, ErrorBoundary, Skeleton - Hook tests: useChatHistory - E2E smoke tests (5 tests) - Accessibility audit utility Backend (12 items): - Vector memory with cosine similarity search - TTS/STT adapter factory wiring - Geometry kernel with orphan detection - Tenant registry with CRUD operations - Response cache with TTL - Connection pool (async) - Background task queue - Health check endpoints (/health, /ready) - Request tracing middleware (X-Request-ID) - API key rotation mechanism - Environment-based config (settings.py) - API route documentation improvements Infrastructure (4 items): - Grafana dashboard template - Database migration system - Storybook configuration Documentation (3 items): - ADR-001: Advisory Governance Model - ADR-002: Twelve-Head Architecture - ADR-003: Consequence Engine 552 Python tests + 45 frontend tests passing, 0 ruff errors. Co-Authored-By: Nakamoto, S <defi@defi-oracle.io>
103 lines
3.5 KiB
Python
103 lines
3.5 KiB
Python
"""Layer 3 — Geometry Authority Kernel: implicit geometry, constraint solvers, feature lineage."""
|
|
|
|
from abc import ABC, abstractmethod
|
|
from typing import Any
|
|
|
|
from pydantic import BaseModel, Field
|
|
|
|
|
|
class FeatureLineageEntry(BaseModel):
|
|
"""Single feature lineage entry: feature -> intent node, physics justification, process eligibility."""
|
|
|
|
feature_id: str = Field(...)
|
|
intent_node_id: str = Field(...)
|
|
physics_justification_ref: str | None = Field(default=None)
|
|
process_eligible: bool = Field(default=False)
|
|
|
|
|
|
class GeometryAuthorityInterface(ABC):
|
|
"""
|
|
Interface for implicit geometry, constraint solvers, feature lineage.
|
|
Every geometric feature must map to intent node, physics justification, process eligibility.
|
|
Orphan geometry is prohibited.
|
|
"""
|
|
|
|
@abstractmethod
|
|
def add_feature(
|
|
self,
|
|
feature_id: str,
|
|
intent_node_id: str,
|
|
physics_justification_ref: str | None = None,
|
|
process_eligible: bool = False,
|
|
payload: dict[str, Any] | None = None,
|
|
) -> FeatureLineageEntry:
|
|
"""Register a feature with lineage; orphan (no intent) prohibited."""
|
|
...
|
|
|
|
@abstractmethod
|
|
def get_lineage(self, feature_id: str) -> FeatureLineageEntry | None:
|
|
"""Return lineage for feature or None."""
|
|
...
|
|
|
|
@abstractmethod
|
|
def validate_no_orphans(self) -> list[str]:
|
|
"""Return list of feature ids with no valid lineage (orphans); must be empty for MPC."""
|
|
...
|
|
|
|
|
|
class InMemoryGeometryKernel(GeometryAuthorityInterface):
|
|
"""In-memory geometry lineage model with orphan detection.
|
|
|
|
Tracks both registered features (with lineage) and all known feature IDs.
|
|
Features added via ``register_feature_id`` without a corresponding
|
|
``add_feature`` call are considered orphans.
|
|
"""
|
|
|
|
def __init__(self) -> None:
|
|
self._lineage: dict[str, FeatureLineageEntry] = {}
|
|
self._all_feature_ids: set[str] = set()
|
|
|
|
def register_feature_id(self, feature_id: str) -> None:
|
|
"""Register a feature ID from the geometry model (may not have lineage yet)."""
|
|
self._all_feature_ids.add(feature_id)
|
|
|
|
def add_feature(
|
|
self,
|
|
feature_id: str,
|
|
intent_node_id: str,
|
|
physics_justification_ref: str | None = None,
|
|
process_eligible: bool = False,
|
|
payload: dict[str, Any] | None = None,
|
|
) -> FeatureLineageEntry:
|
|
entry = FeatureLineageEntry(
|
|
feature_id=feature_id,
|
|
intent_node_id=intent_node_id,
|
|
physics_justification_ref=physics_justification_ref,
|
|
process_eligible=process_eligible,
|
|
)
|
|
self._lineage[feature_id] = entry
|
|
self._all_feature_ids.add(feature_id)
|
|
return entry
|
|
|
|
def get_lineage(self, feature_id: str) -> FeatureLineageEntry | None:
|
|
return self._lineage.get(feature_id)
|
|
|
|
def remove_feature(self, feature_id: str) -> bool:
|
|
"""Remove a feature and its lineage."""
|
|
removed = feature_id in self._lineage
|
|
self._lineage.pop(feature_id, None)
|
|
self._all_feature_ids.discard(feature_id)
|
|
return removed
|
|
|
|
def validate_no_orphans(self) -> list[str]:
|
|
"""Return feature IDs that exist but have no valid lineage."""
|
|
return [fid for fid in self._all_feature_ids if fid not in self._lineage]
|
|
|
|
def list_features(self) -> list[str]:
|
|
"""Return all known feature IDs."""
|
|
return sorted(self._all_feature_ids)
|
|
|
|
def count(self) -> int:
|
|
"""Return total feature count."""
|
|
return len(self._all_feature_ids)
|