Skip to content

v1.0.0 — First Stable Release

Choose a tag to compare

View all tags
@Cataldir Cataldir released this 27 Feb 14:04
· 483 commits to main since this release
v1.0.0
54130a0

Holiday Peak Hub v1.0.0 — First Stable Release

Agent-driven retail accelerator with cloud-native architecture, complete frontend, and comprehensive backend.

Framework (lib/) — First Stable Version

The holiday_peak_lib micro-framework is now production-ready:

Agents

  • BaseRetailAgent: Abstract base for domain agents with SLM/LLM routing
  • AgentBuilder: Composable builder pattern for agent configuration (memory, tools, model targets)
  • ServiceAgent: Production wrapper with health, lifespan, and MCP surface
  • FastAPIMCPServer: Expose agent capabilities as MCP tools for agent-to-agent communication
  • Foundry integration: Azure AI Foundry V2 SDK (�zure-ai-projects>=2.0.0b4) with PromptAgentDefinition, auto-ensure on startup, strict enforcement mode

Memory (Three-Tier Architecture)

  • HotMemory — Redis with connection pooling for real-time context
  • WarmMemory — Cosmos DB for medium-term state (with SDK diagnostics and retry-after handling)
  • ColdMemory — Azure Blob Storage for long-term archival
  • MemoryBuilder — Cascading read/write across tiers

Adapters / Connectors

  • BaseAdapter with canonical connector interfaces
  • Domain adapters: CRM, Funnel, Inventory, Logistics, Pricing, Product
  • Mock adapters for local development and testing

App Factory

  • build_service_app() — Wires FastAPI with standard middleware, logging, health endpoints, settings, agent registration

Schemas (Pydantic v2)

  • Core, CRM, Funnel, Inventory, Logistics, Pricing, Product schemas
  • Validated request/response models across all agent domains

Utilities

  • EventHubPublisher — Async event publishing with error handling
  • Structured logging with correlation IDs and Application Insights
  • Retry helpers with exponential backoff

Configuration

  • ServiceSettings / MemorySettings / PostgresSettings — Pydantic Settings with env var loading
  • FoundryAgentConfig — SLM-first routing with LLM upgrade paths

Agent Services (21)

  • E-commerce (5): catalog-search, product-detail-enrichment, cart-intelligence, checkout-support, order-status
  • Product Management (4): normalization-classification, acp-transformation, consistency-validation, assortment-optimization
  • CRM (4): profile-aggregation, segmentation-personalization, campaign-intelligence, support-assistance
  • Inventory (4): health-check, jit-replenishment, reservation-validation, alerts-triggers
  • Logistics (4): eta-computation, carrier-selection, returns-support, route-issue-detection

CRUD Service

  • 31 REST endpoints across 15 route modules (FastAPI + PostgreSQL/asyncpg)
  • JWKS-based JWT auth (Microsoft Entra ID), RBAC with 4 role tiers
  • APIM-routed agent client with circuit breaker and tenacity retry
  • Event publishing to 5 Azure Event Hubs topics

Frontend

  • Next.js 16.2.0-canary, React 19, TypeScript 5.7
  • 13 pages, 52 components (atomic design), MSAL auth
  • 6 TypeScript API services, 5 React Query hooks

Infrastructure

  • Bicep modules (14 AVM-based) for AKS, ACR, APIM, Redis, Event Hubs, Key Vault, Cosmos DB, PostgreSQL, SWA
  • azd-first deployment with 8-job CI/CD pipeline
  • Helm chart scaffolding with KEDA autoscaling

Testing

  • 165 tests passing (lib + agent + CRUD)
  • Coverage: 73% (lib core)
  • CI gates: lint (black, isort, pylint), format, test with coverage floor

Documentation

  • 21 Architecture Decision Records (ADRs)
  • Full components catalog, playbooks, test plans
  • CRUD service implementation guide, frontend integration guide
Assets 2
Loading