Major integrations and fixes: - Added BACKBEAT SDK integration for P2P operation timing - Implemented beat-aware status tracking for distributed operations - Added Docker secrets support for secure license management - Resolved KACHING license validation via HTTPS/TLS - Updated docker-compose configuration for clean stack deployment - Disabled rollback policies to prevent deployment failures - Added license credential storage (CHORUS-DEV-MULTI-001) Technical improvements: - BACKBEAT P2P operation tracking with phase management - Enhanced configuration system with file-based secrets - Improved error handling for license validation - Clean separation of KACHING and CHORUS deployment stacks 🤖 Generated with [Claude Code](https://claude.ai/code) Co-Authored-By: Claude <noreply@anthropic.com>
64 lines
2.9 KiB
Go
64 lines
2.9 KiB
Go
// Package context provides core context types and interfaces for the SLURP contextual intelligence system.
|
|
//
|
|
// This package defines the foundational data structures and interfaces for hierarchical
|
|
// context resolution within the CHORUS distributed AI development system. It implements
|
|
// bounded hierarchy traversal with role-based access control for efficient context
|
|
// resolution and caching.
|
|
//
|
|
// Key Features:
|
|
// - Hierarchical context resolution with bounded traversal depth
|
|
// - Role-based access control and encryption for context data
|
|
// - CSS-like inheritance patterns for cascading context properties
|
|
// - Efficient caching with selective invalidation
|
|
// - Integration with CHORUS election system for leader-only generation
|
|
//
|
|
// Core Types:
|
|
// - ContextNode: Represents a single context entry in the hierarchy
|
|
// - ResolvedContext: Final resolved context output with metadata
|
|
// - RoleAccessLevel: Defines encryption levels for different roles
|
|
// - EncryptedContext: Role-encrypted context data for DHT storage
|
|
//
|
|
// Primary Interfaces:
|
|
// - ContextResolver: Main interface for hierarchical context resolution
|
|
// - HierarchyManager: Manages the context hierarchy structure
|
|
// - GlobalContextManager: Manages system-wide applicable contexts
|
|
//
|
|
// Integration Points:
|
|
// - pkg/election: Leader election for context generation duties
|
|
// - pkg/crypto: Role-based encryption and access control
|
|
// - pkg/dht: Distributed storage of encrypted context data
|
|
// - pkg/ucxl: UCXL address parsing and handling
|
|
//
|
|
// Example Usage:
|
|
//
|
|
// resolver := context.NewDefaultResolver(storage, crypto)
|
|
// ctx := context.Background()
|
|
//
|
|
// // Resolve context for a UCXL address with bounded depth
|
|
// resolved, err := resolver.ResolveWithDepth(ctx, "ucxl://project/src/main.go", 5)
|
|
// if err != nil {
|
|
// log.Fatal(err)
|
|
// }
|
|
//
|
|
// fmt.Printf("Resolved context: %s\n", resolved.Summary)
|
|
// fmt.Printf("Technologies: %v\n", resolved.Technologies)
|
|
// fmt.Printf("Inheritance chain: %v\n", resolved.InheritanceChain)
|
|
//
|
|
// Architecture Design:
|
|
// The context system uses a tree-like hierarchy where child contexts inherit
|
|
// and override properties from their parents, similar to CSS cascading rules.
|
|
// This enables efficient context resolution while maintaining consistency
|
|
// and reducing duplication across the system.
|
|
//
|
|
// Performance Considerations:
|
|
// - Bounded traversal prevents infinite loops and limits resource usage
|
|
// - Caching with TTL reduces repeated resolution overhead
|
|
// - Batch operations optimize multi-address resolution
|
|
// - Role-based filtering reduces unnecessary data transfer
|
|
//
|
|
// Security Model:
|
|
// All context data is encrypted based on role access levels before storage
|
|
// in the distributed DHT. Only nodes with appropriate role permissions can
|
|
// decrypt and access context information, ensuring secure context sharing
|
|
// across the CHORUS cluster.
|
|
package context |